npm - @ainyc/canonry - Versions diffs - 4.13.1 → 4.14.0 - Mend

@ainyc/canonry 4.13.1 → 4.14.0

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

package/assets/assets/{index-BofSsfDl.js → index-B6Mi9Fd1.js} +122 -122
package/assets/index.html +1 -1
package/dist/{chunk-LNRDWAG3.js → chunk-5NYG5EC7.js} +1 -1
package/dist/{chunk-YDGT5CAY.js → chunk-6QTH5NS5.js} +71 -4
package/dist/{chunk-DCE3B6KD.js → chunk-7HBZCGRL.js} +18 -2
package/dist/{chunk-RIGQFQJJ.js → chunk-UQHWSCTE.js} +240 -73
package/dist/cli.js +58 -26
package/dist/index.js +4 -4
package/dist/{intelligence-service-NT24OLLA.js → intelligence-service-BCKXIKIL.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +6 -6

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-BofSsfDl.js"></script>
+    <script type="module" crossorigin src="./assets/index-B6Mi9Fd1.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-D0EPNRDs.css">
   </head>
   <body>

package/dist/{chunk-LNRDWAG3.js → chunk-5NYG5EC7.js} RENAMED Viewed

@@ -12,7 +12,7 @@ import {
   queryGenerateRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-YDGT5CAY.js";
+} from "./chunk-6QTH5NS5.js";
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-YDGT5CAY.js → chunk-6QTH5NS5.js} RENAMED Viewed

@@ -1239,6 +1239,18 @@ var ga4SocialReferralDtoSchema = z12.object({
   /** GA4 default channel group (e.g. 'Organic Social', 'Paid Social') */
   channelGroup: z12.string()
 });
+var ga4ChannelBucketDtoSchema = z12.object({
+  sessions: z12.number(),
+  sharePct: z12.number(),
+  sharePctDisplay: z12.string()
+});
+var ga4ChannelBreakdownDtoSchema = z12.object({
+  organic: ga4ChannelBucketDtoSchema,
+  social: ga4ChannelBucketDtoSchema,
+  direct: ga4ChannelBucketDtoSchema,
+  ai: ga4ChannelBucketDtoSchema,
+  other: ga4ChannelBucketDtoSchema
+});
 var ga4TrafficSummaryDtoSchema = z12.object({
   totalSessions: z12.number(),
   totalOrganicSessions: z12.number(),
@@ -1259,20 +1271,22 @@ var ga4TrafficSummaryDtoSchema = z12.object({
   aiSessionsDeduped: z12.number(),
   /** Deduped AI user total: MAX(users) per date+source+medium across attribution dimensions, then summed. */
   aiUsersDeduped: z12.number(),
-  /** AI sessions whose CURRENT sessionSource matched an AI engine. Disjoint from Direct/Organic/Social — safe for the channel breakdown. */
+  /** AI sessions whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals; `channelBreakdown` removes those overlaps for display. */
   aiSessionsBySession: z12.number(),
-  /** AI users whose CURRENT sessionSource matched an AI engine. Disjoint from Direct/Organic/Social — safe for the channel breakdown. */
+  /** AI users whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals. */
   aiUsersBySession: z12.number(),
   socialReferrals: z12.array(ga4SocialReferralDtoSchema),
   /** Total social sessions (session-scoped, no cross-dimension dedup needed). */
   socialSessions: z12.number(),
   /** Total social users (session-scoped, no cross-dimension dedup needed). */
   socialUsers: z12.number(),
+  /** Five disjoint buckets used for the channel breakdown. Known AI session-source matches are removed from their native GA4 bucket before shares are computed. */
+  channelBreakdown: ga4ChannelBreakdownDtoSchema,
   /** Organic sessions as a percentage of total sessions (0–100, rounded). */
   organicSharePct: z12.number(),
   /** Deduped AI sessions as a percentage of total sessions (0–100, rounded). Cross-cutting: can overlap with Direct/Organic/Social. */
   aiSharePct: z12.number(),
-  /** Session-source-only AI sessions as a percentage of total sessions (0–100, rounded). Disjoint from Direct/Organic/Social. */
+  /** Session-source-only AI sessions as a percentage of total sessions (0–100, rounded). Can overlap with raw Organic/Social/Direct totals. */
   aiSharePctBySession: z12.number(),
   /** Direct-channel sessions as a percentage of total sessions (0–100, rounded). */
   directSharePct: z12.number(),
@@ -1288,6 +1302,12 @@ var ga4TrafficSummaryDtoSchema = z12.object({
   directSharePctDisplay: z12.string(),
   /** Display string for socialSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
   socialSharePctDisplay: z12.string(),
+  /** Sessions not covered by Organic, Social, Direct, or AI (session) channels — e.g. Referral, Email, Paid Search, Display. Always non-negative; clamped to 0 when the four disjoint channels sum above total (rounding edge). */
+  otherSessions: z12.number(),
+  /** Other sessions as a percentage of total sessions (0–100, rounded). */
+  otherSharePct: z12.number(),
+  /** Display string for otherSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
+  otherSharePctDisplay: z12.string(),
   lastSyncedAt: z12.string().nullable()
 });
 var ga4AiReferralHistoryEntrySchema = z12.object({
@@ -2232,6 +2252,48 @@ var trafficSyncResponseSchema = z20.object({
   windowEnd: z20.string()
 });
+// ../contracts/src/formatting.ts
+function formatRatio(value) {
+  if (!Number.isFinite(value) || value === 0) return "0%";
+  return `${(value * 100).toFixed(1)}%`;
+}
+function formatNumber(value) {
+  if (!Number.isFinite(value)) return "\u2014";
+  if (Math.abs(value) >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (Math.abs(value) >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
+  return value.toLocaleString("en-US");
+}
+function formatDate(iso) {
+  if (!iso) return "\u2014";
+  try {
+    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(iso);
+    const options = { month: "short", day: "numeric", year: "numeric" };
+    const d = dateOnly && dateOnly[1] && dateOnly[2] && dateOnly[3] ? new Date(Date.UTC(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))) : new Date(iso);
+    if (Number.isNaN(d.getTime())) return iso;
+    return d.toLocaleDateString("en-US", dateOnly ? { ...options, timeZone: "UTC" } : options);
+  } catch {
+    return iso;
+  }
+}
+function formatIsoDate(iso) {
+  if (!iso) return "\u2014";
+  try {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime())) return iso;
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
+    const dd = String(d.getUTCDate()).padStart(2, "0");
+    return `${yyyy}-${mm}-${dd}`;
+  } catch {
+    return iso;
+  }
+}
+function formatDateRange(start, end) {
+  if (!start && !end) return "";
+  if (start && end) return `${formatDate(start)} \u2192 ${formatDate(end)}`;
+  return formatDate(start || end);
+}
 export {
   __export,
   providerQuotaPolicySchema,
@@ -2326,5 +2388,10 @@ export {
   TrafficEvidenceKinds,
   TrafficEventConfidences,
   TrafficSourceStatuses,
-  TrafficSourceAuthModes
+  TrafficSourceAuthModes,
+  formatRatio,
+  formatNumber,
+  formatDate,
+  formatIsoDate,
+  formatDateRange
 };

package/dist/{chunk-DCE3B6KD.js → chunk-7HBZCGRL.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-YDGT5CAY.js";
+} from "./chunk-6QTH5NS5.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -358,6 +358,8 @@ var gaAiReferrals = sqliteTable("ga_ai_referrals", {
   medium: text("medium").notNull(),
   /** Which GA4 dimension produced this row: 'session' | 'first_user' | 'manual_utm' */
   sourceDimension: text("source_dimension").notNull().default("session"),
+  /** GA4 default channel group for the session (e.g. 'Referral', 'Organic Social'). */
+  channelGroup: text("channel_group").notNull().default("(not set)"),
   landingPage: text("landing_page").notNull().default("(not set)"),
   landingPageNormalized: text("landing_page_normalized"),
   sessions: integer("sessions").notNull().default(0),
@@ -368,7 +370,7 @@ var gaAiReferrals = sqliteTable("ga_ai_referrals", {
   index("idx_ga_ai_ref_project_date").on(table.projectId, table.date),
   index("idx_ga_ai_ref_source").on(table.source),
   index("idx_ga_ai_ref_landing_page").on(table.projectId, table.date, table.landingPageNormalized),
-  uniqueIndex("idx_ga_ai_ref_unique_v3").on(table.projectId, table.date, table.source, table.medium, table.sourceDimension, table.landingPage),
+  uniqueIndex("idx_ga_ai_ref_unique_v4").on(table.projectId, table.date, table.source, table.medium, table.sourceDimension, table.channelGroup, table.landingPage),
   index("idx_ga_ai_ref_run").on(table.syncRunId)
 ]);
 var gaSocialReferrals = sqliteTable("ga_social_referrals", {
@@ -1570,6 +1572,20 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_raw_event_samples_source_ts ON raw_event_samples(source_id, ts)`,
       `CREATE INDEX IF NOT EXISTS idx_raw_event_samples_event_type ON raw_event_samples(event_type)`
     ]
+  },
+  {
+    version: 50,
+    name: "ga-ai-referral-channel-group",
+    statements: [],
+    run: (tx) => {
+      if (!tableExists(tx, "ga_ai_referrals")) return;
+      if (!columnExists(tx, "ga_ai_referrals", "channel_group")) {
+        tx.run(sql.raw(`ALTER TABLE ga_ai_referrals ADD COLUMN channel_group TEXT NOT NULL DEFAULT '(not set)'`));
+      }
+      tx.run(sql.raw(`DROP INDEX IF EXISTS idx_ga_ai_ref_unique_v3`));
+      tx.run(sql.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_ai_ref_unique_v4
+         ON ga_ai_referrals(project_id, date, source, medium, source_dimension, channel_group, landing_page)`));
+    }
   }
 ];
 function isDuplicateColumnError(err) {