@canonry/canonry 5.21.0 → 5.22.0

package/dist/{chunk-2LO7FLVD.js → chunk-S5OSY3PI.js}

@@ -15051,12 +15051,27 @@ var checkCategorySchema = z50.enum([
   "agent"
 ]);
 var CheckCategories = checkCategorySchema.enum;
+var checkNotificationPolicySchema = z50.enum(["health", "silent"]);
+var CheckNotificationPolicies = checkNotificationPolicySchema.enum;
+var reportMonthSchema = z50.string().regex(/^[1-9]\d{3}-(0[1-9]|1[0-2])$/, "Expected YYYY-MM");
+function reportMonthsForDoctor(reportMonth, now = /* @__PURE__ */ new Date()) {
+  if (reportMonth !== void 0) return [reportMonthSchema.parse(reportMonth)];
+  const current = now.toISOString().slice(0, 7);
+  if (now.getUTCDate() > 3) return [current];
+  const previous = new Date(Date.parse(calendarMonthBounds(current).since) - 1).toISOString().slice(0, 7);
+  return [previous, current];
+}
+function gradedReportMonths(months, now = /* @__PURE__ */ new Date()) {
+  const current = now.toISOString().slice(0, 7);
+  return new Set(months.length > 1 ? months.filter((month) => month !== current) : months);
+}
 var checkResultSchema = z50.object({
   id: z50.string(),
   category: checkCategorySchema,
   scope: checkScopeSchema,
   title: z50.string(),
   status: checkStatusSchema,
+  notificationPolicy: checkNotificationPolicySchema.optional().describe("Health checks page by default. Silent report advisories remain visible but never affect health alert state."),
   code: z50.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
   summary: z50.string(),
   remediation: z50.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
@@ -15066,6 +15081,7 @@ var checkResultSchema = z50.object({
 var doctorReportSchema = z50.object({
   scope: checkScopeSchema,
   project: z50.string().nullable().describe('Project name when scope is "project", null otherwise.'),
+  reportMonths: z50.array(reportMonthSchema).optional().describe("Calendar months evaluated by project report readiness checks."),
   generatedAt: z50.string().describe("ISO-8601 timestamp when this doctor run started."),
   durationMs: z50.number().int().nonnegative(),
   summary: z50.object({
@@ -15097,6 +15113,15 @@ function summarizeCheckResults(results) {
   }
   return summary;
 }
+function groupIsoDateRanges(dates) {
+  const ranges = [];
+  for (const date of [...new Set(dates)].sort()) {
+    const previous = ranges.at(-1);
+    if (previous && shiftIsoCalendarDate(previous.end, 1) === date) previous.end = date;
+    else ranges.push({ start: date, end: date });
+  }
+  return ranges;
+}
 
 // ../contracts/src/index-coverage.ts
 function deriveIndexCoverage(input) {
@@ -20229,8 +20254,13 @@ export {
   CheckStatuses,
   CheckScopes,
   CheckCategories,
+  CheckNotificationPolicies,
+  reportMonthSchema,
+  reportMonthsForDoctor,
+  gradedReportMonths,
   doctorReportSchema,
   summarizeCheckResults,
+  groupIsoDateRanges,
   deriveIndexCoverage,
   normalizeQueryText,
   citationVisibilityResponseSchema,

package/dist/{chunk-NFN5GSEJ.js → chunk-XFHXKLNT.js}

@@ -13,19 +13,19 @@ import {
   resolveOperatorApiKeyIds,
   runWithUsageTags,
   saveConfigPatch
-} from "./chunk-FRWZWJB3.js";
+} from "./chunk-GLLY2GEV.js";
 import {
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout
-} from "./chunk-HDJHQPW3.js";
+} from "./chunk-3LCR6WU6.js";
 import {
   CanonryMcpToolNames,
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   isMachineFormat
-} from "./chunk-WUT3G2GM.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -172,6 +172,7 @@ import {
   runChecks,
   runFills,
   runs,
+  scheduledHealthCheckIds,
   schedules,
   serializeUserSessionCookie,
   siteAuditPages,
@@ -186,7 +187,7 @@ import {
   siteLivenessState,
   toAlertView,
   usageCounters
-} from "./chunk-FAVYLZQV.js";
+} from "./chunk-P5VXVFQW.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_NONE,
@@ -201,6 +202,7 @@ import {
   CANONRY_NPM_PACKAGE_URL,
   CITED_URL_CAPTURE_VERSION,
   CcReleaseSyncStatuses,
+  CheckNotificationPolicies,
   DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT,
   DiscoveryCompetitorTypes,
   GOOGLE_ADS_CAMPAIGN_METRICS_MAX_CAMPAIGNS,
@@ -303,6 +305,7 @@ import {
   hostMatchesAnyDomain,
   hostMatchesDomain,
   hostOf,
+  inclusiveDayCount,
   isAgentProviderId,
   isBrowserProvider,
   isGhostTelemetryEvent,
@@ -331,6 +334,7 @@ import {
   providerError,
   providerSupportsLocationContext,
   registrableDomain,
+  reportMonthsForDoctor,
   resolveProviderModel,
   resolveSnapshotRequestQueries,
   retryAfterDelayMs,
@@ -353,7 +357,7 @@ import {
   visibilityReportRequestSchema,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {
@@ -6648,7 +6652,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "9367462bc55240da41850bf9358ec7327c387258" : void 0;
+  const embedded = true ? "120bbd89c1dedb8df5c2850da43ac2e71ccd3cdc" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -12235,7 +12239,7 @@ function readStoredGroundingSources(rawResponse) {
   return result2;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-3UUKRAZ5.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-CXNBKRHV.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -13436,11 +13440,16 @@ function startSiteLivenessLoop(deps, intervalMs = SITE_LIVENESS_INTERVAL_MS) {
 
 // src/data-refresh.ts
 var log16 = createLogger("DataRefresh");
-async function refreshAllIntegrations(client, projectName) {
+function gaRefreshDays(now = /* @__PURE__ */ new Date()) {
+  const [reportMonth] = reportMonthsForDoctor(void 0, now);
+  const reach = inclusiveDayCount(`${reportMonth}-01`, now.toISOString().slice(0, 10)) ?? 0;
+  return Math.max(30, reach);
+}
+async function refreshAllIntegrations(client, projectName, now = /* @__PURE__ */ new Date()) {
   const integrations = [
     { name: "gsc", run: () => client.gscSync(projectName, {}) },
     { name: "bing", run: () => client.bingInspectSitemap(projectName, {}) },
-    { name: "ga", run: () => client.gaSync(projectName, { days: 30 }) },
+    { name: "ga", run: () => client.gaSync(projectName, { days: gaRefreshDays(now) }) },
     { name: "gbp", run: () => client.triggerGbpSync(projectName, {}) },
     // `ads` remains the OpenAI / ChatGPT Ads integration. For scheduled
     // refreshes, Google providers have explicit names and fan out only here.
@@ -13581,13 +13590,15 @@ var Notifier = class {
           return 0;
       }
     };
-    const graded = report.checks.filter((c) => c.status === "fail" || c.status === "warn" || c.status === "ok");
+    const healthChecks = report.checks.filter((c) => c.notificationPolicy !== CheckNotificationPolicies.silent);
+    if (healthChecks.length === 0 && report.checks.length > 0) return null;
+    const graded = healthChecks.filter((c) => c.status === "fail" || c.status === "warn" || c.status === "ok");
     const failing = graded.filter((c) => c.status !== "ok").sort((a, b) => rank(b.status) - rank(a.status) || categoryRank(b.category) - categoryRank(a.category) || a.id.localeCompare(b.id));
     const worst = failing.at(0) ?? null;
     const noSignal = graded.length === 0;
     const status = noSignal ? "warn" : worst ? worst.status : "ok";
     const code = noSignal ? "health.no-signal" : worst?.code ?? "health.ok";
-    const summary = noSignal ? `No health check produced a result (${report.checks.length} skipped) \u2014 health is unknown, not confirmed.` : worst?.summary ?? `All ${graded.length} health check(s) passing.`;
+    const summary = noSignal ? `No health check produced a result (${healthChecks.length} skipped) \u2014 health is unknown, not confirmed.` : worst?.summary ?? `All ${graded.length} health check(s) passing.`;
     const previous = this.db.select().from(doctorHealthState).where(eq17(doctorHealthState.projectId, projectId)).get();
     const previousStatus = previous?.status ?? null;
     const failingSignature = failing.map((c) => `${c.status}:${c.code}`).join(",");
@@ -19493,7 +19504,7 @@ async function createServer(opts) {
     onDoctorRequested: (projectName) => {
       void (async () => {
         try {
-          const report = await schedulerClient.runDoctor({ project: projectName });
+          const report = await schedulerClient.runDoctor({ project: projectName, checkIds: scheduledHealthCheckIds() });
           const project = opts.db.select().from(projects).where(eq27(projects.name, projectName)).get();
           if (!project) {
             app.log.warn({ projectName }, "doctor schedule fired for an unknown project");

package/dist/{chunk-MEAKE5W7.js → chunk-YTSXQUJ3.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-FRWZWJB3.js";
+} from "./chunk-GLLY2GEV.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-WUT3G2GM.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-NFN5GSEJ.js";
+} from "./chunk-XFHXKLNT.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-MEAKE5W7.js";
+} from "./chunk-YTSXQUJ3.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-FRWZWJB3.js";
+} from "./chunk-GLLY2GEV.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-HDJHQPW3.js";
+import "./chunk-3LCR6WU6.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-WUT3G2GM.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-FAVYLZQV.js";
+} from "./chunk-P5VXVFQW.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -179,7 +179,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -444,7 +444,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-7BVVVXPM.js");
+  const { createDemoServer } = await import("./demo-server-HULNEORN.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -3051,7 +3051,8 @@ async function doctorCommand(opts) {
   const client = createApiClient();
   const report = await client.runDoctor({
     project: opts.project,
-    checkIds: opts.checks
+    checkIds: opts.checks,
+    ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {}
   });
   if (opts.format === "json") {
     console.log(JSON.stringify(report, null, 2));
@@ -3077,8 +3078,8 @@ async function runDoctorAll(opts) {
   const client = createApiClient();
   const projects2 = await client.listProjects();
   const [globalReport, ...projectReports] = await Promise.all([
-    client.runDoctor({ checkIds: opts.checks }),
-    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks }))
+    client.runDoctor({ checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }),
+    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }))
   ]);
   const byKey = { __global__: globalReport };
   projects2.forEach((p, i) => {
@@ -3174,13 +3175,14 @@ ${header}`);
 }
 
 // src/cli-commands/doctor.ts
-var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--format json|jsonl]";
+var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--report-month YYYY-MM] [--format json|jsonl]";
 var DOCTOR_CLI_COMMANDS = [
   {
     path: ["doctor"],
     usage: USAGE,
     options: {
       project: stringOption(),
+      "report-month": stringOption(),
       check: multiStringOption(),
       all: { type: "boolean" }
     },
@@ -3188,6 +3190,7 @@ var DOCTOR_CLI_COMMANDS = [
     run: async (input) => {
       await doctorCommand({
         project: getString(input.values, "project"),
+        reportMonth: getString(input.values, "report-month"),
         all: getBoolean(input.values, "all"),
         checks: getStringArray(input.values, "check"),
         format: input.format

package/dist/{demo-server-7BVVVXPM.js → demo-server-HULNEORN.js}

@@ -4,11 +4,11 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-HDJHQPW3.js";
+} from "./chunk-3LCR6WU6.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-WUT3G2GM.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -84,7 +84,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-FAVYLZQV.js";
+} from "./chunk-P5VXVFQW.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -108,7 +108,7 @@ import {
   placementLinkDecision,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-NFN5GSEJ.js";
+} from "./chunk-XFHXKLNT.js";
 import {
   loadConfig
-} from "./chunk-FRWZWJB3.js";
-import "./chunk-HDJHQPW3.js";
-import "./chunk-WUT3G2GM.js";
-import "./chunk-FAVYLZQV.js";
-import "./chunk-2LO7FLVD.js";
+} from "./chunk-GLLY2GEV.js";
+import "./chunk-3LCR6WU6.js";
+import "./chunk-DDL2XSNM.js";
+import "./chunk-P5VXVFQW.js";
+import "./chunk-S5OSY3PI.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-3UUKRAZ5.js → intelligence-service-CXNBKRHV.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-FAVYLZQV.js";
-import "./chunk-2LO7FLVD.js";
+} from "./chunk-P5VXVFQW.js";
+import "./chunk-S5OSY3PI.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-MEAKE5W7.js";
+} from "./chunk-YTSXQUJ3.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-FRWZWJB3.js";
-import "./chunk-WUT3G2GM.js";
+} from "./chunk-GLLY2GEV.js";
+import "./chunk-DDL2XSNM.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "5.21.0",
+  "version": "5.22.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "keywords": [
@@ -88,30 +88,30 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-web": "0.0.0",
     "@ainyc/canonry-api-client": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
-    "@ainyc/canonry-integration-google-ads": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-google-ads": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0"
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",