@elevasis/ui 2.6.0 → 2.8.0

package/dist/components/index.d.ts

@@ -3831,13 +3831,14 @@ type ListConfigInput = z.infer<typeof ListConfigSchema>;
 /**
  * Per-user-per-org config (stored in org_memberships.config)
  * Controls which features a specific member can access within their org
- * Valid feature keys: operations, monitoring, acquisition, calibration, seo
+ * Valid feature keys: operations, monitoring, acquisition, delivery, calibration, seo
  */
 interface MembershipFeatureConfig {
     features?: {
         operations?: boolean;
         monitoring?: boolean;
         acquisition?: boolean;
+        delivery?: boolean;
         calibration?: boolean;
         seo?: boolean;
     };
@@ -6983,68 +6984,6 @@ interface SortState {
     direction: SortDirection;
 }
 
-interface ActivityFilters$1 {
-    activityType?: ActivityType | 'all';
-    status?: ActivityStatus | 'all';
-    search?: string;
-}
-
-interface ExecutionLogsFilters$1 {
-    resourceId: string | undefined;
-    status: 'all' | ExecutionStatus;
-    resourceStatus: 'all' | 'dev' | 'prod';
-}
-
-interface CreateApiKeyResponse {
-    id: string;
-    key: string;
-    message: string;
-}
-
-/**
- * GET /api/credentials - List credentials
- */
-declare const ListCredentialsResponseSchema = z.object({
-  credentials: z.array(
-    z.object({
-      id: UuidSchema,
-      name: z.string(),
-      type: z.string(),
-      provider: z.string().nullable(), // OAuth provider or null for non-OAuth
-      createdAt: z.string().datetime()
-    })
-  )
-})
-
-/** API response type for a single credential list item */
-type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number]
-
-interface CreateCredentialResponse {
-    id: string;
-    name: string;
-    type: string;
-}
-
-/**
- * Response shape for a single webhook endpoint.
- * NOT strict — response schemas allow extra fields for forward compatibility.
- */
-declare const WebhookEndpointResponseSchema = z.object({
-  id: UuidSchema,
-  organizationId: UuidSchema,
-  key: z.string(),
-  name: z.string(),
-  description: z.string().nullable(),
-  resourceId: z.string().nullable(),
-  status: WebhookEndpointStatusSchema,
-  lastTriggeredAt: z.string().datetime().nullable(),
-  requestCount: z.number().int().min(0),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime()
-})
-
-type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
-
 interface DocFile {
     path: string;
     frontmatter: {
@@ -7167,6 +7106,68 @@ interface CommandViewGraph$1 {
     edges: CommandViewEdge$1[];
 }
 
+interface CreateApiKeyResponse {
+    id: string;
+    key: string;
+    message: string;
+}
+
+/**
+ * GET /api/credentials - List credentials
+ */
+declare const ListCredentialsResponseSchema = z.object({
+  credentials: z.array(
+    z.object({
+      id: UuidSchema,
+      name: z.string(),
+      type: z.string(),
+      provider: z.string().nullable(), // OAuth provider or null for non-OAuth
+      createdAt: z.string().datetime()
+    })
+  )
+})
+
+/** API response type for a single credential list item */
+type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number]
+
+interface CreateCredentialResponse {
+    id: string;
+    name: string;
+    type: string;
+}
+
+/**
+ * Response shape for a single webhook endpoint.
+ * NOT strict — response schemas allow extra fields for forward compatibility.
+ */
+declare const WebhookEndpointResponseSchema = z.object({
+  id: UuidSchema,
+  organizationId: UuidSchema,
+  key: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  resourceId: z.string().nullable(),
+  status: WebhookEndpointStatusSchema,
+  lastTriggeredAt: z.string().datetime().nullable(),
+  requestCount: z.number().int().min(0),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime()
+})
+
+type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
+
+interface ActivityFilters$1 {
+    activityType?: ActivityType | 'all';
+    status?: ActivityStatus | 'all';
+    search?: string;
+}
+
+interface ExecutionLogsFilters$1 {
+    resourceId: string | undefined;
+    status: 'all' | ExecutionStatus;
+    resourceStatus: 'all' | 'dev' | 'prod';
+}
+
 interface SortableHeaderProps {
     column: string;
     children: React.ReactNode;
@@ -8640,7 +8641,43 @@ declare const CrmSidebar: () => react_jsx_runtime.JSX.Element;
 
 declare const CrmSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const CrmSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+/**
+ * Shared nav-item shape used by feature sidebar middle components.
+ *
+ * Matches the subset of {@link SubshellNavItemProps} that the existing
+ * hardcoded item arrays use. Consumers import this type alongside the
+ * exported item arrays (e.g. `CRM_ITEMS`) to type their custom arrays.
+ *
+ * @example
+ * import { NavItem, CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const customItems: NavItem[] = [
+ *   ...CRM_ITEMS,
+ *   { label: 'Reports', to: '/crm/reports', icon: IconFileText, exact: false },
+ * ]
+ */
+interface NavItem {
+    /** Display label for the nav entry. */
+    label: string;
+    /** Route path the item links to. */
+    to: string;
+    /** Tabler icon component (or any component accepting `size` + `style`). */
+    icon: ComponentType<{
+        size?: number;
+        style?: React.CSSProperties;
+    }>;
+    /**
+     * When `true`, the item is only active when the path matches exactly.
+     * When `false`, it is active for any path that starts with `to`.
+     */
+    exact: boolean;
+}
+
+interface CrmSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link CRM_ITEMS}. */
+    items?: NavItem[];
+}
+declare const CrmSidebarMiddle: ({ items }?: CrmSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 interface PipelineStageSummary {
     stage: DealStage;
@@ -8776,14 +8813,33 @@ interface FeatureNavEntry {
 }
 type FeatureSidebarComponent = ComponentType;
 interface FeatureModule {
+    /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
     key: string;
-    label?: string;
+    /** Feature key used for access-flag gating in the organization model. */
     accessFeatureKey: OrganizationModelFeatureKey;
+    /**
+     * Semantic domain identifiers contributed by this feature.
+     * Merged with surface-derived domain IDs during resolution.
+     */
     domainIds?: OrganizationModelSemanticDomain['id'][];
+    /**
+     * Capability identifiers contributed by this feature.
+     * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+     * Not queried at runtime — kept for semantic graph completeness so that
+     * capability membership is fully represented in the resolved model even when
+     * a surface does not declare it directly.
+     */
     capabilityIds?: string[];
+    /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
     navEntry?: FeatureNavEntry;
+    /** Sidebar component rendered when a matching subshell route is active. */
     sidebar?: FeatureSidebarComponent;
+    /** Route path prefixes that activate this feature's sidebar and subshell context. */
     subshellRoutes?: string[];
+    /**
+     * Operations-only bridge surface connecting this feature to the organization graph.
+     * Ignored by all other features. Only one manifest in the registry should set this.
+     */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface OrganizationGraphFeatureBridge {
@@ -8805,7 +8861,11 @@ declare const LeadGenSidebar: () => react_jsx_runtime.JSX.Element;
 
 declare const LeadGenSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const LeadGenSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+interface LeadGenSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link LEAD_GEN_ITEMS}. */
+    items?: NavItem[];
+}
+declare const LeadGenSidebarMiddle: ({ items }?: LeadGenSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 declare const leadGenManifest: FeatureModule;
 
@@ -8894,8 +8954,14 @@ declare const ProjectsSidebarTop: () => react_jsx_runtime.JSX.Element;
 interface ProjectsSidebarMiddleProps {
     currentPath?: string;
     onNavigate?: (to: string) => void;
-}
-declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
+    /** Override the project section items. Defaults to {@link DELIVERY_PROJECT_ITEMS}. */
+    projectItems?: NavItem[];
+    /** Override the work section items. Defaults to {@link DELIVERY_WORK_ITEMS}. */
+    workItems?: NavItem[];
+    /** Override the communication section items. Defaults to {@link DELIVERY_COMMUNICATION_ITEMS}. */
+    communicationItems?: NavItem[];
+}
+declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate, projectItems, workItems, communicationItems }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 declare const deliveryManifest: FeatureModule;
 

package/dist/components/index.js

@@ -1,16 +1,16 @@
-import '../chunk-SMJLS23U.js';
+import '../chunk-NYMKWGKN.js';
 import { useBreadcrumbs } from '../chunk-MG3NF7QL.js';
-export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../chunk-6RGNVHG3.js';
-export { LEAD_GEN_ROUTE_LINKS, LIST_TEMPLATE_OPTIONS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenDeliverabilityPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, buildListConfig, getEnrichmentColor, getStatusColor, leadGenManifest, useDeleteLists } from '../chunk-X4BLH3JL.js';
-export { ActionModal, AgentDefinitionDisplay, AgentExecutionLogs, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, CheckpointGroup, CollapsibleJsonSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, ConfigCard, ContentSections, ContextUsageBadge, ContractDisplay, ExecutionErrorSection, FormFieldRenderer, LogEntry, LogGroup, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceNotFoundState, SessionMemory, ToolsListDisplay, WorkflowDefinitionDisplay, WorkflowExecutionLogs, getExecutionStatusConfig, getIcon, getLogLevelConfig, iconMap, operationsManifest, useNewKnowledgeMapLayout } from '../chunk-FH5QGCXL.js';
+export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../chunk-UX3Q4YYN.js';
+export { LEAD_GEN_ROUTE_LINKS, LIST_TEMPLATE_OPTIONS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenDeliverabilityPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, buildListConfig, getEnrichmentColor, getStatusColor, leadGenManifest, useDeleteLists } from '../chunk-OFT2QK6B.js';
+export { ActionModal, AgentDefinitionDisplay, AgentExecutionLogs, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, CheckpointGroup, CollapsibleJsonSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, ConfigCard, ContentSections, ContextUsageBadge, ContractDisplay, ExecutionErrorSection, FormFieldRenderer, LogEntry, LogGroup, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceNotFoundState, SessionMemory, ToolsListDisplay, WorkflowDefinitionDisplay, WorkflowExecutionLogs, getExecutionStatusConfig, getIcon, getLogLevelConfig, iconMap, operationsManifest, useNewKnowledgeMapLayout } from '../chunk-F5QSLYUB.js';
 import '../chunk-ROSMICXG.js';
 import { SubshellLoader, CollapsibleSidebarGroup } from '../chunk-IDACMRGQ.js';
-import { NotificationList } from '../chunk-PHRDZFJT.js';
-export { ActivityCard, ActivityFilters as ActivityFiltersBar, ActivityTable, BusinessImpactCard, CostBreakdownCard, CostByModelTable, CostMetricsCard, ErrorAnalysisCard, ErrorBreakdownTable, ExecutionBreakdownTable, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, NotificationItem, NotificationList, monitoringManifest } from '../chunk-PHRDZFJT.js';
-export { ResourceHealthPanel } from '../chunk-PEDPD3PU.js';
-export { SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, seoManifest } from '../chunk-YIWLA2B6.js';
-export { CreateCredentialModal, CredentialList, CredentialSettings, MembershipFeaturePanel, MembershipStatusBadge, OAuthConnectModal, OrganizationMembershipsList, WebhookUrlDisplayModal, settingsManifest } from '../chunk-CC4WGHGG.js';
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../chunk-MU5EZV3L.js';
+import { NotificationList } from '../chunk-ZZ35VSNF.js';
+export { ActivityCard, ActivityFilters as ActivityFiltersBar, ActivityTable, BusinessImpactCard, CostBreakdownCard, CostByModelTable, CostMetricsCard, ErrorAnalysisCard, ErrorBreakdownTable, ExecutionBreakdownTable, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, NotificationItem, NotificationList, monitoringManifest } from '../chunk-ZZ35VSNF.js';
+export { ResourceHealthPanel } from '../chunk-7PDDPNQS.js';
+export { SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, seoManifest } from '../chunk-C2OFFC7J.js';
+export { CreateCredentialModal, CredentialList, CredentialSettings, MembershipFeaturePanel, MembershipStatusBadge, OAuthConnectModal, OrganizationMembershipsList, WebhookUrlDisplayModal, settingsManifest } from '../chunk-KGEYEUR5.js';
+export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../chunk-MGEC63TE.js';
 export { SortableHeader, TableSelectionToolbar } from '../chunk-TUMSNGTX.js';
 import { PageContainer } from '../chunk-BZZCNLT6.js';
 import { SubshellNavItem } from '../chunk-27COZ5AH.js';
@@ -18,23 +18,23 @@ import { FilterBar } from '../chunk-PDHTXPSF.js';
 export { FilterBar } from '../chunk-PDHTXPSF.js';
 import { CustomModal } from '../chunk-GBMNCNHX.js';
 export { ConfirmationInputModal, ConfirmationModal, CustomModal } from '../chunk-GBMNCNHX.js';
-import { BaseNode, useGraphTheme, BaseEdge, GraphBackground, GraphLegend, GraphFitViewButton } from '../chunk-ZB5PKIX5.js';
-export { AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, BaseEdge, BaseNode, EmptyVisualizer, ExecutionStats, ExecutionStatusBadge, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, VisualizerContainer, WorkflowExecutionTimeline, getGraphBackgroundStyles, useGraphBackgroundStyles, useGraphTheme } from '../chunk-ZB5PKIX5.js';
+import { BaseNode, useGraphTheme, BaseEdge, GraphBackground, GraphLegend, GraphFitViewButton } from '../chunk-CTWYIRKW.js';
+export { AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, BaseEdge, BaseNode, EmptyVisualizer, ExecutionStats, ExecutionStatusBadge, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, VisualizerContainer, WorkflowExecutionTimeline, getGraphBackgroundStyles, useGraphBackgroundStyles, useGraphTheme } from '../chunk-CTWYIRKW.js';
 export { ResourceHealthChart, getHealthColor } from '../chunk-LGKLC5MG.js';
 import '../chunk-KFICYU6S.js';
 import { AppShellLoader } from '../chunk-YEX4MQSY.js';
 import '../chunk-VNUOQQNY.js';
 export { CONTAINER_CONSTANTS, SHARED_VIZ_CONSTANTS } from '../chunk-XA34RETF.js';
-import { useUpdateApiKey, useDeleteApiKey, useCreateApiKey, useListApiKeys, useActivateDeployment, useDeactivateDeployment, useDeleteDeployment, useListDeployments } from '../chunk-DQJM7T2N.js';
-import { useCommandViewLayout, usePaginationState, useDeploymentDocs, useResources, useCreateSchedule, useListSchedules, usePauseSchedule, useResumeSchedule, useCancelSchedule, useDeleteSchedule, useDealNotes, useCreateDealNote, useDeals, useSyncDealStage, dealKeys, useMarkAllAsRead, useNotifications, showErrorNotification, showSuccessNotification, showApiErrorNotification } from '../chunk-POFDRPDI.js';
-export { showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification } from '../chunk-POFDRPDI.js';
+import '../chunk-7M2VOCYN.js';
+import { useCommandViewLayout, useUpdateApiKey, useDeleteApiKey, useCreateApiKey, useListApiKeys, usePaginationState, useActivateDeployment, useDeactivateDeployment, useDeleteDeployment, useListDeployments, useDeploymentDocs, useResources, useCreateSchedule, useListSchedules, usePauseSchedule, useResumeSchedule, useCancelSchedule, useDeleteSchedule, useDealNotes, useCreateDealNote, useDeals, useSyncDealStage, dealKeys, useMarkAllAsRead, useNotifications, showErrorNotification, showSuccessNotification, showApiErrorNotification } from '../chunk-4PHPENKX.js';
+export { showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification } from '../chunk-4PHPENKX.js';
 import '../chunk-LXHZYSMQ.js';
 import { Graph_module_css_default, useDirectedChainHighlighting, useNodeSelection, GRAPH_CONSTANTS } from '../chunk-22UVE3RA.js';
 export { Graph_module_css_default as graphStyles } from '../chunk-22UVE3RA.js';
-import '../chunk-4GZ6VZWO.js';
+import '../chunk-YCHZ4U5V.js';
 import '../chunk-47YILFON.js';
 import '../chunk-CYXZHBP4.js';
-import '../chunk-O4PMRC6J.js';
+import '../chunk-OPT74SGF.js';
 import { SubshellContainer, SubshellSidebar, SubshellRightSideContainer, SubshellContentContainer } from '../chunk-RX4UWZZR.js';
 import { ListSkeleton, EmptyState, PageTitleCaption, StatCard, CenteredErrorState, CardHeader, ActivityTimeline } from '../chunk-Y3D3WFJG.js';
 export { APIErrorAlert, ActivityTimeline, CardHeader, CenteredErrorState, CollapsibleSection, ContextViewer, CustomSelector, DetailCardSkeleton, ElevasisLoader, EmptyState, FeatureUnavailableState, GlowDot, JsonViewer, ListSkeleton, PageNotFound, PageTitleCaption, ResourceCard, StatCard, StatCardSkeleton, StatsCardSkeleton, StatusBadge, TabCountBadge, TimeRangeSelector, TrendIndicator, catalogItemToResourceDefinition } from '../chunk-Y3D3WFJG.js';
@@ -893,19 +893,28 @@ function DocTreeNav({ files, selectedPath, onSelect }) {
     }
   );
 }
+
+// src/components/operations/knowledge-base/preferredDocPath.ts
+var PREFERRED_INDEX_PATHS = ["index.mdx", "index.md", "docs/index.mdx", "docs/index.md"];
+function getPreferredDocPath(files, selectedPath) {
+  if (selectedPath && files.some((file) => file.path === selectedPath)) {
+    return selectedPath;
+  }
+  if (files.length === 0) {
+    return null;
+  }
+  const preferredIndexFile = files.find(
+    (file) => PREFERRED_INDEX_PATHS.includes(file.path)
+  );
+  return preferredIndexFile?.path ?? files[0].path;
+}
 function KnowledgeBasePage({ mdxRenderer: MdxRenderer2 }) {
   const { organizationReady } = useInitialization();
   const [selectedDeploymentId, setSelectedDeploymentId] = useState(void 0);
   const [selectedPath, setSelectedPath] = useState(null);
   const { files, isLoading, error, activeDeployment, activeDeployments } = useDeploymentDocs(selectedDeploymentId);
   const effectivePath = useMemo(() => {
-    if (selectedPath && files.some((f) => f.path === selectedPath)) {
-      return selectedPath;
-    }
-    if (files.length === 0) return null;
-    const indexFile = files.find((f) => f.path === "index.mdx" || f.path === "docs/index.mdx");
-    if (indexFile) return indexFile.path;
-    return files[0].path;
+    return getPreferredDocPath(files, selectedPath);
   }, [selectedPath, files]);
   const selectedFile = useMemo(() => {
     if (!effectivePath) return null;
@@ -1017,7 +1026,7 @@ function KnowledgeBasePage({ mdxRenderer: MdxRenderer2 }) {
       showNoDocs && /* @__PURE__ */ jsx(Center, { style: { flex: 1 }, children: /* @__PURE__ */ jsxs(Stack, { align: "center", gap: "sm", children: [
         /* @__PURE__ */ jsx(IconFileOff, { size: 48, color: "var(--color-text-subtle)" }),
         /* @__PURE__ */ jsx(Text, { c: "dimmed", size: "lg", children: "No documentation found" }),
-        /* @__PURE__ */ jsx(Text, { c: "dimmed", size: "sm", children: "Add MDX files to your project's docs directory and redeploy." })
+        /* @__PURE__ */ jsx(Text, { c: "dimmed", size: "sm", children: "Add Markdown files (`.md` or `.mdx`) to your project's docs directory and redeploy." })
       ] }) }),
       showContent && selectedFile && /* @__PURE__ */ jsxs(Box, { style: { display: "flex", gap: "1rem", alignItems: "flex-start" }, children: [
         /* @__PURE__ */ jsx(Box, { style: { flex: 1, minWidth: 0 }, children: /* @__PURE__ */ jsx(Card, { withBorder: true, children: /* @__PURE__ */ jsx("div", { ref: contentRef, children: MdxRenderer2 ? /* @__PURE__ */ jsx(MdxRenderer2, { compiledSource: selectedFile.compiledSource }) : /* @__PURE__ */ jsx(Text, { c: "dimmed", children: "No MDX renderer provided" }) }) }) }),

package/dist/features/auth/index.d.ts

@@ -2708,7 +2708,7 @@ interface FeatureGuardProps {
     deniedMessage?: string;
     /**
      * The `useFeatureAccess` hook instance to use for feature flag resolution.
-     * Must be created via `createUseFeatureAccess` from `@repo/ui/hooks`.
+     * Must be created via `createFeatureAccessHook` from `@repo/ui/hooks`.
      */
     useFeatureAccess: UseFeatureAccessHook;
 }
@@ -2716,7 +2716,7 @@ interface FeatureGuardProps {
  * Route guard that restricts access to a named feature.
  *
  * Reads feature flags from the provided `useFeatureAccess` hook instance
- * (created via `createUseFeatureAccess` from `@repo/ui/hooks`). When the
+ * (created via `createFeatureAccessHook` from `@repo/ui/hooks`). When the
  * feature is not allowed, shows a Mantine notification and redirects to '/'.
  *
  * The `restrictedBy === 'membership'` branch surfaces a personal access
@@ -2725,7 +2725,7 @@ interface FeatureGuardProps {
  * @example
  * ```tsx
  * // In your app, create the hook once:
- * export const useFeatureAccess = createUseFeatureAccess({ useInitialization, useOrganization })
+ * export const useFeatureAccess = createFeatureAccessHook({ useInitialization, useOrganization })
  *
  * // Then use the guard:
  * function MonitoringLayout() {

package/dist/features/auth/index.js

@@ -87,11 +87,18 @@ function AdminGuard2({ children, redirectTo, fallback = /* @__PURE__ */ jsx(AppS
   return /* @__PURE__ */ jsx(AdminGuard, { redirectTo, fallback, children });
 }
 var FEATURE_LABELS = {
+  crm: "CRM",
+  "lead-gen": "Lead Gen",
+  projects: "Projects",
   operations: "Operations",
   monitoring: "Monitoring",
-  acquisition: "Acquisition",
+  settings: "Settings",
+  calibration: "Calibration",
   seo: "SEO"
 };
+function getFeatureLabel(featureKey) {
+  return FEATURE_LABELS[featureKey] ?? featureKey;
+}
 function FeatureGuard({ featureKey, children, deniedMessage, useFeatureAccess }) {
   const { checkFeature, isReady } = useFeatureAccess();
   const navigate = useNavigate();
@@ -100,7 +107,7 @@ function FeatureGuard({ featureKey, children, deniedMessage, useFeatureAccess })
   useEffect(() => {
     if (isReady && !allowed && !hasRedirected.current) {
       hasRedirected.current = true;
-      const featureLabel = FEATURE_LABELS[featureKey] || featureKey;
+      const featureLabel = getFeatureLabel(featureKey);
       const message = deniedMessage ?? (restrictedBy === "membership" ? `You do not have access to ${featureLabel}.` : `${featureLabel} is not available for your organization.`);
       notifications.show({
         title: "Access Restricted",

package/dist/features/crm/index.d.ts

@@ -1,12 +1,49 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType, ReactNode } from 'react';
 import { z } from 'zod';
-import { ReactNode, ComponentType } from 'react';
 
 declare const CrmSidebar: () => react_jsx_runtime.JSX.Element;
 
 declare const CrmSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const CrmSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+/**
+ * Shared nav-item shape used by feature sidebar middle components.
+ *
+ * Matches the subset of {@link SubshellNavItemProps} that the existing
+ * hardcoded item arrays use. Consumers import this type alongside the
+ * exported item arrays (e.g. `CRM_ITEMS`) to type their custom arrays.
+ *
+ * @example
+ * import { NavItem, CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const customItems: NavItem[] = [
+ *   ...CRM_ITEMS,
+ *   { label: 'Reports', to: '/crm/reports', icon: IconFileText, exact: false },
+ * ]
+ */
+interface NavItem {
+    /** Display label for the nav entry. */
+    label: string;
+    /** Route path the item links to. */
+    to: string;
+    /** Tabler icon component (or any component accepting `size` + `style`). */
+    icon: ComponentType<{
+        size?: number;
+        style?: React.CSSProperties;
+    }>;
+    /**
+     * When `true`, the item is only active when the path matches exactly.
+     * When `false`, it is active for any path that starts with `to`.
+     */
+    exact: boolean;
+}
+
+declare const CRM_ITEMS: NavItem[];
+interface CrmSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link CRM_ITEMS}. */
+    items?: NavItem[];
+}
+declare const CrmSidebarMiddle: ({ items }?: CrmSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 type Json = string | number | boolean | null | {
     [key: string]: Json | undefined;
@@ -2821,14 +2858,33 @@ interface FeatureNavEntry {
 }
 type FeatureSidebarComponent = ComponentType;
 interface FeatureModule {
+    /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
     key: string;
-    label?: string;
+    /** Feature key used for access-flag gating in the organization model. */
     accessFeatureKey: OrganizationModelFeatureKey;
+    /**
+     * Semantic domain identifiers contributed by this feature.
+     * Merged with surface-derived domain IDs during resolution.
+     */
     domainIds?: OrganizationModelSemanticDomain['id'][];
+    /**
+     * Capability identifiers contributed by this feature.
+     * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+     * Not queried at runtime — kept for semantic graph completeness so that
+     * capability membership is fully represented in the resolved model even when
+     * a surface does not declare it directly.
+     */
     capabilityIds?: string[];
+    /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
     navEntry?: FeatureNavEntry;
+    /** Sidebar component rendered when a matching subshell route is active. */
     sidebar?: FeatureSidebarComponent;
+    /** Route path prefixes that activate this feature's sidebar and subshell context. */
     subshellRoutes?: string[];
+    /**
+     * Operations-only bridge surface connecting this feature to the organization graph.
+     * Ignored by all other features. Only one manifest in the registry should set this.
+     */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface OrganizationGraphFeatureBridge {
@@ -2853,5 +2909,5 @@ interface DealDetailPageProps {
 }
 declare function DealDetailPage({ dealId, renderActions, onDealLoaded }: DealDetailPageProps): react_jsx_runtime.JSX.Element;
 
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity };
-export type { ActivityFeedWidgetProps, RecentActivityEntry as CrmActivityEntry, CrmActivityKind, CrmOverviewProps, CrmQuickMetrics, MyTasksPanelProps, PipelineFunnelWidgetProps, PipelineStageSummary, QuickCreateActionsProps, SavedViewPreset, SavedViewsPanelProps, TasksDueWidgetProps };
+export { ActivityFeedWidget, CRM_ITEMS, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity };
+export type { ActivityFeedWidgetProps, RecentActivityEntry as CrmActivityEntry, CrmActivityKind, CrmOverviewProps, CrmQuickMetrics, CrmSidebarMiddleProps, MyTasksPanelProps, PipelineFunnelWidgetProps, PipelineStageSummary, QuickCreateActionsProps, SavedViewPreset, SavedViewsPanelProps, TasksDueWidgetProps };

package/dist/features/crm/index.js

@@ -1,17 +1,17 @@
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../../chunk-MU5EZV3L.js';
+export { ActivityFeedWidget, CRM_ITEMS, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../../chunk-MGEC63TE.js';
 import '../../chunk-TUMSNGTX.js';
 import '../../chunk-BZZCNLT6.js';
 import '../../chunk-27COZ5AH.js';
 import '../../chunk-PDHTXPSF.js';
 import '../../chunk-GBMNCNHX.js';
-import '../../chunk-DQJM7T2N.js';
-import '../../chunk-POFDRPDI.js';
+import '../../chunk-7M2VOCYN.js';
+import '../../chunk-4PHPENKX.js';
 import '../../chunk-LXHZYSMQ.js';
 import '../../chunk-22UVE3RA.js';
-import '../../chunk-4GZ6VZWO.js';
+import '../../chunk-YCHZ4U5V.js';
 import '../../chunk-47YILFON.js';
 import '../../chunk-CYXZHBP4.js';
-import '../../chunk-O4PMRC6J.js';
+import '../../chunk-OPT74SGF.js';
 import '../../chunk-RX4UWZZR.js';
 import '../../chunk-Y3D3WFJG.js';
 import '../../chunk-3KMDHCAR.js';

package/dist/features/dashboard/index.js

@@ -1,16 +1,16 @@
-export { Dashboard, OperationsOverview, RecentExecutionsByResource, ResourceOverview, UnresolvedErrorsTeaser } from '../../chunk-ZB5PKIX5.js';
+export { Dashboard, OperationsOverview, RecentExecutionsByResource, ResourceOverview, UnresolvedErrorsTeaser } from '../../chunk-CTWYIRKW.js';
 import '../../chunk-LGKLC5MG.js';
 import '../../chunk-KFICYU6S.js';
 import '../../chunk-YEX4MQSY.js';
 import '../../chunk-XA34RETF.js';
-import '../../chunk-DQJM7T2N.js';
-import '../../chunk-POFDRPDI.js';
+import '../../chunk-7M2VOCYN.js';
+import '../../chunk-4PHPENKX.js';
 import '../../chunk-LXHZYSMQ.js';
 import '../../chunk-22UVE3RA.js';
-import '../../chunk-4GZ6VZWO.js';
+import '../../chunk-YCHZ4U5V.js';
 import '../../chunk-47YILFON.js';
 import '../../chunk-CYXZHBP4.js';
-import '../../chunk-O4PMRC6J.js';
+import '../../chunk-OPT74SGF.js';
 import '../../chunk-RX4UWZZR.js';
 import '../../chunk-Y3D3WFJG.js';
 import '../../chunk-3KMDHCAR.js';