@elevasis/ui 2.31.0 → 2.33.0

package/dist/utils/index.d.ts

@@ -80,12 +80,106 @@ declare function debounce<T extends (...args: Parameters<T>) => void>(fn: T, wai
 };
 
 declare const ResourceGovernanceStatusSchema: z.ZodEnum<{
-    active: "active";
     deprecated: "deprecated";
+    active: "active";
     archived: "archived";
 }>;
 type ResourceGovernanceStatus = z.infer<typeof ResourceGovernanceStatusSchema>;
 
+declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
+    objectTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        from: z.ZodString;
+        to: z.ZodString;
+        cardinality: z.ZodOptional<z.ZodString>;
+        via: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$loose>>>>;
+    catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodString>;
+        appliesTo: z.ZodOptional<z.ZodString>;
+        entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        primitive: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        valueType: z.ZodOptional<z.ZodString>;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        pii: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>>>;
+    groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    }, z.core.$loose>>>>;
+    surfaces: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        route: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+}, z.core.$strip>>;
+type OntologyScope = z.infer<typeof OntologyScopeSchema>;
+
 /**
  * Time range selector for dashboard metrics
  */
@@ -108,26 +202,72 @@ declare const ResourceStatusColors: {
     readonly prod: "var(--color-success)";
 };
 
-declare const SystemEntrySchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    description: z.ZodString;
-    kind: z.ZodEnum<{
-        platform: "platform";
-        product: "product";
-        operational: "operational";
-        diagnostic: "diagnostic";
-    }>;
-    responsibleRoleId: z.ZodOptional<z.ZodString>;
-    governedByKnowledge: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    drivesGoals: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodEnum<{
-        active: "active";
-        deprecated: "deprecated";
-        archived: "archived";
-    }>;
+/**
+ * Placeholder discriminated union for ContentNode (Wave 1A).
+ * Wave 2A wires concrete (kind, type) pairs via the registry.
+ *
+ * Per D2: unregistered (kind, type) pairs are allowed and pass through validation.
+ * Per L14: every node carries BOTH `kind` and `type`.
+ */
+declare const ContentNodeSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    parentContentId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodString;
+    type: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-type SystemEntry = z.infer<typeof SystemEntrySchema>;
+type ContentNode = z.infer<typeof ContentNodeSchema>;
+
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Explicit interface needed to annotate the recursive SystemEntrySchema. */
+interface SystemEntry {
+    id: string;
+    label?: string;
+    title?: string;
+    description?: string;
+    kind?: 'product' | 'operational' | 'platform' | 'diagnostic';
+    parentSystemId?: string;
+    ui?: {
+        path: string;
+        surfaces: string[];
+        icon?: string;
+        order?: number;
+    };
+    lifecycle?: 'draft' | 'beta' | 'active' | 'deprecated' | 'archived';
+    responsibleRoleId?: string;
+    governedByKnowledge?: string[];
+    actions?: {
+        actionId: string;
+        intent: 'exposes' | 'consumes';
+        invocation?: unknown;
+    }[];
+    policies?: string[];
+    drivesGoals?: string[];
+    /** @deprecated Use lifecycle. Accepted for one publish cycle. */
+    status?: 'active' | 'deprecated' | 'archived';
+    path?: string;
+    icon?: string;
+    color?: string;
+    uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
+    enabled?: boolean;
+    devOnly?: boolean;
+    requiresAdmin?: boolean;
+    order: number;
+    config?: Record<string, JsonValue>;
+    ontology?: OntologyScope;
+    systems?: Record<string, SystemEntry>;
+    /**
+     * @deprecated Compatibility-only bridge for old tenant data and migration readers.
+     * Author new semantic catalogs in `ontology` and local settings in `config`.
+     */
+    content?: Record<string, ContentNode>;
+    subsystems?: Record<string, SystemEntry>;
+}
 
 /**
  * Resource Registry type definitions
@@ -142,7 +282,7 @@ type ResourceStatus = 'dev' | 'prod';
  * Used as the discriminator field in ResourceDefinition
  */
 type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human';
-type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'status'>;
+type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'lifecycle'>;
 /**
  * Base interface for ALL platform resources
  * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
@@ -168,8 +308,8 @@ interface ResourceDefinition {
     sessionCapable?: boolean;
     /** Whether the resource is local (monorepo) or remote (externally deployed) */
     origin?: 'local' | 'remote';
-    /** OM System membership, when backed by a Resource descriptor */
-    systemId?: string;
+    /** OM System membership — dot-separated system path (e.g. "sys.lead-gen"), when backed by a Resource descriptor */
+    systemPath?: string;
     /** Display metadata for the owning OM System */
     system?: ResourceSystemSummary;
     /** Governance lifecycle status from the OM Resource descriptor */
@@ -181,13 +321,22 @@ interface ResourceDefinition {
 declare const LinkSchema: z.ZodObject<{
     nodeId: z.ZodString;
     kind: z.ZodEnum<{
+        links: "links";
+        affects: "affects";
+        effects: "effects";
+        implements: "implements";
+        reads: "reads";
+        writes: "writes";
+        emits: "emits";
         contains: "contains";
         references: "references";
-        exposes: "exposes";
         maps_to: "maps_to";
-        "operates-on": "operates-on";
         uses: "uses";
         governs: "governs";
+        originates_from: "originates_from";
+        triggers: "triggers";
+        applies_to: "applies_to";
+        uses_catalog: "uses_catalog";
     }>;
 }, z.core.$strip>;
 type Link = z.infer<typeof LinkSchema>;

package/dist/utils/index.js

@@ -1,3 +1,3 @@
-export { APIClientError, API_URL, DEBOUNCE_FILTER, DEBOUNCE_SLIDER, GC_TIME_LONG, GC_TIME_MEDIUM, GC_TIME_SHORT, LIMIT_ACTIVITY_FEED, OAUTH_FLOW_TIMEOUT, PAGE_SIZE_DEFAULT, REFETCH_INTERVAL_DASHBOARD, REFETCH_INTERVAL_REALTIME, REFETCH_INTERVAL_RUNNING, REFETCH_INTERVAL_RUNNING_FAST, SSE_CLOSE_GRACE_PERIOD, SSE_TOKEN_REFRESH_DELAY, STALE_TIME_ADMIN, STALE_TIME_DEFAULT, STALE_TIME_MONITORING, WS_MAX_RETRIES_BEFORE_ERROR, WS_RECONNECT_BASE_DELAY, WS_RECONNECT_MAX_DELAY, debounce, formatChartAxisDate, formatDate, formatDateTime, formatErrorMessage, formatRelativeTime, formatTimeAgo, getErrorInfo, getErrorTitle, getResourceColor, getResourceIcon, getTimeRangeDates, getTimeRangeLabel, isAPIClientError, restoreConsole, setupBrowserMocks, suppressKnownWarnings, validateEmail } from '../chunk-XQHZBA65.js';
+export { APIClientError, API_URL, DEBOUNCE_FILTER, DEBOUNCE_SLIDER, GC_TIME_LONG, GC_TIME_MEDIUM, GC_TIME_SHORT, LIMIT_ACTIVITY_FEED, OAUTH_FLOW_TIMEOUT, PAGE_SIZE_DEFAULT, REFETCH_INTERVAL_DASHBOARD, REFETCH_INTERVAL_REALTIME, REFETCH_INTERVAL_RUNNING, REFETCH_INTERVAL_RUNNING_FAST, SSE_CLOSE_GRACE_PERIOD, SSE_TOKEN_REFRESH_DELAY, STALE_TIME_ADMIN, STALE_TIME_DEFAULT, STALE_TIME_MONITORING, WS_MAX_RETRIES_BEFORE_ERROR, WS_RECONNECT_BASE_DELAY, WS_RECONNECT_MAX_DELAY, debounce, formatChartAxisDate, formatDate, formatDateTime, formatErrorMessage, formatRelativeTime, formatTimeAgo, getErrorInfo, getErrorTitle, getResourceColor, getResourceIcon, getTimeRangeDates, getTimeRangeLabel, isAPIClientError, restoreConsole, setupBrowserMocks, suppressKnownWarnings, validateEmail } from '../chunk-2RJMVWFJ.js';
 export { ResourceStatusColors } from '../chunk-KRWALB24.js';
-import '../chunk-DZTG5IAC.js';
+import '../chunk-I2KLQ2HA.js';

package/dist/vite/index.js

@@ -1,6 +1,6 @@
 import { knowledgePlugin } from '../chunk-UFTM5SZZ.js';
 export { knowledgePlugin } from '../chunk-UFTM5SZZ.js';
-import '../chunk-DZTG5IAC.js';
+import '../chunk-I2KLQ2HA.js';
 
 // src/vite/index.ts
 function elevasisVite() {

package/dist/vite-plugin-knowledge/index.js

@@ -1,2 +1,2 @@
 export { knowledgePlugin } from '../chunk-UFTM5SZZ.js';
-import '../chunk-DZTG5IAC.js';
+import '../chunk-I2KLQ2HA.js';

package/dist/zustand/index.js

@@ -1,4 +1,4 @@
-import '../chunk-DZTG5IAC.js';
+import '../chunk-I2KLQ2HA.js';
 
 // src/zustand/slices/sse.ts
 function resetSSEState(state) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/ui",
-  "version": "2.31.0",
+  "version": "2.33.0",
   "description": "UI components and platform-aware hooks for building custom frontends on the Elevasis platform",
   "type": "module",
   "license": "MIT",
@@ -232,16 +232,19 @@
     "@mantine/charts": "8.2.7",
     "@mantine/notifications": "8.2.7",
     "@mantine/tiptap": "8.2.7",
+    "@mdx-js/mdx": "^3.1.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
     "@tiptap/extension-link": "^2.11.7",
     "@tiptap/extension-placeholder": "^2.11.7",
     "@tiptap/react": "^2.11.7",
     "@tiptap/starter-kit": "^2.11.7",
-    "@mdx-js/mdx": "^3.1.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.1.9",
     "cytoscape": "^3.33.1",
     "cytoscape-fcose": "^2.2.0",
     "globals": "^16.3.0",
+    "msw": "^2.11.0",
     "recharts": "^3.2.1",
     "remark-gfm": "^4.0.1",
     "rollup": "^4.59.0",
@@ -249,20 +252,18 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "vite": "^7.0.0",
-    "@testing-library/react": "^16.3.0",
-    "@testing-library/jest-dom": "^6.9.1",
-    "msw": "^2.11.0",
     "vitest": "^3.2.4",
-    "@elevasis/sdk": "1.19.0",
-    "@repo/eslint-config": "0.0.0",
+    "@repo/core": "0.24.0",
     "@repo/typescript-config": "0.0.0",
-    "@repo/core": "0.22.0",
-    "@repo/elevasis-core": "1.0.0"
+    "@elevasis/sdk": "1.21.0",
+    "@repo/elevasis-core": "1.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "dependencies": {
     "@dagrejs/dagre": "^1.1.4",
     "@microsoft/fetch-event-source": "^2.0.1",
     "mantine-form-zod-resolver": "^1.3.0",
+    "prism-react-renderer": "^2.4.1",
     "react-json-pretty": "^2.2.0"
   },
   "peerDependenciesMeta": {

package/src/README.md

@@ -1,29 +1,29 @@
-# @elevasis/ui
-
-Shared UI package for Elevasis. In the monorepo, import from `@repo/ui`. Published consumers import from `@elevasis/ui`.
-
-## Published Surfaces
-
-- `./provider` and `./provider/ui`
-- `./auth` and `./auth/context`
-- `./hooks`
-- `./sse`
-- `./initialization`
-- `./profile`
-- `./organization`
-- `./api`
-- `./features/*`
-- `./components` and the grouped component subpaths
-- `./theme`
-- `./graph`
-- `./execution`
-- `./router`
-- `./types`
-- `./utils`
-- `./zustand`
-
-## Notes
-
-- `./supabase` is monorepo-only and intentionally excluded from the published npm surface.
-- The package is built before publish, so source-adjacent docs should stay aligned with the current export barrels.
-
+# @elevasis/ui
+
+Shared UI package for Elevasis. In the monorepo, import from `@repo/ui`. Published consumers import from `@elevasis/ui`.
+
+## Published Surfaces
+
+- `./provider` and `./provider/ui`
+- `./auth` and `./auth/context`
+- `./hooks`
+- `./sse`
+- `./initialization`
+- `./profile`
+- `./organization`
+- `./api`
+- `./features/*`
+- `./components` and the grouped component subpaths
+- `./theme`
+- `./graph`
+- `./execution`
+- `./router`
+- `./types`
+- `./utils`
+- `./zustand`
+
+## Notes
+
+- `./supabase` is monorepo-only and intentionally excluded from the published npm surface.
+- The package is built before publish, so source-adjacent docs should stay aligned with the current export barrels.
+

package/src/api/README.md

@@ -1,18 +1,18 @@
-# API
-
-The API surface provides the HTTP client provider, the context hook, and the API config types.
-
-## Exports
-
-- `ApiClientProvider`
-- `useApiClientContext`
-- `useApiClient`
-- `ApiClientContextValue`
-- `ApiClientProviderProps`
-- `ApiErrorDetails`
-
-## Use When
-
-- You need a shared API request client at the app root.
-- You want org-aware request access through `useApiClient`.
-
+# API
+
+The API surface provides the HTTP client provider, the context hook, and the API config types.
+
+## Exports
+
+- `ApiClientProvider`
+- `useApiClientContext`
+- `useApiClient`
+- `ApiClientContextValue`
+- `ApiClientProviderProps`
+- `ApiErrorDetails`
+
+## Use When
+
+- You need a shared API request client at the app root.
+- You want org-aware request access through `useApiClient`.
+

package/src/app/README.md

@@ -1,24 +1,24 @@
-# App
-
-Published app factory for downstream applications.
-
-## Exports
-
-- `createElevasisApp(config)` -- factory that composes providers, router, auth, and theme into a mountable React app
-- `ElevasisAppConfig` -- configuration interface (router, query client, theme, store hooks, error handling)
-- `ElevasisAppStoreConfig` -- store integration hooks for theme state
-
-## Usage
-
-```ts
-import { createElevasisApp } from '@elevasis/ui/app'
-
-const { App } = createElevasisApp({
-  router,
-  queryClient,
-  store: { useThemePreset, useThemeColorScheme, useSetTheme },
-  themeConfig: { presets, defaultPreset },
-})
-```
-
-Consumers must import CSS separately in their entry point.
+# App
+
+Published app factory for downstream applications.
+
+## Exports
+
+- `createElevasisApp(config)` -- factory that composes providers, router, auth, and theme into a mountable React app
+- `ElevasisAppConfig` -- configuration interface (router, query client, theme, store hooks, error handling)
+- `ElevasisAppStoreConfig` -- store integration hooks for theme state
+
+## Usage
+
+```ts
+import { createElevasisApp } from '@elevasis/ui/app'
+
+const { App } = createElevasisApp({
+  router,
+  queryClient,
+  store: { useThemePreset, useThemeColorScheme, useSetTheme },
+  themeConfig: { presets, defaultPreset },
+})
+```
+
+Consumers must import CSS separately in their entry point.

package/src/auth/README.md

@@ -1,18 +1,18 @@
-# Auth
-
-The auth surface is the published authentication entry point for UI shells.
-
-## Exports
-
-- `AuthProvider`
-- `useAuthContext`
-- `useStableAccessToken`
-- `useSessionCheck`
-- `ProtectedRoute`
-- `AdminGuard`
-
-## Use When
-
-- You need auth state, access tokens, or session lifecycle checks.
-- You need route-level guards for protected or admin-only UI.
-
+# Auth
+
+The auth surface is the published authentication entry point for UI shells.
+
+## Exports
+
+- `AuthProvider`
+- `useAuthContext`
+- `useStableAccessToken`
+- `useSessionCheck`
+- `ProtectedRoute`
+- `AdminGuard`
+
+## Use When
+
+- You need auth state, access tokens, or session lifecycle checks.
+- You need route-level guards for protected or admin-only UI.
+

package/src/components/README.md

@@ -1,24 +1,24 @@
-# Components
-
-This barrel groups the shared visual and domain UI surfaces that remain part of the published component layer.
-
-## What It Covers
-
-- Acquisition and CRM UI primitives
-- Navigation, breadcrumbs, tables, forms, modals, and display components
-- Charts, monitoring widgets, notifications, and error states
-- Layout shells, backgrounds, and sidebar primitives
-- Typeform, rich text, content, and resource-definition helpers
-- Operations UI surfaces that are still shared at the component layer
-
-## Related Subpaths
-
-- `./components/navigation`
-- `./components/chat`
-- `./layout`
-- `./charts`
-
-## Notes
-
-- The component layer is broad by design, but feature-oriented application shells should still prefer `./features/*` when a dedicated feature surface exists.
-
+# Components
+
+This barrel groups the shared visual and domain UI surfaces that remain part of the published component layer.
+
+## What It Covers
+
+- Acquisition and CRM UI primitives
+- Navigation, breadcrumbs, tables, forms, modals, and display components
+- Charts, monitoring widgets, notifications, and error states
+- Layout shells, backgrounds, and sidebar primitives
+- Typeform, rich text, content, and resource-definition helpers
+- Operations UI surfaces that are still shared at the component layer
+
+## Related Subpaths
+
+- `./components/navigation`
+- `./components/chat`
+- `./layout`
+- `./charts`
+
+## Notes
+
+- The component layer is broad by design, but feature-oriented application shells should still prefer `./features/*` when a dedicated feature surface exists.
+

package/src/execution/README.md

@@ -1,16 +1,16 @@
-# Execution
-
-The execution surface contains headless helpers for execution timelines, workflow layouts, and execution-specific data shaping.
-
-## Exports
-
-- Hooks under `./hooks`
-- Utilities under `./utils`
-- Execution types under `./types`
-- Shared execution constants
-
-## Use When
-
-- You need execution timeline or workflow graph helpers without pulling in visual shells.
-- You need shared execution math or formatting utilities.
-
+# Execution
+
+The execution surface contains headless helpers for execution timelines, workflow layouts, and execution-specific data shaping.
+
+## Exports
+
+- Hooks under `./hooks`
+- Utilities under `./utils`
+- Execution types under `./types`
+- Shared execution constants
+
+## Use When
+
+- You need execution timeline or workflow graph helpers without pulling in visual shells.
+- You need shared execution math or formatting utilities.
+

package/src/features/README.md

@@ -1,28 +1,28 @@
-# Features
-
-Feature subpaths package complete shell-level UI flows for downstream apps.
-
-## Published Feature Surfaces
-
-- `./features/auth`
-- `./features/crm`
-- `./features/dashboard`
-- `./features/delivery`
-- `./features/lead-gen`
-- `./features/operations`
-- `./features/monitoring`
-- `./features/seo`
-- `./features/settings`
-
-## What They Contain
-
-- Route shells and page-level components
-- Sidebars and feature-specific navigation
-- Feature manifests for registry consumers
-- Feature-specific hooks and shared constants
-
-## Notes
-
-- These surfaces are meant for app composition, not for low-level design-system primitives.
-- Some feature exports are also re-exported through `./components` for convenience in legacy or mixed consumers.
-
+# Features
+
+Feature subpaths package complete shell-level UI flows for downstream apps.
+
+## Published Feature Surfaces
+
+- `./features/auth`
+- `./features/crm`
+- `./features/dashboard`
+- `./features/delivery`
+- `./features/lead-gen`
+- `./features/operations`
+- `./features/monitoring`
+- `./features/seo`
+- `./features/settings`
+
+## What They Contain
+
+- Route shells and page-level components
+- Sidebars and feature-specific navigation
+- Feature manifests for registry consumers
+- Feature-specific hooks and shared constants
+
+## Notes
+
+- These surfaces are meant for app composition, not for low-level design-system primitives.
+- Some feature exports are also re-exported through `./components` for convenience in legacy or mixed consumers.
+