@agent-native/core-corpus 0.210.2 → 0.211.0

package/corpus/templates/analytics/server/lib/content-metrics/legacy-content-view.json

@@ -0,0 +1,172 @@
+{
+  "name": "Content",
+  "description": "Blog articles with authors, daily GA4 pageviews, and Search Console clicks and impressions, from Analytics' daily content collection. Reads only Analytics' own tables, so opening it calls no provider.",
+  "filters": [
+    {
+      "id": "timeRange",
+      "type": "select",
+      "label": "Time range",
+      "default": "28d",
+      "options": [
+        {
+          "value": "7d",
+          "label": "Last 7 days"
+        },
+        {
+          "value": "28d",
+          "label": "Last 28 days"
+        },
+        {
+          "value": "90d",
+          "label": "Last 90 days"
+        },
+        {
+          "value": "all",
+          "label": "All time"
+        }
+      ]
+    }
+  ],
+  "panels": [
+    {
+      "id": "collection-status",
+      "title": "Collection",
+      "chartType": "table",
+      "source": "first-party",
+      "width": 3,
+      "sql": "WITH latest AS ( SELECT step, status, started_at, window_end, error_message FROM ( SELECT step, status, started_at, window_end, error_message, ROW_NUMBER() OVER (PARTITION BY step ORDER BY started_at DESC) AS rn FROM analytics_content_collection_runs ) ranked WHERE rn = 1 ) SELECT CASE step WHEN 'builder_blog' THEN 'Blog articles' WHEN 'ga4' THEN 'GA4 pageviews' WHEN 'search_console' THEN 'Search Console' ELSE step END AS source, CASE status WHEN 'succeeded' THEN 'Collected' WHEN 'failed' THEN 'Failed' WHEN 'cost_limited' THEN 'Cost-limited' WHEN 'not_configured' THEN 'Not set up' WHEN 'running' THEN 'Running' ELSE status END AS status, started_at AS last_run, window_end AS data_through, error_message AS detail FROM latest ORDER BY CASE step WHEN 'builder_blog' THEN 1 WHEN 'ga4' THEN 2 WHEN 'search_console' THEN 3 ELSE 4 END",
+      "config": {
+        "timeScope": "fixed-window",
+        "description": "Each source's latest daily run. Data through is the last day that source reported; Search Console runs two to three days behind.",
+        "columns": [
+          {
+            "key": "source",
+            "label": "Source"
+          },
+          {
+            "key": "status",
+            "label": "Status"
+          },
+          {
+            "key": "last_run",
+            "label": "Last run",
+            "format": "date"
+          },
+          {
+            "key": "data_through",
+            "label": "Data through"
+          },
+          {
+            "key": "detail",
+            "label": "Detail"
+          }
+        ]
+      }
+    },
+    {
+      "id": "articles",
+      "title": "Articles",
+      "chartType": "table",
+      "source": "first-party",
+      "width": 3,
+      "sql": "WITH latest AS ( SELECT step, status, started_at, window_end, error_message FROM ( SELECT step, status, started_at, window_end, error_message, ROW_NUMBER() OVER (PARTITION BY step ORDER BY started_at DESC) AS rn FROM analytics_content_collection_runs ) ranked WHERE rn = 1 ), totals AS ( SELECT item_id, SUM(value) FILTER (WHERE metric = 'ga4_pageviews') AS pageviews, COUNT(*) FILTER (WHERE metric = 'ga4_pageviews') AS pageview_rows, SUM(value) FILTER (WHERE metric = 'search_console_clicks') AS clicks, SUM(value) FILTER (WHERE metric = 'search_console_impressions') AS impressions, COUNT(*) FILTER (WHERE metric = 'search_console_clicks') AS search_rows FROM analytics_content_metric_snapshots WHERE (metric_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND metric_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '28d' AND metric_date >= to_char(CURRENT_DATE - INTERVAL '28 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND metric_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND metric_date >= '{{timeRangeStart}}' AND metric_date <= '{{timeRangeEnd}}'))) GROUP BY item_id ) SELECT title, href, author, published, pageviews, clicks, impressions, NULLIF(COALESCE(ga4_missing, '') || CASE WHEN ga4_missing IS NOT NULL AND search_missing IS NOT NULL THEN ' · ' ELSE '' END || COALESCE(search_missing, ''), '') AS not_collected FROM ( SELECT i.title, i.url AS href, i.author, i.published_at, substr(i.published_at, 1, 10) AS published, t.pageviews, t.clicks, t.impressions, CASE WHEN COALESCE(t.pageview_rows, 0) > 0 THEN NULL ELSE 'GA4: ' || CASE ga4_run.status WHEN 'failed' THEN 'failed' WHEN 'cost_limited' THEN 'cost-limited' WHEN 'not_configured' THEN 'not set up' WHEN 'running' THEN 'running' WHEN 'succeeded' THEN 'still arriving' ELSE 'not collected yet' END END AS ga4_missing, CASE WHEN COALESCE(t.search_rows, 0) > 0 THEN NULL ELSE 'Search Console: ' || CASE search_run.status WHEN 'failed' THEN 'failed' WHEN 'cost_limited' THEN 'cost-limited' WHEN 'not_configured' THEN 'not set up' WHEN 'running' THEN 'running' WHEN 'succeeded' THEN 'still arriving' ELSE 'not collected yet' END END AS search_missing FROM analytics_content_items i LEFT JOIN totals t ON t.item_id = i.id LEFT JOIN latest ga4_run ON ga4_run.step = 'ga4' LEFT JOIN latest search_run ON search_run.step = 'search_console' WHERE i.source = 'builder_blog' ) articles ORDER BY published_at DESC NULLS LAST LIMIT 1000",
+      "config": {
+        "timeScope": "dashboard",
+        "description": "Every collected blog article. A blank number means that source has no data for the article in this window; Not collected says why.",
+        "sortable": true,
+        "columns": [
+          {
+            "key": "title",
+            "label": "Article",
+            "format": "link",
+            "linkKey": "href"
+          },
+          {
+            "key": "href",
+            "hidden": true
+          },
+          {
+            "key": "author",
+            "label": "Author"
+          },
+          {
+            "key": "published",
+            "label": "Published"
+          },
+          {
+            "key": "pageviews",
+            "label": "Pageviews",
+            "format": "number"
+          },
+          {
+            "key": "clicks",
+            "label": "Search clicks",
+            "format": "number"
+          },
+          {
+            "key": "impressions",
+            "label": "Impressions",
+            "format": "number"
+          },
+          {
+            "key": "not_collected",
+            "label": "Not collected"
+          }
+        ]
+      }
+    },
+    {
+      "id": "daily-trend",
+      "title": "Daily pageviews and search clicks",
+      "chartType": "line",
+      "source": "first-party",
+      "width": 3,
+      "sql": "SELECT s.metric_date AS date, SUM(s.value) FILTER (WHERE s.metric = 'ga4_pageviews') AS pageviews, SUM(s.value) FILTER (WHERE s.metric = 'search_console_clicks') AS search_clicks FROM analytics_content_metric_snapshots s JOIN analytics_content_items i ON i.id = s.item_id WHERE i.source = 'builder_blog' AND s.metric IN ('ga4_pageviews', 'search_console_clicks') AND (s.metric_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '28d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '28 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND s.metric_date >= '{{timeRangeStart}}' AND s.metric_date <= '{{timeRangeEnd}}'))) GROUP BY s.metric_date ORDER BY s.metric_date",
+      "config": {
+        "timeScope": "dashboard",
+        "xKey": "date",
+        "yKeys": ["pageviews", "search_clicks"],
+        "seriesLabels": {
+          "pageviews": "Pageviews",
+          "search_clicks": "Search clicks"
+        },
+        "description": "All blog articles. A day a source hasn't reported is a gap, not a zero."
+      }
+    },
+    {
+      "id": "search-pages",
+      "title": "Other pages in search",
+      "chartType": "table",
+      "source": "first-party",
+      "width": 3,
+      "sql": "SELECT i.url AS page, i.url AS href, SUM(s.value) FILTER (WHERE s.metric = 'search_console_clicks') AS clicks, SUM(s.value) FILTER (WHERE s.metric = 'search_console_impressions') AS impressions FROM analytics_content_items i JOIN analytics_content_metric_snapshots s ON s.item_id = i.id WHERE i.source = 'search_console' AND (s.metric_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '28d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '28 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND s.metric_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND s.metric_date >= '{{timeRangeStart}}' AND s.metric_date <= '{{timeRangeEnd}}'))) GROUP BY i.url ORDER BY clicks DESC NULLS LAST, impressions DESC NULLS LAST LIMIT 200",
+      "config": {
+        "timeScope": "dashboard",
+        "description": "Search Console pages that aren't collected blog articles.",
+        "sortable": true,
+        "columns": [
+          {
+            "key": "page",
+            "label": "Page",
+            "format": "link",
+            "linkKey": "href"
+          },
+          {
+            "key": "href",
+            "hidden": true
+          },
+          {
+            "key": "clicks",
+            "label": "Search clicks",
+            "format": "number"
+          },
+          {
+            "key": "impressions",
+            "label": "Impressions",
+            "format": "number"
+          }
+        ]
+      }
+    }
+  ]
+}

package/corpus/templates/analytics/server/lib/content-metrics/migration.ts

@@ -65,3 +65,5 @@ export const CONTENT_METRICS_MIGRATION_SQL = [
   )`,
   `CREATE INDEX IF NOT EXISTS analytics_content_collection_runs_step_idx ON analytics_content_collection_runs (tenant_key, step, started_at)`,
 ];
+
+export const CONTENT_COVERAGE_CONFIG_MIGRATION_SQL = `ALTER TABLE analytics_content_collection_runs ADD COLUMN IF NOT EXISTS config_fingerprint TEXT`;

package/corpus/templates/analytics/server/lib/content-metrics/steps/daily-metrics.ts

@@ -25,14 +25,19 @@ export async function collectionWindow(
   step: ContentCollectionStepId,
   now: Date,
   lookbackDays: number,
+  configFingerprint?: string,
 ): Promise<{ startDate: string; endDate: string }> {
   const end = new Date(now.getTime() - DAY_MS);
   const previous = await lastSucceededContentRun(collection, step);
   const earliest = end.getTime() - (BACKFILL_DAYS - 1) * DAY_MS;
   const lookback = end.getTime() - (lookbackDays - 1) * DAY_MS;
-  const uncovered = previous?.windowEnd
-    ? new Date(`${previous.windowEnd}T00:00:00Z`).getTime() + DAY_MS
-    : earliest;
+  const sameConfig =
+    configFingerprint === undefined ||
+    previous?.configFingerprint === configFingerprint;
+  const uncovered =
+    previous?.windowEnd && sameConfig
+      ? new Date(`${previous.windowEnd}T00:00:00Z`).getTime() + DAY_MS
+      : earliest;
   const start = Math.max(earliest, Math.min(lookback, uncovered));
   return {
     startDate: utcDate(new Date(start)),

package/corpus/templates/analytics/server/lib/content-metrics/steps/search-console.ts

@@ -1,3 +1,6 @@
+import { createHash } from "node:crypto";
+
+import { normalizeSearchConsoleProperty } from "../../../../shared/search-console-property.js";
 import { querySearchAnalytics } from "../../search-console.js";
 import type { SearchConsoleSite } from "../config.js";
 import { ContentStepStop, type ContentStep } from "../step.js";
@@ -33,7 +36,7 @@ function escapeRegex(value: string): string {
 
 /** Whether a page URL belongs to a Domain or URL-prefix property. */
 export function siteCoversUrl(siteUrl: string, url: string): boolean {
-  if (siteUrl.startsWith("sc-domain:")) {
+  if (siteUrl.toLowerCase().startsWith("sc-domain:")) {
     const domain = siteUrl.slice("sc-domain:".length).toLowerCase();
     if (!URL.canParse(url)) return false;
     const host = new URL(url).hostname.toLowerCase();
@@ -59,6 +62,16 @@ export const searchConsoleStep: ContentStep = {
   id: "search_console",
   async run({ collection, now, signal }) {
     const sites = collection.config.searchConsole.sites;
+    const configFingerprint = createHash("sha256")
+      .update(
+        JSON.stringify(
+          sites.map((site) => [
+            normalizeSearchConsoleProperty(site.siteUrl),
+            site.pathPrefix?.trim() ?? "",
+          ]),
+        ),
+      )
+      .digest("hex");
     if (sites.length === 0) {
       throw new ContentStepStop({
         status: "not_configured",
@@ -82,6 +95,7 @@ export const searchConsoleStep: ContentStep = {
       "search_console",
       now,
       LOOKBACK_DAYS,
+      configFingerprint,
     );
     const newPages = new Map<string, ContentItemInput>();
     const snapshots = new Map<string, ContentSnapshotInput>();
@@ -167,9 +181,8 @@ export const searchConsoleStep: ContentStep = {
       outcome: {
         rowCount: snapshots.size,
         windowStart: window.startDate,
-        // Query coverage advances even when no rows exist. Data dates remain
-        // on the snapshots, and omitted values still have no snapshot.
         windowEnd: window.endDate,
+        configFingerprint,
       },
     };
   },

package/corpus/templates/analytics/server/lib/content-metrics/steps/signups.ts

@@ -0,0 +1,240 @@
+import {
+  BigQueryMaximumBytesBilledError,
+  dryRunQuerySchema,
+  runQuery,
+} from "../../bigquery.js";
+import type { SignupsConfig } from "../config.js";
+import { ContentStepStop, type ContentStep } from "../step.js";
+import { listContentItems } from "../store.js";
+import { BUILDER_BLOG_ORIGIN } from "./builder-blog.js";
+import { BACKFILL_DAYS, DailyMetricValues, utcDate } from "./daily-metrics.js";
+
+export const SIGNUPS_FIRST_TOUCH_METRIC = "signups_first_touch";
+/** The same first-touch signups, only those from the saved `signupSource`. */
+export const SOURCE_SIGNUPS_FIRST_TOUCH_METRIC = "signups_first_touch_source";
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** Far more than any day's article and signup pairs; reaching it is a failure. */
+const MAX_ROWS = 200_000;
+
+export type SignupsQuery = {
+  sql: string;
+  startDate: string;
+  endDate: string;
+};
+
+type SignupsTables = {
+  [K in Exclude<
+    keyof SignupsConfig,
+    "enabled" | "maxBytesBilled"
+  >]: NonNullable<SignupsConfig[K]>;
+};
+
+const TABLE_SETTINGS = [
+  "signupEventsTable",
+  "firstPageviewsTable",
+  "signupSource",
+  "signupsSince",
+] as const;
+
+function notSetUp(missing: readonly string[]): ContentStepStop {
+  return new ContentStepStop({
+    status: "not_configured",
+    errorCode: "signups_not_configured",
+    errorMessage: `Per-article signups need ${missing.join(", ")} set with configure-content-collection. Measure maxBytesBilled with estimate-content-signups-cost first.`,
+  });
+}
+
+/** The warehouse settings the join is built from; a dry run needs only these. */
+export function signupsTables(config: SignupsConfig): SignupsTables {
+  const missing = TABLE_SETTINGS.filter((key) => config[key] === null);
+  if (missing.length > 0) throw notSetUp(missing);
+  return config as SignupsTables;
+}
+
+/**
+ * The approved cap. Without one the step is not set up, so a join nobody has
+ * priced never runs.
+ */
+function signupsCap(config: SignupsConfig): number {
+  if (config.maxBytesBilled === null) throw notSetUp(["maxBytesBilled"]);
+  return config.maxBytesBilled;
+}
+
+/**
+ * Signups credited to the blog article each person first landed on, by the
+ * day of that first visit: DevRel Leaderboard v3's first-touch join, so a
+ * window's daily values add up to its total. A later signup still credits
+ * the visit's day, so every run recomputes the whole backfill window.
+ *
+ * Signups are read only from the window's first day (or `signupsSince`, if
+ * later): a signup before the first visit isn't first-touch credit, and a
+ * fixed lower bound would grow the scan by a day's events every run.
+ *
+ * `data_through` is the newest first pageview in the window; days after it
+ * aren't in the warehouse yet and get no row.
+ */
+export function buildSignupsQuery(
+  config: SignupsTables,
+  now: Date,
+): SignupsQuery {
+  const end = new Date(now.getTime() - DAY_MS);
+  const startDate = utcDate(
+    new Date(end.getTime() - (BACKFILL_DAYS - 1) * DAY_MS),
+  );
+  const endDate = utcDate(end);
+  const signupsFrom =
+    config.signupsSince > startDate ? config.signupsSince : startDate;
+  const blog = new URL(BUILDER_BLOG_ORIGIN);
+  const escapeRegex = (value: string) =>
+    value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const blogPattern = `^https?://(www\\.)?${escapeRegex(blog.hostname.replace(/^www\./, ""))}${escapeRegex(blog.pathname)}`;
+  const sql = `WITH signups AS (
+  SELECT JSON_VALUE(data, '$.visitorId') AS visitor_id, JSON_VALUE(data, '$.userId') AS user_id, createdDate AS signup_at,
+    LOGICAL_OR(JSON_VALUE(data, '$.signupSource') = '${config.signupSource}') AS from_source
+  FROM \`${config.signupEventsTable}\`
+  WHERE createdDate >= TIMESTAMP('${signupsFrom}') AND event = 'signup'
+    AND COALESCE(JSON_VALUE(data, '$.visitorId'), '') != ''
+  GROUP BY 1, 2, 3
+), visits AS (
+  SELECT REGEXP_EXTRACT(url, r'/blog/([^/?#]+)') AS handle, visitor_id, created_date, DATE(created_date) AS day
+  FROM \`${config.firstPageviewsTable}\`
+  WHERE REGEXP_CONTAINS(url, r'${blogPattern}') AND is_bot = FALSE
+    AND created_date >= TIMESTAMP('${startDate}') AND created_date < TIMESTAMP(DATE_ADD(DATE '${endDate}', INTERVAL 1 DAY))
+), fresh AS (
+  SELECT FORMAT_DATE('%F', MAX(day)) AS data_through FROM visits
+), counts AS (
+  SELECT v.handle, FORMAT_DATE('%F', v.day) AS day, COUNT(DISTINCT s.user_id) AS signups,
+    COUNT(DISTINCT IF(s.from_source, s.user_id, NULL)) AS source_signups
+  FROM visits v JOIN signups s ON s.visitor_id = v.visitor_id AND s.signup_at >= v.created_date
+  WHERE v.handle IS NOT NULL
+  GROUP BY 1, 2
+)
+SELECT f.data_through, c.handle, c.day, c.signups, c.source_signups FROM fresh f LEFT JOIN counts c ON TRUE`;
+  return { sql, startDate, endDate };
+}
+
+function costLimited(message: string): ContentStepStop {
+  return new ContentStepStop({
+    status: "cost_limited",
+    errorCode: "signups_bytes_cap",
+    errorMessage: message,
+  });
+}
+
+function articleHandle(url: string | null): string | null {
+  if (!url) return null;
+  const match = /\/blog\/([^/?#]+)/.exec(url);
+  return match ? normalizeHandle(match[1]!) : null;
+}
+
+function normalizeHandle(handle: string): string | null {
+  try {
+    return decodeURIComponent(handle).toLowerCase();
+    // coercion-ok: a malformed escape gets the typed null handle, which matches no row
+  } catch {
+    return null;
+  }
+}
+
+/** Daily first-touch signups per Builder blog article, behind a bytes cap. */
+export const signupsStep: ContentStep = {
+  id: "signups",
+  async run({ collection, now, signal }) {
+    const tables = signupsTables(collection.config.signups);
+    const cap = signupsCap(collection.config.signups);
+    const articles = await listContentItems(collection, "builder_blog");
+    if (articles.length === 0) {
+      throw new ContentStepStop({
+        status: "not_configured",
+        errorCode: "no_content_items",
+        errorMessage:
+          "No blog articles are collected yet, so there are no articles to credit signups to.",
+      });
+    }
+
+    const query = buildSignupsQuery(tables, now);
+    const estimate = await dryRunQuerySchema(query.sql, {
+      ...(signal ? { signal } : {}),
+    });
+    if (estimate.error) {
+      throw new Error(`The signups dry run failed: ${estimate.error}`);
+    }
+    if (estimate.totalBytesProcessed === undefined) {
+      throw new Error(
+        "The signups dry run returned no byte estimate, so the cap can't be checked.",
+      );
+    }
+    if (estimate.totalBytesProcessed > cap) {
+      throw costLimited(
+        `The signups join would scan ${estimate.totalBytesProcessed} bytes, over the ${cap}-byte cap. Nothing ran.`,
+      );
+    }
+
+    let result: Awaited<ReturnType<typeof runQuery>>;
+    try {
+      result = await runQuery(query.sql, {
+        maxBytesBilled: cap,
+        forceRefresh: true,
+        ...(signal ? { signal } : {}),
+      });
+    } catch (error) {
+      if (error instanceof BigQueryMaximumBytesBilledError) {
+        throw costLimited(
+          `BigQuery stopped the signups join at the ${cap}-byte cap.`,
+        );
+      }
+      throw error;
+    }
+    if (result.truncated || result.rows.length >= MAX_ROWS) {
+      throw new Error(
+        `The signups join returned ${result.rows.length} rows, more than this step reads; nothing was written.`,
+      );
+    }
+
+    const byHandle = new Map(
+      articles.flatMap((article) => {
+        const handle = articleHandle(article.url);
+        return handle ? [[handle, article] as const] : [];
+      }),
+    );
+    const values = new DailyMetricValues();
+    let dataThrough: string | null = null;
+    for (const row of result.rows) {
+      if (typeof row.data_through === "string") dataThrough = row.data_through;
+      if (typeof row.handle !== "string" || typeof row.day !== "string") {
+        continue;
+      }
+      const handle = normalizeHandle(row.handle);
+      const article = handle ? byHandle.get(handle) : undefined;
+      if (!article) continue;
+      values.add(
+        article,
+        row.day,
+        SIGNUPS_FIRST_TOUCH_METRIC,
+        Number(row.signups),
+      );
+      values.add(
+        article,
+        row.day,
+        SOURCE_SIGNUPS_FIRST_TOUCH_METRIC,
+        Number(row.source_signups),
+      );
+    }
+
+    const snapshots = values.snapshots({
+      items: articles,
+      metrics: [SIGNUPS_FIRST_TOUCH_METRIC, SOURCE_SIGNUPS_FIRST_TOUCH_METRIC],
+      startDate: query.startDate,
+      lastReturnedDate: dataThrough,
+    });
+    return {
+      snapshots,
+      outcome: {
+        rowCount: snapshots.length,
+        windowStart: query.startDate,
+        windowEnd: dataThrough,
+      },
+    };
+  },
+};

package/corpus/templates/analytics/server/lib/content-metrics/store.ts

@@ -60,6 +60,7 @@ export type ContentRunOutcome = {
   rowCount: number;
   windowStart?: string | null;
   windowEnd?: string | null;
+  configFingerprint?: string | null;
   bytesProcessed?: number | null;
   bytesCap?: number | null;
   costUsd?: number | null;
@@ -482,6 +483,9 @@ export async function completeContentRun(
             runId: sql`excluded.run_id`,
             collectedAt: sql`excluded.collected_at`,
           },
+          // Steps re-send whole windows (signups recomputes 90 days daily),
+          // so an unchanged value writes nothing and keeps the run that set it.
+          setWhere: sql`${schema.analyticsContentMetricSnapshots.value} IS DISTINCT FROM excluded.value OR ${schema.analyticsContentMetricSnapshots.source} IS DISTINCT FROM excluded.source`,
         });
     }
 
@@ -493,6 +497,7 @@ export async function completeContentRun(
         rowCount: outcome.rowCount,
         windowStart: outcome.windowStart ?? null,
         windowEnd: outcome.windowEnd ?? null,
+        configFingerprint: outcome.configFingerprint ?? null,
         bytesProcessed: outcome.bytesProcessed ?? null,
         bytesCap: outcome.bytesCap ?? null,
         costUsd: outcome.costUsd ?? null,

package/corpus/templates/analytics/server/lib/dashboard-catalog.ts

@@ -969,6 +969,27 @@ export const dashboardCatalogEntries: DashboardCatalogEntry[] = [
     visibleInCatalog: false,
     buildConfig: () => seedConfig("skills-cli-funnel"),
   },
+  {
+    id: "content-view",
+    name: "Content",
+    description:
+      "Blog articles with authors, daily GA4 pageviews, and Search Console clicks and impressions from the daily content collection, with each source's last run.",
+    category: "Acquisition",
+    defaultDashboardId: "content-view",
+    dataSources: ["first-party"],
+    tags: [
+      "content",
+      "blog",
+      "articles",
+      "authors",
+      "search console",
+      "pageviews",
+      "seo",
+    ],
+    panelCount: 4,
+    version: CATALOG_VERSION,
+    buildConfig: () => seedConfig("content-view"),
+  },
   {
     id: "google-analytics-web",
     name: "Google Analytics Website",