docs(ui): inventory common platform migration targets

docs/UI_UX_PLATFORM_CORE_MIGRATION_ROADMAP.md

@@ -18,6 +18,25 @@ Live source of truth for migrating `learning_ai_invt_trdg` UI/UX and platform cl
 - Product UI adapter (`web/src/components/ui/Primitives.tsx`, to be added): imports from `@bytelyst/ui`, maps product defaults, status tones, density, radius, focus behavior, and preserves trading-domain composition locally.
 - Product-owned UI: trading workflows, strategy/risk/execution domain composition, charts, order lifecycle views, and product-specific copy/state.
 
+## Common-Platform Inventory
+
+| Product Need | Current Product Usage | Common-Platform Package | Migration Decision |
+|---|---|---|---|
+| Core UI primitives | Local `web/src/components/ui/*`, raw controls, local CSS classes | `@bytelyst/ui` | Add product adapter and migrate local primitives/workflows to common exports. |
+| Design tokens | Product CSS variables and hardcoded literals in `web/src/index.css`, `web/src/App.css`, component styles | `@bytelyst/design-tokens` | Add shared token dependency and global `--bl-*` aliases before component migrations. |
+| Platform API client | `@bytelyst/api-client` in web dependency graph through local/vendor resolution | `@bytelyst/api-client`, `@bytelyst/platform-client` | Keep current API client, evaluate `platform-client` where product uses platform-service workflows directly. |
+| Auth/session | `@bytelyst/react-auth`, backend `@bytelyst/auth` | `@bytelyst/react-auth`, `@bytelyst/auth`, `@bytelyst/auth-client`, `@bytelyst/auth-ui`, `@bytelyst/secure-storage-web` | Keep current auth primitives; evaluate auth UI and secure storage during forms/auth migration. |
+| Telemetry | `@bytelyst/telemetry-client` in shared web/mobile and backend telemetry singleton | `@bytelyst/telemetry-client`, `@bytelyst/backend-telemetry`, `@bytelyst/monitoring` | Keep current telemetry client; evaluate backend package consolidation separately from UI migration. |
+| Diagnostics | Product-local operational status and error surfaces | `@bytelyst/diagnostics-client`, `@bytelyst/errors` | Add diagnostics client when operational panels migrate; keep `@bytelyst/errors` for shared error contracts. |
+| Feature flags | Product-local feature gate utilities and backend config | `@bytelyst/feature-flag-client`, `@bytelyst/backend-flags` | Use common feature flag client for web gates when replacing product-local feature gate plumbing. |
+| Kill switch | `@bytelyst/kill-switch-client` in root/web/mobile dependencies | `@bytelyst/kill-switch-client` | Already consumed; migrate UI status surfaces to common primitives, not new service code. |
+| Blob and extraction | Product-specific research/import surfaces not yet common-backed | `@bytelyst/blob-client`, `@bytelyst/blob`, `@bytelyst/storage`, `@bytelyst/extraction` | Evaluate when file/blob/extraction workflows are touched; no trading-domain move. |
+| Offline and broadcast | Product-local realtime/socket behavior and mobile support | `@bytelyst/offline-queue`, `@bytelyst/broadcast-client`, `@bytelyst/sync`, `@bytelyst/events` | Keep trading WebSocket domain local; use common offline/broadcast only for product-agnostic client concerns. |
+| Billing/subscription | Membership tab/product tier policy | `@bytelyst/billing-client`, `@bytelyst/subscription-client`, `@bytelyst/marketplace-client` | Evaluate during membership/marketplace migration; keep trading tier rules local when domain-specific. |
+| Feedback and survey | No first-class common client usage found | `@bytelyst/feedback-client`, `@bytelyst/survey-client` | Add only when feedback/survey surfaces are introduced or migrated. |
+| Datastore/config | Backend Cosmos repositories and `@bytelyst/config` bootstrap | `@bytelyst/datastore`, `@bytelyst/cosmos`, `@bytelyst/config`, `@bytelyst/backend-config` | Existing `@bytelyst/cosmos`/`config` usage stays; consider `datastore` only for reusable storage helpers. |
+| Operational shells/components | Local AppShell, Sidebar, cards, lists, status surfaces | `@bytelyst/ui`, `@bytelyst/dashboard-shell`, `@bytelyst/dashboard-components` | Prefer `@bytelyst/ui` first; evaluate dashboard packages only if they fit product-agnostic shell/list composition. |
+
 ## Roadmap
 
 | Status | Phase | Scope / Repo | Implementation Summary | Verification Commands | Commit Hash | Notes / Deferrals |