@elevasis/core 0.2.0 → 0.3.0

package/src/organization-model/organization-model.mdx

@@ -21,7 +21,7 @@ The model does **not** replace the shared feature-provider system. It enriches a
 - `packages/core/src/organization-model/types.ts` -- exported TypeScript types
 - `packages/core/src/organization-model/defaults.ts` -- `DEFAULT_ORGANIZATION_MODEL`
 - `packages/core/src/organization-model/resolve.ts` -- `defineOrganizationModel`, `resolveOrganizationModel`
-- `packages/core/src/organization-model/domains/*.ts` -- feature keys, navigation surfaces, CRM/lead-gen/delivery semantics
+- `packages/core/src/organization-model/domains/*.ts` -- feature schema, navigation surfaces, CRM/lead-gen/delivery semantics
 - `packages/core/src/published.ts` -- curated root barrel for the published package
 - `packages/core/src/organization-model/published.ts` -- curated organization-model barrel
 - `packages/core/src/__tests__/template-foundations-compatibility.test.ts` -- adapter-baseline guard
@@ -31,9 +31,8 @@ The model does **not** replace the shared feature-provider system. It enriches a
 Top-level fields on `OrganizationModel`:
 
 - `version`
-- `domains` -- semantic domains (`crm`, `lead-gen`, `delivery`, `operations`)
+- `features` -- unified feature array (`OrganizationModelFeature[]`); each entry combines access gating, semantic grouping, and display metadata
 - `branding`
-- `features` -- `enabled` map and `labels` overrides
 - `navigation` -- surfaces, groups, `defaultSurfaceId`
 - `crm` -- pipeline stages and stage semantics
 - `leadGen` -- company/contact lifecycle stages
@@ -61,24 +60,21 @@ All `id` fields, `parentId`, `defaultSurfaceId`, and reference ID arrays use `Mo
 
 This applies to domain IDs, surface IDs, navigation group IDs, and resource mapping IDs.
 
-### Default Feature Keys
+### Default Features
 
-```ts
-type OrganizationModelFeatureKey =
-  | 'acquisition'
-  | 'delivery'
-  | 'operations'
-  | 'monitoring'
-  | 'settings'
-  | 'seo'
-  | 'calibration'
-```
+Seven features ship by default in `DEFAULT_ORGANIZATION_MODEL.features`:
 
-These are the **grouped** published access/visibility keys. They differ from shell feature-module keys (`crm`, `lead-gen`, `delivery`). See [Feature Shell](../ui/feature-shell.mdx) for how the provider bridges the two.
+- `crm` -- enabled; CRM pipeline and deal management
+- `lead-gen` -- enabled; prospecting, qualification, and outreach
+- `projects` -- enabled; projects, milestones, and client work execution (formerly `delivery`)
+- `operations` -- enabled; organizational topology and orchestration visibility
+- `monitoring` -- enabled; execution monitoring
+- `settings` -- enabled; organization settings
+- `seo` -- disabled by default; SEO surface
 
-### Default Semantic Domains
+Each feature entry (`OrganizationModelFeature`) combines what were previously three separate concepts: an access/gating key (the former `OrganizationModelFeatureKey`), a semantic domain (the former `SemanticDomainSchema` entry), and display metadata. The `features` field is now `z.array(FeatureSchema)` -- there is no separate `domains` array and no separate `enabled`/`labels` map.
 
-Four domains ship by default -- `crm`, `lead-gen`, `delivery`, `operations`. Each binds together entity IDs, surface IDs, resource IDs, and capability IDs. Domains are semantic, not purely navigational -- they describe what area of the business or resource model a thing belongs to, not which access key gates it.
+`FeatureModule.featureId` on the UI side maps directly to one of these IDs. No alias layer is needed. See [Feature Shell](../ui/feature-shell.mdx) for how the provider resolves feature access from this array.
 
 ### ResourceMapping Shape
 
@@ -88,7 +84,7 @@ Four domains ship by default -- `crm`, `lead-gen`, `delivery`, `operations`. Eac
 - `resourceId` -- the actual resource identifier (string, max 255 chars)
 - `resourceType` -- one of `'workflow' | 'agent' | 'trigger' | 'integration' | 'external' | 'human_checkpoint'`
 - `label`, `description`, `color`, `icon` -- display metadata (from `DisplayMetadataSchema`)
-- `domainIds` -- domains this resource belongs to
+- `featureIds` -- features this resource belongs to (replaces the former `domainIds`)
 - `entityIds` -- entities this resource operates on
 - `surfaceIds` -- surfaces this resource is exposed in
 - `capabilityIds` -- capabilities this resource fulfills
@@ -109,9 +105,9 @@ Surfaces such as `crm.pipeline`, `lead-gen.lists`, `projects.index`, `operations
 - `surfaceType` -- `'page' | 'dashboard' | 'graph' | 'detail' | 'list' | 'settings'`
 - `description` -- optional
 - `icon` -- optional icon name token (max 80 chars)
-- `featureKey` -- optional `OrganizationModelFeatureKey` that gates this surface
+- `featureId` -- optional feature ID that gates this surface (replaces the former `featureKey` field); must match a feature `id` in the features array
 - `parentId` -- optional ModelId referencing a parent surface; validated to exist
-- `domainIds` -- domains this surface belongs to (bidirectionally validated)
+- `featureIds` -- features this surface belongs to (bidirectionally validated; replaces the former `domainIds`)
 - `entityIds` -- entity IDs relevant to this surface
 - `resourceIds` -- resources exposed on this surface (bidirectionally validated against resource mappings)
 - `capabilityIds` -- capabilities this surface fulfills
@@ -126,11 +122,13 @@ Surfaces such as `crm.pipeline`, `lead-gen.lists`, `projects.index`, `operations
 
 The default groups (`primary-workspace`, `primary-operations`) both use `placement: 'primary'`.
 
-### Domain-Specific Semantics
+### Feature-Specific Semantics
 
-- **CRM** -- pipeline stages and stage semantics
-- **Lead-gen** -- company and contact lifecycle stages
-- **Delivery** -- project, milestone, and task statuses
+The top-level `crm`, `leadGen`, and `delivery` fields on `OrganizationModel` remain as named fields (not moved into per-feature config) and carry domain-specific semantic shapes:
+
+- `crm` -- pipeline stages and stage semantics
+- `leadGen` -- company and contact lifecycle stages
+- `delivery` -- project, milestone, and task statuses (used by the `projects` feature)
 
 This is why the organization model is semantic, not just nav config -- it owns product meaning for the business objects the shell surfaces expose.
 
@@ -152,7 +150,7 @@ Merge semantics:
 
 **Uniqueness checks** -- IDs must be unique within their respective collections:
 
-- `domains[].id`
+- `features[].id`
 - `navigation.surfaces[].id`
 - `navigation.groups[].id`
 - `resourceMappings[].id`
@@ -162,20 +160,20 @@ Merge semantics:
 
 - `navigation.defaultSurfaceId` must point at a declared surface
 - every `surfaceId` in a navigation group must resolve to a declared surface
-- every `surfaceId` in a domain must resolve to a declared surface
-- every `resourceId` in a domain must resolve to a declared resource mapping (by `resourceId`)
+- every `surfaceId` in a feature must resolve to a declared surface
+- every `resourceId` in a feature must resolve to a declared resource mapping (by `resourceId`)
 - surface `parentId` must reference an existing surface
-- every `domainId` on a surface must resolve to a declared domain
+- every `featureId` on a surface must resolve to a declared feature
 - every `resourceId` on a surface must resolve to a declared resource mapping
-- every `domainId` on a resource mapping must resolve to a declared domain
+- every `featureId` on a resource mapping must resolve to a declared feature
 - every `surfaceId` on a resource mapping must resolve to a declared surface
 
 **Bidirectional reference enforcement** -- cross-references must be mutual, not one-sided:
 
-- a domain listing `surfaceId` S requires surface S to list that domain's ID in its `domainIds`
-- a surface listing `domainId` D requires domain D to list that surface's ID in its `surfaceIds`
-- a domain listing `resourceId` R requires resource mapping R to list that domain's ID in its `domainIds`
-- a resource mapping listing `domainId` D requires domain D to list that resource's `resourceId` in its `resourceIds`
+- a feature listing `surfaceId` S requires surface S to list that feature's ID in its `featureIds`
+- a surface listing `featureId` F requires feature F to list that surface's ID in its `surfaceIds`
+- a feature listing `resourceId` R requires resource mapping R to list that feature's ID in its `featureIds`
+- a resource mapping listing `featureId` F requires feature F to list that resource's `resourceId` in its `resourceIds`
 - a surface listing `resourceId` R requires resource mapping R to list that surface's ID in its `surfaceIds`
 - a resource mapping listing `surfaceId` S requires surface S to list that resource's `resourceId` in its `resourceIds`
 
@@ -185,8 +183,8 @@ This bidirectional enforcement is what keeps the organization model semantically
 
 `ElevasisFeaturesProvider` uses the organization model in three ways:
 
-1. **Feature resolution** -- provider first checks `useFeatureAccess()`, then refines through organization-model feature state when the model knows the key.
-2. **Nav label and path resolution** -- when `organizationModel` is present, feature labels resolve from `organizationModel.features.labels`, and surface labels and paths resolve from `organizationModel.navigation.surfaces`. Semantic customization without changing manifest code.
+1. **Feature resolution** -- the provider looks up each manifest's `featureId` in `organizationModel.features` to determine `access.enabled`. If no matching feature entry is found, `access.enabled` defaults to `false`.
+2. **Nav label and path resolution** -- when `organizationModel` is present, feature labels resolve from the matching feature entry's `label` field, and surface labels and paths resolve from `organizationModel.navigation.surfaces`. Semantic customization without changing manifest code.
 3. **Organization-graph bridge** -- the `operationsManifest` declares `organizationGraph.surfaceId = 'operations.organization-graph'`. The provider resolves that against organization-model surfaces and exposes the result as `organizationGraph` in context. See [Organization Graph](./organization-graph.mdx).
 
 ## Published Package: `@elevasis/core`
@@ -238,7 +236,7 @@ Exports the foundations module provides to consumers:
 - `FoundationFeatureKey`, `FoundationSurfaceIcon`, `FoundationNavigationSurface`, `FoundationOrganizationModel`
 - `homeLabel`, `quickAccessSurfaceIds`, `getOrganizationSurface(surfaceId)`
 
-Downstream template shells pass `canonicalOrganizationModel` into `ElevasisFeaturesProvider`, preserving host-local dashboard/nav customizations alongside the shared runtime. Grouped core features map onto template vocabulary -- `crm` and `lead-gen` project from `acquisition`, `projects` from `delivery`.
+Downstream template shells pass `canonicalOrganizationModel` into `ElevasisFeaturesProvider`, preserving host-local dashboard/nav customizations alongside the shared runtime. Feature IDs are now direct matches -- `crm`, `lead-gen`, `projects` in the org model correspond directly to the same IDs on `FeatureModule.featureId`. No alias layer is needed.
 
 Derivative projects (`external/nirvana-marketing`, `external/ZentaraHQ`) follow the same adapter + provider-wiring baseline with their own project-local customizations.
 

package/src/organization-model/published.ts

@@ -1,6 +1,9 @@
 export { OrganizationModelSchema } from './schema'
+export { FeatureSchema } from './domains/features'
+export { PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, DELIVERY_PROJECTS_VIEW_CAPABILITY_ID } from './contracts'
 export { DEFAULT_ORGANIZATION_MODEL } from './defaults'
 export { defineOrganizationModel, resolveOrganizationModel } from './resolve'
+export { createFoundationOrganizationModel } from './foundation'
 
 export type {
   DeepPartial,
@@ -8,11 +11,17 @@ export type {
   OrganizationModelBranding,
   OrganizationModelCrm,
   OrganizationModelDelivery,
-  OrganizationModelFeatureKey,
-  OrganizationModelFeatures,
+  OrganizationModelFeature,
   OrganizationModelLeadGen,
   OrganizationModelNavigation,
   OrganizationModelResourceMapping,
-  OrganizationModelSemanticDomain,
   OrganizationModelSurface
 } from './types'
+
+export type {
+  FoundationBranding,
+  FoundationNavigationSurface,
+  FoundationOrganizationModel,
+  FoundationSurfaceIcon,
+  FoundationSurfaceType
+} from './foundation'

package/src/organization-model/schema.ts

@@ -2,16 +2,15 @@ import { z } from 'zod'
 import { OrganizationModelBrandingSchema } from './domains/branding'
 import { OrganizationModelCrmSchema } from './domains/crm'
 import { OrganizationModelDeliverySchema } from './domains/delivery'
-import { OrganizationModelFeaturesSchema } from './domains/features'
+import { FeatureSchema } from './domains/features'
 import { OrganizationModelLeadGenSchema } from './domains/lead-gen'
 import { OrganizationModelNavigationSchema } from './domains/navigation'
-import { ResourceMappingSchema, SemanticDomainSchema } from './domains/shared'
+import { ResourceMappingSchema } from './domains/shared'
 
 const OrganizationModelSchemaBase = z.object({
   version: z.literal(1).default(1),
-  domains: z.array(SemanticDomainSchema).default([]),
+  features: z.array(FeatureSchema).default([]),
   branding: OrganizationModelBrandingSchema,
-  features: OrganizationModelFeaturesSchema,
   navigation: OrganizationModelNavigationSchema,
   crm: OrganizationModelCrmSchema,
   leadGen: OrganizationModelLeadGenSchema,
@@ -48,7 +47,7 @@ function collectIds<T extends { id: string }>(
 }
 
 export const OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ctx) => {
-  const domainsById = collectIds(model.domains, ctx, ['domains'], 'Domain')
+  const featuresById = collectIds(model.features, ctx, ['features'], 'Feature')
   const surfacesById = collectIds(model.navigation.surfaces, ctx, ['navigation', 'surfaces'], 'Surface')
   collectIds(model.navigation.groups, ctx, ['navigation', 'groups'], 'Navigation group')
   collectIds(model.resourceMappings, ctx, ['resourceMappings'], 'Resource mapping')
@@ -87,48 +86,51 @@ export const OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((
     })
   })
 
-  model.domains.forEach((domain, domainIndex) => {
-    domain.surfaceIds.forEach((surfaceId, surfaceIndex) => {
+  // Feature -> Surface bidirectional validation
+  model.features.forEach((feature, featureIndex) => {
+    feature.surfaceIds.forEach((surfaceId, surfaceIndex) => {
       const surface = surfacesById.get(surfaceId)
       if (!surface) {
         addIssue(
           ctx,
-          ['domains', domainIndex, 'surfaceIds', surfaceIndex],
-          `Domain "${domain.id}" references unknown surface "${surfaceId}"`
+          ['features', featureIndex, 'surfaceIds', surfaceIndex],
+          `Feature "${feature.id}" references unknown surface "${surfaceId}"`
         )
         return
       }
 
-      if (!surface.domainIds.includes(domain.id)) {
+      if (!surface.featureIds.includes(feature.id)) {
         addIssue(
           ctx,
-          ['domains', domainIndex, 'surfaceIds', surfaceIndex],
-          `Domain "${domain.id}" references surface "${surfaceId}" but that surface does not include domain "${domain.id}"`
+          ['features', featureIndex, 'surfaceIds', surfaceIndex],
+          `Feature "${feature.id}" references surface "${surfaceId}" but that surface does not include feature "${feature.id}"`
         )
       }
     })
 
-    domain.resourceIds.forEach((resourceId, resourceIndex) => {
+    // Feature -> Resource bidirectional validation
+    feature.resourceIds.forEach((resourceId, resourceIndex) => {
       const resourceMapping = resourceMappingsByResourceId.get(resourceId)
       if (!resourceMapping) {
         addIssue(
           ctx,
-          ['domains', domainIndex, 'resourceIds', resourceIndex],
-          `Domain "${domain.id}" references unknown resource "${resourceId}"`
+          ['features', featureIndex, 'resourceIds', resourceIndex],
+          `Feature "${feature.id}" references unknown resource "${resourceId}"`
         )
         return
       }
 
-      if (!resourceMapping.domainIds.includes(domain.id)) {
+      if (!resourceMapping.featureIds.includes(feature.id)) {
         addIssue(
           ctx,
-          ['domains', domainIndex, 'resourceIds', resourceIndex],
-          `Domain "${domain.id}" references resource "${resourceId}" but that resource mapping does not include domain "${domain.id}"`
+          ['features', featureIndex, 'resourceIds', resourceIndex],
+          `Feature "${feature.id}" references resource "${resourceId}" but that resource mapping does not include feature "${feature.id}"`
         )
       }
     })
   })
 
+  // Surface -> Feature bidirectional validation and other surface refs
   model.navigation.surfaces.forEach((surface, surfaceIndex) => {
     if (surface.parentId && !surfacesById.has(surface.parentId)) {
       addIssue(
@@ -138,26 +140,27 @@ export const OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((
       )
     }
 
-    surface.domainIds.forEach((domainId, domainIndex) => {
-      const domain = domainsById.get(domainId)
-      if (!domain) {
+    surface.featureIds.forEach((featureId, featureIndex) => {
+      const feature = featuresById.get(featureId)
+      if (!feature) {
         addIssue(
           ctx,
-          ['navigation', 'surfaces', surfaceIndex, 'domainIds', domainIndex],
-          `Surface "${surface.id}" references unknown domain "${domainId}"`
+          ['navigation', 'surfaces', surfaceIndex, 'featureIds', featureIndex],
+          `Surface "${surface.id}" references unknown feature "${featureId}"`
         )
         return
       }
 
-      if (!domain.surfaceIds.includes(surface.id)) {
+      if (!feature.surfaceIds.includes(surface.id)) {
         addIssue(
           ctx,
-          ['navigation', 'surfaces', surfaceIndex, 'domainIds', domainIndex],
-          `Surface "${surface.id}" references domain "${domainId}" but that domain does not include surface "${surface.id}"`
+          ['navigation', 'surfaces', surfaceIndex, 'featureIds', featureIndex],
+          `Surface "${surface.id}" references feature "${featureId}" but that feature does not include surface "${surface.id}"`
         )
       }
     })
 
+    // Surface -> Resource bidirectional validation
     surface.resourceIds.forEach((resourceId, resourceIndex) => {
       const resourceMapping = resourceMappingsByResourceId.get(resourceId)
       if (!resourceMapping) {
@@ -179,23 +182,24 @@ export const OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((
     })
   })
 
+  // ResourceMapping -> Feature and Surface bidirectional validation
   model.resourceMappings.forEach((resourceMapping, resourceIndex) => {
-    resourceMapping.domainIds.forEach((domainId, domainIndex) => {
-      const domain = domainsById.get(domainId)
-      if (!domain) {
+    resourceMapping.featureIds.forEach((featureId, featureIndex) => {
+      const feature = featuresById.get(featureId)
+      if (!feature) {
         addIssue(
           ctx,
-          ['resourceMappings', resourceIndex, 'domainIds', domainIndex],
-          `Resource mapping "${resourceMapping.id}" references unknown domain "${domainId}"`
+          ['resourceMappings', resourceIndex, 'featureIds', featureIndex],
+          `Resource mapping "${resourceMapping.id}" references unknown feature "${featureId}"`
         )
         return
       }
 
-      if (!domain.resourceIds.includes(resourceMapping.resourceId)) {
+      if (!feature.resourceIds.includes(resourceMapping.resourceId)) {
         addIssue(
           ctx,
-          ['resourceMappings', resourceIndex, 'domainIds', domainIndex],
-          `Resource mapping "${resourceMapping.id}" references domain "${domainId}" but that domain does not include resource "${resourceMapping.resourceId}"`
+          ['resourceMappings', resourceIndex, 'featureIds', featureIndex],
+          `Resource mapping "${resourceMapping.id}" references feature "${featureId}" but that feature does not include resource "${resourceMapping.resourceId}"`
         )
       }
     })

package/src/organization-model/types.ts

@@ -2,10 +2,10 @@ import type { z } from 'zod'
 import { OrganizationModelBrandingSchema } from './domains/branding'
 import { OrganizationModelCrmSchema } from './domains/crm'
 import { OrganizationModelDeliverySchema } from './domains/delivery'
-import { OrganizationModelFeaturesSchema, FeatureKeySchema } from './domains/features'
+import { FeatureSchema } from './domains/features'
 import { OrganizationModelLeadGenSchema } from './domains/lead-gen'
 import { OrganizationModelNavigationSchema, SurfaceDefinitionSchema } from './domains/navigation'
-import { ResourceMappingSchema, SemanticDomainSchema } from './domains/shared'
+import { ResourceMappingSchema } from './domains/shared'
 import { OrganizationModelSchema } from './schema'
 
 export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
@@ -13,15 +13,10 @@ export type OrganizationModelBranding = z.infer<typeof OrganizationModelBranding
 export type OrganizationModelCrm = z.infer<typeof OrganizationModelCrmSchema>
 export type OrganizationModelLeadGen = z.infer<typeof OrganizationModelLeadGenSchema>
 export type OrganizationModelDelivery = z.infer<typeof OrganizationModelDeliverySchema>
-export type OrganizationModelFeatures = z.infer<typeof OrganizationModelFeaturesSchema>
-export type OrganizationModelFeatureKey = z.infer<typeof FeatureKeySchema>
+export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
 export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
 export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
-export type OrganizationModelSemanticDomain = z.infer<typeof SemanticDomainSchema>
 export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSchema>
 
-export type DeepPartial<T> = T extends Array<infer U>
-  ? Array<DeepPartial<U>>
-  : T extends object
-    ? { [K in keyof T]?: DeepPartial<T[K]> }
-    : T
+export type DeepPartial<T> =
+  T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T

package/src/platform/constants/versions.ts

@@ -1,3 +1,3 @@
 export const VERSION = {
-  CURRENT: '1.5.6'
+  CURRENT: '1.5.7'
 }

package/src/platform/sse/events.ts

@@ -14,54 +14,21 @@ import type {
   ExecutionCompleteEvent,
   ExecutionConnectedEvent
 } from '../../execution/core/sse-executions'
-import type {
-  CalibrationSSEEvent,
-  CalibrationExecutionStartedEvent,
-  CalibrationExecutionCompletedEvent,
-  CalibrationExecutionFailedEvent,
-  CalibrationSessionStartedEvent,
-  CalibrationTurnStartedEvent,
-  CalibrationTurnCompletedEvent,
-  CalibrationSessionCompletedEvent,
-  CalibrationGradingStartedEvent,
-  CalibrationGradingCompletedEvent,
-  CalibrationGradingFailedEvent,
-  CalibrationCompletedEvent,
-  CalibrationFailedEvent,
-  CalibrationConnectedEvent
-} from '../../execution/calibration/sse-events'
 
 // Re-export domain-specific event types
 export type { NotificationSSEEvent, NotificationCountUpdatedEvent }
 export type { ActivitySSEEvent, ActivityCreatedEvent, ActivityConnectedEvent }
 export type { CommandQueueSSEEvent, CommandQueueTaskUpdatedEvent, CommandQueueConnectedEvent }
 export type { ExecutionSSEEvent, ExecutionStartedEvent, ExecutionLogEvent, ExecutionCompleteEvent, ExecutionConnectedEvent }
-export type {
-  CalibrationSSEEvent,
-  CalibrationExecutionStartedEvent,
-  CalibrationExecutionCompletedEvent,
-  CalibrationExecutionFailedEvent,
-  CalibrationSessionStartedEvent,
-  CalibrationTurnStartedEvent,
-  CalibrationTurnCompletedEvent,
-  CalibrationSessionCompletedEvent,
-  CalibrationGradingStartedEvent,
-  CalibrationGradingCompletedEvent,
-  CalibrationGradingFailedEvent,
-  CalibrationCompletedEvent,
-  CalibrationFailedEvent,
-  CalibrationConnectedEvent
-}
 
 /**
  * Union of all application-level SSE events across all domains
  *
  * Use this for generic SSE handling that needs to support all event types.
- * For domain-specific handling, use NotificationSSEEvent, ActivitySSEEvent, ExecutionSSEEvent, CalibrationSSEEvent, etc.
+ * For domain-specific handling, use NotificationSSEEvent, ActivitySSEEvent, ExecutionSSEEvent, etc.
  */
 export type AppSSEEvent =
   | NotificationSSEEvent
   | ActivitySSEEvent
   | CommandQueueSSEEvent
   | ExecutionSSEEvent
-  | CalibrationSSEEvent

package/src/projects/api-schemas.ts

@@ -102,7 +102,8 @@ export const UpdateProjectRequestSchema = z
 export const GetProjectsQuerySchema = z
   .object({
     kind: ProjectKindSchema.optional(),
-    status: ProjectStatusSchema.optional()
+    status: ProjectStatusSchema.optional(),
+    search: z.string().trim().min(1).max(255).optional()
   })
   .strict()
 

package/src/reference/_generated/contracts.md

@@ -1,3 +1,4 @@
+<!-- Auto-generated on 2026-04-18T06:38:52.184Z by scripts/monorepo/generate-scaffold-contracts.js -->
 ---
 title: Reference Contracts
 description: Auto-generated TypeScript contracts for SDK consumers. Do not edit manually.
@@ -37,16 +38,10 @@ export type OrganizationModelLeadGen = z.infer<typeof OrganizationModelLeadGenSc
 export type OrganizationModelDelivery = z.infer<typeof OrganizationModelDeliverySchema>
 ```
 
-### `OrganizationModelFeatures`
+### `OrganizationModelFeature`
 
 ```typescript
-export type OrganizationModelFeatures = z.infer<typeof OrganizationModelFeaturesSchema>
-```
-
-### `OrganizationModelFeatureKey`
-
-```typescript
-export type OrganizationModelFeatureKey = z.infer<typeof FeatureKeySchema>
+export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
 ```
 
 ### `OrganizationModelNavigation`
@@ -61,12 +56,6 @@ export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNaviga
 export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
 ```
 
-### `OrganizationModelSemanticDomain`
-
-```typescript
-export type OrganizationModelSemanticDomain = z.infer<typeof SemanticDomainSchema>
-```
-
 ### `OrganizationModelResourceMapping`
 
 ```typescript
@@ -76,11 +65,7 @@ export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSch
 ### `DeepPartial`
 
 ```typescript
-export type DeepPartial<T> = T extends Array<infer U>
-  ? Array<DeepPartial<U>>
-  : T extends object
-    ? { [K in keyof T]?: DeepPartial<T[K]> }
-    : T
+export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
 ```
 
 ## Feature System
@@ -121,15 +106,10 @@ export type FeatureSidebarComponent = ComponentType
 
 ```typescript
 export interface FeatureModule {
-  /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
+  /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
   key: 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'][]
+  /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
+  featureId: string
   /**
    * Capability identifiers contributed by this feature.
    * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
@@ -156,7 +136,7 @@ export interface FeatureModule {
 
 ```typescript
 export interface ResolvedFeatureAccess {
-  featureKey: string
+  featureId: string
   enabled: boolean
 }
 ```
@@ -165,7 +145,6 @@ export interface ResolvedFeatureAccess {
 
 ```typescript
 export interface ResolvedFeatureSemantics {
-  domainIds: OrganizationModelSemanticDomain['id'][]
   capabilityIds: string[]
   surfaceIds: string[]
   surfaces: OrganizationModelSurface[]
@@ -199,7 +178,7 @@ export type ShellNavSource = 'app' | 'feature'
 export interface ResolvedShellNavItem extends FeatureNavEntry {
   placement: ShellNavPlacement
   source: ShellNavSource
-  accessFeatureKey?: string
+  featureId?: string
 }
 ```
 
@@ -262,7 +241,7 @@ export interface OrganizationGraphContextValue {
   surfaceId?: string
   surfacePath?: string
   surfaceType?: OrganizationModelSurface['surfaceType']
-  featureKey?: OrganizationModelFeatureKey
+  featureId?: string
 }
 ```