feat(i18n): translate CRM list-view & action labels via metadata API

Add a convention-based, framework-level translation pipeline that
localizes view and action metadata at the REST boundary. Developers
keep authoring plain English label/confirmText/successMessage strings;
translations live in the per-locale translation bundle under
`objects.<obj>._views.<view_name>.{label,description}` and
`objects.<obj>._actions.<action_name>.{label,confirmText,successMessage}`,
with object-less actions resolved via top-level `globalActions.<name>`.

Spec changes:
* Extend ObjectTranslationDataSchema with `_views` and `_actions` records.
* Add top-level `globalActions` to TranslationDataSchema.
* New i18n-resolver module with `resolveViewLabel`, `resolveViewDescription`,
  `resolveActionLabel`, `resolveActionConfirm`, `resolveActionSuccess`,
  `translateView`, `translateAction`, `translateMetadataDocument`.
* Resolver fallback chain: requested locale → opts.fallbackChain (default
  ['en']) → literal label/name; never throws.

REST wiring:
* RestServer translates view/action metadata documents on the fly when an
  Accept-Language header (or `?locale=` query, or i18n service default) is
  supplied and the per-project kernel exposes an `i18n` service.
* Adds `Vary: Accept-Language` to translated metadata responses so caches
  key on locale.

CRM translations:
* en/zh-CN/ja-JP/es-ES bundles populated with `_views` for all 11 objects
  (account, contact, lead, opportunity, case, contract, product, quote,
  task, campaign) and `_actions` for the 5 action files
  (contact.mark_primary/send_email, lead.convert_lead/create_campaign,
  case.escalate_case/close_case, opportunity.clone_opportunity/mass_update_stage).
* Top-level globalActions for log_call + export_csv added in all 4 locales.
* ja-JP/es-ES gain stub object entries for the 6 objects that previously
  only had label/pluralLabel translations in en.ts.

Tests:
* spec: 6840/6840 pass (added schema parsing + resolver fallback +
  translateMetadataDocument coverage).
* rest: 53/53 pass.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Copilot

examples/app-crm/src/translations/en.ts

@@ -39,6 +39,13 @@ export const en: TranslationData = {
         is_active: { label: 'Active' },
         last_activity_date: { label: 'Last Activity Date' },
       },
+      _views: {
+        all_accounts: { label: 'All Accounts', description: 'Primary account list with revenue & industry summaries' },
+        account_gallery: { label: 'Account Cards', description: 'Branded account cards with brand-color highlights' },
+        account_map: { label: 'Accounts by Location', description: 'Geospatial distribution of accounts' },
+        enterprise_accounts: { label: 'Enterprise Accounts', description: 'Accounts with the highest annual revenue' },
+        my_accounts: { label: 'My Accounts', description: 'Accounts owned by the current user' },
+      },
     },
 
     contact: {
@@ -66,6 +73,21 @@ export const en: TranslationData = {
         description: { label: 'Description' },
         is_primary: { label: 'Primary Contact' },
       },
+      _views: {
+        all_contacts: { label: 'All Contacts' },
+        contact_directory: { label: 'People Directory' },
+        primary_contacts: { label: 'Primary Contacts' },
+      },
+      _actions: {
+        mark_primary: {
+          label: 'Mark as Primary Contact',
+          confirmText: 'Mark this contact as the primary contact for the account?',
+          successMessage: 'Contact marked as primary!',
+        },
+        send_email: {
+          label: 'Send Email',
+        },
+      },
     },
 
     lead: {
@@ -96,6 +118,25 @@ export const en: TranslationData = {
         is_converted: { label: 'Converted' },
         description: { label: 'Description' },
       },
+      _views: {
+        all_leads: { label: 'All Leads' },
+        kanban_by_status: { label: 'Lead Pipeline' },
+        calendar_by_created: { label: 'Lead Calendar' },
+        gallery_view: { label: 'Lead Cards' },
+        my_leads: { label: 'My Leads' },
+        high_priority: { label: 'High Priority' },
+      },
+      _actions: {
+        convert_lead: {
+          label: 'Convert Lead',
+          confirmText: 'Are you sure you want to convert this lead?',
+          successMessage: 'Lead converted successfully!',
+        },
+        create_campaign: {
+          label: 'Add to Campaign',
+          successMessage: 'Leads added to campaign!',
+        },
+      },
     },
 
     opportunity: {
@@ -137,6 +178,114 @@ export const en: TranslationData = {
         description: { label: 'Description' },
         next_step: { label: 'Next Step' },
       },
+      _views: {
+        all_opportunities: { label: 'All Opportunities' },
+        pipeline_kanban: { label: 'Sales Pipeline' },
+        close_date_calendar: { label: 'Forecast Calendar' },
+        deal_timeline: { label: 'Deal Timeline' },
+        deal_gallery: { label: 'Deal Cards' },
+        my_open_deals: { label: 'My Open Deals' },
+      },
+      _actions: {
+        clone_opportunity: {
+          label: 'Clone Opportunity',
+          successMessage: 'Opportunity cloned successfully!',
+        },
+        mass_update_stage: {
+          label: 'Update Stage',
+          successMessage: 'Opportunities updated successfully!',
+        },
+      },
+    },
+
+    case: {
+      label: 'Case',
+      pluralLabel: 'Cases',
+      _views: {
+        all_cases: { label: 'All Cases' },
+        case_workflow: { label: 'Service Workflow' },
+        sla_calendar: { label: 'SLA Calendar' },
+        case_timeline: { label: 'Case Timeline' },
+        escalated_cases: { label: 'Escalated Cases' },
+      },
+      _actions: {
+        escalate_case: {
+          label: 'Escalate Case',
+          confirmText: 'This will escalate the case to the escalation team. Continue?',
+          successMessage: 'Case escalated successfully!',
+        },
+        close_case: {
+          label: 'Close Case',
+          confirmText: 'Are you sure you want to close this case?',
+          successMessage: 'Case closed successfully!',
+        },
+      },
+    },
+
+    contract: {
+      label: 'Contract',
+      pluralLabel: 'Contracts',
+      _views: {
+        all_contracts: { label: 'All Contracts' },
+        renewal_calendar: { label: 'Renewal Calendar' },
+        contract_gantt: { label: 'Contract Terms' },
+        contract_timeline: { label: 'Contract Timeline' },
+      },
+    },
+
+    product: {
+      label: 'Product',
+      pluralLabel: 'Products',
+      _views: {
+        all_products: { label: 'All Products' },
+        product_catalog: { label: 'Product Catalog' },
+        low_stock: { label: 'Low Stock' },
+      },
+    },
+
+    quote: {
+      label: 'Quote',
+      pluralLabel: 'Quotes',
+      _views: {
+        all_quotes: { label: 'All Quotes' },
+        quote_pipeline: { label: 'Quote Pipeline' },
+        quote_calendar: { label: 'Quote Calendar' },
+      },
+    },
+
+    task: {
+      label: 'Task',
+      pluralLabel: 'Tasks',
+      _views: {
+        all_tasks: { label: 'All Tasks' },
+        task_board: { label: 'Task Board' },
+        task_calendar: { label: 'Task Schedule' },
+        task_gantt: { label: 'Execution Plan' },
+        task_timeline: { label: 'Worklog Timeline' },
+        my_open_tasks: { label: 'My Open Tasks' },
+      },
+    },
+
+    campaign: {
+      label: 'Campaign',
+      pluralLabel: 'Campaigns',
+      _views: {
+        all_campaigns: { label: 'All Campaigns' },
+        campaign_gantt: { label: 'Campaign Schedule' },
+        campaign_calendar: { label: 'Launch Calendar' },
+        campaign_timeline: { label: 'Marketing Timeline' },
+      },
+    },
+  },
+
+  globalActions: {
+    log_call: {
+      label: 'Log a Call',
+      successMessage: 'Call logged successfully!',
+    },
+    export_csv: {
+      label: 'Export to CSV',
+      successMessage: 'Export completed!',
     },
   },
 

examples/app-crm/src/translations/es-ES.ts

@@ -38,6 +38,13 @@ export const esES: TranslationData = {
         is_active: { label: 'Activo' },
         last_activity_date: { label: 'Fecha de Última Actividad' },
       },
+      _views: {
+        all_accounts: { label: 'Todas las Cuentas', description: 'Lista maestra de cuentas con ingresos e industria' },
+        account_gallery: { label: 'Galería de Cuentas', description: 'Vista de tarjetas con colores de marca' },
+        account_map: { label: 'Mapa de Cuentas', description: 'Distribución geográfica de cuentas' },
+        enterprise_accounts: { label: 'Cuentas Empresariales', description: 'Cuentas con mayores ingresos anuales' },
+        my_accounts: { label: 'Mis Cuentas', description: 'Cuentas asignadas al usuario actual' },
+      },
     },
 
     contact: {
@@ -65,6 +72,21 @@ export const esES: TranslationData = {
         description: { label: 'Descripción' },
         is_primary: { label: 'Contacto Principal' },
       },
+      _views: {
+        all_contacts: { label: 'Todos los Contactos' },
+        contact_directory: { label: 'Directorio de Contactos' },
+        primary_contacts: { label: 'Contactos Principales' },
+      },
+      _actions: {
+        mark_primary: {
+          label: 'Marcar como Principal',
+          confirmText: '¿Establecer este contacto como contacto principal de la cuenta?',
+          successMessage: '¡Establecido como contacto principal!',
+        },
+        send_email: {
+          label: 'Enviar Correo',
+        },
+      },
     },
 
     lead: {
@@ -95,6 +117,25 @@ export const esES: TranslationData = {
         is_converted: { label: 'Convertido' },
         description: { label: 'Descripción' },
       },
+      _views: {
+        all_leads: { label: 'Todos los Prospectos' },
+        kanban_by_status: { label: 'Pipeline de Prospectos' },
+        calendar_by_created: { label: 'Calendario de Prospectos' },
+        gallery_view: { label: 'Galería de Prospectos' },
+        my_leads: { label: 'Mis Prospectos' },
+        high_priority: { label: 'Alta Prioridad' },
+      },
+      _actions: {
+        convert_lead: {
+          label: 'Convertir Prospecto',
+          confirmText: '¿Está seguro de querer convertir este prospecto?',
+          successMessage: '¡Prospecto convertido con éxito!',
+        },
+        create_campaign: {
+          label: 'Agregar a Campaña',
+          successMessage: '¡Prospecto agregado a la campaña!',
+        },
+      },
     },
 
     opportunity: {
@@ -136,6 +177,114 @@ export const esES: TranslationData = {
         description: { label: 'Descripción' },
         next_step: { label: 'Próximo Paso' },
       },
+      _views: {
+        all_opportunities: { label: 'Todas las Oportunidades' },
+        pipeline_kanban: { label: 'Pipeline de Ventas' },
+        close_date_calendar: { label: 'Calendario de Pronóstico' },
+        deal_timeline: { label: 'Línea de Tiempo' },
+        deal_gallery: { label: 'Galería de Negocios' },
+        my_open_deals: { label: 'Mis Negocios Abiertos' },
+      },
+      _actions: {
+        clone_opportunity: {
+          label: 'Clonar Oportunidad',
+          successMessage: '¡Oportunidad clonada con éxito!',
+        },
+        mass_update_stage: {
+          label: 'Actualizar Etapa',
+          successMessage: '¡Etapa de oportunidad actualizada!',
+        },
+      },
+    },
+
+    case: {
+      label: 'Caso',
+      pluralLabel: 'Casos',
+      _views: {
+        all_cases: { label: 'Todos los Casos' },
+        case_workflow: { label: 'Flujo de Servicio' },
+        sla_calendar: { label: 'Calendario SLA' },
+        case_timeline: { label: 'Línea de Tiempo de Casos' },
+        escalated_cases: { label: 'Casos Escalados' },
+      },
+      _actions: {
+        escalate_case: {
+          label: 'Escalar Caso',
+          confirmText: 'Esto enviará el caso al equipo de escalación. ¿Continuar?',
+          successMessage: '¡Caso escalado con éxito!',
+        },
+        close_case: {
+          label: 'Cerrar Caso',
+          confirmText: '¿Está seguro de querer cerrar este caso?',
+          successMessage: '¡Caso cerrado con éxito!',
+        },
+      },
+    },
+
+    contract: {
+      label: 'Contrato',
+      pluralLabel: 'Contratos',
+      _views: {
+        all_contracts: { label: 'Todos los Contratos' },
+        renewal_calendar: { label: 'Calendario de Renovación' },
+        contract_gantt: { label: 'Plazos del Contrato' },
+        contract_timeline: { label: 'Línea de Tiempo' },
+      },
+    },
+
+    product: {
+      label: 'Producto',
+      pluralLabel: 'Productos',
+      _views: {
+        all_products: { label: 'Todos los Productos' },
+        product_catalog: { label: 'Catálogo de Productos' },
+        low_stock: { label: 'Stock Bajo' },
+      },
+    },
+
+    quote: {
+      label: 'Cotización',
+      pluralLabel: 'Cotizaciones',
+      _views: {
+        all_quotes: { label: 'Todas las Cotizaciones' },
+        quote_pipeline: { label: 'Pipeline de Cotizaciones' },
+        quote_calendar: { label: 'Calendario de Cotizaciones' },
+      },
+    },
+
+    task: {
+      label: 'Tarea',
+      pluralLabel: 'Tareas',
+      _views: {
+        all_tasks: { label: 'Todas las Tareas' },
+        task_board: { label: 'Tablero de Tareas' },
+        task_calendar: { label: 'Calendario de Tareas' },
+        task_gantt: { label: 'Plan de Ejecución' },
+        task_timeline: { label: 'Línea de Tiempo' },
+        my_open_tasks: { label: 'Mis Tareas Abiertas' },
+      },
+    },
+
+    campaign: {
+      label: 'Campaña',
+      pluralLabel: 'Campañas',
+      _views: {
+        all_campaigns: { label: 'Todas las Campañas' },
+        campaign_gantt: { label: 'Programación de Campañas' },
+        campaign_calendar: { label: 'Calendario de Campañas' },
+        campaign_timeline: { label: 'Línea de Tiempo de Marketing' },
+      },
+    },
+  },
+
+  globalActions: {
+    log_call: {
+      label: 'Registrar Llamada',
+      successMessage: '¡Llamada registrada con éxito!',
+    },
+    export_csv: {
+      label: 'Exportar CSV',
+      successMessage: '¡Exportación completada!',
     },
   },