npm - @ainyc/canonry - Versions diffs - 4.43.0 → 4.44.1 - Mend

@ainyc/canonry 4.43.0 → 4.44.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/assets/assets/{index-kRilKhIW.js → index-ObgzOp7B.js} +24 -24
package/assets/assets/{index-jvmhx0du.css → index-PWkDKYPZ.css} +1 -1
package/assets/index.html +2 -2
package/dist/{chunk-IXP4WGLQ.js → chunk-5FQBPF72.js} +30 -25
package/dist/{chunk-MITJYCHG.js → chunk-TBADB57G.js} +22 -0
package/dist/cli.js +32 -2
package/dist/index.js +2 -2
package/dist/{intelligence-service-HWWNLBZM.js → intelligence-service-YFBVWCK2.js} +1 -1
package/package.json +8 -8

package/assets/index.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-kRilKhIW.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-jvmhx0du.css">
+    <script type="module" crossorigin src="./assets/index-ObgzOp7B.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-PWkDKYPZ.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-IXP4WGLQ.js → chunk-5FQBPF72.js} RENAMED Viewed

@@ -77,9 +77,10 @@ import {
   rawEventSamples,
   runs,
   schedules,
+  smoothedRunDelta,
   trafficSources,
   usageCounters
-} from "./chunk-MITJYCHG.js";
+} from "./chunk-TBADB57G.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -3150,12 +3151,16 @@ function clientConfidenceLabel(confidence) {
 function clientTrendCopy(delta) {
   if (!delta) return null;
   if (delta.direction === "up") {
-    return { text: `Up ${delta.deltaAbs.toFixed(1)} points since last check (was ${delta.prior}%)`, tone: "positive", arrow: "\u2191" };
+    return { text: `Up ${delta.deltaAbs.toFixed(1)} points ${compareCopy(delta)}`, tone: "positive", arrow: "\u2191" };
   }
   if (delta.direction === "down") {
-    return { text: `Down ${Math.abs(delta.deltaAbs).toFixed(1)} points since last check (was ${delta.prior}%)`, tone: "negative", arrow: "\u2193" };
+    return { text: `Down ${Math.abs(delta.deltaAbs).toFixed(1)} points ${compareCopy(delta)}`, tone: "negative", arrow: "\u2193" };
   }
-  return { text: `Holding steady since last check (was ${delta.prior}%)`, tone: "neutral", arrow: "\u2192" };
+  return { text: `Holding steady ${compareCopy(delta)}`, tone: "neutral", arrow: "\u2192" };
+}
+function compareCopy(delta) {
+  const window = delta.window ?? 1;
+  return window >= 2 ? `vs prior ${window} checks (avg ${delta.prior}%)` : `since last check (was ${delta.prior}%)`;
 }
 function compactInlineList(items, limit = 3) {
   const visible = items.slice(0, limit);
@@ -4331,7 +4336,7 @@ function renderCompetitorLandscape(report) {
     </tr>`;
   }).join("");
   const table = competitors2.length > 0 ? `<table class="report-table">
-        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th class="numeric">Mentions</th><th class="numeric">SOV</th><th>Cited queries</th></tr></thead>
+        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th class="numeric">Mentions</th><th class="numeric" title="Citation share \u2014 % of cited-source slots that went to this competitor across tracked queries. Distinct from Mention Share.">Citation share</th><th>Cited queries</th></tr></thead>
         <tbody>${rows}</tbody>
       </table>` : renderEmpty("No competitors configured.");
   const citationBars = renderCompetitorBars(report.competitorLandscape, report.meta.project.canonicalDomain);
@@ -6688,6 +6693,8 @@ function buildAgencyDiagnostics(input) {
 }
 var WHATS_CHANGED_PERIOD_DAYS2 = 14;
 var WHATS_CHANGED_MIN_TREND_POINTS = WHATS_CHANGED_PERIOD_DAYS2 * 2;
+var RATE_REAL_MOVEMENT_THRESHOLD_PP = 3;
+var COUNT_REAL_MOVEMENT_THRESHOLD = 0.5;
 var WIN_REGRESSION_LIMIT = 5;
 function rateDirection(delta, threshold = 0.5) {
   if (delta > threshold) return "up";
@@ -6716,7 +6723,8 @@ function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHisto
   if (citation) {
     const arrow = citation.direction === "up" ? "\u2191" : citation.direction === "down" ? "\u2193" : "\u2192";
     const verb = citation.direction === "up" ? "rose" : citation.direction === "down" ? "fell" : "held";
-    parts.push(`Citation rate ${verb} ${citation.prior}% ${arrow} ${citation.current}%`);
+    const smoothingHint = citation.window && citation.window >= 2 ? ` (avg of last ${citation.window} checks)` : "";
+    parts.push(`Citation rate ${verb} ${citation.prior}% ${arrow} ${citation.current}%${smoothingHint}`);
   }
   if (aiReferrals && aiReferrals.direction !== "flat") {
     const arrow = aiReferrals.direction === "up" ? "\u2191" : "\u2193";
@@ -6733,23 +6741,20 @@ function buildWhatsChanged(input) {
   const latest = citationsTrend.at(-1);
   const prior = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
   const enoughHistory = !baseline && latest !== void 0 && prior !== void 0;
-  const citationRate = enoughHistory ? {
-    current: latest.citationRate,
-    prior: prior.citationRate,
-    deltaAbs: latest.citationRate - prior.citationRate,
-    direction: rateDirection(latest.citationRate - prior.citationRate)
+  const citationRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.citationRate);
+  const citationRate = enoughHistory && citationRateSmoothed ? {
+    ...citationRateSmoothed,
+    direction: rateDirection(citationRateSmoothed.deltaAbs, RATE_REAL_MOVEMENT_THRESHOLD_PP)
   } : null;
-  const mentionRate = enoughHistory ? {
-    current: latest.mentionRate,
-    prior: prior.mentionRate,
-    deltaAbs: latest.mentionRate - prior.mentionRate,
-    direction: rateDirection(latest.mentionRate - prior.mentionRate)
+  const mentionRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.mentionRate);
+  const mentionRate = enoughHistory && mentionRateSmoothed ? {
+    ...mentionRateSmoothed,
+    direction: rateDirection(mentionRateSmoothed.deltaAbs, RATE_REAL_MOVEMENT_THRESHOLD_PP)
   } : null;
-  const citedQueryCount = enoughHistory ? {
-    current: latest.citedQueryCount,
-    prior: prior.citedQueryCount,
-    deltaAbs: latest.citedQueryCount - prior.citedQueryCount,
-    direction: rateDirection(latest.citedQueryCount - prior.citedQueryCount, 0)
+  const citedQueryCountSmoothed = smoothedRunDelta(citationsTrend, (p) => p.citedQueryCount);
+  const citedQueryCount = enoughHistory && citedQueryCountSmoothed ? {
+    ...citedQueryCountSmoothed,
+    direction: rateDirection(citedQueryCountSmoothed.deltaAbs, COUNT_REAL_MOVEMENT_THRESHOLD)
   } : null;
   const providerMovements = [];
   if (enoughHistory) {
@@ -13499,7 +13504,7 @@ async function bingRoutes(app, opts) {
       connected: true,
       domain: project.canonicalDomain,
       siteUrl: existing?.siteUrl ?? null,
-      availableSites: sites.map((s) => ({ url: s.Url, verified: s.Verified ?? false }))
+      availableSites: sites.map((s) => ({ url: s.Url, verified: s.IsVerified ?? false }))
     };
   });
   app.delete("/projects/:name/bing/disconnect", async (request, reply) => {
@@ -13535,7 +13540,7 @@ async function bingRoutes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     const conn = requireConnection(store, project.canonicalDomain);
     const sites = await getSites(conn.apiKey);
-    return { sites: sites.map((s) => ({ url: s.Url, verified: s.Verified ?? false })) };
+    return { sites: sites.map((s) => ({ url: s.Url, verified: s.IsVerified ?? false })) };
   });
   app.post("/projects/:name/bing/set-site", async (request) => {
     const store = requireConnectionStore();
@@ -19607,7 +19612,7 @@ var BING_AUTH_CHECKS = [
             }
           };
         }
-        if (!match.Verified) {
+        if (!match.IsVerified) {
           return {
             status: CheckStatuses.fail,
             code: "bing.auth.site-not-verified",
@@ -26309,7 +26314,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-HWWNLBZM.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-YFBVWCK2.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-MITJYCHG.js → chunk-TBADB57G.js} RENAMED Viewed

@@ -3793,6 +3793,27 @@ function formatImpressions2(value) {
   return value.toString();
 }
+// ../intelligence/src/smoothed-delta.ts
+var SMOOTHED_RUN_DELTA_MAX_WINDOW = 3;
+function smoothedRunDelta(points, valueFn, maxWindow = SMOOTHED_RUN_DELTA_MAX_WINDOW) {
+  if (points.length < 2) return null;
+  const window = Math.min(maxWindow, Math.floor(points.length / 2));
+  const tail = points.slice(-window);
+  const prior = points.slice(-window * 2, -window);
+  const sum = (arr) => arr.reduce((s, p) => s + valueFn(p), 0);
+  const currentAvg = sum(tail) / tail.length;
+  const priorAvg = sum(prior) / prior.length;
+  return {
+    current: roundTo1Decimal(currentAvg),
+    prior: roundTo1Decimal(priorAvg),
+    deltaAbs: currentAvg - priorAvg,
+    window
+  };
+}
+function roundTo1Decimal(value) {
+  return Math.round(value * 10) / 10;
+}
 // src/intelligence-service.ts
 import crypto from "crypto";
@@ -4323,6 +4344,7 @@ export {
   providerKey,
   buildMentionShare,
   buildSuggestedQueries,
+  smoothedRunDelta,
   createLogger,
   IntelligenceService
 };

package/dist/cli.js CHANGED Viewed

@@ -21,7 +21,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-IXP4WGLQ.js";
+} from "./chunk-5FQBPF72.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   migrate,
   projects,
   queries
-} from "./chunk-MITJYCHG.js";
+} from "./chunk-TBADB57G.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -8081,6 +8081,7 @@ function renderHuman(overview) {
     providerScores,
     attentionItems,
     runHistory,
+    suggestedQueries,
     dateRangeLabel,
     contextLabel
   } = overview;
@@ -8096,7 +8097,11 @@ function renderHuman(overview) {
     console.log("\n  No runs yet.");
   }
   console.log("\nScores:");
+  printScore("Mention          ", scores.mention);
   printScore("Visibility       ", scores.visibility);
+  printScore("Mention share    ", scores.mentionShare);
+  printMentionShareBreakdown(scores.mentionShare);
+  printScore("Mention gaps     ", scores.mentionGaps);
   printScore("Gap queries      ", scores.gapQueries);
   printScore("Index coverage   ", scores.indexCoverage);
   printScore("Competitor press.", scores.competitorPressure);
@@ -8156,12 +8161,37 @@ function renderHuman(overview) {
       console.log(`    ${point.createdAt.slice(0, 10)} ${String(point.citationRate).padStart(3)}% ${bar}`);
     }
   }
+  if (suggestedQueries.rows.length > 0) {
+    const moreLabel = suggestedQueries.totalCandidates > suggestedQueries.rows.length ? ` (showing ${suggestedQueries.rows.length} of ${suggestedQueries.totalCandidates})` : "";
+    console.log(`
+  Suggested queries to track${moreLabel}:`);
+    for (const s of suggestedQueries.rows) {
+      console.log(`    + ${s.query}`);
+      console.log(`        ${s.reason}`);
+    }
+    console.log(`    (add via: canonry query add ${meta.name} "<query>")`);
+  }
 }
 function printScore(prefix, score) {
   const tone = `[${score.tone}]`.padEnd(11);
   const value = score.value.padEnd(8);
   console.log(`  ${prefix} ${tone} ${value} ${score.delta}`);
 }
+function printMentionShareBreakdown(mentionShare) {
+  const { breakdown } = mentionShare;
+  if (breakdown.perCompetitor.length === 0) return;
+  const total = breakdown.projectMentionSnapshots + breakdown.competitorMentionSnapshots;
+  if (total === 0) return;
+  const youPct = (breakdown.projectMentionSnapshots / total * 100).toFixed(1);
+  console.log(`      you${" ".repeat(28)} ${breakdown.projectMentionSnapshots} mentions (${youPct}% of combined)`);
+  for (const row of breakdown.perCompetitor.slice(0, 3)) {
+    const pct2 = (row.mentionSnapshots / total * 100).toFixed(1);
+    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct2}% of combined)`);
+  }
+  if (breakdown.perCompetitor.length > 3) {
+    console.log(`      + ${breakdown.perCompetitor.length - 3} more competitor${breakdown.perCompetitor.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
+  }
+}
 function pct(value) {
   return `${(value * 100).toFixed(1)}%`;
 }

package/dist/index.js CHANGED Viewed

@@ -1,10 +1,10 @@
 import {
   createServer
-} from "./chunk-IXP4WGLQ.js";
+} from "./chunk-5FQBPF72.js";
 import {
   loadConfig
 } from "./chunk-JZ2VJW4U.js";
-import "./chunk-MITJYCHG.js";
+import "./chunk-TBADB57G.js";
 import "./chunk-Q7XFJO2V.js";
 export {
   createServer,

package/dist/{intelligence-service-HWWNLBZM.js → intelligence-service-YFBVWCK2.js} RENAMED Viewed

@@ -1,6 +1,6 @@
 import {
   IntelligenceService
-} from "./chunk-MITJYCHG.js";
+} from "./chunk-TBADB57G.js";
 import "./chunk-Q7XFJO2V.js";
 export {
   IntelligenceService

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.43.0",
+  "version": "4.44.1",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,22 +61,22 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "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-db": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-traffic": "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-provider-gemini": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "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",