@ainyc/canonry 4.60.1 → 4.61.0

package/dist/{chunk-DXWUBWBD.js → chunk-URPUUKLC.js}

@@ -851,6 +851,10 @@ var gbpLocationDtoSchema = z7.object({
   primaryCategoryDisplayName: z7.string().nullable(),
   storefrontAddress: z7.string().nullable(),
   websiteUri: z7.string().nullable(),
+  // Google Maps Place ID + public Maps link (from location metadata; null when
+  // the location is not on Maps). `placeId` is the join key to the Places API.
+  placeId: z7.string().nullable(),
+  mapsUri: z7.string().nullable(),
   selected: z7.boolean(),
   syncedAt: z7.string().nullable(),
   createdAt: z7.string(),
@@ -944,6 +948,22 @@ var gbpLodgingListResponseSchema = z7.object({
   lodging: z7.array(gbpLodgingDtoSchema),
   total: z7.number().int().nonnegative()
 });
+var gbpPlaceDetailsDtoSchema = z7.object({
+  locationName: z7.string(),
+  placeId: z7.string(),
+  /** Field-mask SKU tier the snapshot was fetched at ('atmosphere' | 'pro'). */
+  tier: z7.string(),
+  /** Amenities the public listing advertises, derived from `place`. */
+  amenities: z7.array(z7.string()),
+  /** When this listing was last fetched from Places — advances on every fetch, even when the content is unchanged (this is what the refresh-cadence gate reads). */
+  syncedAt: z7.string(),
+  /** Raw Place Details resource as Google returned it. */
+  place: z7.record(z7.string(), z7.unknown())
+});
+var gbpPlaceDetailsListResponseSchema = z7.object({
+  places: z7.array(gbpPlaceDetailsDtoSchema),
+  total: z7.number().int().nonnegative()
+});
 var gbpSummaryDtoSchema = z7.object({
   scope: z7.object({
     locationName: z7.string().nullable(),
@@ -2099,6 +2119,7 @@ var projectSearchInsightHitSchema = z18.object({
     "competitor-lost",
     // Google Business Profile (local-AEO) insight types — see InsightType.
     "gbp-lodging-gap",
+    "gbp-listing-discrepancy",
     "gbp-cta-gap",
     "gbp-metric-drop",
     "gbp-keyword-drop"
@@ -3887,6 +3908,7 @@ export {
   gbpKeywordImpressionListResponseSchema,
   gbpPlaceActionListResponseSchema,
   gbpLodgingListResponseSchema,
+  gbpPlaceDetailsListResponseSchema,
   gbpSummaryDtoSchema,
   withRetry,
   isRetryableHttpError,

package/dist/{chunk-X4ZZFZQZ.js → chunk-ZTVBTGDW.js}

@@ -8,7 +8,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-CKWHFAVB.js";
+} from "./chunk-PITZUUFV.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -54,14 +54,17 @@ import {
   gbpLocations,
   gbpLodgingSnapshots,
   gbpPlaceActions,
+  gbpPlaceDetails,
   getCrawlIssues,
   getLodging,
+  getPlaceDetails,
   getUrlInfo,
   groupRunsByCreatedAt,
   gscCoverageSnapshots,
   gscSearchData,
   gscUrlInspections,
   hashLodging,
+  hashPlaceDetails,
   insights,
   inspectUrl,
   installDuckdb,
@@ -90,7 +93,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-3G3GAT3E.js";
+} from "./chunk-QZN3J35I.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -138,7 +141,7 @@ import {
   skillsClientSchema,
   validationError,
   withRetry
-} from "./chunk-DXWUBWBD.js";
+} from "./chunk-URPUUKLC.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -2692,6 +2695,21 @@ var perplexityAdapter = {
   }
 };
 
+// src/places-config.ts
+var DEFAULT_TIER = "atmosphere";
+var DEFAULT_REFRESH_INTERVAL_DAYS = 7;
+function parseTier(raw) {
+  return raw === "atmosphere" || raw === "pro" || raw === "off" ? raw : void 0;
+}
+function getPlacesConfig(config) {
+  const envKey = process.env.GOOGLE_PLACES_API_KEY?.trim();
+  const apiKey = envKey || config.places?.apiKey || void 0;
+  const tier = parseTier(process.env.GOOGLE_PLACES_TIER?.trim()) ?? config.places?.tier ?? DEFAULT_TIER;
+  const envInterval = Number(process.env.GOOGLE_PLACES_REFRESH_INTERVAL_DAYS);
+  const refreshIntervalDays = Number.isFinite(envInterval) && envInterval > 0 ? envInterval : config.places?.refreshIntervalDays ?? DEFAULT_REFRESH_INTERVAL_DAYS;
+  return { apiKey, tier, refreshIntervalDays };
+}
+
 // src/google-config.ts
 function ensureConnections(config) {
   if (!config.google) config.google = {};
@@ -3542,6 +3560,71 @@ function buildPhases(input) {
 // src/gsc-sync.ts
 import crypto4 from "crypto";
 import { eq as eq2, and as and2, sql as sql2 } from "drizzle-orm";
+
+// src/gsc-inspect-paced.ts
+var INSPECT_BASE_DELAY_MS = 1e3;
+var INSPECT_PACING_JITTER_MS = 250;
+var INSPECT_MAX_RETRIES = 3;
+var INSPECT_MAX_BACKOFF_MS = 3e4;
+var INSPECT_FAILFAST_THRESHOLD = 5;
+function isRetryableGscInspectError(err) {
+  if (err != null && typeof err === "object" && "status" in err) {
+    if (err.status === 403) return true;
+  }
+  return isRetryableHttpError(err);
+}
+function defaultSleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function inspectUrlsPaced(urls, cb, deps = {}) {
+  const sleep3 = deps.sleep ?? defaultSleep;
+  const jitter = deps.jitter ?? Math.random;
+  let inspected = 0;
+  let errors = 0;
+  let consecutiveRetryableFailures = 0;
+  for (let index = 0; index < urls.length; index++) {
+    const url = urls[index];
+    try {
+      const result = await withRetry(() => cb.inspectOne(url), {
+        maxRetries: INSPECT_MAX_RETRIES,
+        baseDelayMs: INSPECT_BASE_DELAY_MS,
+        maxDelayMs: INSPECT_MAX_BACKOFF_MS,
+        isRetryable: isRetryableGscInspectError,
+        sleep: sleep3,
+        onRetry: ({ attempt, delayMs, err }) => deps.log?.info("inspect.retry", {
+          url,
+          attempt,
+          delayMs: Math.round(delayMs),
+          error: err instanceof Error ? err.message : String(err)
+        })
+      });
+      cb.onResult(url, result, index);
+      inspected++;
+      consecutiveRetryableFailures = 0;
+    } catch (err) {
+      errors++;
+      cb.onError(url, err, index);
+      if (isRetryableGscInspectError(err)) {
+        consecutiveRetryableFailures++;
+        if (consecutiveRetryableFailures >= INSPECT_FAILFAST_THRESHOLD) {
+          deps.log?.error("inspect.circuit-break", {
+            consecutiveFailures: consecutiveRetryableFailures,
+            inspected,
+            errors,
+            remaining: urls.length - index - 1
+          });
+          return { inspected, errors, aborted: true, abortError: err };
+        }
+      }
+    }
+    if (index < urls.length - 1) {
+      await sleep3(INSPECT_BASE_DELAY_MS + jitter() * INSPECT_PACING_JITTER_MS);
+    }
+  }
+  return { inspected, errors, aborted: false };
+}
+
+// src/gsc-sync.ts
 var log2 = createLogger("GscSync");
 function formatDate(d) {
   return d.toISOString().split("T")[0];
@@ -3570,6 +3653,7 @@ async function executeGscSync(db, runId, projectId, opts) {
     if (!conn.propertyId) {
       throw new Error('No GSC property selected. Use "canonry google properties" to list available sites, then set one with the API.');
     }
+    const propertyId = conn.propertyId;
     let accessToken = conn.accessToken;
     const expiresAt = conn.tokenExpiresAt ? new Date(conn.tokenExpiresAt).getTime() : 0;
     if (Date.now() > expiresAt - 5 * 60 * 1e3) {
@@ -3631,35 +3715,53 @@ async function executeGscSync(db, runId, projectId, opts) {
     }
     const topPages = [...pageClicks.entries()].sort((a, b) => b[1] - a[1]).slice(0, 50).map(([page]) => page);
     log2.info("inspect.start", { runId, projectId, urlCount: topPages.length });
-    for (const pageUrl of topPages) {
-      try {
-        const result = await inspectUrl(accessToken, pageUrl, conn.propertyId);
-        const ir = result.inspectionResult;
-        const idx = ir.indexStatusResult;
-        const mob = ir.mobileUsabilityResult;
-        const rich = ir.richResultsResult;
-        const inspectedAt = (/* @__PURE__ */ new Date()).toISOString();
-        db.insert(gscUrlInspections).values({
-          id: crypto4.randomUUID(),
-          projectId,
-          syncRunId: runId,
-          url: pageUrl,
-          indexingState: idx?.indexingState ?? null,
-          verdict: idx?.verdict ?? null,
-          coverageState: idx?.coverageState ?? null,
-          pageFetchState: idx?.pageFetchState ?? null,
-          robotsTxtState: idx?.robotsTxtState ?? null,
-          crawlTime: idx?.lastCrawlTime ?? null,
-          lastCrawlResult: idx?.crawlResult ?? null,
-          isMobileFriendly: mob?.verdict === "PASS" ? true : mob?.verdict === "FAIL" ? false : null,
-          richResults: rich?.detectedItems?.map((d) => d.richResultType) ?? [],
-          referringUrls: idx?.referringUrls ?? [],
-          inspectedAt,
-          createdAt: inspectedAt
-        }).run();
-      } catch (err) {
-        log2.error("inspect.url-failed", { runId, projectId, url: pageUrl, error: err instanceof Error ? err.message : String(err) });
+    const inspectOutcome = await inspectUrlsPaced(
+      topPages,
+      {
+        inspectOne: (pageUrl) => inspectUrl(accessToken, pageUrl, propertyId),
+        onResult: (pageUrl, result) => {
+          const ir = result.inspectionResult;
+          const idx = ir.indexStatusResult;
+          const mob = ir.mobileUsabilityResult;
+          const rich = ir.richResultsResult;
+          const inspectedAt = (/* @__PURE__ */ new Date()).toISOString();
+          db.insert(gscUrlInspections).values({
+            id: crypto4.randomUUID(),
+            projectId,
+            syncRunId: runId,
+            url: pageUrl,
+            indexingState: idx?.indexingState ?? null,
+            verdict: idx?.verdict ?? null,
+            coverageState: idx?.coverageState ?? null,
+            pageFetchState: idx?.pageFetchState ?? null,
+            robotsTxtState: idx?.robotsTxtState ?? null,
+            crawlTime: idx?.lastCrawlTime ?? null,
+            lastCrawlResult: idx?.crawlResult ?? null,
+            isMobileFriendly: mob?.verdict === "PASS" ? true : mob?.verdict === "FAIL" ? false : null,
+            richResults: rich?.detectedItems?.map((d) => d.richResultType) ?? [],
+            referringUrls: idx?.referringUrls ?? [],
+            inspectedAt,
+            createdAt: inspectedAt
+          }).run();
+        },
+        onError: (pageUrl, err) => {
+          log2.error("inspect.url-failed", { runId, projectId, url: pageUrl, error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+      {
+        log: {
+          info: (action, ctx) => log2.info(action, { runId, projectId, ...ctx }),
+          error: (action, ctx) => log2.error(action, { runId, projectId, ...ctx })
+        }
       }
+    );
+    if (inspectOutcome.aborted) {
+      log2.error("inspect.stopped-early", {
+        runId,
+        projectId,
+        inspected: inspectOutcome.inspected,
+        note: "URL inspection stopped early after sustained rate/access failures; search-analytics data was still saved"
+      });
     }
     const allInspections = db.select().from(gscUrlInspections).where(eq2(gscUrlInspections.projectId, projectId)).all();
     const latestByUrl = /* @__PURE__ */ new Map();
@@ -3706,6 +3808,7 @@ async function executeGscSync(db, runId, projectId, opts) {
 // src/gbp-sync.ts
 import crypto5 from "crypto";
 import { eq as eq3, and as and3, desc, inArray as inArray2, lt } from "drizzle-orm";
+var MS_PER_DAY = 864e5;
 var log3 = createLogger("GbpSync");
 var LOCATION_CONCURRENCY = 4;
 var DEFAULT_DAYS_OF_METRICS = 30;
@@ -3765,6 +3868,7 @@ async function executeGbpSync(db, runId, projectId, opts) {
     const keywordsEnd = monthMinus(0);
     const trendMonths = Array.from({ length: KEYWORD_TREND_MONTHS }, (_, i) => monthMinus(i + 1));
     const keywordRetentionCutoff = monthKey(monthMinus(KEYWORD_HISTORY_RETENTION_MONTHS));
+    const { apiKey: placesApiKey, tier: placesTier, refreshIntervalDays: placesRefreshDays } = getPlacesConfig(opts.config);
     log3.info("sync.start", { runId, projectId, locations: locationRows.length, daysOfMetrics, monthsOfKeywords });
     const errors = /* @__PURE__ */ new Map();
     let okCount = 0;
@@ -3796,6 +3900,25 @@ async function executeGbpSync(db, runId, projectId, opts) {
           const lodgingHash = lodging ? hashLodging(lodging) : null;
           const latestLodging = lodging ? db.select().from(gbpLodgingSnapshots).where(and3(eq3(gbpLodgingSnapshots.projectId, projectId), eq3(gbpLodgingSnapshots.locationName, loc.locationName))).orderBy(desc(gbpLodgingSnapshots.syncedAt)).limit(1).get() : void 0;
           const lodgingChanged = lodging !== null && latestLodging?.contentHash !== lodgingHash;
+          let placeToWrite = null;
+          let placeToTouch = null;
+          if (placesTier !== "off" && placesApiKey && lodging !== null && loc.placeId) {
+            const latestPlace = db.select().from(gbpPlaceDetails).where(and3(eq3(gbpPlaceDetails.projectId, projectId), eq3(gbpPlaceDetails.locationName, loc.locationName))).orderBy(desc(gbpPlaceDetails.syncedAt)).limit(1).get();
+            const ageDays = latestPlace ? (Date.now() - new Date(latestPlace.syncedAt).getTime()) / MS_PER_DAY : Infinity;
+            if (ageDays >= placesRefreshDays) {
+              try {
+                const place = await getPlaceDetails(loc.placeId, placesApiKey, { tier: placesTier });
+                const hash = hashPlaceDetails(place);
+                if (!latestPlace || latestPlace.contentHash !== hash) {
+                  placeToWrite = { contentHash: hash, attributes: place, tier: placesTier, placeId: loc.placeId };
+                } else {
+                  placeToTouch = latestPlace.id;
+                }
+              } catch (placesErr) {
+                log3.warn("places.failed", { runId, location: loc.locationName, error: placesErr instanceof Error ? placesErr.message : String(placesErr) });
+              }
+            }
+          }
           const insertNow = (/* @__PURE__ */ new Date()).toISOString();
           db.transaction((tx) => {
             tx.delete(gbpDailyMetrics).where(and3(eq3(gbpDailyMetrics.projectId, projectId), eq3(gbpDailyMetrics.locationName, loc.locationName))).run();
@@ -3878,6 +4001,21 @@ async function executeGbpSync(db, runId, projectId, opts) {
                 syncRunId: runId
               }).run();
             }
+            if (placeToWrite) {
+              tx.insert(gbpPlaceDetails).values({
+                id: crypto5.randomUUID(),
+                projectId,
+                locationName: loc.locationName,
+                placeId: placeToWrite.placeId,
+                contentHash: placeToWrite.contentHash,
+                tier: placeToWrite.tier,
+                attributes: placeToWrite.attributes,
+                syncedAt: insertNow,
+                syncRunId: runId
+              }).run();
+            } else if (placeToTouch) {
+              tx.update(gbpPlaceDetails).set({ syncedAt: insertNow, syncRunId: runId }).where(eq3(gbpPlaceDetails.id, placeToTouch)).run();
+            }
             tx.update(gbpLocations).set({ syncedAt: insertNow, updatedAt: insertNow }).where(eq3(gbpLocations.id, loc.id)).run();
           });
           okCount++;
@@ -4057,6 +4195,7 @@ async function executeInspectSitemap(db, runId, projectId, opts) {
     if (!conn.propertyId) {
       throw new Error('No GSC property selected. Use "canonry google properties" to list available sites, then set one.');
     }
+    const propertyId = conn.propertyId;
     let accessToken = conn.accessToken;
     const expiresAt = conn.tokenExpiresAt ? new Date(conn.tokenExpiresAt).getTime() : 0;
     if (Date.now() > expiresAt - 5 * 60 * 1e3) {
@@ -4076,43 +4215,52 @@ async function executeInspectSitemap(db, runId, projectId, opts) {
     if (urls.length === 0) {
       throw new Error("No URLs found in sitemap");
     }
-    let inspected = 0;
-    let errors = 0;
-    for (const pageUrl of urls) {
-      try {
-        const result = await inspectUrl(accessToken, pageUrl, conn.propertyId);
-        const ir = result.inspectionResult;
-        const idx = ir.indexStatusResult;
-        const mob = ir.mobileUsabilityResult;
-        const rich = ir.richResultsResult;
-        const inspectedAt = (/* @__PURE__ */ new Date()).toISOString();
-        db.insert(gscUrlInspections).values({
-          id: crypto6.randomUUID(),
-          projectId,
-          syncRunId: runId,
-          url: pageUrl,
-          indexingState: idx?.indexingState ?? null,
-          verdict: idx?.verdict ?? null,
-          coverageState: idx?.coverageState ?? null,
-          pageFetchState: idx?.pageFetchState ?? null,
-          robotsTxtState: idx?.robotsTxtState ?? null,
-          crawlTime: idx?.lastCrawlTime ?? null,
-          lastCrawlResult: idx?.crawlResult ?? null,
-          isMobileFriendly: mob?.verdict === "PASS" ? true : mob?.verdict === "FAIL" ? false : null,
-          richResults: rich?.detectedItems?.map((d) => d.richResultType) ?? [],
-          referringUrls: idx?.referringUrls ?? [],
-          inspectedAt,
-          createdAt: inspectedAt
-        }).run();
-        inspected++;
-        log5.info("inspect.url-done", { runId, projectId, url: pageUrl, progress: `${inspected}/${urls.length}` });
-      } catch (err) {
-        errors++;
-        log5.error("inspect.url-failed", { runId, projectId, url: pageUrl, error: err instanceof Error ? err.message : String(err) });
-      }
-      if (inspected + errors < urls.length) {
-        await new Promise((r) => setTimeout(r, 1e3));
+    const { inspected, errors, aborted, abortError } = await inspectUrlsPaced(
+      urls,
+      {
+        inspectOne: (pageUrl) => inspectUrl(accessToken, pageUrl, propertyId),
+        onResult: (pageUrl, result, index) => {
+          const ir = result.inspectionResult;
+          const idx = ir.indexStatusResult;
+          const mob = ir.mobileUsabilityResult;
+          const rich = ir.richResultsResult;
+          const inspectedAt = (/* @__PURE__ */ new Date()).toISOString();
+          db.insert(gscUrlInspections).values({
+            id: crypto6.randomUUID(),
+            projectId,
+            syncRunId: runId,
+            url: pageUrl,
+            indexingState: idx?.indexingState ?? null,
+            verdict: idx?.verdict ?? null,
+            coverageState: idx?.coverageState ?? null,
+            pageFetchState: idx?.pageFetchState ?? null,
+            robotsTxtState: idx?.robotsTxtState ?? null,
+            crawlTime: idx?.lastCrawlTime ?? null,
+            lastCrawlResult: idx?.crawlResult ?? null,
+            isMobileFriendly: mob?.verdict === "PASS" ? true : mob?.verdict === "FAIL" ? false : null,
+            richResults: rich?.detectedItems?.map((d) => d.richResultType) ?? [],
+            referringUrls: idx?.referringUrls ?? [],
+            inspectedAt,
+            createdAt: inspectedAt
+          }).run();
+          log5.info("inspect.url-done", { runId, projectId, url: pageUrl, progress: `${index + 1}/${urls.length}` });
+        },
+        onError: (pageUrl, err) => {
+          log5.error("inspect.url-failed", { runId, projectId, url: pageUrl, error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+      {
+        log: {
+          info: (action, ctx) => log5.info(action, { runId, projectId, ...ctx }),
+          error: (action, ctx) => log5.error(action, { runId, projectId, ...ctx })
+        }
       }
+    );
+    if (aborted) {
+      const detail = abortError instanceof Error ? abortError.message : String(abortError);
+      throw new Error(
+        `URL inspection aborted after ${INSPECT_FAILFAST_THRESHOLD} consecutive rate/access failures (likely GSC URL Inspection quota exhaustion or property access loss). Last error: ${detail}`
+      );
     }
     const allInspections = db.select().from(gscUrlInspections).where(eq4(gscUrlInspections.projectId, projectId)).all();
     const latestByUrl = /* @__PURE__ */ new Map();
@@ -5468,7 +5616,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-UYVVKQ2K.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-RWVBWSB5.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -9682,6 +9830,7 @@ async function createServer(opts) {
       registerAgentRoutes(scope, { db: opts.db, sessionRegistry });
     },
     getGoogleAuthConfig: () => getGoogleAuthConfig(opts.config),
+    getPlacesConfig: () => getPlacesConfig(opts.config),
     googleConnectionStore,
     googleStateSecret,
     publicUrl: opts.config.publicUrl,

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-X4ZZFZQZ.js";
+} from "./chunk-ZTVBTGDW.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -43,7 +43,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-CKWHFAVB.js";
+} from "./chunk-PITZUUFV.js";
 import {
   apiKeys,
   createClient,
@@ -51,7 +51,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-3G3GAT3E.js";
+} from "./chunk-QZN3J35I.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -67,7 +67,7 @@ import {
   notificationEventSchema,
   providerQuotaPolicySchema,
   resolveProviderInput
-} from "./chunk-DXWUBWBD.js";
+} from "./chunk-URPUUKLC.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -3069,6 +3069,23 @@ async function gbpLodging(project, opts) {
     console.log(`  ${l.locationName}  ${l.populatedGroupCount} attribute group(s)${note}`);
   }
 }
+async function gbpPlaces(project, opts) {
+  const client = getClient6();
+  const response = await client.listGbpPlaces(project, { locationName: opts.location });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  if (response.places.length === 0) {
+    console.log('No Places data \u2014 set a Places API key (places.apiKey / GOOGLE_PLACES_API_KEY) and run "canonry gbp sync" for lodging locations.');
+    return;
+  }
+  console.log(`${response.total} Places listing snapshot(s) \u2014 the amenities Google's public listing advertises:`);
+  for (const p of response.places) {
+    const amenities = p.amenities.length > 0 ? p.amenities.join(", ") : "(none detected)";
+    console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
+  }
+}
 function fmtDelta(pct2) {
   if (pct2 === null) return "n/a";
   return `${pct2 >= 0 ? "+" : ""}${pct2}%`;
@@ -3261,6 +3278,17 @@ var GBP_CLI_COMMANDS = [
       await gbpLodging(project, { location: getString(input.values, "location"), format: input.format });
     }
   },
+  {
+    path: ["gbp", "places"],
+    usage: "canonry gbp places <project> [--location <name>] [--format json]",
+    options: {
+      location: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "gbp.places", "canonry gbp places <project> [--location <name>] [--format json]");
+      await gbpPlaces(project, { location: getString(input.values, "location"), format: input.format });
+    }
+  },
   {
     path: ["gbp", "summary"],
     usage: "canonry gbp summary <project> [--location <name>] [--format json]",

package/dist/index.d.ts

@@ -144,6 +144,21 @@ interface AgentConfigEntry {
     /** Agent mode. Only 'disabled' is valid until the native loop ships. */
     mode?: 'disabled';
 }
+/**
+ * Google Places API config — supplemental rendered-listing data for GBP
+ * lodging locations (#648). The API key authenticates Place Details calls
+ * (`X-Goog-Api-Key`); it is NOT OAuth and is unrelated to `google.clientId`.
+ *   - `tier`: 'atmosphere' (default; amenity booleans for the cross-reference,
+ *     1k free calls/month) | 'pro' (cheaper, accessibility-only) | 'off'.
+ *   - `refreshIntervalDays`: minimum age before a location's Place Details is
+ *     re-fetched during gbp-sync (default 7) — the cost lever, since amenities
+ *     change rarely.
+ */
+interface PlacesConfigEntry {
+    apiKey?: string;
+    tier?: 'atmosphere' | 'pro' | 'off';
+    refreshIntervalDays?: number;
+}
 interface CanonryConfig {
     apiUrl: string;
     publicUrl?: string;
@@ -172,6 +187,7 @@ interface CanonryConfig {
     lastUpdateCheckAt?: string;
     lastKnownLatestVersion?: string;
     agent?: AgentConfigEntry;
+    places?: PlacesConfigEntry;
 }
 declare function loadConfig(): CanonryConfig;
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-X4ZZFZQZ.js";
+} from "./chunk-ZTVBTGDW.js";
 import {
   loadConfig
-} from "./chunk-CKWHFAVB.js";
-import "./chunk-3G3GAT3E.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-PITZUUFV.js";
+import "./chunk-QZN3J35I.js";
+import "./chunk-URPUUKLC.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-UYVVKQ2K.js → intelligence-service-RWVBWSB5.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-3G3GAT3E.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-QZN3J35I.js";
+import "./chunk-URPUUKLC.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,8 +3,8 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-CKWHFAVB.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-PITZUUFV.js";
+import "./chunk-URPUUKLC.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.60.1",
+  "version": "4.61.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,25 +61,26 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",