@elevasis/core 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/core",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "Minimal shared constants across Elevasis monorepo",
   "sideEffects": false,

package/src/__tests__/template-core-compatibility.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { PROJECTS_VIEW_CAPABILITY_ID, PROJECTS_FEATURE_ID } from '../organization-model/published'
+import { PROJECTS_FEATURE_ID } from '../organization-model/published'
 import {
   getOrganizationSurface,
   homeLabel,
@@ -13,95 +13,77 @@ describe('template core compatibility', () => {
     expect(foundationOrganizationModel.navigation.quickAccessSurfaceIds).toEqual(quickAccessSurfaceIds)
     expect(foundationOrganizationModel.version).toBe(1)
     expect(foundationOrganizationModel.navigation.defaultSurfaceId).toBe('operations')
-    expect(getOrganizationSurface('operations')).toMatchObject({
-      id: 'operations',
-      label: 'Organization Graph',
-      path: '/operations',
-      surfaceType: 'graph',
-      featureId: 'operations'
-    })
-
-    expect(getOrganizationSurface('operations.organization-graph')).toMatchObject({
-      id: 'operations.organization-graph',
-      label: 'Organization Graph',
-      path: '/operations',
-      surfaceType: 'graph',
-      featureId: 'operations'
-    })
-  })
-
-  it('projects legacy template aliases with canonical navigation metadata', () => {
+    expect(getOrganizationSurface('operations')).toMatchObject({
+      id: 'operations',
+      label: 'Organization Graph',
+      path: '/operations',
+      surfaceType: 'graph'
+    })
+
+    expect(getOrganizationSurface('operations.graph')).toMatchObject({
+      id: 'operations.graph',
+      label: 'Organization Graph',
+      path: '/operations',
+      surfaceType: 'graph'
+    })
+  })
+
+  it('projects legacy template aliases with canonical navigation metadata', () => {
     const legacySurfaces = [
       {
-        id: 'operations',
-        label: 'Organization Graph',
-        surfaceType: 'graph',
-        expectedFeatureId: 'operations',
-        expectedIcon: 'operations',
-        expectedPath: '/operations',
-        expectedEntityIds: [],
-        expectedCapabilityIds: ['operations.organization-graph']
-      },
-      {
-        id: PROJECTS_FEATURE_ID,
-        label: 'Projects',
-        surfaceType: 'list',
-        expectedFeatureId: PROJECTS_FEATURE_ID,
-        expectedIcon: 'projects',
-        expectedPath: '/projects',
-        expectedEntityIds: ['delivery.project'],
-        expectedCapabilityIds: [PROJECTS_VIEW_CAPABILITY_ID]
-      },
-      {
-        id: 'lead-gen',
-        label: 'Lists',
-        surfaceType: 'list',
-        expectedFeatureId: 'lead-gen',
-        expectedIcon: 'lead-gen',
-        expectedPath: '/lead-gen/lists',
-        expectedEntityIds: ['leadgen.list'],
-        expectedCapabilityIds: ['leadgen.lists.manage']
-      },
-      {
-        id: 'crm',
-        label: 'Pipeline',
-        surfaceType: 'graph',
-        expectedFeatureId: 'crm',
-        expectedIcon: 'crm',
-        expectedPath: '/crm/pipeline',
-        expectedEntityIds: ['crm.deal'],
-        expectedCapabilityIds: ['crm.pipeline.manage']
-      }
-    ] as const
-
-    expect(getOrganizationSurface('operations.organization-graph')).toBeDefined()
-
-    for (const surface of legacySurfaces) {
-      expect(getOrganizationSurface(surface.id)).toMatchObject({
-        id: surface.id,
-        label: surface.label,
-        path: surface.expectedPath,
-        surfaceType: surface.surfaceType,
-        icon: surface.expectedIcon,
-        featureId: surface.expectedFeatureId,
-        entityIds: surface.expectedEntityIds,
-        resourceIds: [],
-        capabilityIds: surface.expectedCapabilityIds
-      })
-    }
-  })
-
-  it('maps grouped core features onto the legacy template feature vocabulary', () => {
-    const features = foundationOrganizationModel.features as Array<{ id: string; label: string; enabled: boolean }>
-    const featureById = (id: string) => features.find((f) => f.id === id)
-
-    expect(featureById('crm')?.enabled).toBe(true)
-    expect(featureById('lead-gen')?.enabled).toBe(true)
-    expect(featureById('projects')?.enabled).toBe(true)
-    expect(featureById('operations')?.enabled).toBe(true)
-
-    expect(featureById('crm')?.label).toBe('CRM')
-    expect(featureById('lead-gen')?.label).toBe('Lead Gen')
-    expect(featureById('projects')?.label).toBe('Projects')
-  })
-})
+        id: 'operations',
+        label: 'Organization Graph',
+        surfaceType: 'graph',
+        expectedIcon: 'operations',
+        expectedPath: '/operations',
+      },
+      {
+        id: PROJECTS_FEATURE_ID,
+        label: 'Projects',
+        surfaceType: 'list',
+        expectedIcon: 'projects',
+        expectedPath: '/projects',
+      },
+      {
+        id: 'lead-gen',
+        label: 'Lead Gen',
+        surfaceType: 'list',
+        expectedIcon: 'lead-gen',
+        expectedPath: '/lead-gen',
+      },
+      {
+        id: 'crm',
+        label: 'CRM',
+        surfaceType: 'graph',
+        expectedIcon: 'crm',
+        expectedPath: '/crm',
+      }
+    ] as const
+
+    expect(getOrganizationSurface('operations.graph')).toBeDefined()
+
+    for (const surface of legacySurfaces) {
+      expect(getOrganizationSurface(surface.id)).toMatchObject({
+        id: surface.id,
+        label: surface.label,
+        path: surface.expectedPath,
+        surfaceType: surface.surfaceType,
+        icon: surface.expectedIcon
+      })
+    }
+  })
+
+  it('maps grouped core features onto the legacy template feature vocabulary', () => {
+    const features = foundationOrganizationModel.features as Array<{ id: string; label: string; enabled: boolean }>
+    const featureById = (id: string) => features.find((f) => f.id === id)
+
+    expect(featureById('sales.crm')?.enabled).toBe(true)
+    expect(featureById('sales.lead-gen')?.enabled).toBe(true)
+    expect(featureById('projects')?.enabled).toBe(true)
+    expect(featureById('operations')?.enabled).toBe(true)
+
+    expect(featureById('sales.crm')?.label).toBe('CRM')
+    expect(featureById('sales.lead-gen')?.label).toBe('Lead Gen')
+    expect(featureById('projects')?.label).toBe('Projects')
+  })
+})

package/src/_gen/__tests__/__snapshots__/contracts.md.snap

@@ -45,22 +45,28 @@ export type OrganizationModelProjects = z.infer<typeof OrganizationModelProjects
 export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
 ```
 
-### `OrganizationModelNavigation`
+### `NodeIdPath`
 
 ```typescript
-export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
+export type NodeIdPath = z.infer<typeof NodeIdPathSchema>
 ```
 
-### `OrganizationModelSurface`
+### `NodeIdString`
 
 ```typescript
-export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+export type NodeIdString = z.infer<typeof NodeIdStringSchema>
+```
+
+### `OrganizationModelNavigation`
+
+```typescript
+export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
 ```
 
-### `OrganizationModelResourceMapping`
+### `OrganizationModelSurface`
 
 ```typescript
-export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSchema>
+export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
 ```
 
 ### `OrganizationModelTechStackEntry`
@@ -179,64 +185,34 @@ export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> :
 
 ## Feature System
 
-### `FeatureNavLink`
-
-```typescript
-export interface FeatureNavLink {
-  label: string
-  link: string
-  featureKey?: string
-  onClick?: () => void
-  links?: FeatureNavLink[]
-}
-```
-
-### `FeatureNavEntry`
+### `FeatureSidebarComponent`
 
 ```typescript
-export interface FeatureNavEntry {
-  label: string
-  icon: ComponentType
-  link?: string
-  featureKey?: string
-  requiresAdmin?: boolean
-  dataOnboardingTourId?: string
-  links?: FeatureNavLink[]
-}
+export type FeatureSidebarComponent = ComponentType
+export type FeatureIconComponent = ComponentType<{ size?: number;
 ```
 
-### `FeatureSidebarComponent`
+### `FeatureIconComponent`
 
 ```typescript
-export type FeatureSidebarComponent = ComponentType
+export type FeatureIconComponent = ComponentType<{ size?: number;
 ```
 
 ### `FeatureModule`
 
 ```typescript
 export interface FeatureModule {
-  /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
+  /** Unique stable identifier for this feature module. */
   key: string
-  /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
+  /** Organization Model feature id this module presents. */
   featureId: string
-  /**
-   * 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.
-   */
+  /** Capability identifiers contributed by this feature module. */
   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. */
+  /** Icon used when this feature node appears in shell navigation. */
+  icon?: FeatureIconComponent
+  /** Sidebar component rendered when this feature's subtree 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.
-   */
+  /** Operations-only bridge connecting this feature to the organization graph node. */
   organizationGraph?: OrganizationGraphFeatureBridge
 }
 ```
@@ -255,8 +231,6 @@ export interface ResolvedFeatureAccess {
 ```typescript
 export interface ResolvedFeatureSemantics {
   capabilityIds: string[]
-  surfaceIds: string[]
-  surfaces: OrganizationModelSurface[]
 }
 ```
 
@@ -269,25 +243,11 @@ export interface ResolvedFeatureModule extends FeatureModule {
 }
 ```
 
-### `ShellNavPlacement`
-
-```typescript
-export type ShellNavPlacement = 'primary' | 'bottom'
-```
-
-### `ShellNavSource`
-
-```typescript
-export type ShellNavSource = 'app' | 'feature'
-```
-
-### `ResolvedShellNavItem`
+### `ResolvedShellFeature`
 
 ```typescript
-export interface ResolvedShellNavItem extends FeatureNavEntry {
-  placement: ShellNavPlacement
-  source: ShellNavSource
-  featureId?: string
+export interface ResolvedShellFeature extends OrganizationModelFeature {
+  iconComponent?: FeatureIconComponent
 }
 ```
 
@@ -295,16 +255,16 @@ export interface ResolvedShellNavItem extends FeatureNavEntry {
 
 ```typescript
 export interface ResolvedShellModel {
-  navItems: ResolvedShellNavItem[]
-}
-```
-
-### `AppShellOverrides`
-
-```typescript
-export interface AppShellOverrides {
-  primaryNavItems?: FeatureNavEntry[]
-  bottomNavItems?: FeatureNavEntry[]
+  features: readonly ResolvedShellFeature[]
+  findByPath: (path: string) => ResolvedShellFeature | undefined
+  findById: (id: string) => ResolvedShellFeature | undefined
+  childrenOf: (id: string) => ResolvedShellFeature[]
+  ancestorsOf: (id: string) => ResolvedShellFeature[]
+  parentOf: (id: string) => ResolvedShellFeature | undefined
+  topLevel: () => ResolvedShellFeature[]
+  uiPositionFor: (id: string) => OrganizationModelFeature['uiPosition'] | undefined
+  requiresAdminFor: (id: string) => boolean
+  devOnlyFor: (id: string) => boolean
 }
 ```
 
@@ -321,8 +281,7 @@ export interface ResolvedShellRouteMatch {
   status: ShellRouteMatchStatus
   path: string
   feature?: ResolvedFeatureModule
-  navItem?: ResolvedShellNavItem
-  navLink?: FeatureNavLink
+  node?: ResolvedShellFeature
 }
 ```
 
@@ -338,7 +297,7 @@ export interface ShellRuntime {
 
 ```typescript
 export interface OrganizationGraphFeatureBridge {
-  surfaceId: string
+  featureId: string
 }
 ```
 
@@ -347,10 +306,8 @@ export interface OrganizationGraphFeatureBridge {
 ```typescript
 export interface OrganizationGraphContextValue {
   available: boolean
-  surfaceId?: string
-  surfacePath?: string
-  surfaceType?: OrganizationModelSurface['surfaceType']
   featureId?: string
+  featurePath?: string
 }
 ```
 
@@ -360,7 +317,6 @@ export interface OrganizationGraphContextValue {
 export interface ElevasisFeaturesProviderProps {
   features: FeatureModule[]
   organizationModel?: OrganizationModel
-  appShellOverrides?: AppShellOverrides
   timeRange?: TimeRange
   operationsApiUrl?: string
   operationsSSEManager?: SSEConnectionManagerLike
@@ -401,8 +357,8 @@ export interface ElevasisFeaturesContextValue {
  * Resource Registry type definitions
  */
 
-import type { IntegrationType } from '../../execution/engine/tools/integration'
-import type { ResourceDomain } from './domains'
+import type { IntegrationType } from '../../execution/engine/tools/integration'
+import type { ResourceCategory, ResourceLink } from './resource-link'
 
 // ============================================================================
 // Core Resource Type Definitions
@@ -479,8 +435,11 @@ export interface ResourceDefinition {
   /** Environment/deployment status */
   status: ResourceStatus
 
-  /** Domain tags for filtering and organization */
-  domains?: ResourceDomain[]
+  /** Graph links to Organization Model nodes */
+  links?: ResourceLink[]
+
+  /** Infrastructure category for filtering */
+  category?: ResourceCategory
 
   /** Whether the agent supports multi-turn sessions (agents only) */
   sessionCapable?: boolean
@@ -493,7 +452,7 @@ export interface ResourceDefinition {
 }
 ```
 
-### `DomainDefinition`
+### `ResourceList`
 
 ```typescript
 /** Unique resource identifier */
@@ -514,8 +473,11 @@ export interface ResourceDefinition {
   /** Environment/deployment status */
   status: ResourceStatus
 
-  /** Domain tags for filtering and organization */
-  domains?: ResourceDomain[]
+  /** Graph links to Organization Model nodes */
+  links?: ResourceLink[]
+
+  /** Infrastructure category for filtering */
+  category?: ResourceCategory
 
   /** Whether the agent supports multi-turn sessions (agents only) */
   sessionCapable?: boolean
@@ -527,57 +489,9 @@ export interface ResourceDefinition {
   archived?: boolean
 }
 
-// ============================================================================
-// Domain Definition Types
-// ============================================================================
-
-/**
- * Domain definition for Command View filtering
- *
- * Domains are organizational metadata for UI filtering/grouping.
- * No execution impact - purely for visualization.
- *
- * @example
- * {
- *   id: 'support',
- *   name: 'Customer Support',
- *   description: 'Ticket triage, knowledge base, escalations',
- *   color: 'green',
- *   icon: 'IconHeadset'
- * }
- */
-export interface DomainDefinition {
-  /** Unique identifier (e.g., 'support') */
-  id: string
-  /** Display name (e.g., 'Customer Support') */
-  name: string
-  /** Purpose description */
-  description: string
-  /** Optional Mantine color for UI (e.g., 'blue', 'green', 'orange') */
-  color?: string
-  /** Optional Tabler icon name (e.g., 'IconHeadset') */
-  icon?: string
-}
-```
-
-### `ResourceList`
-
-```typescript
-/** Unique identifier (e.g., 'support') */
-  id: string
-  /** Display name (e.g., 'Customer Support') */
-  name: string
-  /** Purpose description */
-  description: string
-  /** Optional Mantine color for UI (e.g., 'blue', 'green', 'orange') */
-  color?: string
-  /** Optional Tabler icon name (e.g., 'IconHeadset') */
-  icon?: string
-}
-
-/**
- * Resource list for organization
- * Returns ResourceDefinition metadata (not full definitions)
+/**
+ * Resource list for organization
+ * Returns ResourceDefinition metadata (not full definitions)
  */
 export interface ResourceList {
   workflows: ResourceDefinition[]
@@ -676,7 +590,7 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * scheduled cron jobs, platform events, or manual user actions.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited), `type` -> `triggerType`
  * - Relationship rename: `invokes` -> `triggers` (unified vocabulary)
  * - New required fields: `version` (inherited), `type: 'trigger'` (inherited)
@@ -712,7 +626,7 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * scheduled cron jobs, platform events, or manual user actions.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited), `type` -> `triggerType`
  * - Relationship rename: `invokes` -> `triggers` (unified vocabulary)
  * - New required fields: `version` (inherited), `type: 'trigger'` (inherited)
@@ -790,7 +704,7 @@ export interface TriggerDefinition extends ResourceDefinition {
  * stored here (queried at runtime from credentials table).
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - New required field: `status` (inherited) - organizations must add status to all integrations
  * - New required field: `version` (inherited) - organizations must add version to all integrations
@@ -919,7 +833,7 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  * no API integration with external platforms, no status syncing.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - New required field: `version` (inherited) - organizations must add version to all external resources
  * - New required field: `type: 'external'` (inherited) - resource type discriminator
@@ -954,7 +868,7 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  * no API integration with external platforms, no status syncing.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - New required field: `version` (inherited) - organizations must add version to all external resources
  * - New required field: `type: 'external'` (inherited) - resource type discriminator
@@ -1048,7 +962,7 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
  * Tasks with matching command_queue_group are routed to this checkpoint.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - description is now REQUIRED (was optional) - organizations must add description to all human checkpoints
  * - New required field: `version` (inherited) - organizations must add version to all human checkpoints