@canonry/canonry 7.59.0 → 7.61.0

package/dist/{chunk-TJ4UAO7R.js → chunk-JHYLKXUV.js}

@@ -8,7 +8,7 @@ import {
   classifyJourneyEntry,
   hostMatchesDomain,
   hostOf
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // ../integration-traffic/src/ip-ranges/amazonbot.json
 var amazonbot_default = {
@@ -15186,6 +15186,29 @@ var DEFAULT_BOT_LIST = {
 };
 var DEFAULT_BOT_SCORE_MAX_FORWARD = 30;
 var WORKER_COMPATIBILITY_DATE = "2026-05-01";
+var CLOUDFLARE_PAGE_VIEWS_VERSION_SUFFIX = "+page-views";
+var PAGE_VIEW_ASSET_EXTENSIONS = ["avif", "bmp", "css", "gif", "ico", "jpeg", "jpg", "js", "map", "mjs", "mp3", "mp4", "otf", "pdf", "png", "svg", "ttf", "txt", "webm", "webmanifest", "webp", "woff", "woff2", "xml", "zip"];
+var PAGE_VIEW_FILTER = `
+const PAGE_VIEW_ASSET_PATTERN = new RegExp(${JSON.stringify(`\\.(?:${PAGE_VIEW_ASSET_EXTENSIONS.join("|")})$`)}, 'i')
+
+function isPageView(request) {
+  const method = request.method || 'GET'
+  if (method !== 'GET' && method !== 'POST') return false
+  const purpose = lower(request.headers.get('sec-purpose') || request.headers.get('purpose') || '')
+  if (purpose.indexOf('prefetch') !== -1 || purpose.indexOf('prerender') !== -1) return false
+  const ua = request.headers.get('user-agent') || ''
+  if (ua.indexOf('Mozilla/') !== 0) return false
+  const dest = lower(request.headers.get('sec-fetch-dest') || '')
+  if (dest) return dest === 'document'
+  if (method !== 'GET') return false
+  if (lower(request.headers.get('accept') || '').indexOf('text/html') === -1) return false
+  try {
+    return !PAGE_VIEW_ASSET_PATTERN.test(new URL(request.url).pathname)
+  } catch (_) {
+    return false
+  }
+}
+`;
 function jsString(value) {
   return JSON.stringify(value);
 }
@@ -15194,6 +15217,9 @@ function jsArray(values) {
 }
 function generateWorkerScript(opts) {
   const botScoreMax = opts.botScoreMaxForward ?? DEFAULT_BOT_SCORE_MAX_FORWARD;
+  const pageViewHeader = opts.forwardPageViews ? "\n// page views: forwarded" : "";
+  const pageViewFilter = opts.forwardPageViews ? PAGE_VIEW_FILTER : "";
+  const pageViewCheck = opts.forwardPageViews ? "\n  if (isPageView(request)) return true" : "";
   const canonicalJsonFunction = canonicalizeCloudflareJson.toString();
   const directPushDelivery = opts.deliveryMode === "direct-push" ? `
 function toHex(buffer) {
@@ -15303,7 +15329,7 @@ async function deliverViaQueue(env, batch) {
   return `${CLOUDFLARE_WORKER_GENERATED_MARKER}
 // worker version: ${opts.workerVersion}
 // bot-list version: ${opts.botList.version}
-// delivery mode: ${opts.deliveryMode}
+// delivery mode: ${opts.deliveryMode}${pageViewHeader}
 
 const UA_KEYWORDS = ${jsArray(opts.botList.uaKeywords)}
 const REFERER_DOMAINS = ${jsArray(opts.botList.refererDomains)}
@@ -15378,14 +15404,14 @@ function botSignals(cf) {
   if (typeof cf.botScore === 'number' && cf.botScore < BOT_SCORE_MAX_FORWARD) return true
   return false
 }
-
+${pageViewFilter}
 function shouldForward(request) {
   const ua = request.headers.get('user-agent') || ''
   if (uaMatches(ua)) return true
   if (urlUtmMatches(request.url)) return true
   const referer = request.headers.get('referer') || ''
   if (refererMatches(referer)) return true
-  if (urlUtmMatches(referer)) return true
+  if (urlUtmMatches(referer)) return true${pageViewCheck}
   return botSignals(request.cf)
 }
 
@@ -15680,6 +15706,7 @@ export {
   CLOUDFLARE_WORKER_GENERATED_MARKER,
   CLOUDFLARE_WRANGLER_GENERATED_MARKER,
   DEFAULT_BOT_LIST,
+  CLOUDFLARE_PAGE_VIEWS_VERSION_SUFFIX,
   generateWorkerScript,
   generateWranglerToml,
   verifyRequestSignature

package/dist/{chunk-KCO3PGDZ.js → chunk-K2TRV65V.js}

@@ -1,7 +1,7 @@
 import {
   API_PROVIDER_NAMES,
   ProviderNames
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/provider-registration.ts
 function isApiProviderRegistrable(name, entry) {

package/dist/{chunk-ON7D53WE.js → chunk-L3W6UCTQ.js}

@@ -2,18 +2,18 @@ import {
   configExists,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-FA7RDZ43.js";
+} from "./chunk-HF4ARGGH.js";
 import {
   BUNDLED_SKILL_NAMES,
   installSkills
-} from "./chunk-SXDAIG5W.js";
+} from "./chunk-TD623G6F.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-EED2QEE7.js → chunk-M6KKI7FB.js}

@@ -23,7 +23,7 @@ import {
   measurementDraftUpsertGroupRequestSchema,
   measurementDraftUpsertMarketRequestSchema,
   measurementDraftUpsertTargetRequestSchema
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/measurement-draft-actions.ts
 import { z } from "zod";

package/dist/{chunk-3WRDJJOY.js → chunk-MIV52IYY.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   describeError
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/commands/mcp.ts
 import fs from "fs";

package/dist/{chunk-PP7HR4II.js → chunk-MSEOZUBH.js}

@@ -1,10 +1,10 @@
 import {
   registeredProviderNames
-} from "./chunk-KCO3PGDZ.js";
+} from "./chunk-K2TRV65V.js";
 import {
   configExists,
   loadConfigRaw
-} from "./chunk-FA7RDZ43.js";
+} from "./chunk-HF4ARGGH.js";
 
 // src/setup-state.ts
 import fs from "fs";
@@ -28,7 +28,7 @@ async function buildSetupState() {
   }
   if (dbPath && fs.existsSync(dbPath)) {
     try {
-      const { createClient, projects, queries: queriesTable } = await import("./src-CLICUC3F.js");
+      const { createClient, projects, queries: queriesTable } = await import("./src-QZCOCSQQ.js");
       const db = createClient(dbPath);
       project_count = db.select({ id: projects.id }).from(projects).all().length;
       const firstQuery = db.select({ id: queriesTable.id }).from(queriesTable).limit(1).all();
@@ -47,7 +47,7 @@ function queueServeHandoff() {
 async function runPendingServeHandoff(format) {
   if (!pendingServeHandoff) return;
   pendingServeHandoff = false;
-  const { serveCommand } = await import("./serve-LESJD7GM.js");
+  const { serveCommand } = await import("./serve-EHPDSJSX.js");
   await serveCommand(format);
 }
 

package/dist/{chunk-WSFCQQ7F.js → chunk-O5WQN3GW.js}

@@ -1,4 +1,5 @@
 import {
+  CLOUDFLARE_PAGE_VIEWS_VERSION_SUFFIX,
   DEFAULT_BOT_LIST,
   buildTrafficProbeReport,
   extractJourneyRequests,
@@ -8,14 +9,14 @@ import {
   normalizeCloudflareWorkerEvent,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-TJ4UAO7R.js";
+} from "./chunk-JHYLKXUV.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-KLPRF4PA.js";
+} from "./chunk-5JFEK7IL.js";
 import {
   SentimentIdempotencyConflict,
   SentimentRepository,
@@ -153,7 +154,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-QF5C3JXL.js";
+} from "./chunk-ST7JA3UW.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -260,6 +261,7 @@ import {
   JOURNEY_LIST_VISITS_PER_VISITOR,
   JOURNEY_LOOKBACK_DAYS,
   JOURNEY_MAX_REQUESTS_PER_VISITOR_DAY,
+  JOURNEY_PAGE_VIEWS_PENDING_REASON,
   JOURNEY_PARTIAL_SOURCE_TYPES,
   JOURNEY_RETENTION_DAYS,
   JOURNEY_VISIT_IDLE_MINUTES,
@@ -937,6 +939,7 @@ import {
   providerSummaryEntryDtoSchema,
   providersFailing,
   qualifiedNameIncludesName,
+  queryClassFilterSchema,
   queryDtoSchema,
   queryGenerateRequestSchema,
   queryGenerateResponseSchema,
@@ -1154,7 +1157,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -27366,6 +27369,22 @@ async function analyticsRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const classifyQuery = projectQueryClassifier(project);
     const mentionShareScope = classifyQuery ? "non-brand" : "pooled";
+    const parsedQueryClass = queryClassFilterSchema.safeParse(request.query.queryClass ?? "all");
+    if (!parsedQueryClass.success) {
+      throw validationError('"queryClass" must be one of: all, branded, non-brand', { issues: parsedQueryClass.error.issues });
+    }
+    const queryClass = parsedQueryClass.data;
+    if (queryClass !== "all" && activeMeasurementPlan(app.db, project.id)?.plan.schemaVersion === 2) {
+      throw validationError(
+        `Query class "${queryClass}" on a published measurement plan follows its assignments. Read the split from GET /projects/${project.name}/visibility-report, or omit queryClass for pooled trends.`
+      );
+    }
+    if (queryClass !== "all" && !classifyQuery) {
+      throw validationError(
+        `Query class "${queryClass}" needs a brand name or alias on this project. Add one, or omit queryClass for pooled trends.`
+      );
+    }
+    const inQueryClass = (text) => queryClass === "all" || classifyQuery(text) === queryClass;
     const window2 = parseWindow(request.query.window);
     const cutoff = windowCutoff(window2);
     const projectRuns = app.db.select().from(runs).where(and37(
@@ -27379,6 +27398,7 @@ async function analyticsRoutes(app) {
       return reply.send({
         window: window2,
         mentionShareScope,
+        queryClass,
         buckets: [],
         overall: { citationRate: 0, cited: 0, total: 0, mentionRate: 0, mentionedCount: 0 },
         byProvider: {},
@@ -27435,7 +27455,7 @@ async function analyticsRoutes(app) {
       // this far when its text matched the basket, so its key is never empty.)
       basketKey: normalizeQueryText(s.queryText ?? (s.queryId ? queryTextById.get(s.queryId) ?? "" : "")) || s.queryId || "",
       runBasketRevision: runBasketRevision.get(s.runId) ?? null
-    }));
+    })).filter((s) => queryClass === "all" || s.queryClass === queryClass);
     const mentionShareCompetitors2 = mentionShareCompetitors(
       app.db.select(competitorIdentityColumns).from(competitors).where(eq46(competitors.projectId, project.id)).orderBy(competitors.domain).all()
     );
@@ -27601,17 +27621,17 @@ async function analyticsRoutes(app) {
     const trend = computeTrend(buckets, "citationRate");
     const mentionTrend = computeTrend(buckets, "mentionRate");
     const windowChange = computeWindowChange(buckets);
-    const queryChanges = computeQueryChanges(projectQueries, cutoff);
+    const queryChanges = computeQueryChanges(projectQueries.filter((q) => inQueryClass(q.query)), cutoff);
     const basketChanges = basketRevisions.slice(1).map((rev, i) => {
       const previous = new Set(basketRevisions[i].members);
       const current = new Set(rev.members);
       return {
         revision: rev.revision,
         at: rev.createdAt,
-        added: rev.members.filter((m) => !previous.has(m)),
-        removed: basketRevisions[i].members.filter((m) => !current.has(m))
+        added: rev.members.filter((m) => !previous.has(m) && inQueryClass(m)),
+        removed: basketRevisions[i].members.filter((m) => !current.has(m) && inQueryClass(m))
       };
-    }).filter((change) => !cutoff || change.at >= cutoff);
+    }).filter((change) => queryClass === "all" || change.added.length + change.removed.length > 0).filter((change) => !cutoff || change.at >= cutoff);
     const executionIdentityChanges = [];
     let previousExecutionChecksum = null;
     for (const run of projectRuns) {
@@ -27622,7 +27642,7 @@ async function analyticsRoutes(app) {
       }
       previousExecutionChecksum = identity.checksum;
     }
-    return reply.send({ window: window2, mentionShareScope, buckets, overall, byProvider, trend, mentionTrend, windowChange, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges, competitorIdentityChangedAt: readCompetitorIdentityChangedAt(app.db, project.id), competitorSetChangedAt: readCompetitorSetChangedAt(app.db, project.id) });
+    return reply.send({ window: window2, mentionShareScope, queryClass, buckets, overall, byProvider, trend, mentionTrend, windowChange, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges, competitorIdentityChangedAt: readCompetitorIdentityChangedAt(app.db, project.id), competitorSetChangedAt: readCompetitorSetChangedAt(app.db, project.id) });
   });
   app.get("/projects/:name/analytics/gaps", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -28845,6 +28865,14 @@ async function trafficSamplesRoutes(app) {
 import crypto28 from "crypto";
 import { and as and42, asc as asc10, count as count4, desc as desc23, eq as eq50, gt as gt4, gte as gte10, inArray as inArray27, lt as lt8, lte as lte9, sql as sql15 } from "drizzle-orm";
 import "zod";
+
+// ../api-routes/src/cloudflare-worker-version.ts
+var CURRENT_CLOUDFLARE_WORKER_VERSION = "1.0.1";
+function cloudflareWorkerVersionFor(options) {
+  return `${CURRENT_CLOUDFLARE_WORKER_VERSION}${options.forwardPageViews ? CLOUDFLARE_PAGE_VIEWS_VERSION_SUFFIX : ""}`;
+}
+
+// ../api-routes/src/journeys.ts
 var DAY_MS = 24 * 60 * 6e4;
 var IDLE_MS = JOURNEY_VISIT_IDLE_MINUTES * 6e4;
 var LOOKBACK_MS = JOURNEY_LOOKBACK_DAYS * DAY_MS;
@@ -29135,7 +29163,27 @@ function visitsByVisitor(db, projectId, keys) {
 }
 function partialSources(db, projectId) {
   const types = Object.keys(JOURNEY_PARTIAL_SOURCE_TYPES);
-  return db.select({ id: trafficSources.id, sourceType: trafficSources.sourceType, status: trafficSources.status }).from(trafficSources).where(and42(eq50(trafficSources.projectId, projectId), inArray27(trafficSources.sourceType, types))).orderBy(asc10(trafficSources.id)).all().filter((row) => row.status !== TrafficSourceStatuses.archived).map((row) => ({ sourceId: row.id, sourceType: row.sourceType, reason: JOURNEY_PARTIAL_SOURCE_TYPES[row.sourceType] }));
+  const rows = db.select({
+    id: trafficSources.id,
+    sourceType: trafficSources.sourceType,
+    status: trafficSources.status,
+    configJson: trafficSources.configJson,
+    lastWorkerVersion: trafficSources.lastWorkerVersion
+  }).from(trafficSources).where(and42(eq50(trafficSources.projectId, projectId), inArray27(trafficSources.sourceType, types))).orderBy(asc10(trafficSources.id)).all();
+  const out = [];
+  for (const row of rows) {
+    if (row.status === TrafficSourceStatuses.archived) continue;
+    let reason = JOURNEY_PARTIAL_SOURCE_TYPES[row.sourceType];
+    if (row.sourceType === TrafficSourceTypes.cloudflare) {
+      const config = cloudflareTrafficSourceConfigSchema.safeParse(row.configJson);
+      if (config.success && config.data.forwardPageViews) {
+        if (row.lastWorkerVersion === cloudflareWorkerVersionFor({ forwardPageViews: true })) continue;
+        reason = JOURNEY_PAGE_VIEWS_PENDING_REASON;
+      }
+    }
+    out.push({ sourceId: row.id, sourceType: row.sourceType, reason });
+  }
+  return out;
 }
 function median(values) {
   if (values.length === 0) return null;
@@ -34260,6 +34308,12 @@ var sourcesQueryClassParameter = {
   description: "Restrict to branded or non-brand answers. With an active v2 measurement plan the class comes from each run's frozen plan assignments (the same answers as the competitor landscape at scope=all-markets); otherwise from the project's brand-name classifier over the query text. Answers neither basis can place are excluded and counted in unclassifiedAnswers. Defaults to all, which pools both classes.",
   schema: { type: "string", enum: ["all", "branded", "non-brand"] }
 };
+var metricsQueryClassParameter = {
+  name: "queryClass",
+  in: "query",
+  description: "Restrict every rate, bucket, change and query-set event to branded or non-brand answers, classified from the query text by the project's brand names (the same split mention share uses). Mention share stays non-brand, so it is empty under branded. Bucket boundaries do not move with the class, so the two classes plot on the same dates. 400 when the project has no brand name or alias to classify with, or has a published v2 measurement plan (its classes live on the plan assignments; read the split from the visibility report). Defaults to all, which pools both classes.",
+  schema: { type: "string", enum: ["all", "branded", "non-brand"] }
+};
 var sourcesIncludeByQueryParameter = {
   name: "includeByQuery",
   in: "query",
@@ -36774,9 +36828,10 @@ var routeCatalog = [
     path: "/api/v1/projects/{name}/analytics/metrics",
     summary: "Get citation trend analytics",
     tags: ["analytics"],
-    parameters: [nameParameter, analyticsWindowParameter],
+    parameters: [nameParameter, analyticsWindowParameter, metricsQueryClassParameter],
     responses: {
       200: jsonResponse("Citation metrics returned.", "BrandMetricsDto"),
+      400: errorResponse("Invalid query parameters."),
       404: errorResponse("Project not found.")
     }
   },
@@ -60194,9 +60249,6 @@ import { isIP } from "net";
 import { isDeepStrictEqual } from "util";
 import { and as and69, desc as desc39, eq as eq80, gt as gt7, gte as gte19, inArray as inArray34, lt as lt13, lte as lte20, sql as sql30 } from "drizzle-orm";
 
-// ../api-routes/src/cloudflare-worker-version.ts
-var CURRENT_CLOUDFLARE_WORKER_VERSION = "1.0.1";
-
 // ../api-routes/src/traffic-limits.ts
 var VERCEL_MAX_SYNC_WINDOW_MS = 24 * 60 * 6e4;
 var DEFAULT_VERCEL_SYNC_DEADLINE_MS = 4 * 6e4;
@@ -61985,6 +62037,19 @@ async function loadQueueReceiptPolicy(db, sourceId, readRetentionSeconds, warn2)
   const floorMs = floorExpiry ? Date.parse(floorExpiry) : 0;
   return { ttlMsAt: (receivedAt) => Math.max(ttlMs, floorMs - Date.parse(receivedAt)) };
 }
+function cloudflarePageViewInstructions(forwardPageViews, deliveryMode) {
+  if (!forwardPageViews) return [];
+  const lines = [
+    "This Worker also forwards page views (document loads and form posts), so AI visitor journeys record later visits.",
+    "Each page view becomes one Worker delivery: expect more Worker CPU and Canonry ingest volume on busy sites."
+  ];
+  if (deliveryMode === CloudflareTrafficDeliveryModes["queue-pull"]) {
+    lines.push(
+      "Each page view is one Queue message (3 Queue operations). Each sync drains for up to 4 minutes by default; if doctor reports more than 1,000 messages left after syncs, shorten the traffic-sync interval or raise CANONRY_CLOUDFLARE_QUEUE_SYNC_DEADLINE_MS."
+    );
+  }
+  return lines;
+}
 function parseDirectPushCloudflareSourceConfig(config) {
   const parsed = cloudflareTrafficSourceConfigSchema.safeParse(config);
   return parsed.success && parsed.data.deliveryMode === CloudflareTrafficDeliveryModes["direct-push"] ? parsed.data : null;
@@ -63103,11 +63168,13 @@ async function trafficRoutes(app, opts) {
       if (sameModeSource) attempt.update({ action: "reauth" });
       const sourceId2 = sameModeSource?.id ?? crypto52.randomUUID();
       const previousCredential2 = credentialStore.getConnectionBySourceId(sourceId2);
-      const workerVersion2 = CURRENT_CLOUDFLARE_WORKER_VERSION;
+      const forwardPageViews2 = parsed.data.forwardPageViews ?? (sameModeSource ? parseQueuePullCloudflareSourceConfig(sameModeSource.configJson)?.forwardPageViews : void 0) ?? false;
+      const workerVersion2 = cloudflareWorkerVersionFor({ forwardPageViews: forwardPageViews2 });
       const workerScript2 = generateWorkerScript({
         deliveryMode: "queue-pull",
         workerVersion: workerVersion2,
-        botList: DEFAULT_BOT_LIST
+        botList: DEFAULT_BOT_LIST,
+        forwardPageViews: forwardPageViews2
       });
       const wranglerToml2 = generateWranglerToml({
         deliveryMode: "queue-pull",
@@ -63124,6 +63191,7 @@ async function trafficRoutes(app, opts) {
         workerVersion: workerVersion2,
         expectedBotListVersion: DEFAULT_BOT_LIST.version,
         zoneId: zoneId2 ?? null,
+        forwardPageViews: forwardPageViews2,
         accountId: accountId2,
         queueId,
         queueName,
@@ -63219,12 +63287,14 @@ async function trafficRoutes(app, opts) {
         workerScript: workerScript2,
         wranglerToml: wranglerToml2,
         workerVersion: workerVersion2,
+        forwardPageViews: forwardPageViews2,
         instructions: [
           "Deploy this Worker to your Cloudflare zone:",
           "  1. Save worker.js and wrangler.toml; neither file contains Queue credentials",
           `  2. Enable the Queue HTTP pull consumer: wrangler queues consumer http add ${queueName}`,
           `  3. Attach ${workerRouteHost2}/* in the Cloudflare Dashboard with Fail open`,
           `  4. Canonry pulls Queue ${queueName}; activate this source after the route is live.`,
+          ...cloudflarePageViewInstructions(forwardPageViews2, CloudflareTrafficDeliveryModes["queue-pull"]),
           `Source id: ${sourceRow3.id}`
         ].join("\n")
       };
@@ -63253,17 +63323,19 @@ async function trafficRoutes(app, opts) {
     const previousAccountId = reusableCredential?.accountId ?? parsedActiveConfig?.accountId ?? null;
     const effectiveZoneId = zoneId ?? previousZoneId;
     const effectiveAccountId = accountId ?? previousAccountId;
+    const forwardPageViews = parsed.data.forwardPageViews ?? parsedActiveConfig?.forwardPageViews ?? false;
     const bearerToken = reusableCredential?.bearerToken ?? `cnry_cfw_${crypto52.randomBytes(32).toString("hex")}`;
     const hmacSecret = reusableCredential?.hmacSecret ?? crypto52.randomBytes(32).toString("hex");
     const ingestTokenHash = sha256Hex3(bearerToken);
     const ingestUrl = opts.cloudflareTrafficIngestUrl.replace("{name}", encodeURIComponent(project.name));
     assertCloudflareIngestUrlIsPublicHttps(ingestUrl);
     assertCloudflareIngestUrlOutsideWorkerRoute(ingestUrl, workerRouteHost);
-    const workerVersion = CURRENT_CLOUDFLARE_WORKER_VERSION;
+    const workerVersion = cloudflareWorkerVersionFor({ forwardPageViews });
     const workerScript = generateWorkerScript({
       deliveryMode,
       workerVersion,
-      botList: DEFAULT_BOT_LIST
+      botList: DEFAULT_BOT_LIST,
+      forwardPageViews
     });
     const wranglerToml = generateWranglerToml({
       deliveryMode,
@@ -63280,7 +63352,8 @@ async function trafficRoutes(app, opts) {
       workerVersion,
       expectedBotListVersion: DEFAULT_BOT_LIST.version,
       zoneId: effectiveZoneId,
-      accountId: effectiveAccountId
+      accountId: effectiveAccountId,
+      forwardPageViews
     };
     const fallbackName = displayName ?? activeSource?.displayName ?? `Cloudflare \xB7 ${effectiveZoneId ?? sourceId.slice(0, 8)}`;
     credentialStore.upsertConnection({
@@ -63383,6 +63456,7 @@ async function trafficRoutes(app, opts) {
       `  5. In the Cloudflare Dashboard route form, select \`${workerRouteHost}/*\` and this Worker`,
       "  6. Set Request limit failure mode to Fail open, then save the route; Wrangler cannot set this toggle",
       "  7. Keep the Canonry ingest hostname outside this Worker route to avoid recursion",
+      ...cloudflarePageViewInstructions(forwardPageViews, CloudflareTrafficDeliveryModes["direct-push"]),
       "",
       `Source id: ${sourceRow2.id}`,
       "After deploy, check `canonry doctor --project " + project.name + "` to confirm events are arriving."
@@ -63394,6 +63468,7 @@ async function trafficRoutes(app, opts) {
       workerScript,
       wranglerToml,
       workerVersion,
+      forwardPageViews,
       instructions
     };
   }));
@@ -68996,7 +69071,7 @@ var workerVersionCheck = {
       };
     }
     const measured = sources.map((source) => {
-      const expectedVersion = CURRENT_CLOUDFLARE_WORKER_VERSION;
+      const expectedVersion = cloudflareWorkerVersionFor({ forwardPageViews: source.configJson.forwardPageViews === true });
       const observedVersion = source.lastWorkerVersion;
       const state = observedVersion === null ? "waiting-for-first-event" : observedVersion === expectedVersion ? "current" : "stale";
       return {

package/dist/{chunk-Y54KA37X.js → chunk-OFV6CZ2K.js}

@@ -5,7 +5,7 @@ import {
   AppError,
   parseWindowIn,
   resolveDateRange
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/cli-access.ts
 var CLI_ACCESS_BY_ID = Object.freeze({

package/dist/{chunk-VWO4WRQM.js → chunk-OQDVG7K7.js}

@@ -6,12 +6,12 @@ import {
 import {
   createApiClient,
   runWithUsageTags
-} from "./chunk-PTKFLEVN.js";
+} from "./chunk-XRQCRDTF.js";
 import {
   canonryMcpTools,
   mcpOutputSchema,
   toolOperationAccess
-} from "./chunk-LWKHCQ46.js";
+} from "./chunk-GDVMHIY4.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -24,7 +24,7 @@ import {
   isReadOnlyKey,
   restrictedWriteScopes,
   upgradeCaveatFor
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/mcp/server.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-VRI3UDRA.js → chunk-OTOVHA7D.js}

@@ -1,6 +1,6 @@
 import {
   hostMatchesDomain
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/citation-utils.ts
 function pickProjectCitedDomain(citedDomains, projectDomains) {

package/dist/{chunk-QF5C3JXL.js → chunk-ST7JA3UW.js}

@@ -20,7 +20,7 @@ import {
   templateLinkRatio,
   templateLinkUbiquityAvailable,
   validationError
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";

package/dist/{chunk-SXDAIG5W.js → chunk-TD623G6F.js}

@@ -15,7 +15,7 @@ import {
   formatCanonryPluginUpdateHint,
   formatCanonryPluginVersionMismatch,
   skillsClientSchema
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/commands/skills.ts
 import crypto from "crypto";

package/dist/{chunk-EJZ4TQQR.js → chunk-TQLXCGRD.js}

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-FA7RDZ43.js";
+} from "./chunk-HF4ARGGH.js";
 import {
   CANONRY_NPM_PACKAGE_URL,
   compareSemver,
@@ -18,7 +18,7 @@ import {
   updateCheckEnvOptOut,
   upgradeCaveatFor,
   upgradeCommandFor
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {

package/dist/{chunk-TKX4G4NV.js → chunk-UQVOB3OH.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-EJZ4TQQR.js";
+} from "./chunk-TQLXCGRD.js";
 import {
   getConfigDir
-} from "./chunk-FA7RDZ43.js";
+} from "./chunk-HF4ARGGH.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-KLPRF4PA.js";
+} from "./chunk-5JFEK7IL.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{chunk-RFXO5GPB.js → chunk-UX6KFIIE.js}

@@ -1,13 +1,13 @@
 import {
   createApiClient
-} from "./chunk-PTKFLEVN.js";
+} from "./chunk-XRQCRDTF.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-EED2QEE7.js";
+} from "./chunk-M6KKI7FB.js";
 import {
   isMachineFormat,
   systemError
@@ -37,7 +37,7 @@ import {
   unattributedAnswersLabel,
   uncheckedSourcesLabel,
   visibilityReportRequestSchema
-} from "./chunk-HUO3YPKB.js";
+} from "./chunk-V3XAJCO3.js";
 
 // src/commands/measurement-plan.ts
 import crypto from "crypto";