@canonry/canonry 4.165.1 → 4.166.0

package/dist/{chunk-QKLNTSQ2.js → chunk-KU45I42F.js}

@@ -236,6 +236,7 @@ import {
   deriveCitedUrlCandidates,
   deriveSiteHealthState,
   deriveWinnabilityClass,
+  describeError,
   determineAnswerMentioned,
   discoveryBucketSchema,
   discoveryHarvestDtoSchema,
@@ -470,6 +471,7 @@ import {
   recommendationExplainRequestSchema,
   recommendationExplanationDtoSchema,
   registrableDomain,
+  relativeChangeRatio,
   reportActionCategoryLabel,
   reportActionTone,
   reportComparisonWindowDays,
@@ -582,7 +584,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-BU6C2DKF.js";
+} from "./chunk-GU7T2JUB.js";
 
 // src/intelligence-service.ts
 import { eq as eq59, desc as desc26, asc as asc11, and as and47, ne as ne7, or as or13, inArray as inArray21, gte as gte14, lte as lte12 } from "drizzle-orm";
@@ -8635,7 +8637,9 @@ function pickWorstKeywordDrop(loc) {
   let worst = null;
   for (const point of loc.keywordPoints) {
     if (point.recent == null || point.prior == null || point.prior < GBP_KEYWORD_MIN_BASELINE) continue;
-    const dropPct = Math.round((point.prior - point.recent) / point.prior * 100);
+    const changeRatio = relativeChangeRatio(point.recent, point.prior);
+    if (changeRatio === null) continue;
+    const dropPct = Math.round(-changeRatio * 100);
     if (dropPct < GBP_KEYWORD_DROP_PCT) continue;
     if (!worst || dropPct > worst.dropPct) {
       worst = { keyword: point.keyword, dropPct, recent: point.recent, prior: point.prior };
@@ -13630,7 +13634,7 @@ function assertLimits(limits) {
 // ../api-routes/src/measurement-service.ts
 var DEFAULT_DISCOVERY_URL_LIMIT = 1e4;
 function messageOf(error) {
-  return error instanceof Error ? error.message : String(error);
+  return describeError(error);
 }
 async function measurementServiceRoutes(app, opts) {
   app.post("/projects/:name/measurement-discovery", {
@@ -16719,7 +16723,7 @@ function availableStableKey(preferred, taken) {
   throw validationError(`Discovery could not find a free stable key for '${preferred}'.`);
 }
 function messageOf2(error) {
-  return error instanceof Error ? error.message : String(error);
+  return describeError(error);
 }
 async function measurementDiscoveryV2Routes(app) {
   app.post("/projects/:name/measurement-plan/draft/actions/import-sitemap", async (request, reply) => {
@@ -19088,7 +19092,7 @@ async function applyRoutes(app, opts) {
         try {
           cronExpr = resolvePreset(schedSpec.preset);
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = describeError(err);
           throw validationError(msg);
         }
       } else if (schedSpec.cron) {
@@ -25913,7 +25917,7 @@ function summarizeServer(crawlers, fetches, referrals) {
 }
 function comparisonDetail(latest, prior) {
   if (prior === 0) return `${latest} in the latest cohort versus 0 in the prior cohort`;
-  const change = Math.round((latest - prior) / prior * 100);
+  const change = deltaPercent(latest, prior) ?? 0;
   return `${latest} in the latest cohort versus ${prior} prior (${change >= 0 ? "+" : ""}${change}%)`;
 }
 function aggregateCoverage(row) {
@@ -35135,7 +35139,7 @@ async function scheduleRoutes(app, opts) {
       try {
         cronExpr = resolvePreset(preset);
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = describeError(err);
         throw validationError(msg);
       }
     } else {
@@ -35612,7 +35616,7 @@ function computeWindowDelta(rows, referenceDate) {
     const prior = prior7d[metric2] ?? 0;
     recent7d[metric2] = recent;
     prior7d[metric2] = prior;
-    deltaPct[metric2] = prior === 0 ? null : Math.round((recent - prior) / prior * 100);
+    deltaPct[metric2] = deltaPercent(recent, prior);
   }
   return { recent7d, prior7d, deltaPct };
 }
@@ -37622,7 +37626,7 @@ function gscErrorToAppError(err, context) {
       status != null ? { upstreamStatus: status } : void 0
     );
   }
-  return providerError(`${context}: ${err instanceof Error ? err.message : String(err)}`);
+  return providerError(`${context}: ${describeError(err)}`);
 }
 async function googleRoutes(app, opts) {
   if (opts.googleStateSecret === void 0) {
@@ -37756,7 +37760,7 @@ async function googleRoutes(app, opts) {
     try {
       tokens = await exchangeCode(googleClientId, googleClientSecret, code, redirectUri);
     } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
+      const msg = describeError(err);
       return reply.type("text/html").send(
         `<html><body style="font-family:system-ui;padding:40px;max-width:600px;margin:0 auto">
           <h2 style="color:#ef4444">Token exchange failed</h2>
@@ -38377,7 +38381,7 @@ async function googleRoutes(app, opts) {
         });
         results.push({ sitemapUrl, status: "accepted", submittedAt });
       } catch (err) {
-        results.push({ sitemapUrl, status: "error", error: err instanceof Error ? err.message : String(err) });
+        results.push({ sitemapUrl, status: "error", error: describeError(err) });
       }
     }
     const accepted = results.filter((result) => result.status === "accepted").length;
@@ -38552,7 +38556,7 @@ async function googleRoutes(app, opts) {
           status: "success"
         });
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = describeError(err);
         results.push({
           url,
           type: "URL_UPDATED",
@@ -42864,7 +42868,7 @@ async function adsRoutes(app, opts) {
       try {
         account = await opts.verifyAdsAccount(parsed.data.apiKey);
       } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
+        const message = describeError(err);
         throw validationError(`OpenAI Ads API rejected the key: ${message}`);
       }
       const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -44201,7 +44205,7 @@ async function bingRoutes(app, opts) {
       sites = await getSites(apiKey);
       bingLog("info", "connect.verify-key", { domain: project.canonicalDomain, siteCount: sites.length });
     } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = describeError(e);
       bingLog("error", "connect.verify-key-failed", { domain: project.canonicalDomain, error: msg });
       throw validationError(`Failed to verify Bing API key: ${msg}`);
     }
@@ -44469,7 +44473,7 @@ async function bingRoutes(app, opts) {
         } catch (e) {
           bingLog("warn", "inspect-url.crawl-issues-lookup-failed", {
             domain: project.canonicalDomain,
-            error: e instanceof Error ? e.message : String(e)
+            error: describeError(e)
           });
         }
       }
@@ -44502,7 +44506,7 @@ async function bingRoutes(app, opts) {
         discoveryDate
       };
     } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = describeError(e);
       bingLog("error", "inspect-url.failed", { domain: project.canonicalDomain, url, error: msg });
       app.db.update(runs).set({ status: RunStatuses.failed, error: msg, finishedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(eq42(runs.id, runId)).run();
       throw e;
@@ -44580,7 +44584,7 @@ async function bingRoutes(app, opts) {
           }
           bingLog("info", "index-submit.batch-ok", { domain: project.canonicalDomain, batchSize: batch.length, urls: batch });
         } catch (e) {
-          const msg = e instanceof Error ? e.message : String(e);
+          const msg = describeError(e);
           const now = (/* @__PURE__ */ new Date()).toISOString();
           for (const url of batch) {
             results.push({ url, status: "error", submittedAt: now, error: msg });
@@ -44595,7 +44599,7 @@ async function bingRoutes(app, opts) {
         results.push({ url, status: "success", submittedAt: (/* @__PURE__ */ new Date()).toISOString() });
         bingLog("info", "index-submit.ok", { domain: project.canonicalDomain, url });
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         results.push({ url, status: "error", submittedAt: (/* @__PURE__ */ new Date()).toISOString(), error: msg });
         bingLog("error", "index-submit.failed", { domain: project.canonicalDomain, url, error: msg });
       }
@@ -45153,7 +45157,7 @@ function ga4ErrorToAppError(err, context) {
     }
     return providerError(`${context}: ${err.message}`);
   }
-  return providerError(`${context}: ${err instanceof Error ? err.message : String(err)}`);
+  return providerError(`${context}: ${describeError(err)}`);
 }
 async function resolveGa4AccessToken(opts, projectName, canonicalDomain) {
   const saConn = opts.ga4CredentialStore?.getConnection(projectName);
@@ -45219,7 +45223,7 @@ async function ga4Routes(app, opts) {
         await verifyConnection(clientEmail, privateKey, propertyId);
         gaLog("info", "connect.verified.service-account", { projectId: project.id, propertyId });
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         gaLog("error", "connect.verify-failed", { projectId: project.id, propertyId, error: msg });
         throw validationError(`Failed to verify GA4 credentials: ${msg}`);
       }
@@ -45264,7 +45268,7 @@ async function ga4Routes(app, opts) {
       await verifyConnectionWithToken(accessToken, propertyId);
       gaLog("info", "connect.verified.oauth", { projectId: project.id, propertyId });
     } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = describeError(e);
       gaLog("error", "connect.verify-failed.oauth", { projectId: project.id, propertyId, error: msg });
       throw validationError(`Failed to verify GA4 access: ${msg}`);
     }
@@ -45550,7 +45554,7 @@ async function ga4Routes(app, opts) {
       const [acquisitionSettled, leadsSettled] = await measurementFetch;
       const measurementNow = (/* @__PURE__ */ new Date()).toISOString();
       const recordMeasurementFailure = (component, reason) => {
-        const message = reason instanceof Error ? reason.message : String(reason);
+        const message = describeError(reason);
         gaLog("warn", "measurement.component-failed", {
           projectId: project.id,
           runId,
@@ -45564,7 +45568,7 @@ async function ga4Routes(app, opts) {
             projectId: project.id,
             runId,
             component,
-            error: stateError instanceof Error ? stateError.message : String(stateError)
+            error: describeError(stateError)
           });
         }
         return { status: "error", days: component === "acquisition" ? acquisitionDays : leadDays, rowCount: 0, error: message };
@@ -45648,7 +45652,7 @@ async function ga4Routes(app, opts) {
         ...syncedComponents ? { syncedComponents } : {}
       };
     } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = describeError(e);
       gaLog("error", "sync.fetch-failed", { projectId: project.id, runId, error: msg });
       app.db.update(runs).set({ status: RunStatuses.failed, error: msg, finishedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(eq44(runs.id, runId)).run();
       throw e;
@@ -45941,7 +45945,6 @@ async function ga4Routes(app, opts) {
     const prev7d = sumSocial(daysAgo(14), daysAgo(7));
     const current30d = sumSocial(daysAgo(30), fmt(today));
     const prev30d = sumSocial(daysAgo(60), daysAgo(30));
-    const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
     const sourceCurrent = app.db.select({
       source: gaSocialReferrals.source,
       sessions: sql16`SUM(${gaSocialReferrals.sessions})`
@@ -45970,17 +45973,17 @@ async function ga4Routes(app, opts) {
           source: row.source,
           sessions7d: row.sessions,
           sessionsPrev7d: prev,
-          changePct: pct(row.sessions, prev) ?? (row.sessions > 0 ? 100 : 0)
+          changePct: deltaPercent(row.sessions, prev) ?? (row.sessions > 0 ? 100 : 0)
         };
       }
     }
     return {
       socialSessions7d: current7d?.sessions ?? 0,
       socialSessionsPrev7d: prev7d?.sessions ?? 0,
-      trend7dPct: pct(current7d?.sessions ?? 0, prev7d?.sessions ?? 0),
+      trend7dPct: deltaPercent(current7d?.sessions ?? 0, prev7d?.sessions ?? 0),
       socialSessions30d: current30d?.sessions ?? 0,
       socialSessionsPrev30d: prev30d?.sessions ?? 0,
-      trend30dPct: pct(current30d?.sessions ?? 0, prev30d?.sessions ?? 0),
+      trend30dPct: deltaPercent(current30d?.sessions ?? 0, prev30d?.sessions ?? 0),
       biggestMover
     };
   });
@@ -45994,7 +45997,6 @@ async function ga4Routes(app, opts) {
       d.setDate(d.getDate() - n);
       return fmt(d);
     };
-    const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
     const sumTotal = (from, to) => app.db.select({ sessions: sql16`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and35(eq44(gaTrafficSnapshots.projectId, project.id), sql16`${gaTrafficSnapshots.date} >= ${from}`, sql16`${gaTrafficSnapshots.date} < ${to}`)).get();
     const sumOrganic = (from, to) => app.db.select({ sessions: sql16`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and35(eq44(gaTrafficSnapshots.projectId, project.id), sql16`${gaTrafficSnapshots.date} >= ${from}`, sql16`${gaTrafficSnapshots.date} < ${to}`)).get();
     const sumDirect = (from, to) => app.db.select({ sessions: sql16`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and35(eq44(gaTrafficSnapshots.projectId, project.id), sql16`${gaTrafficSnapshots.date} >= ${from}`, sql16`${gaTrafficSnapshots.date} < ${to}`)).get();
@@ -46011,7 +46013,7 @@ async function ga4Routes(app, opts) {
       const p7 = sum(daysAgo(14), daysAgo(7))?.sessions ?? 0;
       const c30 = sum(daysAgo(30), todayStr)?.sessions ?? 0;
       const p30 = sum(daysAgo(60), daysAgo(30))?.sessions ?? 0;
-      return { sessions7d: c7, sessionsPrev7d: p7, trend7dPct: pct(c7, p7), sessions30d: c30, sessionsPrev30d: p30, trend30dPct: pct(c30, p30) };
+      return { sessions7d: c7, sessionsPrev7d: p7, trend7dPct: deltaPercent(c7, p7), sessions30d: c30, sessionsPrev30d: p30, trend30dPct: deltaPercent(c30, p30) };
     };
     const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql16`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and35(
       eq44(gaAiReferrals.projectId, project.id),
@@ -46034,7 +46036,7 @@ async function ga4Routes(app, opts) {
         const delta = Math.abs(row.sessions - p);
         if (delta > maxDelta) {
           maxDelta = delta;
-          mover = { source: row.source, sessions7d: row.sessions, sessionsPrev7d: p, changePct: pct(row.sessions, p) ?? (row.sessions > 0 ? 100 : 0) };
+          mover = { source: row.source, sessions7d: row.sessions, sessionsPrev7d: p, changePct: deltaPercent(row.sessions, p) ?? (row.sessions > 0 ? 100 : 0) };
         }
       }
       return mover;
@@ -46531,7 +46533,7 @@ async function getSiteStatus(connection, env) {
       authenticatedUser: userInfo
     };
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
+    const message = describeError(error);
     return {
       url: site.siteUrl,
       reachable: false,
@@ -46812,7 +46814,7 @@ async function bulkSetSeoMeta(connection, entries, env) {
         return {
           slug: entry.slug,
           status: "skipped",
-          error: error instanceof Error ? error.message : String(error)
+          error: describeError(error)
         };
       }
     }
@@ -46893,7 +46895,7 @@ async function deploySchema(connection, slug, schemas, env) {
     return {
       slug,
       status: "failed",
-      error: error instanceof Error ? error.message : String(error)
+      error: describeError(error)
     };
   }
 }
@@ -47580,7 +47582,7 @@ async function wordpressRoutes(app, opts) {
         });
         steps.push({ name: "connect", status: "completed", summary: `Connected to ${url}` });
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = describeError(err);
         steps.push({ name: "connect", status: "failed", error: msg });
         return { projectName: project.name, steps };
       }
@@ -47596,7 +47598,7 @@ async function wordpressRoutes(app, opts) {
         pageUrls = pageSummaries.map((p) => p.link).filter((link) => typeof link === "string" && link.length > 0);
         steps.push({ name: "audit", status: "completed", summary: `${pageCount} pages audited, ${issueCount} issues` });
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = describeError(err);
         steps.push({ name: "audit", status: "failed", error: msg });
         return { projectName: project.name, steps };
       }
@@ -47636,7 +47638,7 @@ async function wordpressRoutes(app, opts) {
           });
         }
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = describeError(err);
         steps.push({ name: "set-meta", status: "failed", error: msg });
         return { projectName: project.name, steps };
       }
@@ -47662,7 +47664,7 @@ async function wordpressRoutes(app, opts) {
             });
           }
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = describeError(err);
           steps.push({ name: "schema-deploy", status: "failed", error: msg });
           return { projectName: project.name, steps };
         }
@@ -47694,7 +47696,7 @@ async function wordpressRoutes(app, opts) {
             }
           }
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = describeError(err);
           steps.push({ name: "google-submit", status: "skipped", summary: `Google not available: ${msg}` });
         }
         try {
@@ -47719,7 +47721,7 @@ async function wordpressRoutes(app, opts) {
             }
           }
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = describeError(err);
           steps.push({ name: "bing-submit", status: "skipped", summary: `Bing not available: ${msg}` });
         }
       }
@@ -54152,7 +54154,7 @@ async function runBackfillTask(options) {
   try {
     allEvents = await pullForBackfill();
   } catch (e) {
-    markFailed(`${pullErrorPrefix}: ${e instanceof Error ? e.message : String(e)}`);
+    markFailed(`${pullErrorPrefix}: ${describeError(e)}`);
     return;
   }
   if (allEvents.length === 0) {
@@ -54415,7 +54417,7 @@ async function runBackfillTask(options) {
     });
     if (commitOutcome === "source-inactive") return;
   } catch (e) {
-    markFailed(`Backfill rollup write failed: ${e instanceof Error ? e.message : String(e)}`);
+    markFailed(`Backfill rollup write failed: ${describeError(e)}`);
   }
 }
 async function trafficRoutes(app, opts) {
@@ -54624,7 +54626,7 @@ async function trafficRoutes(app, opts) {
             `WordPress traffic probe failed (HTTP ${e.status}): ${e.message}${e.body ? ` \u2014 ${e.body}` : ""}`
           );
         }
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         throw providerError(`WordPress traffic probe failed: ${msg}`);
       }
     });
@@ -54715,7 +54717,7 @@ async function trafficRoutes(app, opts) {
           `Vercel traffic probe failed (HTTP ${e.status}): ${e.message}${e.body ? ` \u2014 ${e.body}` : ""}`
         );
       }
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = describeError(e);
       throw providerError(`Vercel traffic probe failed: ${msg}`);
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -55582,7 +55584,7 @@ async function trafficRoutes(app, opts) {
       try {
         accessToken = await resolveAccessToken2(credential);
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         markFailed(msg, "PROVIDER_AUTH");
         throw providerError(`Failed to resolve Cloud Run access token: ${msg}`);
       }
@@ -55601,7 +55603,7 @@ async function trafficRoutes(app, opts) {
         });
         allEvents = page.events;
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         markFailed(msg, "PROVIDER_PULL");
         throw providerError(`Cloud Run pull failed: ${msg}`);
       }
@@ -55625,7 +55627,7 @@ async function trafficRoutes(app, opts) {
       try {
         pinnedDispatcher = await assertWordpressTargetAllowed(credential.baseUrl);
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         markFailed(msg, "PROVIDER_PULL");
         throw e;
       }
@@ -55651,7 +55653,7 @@ async function trafficRoutes(app, opts) {
         allEvents = collected;
         nextCursor = cursor;
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         markFailed(msg, "PROVIDER_PULL");
         throw providerError(`WordPress pull failed: ${msg}`);
       } finally {
@@ -55753,7 +55755,7 @@ async function trafficRoutes(app, opts) {
         }
         allEvents = drained.events;
       } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
+        const msg = describeError(e);
         markFailed(msg, "PROVIDER_PULL");
         throw providerError(`Vercel pull failed: ${msg}`);
       }
@@ -56995,7 +56997,7 @@ var BING_AUTH_CHECKS = [
           remediation: null
         };
       } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
+        const message = describeError(err);
         return {
           status: CheckStatuses.fail,
           code: "bing.auth.verification-failed",
@@ -57077,7 +57079,7 @@ var BING_AUTH_CHECKS = [
           remediation: null
         };
       } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
+        const message = describeError(err);
         return {
           status: CheckStatuses.fail,
           code: "bing.auth.site-check-failed",
@@ -57337,7 +57339,7 @@ async function checkServiceAccount(conn) {
   try {
     await verifyConnection(conn.clientEmail, conn.privateKey, conn.propertyId);
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = describeError(err);
     return {
       status: CheckStatuses.fail,
       code: "ga.auth.verify-failed",
@@ -57386,7 +57388,7 @@ async function checkOAuthConnection(ctx, projectName, conn) {
     const tokens = await refreshAccessToken(auth.clientId, auth.clientSecret, conn.refreshToken);
     accessToken = tokens.access_token;
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = describeError(err);
     return {
       status: CheckStatuses.fail,
       code: "ga.auth.refresh-failed",
@@ -57398,7 +57400,7 @@ async function checkOAuthConnection(ctx, projectName, conn) {
   try {
     await verifyConnectionWithToken(accessToken, conn.propertyId);
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = describeError(err);
     return {
       status: CheckStatuses.fail,
       code: "ga.auth.verify-failed",
@@ -57517,7 +57519,7 @@ async function resolveGbpToken(ctx) {
     const tokens = await refreshAccessToken(auth.clientId, auth.clientSecret, conn.refreshToken);
     return { ok: true, token: { accessToken: tokens.access_token, conn } };
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = describeError(err);
     return {
       ok: false,
       output: {
@@ -57649,7 +57651,7 @@ var accountAccessCheck = {
           details: { reason: err.reason ?? void 0, status: err.status }
         };
       }
-      const message = err instanceof Error ? err.message : String(err);
+      const message = describeError(err);
       return {
         status: CheckStatuses.fail,
         code: "gbp.account.list-failed",
@@ -57881,7 +57883,7 @@ async function resolveAccessToken(ctx) {
     const tokens = await refreshAccessToken(auth.clientId, auth.clientSecret, conn.refreshToken);
     return { ok: true, token: { accessToken: tokens.access_token } };
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = describeError(err);
     return {
       ok: false,
       output: {
@@ -57973,7 +57975,7 @@ var propertyAccessCheck = {
           details: { error: err.message }
         };
       }
-      const message = err instanceof Error ? err.message : String(err);
+      const message = describeError(err);
       return {
         status: CheckStatuses.fail,
         code: "google.auth.list-sites-failed",
@@ -58560,7 +58562,7 @@ async function runValidator(source, validator, fallbackId, fallbackLabel) {
     }
     return { source, output: result };
   } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
+    const msg = describeError(e);
     return {
       source,
       output: {
@@ -59015,7 +59017,7 @@ var WORDPRESS_PUBLISH_CHECKS = [
             details: { error: err.message }
           };
         }
-        const message = err instanceof Error ? err.message : String(err);
+        const message = describeError(err);
         return {
           status: CheckStatuses.fail,
           code: "wordpress.publish.verification-failed",
@@ -59075,7 +59077,7 @@ async function runChecks(ctx, checks, options = {}) {
     try {
       output = await definition.run(ctx);
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const message = describeError(err);
       output = {
         status: CheckStatuses.fail,
         code: `${definition.id}.runtime-error`,
@@ -62099,7 +62101,7 @@ function buildTrafficSourceValidators(opts) {
             summary: `Cloud Run access token resolves for "${source.displayName}" (project ${record.gcpProjectId}).`
           };
         } catch (e) {
-          const msg = e instanceof Error ? e.message : String(e);
+          const msg = describeError(e);
           return {
             status: CheckStatuses.fail,
             code: "traffic.credentials.resolve-failed",
@@ -62145,7 +62147,7 @@ function buildTrafficSourceValidators(opts) {
           };
         } catch (e) {
           const httpStatus = e instanceof WordpressTrafficApiError ? e.status : null;
-          const msg = e instanceof Error ? e.message : String(e);
+          const msg = describeError(e);
           return {
             status: CheckStatuses.fail,
             code: httpStatus === 401 || httpStatus === 403 ? "traffic.credentials.unauthorized" : "traffic.credentials.resolve-failed",
@@ -62192,7 +62194,7 @@ function buildTrafficSourceValidators(opts) {
           };
         } catch (e) {
           const httpStatus = e instanceof VercelLogsApiError ? e.status : null;
-          const msg = e instanceof Error ? e.message : String(e);
+          const msg = describeError(e);
           return {
             status: CheckStatuses.fail,
             code: httpStatus === 401 || httpStatus === 403 ? "traffic.credentials.unauthorized" : "traffic.credentials.resolve-failed",

package/dist/{chunk-QDOZEMDK.js → chunk-QFMHIUV7.js}

@@ -17,6 +17,7 @@ import {
   adsUnresolvedOperationListQuerySchema,
   backlinkSourceSchema,
   competitorBatchRequestSchema,
+  describeError,
   discoveryBucketSchema,
   discoveryCompetitorTypeSchema,
   discoveryPromoteRequestSchema,
@@ -81,7 +82,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-BU6C2DKF.js";
+} from "./chunk-GU7T2JUB.js";
 
 // src/config.ts
 import fs from "fs";
@@ -5271,7 +5272,7 @@ var ApiClient = class {
       result = await call();
     } catch (err) {
       if (err instanceof CliError) throw err;
-      const msg = err instanceof Error ? err.message : String(err);
+      const msg = describeError(err);
       if (traceEnabled) {
         process.stderr.write(`[trace] (sdk-call) \u2192 ERROR (${Date.now() - traceStart}ms): ${msg}
 `);
@@ -5388,7 +5389,7 @@ var ApiClient = class {
       res = await fetch(url, { method: "POST", headers, body: JSON.stringify(body ?? {}), signal });
     } catch (err) {
       if (err instanceof CliError) throw err;
-      const msg = err instanceof Error ? err.message : String(err);
+      const msg = describeError(err);
       if (msg.includes("fetch failed") || msg.includes("ECONNREFUSED") || msg.includes("connect ECONNREFUSED")) {
         throw new CliError({
           code: "CONNECTION_ERROR",
@@ -5496,7 +5497,7 @@ var ApiClient = class {
         headers: { Authorization: `Bearer ${this.apiKey}` }
       });
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const message = describeError(err);
       if (message.includes("fetch failed") || message.includes("ECONNREFUSED") || message.includes("connect ECONNREFUSED")) {
         throw new CliError({
           code: "CONNECTION_ERROR",
@@ -8260,7 +8261,7 @@ async function submitGscSitemapsFromMcp(client2, input) {
           remaining,
           unconfirmedBatch: { index: Math.floor(offset / 50) + 1, sitemapUrls: batchSitemapUrls },
           partialResult: aggregate,
-          cause: cause instanceof CliError ? { code: cause.code, message: cause.message, details: cause.details } : { message: cause instanceof Error ? cause.message : String(cause) }
+          cause: cause instanceof CliError ? { code: cause.code, message: cause.message, details: cause.details } : { message: describeError(cause) }
         }
       });
     }