@open-mercato/core 0.6.8-develop.6891.1.4dca3f1ad3 → 0.6.8-develop.6893.1.7af3b3a72d

package/src/modules/communication_channels/backend/profile/communication-channels/page.tsx

@@ -42,6 +42,13 @@ type ChannelRow = {
   /** Spec C — push delivery state (null when provider doesn't support push). */
   pushStatus: 'active' | 'inactive' | 'failed' | null
   lastPushError: { code: string | null; message: string | null; at: string | null } | null
+  /**
+   * `true` when the adapter declares real-time push, so the hub's poll worker
+   * skips this channel entirely — inbound arrives over the provider connection.
+   */
+  supportsRealtimePush: boolean
+  /** `true` when the adapter implements `registerPush` (Gmail-style subscriptions). */
+  supportsPushRegistration: boolean
   createdAt: string | null
 }
 
@@ -314,17 +321,38 @@ export default function ProfileCommunicationChannelsPage() {
       },
       {
         id: 'pushStatus',
-        header: t('communication_channels.push.status.active', 'Push'),
+        // Its own key: sharing `push.status.active` made the header render
+        // "Push active" over a column whose rows say "Polling only" (#4980).
+        header: t('communication_channels.profile.columns.push', 'Push'),
         cell: ({ row }) => {
-          const supportsPush = row.original.providerKey === 'gmail'
-          if (!supportsPush) {
+          const ps = row.original.pushStatus
+          const errorTitle = row.original.lastPushError?.message ?? undefined
+          // Derived from the adapter's declared capabilities, never from the
+          // provider name: `supportsPushRegistration` means push subscriptions
+          // can be (re-)registered from here, `supportsRealtimePush` means the
+          // hub's poll worker skips the channel because the provider connection
+          // delivers inbound itself (#4980).
+          if (!row.original.supportsPushRegistration) {
+            if (!row.original.supportsRealtimePush) {
+              return (
+                <span className="text-xs text-muted-foreground">
+                  {t('communication_channels.push.status.inactive', 'Polling only')}
+                </span>
+              )
+            }
+            if (ps === 'failed') {
+              return (
+                <Tag variant="error" dot title={errorTitle}>
+                  {t('communication_channels.push.status.pushDrivenFailed', 'Push connection failed')}
+                </Tag>
+              )
+            }
             return (
-              <span className="text-xs text-muted-foreground">
-                {t('communication_channels.push.status.inactive', 'Polling only')}
-              </span>
+              <Tag variant="success" dot>
+                {t('communication_channels.push.status.pushDriven', 'Push-driven')}
+              </Tag>
             )
           }
-          const ps = row.original.pushStatus
           if (ps === 'active') {
             return (
               <Tag variant="success" dot>
@@ -333,7 +361,6 @@ export default function ProfileCommunicationChannelsPage() {
             )
           }
           if (ps === 'failed') {
-            const errorMsg = row.original.lastPushError?.message ?? null
             return (
               <div className="flex items-center gap-2">
                 <Tag variant="error" dot>
@@ -345,18 +372,23 @@ export default function ProfileCommunicationChannelsPage() {
                   size="sm"
                   onClick={() => void onRegisterPush(row.original.id)}
                   aria-label={t('communication_channels.push.button.reregister', 'Re-register push')}
-                  title={errorMsg ?? undefined}
+                  title={errorTitle}
                 >
                   {t('communication_channels.push.button.reregister', 'Re-register push')}
                 </Button>
               </div>
             )
           }
-          // null or 'inactive' — provider supports push but not registered yet.
+          // null or 'inactive' — the provider can register push but has not yet.
+          // Only a hub-polled channel falls back to polling meanwhile; for a
+          // push-driven one nothing is delivering inbound at all, so claiming
+          // "Polling only" would repeat the defect this issue is about (#4980).
           return (
             <div className="flex items-center gap-2">
               <span className="text-xs text-muted-foreground">
-                {t('communication_channels.push.status.inactive', 'Polling only')}
+                {row.original.supportsRealtimePush
+                  ? t('communication_channels.push.status.notRegistered', 'Push not registered')
+                  : t('communication_channels.push.status.inactive', 'Polling only')}
               </span>
               <Button
                 type="button"
@@ -409,25 +441,38 @@ export default function ProfileCommunicationChannelsPage() {
           // Allowed from 'connected' AND 'error' — the latter lets the user
           // recover a stuck channel without disconnecting + reconnecting.
           // 'requires_reauth' and 'disconnected' are owned by other flows.
+          // A push-driven channel is never polled by the worker, so offering the
+          // action at all would promise a sync that cannot happen (#4980).
+          const pushDriven = row.original.supportsRealtimePush
           const pollable =
             row.original.isActive &&
+            !pushDriven &&
             (row.original.status === 'connected' || row.original.status === 'error')
           const label =
             row.original.status === 'error'
               ? t('communication_channels.profile.actions.retryPoll', 'Retry')
               : t('communication_channels.profile.actions.pollNow', 'Poll now')
-          return (
+          const disabledReason = pushDriven
+            ? t(
+                'communication_channels.profile.actions.pollNowPushDriven',
+                'This channel is push-driven — inbound messages arrive over the provider connection, so polling does not apply.',
+              )
+            : undefined
+          const button = (
             <Button
               type="button"
               variant={row.original.status === 'error' ? 'default' : 'outline'}
               size="sm"
               onClick={() => void onPollNow(row.original.id)}
               disabled={!pollable}
-              aria-label={label}
+              aria-label={disabledReason ? `${label} — ${disabledReason}` : label}
             >
               {label}
             </Button>
           )
+          // A disabled button does not receive hover events in every browser, so
+          // the explanation lives on a wrapper the pointer can still reach.
+          return disabledReason ? <span title={disabledReason}>{button}</span> : button
         },
       },
       {

package/src/modules/communication_channels/i18n/de.json

@@ -23,6 +23,7 @@
   "communication_channels.emptyState": "Noch keine gemeinsamen Kanäle. Diese Seite listet gemeinsame, mandantenweite Kanäle auf. Ihr persönliches E-Mail-Postfach ist privat – verbinden und verwalten Sie es unter Profil → Kommunikationskanäle.",
   "communication_channels.errors.loadDetail": "Kanal konnte nicht geladen werden",
   "communication_channels.errors.loadList": "Kanäle konnten nicht geladen werden",
+  "communication_channels.errors.pollNowPushDriven": "Der Kanal ist Push-gesteuert — Abrufen ist nicht anwendbar. Eingehende Nachrichten kommen über die Push-Verbindung des Anbieters.",
   "communication_channels.errors.reactionFailed": "Reaktion fehlgeschlagen",
   "communication_channels.errors.undoBlockedPrimaryConflict": "Ein anderer Kanal ist jetzt für diesen Benutzer als primär festgelegt. Setze ihn auf nicht-primär, bevor du den getrennten Kanal wieder als primär festlegst.",
   "communication_channels.infoPanel.aria": "Kanalinfo",
@@ -53,6 +54,7 @@
   "communication_channels.profile.actions.importHistory": "Verlauf importieren",
   "communication_channels.profile.actions.pollNow": "Jetzt abrufen",
   "communication_channels.profile.actions.pollNowFailed": "Abruf konnte nicht ausgelöst werden",
+  "communication_channels.profile.actions.pollNowPushDriven": "Dieser Kanal ist Push-gesteuert — eingehende Nachrichten kommen über die Anbieterverbindung, Abrufen ist daher nicht anwendbar.",
   "communication_channels.profile.actions.pollNowSuccess": "Abruf ausgelöst — neue Nachrichten erscheinen in wenigen Sekunden auf den verknüpften Personen-Zeitleisten.",
   "communication_channels.profile.actions.retryPoll": "Wiederholen",
   "communication_channels.profile.actions.setPrimary": "Als primär festlegen",
@@ -64,6 +66,7 @@
   "communication_channels.profile.columns.lastPolled": "Zuletzt synchronisiert",
   "communication_channels.profile.columns.pollNow": "Synchronisieren",
   "communication_channels.profile.columns.primary": "Primär",
+  "communication_channels.profile.columns.push": "Push",
   "communication_channels.profile.connect.blocked": "Verbindung durch Validierung blockiert",
   "communication_channels.profile.connect.cancel": "Abbrechen",
   "communication_channels.profile.connect.connected": "Kanal verbunden.",
@@ -126,6 +129,9 @@
   "communication_channels.push.status.active": "Push aktiv",
   "communication_channels.push.status.failed": "Push fehlgeschlagen — nutze Polling",
   "communication_channels.push.status.inactive": "Nur Polling",
+  "communication_channels.push.status.notRegistered": "Push nicht registriert",
+  "communication_channels.push.status.pushDriven": "Push-gesteuert",
+  "communication_channels.push.status.pushDrivenFailed": "Push-Verbindung fehlgeschlagen",
   "communication_channels.reaction.bar.aria": "Reaktionen",
   "communication_channels.reaction.cannotRemoveExternal": "Reaktionen externer Teilnehmer können nur in der Anbieter-App entfernt werden.",
   "communication_channels.reaction.toggleAria": "Reaktion {emoji} umschalten",

package/src/modules/communication_channels/i18n/en.json

@@ -23,6 +23,7 @@
   "communication_channels.emptyState": "No shared channels yet. This page lists shared, tenant-wide channels. Your personal email mailbox is private — connect and manage it under Profile → Communication Channels.",
   "communication_channels.errors.loadDetail": "Failed to load channel",
   "communication_channels.errors.loadList": "Failed to load channels",
+  "communication_channels.errors.pollNowPushDriven": "Channel is push-driven — polling does not apply. Inbound messages arrive through the provider push connection.",
   "communication_channels.errors.reactionFailed": "Reaction failed",
   "communication_channels.errors.undoBlockedPrimaryConflict": "Another channel is now primary for this user. Set it as non-primary before restoring the disconnected channel as primary.",
   "communication_channels.infoPanel.aria": "Channel info",
@@ -53,6 +54,7 @@
   "communication_channels.profile.actions.importHistory": "Import history",
   "communication_channels.profile.actions.pollNow": "Poll now",
   "communication_channels.profile.actions.pollNowFailed": "Failed to trigger poll",
+  "communication_channels.profile.actions.pollNowPushDriven": "This channel is push-driven — inbound messages arrive over the provider connection, so polling does not apply.",
   "communication_channels.profile.actions.pollNowSuccess": "Poll triggered — new messages will appear on linked Person timelines in a few seconds.",
   "communication_channels.profile.actions.retryPoll": "Retry",
   "communication_channels.profile.actions.setPrimary": "Set as primary",
@@ -64,6 +66,7 @@
   "communication_channels.profile.columns.lastPolled": "Last synced",
   "communication_channels.profile.columns.pollNow": "Sync",
   "communication_channels.profile.columns.primary": "Primary",
+  "communication_channels.profile.columns.push": "Push",
   "communication_channels.profile.connect.blocked": "Connection blocked by validation",
   "communication_channels.profile.connect.cancel": "Cancel",
   "communication_channels.profile.connect.connected": "Channel connected.",
@@ -126,6 +129,9 @@
   "communication_channels.push.status.active": "Push active",
   "communication_channels.push.status.failed": "Push failed — using polling",
   "communication_channels.push.status.inactive": "Polling only",
+  "communication_channels.push.status.notRegistered": "Push not registered",
+  "communication_channels.push.status.pushDriven": "Push-driven",
+  "communication_channels.push.status.pushDrivenFailed": "Push connection failed",
   "communication_channels.reaction.bar.aria": "Reactions",
   "communication_channels.reaction.cannotRemoveExternal": "Reactions from external participants can only be removed in the provider app.",
   "communication_channels.reaction.toggleAria": "Toggle {emoji} reaction",

package/src/modules/communication_channels/i18n/es.json

@@ -23,6 +23,7 @@
   "communication_channels.emptyState": "Aún no hay canales compartidos. Esta página muestra los canales compartidos de toda la organización. Tu buzón de correo personal es privado: conéctalo y gestiónalo en Perfil → Canales de comunicación.",
   "communication_channels.errors.loadDetail": "No se pudo cargar el canal",
   "communication_channels.errors.loadList": "No se pudieron cargar los canales",
+  "communication_channels.errors.pollNowPushDriven": "El canal funciona con push — el sondeo no aplica. Los mensajes entrantes llegan por la conexión push del proveedor.",
   "communication_channels.errors.reactionFailed": "La reacción falló",
   "communication_channels.errors.undoBlockedPrimaryConflict": "Otro canal es ahora el principal para este usuario. Configúralo como no principal antes de restaurar el canal desconectado como principal.",
   "communication_channels.infoPanel.aria": "Información del canal",
@@ -53,6 +54,7 @@
   "communication_channels.profile.actions.importHistory": "Importar historial",
   "communication_channels.profile.actions.pollNow": "Sondear ahora",
   "communication_channels.profile.actions.pollNowFailed": "No se pudo iniciar el sondeo",
+  "communication_channels.profile.actions.pollNowPushDriven": "Este canal funciona con push — los mensajes entrantes llegan por la conexión del proveedor, por lo que el sondeo no aplica.",
   "communication_channels.profile.actions.pollNowSuccess": "Sondeo iniciado — los nuevos mensajes aparecerán en las líneas de tiempo de las personas vinculadas en unos segundos.",
   "communication_channels.profile.actions.retryPoll": "Reintentar",
   "communication_channels.profile.actions.setPrimary": "Establecer como principal",
@@ -64,6 +66,7 @@
   "communication_channels.profile.columns.lastPolled": "Última sincronización",
   "communication_channels.profile.columns.pollNow": "Sincronizar",
   "communication_channels.profile.columns.primary": "Principal",
+  "communication_channels.profile.columns.push": "Push",
   "communication_channels.profile.connect.blocked": "Conexión bloqueada por la validación",
   "communication_channels.profile.connect.cancel": "Cancelar",
   "communication_channels.profile.connect.connected": "Canal conectado.",
@@ -126,6 +129,9 @@
   "communication_channels.push.status.active": "Push activo",
   "communication_channels.push.status.failed": "Push fallido — usando sondeo",
   "communication_channels.push.status.inactive": "Solo sondeo",
+  "communication_channels.push.status.notRegistered": "Push no registrado",
+  "communication_channels.push.status.pushDriven": "Basado en push",
+  "communication_channels.push.status.pushDrivenFailed": "Error en la conexión push",
   "communication_channels.reaction.bar.aria": "Reacciones",
   "communication_channels.reaction.cannotRemoveExternal": "Las reacciones de participantes externos solo se pueden eliminar en la aplicación del proveedor.",
   "communication_channels.reaction.toggleAria": "Alternar reacción {emoji}",

package/src/modules/communication_channels/i18n/ko.json

@@ -23,6 +23,7 @@
   "communication_channels.emptyState": "아직 공유 채널이 없습니다. 이 페이지에는 공유되는 테넌트 전체 채널이 나열됩니다. 개인 이메일 메일함은 비공개이며, 프로필 → 통신 채널에서 연결하고 관리하세요.",
   "communication_channels.errors.loadDetail": "채널을 불러오지 못했습니다",
   "communication_channels.errors.loadList": "채널을 불러오지 못했습니다",
+  "communication_channels.errors.pollNowPushDriven": "이 채널은 푸시 기반입니다 — 폴링은 적용되지 않습니다. 수신 메시지는 공급자의 푸시 연결로 전달됩니다.",
   "communication_channels.errors.reactionFailed": "반응 처리에 실패했습니다",
   "communication_channels.errors.undoBlockedPrimaryConflict": "다른 채널이 현재 이 사용자의 기본 채널로 설정되어 있습니다. 연결이 끊어진 채널을 기본으로 복원하기 전에 해당 채널을 기본이 아닌 채널로 설정하세요.",
   "communication_channels.infoPanel.aria": "채널 정보",
@@ -53,6 +54,7 @@
   "communication_channels.profile.actions.importHistory": "기록 가져오기",
   "communication_channels.profile.actions.pollNow": "지금 폴링",
   "communication_channels.profile.actions.pollNowFailed": "폴링 실행에 실패했습니다",
+  "communication_channels.profile.actions.pollNowPushDriven": "이 채널은 푸시 기반입니다 — 수신 메시지가 공급자 연결로 전달되므로 폴링은 적용되지 않습니다.",
   "communication_channels.profile.actions.pollNowSuccess": "폴링이 실행되었습니다 — 몇 초 후 연결된 사람 타임라인에 새 메시지가 표시됩니다.",
   "communication_channels.profile.actions.retryPoll": "재시도",
   "communication_channels.profile.actions.setPrimary": "기본으로 설정",
@@ -64,6 +66,7 @@
   "communication_channels.profile.columns.lastPolled": "마지막 동기화",
   "communication_channels.profile.columns.pollNow": "동기화",
   "communication_channels.profile.columns.primary": "기본",
+  "communication_channels.profile.columns.push": "푸시",
   "communication_channels.profile.connect.blocked": "유효성 검사로 인해 연결이 차단되었습니다",
   "communication_channels.profile.connect.cancel": "취소",
   "communication_channels.profile.connect.connected": "채널이 연결되었습니다.",
@@ -126,6 +129,9 @@
   "communication_channels.push.status.active": "푸시 활성",
   "communication_channels.push.status.failed": "푸시 실패 — 폴링 사용 중",
   "communication_channels.push.status.inactive": "폴링만 사용",
+  "communication_channels.push.status.notRegistered": "푸시 미등록",
+  "communication_channels.push.status.pushDriven": "푸시 기반",
+  "communication_channels.push.status.pushDrivenFailed": "푸시 연결 실패",
   "communication_channels.reaction.bar.aria": "반응",
   "communication_channels.reaction.cannotRemoveExternal": "외부 참여자의 반응은 제공업체 앱에서만 제거할 수 있습니다.",
   "communication_channels.reaction.toggleAria": "{emoji} 반응 전환",

package/src/modules/communication_channels/i18n/pl.json

@@ -23,6 +23,7 @@
   "communication_channels.emptyState": "Brak kanałów współdzielonych. Ta strona pokazuje współdzielone kanały obejmujące całą organizację. Twoja osobista skrzynka e-mail jest prywatna — połącz ją i zarządzaj nią w Profil → Kanały komunikacji.",
   "communication_channels.errors.loadDetail": "Nie udało się załadować kanału",
   "communication_channels.errors.loadList": "Nie udało się załadować kanałów",
+  "communication_channels.errors.pollNowPushDriven": "Kanał działa w trybie push — odpytywanie go nie dotyczy. Wiadomości przychodzące docierają połączeniem push dostawcy.",
   "communication_channels.errors.reactionFailed": "Reakcja nie powiodła się",
   "communication_channels.errors.undoBlockedPrimaryConflict": "Inny kanał jest teraz głównym dla tego użytkownika. Ustaw go jako niegłówny, zanim przywrócisz rozłączony kanał jako główny.",
   "communication_channels.infoPanel.aria": "Informacje o kanale",
@@ -53,6 +54,7 @@
   "communication_channels.profile.actions.importHistory": "Importuj historię",
   "communication_channels.profile.actions.pollNow": "Pobierz teraz",
   "communication_channels.profile.actions.pollNowFailed": "Nie udało się uruchomić pobierania",
+  "communication_channels.profile.actions.pollNowPushDriven": "Ten kanał działa w trybie push — wiadomości przychodzące docierają połączeniem dostawcy, więc odpytywanie go nie dotyczy.",
   "communication_channels.profile.actions.pollNowSuccess": "Pobieranie uruchomione — nowe wiadomości pojawią się na osiach czasu osób w ciągu kilku sekund.",
   "communication_channels.profile.actions.retryPoll": "Ponów",
   "communication_channels.profile.actions.setPrimary": "Ustaw jako główny",
@@ -64,6 +66,7 @@
   "communication_channels.profile.columns.lastPolled": "Ostatnia synchronizacja",
   "communication_channels.profile.columns.pollNow": "Synchronizacja",
   "communication_channels.profile.columns.primary": "Główny",
+  "communication_channels.profile.columns.push": "Push",
   "communication_channels.profile.connect.blocked": "Połączenie zablokowane przez walidację",
   "communication_channels.profile.connect.cancel": "Anuluj",
   "communication_channels.profile.connect.connected": "Kanał połączony.",
@@ -126,6 +129,9 @@
   "communication_channels.push.status.active": "Push aktywny",
   "communication_channels.push.status.failed": "Push nieudany — używam odpytywania",
   "communication_channels.push.status.inactive": "Tylko odpytywanie",
+  "communication_channels.push.status.notRegistered": "Push niezarejestrowany",
+  "communication_channels.push.status.pushDriven": "Sterowany push",
+  "communication_channels.push.status.pushDrivenFailed": "Połączenie push nie działa",
   "communication_channels.reaction.bar.aria": "Reakcje",
   "communication_channels.reaction.cannotRemoveExternal": "Reakcje uczestników zewnętrznych można usunąć tylko w aplikacji dostawcy.",
   "communication_channels.reaction.toggleAria": "Przełącz reakcję {emoji}",

package/src/modules/communication_channels/lib/polling-eligibility.ts

@@ -0,0 +1,14 @@
+/**
+ * Single source of truth for "does the hub poll this channel?".
+ *
+ * `ChannelCapabilities.realtimePush` is optional and defaults to `true` for
+ * back-compat (chat providers predating the flag omit it), so only an explicit
+ * `false` opts a channel into hub-managed polling. The poll worker, the manual
+ * `poll-now` route and the profile grid all derive their behaviour from this
+ * predicate, so the UI can never label a channel the opposite of what the worker
+ * actually does (#4980).
+ */
+export function isHubPolledChannel(capabilities: unknown): boolean {
+  if (!capabilities || typeof capabilities !== 'object' || Array.isArray(capabilities)) return false
+  return (capabilities as { realtimePush?: unknown }).realtimePush === false
+}

package/src/modules/communication_channels/workers/poll-channel.ts

@@ -9,6 +9,7 @@ import {
 } from '../commands/ingest-inbound-message'
 import { COMMUNICATION_CHANNELS_QUEUES, getCommunicationChannelsQueue } from '../lib/queue'
 import { preservePushState } from '../lib/push-state'
+import { isHubPolledChannel } from '../lib/polling-eligibility'
 import { writeIngestDeadLetter } from '../lib/dead-letter'
 import { classifyOutboundError, computeBackoffMs, isReauthError } from '../lib/error-classification'
 import { refreshCredentialsIfNeeded } from '../lib/credential-refresh'
@@ -123,9 +124,8 @@ export default async function handle(
     logger.warn('no adapter for provider', { providerKey: channel.providerKey, channelId })
     return
   }
-  // Adapter opted out of polling — webhook providers.
-  const capabilities = (channel.capabilities as { realtimePush?: boolean } | null) ?? null
-  if (capabilities?.realtimePush !== false) {
+  // Adapter opted out of polling — webhook and gateway providers.
+  if (!isHubPolledChannel(channel.capabilities)) {
     // realtimePush is `true` (default for back-compat) — don't poll push providers.
     return
   }

package/src/modules/configs/cli.ts

@@ -158,12 +158,12 @@ function printCacheHelp() {
   console.log('  yarn mercato configs cache purge --key <key1,key2> [--tenant <id> | --global | --all-tenants] [--dry-run] [--json]')
   console.log('  yarn mercato configs cache purge --id <token1,token2> [--tenant <id> | --global | --all-tenants] [--dry-run] [--json]')
   console.log('  yarn mercato configs cache purge --pattern <glob> [--tenant <id> | --global | --all-tenants] [--dry-run] [--json]')
-  console.log('  yarn mercato configs cache structural [--tenant <id> | --global | --all-tenants] [--dry-run] [--json]')
+  console.log('  yarn mercato configs cache structural [--tenant <id> | --global | --all-tenants] [--touch-generated] [--dry-run] [--json]')
   console.log('')
   console.log('ℹ️ Notes:')
   console.log('  `stats` mirrors the cache admin page segment overview for CRUD/widget caches.')
   console.log('  `purge --id` removes every key whose name contains the provided token (for example a user id or entity id).')
-  console.log('  `structural` targets navigation/sidebar caches and is the recommended post-step after module/sidebar structure changes.')
+  console.log('  `structural` targets navigation/sidebar caches. Add `--touch-generated` only for explicit stale-compiler recovery.')
   console.log('  When no scope flag is supplied, this command uses the global cache scope only.')
 }
 
@@ -278,14 +278,16 @@ async function runStructuralCachePurge(args: ParsedArgs) {
   if (json) {
     console.log(JSON.stringify(structuralResults, null, 2))
   }
-  const quiet = flagEnabled(args, 'quiet')
-  try {
-    touchGeneratedBarrels({ quiet: quiet || json })
-  } catch (err) {
-    if (!quiet && !json) {
-      console.warn(
-        `[structural] failed to touch generated barrels: ${(err as Error).message ?? err}`,
-      )
+  if (flagEnabled(args, 'touch-generated', 'touchGenerated')) {
+    const quiet = flagEnabled(args, 'quiet')
+    try {
+      touchGeneratedBarrels({ quiet: quiet || json })
+    } catch (err) {
+      if (!quiet && !json) {
+        console.warn(
+          `[structural] failed to touch generated barrels: ${(err as Error).message ?? err}`,
+        )
+      }
     }
   }
 }

package/src/modules/configs/lib/touchGeneratedBarrels.ts

@@ -43,13 +43,16 @@ export function touchGeneratedBarrels(
   }
 
   const touched: string[] = []
+  const touchedAt = new Date()
   const entries = fs.readdirSync(generatedDir, { withFileTypes: true })
   for (const entry of entries) {
     if (!entry.isFile()) continue
     if (!TOUCHABLE_PATTERN.test(entry.name)) continue
     const filePath = path.join(generatedDir, entry.name)
-    const contents = fs.readFileSync(filePath)
-    fs.writeFileSync(filePath, contents)
+    // Advance mtime without rewriting the bytes: rewriting truncates then refills
+    // multi-megabyte registries, and a concurrent Turbopack compile reading one
+    // mid-write sees a partial file. Matches `packages/cli/src/lib/post-generate-invalidation.ts`.
+    fs.utimesSync(filePath, touchedAt, touchedAt)
     touched.push(filePath)
   }
 

package/src/modules/customers/message-objects.ts

@@ -1,5 +1,5 @@
 import type { MessageObjectTypeDefinition } from '@open-mercato/shared/modules/messages/types'
-import { MessageObjectDetail, MessageObjectPreview } from '@open-mercato/ui'
+import { MessageObjectDetail, MessageObjectPreview } from '@open-mercato/ui/backend/messages'
 
 const objectMessageTypes = ['default', 'messages.defaultWithObjects']