search and ai stabilization work, localization stablized.

docs/modules/platform/platform-service.md

@@ -13,6 +13,7 @@ Provide a single, deterministic aggregation layer for cross-service UX workflows
 - Aggregate quota usage across Authority, Gateway, Orchestrator, and storage backends.
 - Persist onboarding progress and tenant setup milestones.
 - Persist dashboard personalization and layout preferences.
+- Persist authenticated user language preference for shared Web/CLI locale selection.
 - Provide global search aggregation across entities.
 - Provide global context selectors (region/environment/time window) and per-user persistence for Pack 22 top-bar context.
 - Provide Pack 22 release read-model projections for list/detail/activity/approvals queue views.
@@ -43,6 +44,8 @@ Provide a single, deterministic aggregation layer for cross-service UX workflows
 ### Preferences
 - GET `/api/v1/platform/preferences/dashboard`
 - PUT `/api/v1/platform/preferences/dashboard`
+- GET `/api/v1/platform/preferences/language`
+- PUT `/api/v1/platform/preferences/language`
 - GET `/api/v1/platform/dashboard/profiles`
 - GET `/api/v1/platform/dashboard/profiles/{profileId}`
 - POST `/api/v1/platform/dashboard/profiles`
@@ -50,11 +53,24 @@ Provide a single, deterministic aggregation layer for cross-service UX workflows
 ### Global search
 - GET `/api/v1/search` (alias to `/api/v1/platform/search`)
 - GET `/api/v1/platform/search`
+- Legacy notice: both endpoints now emit deprecation metadata (`Deprecation`, `Sunset`, `Link`, `Warning`) and are being replaced by Unified Search `POST /api/v1/search/query`.
 
 ### Metadata
 - GET `/api/v1/platform/metadata`
 - Response includes a capabilities list for UI bootstrapping; analytics capability is reported only when analytics storage is configured.
 
+### Localization
+- GET `/platform/i18n/{locale}.json` (anonymous, cacheable UI translation bundle)
+- GET `/api/v1/platform/localization/bundles/{locale}`
+- GET `/api/v1/platform/localization/bundles/{locale}/{namespace}`
+- GET `/api/v1/platform/localization/locales` (catalog used by Web and CLI locale selectors)
+- PUT `/api/v1/platform/localization/bundles`
+- DELETE `/api/v1/platform/localization/strings/{locale}/{key}`
+- Backend locale resolution contract: `X-Locale` -> `Accept-Language` -> default locale.
+- Runtime bundle layering consumed by backend services: shared embedded `common` -> service embedded bundle -> Platform override bundle.
+- Platform ships locale-complete `ui` and `platform` namespace bundles for `en-US`, `de-DE`, `bg-BG`, `ru-RU`, `es-ES`, `fr-FR`, `uk-UA`, `zh-TW`, `zh-CN`; shared localization library now provides `common` bundles for the same locale set.
+- Bundled locales currently shipped: `en-US`, `de-DE`, `bg-BG`, `ru-RU`, `es-ES`, `fr-FR`, `uk-UA`, `zh-TW`, `zh-CN`.
+
 ## API surface (v2)
 
 ### Global context
@@ -108,11 +124,12 @@ Provide a single, deterministic aggregation layer for cross-service UX workflows
 - Alias usage telemetry is emitted as deterministic event keys (`alias_<method>_<route_pattern>`) with tenant hash metadata only.
 
 ## Data model
-- `platform.dashboard_preferences` (dashboard layout, widgets, filters)
+- `platform.dashboard_preferences` (dashboard layout, widgets, filters, optional user `locale` preference key)
 - `platform.dashboard_profiles` (saved profiles per tenant)
 - `platform.onboarding_state` (step state, timestamps, actor)
 - `platform.quota_alerts` (per-tenant quota alert thresholds)
 - `platform.search_history` (optional, user-scoped, append-only)
+- `platform.translations` (tenant + locale scoped translation override store)
 - `platform.context_regions` (global region selector inventory)
 - `platform.context_environments` (global environment selector inventory with region linkage)
 - `platform.ui_context_preferences` (tenant + actor scoped region/environment/time-window selections)