@canonry/canonry 7.62.1 → 7.63.1

package/dist/{chunk-3B2GBWIA.js → chunk-5GMYD7UZ.js}

@@ -1,6 +1,6 @@
 import {
   pickProjectCitedDomain
-} from "./chunk-U2WPZZPQ.js";
+} from "./chunk-EHTSCLEL.js";
 import {
   GBP_INSIGHT_PROVIDER,
   PERSISTENT_GAP_THRESHOLD,
@@ -14,10 +14,10 @@ import {
   mergeGscQueryTotalsWithFallback,
   readGscQueryDailyRows,
   readLatestGscDataDate
-} from "./chunk-2HNTNKFC.js";
+} from "./chunk-22ABGRB7.js";
 import {
   getRequestContext
-} from "./chunk-LAILXR2F.js";
+} from "./chunk-QNFX7ZCT.js";
 import {
   competitors,
   gbpDailyMetrics,
@@ -35,7 +35,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-RGD5SDT3.js";
+} from "./chunk-HNZQVIPS.js";
 import {
   CitationStates,
   RunKinds,
@@ -45,7 +45,7 @@ import {
   effectiveDomains,
   redactLogString,
   redactLogValue
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray, gte, lte, isNull, sql, exists } from "drizzle-orm";

package/dist/{chunk-X3GWBK7N.js → chunk-5VAC4KQ2.js}

@@ -6,12 +6,12 @@ import {
 import {
   createApiClient,
   runWithUsageTags
-} from "./chunk-SDZKHJ6W.js";
+} from "./chunk-LEG7F3DN.js";
 import {
   canonryMcpTools,
   mcpOutputSchema,
   toolOperationAccess
-} from "./chunk-YQGVA64Q.js";
+} from "./chunk-H22RCHYH.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -24,7 +24,7 @@ import {
   isReadOnlyKey,
   restrictedWriteScopes,
   upgradeCaveatFor
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/mcp/server.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-WKZZILBI.js → chunk-5YC6IU44.js}

@@ -5,7 +5,7 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-RGD5SDT3.js";
+} from "./chunk-HNZQVIPS.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
@@ -15,7 +15,7 @@ import {
   factorStatusFromDistribution,
   factorStatusFromScore,
   roundPreservingTotal
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/site-audit-factors.ts
 function recordedSharePct(factor) {

package/dist/{chunk-5NYS3ABL.js → chunk-67262NJL.js}

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

package/dist/{chunk-7EWDQUNH.js → chunk-6ABOEN5D.js}

@@ -7,27 +7,27 @@ import {
   reparseStoredResult4,
   reparseStoredResult5,
   resolveStoredApiResponse
-} from "./chunk-APQ5EAL2.js";
+} from "./chunk-UYPBR3SF.js";
 import {
   loadConfig
-} from "./chunk-2LY4FY4N.js";
+} from "./chunk-A57HYHJ3.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
 import {
   determineCitationState
-} from "./chunk-U2WPZZPQ.js";
+} from "./chunk-EHTSCLEL.js";
 import {
   backfillProjectAnswerMentions,
   competitorIdentityColumns,
   createRunCompetitorResolver,
   readMarketCompetitorNames,
   refreshSnapshotMentionIdentity
-} from "./chunk-2HNTNKFC.js";
+} from "./chunk-22ABGRB7.js";
 import {
   classifyAiUserFetch,
   classifyCrawler
-} from "./chunk-SYQLUOR7.js";
+} from "./chunk-SG2OPR7J.js";
 import {
   aiUserFetchEventsHourly,
   auditLog,
@@ -42,7 +42,7 @@ import {
   querySnapshots,
   rawEventSamples,
   runs
-} from "./chunk-RGD5SDT3.js";
+} from "./chunk-HNZQVIPS.js";
 import {
   ProviderNames,
   RetrievalContracts,
@@ -59,7 +59,7 @@ import {
   extractRecommendedCompetitors,
   normalizeUrlPath,
   openRouterRouteModel
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/commands/backfill.ts
 import { setImmediate as yieldToEventLoop } from "timers/promises";
@@ -437,7 +437,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-UNKFCG5N.js");
+  const { IntelligenceService } = await import("./intelligence-service-MWTHUE7S.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-2LY4FY4N.js → chunk-A57HYHJ3.js}

@@ -20,7 +20,7 @@ import {
   resolveProviderModel,
   schedulableRunKindSchema,
   sentimentEvaluatorProviderSchema
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // ../config/src/index.ts
 import { z as z4 } from "zod";

package/dist/{chunk-O6VSPM5S.js → chunk-AGSQWIE4.js}

@@ -1,7 +1,7 @@
 import {
   answerServiceAdapters,
   answerServiceDescriptors
-} from "./chunk-Q7PTBHNG.js";
+} from "./chunk-OIHJJHJR.js";
 import {
   AeroLlmUsageFeatures,
   aeroTurnStatus,
@@ -27,14 +27,14 @@ import {
   resolveConfiguredAgentProvider,
   resolveSessionProviderAndModel,
   setAeroSystemPrompt
-} from "./chunk-AO4P75DI.js";
+} from "./chunk-V3QMOGZE.js";
 import {
   AeroToolProfiles,
   AeroToolScopes,
   buildAeroStateTools,
   isAeroToolProfile,
   truncateToolResult
-} from "./chunk-UUGT7UMF.js";
+} from "./chunk-JM6OFCLX.js";
 import {
   getGoogleAuthConfig,
   getGoogleConnection,
@@ -53,7 +53,7 @@ import {
   removeCloudflareTrafficConnection,
   removeCloudflareTrafficConnectionBySourceId,
   upsertCloudflareTrafficConnection
-} from "./chunk-KTQVRQDM.js";
+} from "./chunk-UBP3AAKA.js";
 import {
   claudeAdapter,
   embedQueries,
@@ -64,7 +64,7 @@ import {
   openaiAdapter,
   openrouterAdapter,
   perplexityAdapter
-} from "./chunk-APQ5EAL2.js";
+} from "./chunk-UYPBR3SF.js";
 import {
   classifyUsageSurface,
   createApiUsageTelemetry,
@@ -76,7 +76,7 @@ import {
   startOutcomeTimer,
   trackFeatureCompleted,
   trackInstallState
-} from "./chunk-KLGHY67V.js";
+} from "./chunk-CWMJQ2JV.js";
 import {
   isLoopbackBindHost
 } from "./chunk-TSENU4GG.js";
@@ -84,7 +84,7 @@ import {
   isApiProviderRegistrable,
   isCdpProviderRegistrable,
   registeredProviderNames
-} from "./chunk-IALK4DQJ.js";
+} from "./chunk-GRWZC3GQ.js";
 import {
   checkLatestVersionForServer,
   getOrCreateAnonymousId,
@@ -95,17 +95,17 @@ import {
   recordDashboardEvent,
   setTelemetryPreference,
   trackEvent
-} from "./chunk-5NYS3ABL.js";
+} from "./chunk-67262NJL.js";
 import {
   createCanonryMcpServer
-} from "./chunk-X3GWBK7N.js";
+} from "./chunk-5VAC4KQ2.js";
 import {
   CANONRY_MCP_TIERS,
   CANONRY_MCP_TOOLKIT_NAMES
 } from "./chunk-NCIPNVD6.js";
 import {
   ApiClient
-} from "./chunk-SDZKHJ6W.js";
+} from "./chunk-LEG7F3DN.js";
 import {
   AGENT_PROVIDERS,
   adapterSupportsBatch,
@@ -136,21 +136,21 @@ import {
   saveConfigPatch,
   sentimentInstallReadiness,
   updateSharedProviderExecutionGate
-} from "./chunk-2LY4FY4N.js";
+} from "./chunk-A57HYHJ3.js";
 import {
   getBundledSkillSnapshots
-} from "./chunk-YBDUZBGU.js";
+} from "./chunk-PH7RTAWW.js";
 import {
   computeFactorAverages,
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout,
   recordedSharePct
-} from "./chunk-WKZZILBI.js";
+} from "./chunk-5YC6IU44.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-YQGVA64Q.js";
+} from "./chunk-H22RCHYH.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -162,11 +162,11 @@ import {
   addLogListener,
   createFastifyLogger,
   createLogger
-} from "./chunk-3B2GBWIA.js";
+} from "./chunk-5GMYD7UZ.js";
 import {
   computeCitedCompetitorDomains,
   determineCitationState
-} from "./chunk-U2WPZZPQ.js";
+} from "./chunk-EHTSCLEL.js";
 import {
   BingApiError,
   CC_CACHE_DIR,
@@ -285,7 +285,7 @@ import {
   webhookResponseReason,
   webhookTargetRefusalReason,
   writeAuditLog
-} from "./chunk-2HNTNKFC.js";
+} from "./chunk-22ABGRB7.js";
 import {
   OperationalLogStore,
   SentimentIdempotencyConflict,
@@ -371,7 +371,7 @@ import {
   siteLivenessState,
   trafficSources,
   usageCounters
-} from "./chunk-RGD5SDT3.js";
+} from "./chunk-HNZQVIPS.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AI_ENGINE_DOMAINS,
@@ -401,6 +401,7 @@ import {
   GoogleAdsSnapshotKinds,
   GoogleMarketingProviders,
   GtmSnapshotKinds,
+  HEALTH_NO_LONGER_URGENT,
   HostedMcpStatuses,
   HostedMcpUnavailableReasons,
   INTEGRATION_NAMES,
@@ -616,7 +617,7 @@ import {
   winnabilityClassLabel,
   withRetry,
   withSkippedProviders
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/google-marketing-runtime.ts
 import crypto2 from "crypto";
@@ -5657,7 +5658,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "6b84bb1b02f35a10a9f5acf10daf9c9e9df2a2d1" : void 0;
+  const embedded = true ? "bf661eb5ab6eb02b455254b13b5cc8d0d8ca6536" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -12995,6 +12996,23 @@ var SLOT_FIRED = { status: OutcomeStatuses.succeeded };
 var slotSkipped = (reasonCode) => ({ status: OutcomeStatuses.skipped, reasonCode });
 var slotFailed = (reasonCode) => ({ status: OutcomeStatuses.failed, reasonCode });
 var DEFAULT_HEALTH_CRON = "0 */6 * * *";
+var SCHEDULE_SPREAD_MS = 12e4;
+var UNSPREAD_KINDS = /* @__PURE__ */ new Set([SchedulableRunKinds["answer-visibility"]]);
+function scheduleSpreadMs(projectId, kind, spreadMs = SCHEDULE_SPREAD_MS) {
+  if (spreadMs <= 0) return 0;
+  return crypto20.createHash("sha256").update(`${projectId}:${kind}`).digest().readUInt32BE(0) % spreadMs;
+}
+function shortestCronGapMs(cronExpr, timezone, from = /* @__PURE__ */ new Date()) {
+  let previous = nextRunFromCron(cronExpr, timezone, from);
+  let shortest = Number.POSITIVE_INFINITY;
+  for (let i = 0; previous && i < 8; i++) {
+    const next = nextRunFromCron(cronExpr, timezone, new Date(Date.parse(previous) + 1e3));
+    if (!next) break;
+    shortest = Math.min(shortest, Date.parse(next) - Date.parse(previous));
+    previous = next;
+  }
+  return Number.isFinite(shortest) ? shortest : null;
+}
 function ensureDefaultHealthSchedule(db, projectId, now = (/* @__PURE__ */ new Date()).toISOString()) {
   const result = db.insert(schedules).values({
     id: crypto20.randomUUID(),
@@ -13023,9 +13041,14 @@ var Scheduler = class {
   tasks = /* @__PURE__ */ new Map();
   /** A cron can fire every minute, so slot outcomes are sampled per status and reason. */
   sampleSlot = createOutcomeSampler({ burst: 5, refillMs: 30 * 6e4 });
-  constructor(db, callbacks) {
+  /** How far background work may start after its cron minute; 0 starts it on the minute. */
+  spreadMs;
+  /** Spread starts waiting to fire, by task key, so stopping a task cancels its start too. */
+  spreadTimers = /* @__PURE__ */ new Map();
+  constructor(db, callbacks, options = {}) {
     this.db = db;
     this.callbacks = callbacks;
+    this.spreadMs = options.spreadMs ?? 0;
   }
   /**
    * Give every project a health schedule if it has never had one.
@@ -13147,6 +13170,11 @@ var Scheduler = class {
   stopTask(key, task, verb) {
     void task.stop();
     void task.destroy();
+    const pending = this.spreadTimers.get(key);
+    if (pending) {
+      clearTimeout(pending);
+      this.spreadTimers.delete(key);
+    }
     log17.info(`task.${verb.toLowerCase()}`, { key });
   }
   /** Runtime timing writes must not restore a version already issued to a settings caller. */
@@ -13176,12 +13204,27 @@ var Scheduler = class {
       log17.error("cron.invalid", { projectId, kind, cronExpr });
       return false;
     }
+    const key = taskKey(projectId, kind);
+    const gapMs = this.spreadMs > 0 && !UNSPREAD_KINDS.has(kind) ? shortestCronGapMs(cronExpr, timezone) : null;
+    const spreadMs = gapMs === null ? 0 : scheduleSpreadMs(projectId, kind, Math.min(this.spreadMs, Math.floor(gapMs / 2)));
     const task = cron.schedule(cronExpr, () => {
-      this.triggerRun(scheduleId, projectId, kind);
+      if (spreadMs === 0) {
+        this.triggerRun(scheduleId, projectId, kind);
+        return;
+      }
+      const overdue = this.spreadTimers.get(key);
+      if (overdue) {
+        clearTimeout(overdue);
+        this.triggerRun(scheduleId, projectId, kind);
+      }
+      this.spreadTimers.set(key, setTimeout(() => {
+        this.spreadTimers.delete(key);
+        this.triggerRun(scheduleId, projectId, kind);
+      }, spreadMs));
     }, {
       timezone
     });
-    this.tasks.set(taskKey(projectId, kind), task);
+    this.tasks.set(key, task);
     if (!options.preserveNextRunAt || !schedule.nextRunAt) {
       this.updateScheduleTiming(scheduleId, {
         nextRunAt: nextRunFromCron(cronExpr, timezone)
@@ -14446,7 +14489,7 @@ var Notifier = class {
     const urgentItems = [];
     for (const c of failing) {
       if (c.urgent !== true) continue;
-      urgentItems.push({ id: c.id, code: c.code, rank: rank(c.status), status: c.status, summary: c.summary, remediation: c.remediation ?? null });
+      urgentItems.push({ id: c.id, code: c.code, rank: rank(c.status), status: c.status, summary: c.summary, remediation: c.remediation ?? null, ...c.alert ? { alert: c.alert } : {} });
     }
     for (const c of healthChecks) {
       const supersededCode = c.details?.supersededCode;
@@ -14454,7 +14497,7 @@ var Notifier = class {
       const causeIds = Array.isArray(c.details?.supersededBy) ? c.details.supersededBy : [];
       const cause = failing.find((f) => causeIds.includes(f.id));
       const status2 = c.details?.supersededStatus === "warn" ? "warn" : "fail";
-      urgentItems.push({ id: c.id, code: supersededCode, rank: rank(status2), status: status2, summary: cause?.summary ?? c.summary, remediation: cause?.remediation ?? null });
+      urgentItems.push({ id: c.id, code: supersededCode, rank: rank(status2), status: status2, summary: cause?.summary ?? c.summary, remediation: cause?.remediation ?? null, ...cause?.alert ? { alert: cause.alert } : {} });
     }
     urgentItems.sort((a, b) => b.rank - a.rank);
     const urgentById = new Map(urgentItems.map((item) => [item.id, item]));
@@ -14517,7 +14560,7 @@ var Notifier = class {
       const previousUrgent = toldRank === 0 ? "ok" : toldRank === 2 ? "fail" : "warn";
       const lead = urgentNew[0];
       const onlyCleared = urgentCleared.length === 1 ? graded.find((c) => c.id === urgentCleared[0].id) : void 0;
-      const resolvedSummary = onlyCleared ? onlyCleared.status === "ok" ? onlyCleared.summary : `No longer urgent. ${onlyCleared.summary}` : `${urgentCleared.length} urgent problems are resolved.`;
+      const resolvedSummary = onlyCleared ? onlyCleared.status === "ok" ? onlyCleared.summary : `${HEALTH_NO_LONGER_URGENT} ${onlyCleared.summary}` : `${urgentCleared.length} urgent problems are resolved.`;
       const urgentHealth = urgentEvent === "health.urgent" && lead ? {
         status: lead.status,
         code: lead.code,
@@ -14525,7 +14568,7 @@ var Notifier = class {
         remediation: lead.remediation,
         checkedAt: now,
         previousStatus: previousUrgent,
-        failing: urgentItems.map((item) => ({ id: item.id, status: item.status, code: item.code, summary: item.summary })),
+        failing: urgentItems.map((item) => ({ id: item.id, status: item.status, code: item.code, summary: item.summary, remediation: item.remediation, ...item.alert ? { alert: item.alert } : {} })),
         added: breachCodes(urgentNew),
         ...urgentCleared.length > 0 ? { cleared: breachCodes(urgentCleared) } : {}
       } : {
@@ -14583,7 +14626,7 @@ var Notifier = class {
         remediation: worst?.remediation ?? null,
         checkedAt: now,
         previousStatus,
-        failing: failing.map((c) => ({ id: c.id, status: c.status, code: c.code, summary: c.summary })),
+        failing: failing.map((c) => ({ id: c.id, status: c.status, code: c.code, summary: c.summary, remediation: c.remediation ?? null, ...c.alert ? { alert: c.alert } : {} })),
         ...added ? { added } : {},
         ...cleared ? { cleared } : {}
       },
@@ -19680,6 +19723,10 @@ async function createServer(opts) {
       schedulerClient.trafficSync(projectName, sourceId).finally(() => {
         scheduledSyncClaims.delete(syncRunClaimKey(projectName, RunKinds["traffic-sync"], sourceId));
       }).catch((err) => {
+        if (err instanceof CliError && err.code === "OPERATION_IN_PROGRESS") {
+          app.log.info({ projectName, sourceId }, "Scheduled traffic sync skipped: the source is busy");
+          return;
+        }
         app.log.error(
           {
             projectName,
@@ -19730,7 +19777,7 @@ async function createServer(opts) {
     onSiteAuditRequested: (runId, projectId, auditOpts) => {
       runSiteAudit(runId, projectId, auditOpts);
     }
-  });
+  }, { spreadMs: opts.scheduleSpreadMs ?? SCHEDULE_SPREAD_MS });
   const providerSummary = providerSummaries(registry, opts.config);
   const googleSettingsSummary = {
     configured: Boolean(

package/dist/{chunk-KLGHY67V.js → chunk-CWMJQ2JV.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-5NYS3ABL.js";
+} from "./chunk-67262NJL.js";
 import {
   getConfigDir
-} from "./chunk-2LY4FY4N.js";
+} from "./chunk-A57HYHJ3.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-LAILXR2F.js";
+} from "./chunk-QNFX7ZCT.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{chunk-U2WPZZPQ.js → chunk-EHTSCLEL.js}

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

package/dist/{chunk-IVZMXHXE.js → chunk-ERJ54U2I.js}

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

package/dist/{chunk-IALK4DQJ.js → chunk-GRWZC3GQ.js}

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

package/dist/{chunk-YQGVA64Q.js → chunk-H22RCHYH.js}

@@ -2,11 +2,11 @@ import {
   dedupeGscSitemapUrls,
   resolveDiscoveredGscSitemapUrls,
   submitGscSitemapBatches
-} from "./chunk-DAKJBAUN.js";
+} from "./chunk-SN5A767O.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-MMRJUOE2.js";
+} from "./chunk-NOQCIXM6.js";
 import {
   CliError
 } from "./chunk-HGMYEDAQ.js";
@@ -173,7 +173,7 @@ import {
   trafficSeriesGranularitySchema,
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/mcp/tool-registry.ts
 import { z as z2 } from "zod";
@@ -861,10 +861,15 @@ var trafficBackfillInputSchema = z2.object({
   sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_sources_list."),
   days: z2.number().int().positive().max(90).optional().describe("Lookback window in days. Default 30, capped by the adapter at 90d. Generic WordPress replace backfill is unavailable because retained coverage is unproven.")
 });
+var trafficDeclareGapInputSchema = z2.object({
+  project: projectNameSchema,
+  sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_sources_list."),
+  skippedThroughAt: z2.string().min(1).describe("The source's current skippedThroughAt, exactly as canonry_traffic_sources_list returned it. A newer skip is refused, never cleared.")
+});
 var trafficResetInputSchema = z2.object({
   project: projectNameSchema,
   sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_sources_list."),
-  advanceToNow: z2.literal(true).describe("Must be `true`. Explicit gate against accidental resets. Advances lastSyncedAt to NOW and clears the source's error state; WordPress also clears its continuation state and records an unrecovered span that needs retention-aware repair.")
+  advanceToNow: z2.literal(true).describe("Must be `true`. Explicit gate against accidental resets. Advances lastSyncedAt to NOW and clears the source's error state; WordPress also clears its continuation state and records an unrecovered span; once it cannot be recovered, record it with canonry_traffic_declare_gap.")
 });
 var trafficEventsInputSchema = z2.object({
   project: projectNameSchema,
@@ -2934,7 +2939,7 @@ var rawCanonryMcpTools = [
   defineTool({
     name: "canonry_traffic_backfill",
     title: "Backfill traffic source",
-    description: 'Async one-shot reclassification for Cloud Run or Vercel traffic. It replaces the selected window\u2019s rollups with a fresh bounded pull and current classifier output. WordPress generic replace backfill is unavailable because the endpoint cannot prove retained coverage; use a retention-aware repair that explicitly declares any unrecoverable span. Returns `{ runId, status: "running" }`; poll canonry_run_get for completion.',
+    description: 'Async one-shot reclassification for Cloud Run or Vercel traffic. It replaces the selected window\u2019s rollups with a fresh bounded pull and current classifier output. WordPress generic replace backfill is unavailable because the endpoint cannot prove retained coverage; record a span that cannot be recovered with canonry_traffic_declare_gap. Returns `{ runId, status: "running" }`; poll canonry_run_get for completion.',
     access: "write",
     tier: "traffic",
     inputSchema: trafficBackfillInputSchema,
@@ -2945,7 +2950,7 @@ var rawCanonryMcpTools = [
   defineTool({
     name: "canonry_traffic_reset",
     title: "Advance traffic source lastSyncedAt to NOW",
-    description: "Operator recovery for a stuck traffic source. Advances `lastSyncedAt` to NOW, sets `status` back to `connected`, and clears `last_error`. A WordPress reset also clears its continuation state and records an unrecovered span so its next bounded drain cannot combine an old cursor with a new window. That stops replay but is not historical repair. Generic WordPress replace-mode backfill is unavailable because retained coverage is unproven; use a retention-aware repair that explicitly declares any unrecoverable span. Archived sources are rejected; reconnect them with the appropriate canonry_traffic_connect_* tool.",
+    description: "Operator recovery for a stuck traffic source. Advances `lastSyncedAt` to NOW, sets `status` back to `connected`, and clears `last_error`. A WordPress reset also clears its continuation state and records an unrecovered span so its next bounded drain cannot combine an old cursor with a new window. That stops replay but is not historical repair. Generic WordPress replace-mode backfill is unavailable because retained coverage is unproven; once a span cannot be recovered, record it with canonry_traffic_declare_gap. Archived sources are rejected; reconnect them with the appropriate canonry_traffic_connect_* tool.",
     access: "write",
     tier: "traffic",
     inputSchema: trafficResetInputSchema,
@@ -2953,6 +2958,17 @@ var rawCanonryMcpTools = [
     openApiOperations: ["POST /api/v1/projects/{name}/traffic/sources/{id}/reset"],
     handler: (client, input) => client.trafficReset(input.project, input.sourceId)
   }),
+  defineTool({
+    name: "canonry_traffic_declare_gap",
+    title: "Record a traffic gap as unrecoverable",
+    description: "Record a traffic source's unrecovered skip (its skippedThroughAt) as data that cannot be recovered, and clear it so the traffic.sync-lag.unrecovered-skip doctor check passes. Rollups are untouched; an audit entry keeps the span. For WordPress, whose plugin feed cannot prove a historical repair, or any source whose provider no longer retains the span; backfill a recoverable gap instead. This hides a data-loss warning, so declare only after the person running the project agrees.",
+    access: "write",
+    tier: "traffic",
+    inputSchema: trafficDeclareGapInputSchema,
+    annotations: writeAnnotations({ idempotentHint: false, destructiveHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/traffic/sources/{id}/declare-gap"],
+    handler: (client, input) => client.trafficDeclareGap(input.project, input.sourceId, input.skippedThroughAt)
+  }),
   defineTool({
     name: "canonry_snapshot",
     title: "Generate a prospect snapshot",

package/dist/{chunk-RGD5SDT3.js → chunk-HNZQVIPS.js}

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

package/dist/{chunk-UVDBUMYV.js → chunk-IDQZTPRG.js}

@@ -1,6 +1,6 @@
 import {
   createApiClient
-} from "./chunk-SDZKHJ6W.js";
+} from "./chunk-LEG7F3DN.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -19,7 +19,7 @@ import {
   formatMicros,
   formatRunErrorOneLine,
   resolveProviderInput
-} from "./chunk-U6CNJC2Y.js";
+} from "./chunk-TKLE2Y6H.js";
 
 // src/commands/run.ts
 function getClient() {

package/dist/{chunk-I3CMCTNE.js → chunk-IRRONWF7.js}

@@ -1,10 +1,10 @@
 import {
   registeredProviderNames
-} from "./chunk-IALK4DQJ.js";
+} from "./chunk-GRWZC3GQ.js";
 import {
   configExists,
   loadConfigRaw
-} from "./chunk-2LY4FY4N.js";
+} from "./chunk-A57HYHJ3.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-F63SHN5T.js");
+      const { createClient, projects, queries: queriesTable } = await import("./src-CTHVFVLF.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-OCAFOFS2.js");
+  const { serveCommand } = await import("./serve-VIEGFGSK.js");
   await serveCommand(format);
 }