npm - @ainyc/canonry - Versions diffs - 3.3.9 → 3.4.6 - Mend

@ainyc/canonry 3.3.9 → 3.4.6

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 (12) hide show

package/assets/assets/{index-C1kUp1aS.js → index-C6qeFqvR.js} +87 -87
package/assets/index.html +1 -1
package/dist/{chunk-ZCPZOVVE.js → chunk-K33FVWFW.js} +167 -6
package/dist/{chunk-P6D3O5JB.js → chunk-UJRPODX3.js} +574 -492
package/dist/chunk-VIUWGDDU.js +1919 -0
package/dist/{chunk-24C7RMIS.js → chunk-ZYESHCMF.js} +76 -1967
package/dist/cli.js +93 -33
package/dist/index.js +4 -4
package/dist/{intelligence-service-FNJTFSI3.js → intelligence-service-NGA6RLCH.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +6 -6
package/dist/chunk-MLKGABMK.js +0 -9

package/assets/index.html CHANGED Viewed

@@ -12,7 +12,7 @@
     <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-C1kUp1aS.js"></script>
+    <script type="module" crossorigin src="./assets/index-C6qeFqvR.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-JG7aBJrz.css">
   </head>
   <body>

package/dist/{chunk-ZCPZOVVE.js → chunk-K33FVWFW.js} RENAMED Viewed

@@ -1,9 +1,11 @@
 import {
+  ContentActions,
+  RunKinds,
   __export
-} from "./chunk-MLKGABMK.js";
+} from "./chunk-VIUWGDDU.js";
 // src/intelligence-service.ts
-import { eq, desc, asc, and, or } from "drizzle-orm";
+import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -1946,6 +1948,103 @@ function clamp012(value) {
   return value;
 }
+// ../intelligence/src/next-steps.ts
+var TOP_N = 5;
+var IMMEDIATE_HORIZON = 3;
+var ACTION_TITLE = {
+  [ContentActions.create]: (q) => `Create a page targeting "${q}"`,
+  [ContentActions.refresh]: (q) => `Refresh the page targeting "${q}"`,
+  [ContentActions.expand]: (q) => `Expand coverage of "${q}"`,
+  [ContentActions["add-schema"]]: (q) => `Add structured data to the page targeting "${q}"`
+};
+function mapOpportunitiesToNextSteps(opportunities, existing) {
+  if (existing.length > 0) return existing;
+  if (opportunities.length === 0) return [];
+  return opportunities.slice(0, TOP_N).map((opp, idx) => ({
+    horizon: idx < IMMEDIATE_HORIZON ? "immediate" : "short-term",
+    title: ACTION_TITLE[opp.action](opp.query),
+    rationale: `Score ${Math.round(opp.score)} \xB7 demand ${opp.demandSource} \xB7 ${opp.actionConfidence} confidence.`
+  }));
+}
+// ../intelligence/src/insight-severity.ts
+var SEVERITY_THRESHOLDS = {
+  highTrafficImpressions: 100,
+  recurrenceCount: 2,
+  mediumTrafficImpressions: 10
+};
+function classifyRegressionSeverity(signals) {
+  const { gscImpressions, recurrenceCount } = signals;
+  if (gscImpressions === void 0 && recurrenceCount === void 0) return "high";
+  const isHighTraffic = gscImpressions !== void 0 && gscImpressions >= SEVERITY_THRESHOLDS.highTrafficImpressions;
+  const isRecurring = recurrenceCount !== void 0 && recurrenceCount >= SEVERITY_THRESHOLDS.recurrenceCount;
+  const isModerateTraffic = gscImpressions !== void 0 && gscImpressions >= SEVERITY_THRESHOLDS.mediumTrafficImpressions;
+  if (isHighTraffic && isRecurring) return "critical";
+  if (isHighTraffic || isRecurring) return "high";
+  if (isModerateTraffic) return "medium";
+  return "low";
+}
+// ../intelligence/src/insight-grouping.ts
+function groupInsights(insights2, keyFn = (i) => `${i.keyword} ${i.provider} ${i.type}`) {
+  const order = [];
+  const buckets = /* @__PURE__ */ new Map();
+  for (const i of insights2) {
+    const key = keyFn(i);
+    const bucket = buckets.get(key);
+    if (bucket) {
+      bucket.push(i);
+    } else {
+      buckets.set(key, [i]);
+      order.push(key);
+    }
+  }
+  return order.map((key) => {
+    const sorted = [...buckets.get(key)].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    const representative = sorted[sorted.length - 1];
+    return {
+      representative,
+      count: sorted.length,
+      instances: sorted,
+      latest: representative.createdAt
+    };
+  });
+}
+// ../intelligence/src/query-categorize.ts
+var TRANSACTIONAL_RE = /\b(buy|price|pricing|cost|hire|near me|services?|agency|consultant|company)\b/i;
+var INFORMATIONAL_RE = /\b(what|how|why|when|guide|tutorial|vs|versus|alternatives?|examples?|definition)\b/i;
+var MIN_BRAND_TOKEN_LENGTH = 3;
+function compact(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function buildBrandTokens(canonicalDomain, displayName) {
+  const seen = /* @__PURE__ */ new Set();
+  const stem = canonicalDomain.toLowerCase().replace(/\.[a-z]{2,}$/, "");
+  const stemCompact = compact(stem);
+  if (stemCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(stemCompact);
+  if (displayName) {
+    const displayCompact = compact(displayName);
+    if (displayCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(displayCompact);
+  }
+  return [...seen];
+}
+function categorizeQueryByIntent(query, brandTokens) {
+  const compactQuery = compact(query);
+  if (brandTokens.length > 0 && brandTokens.some((t) => compactQuery.includes(t))) {
+    return "brand";
+  }
+  if (TRANSACTIONAL_RE.test(query)) return "lead-gen";
+  if (INFORMATIONAL_RE.test(query)) return "industry";
+  return "other";
+}
+// ../intelligence/src/trend-stability.ts
+var MIN_TREND_POINTS = 4;
+function isTrendBaseline(points) {
+  return points.length < MIN_TREND_POINTS;
+}
 // src/intelligence-service.ts
 import crypto from "crypto";
@@ -1987,6 +2086,7 @@ function createLogger(module) {
 }
 // src/intelligence-service.ts
+var RECURRENCE_LOOKBACK_RUNS = 5;
 var log = createLogger("IntelligenceService");
 var IntelligenceService = class {
   constructor(db) {
@@ -2040,8 +2140,9 @@ var IntelligenceService = class {
       citedRate: result.health.overallCitedRate,
       insights: result.insights.length
     });
-    this.persistResult(result, runId, projectId);
-    return result;
+    const tieredResult = this.tierResult(result, runId, projectId);
+    this.persistResult(tieredResult, runId, projectId);
+    return tieredResult;
   }
   /**
    * Analyze a single run given an explicit previous run (or null for first run).
@@ -2059,8 +2160,9 @@ var IntelligenceService = class {
       return result2;
     }
     const result = analyzeRuns(currentRun, previousRun);
-    this.persistResult(result, runRecord.id, runRecord.projectId);
-    return result;
+    const tieredResult = this.tierResult(result, runRecord.id, runRecord.projectId);
+    this.persistResult(tieredResult, runRecord.id, runRecord.projectId);
+    return tieredResult;
   }
   /**
    * Backfill intelligence for all completed/partial runs of a project.
@@ -2151,6 +2253,59 @@ var IntelligenceService = class {
     });
     log.info("intelligence.persisted", { runId, insights: result.insights.length });
   }
+  /**
+   * Apply severity tiering to the insights of an AnalysisResult and return a
+   * new result. Wraps `applySeverityTiering` so callers (analyzeAndPersist,
+   * analyzeRunWithPrevious) can pass the same tiered shape both into the DB
+   * write and back to the RunCoordinator / webhook dispatcher.
+   */
+  tierResult(result, runId, projectId) {
+    if (result.insights.length === 0) return result;
+    return { ...result, insights: this.applySeverityTiering(result.insights, runId, projectId) };
+  }
+  /**
+   * Re-classify each regression insight's severity using GSC traffic +
+   * recurrence signals via the pure `classifyRegressionSeverity` primitive
+   * in @ainyc/canonry-intelligence. Non-regression insights are returned
+   * untouched.
+   */
+  applySeverityTiering(rawInsights, excludeRunId, projectId) {
+    const regressions = rawInsights.filter((i) => i.type === "regression");
+    if (regressions.length === 0) return rawInsights;
+    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq(gscSearchData.projectId, projectId)).all();
+    const gscConnected = gscRows.length > 0;
+    const gscImpressionsByKeyword = /* @__PURE__ */ new Map();
+    for (const row of gscRows) {
+      const key = row.query.toLowerCase();
+      gscImpressionsByKeyword.set(key, (gscImpressionsByKeyword.get(key) ?? 0) + row.impressions);
+    }
+    const recentRunIds = this.db.select({ id: runs.id }).from(runs).where(
+      and(
+        eq(runs.projectId, projectId),
+        eq(runs.kind, RunKinds["answer-visibility"]),
+        or(eq(runs.status, "completed"), eq(runs.status, "partial"))
+      )
+    ).orderBy(desc(runs.createdAt)).limit(RECURRENCE_LOOKBACK_RUNS + 1).all().map((r) => r.id).filter((id) => id !== excludeRunId).slice(0, RECURRENCE_LOOKBACK_RUNS);
+    const haveHistory = recentRunIds.length > 0;
+    const priorRegressionsByPair = /* @__PURE__ */ new Map();
+    if (haveHistory) {
+      const priorRows = this.db.select({ keyword: insights.keyword, provider: insights.provider }).from(insights).where(and(eq(insights.type, "regression"), inArray(insights.runId, recentRunIds))).all();
+      for (const row of priorRows) {
+        const key = `${row.keyword}:${row.provider}`;
+        priorRegressionsByPair.set(key, (priorRegressionsByPair.get(key) ?? 0) + 1);
+      }
+    }
+    return rawInsights.map((insight) => {
+      if (insight.type !== "regression") return insight;
+      const gscImpressions = gscConnected ? gscImpressionsByKeyword.get(insight.keyword.toLowerCase()) ?? 0 : void 0;
+      const recurrenceCount = haveHistory ? priorRegressionsByPair.get(`${insight.keyword}:${insight.provider}`) ?? 0 : void 0;
+      const severity = classifyRegressionSeverity({
+        gscImpressions,
+        recurrenceCount
+      });
+      return { ...insight, severity };
+    });
+  }
   buildRunData(runId, projectId, completedAt) {
     const rows = this.db.select({
       keyword: keywords.keyword,
@@ -2211,6 +2366,12 @@ export {
   buildContentTargetRows,
   buildContentSourceRows,
   buildContentGapRows,
+  mapOpportunitiesToNextSteps,
+  groupInsights,
+  buildBrandTokens,
+  categorizeQueryByIntent,
+  MIN_TREND_POINTS,
+  isTrendBaseline,
   createLogger,
   IntelligenceService
 };