improvement(platform): give zone and organization views one shared helper layer

Author: waleedlatif1

apps/sim/platform/AGENTS.md

@@ -76,7 +76,7 @@ Gates live on the server and arrive as data. Hiding an entry is navigation, not
 
 `embedded/` holds the organization views and their data (`embedded/app`, `embedded/lib`). It is not a Next app and has no pages: the main app's `app/o/[organizationId]/` routes mount it, for every organization, whatever the `platform-org-ui` flag says. An edit here ships in the main app's build. It is built on the host, not on this project: it imports the host's hooks, stores, providers and packages, legacy chrome included (`WorkspaceChrome`, the legacy composer, Search's source cards), and the data seam and seam closure do not apply to it. `check:boundaries` sets its own seam: views read data through `embedded/lib/data`, and that layer points away from views and routes.
 
-The zone and `embedded/` share only `design-system/`. Neither imports the other, not even for a type (`check:platform-design` rule `zone-embedded`, `check:boundaries` rule 7), so a change to a view here does not change the zone, and a similar view in each is two views. `app/o` is the only legacy code that may import `@/platform/*`, and only those two trees; `check:platform-css` holds every other entry out, and `check:platform-design` holds `app/o` out of the zone.
+The zone and `embedded/` share only `design-system/` and `shared/`, which holds pure helpers and imports neither of them. Neither imports the other, not even for a type (`check:platform-design` rule `zone-embedded`, `check:boundaries` rule 7), so a change to a view here does not change the zone, and a similar view in each is two views. `app/o` is the only legacy code that may import `@/platform/*`, and only those two trees; `check:platform-css` holds every other entry out, and `check:platform-design` holds `app/o` out of the zone.
 
 Org context comes from a different place in each. A view here calls `useOrganization()` from `@/lib/organizations/provider`, which the `app/o` layout fills from `getOrganizationSurfaceContext`. The zone calls its own from `@/platform/lib/data/organization`. `surfaceHref`, `legacyRoutes` and `routePrefix` are the zone's and do not exist here: a link here is a host route (`@/lib/navigation/paths`). Each tree has its own `usePlatformNotices`. `PlatformSurface` collapses inside another, so a part can wrap itself when it alternates with legacy chrome.
 

apps/sim/platform/app/(shell)/_components/chat/message/message-time.tsx

@@ -1,4 +1,4 @@
-import { formatClockTime } from '@/platform/lib/time'
+import { formatClockTime } from '@/platform/shared/time'
 
 interface MessageTimeProps {
   sentAt: number

apps/sim/platform/app/(shell)/_components/chat/panel/panel-content.tsx

@@ -13,7 +13,7 @@ import {
   WorkspaceList,
 } from '@/platform/design-system/components'
 import { useCompactViewport } from '@/platform/design-system/components/layout/use-compact-viewport'
-import { formatRelativeTime } from '@/platform/lib/time'
+import { formatRelativeTime } from '@/platform/shared/time'
 
 interface PanelContentProps {
   view: PanelDestination

apps/sim/platform/app/(shell)/_components/links-page/links-page.tsx

@@ -23,7 +23,7 @@ import {
 import type { MenuAction } from '@/platform/design-system/components/menu/action-menu'
 import type { LoadMoreState } from '@/platform/design-system/components/scroll-area/use-load-more'
 import { type LinkRecord, linkFaviconSrc, openLink, useLinksPage } from '@/platform/lib/data/links'
-import { formatRelativeTime } from '@/platform/lib/time'
+import { formatRelativeTime } from '@/platform/shared/time'
 
 const COLUMNS = [
   { key: 'name', label: 'Name', kind: 'text' },

apps/sim/platform/app/(shell)/_components/organization-menu/organization-menu.tsx

@@ -15,7 +15,7 @@ import {
 } from '@/platform/design-system/components'
 import { IdentityButton } from '@/platform/design-system/components/identity-button/identity-button'
 import { AnchoredPopover } from '@/platform/design-system/components/menu/anchored-popover'
-import { plural } from '@/platform/lib/plural'
+import { plural } from '@/platform/shared/plural'
 
 /** Lazy because its form reads real data, which a fixture session never loads. */
 const InviteModal = dynamic(

apps/sim/platform/app/(shell)/_components/settings-navigation/settings-navigation.tsx

@@ -6,7 +6,7 @@ import type { SettingsNavGroup } from '@/platform/app/(shell)/_components/model'
 import styles from '@/platform/app/(shell)/_components/settings-navigation/settings-navigation.module.css'
 import { Chip, SearchField } from '@/platform/design-system/components'
 import { platformHref } from '@/platform/design-system/navigation'
-import { plural } from '@/platform/lib/plural'
+import { plural } from '@/platform/shared/plural'
 
 interface SettingsNavigationProps {
   section?: string

apps/sim/platform/app/(shell)/home/_components/activity-chart/activity-chart.tsx

@@ -15,7 +15,7 @@ import { ChartTooltip } from '@/platform/design-system/components/chart/chart-to
 import { usePlotInspection } from '@/platform/design-system/components/chart/use-plot-inspection'
 import { RangePicker } from '@/platform/design-system/components/menu/range-picker'
 import { useScrollEdges } from '@/platform/design-system/components/scroll-area/use-scroll-edges'
-import { DAY_MS, formatCalendarDate } from '@/platform/lib/time'
+import { DAY_MS, formatCalendarDate } from '@/platform/shared/time'
 
 interface HomeActivityChartProps {
   title: string

apps/sim/platform/app/(shell)/home/_components/activity-list/activity-list.tsx

@@ -17,7 +17,7 @@ import {
   ScrollArea,
 } from '@/platform/design-system/components'
 import { platformHref } from '@/platform/design-system/navigation'
-import { formatRelativeTime } from '@/platform/lib/time'
+import { formatRelativeTime } from '@/platform/shared/time'
 
 interface EmailListProps {
   items: readonly EmailItem[]

apps/sim/platform/app/(shell)/home/_components/calendar/calendar-day.tsx

@@ -16,7 +16,7 @@ import {
   OverflowText,
 } from '@/platform/design-system/components'
 import { useScrollEdges } from '@/platform/design-system/components/scroll-area/use-scroll-edges'
-import { formatCalendarDate, formatClockTime, formatTimeRange } from '@/platform/lib/time'
+import { formatCalendarDate, formatClockTime, formatTimeRange } from '@/platform/shared/time'
 
 interface CalendarDayProps {
   calendar: HomeCalendarDay

apps/sim/platform/app/(shell)/people/_components/import/import-modal.tsx

@@ -26,7 +26,7 @@ import {
   useProvisioningConnection,
 } from '@/platform/lib/data/people'
 import { toast } from '@/platform/lib/data/toast'
-import { plural } from '@/platform/lib/plural'
+import { plural } from '@/platform/shared/plural'
 
 const ACCEPTED_FILES = '.csv,.tsv,.xlsx,.xls'