@ainyc/canonry 4.86.0 → 4.88.0

package/dist/{chunk-23HGQV22.js → chunk-JZ67YCHT.js}

@@ -3163,6 +3163,196 @@ var ccCachedReleaseSchema = z23.object({
 
 // ../contracts/src/composites.ts
 import { z as z24 } from "zod";
+var metricToneSchema = z24.enum(["positive", "caution", "negative", "neutral"]);
+var scoreSummarySchema = z24.object({
+  label: z24.string(),
+  value: z24.string(),
+  delta: z24.string(),
+  tone: metricToneSchema,
+  description: z24.string(),
+  tooltip: z24.string().optional(),
+  trend: z24.array(z24.number()),
+  progress: z24.number().optional(),
+  providerCoverage: z24.string().optional()
+});
+var mentionShareSchema = scoreSummarySchema.extend({
+  breakdown: z24.object({
+    projectMentionSnapshots: z24.number().int().nonnegative(),
+    competitorMentionSnapshots: z24.number().int().nonnegative(),
+    perCompetitor: z24.array(z24.object({
+      domain: z24.string(),
+      mentionSnapshots: z24.number().int().nonnegative(),
+      shareOfCompetitiveTotal: z24.number()
+    })),
+    snapshotsWithAnswerText: z24.number().int().nonnegative(),
+    snapshotsTotal: z24.number().int().nonnegative()
+  })
+});
+var movementSummarySchema = z24.object({
+  gained: z24.number().int().nonnegative(),
+  lost: z24.number().int().nonnegative(),
+  tone: metricToneSchema,
+  hasPreviousRun: z24.boolean(),
+  gainedQueries: z24.array(z24.string()).optional(),
+  lostQueries: z24.array(z24.string()).optional()
+});
+var movementComparisonSchema = z24.object({
+  hasPreviousRun: z24.boolean(),
+  comparable: z24.boolean(),
+  querySetChanged: z24.boolean(),
+  previousRunAt: z24.string().nullable(),
+  currentQueryCount: z24.number().int().nonnegative(),
+  previousQueryCount: z24.number().int().nonnegative(),
+  comparableQueryCount: z24.number().int().nonnegative(),
+  addedQueryCount: z24.number().int().nonnegative(),
+  removedQueryCount: z24.number().int().nonnegative(),
+  addedQueries: z24.array(z24.string()),
+  removedQueries: z24.array(z24.string())
+});
+var projectOverviewInsightSchema = z24.object({
+  id: z24.string(),
+  projectId: z24.string(),
+  runId: z24.string().nullable(),
+  type: z24.enum([
+    "regression",
+    "gain",
+    "opportunity",
+    "first-citation",
+    "provider-pickup",
+    "persistent-gap",
+    "competitor-gained",
+    "competitor-lost",
+    "gbp-lodging-gap",
+    "gbp-listing-discrepancy",
+    "gbp-cta-gap",
+    "gbp-metric-drop",
+    "gbp-keyword-drop"
+  ]),
+  severity: z24.enum(["critical", "high", "medium", "low"]),
+  title: z24.string(),
+  query: z24.string(),
+  provider: z24.string(),
+  recommendation: z24.object({
+    action: z24.string(),
+    target: z24.string().optional(),
+    reason: z24.string()
+  }).optional(),
+  cause: z24.object({
+    cause: z24.string(),
+    competitorDomain: z24.string().optional(),
+    details: z24.string().optional()
+  }).optional(),
+  dismissed: z24.boolean(),
+  createdAt: z24.string()
+});
+var projectOverviewHealthSchema = z24.object({
+  id: z24.string(),
+  projectId: z24.string(),
+  runId: z24.string().nullable(),
+  overallCitedRate: z24.number(),
+  overallMentionRate: z24.number(),
+  totalPairs: z24.number().int().nonnegative(),
+  citedPairs: z24.number().int().nonnegative(),
+  mentionedPairs: z24.number().int().nonnegative(),
+  providerBreakdown: z24.record(z24.string(), z24.object({
+    citedRate: z24.number(),
+    mentionRate: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    mentioned: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative()
+  })),
+  createdAt: z24.string(),
+  status: z24.enum(["ready", "no-data"]),
+  reason: z24.literal("no-runs-yet").optional()
+});
+var projectOverviewDtoSchema = z24.object({
+  project: projectDtoSchema,
+  latestRun: latestProjectRunDtoSchema,
+  health: projectOverviewHealthSchema.nullable(),
+  topInsights: z24.array(projectOverviewInsightSchema),
+  queryCounts: z24.object({
+    totalQueries: z24.number().int().nonnegative(),
+    citedQueries: z24.number().int().nonnegative(),
+    notCitedQueries: z24.number().int().nonnegative(),
+    citedRate: z24.number(),
+    mentionedQueries: z24.number().int().nonnegative(),
+    notMentionedQueries: z24.number().int().nonnegative(),
+    mentionRate: z24.number()
+  }),
+  providers: z24.array(z24.object({
+    provider: z24.string(),
+    citedRate: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative()
+  })),
+  transitions: z24.object({
+    since: z24.string().nullable(),
+    gained: z24.number().int().nonnegative(),
+    lost: z24.number().int().nonnegative(),
+    emerging: z24.number().int().nonnegative()
+  }),
+  scores: z24.object({
+    mention: scoreSummarySchema,
+    visibility: scoreSummarySchema,
+    mentionShare: mentionShareSchema,
+    gapQueries: scoreSummarySchema,
+    mentionGaps: scoreSummarySchema,
+    indexCoverage: scoreSummarySchema,
+    competitorPressure: scoreSummarySchema,
+    runStatus: scoreSummarySchema
+  }),
+  movementSummary: movementSummarySchema,
+  citationMovement: movementSummarySchema,
+  mentionMovement: movementSummarySchema,
+  movementComparison: movementComparisonSchema,
+  competitors: z24.array(z24.object({
+    id: z24.string(),
+    domain: z24.string(),
+    citationCount: z24.number().int().nonnegative(),
+    totalQueries: z24.number().int().nonnegative(),
+    pressureLabel: z24.enum(["None", "Low", "Moderate", "High"]),
+    citedQueries: z24.array(z24.string())
+  })),
+  providerScores: z24.array(z24.object({
+    provider: z24.string(),
+    model: z24.string().nullable(),
+    score: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative(),
+    trend: z24.array(z24.number()).optional()
+  })),
+  attentionItems: z24.array(z24.object({
+    id: z24.string(),
+    tone: metricToneSchema,
+    title: z24.string(),
+    detail: z24.string(),
+    actionLabel: z24.string(),
+    href: z24.string()
+  })),
+  runHistory: z24.array(z24.object({
+    runId: z24.string(),
+    createdAt: z24.string(),
+    citedCount: z24.number().int().nonnegative(),
+    totalCount: z24.number().int().nonnegative(),
+    citationRate: z24.number(),
+    mentionedCount: z24.number().int().nonnegative(),
+    mentionRate: z24.number(),
+    status: z24.string()
+  })),
+  suggestedQueries: z24.object({
+    rows: z24.array(z24.object({
+      query: z24.string(),
+      impressions: z24.number(),
+      clicks: z24.number(),
+      avgPosition: z24.number(),
+      reason: z24.string()
+    })),
+    totalCandidates: z24.number().int().nonnegative(),
+    skippedAlreadyTracked: z24.number().int().nonnegative()
+  }),
+  dateRangeLabel: z24.string(),
+  contextLabel: z24.string()
+});
 var searchHitKindSchema = z24.enum(["snapshot", "insight"]);
 var projectSearchSnapshotHitSchema = z24.object({
   kind: z24.literal("snapshot"),
@@ -3533,6 +3723,11 @@ function summarizeCheckResults(results) {
   return summary;
 }
 
+// ../contracts/src/query-normalize.ts
+function normalizeQueryText(value) {
+  return value.trim().toLowerCase();
+}
+
 // ../contracts/src/citations.ts
 import { z as z27 } from "zod";
 var citationCoverageProviderSchema = z27.object({
@@ -4360,6 +4555,20 @@ function coerceSkillManifest(parsed) {
 
 // ../contracts/src/traffic.ts
 import { z as z30 } from "zod";
+var trafficCrawlerSegmentsSchema = z30.object({
+  content: z30.number().int().nonnegative(),
+  sitemap: z30.number().int().nonnegative(),
+  robots: z30.number().int().nonnegative(),
+  asset: z30.number().int().nonnegative(),
+  other: z30.number().int().nonnegative()
+});
+var trafficPathClassSchema = z30.enum([
+  "content",
+  "sitemap",
+  "robots",
+  "asset",
+  "other"
+]);
 var trafficSourceTypeSchema = z30.enum([
   "cloud-run",
   "wordpress",
@@ -4516,7 +4725,18 @@ var trafficBackfillResponseSchema = z30.object({
   daysApplied: z30.number().int().positive()
 });
 var trafficSourceTotalsSchema = z30.object({
+  /**
+   * Total classified-crawler hits in the window. UNCHANGED contract — still the
+   * full count across every path class. Use `crawlerContentHits` for the
+   * "content was actually crawled" signal.
+   */
   crawlerHits: z30.number().int().nonnegative(),
+  /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
+  crawlerContentHits: z30.number().int().nonnegative(),
+  /** Infrastructure crawler hits — sitemap + robots + asset fetches (`crawlerSegments.{sitemap,robots,asset}`). */
+  crawlerInfraHits: z30.number().int().nonnegative(),
+  /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
+  crawlerSegments: trafficCrawlerSegmentsSchema,
   aiUserFetchHits: z30.number().int().nonnegative(),
   aiReferralHits: z30.number().int().nonnegative(),
   sampleCount: z30.number().int().nonnegative()
@@ -4547,6 +4767,8 @@ var trafficCrawlerEventEntrySchema = z30.object({
   operator: z30.string(),
   verificationStatus: z30.string(),
   pathNormalized: z30.string(),
+  /** Coarse class of the fetched path — lets the UI split content crawls from sitemap/robots/asset polling. */
+  pathClass: trafficPathClassSchema,
   status: z30.number().int(),
   hits: z30.number().int().nonnegative()
 });
@@ -4582,13 +4804,151 @@ var trafficEventsResponseSchema = z30.object({
   windowStart: z30.string(),
   windowEnd: z30.string(),
   totals: z30.object({
+    /** Total classified-crawler hits across the window. UNCHANGED contract. */
     crawlerHits: z30.number().int().nonnegative(),
+    /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
+    crawlerContentHits: z30.number().int().nonnegative(),
+    /** Infrastructure crawler hits — sitemap + robots + asset fetches. */
+    crawlerInfraHits: z30.number().int().nonnegative(),
+    /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
+    crawlerSegments: trafficCrawlerSegmentsSchema,
     aiUserFetchHits: z30.number().int().nonnegative(),
     aiReferralHits: z30.number().int().nonnegative()
   }),
   events: z30.array(trafficEventEntrySchema)
 });
 
+// ../contracts/src/traffic-path.ts
+var TrafficPathClasses = {
+  content: "content",
+  sitemap: "sitemap",
+  robots: "robots",
+  asset: "asset",
+  other: "other"
+};
+var ROBOTS_BASENAMES = /* @__PURE__ */ new Set(["robots.txt", "llms.txt", "llms-full.txt"]);
+var ASSET_EXTENSIONS = /* @__PURE__ */ new Set([
+  "css",
+  "js",
+  "mjs",
+  "cjs",
+  "map",
+  "json",
+  "png",
+  "jpg",
+  "jpeg",
+  "webp",
+  "avif",
+  "gif",
+  "svg",
+  "ico",
+  "bmp",
+  "tif",
+  "tiff",
+  "woff",
+  "woff2",
+  "ttf",
+  "otf",
+  "eot",
+  "mp4",
+  "webm",
+  "mov",
+  "m4v",
+  "mp3",
+  "wav",
+  "ogg",
+  "flac",
+  "m4a",
+  "wasm"
+]);
+var DOCUMENT_EXTENSIONS = /* @__PURE__ */ new Set([
+  "html",
+  "htm",
+  "xhtml",
+  "shtml",
+  "php",
+  "php5",
+  "php7",
+  "asp",
+  "aspx",
+  "jsp",
+  "jspx",
+  "cfm",
+  "md"
+]);
+var DOWNLOAD_EXTENSIONS = /* @__PURE__ */ new Set([
+  "pdf",
+  "csv",
+  "tsv",
+  "txt",
+  "doc",
+  "docx",
+  "xls",
+  "xlsx",
+  "ppt",
+  "pptx",
+  "odt",
+  "ods",
+  "odp",
+  "rtf",
+  "zip",
+  "gz",
+  "tgz",
+  "tar",
+  "rar",
+  "7z",
+  "bz2",
+  "xz",
+  "rss",
+  "atom",
+  "ics",
+  "vcf",
+  "epub",
+  "mobi",
+  "apk",
+  "dmg",
+  "exe",
+  "bin",
+  "iso",
+  "sql"
+]);
+var SITEMAP_BASENAME = /^sitemap(?:[-_]index)?$/;
+function classifyTrafficPath(pathNormalized) {
+  const raw = (pathNormalized ?? "").trim();
+  if (!raw) return TrafficPathClasses.other;
+  const rawPath = raw.split(/[?#]/)[0] ?? "";
+  const pathOnly = rawPath.length > 1 ? rawPath.replace(/\/+$/, "") || "/" : rawPath;
+  if (!pathOnly) return TrafficPathClasses.other;
+  const lower = pathOnly.toLowerCase();
+  const segments = lower.split("/");
+  const basename = segments[segments.length - 1] ?? "";
+  if (ROBOTS_BASENAMES.has(basename)) return TrafficPathClasses.robots;
+  if (lower.endsWith(".xml") || lower.endsWith(".xml.gz")) return TrafficPathClasses.sitemap;
+  if (SITEMAP_BASENAME.test(basename)) return TrafficPathClasses.sitemap;
+  const dot = basename.lastIndexOf(".");
+  const ext = dot > 0 ? basename.slice(dot + 1) : "";
+  if (ext) {
+    if (ASSET_EXTENSIONS.has(ext)) return TrafficPathClasses.asset;
+    if (DOCUMENT_EXTENSIONS.has(ext)) return TrafficPathClasses.content;
+    if (DOWNLOAD_EXTENSIONS.has(ext)) return TrafficPathClasses.other;
+    return TrafficPathClasses.content;
+  }
+  return TrafficPathClasses.content;
+}
+function emptyCrawlerSegments() {
+  return { content: 0, sitemap: 0, robots: 0, asset: 0, other: 0 };
+}
+function segmentCrawlerHits(rows) {
+  const segments = emptyCrawlerSegments();
+  for (const row of rows) {
+    segments[classifyTrafficPath(row.pathNormalized)] += row.hits;
+  }
+  return segments;
+}
+function sumInfraHits(segments) {
+  return segments.sitemap + segments.robots + segments.asset;
+}
+
 // ../contracts/src/formatting.ts
 function formatRatio(value) {
   if (!Number.isFinite(value) || value === 0) return "0%";
@@ -5029,6 +5389,7 @@ export {
   backlinksInstallResultDtoSchema,
   ccAvailableReleaseSchema,
   ccCachedReleaseSchema,
+  projectOverviewDtoSchema,
   ContentActions,
   contentActionLabel,
   actionConfidenceLabel,
@@ -5052,6 +5413,7 @@ export {
   CheckCategories,
   doctorReportSchema,
   summarizeCheckResults,
+  normalizeQueryText,
   citationVisibilityResponseSchema,
   emptyCitationVisibility,
   citationStateToCited,
@@ -5088,6 +5450,9 @@ export {
   trafficEventKindSchema,
   TrafficEventKinds,
   trafficEventsResponseSchema,
+  classifyTrafficPath,
+  segmentCrawlerHits,
+  sumInfraHits,
   formatRatio,
   formatNumber,
   formatDate,

package/dist/{chunk-LLJPZKHG.js → chunk-RH3QYFX3.js}

@@ -23,7 +23,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-23HGQV22.js";
+} from "./chunk-JZ67YCHT.js";
 
 // src/config.ts
 import fs from "fs";
@@ -5597,7 +5597,7 @@ 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, 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.',
+    description: 'One-call summary for "how is project X doing?". Returns independent mention and citation coverage, separate query-level movement for each signal, query-basket comparability with added/removed counts, latest run and health, insights, provider/model breakdowns, competitors, attention items, and recent history. Movement excludes queries not shared by both sweeps. Filterable by location and time window. Prefer this over fanning out to separate tools.',
     access: "read",
     tier: "core",
     inputSchema: z2.object({