@ainyc/canonry 1.41.0 → 1.45.0

package/dist/{chunk-EUBC5EGC.js → chunk-SVPQUYTG.js}

@@ -19,11 +19,13 @@ __export(schema_exports, {
   apiKeys: () => apiKeys,
   auditLog: () => auditLog,
   bingConnections: () => bingConnections,
+  bingCoverageSnapshots: () => bingCoverageSnapshots,
   bingKeywordStats: () => bingKeywordStats,
   bingUrlInspections: () => bingUrlInspections,
   competitors: () => competitors,
   gaAiReferrals: () => gaAiReferrals,
   gaConnections: () => gaConnections,
+  gaSocialReferrals: () => gaSocialReferrals,
   gaTrafficSnapshots: () => gaTrafficSnapshots,
   gaTrafficSummaries: () => gaTrafficSummaries,
   googleConnections: () => googleConnections,
@@ -237,6 +239,17 @@ var gscCoverageSnapshots = sqliteTable("gsc_coverage_snapshots", {
   index("idx_gsc_coverage_snap_project_date").on(table.projectId, table.date),
   index("idx_gsc_coverage_snap_run").on(table.syncRunId)
 ]);
+var bingCoverageSnapshots = sqliteTable("bing_coverage_snapshots", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  date: text("date").notNull(),
+  indexed: integer("indexed").notNull().default(0),
+  notIndexed: integer("not_indexed").notNull().default(0),
+  unknown: integer("unknown").notNull().default(0),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  uniqueIndex("idx_bing_coverage_snap_project_date").on(table.projectId, table.date)
+]);
 var bingConnections = sqliteTable("bing_connections", {
   id: text("id").primaryKey(),
   domain: text("domain").notNull(),
@@ -318,6 +331,22 @@ var gaAiReferrals = sqliteTable("ga_ai_referrals", {
   index("idx_ga_ai_ref_source").on(table.source),
   uniqueIndex("idx_ga_ai_ref_unique_v2").on(table.projectId, table.date, table.source, table.medium, table.sourceDimension)
 ]);
+var gaSocialReferrals = sqliteTable("ga_social_referrals", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  date: text("date").notNull(),
+  source: text("source").notNull(),
+  medium: text("medium").notNull(),
+  /** GA4 default channel group (e.g. 'Organic Social', 'Paid Social') */
+  channelGroup: text("channel_group").notNull().default("Organic Social"),
+  sessions: integer("sessions").notNull().default(0),
+  users: integer("users").notNull().default(0),
+  syncedAt: text("synced_at").notNull()
+}, (table) => [
+  index("idx_ga_social_ref_project_date").on(table.projectId, table.date),
+  index("idx_ga_social_ref_source").on(table.source),
+  uniqueIndex("idx_ga_social_ref_unique").on(table.projectId, table.date, table.source, table.medium, table.channelGroup)
+]);
 var gaTrafficSummaries = sqliteTable("ga_traffic_summaries", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
@@ -762,7 +791,34 @@ var MIGRATIONS = [
   `ALTER TABLE insights ADD COLUMN run_id TEXT REFERENCES runs(id) ON DELETE CASCADE`,
   `CREATE INDEX IF NOT EXISTS idx_insights_run ON insights(run_id)`,
   `ALTER TABLE health_snapshots ADD COLUMN run_id TEXT REFERENCES runs(id) ON DELETE CASCADE`,
-  `CREATE INDEX IF NOT EXISTS idx_health_snapshots_run ON health_snapshots(run_id)`
+  `CREATE INDEX IF NOT EXISTS idx_health_snapshots_run ON health_snapshots(run_id)`,
+  // v25: Social media referral tracking — ga_social_referrals table
+  // Uses GA4's native sessionDefaultChannelGroup for social classification
+  `CREATE TABLE IF NOT EXISTS ga_social_referrals (
+    id              TEXT PRIMARY KEY,
+    project_id      TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    date            TEXT NOT NULL,
+    source          TEXT NOT NULL,
+    medium          TEXT NOT NULL,
+    channel_group   TEXT NOT NULL DEFAULT 'Organic Social',
+    sessions        INTEGER NOT NULL DEFAULT 0,
+    users           INTEGER NOT NULL DEFAULT 0,
+    synced_at       TEXT NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_ga_social_ref_project_date ON ga_social_referrals(project_id, date)`,
+  `CREATE INDEX IF NOT EXISTS idx_ga_social_ref_source ON ga_social_referrals(source)`,
+  `CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_social_ref_unique ON ga_social_referrals(project_id, date, source, medium, channel_group)`,
+  // v26: Bing coverage snapshots for historical tracking (mirrors gsc_coverage_snapshots)
+  `CREATE TABLE IF NOT EXISTS bing_coverage_snapshots (
+    id              TEXT PRIMARY KEY,
+    project_id      TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    date            TEXT NOT NULL,
+    indexed         INTEGER NOT NULL DEFAULT 0,
+    not_indexed     INTEGER NOT NULL DEFAULT 0,
+    unknown         INTEGER NOT NULL DEFAULT 0,
+    created_at      TEXT NOT NULL
+  )`,
+  `CREATE UNIQUE INDEX IF NOT EXISTS idx_bing_coverage_snap_project_date ON bing_coverage_snapshots(project_id, date)`
 ];
 function isDuplicateColumnError(err) {
   if (!(err instanceof Error)) return false;
@@ -1206,9 +1262,11 @@ export {
   gscSearchData,
   gscUrlInspections,
   gscCoverageSnapshots,
+  bingCoverageSnapshots,
   bingUrlInspections,
   gaTrafficSnapshots,
   gaAiReferrals,
+  gaSocialReferrals,
   gaTrafficSummaries,
   usageCounters,
   insights,

package/dist/cli.js

@@ -28,7 +28,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-TKMBOLZB.js";
+} from "./chunk-B4EP44AR.js";
 import {
   apiKeys,
   competitors,
@@ -38,7 +38,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-EUBC5EGC.js";
+} from "./chunk-SVPQUYTG.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -355,7 +355,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   console.log(`  Errors:   ${providerErrors}`);
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-DXGTIRF5.js");
+  const { IntelligenceService } = await import("./intelligence-service-TXWOESFH.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -619,6 +619,7 @@ var ApiClient = class {
     const serializedBody = body != null ? JSON.stringify(body) : void 0;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
+      "Accept": "application/json",
       ...serializedBody != null ? { "Content-Type": "application/json" } : {}
     };
     let res;
@@ -860,6 +861,10 @@ var ApiClient = class {
   async bingCoverage(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/coverage`);
   }
+  async bingCoverageHistory(project, params) {
+    const qs = params?.limit != null ? `?limit=${params.limit}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/coverage/history${qs}`);
+  }
   async bingInspections(project, params) {
     const qs = params ? "?" + new URLSearchParams(params).toString() : "";
     return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/inspections${qs}`);
@@ -907,6 +912,15 @@ var ApiClient = class {
   async gaAiReferralHistory(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/ai-referral-history`);
   }
+  async gaSocialReferralHistory(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-history`);
+  }
+  async gaSocialReferralTrend(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-trend`);
+  }
+  async gaAttributionTrend(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/attribution-trend`);
+  }
   async gaSessionHistory(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/session-history`);
   }
@@ -1143,6 +1157,26 @@ Bing Index Coverage for "${project}"
     console.log(`  Last inspected: ${result.lastInspectedAt}`);
   }
 }
+async function bingCoverageHistory(project, opts) {
+  const client = getClient();
+  const rows = await client.bingCoverageHistory(project, { limit: opts.limit });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (rows.length === 0) {
+    console.log('No coverage history found. Run "canonry bing coverage" or "canonry bing refresh" first to capture a snapshot.');
+    return;
+  }
+  console.log(`
+Bing Coverage History for "${project}" (${rows.length} snapshots):
+`);
+  console.log(`  ${"DATE".padEnd(12)}${"INDEXED".padEnd(10)}${"NOT INDEXED".padEnd(14)}UNKNOWN`);
+  console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(14)}${"\u2500".repeat(10)}`);
+  for (const row of rows) {
+    console.log(`  ${row.date.padEnd(12)}${String(row.indexed).padEnd(10)}${String(row.notIndexed).padEnd(14)}${String(row.unknown)}`);
+  }
+}
 async function bingInspect(project, url, format) {
   const client = getClient();
   const result = await client.bingInspectUrl(project, url);
@@ -1343,6 +1377,22 @@ var BING_CLI_COMMANDS = [
       await bingSetSite(project, siteUrl, input.format);
     }
   },
+  {
+    path: ["bing", "coverage-history"],
+    usage: "canonry bing coverage-history <project> [--limit <n>] [--format json]",
+    options: { limit: stringOption() },
+    run: async (input) => {
+      const project = requireProject(input, "bing.coverage-history", "canonry bing coverage-history <project> [--limit <n>] [--format json]");
+      await bingCoverageHistory(project, {
+        limit: parseIntegerOption(input, "limit", {
+          command: "bing.coverage-history",
+          message: "--limit must be a positive integer",
+          usage: "canonry bing coverage-history <project> [--limit <n>] [--format json]"
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["bing", "coverage"],
     usage: "canonry bing coverage <project> [--format json]",
@@ -1422,12 +1472,12 @@ var BING_CLI_COMMANDS = [
   },
   {
     path: ["bing"],
-    usage: "canonry bing <connect|disconnect|status|sites|set-site|coverage|inspect|inspections|request-indexing|performance|refresh> <project> [args]",
+    usage: "canonry bing <connect|disconnect|status|sites|set-site|coverage|coverage-history|inspect|inspections|request-indexing|performance|refresh> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "bing",
-        usage: "canonry bing <connect|disconnect|status|sites|set-site|coverage|inspect|inspections|request-indexing|performance|refresh> <project> [args]",
-        available: ["connect", "disconnect", "status", "sites", "set-site", "coverage", "inspect", "inspections", "request-indexing", "performance", "refresh"]
+        usage: "canonry bing <connect|disconnect|status|sites|set-site|coverage|coverage-history|inspect|inspections|request-indexing|performance|refresh> <project> [args]",
+        available: ["connect", "disconnect", "status", "sites", "set-site", "coverage", "coverage-history", "inspect", "inspections", "request-indexing", "performance", "refresh"]
       });
     }
   }
@@ -1709,14 +1759,21 @@ async function gaStatus(project, format) {
 }
 async function gaSync(project, opts) {
   const client = getClient3();
-  const result = await client.gaSync(project, { days: opts?.days });
+  const body = {};
+  if (opts?.days) body.days = opts.days;
+  if (opts?.only) body.only = opts.only;
+  const result = await client.gaSync(project, body);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
   console.log(`GA4 sync complete for "${project}".`);
+  if (result.syncedComponents) {
+    console.log(`  Components:  ${result.syncedComponents.join(", ")}`);
+  }
   console.log(`  Page rows:   ${result.rowCount}`);
   console.log(`  AI rows:     ${result.aiReferralCount}`);
+  console.log(`  Social rows: ${result.socialReferralCount}`);
   console.log(`  Period:      ${result.days} days`);
   console.log(`  Synced at:   ${result.syncedAt}`);
 }
@@ -1729,7 +1786,7 @@ async function gaTraffic(project, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  if (result.topPages.length === 0 && result.aiReferrals.length === 0) {
+  if (result.topPages.length === 0 && result.aiReferrals.length === 0 && result.socialReferrals.length === 0) {
     console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
     return;
   }
@@ -1756,6 +1813,23 @@ async function gaTraffic(project, opts) {
     }
     console.log();
   }
+  if (result.socialReferrals.length > 0) {
+    const chanWidth = 12;
+    if (result.socialSessions > 0) {
+      const share = result.totalSessions > 0 ? Math.round(result.socialSessions / result.totalSessions * 100) : 0;
+      console.log(`  Social Sessions:         ${result.socialSessions} (${share}% of total)`);
+    }
+    console.log("  SOCIAL REFERRAL SOURCES");
+    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}${"USERS".padEnd(8)}`);
+    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+    for (const ref of result.socialReferrals) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(
+        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${chanLabel.padEnd(chanWidth)}  ${String(ref.sessions).padEnd(10)}${String(ref.users).padEnd(8)}`
+      );
+    }
+    console.log();
+  }
   if (result.topPages.length > 0) {
     const pageWidth = Math.min(60, Math.max(15, ...result.topPages.map((r) => r.landingPage.length)));
     console.log(`  TOP LANDING PAGES`);
@@ -1798,6 +1872,31 @@ async function gaAiReferralHistory(project, format) {
     );
   }
 }
+async function gaSocialReferralHistory(project, format) {
+  const client = getClient3();
+  const result = await client.gaSocialReferralHistory(project);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (result.length === 0) {
+    console.log('No social referral history. Run "canonry ga sync <project>" first.');
+    return;
+  }
+  const dateWidth = 12;
+  const sourceWidth = Math.min(30, Math.max(10, ...result.map((r) => r.source.length)));
+  const chanWidth = 12;
+  console.log(`GA4 Social Referral History for "${project}":
+`);
+  console.log(`  ${"DATE".padEnd(dateWidth)}  ${"SOURCE".padEnd(sourceWidth)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}${"USERS".padEnd(8)}`);
+  console.log(`  ${"\u2500".repeat(dateWidth)}  ${"\u2500".repeat(sourceWidth)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+  for (const row of result) {
+    const chanLabel = row.channelGroup === "Paid Social" ? "paid" : "organic";
+    console.log(
+      `  ${row.date.padEnd(dateWidth)}  ${row.source.padEnd(sourceWidth)}  ${chanLabel.padEnd(chanWidth)}  ${String(row.sessions).padEnd(10)}${String(row.users).padEnd(8)}`
+    );
+  }
+}
 async function gaCoverage(project, format) {
   const client = getClient3();
   const result = await client.gaCoverage(project);
@@ -1821,6 +1920,182 @@ async function gaCoverage(project, format) {
     );
   }
 }
+async function gaSocialReferralSummary(project, opts) {
+  const client = getClient3();
+  const traffic = await client.gaTraffic(project);
+  if (opts?.trend) {
+    const trend = await client.gaSocialReferralTrend(project);
+    if (opts.format === "json") {
+      console.log(JSON.stringify({
+        socialSessions: traffic.socialSessions,
+        socialUsers: traffic.socialUsers,
+        totalSessions: traffic.totalSessions,
+        socialSharePct: traffic.socialSharePct,
+        topSources: traffic.socialReferrals.slice(0, 5).map((r) => ({ source: r.source, sessions: r.sessions, channel: r.channelGroup })),
+        trend
+      }, null, 2));
+      return;
+    }
+    console.log(`Social Traffic Summary for "${project}"
+`);
+    console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+    console.log(`  Users:    ${traffic.socialUsers}`);
+    console.log();
+    const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+    console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
+    console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
+    if (trend.biggestMover) {
+      const m = trend.biggestMover;
+      console.log(`  Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d})`);
+    }
+    console.log();
+    if (traffic.socialReferrals.length > 0) {
+      console.log("  TOP SOURCES");
+      for (const ref of traffic.socialReferrals.slice(0, 5)) {
+        const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+        console.log(`    ${ref.source.padEnd(20)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+      }
+    }
+    return;
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify({
+      socialSessions: traffic.socialSessions,
+      socialUsers: traffic.socialUsers,
+      totalSessions: traffic.totalSessions,
+      socialSharePct: traffic.socialSharePct,
+      topSources: traffic.socialReferrals.slice(0, 5).map((r) => ({ source: r.source, sessions: r.sessions, channel: r.channelGroup }))
+    }, null, 2));
+    return;
+  }
+  console.log(`Social Traffic Summary for "${project}"
+`);
+  console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+  console.log(`  Users:    ${traffic.socialUsers}`);
+  if (traffic.socialReferrals.length > 0) {
+    console.log();
+    console.log("  TOP SOURCES");
+    for (const ref of traffic.socialReferrals.slice(0, 5)) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(`    ${ref.source.padEnd(20)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+    }
+  }
+}
+async function gaAttribution(project, opts) {
+  const client = getClient3();
+  const traffic = await client.gaTraffic(project);
+  const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+  if (opts?.trend) {
+    const trend = await client.gaAttributionTrend(project);
+    if (opts.format === "json") {
+      console.log(JSON.stringify({
+        totalSessions: traffic.totalSessions,
+        totalUsers: traffic.totalUsers,
+        organicSessions: traffic.totalOrganicSessions,
+        aiSessions: traffic.aiSessionsDeduped,
+        aiUsers: traffic.aiUsersDeduped,
+        socialSessions: traffic.socialSessions,
+        socialUsers: traffic.socialUsers,
+        aiSharePct: traffic.aiSharePct,
+        socialSharePct: traffic.socialSharePct,
+        organicSharePct: traffic.organicSharePct,
+        aiReferrals: traffic.aiReferrals,
+        socialReferrals: traffic.socialReferrals,
+        trend
+      }, null, 2));
+      return;
+    }
+    if (traffic.totalSessions === 0) {
+      console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
+      return;
+    }
+    console.log(`GA4 Attribution Overview for "${project}"
+`);
+    console.log(`  Total Sessions:   ${traffic.totalSessions}`);
+    console.log(`  Total Users:      ${traffic.totalUsers}`);
+    console.log();
+    console.log("  CHANNEL BREAKDOWN                  7d trend     30d trend");
+    console.log(`    Organic Search: ${String(traffic.totalOrganicSessions).padEnd(6)} (${String(traffic.organicSharePct).padStart(2)}%)    ${fmtTrend(trend.organic.trend7dPct).padEnd(12)} ${fmtTrend(trend.organic.trend30dPct)}`);
+    console.log(`    AI Referrals:   ${String(traffic.aiSessionsDeduped).padEnd(6)} (${String(traffic.aiSharePct).padStart(2)}%)    ${fmtTrend(trend.ai.trend7dPct).padEnd(12)} ${fmtTrend(trend.ai.trend30dPct)}`);
+    console.log(`    Social:         ${String(traffic.socialSessions).padEnd(6)} (${String(traffic.socialSharePct).padStart(2)}%)    ${fmtTrend(trend.social.trend7dPct).padEnd(12)} ${fmtTrend(trend.social.trend30dPct)}`);
+    const otherSessions2 = traffic.totalSessions - traffic.totalOrganicSessions - traffic.aiSessionsDeduped - traffic.socialSessions;
+    if (otherSessions2 > 0) {
+      const otherPct = traffic.totalSessions > 0 ? Math.round(otherSessions2 / traffic.totalSessions * 100) : 0;
+      console.log(`    Other:          ${String(otherSessions2).padEnd(6)} (${String(otherPct).padStart(2)}%)`);
+    }
+    console.log(`    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+    console.log(`    Total:          ${String(traffic.totalSessions).padEnd(6)}         ${fmtTrend(trend.total.trend7dPct).padEnd(12)} ${fmtTrend(trend.total.trend30dPct)}`);
+    if (trend.aiBiggestMover) {
+      const m = trend.aiBiggestMover;
+      console.log(`
+  AI Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+    }
+    if (trend.socialBiggestMover) {
+      const m = trend.socialBiggestMover;
+      console.log(`  Social Mover: ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+    }
+    if (traffic.lastSyncedAt) {
+      console.log(`
+  Last synced: ${traffic.lastSyncedAt}`);
+    }
+    return;
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify({
+      totalSessions: traffic.totalSessions,
+      totalUsers: traffic.totalUsers,
+      organicSessions: traffic.totalOrganicSessions,
+      aiSessions: traffic.aiSessionsDeduped,
+      aiUsers: traffic.aiUsersDeduped,
+      socialSessions: traffic.socialSessions,
+      socialUsers: traffic.socialUsers,
+      aiSharePct: traffic.aiSharePct,
+      socialSharePct: traffic.socialSharePct,
+      organicSharePct: traffic.organicSharePct,
+      aiReferrals: traffic.aiReferrals,
+      socialReferrals: traffic.socialReferrals
+    }, null, 2));
+    return;
+  }
+  if (traffic.totalSessions === 0) {
+    console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
+    return;
+  }
+  console.log(`GA4 Attribution Overview for "${project}"
+`);
+  console.log(`  Total Sessions:   ${traffic.totalSessions}`);
+  console.log(`  Total Users:      ${traffic.totalUsers}`);
+  console.log();
+  console.log("  CHANNEL BREAKDOWN");
+  console.log(`    Organic Search: ${traffic.totalOrganicSessions} sessions (${traffic.organicSharePct}%)`);
+  console.log(`    AI Referrals:   ${traffic.aiSessionsDeduped} sessions (${traffic.aiSharePct}%)`);
+  console.log(`    Social:         ${traffic.socialSessions} sessions (${traffic.socialSharePct}%)`);
+  const otherSessions = traffic.totalSessions - traffic.totalOrganicSessions - traffic.aiSessionsDeduped - traffic.socialSessions;
+  if (otherSessions > 0) {
+    const otherPct = traffic.totalSessions > 0 ? Math.round(otherSessions / traffic.totalSessions * 100) : 0;
+    console.log(`    Other:          ${otherSessions} sessions (${otherPct}%)`);
+  }
+  if (traffic.aiReferrals.length > 0) {
+    console.log();
+    console.log("  AI SOURCES");
+    for (const ref of traffic.aiReferrals.slice(0, 10)) {
+      const dimLabel = ref.sourceDimension === "first_user" ? "first-visit" : ref.sourceDimension === "manual_utm" ? "utm" : "session";
+      console.log(`    ${ref.source.padEnd(25)} ${String(ref.sessions).padEnd(8)} sessions  (${dimLabel})`);
+    }
+  }
+  if (traffic.socialReferrals.length > 0) {
+    console.log();
+    console.log("  SOCIAL SOURCES");
+    for (const ref of traffic.socialReferrals.slice(0, 10)) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(`    ${ref.source.padEnd(25)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+    }
+  }
+  if (traffic.lastSyncedAt) {
+    console.log(`
+  Last synced: ${traffic.lastSyncedAt}`);
+  }
+}
 
 // src/cli-commands/ga.ts
 var GA_CLI_COMMANDS = [
@@ -1864,16 +2139,19 @@ var GA_CLI_COMMANDS = [
   },
   {
     path: ["ga", "sync"],
-    usage: "canonry ga sync <project> [--days 30] [--format json]",
+    usage: "canonry ga sync <project> [--days 30] [--only traffic|ai|social] [--format json]",
     options: {
-      days: stringOption()
+      days: stringOption(),
+      only: stringOption()
     },
     run: async (input) => {
-      const project = requireProject(input, "ga.sync", "canonry ga sync <project> [--days 30] [--format json]");
+      const project = requireProject(input, "ga.sync", "canonry ga sync <project> [--days 30] [--only traffic|ai|social] [--format json]");
       const daysStr = getString(input.values, "days");
       const days = daysStr ? parseInt(daysStr, 10) : void 0;
+      const only = getString(input.values, "only");
       await gaSync(project, {
         days,
+        only,
         format: input.format
       });
     }
@@ -1910,14 +2188,50 @@ var GA_CLI_COMMANDS = [
       await gaAiReferralHistory(project, input.format);
     }
   },
+  {
+    path: ["ga", "social-referral-history"],
+    usage: "canonry ga social-referral-history <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "ga.social-referral-history", "canonry ga social-referral-history <project> [--format json]");
+      await gaSocialReferralHistory(project, input.format);
+    }
+  },
+  {
+    path: ["ga", "social-referral-summary"],
+    usage: "canonry ga social-referral-summary <project> [--trend] [--format json]",
+    options: {
+      trend: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.social-referral-summary", "canonry ga social-referral-summary <project> [--trend] [--format json]");
+      await gaSocialReferralSummary(project, {
+        trend: input.values.trend === true,
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["ga", "attribution"],
+    usage: "canonry ga attribution <project> [--trend] [--format json]",
+    options: {
+      trend: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.attribution", "canonry ga attribution <project> [--trend] [--format json]");
+      await gaAttribution(project, {
+        trend: input.values.trend === true,
+        format: input.format
+      });
+    }
+  },
   {
     path: ["ga"],
-    usage: "canonry ga <connect|disconnect|status|sync|traffic|coverage|ai-referral-history> <project> [args]",
+    usage: "canonry ga <subcommand> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "ga",
-        usage: "canonry ga <connect|disconnect|status|sync|traffic|coverage|ai-referral-history> <project> [args]",
-        available: ["connect", "disconnect", "status", "sync", "traffic", "coverage", "ai-referral-history"]
+        usage: "canonry ga <subcommand> <project> [args]",
+        available: ["connect", "disconnect", "status", "sync", "traffic", "coverage", "ai-referral-history", "social-referral-history", "social-referral-summary", "attribution"]
       });
     }
   }
@@ -4016,7 +4330,7 @@ async function triggerRun(project, opts) {
       console.log(`  ${loc}  ${id}  ${r.status}`);
     }
     if (opts?.wait) {
-      const pending = locationRuns.filter((r) => r.id && r.status !== "conflict");
+      const pending = locationRuns.filter((r) => r.id && r.status !== "conflict" && !TERMINAL_STATUSES.has(r.status));
       if (pending.length > 0) {
         process.stderr.write(`Waiting for ${pending.length} run(s)`);
         await Promise.all(
@@ -4036,7 +4350,7 @@ async function triggerRun(project, opts) {
     return;
   }
   const run = response;
-  if (opts?.wait) {
+  if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
     process.stderr.write(`Run ${run.id} started`);
     const result = await pollRun(client, run.id);
     if (opts?.format === "json") {
@@ -4047,6 +4361,15 @@ async function triggerRun(project, opts) {
     }
     return;
   }
+  if (opts?.wait && (TERMINAL_STATUSES.has(run.status) || !run.id)) {
+    const result = run.id ? await client.getRun(run.id) : run;
+    if (opts?.format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      printRunDetail(result);
+    }
+    return;
+  }
   if (opts?.format === "json") {
     console.log(JSON.stringify(run, null, 2));
     return;
@@ -5219,7 +5542,7 @@ var SNAPSHOT_CLI_COMMANDS = [
 // src/commands/insights.ts
 async function listInsights(project, opts) {
   const client = createApiClient();
-  const insights = await client.getInsights(project, { dismissed: opts.dismissed });
+  const insights = await client.getInsights(project, { dismissed: opts.dismissed, runId: opts.runId });
   if (opts.format === "json") {
     console.log(JSON.stringify(insights, null, 2));
     return;
@@ -5296,15 +5619,17 @@ async function showHealth(project, opts) {
 var INTELLIGENCE_CLI_COMMANDS = [
   {
     path: ["insights"],
-    usage: "canonry insights <project> [--dismissed] [--format json]",
+    usage: "canonry insights <project> [--dismissed] [--run-id <id>] [--format json]",
     options: {
-      dismissed: { type: "boolean" }
+      dismissed: { type: "boolean" },
+      "run-id": { type: "string" }
     },
     run: async (input) => {
-      const usage = "canonry insights <project> [--dismissed] [--format json]";
+      const usage = "canonry insights <project> [--dismissed] [--run-id <id>] [--format json]";
       const project = requireProject(input, "insights", usage);
       const dismissed = input.values.dismissed === true;
-      await listInsights(project, { dismissed, format: input.format });
+      const runId = getString(input.values, "run-id");
+      await listInsights(project, { dismissed, runId, format: input.format });
     }
   },
   {
@@ -5329,8 +5654,11 @@ var INTELLIGENCE_CLI_COMMANDS = [
       const usage = "canonry health <project> [--history] [--limit <n>] [--format json]";
       const project = requireProject(input, "health", usage);
       const history = input.values.history === true;
-      const limitStr = getString(input.values, "limit");
-      const limit = limitStr ? Number.parseInt(limitStr, 10) : void 0;
+      const limit = parseIntegerOption(input, "limit", {
+        command: "health",
+        usage,
+        message: "--limit must be an integer"
+      });
       await showHealth(project, { history, limit, format: input.format });
     }
   }
@@ -5937,15 +6265,23 @@ async function serveCommand(format = "text") {
   const db = createClient(config.database);
   migrate(db);
   const app = await createServer({ config, db });
-  const shutdown = () => {
+  let shuttingDown = false;
+  const shutdown = (signal) => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    if (format === "text") {
+      console.log(`
+Received ${signal}, stopping server...`);
+    }
     app.close().then(() => {
       process.exit(0);
-    }).catch(() => {
+    }).catch((err) => {
+      console.error("Error during shutdown:", err);
       process.exit(1);
     });
   };
-  process.on("SIGTERM", shutdown);
-  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", () => shutdown("SIGTERM"));
+  process.on("SIGINT", () => shutdown("SIGINT"));
   try {
     await app.listen({ host, port });
     const url = `http://${host === "0.0.0.0" ? "localhost" : host}:${port}`;