@elevasis/core 0.3.0 → 0.5.0

package/src/organization-model/__tests__/resolve.test.ts

@@ -70,8 +70,8 @@ describe('organization-model', () => {
       expect(model.branding.shortName).toBe('Elevasis')
       expect(model.features).toHaveLength(7)
       expect(model.navigation.defaultSurfaceId).toBe('crm.pipeline')
-      expect(model.navigation.surfaces).toHaveLength(5)
-      expect(model.navigation.groups).toHaveLength(2)
+      expect(model.navigation.surfaces).toHaveLength(22)
+      expect(model.navigation.groups).toHaveLength(4)
     })
 
     it('preserves sibling fields when overriding a nested property', () => {

package/src/organization-model/contracts.ts

@@ -1,3 +1,14 @@
 export const PROJECTS_FEATURE_ID = 'projects' as const
 export const PROJECTS_INDEX_SURFACE_ID = 'projects.index' as const
 export const DELIVERY_PROJECTS_VIEW_CAPABILITY_ID = 'delivery.projects.view' as const
+
+export const CRM_FEATURE_ID = 'crm' as const
+export const LEAD_GEN_FEATURE_ID = 'lead-gen' as const
+export const OPERATIONS_FEATURE_ID = 'operations' as const
+export const MONITORING_FEATURE_ID = 'monitoring' as const
+export const SETTINGS_FEATURE_ID = 'settings' as const
+export const SEO_FEATURE_ID = 'seo' as const
+
+export const CRM_PIPELINE_SURFACE_ID = 'crm.pipeline' as const
+export const LEAD_GEN_LISTS_SURFACE_ID = 'lead-gen.lists' as const
+export const OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID = 'operations.organization-graph' as const

package/src/organization-model/defaults.ts

@@ -1,8 +1,17 @@
 import type { OrganizationModel } from './types'
 import {
+  CRM_FEATURE_ID,
+  CRM_PIPELINE_SURFACE_ID,
   DELIVERY_PROJECTS_VIEW_CAPABILITY_ID,
+  LEAD_GEN_FEATURE_ID,
+  LEAD_GEN_LISTS_SURFACE_ID,
+  MONITORING_FEATURE_ID,
+  OPERATIONS_FEATURE_ID,
+  OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
   PROJECTS_FEATURE_ID,
-  PROJECTS_INDEX_SURFACE_ID
+  PROJECTS_INDEX_SURFACE_ID,
+  SETTINGS_FEATURE_ID,
+  SEO_FEATURE_ID
 } from './contracts'
 import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from './domains/branding'
 import { DEFAULT_ORGANIZATION_MODEL_CRM } from './domains/crm'
@@ -14,24 +23,24 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
   version: 1,
   features: [
     {
-      id: 'crm',
+      id: CRM_FEATURE_ID,
       label: 'CRM',
       description: 'Relationship pipeline and deal management',
       enabled: true,
       color: 'blue',
       entityIds: ['crm.deal'],
-      surfaceIds: ['crm.pipeline'],
+      surfaceIds: [CRM_PIPELINE_SURFACE_ID],
       resourceIds: [],
       capabilityIds: ['crm.pipeline.manage']
     },
     {
-      id: 'lead-gen',
+      id: LEAD_GEN_FEATURE_ID,
       label: 'Lead Gen',
       description: 'Prospecting, qualification, and outreach preparation',
       enabled: true,
       color: 'cyan',
       entityIds: ['leadgen.list', 'leadgen.company', 'leadgen.contact'],
-      surfaceIds: ['lead-gen.lists'],
+      surfaceIds: [LEAD_GEN_LISTS_SURFACE_ID],
       resourceIds: [],
       capabilityIds: ['leadgen.lists.manage']
     },
@@ -47,36 +56,58 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       capabilityIds: [DELIVERY_PROJECTS_VIEW_CAPABILITY_ID]
     },
     {
-      id: 'operations',
+      id: OPERATIONS_FEATURE_ID,
       label: 'Operations',
       description: 'Operational resources, topology, and orchestration visibility',
       enabled: true,
       color: 'violet',
       entityIds: [],
-      surfaceIds: ['operations.organization-graph', 'operations.command-view'],
+      surfaceIds: [
+        OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
+        'operations.command-view',
+        'operations.overview',
+        'operations.resources',
+        'operations.command-queue',
+        'operations.sessions',
+        'operations.task-scheduler'
+      ],
       resourceIds: [],
       capabilityIds: ['operations.organization-graph', 'operations.command-view']
     },
     {
-      id: 'monitoring',
+      id: MONITORING_FEATURE_ID,
       label: 'Monitoring',
       enabled: true,
       entityIds: [],
-      surfaceIds: [],
+      surfaceIds: [
+        'monitoring.activity-log',
+        'monitoring.execution-logs',
+        'monitoring.execution-health',
+        'monitoring.cost-analytics',
+        'monitoring.notifications'
+      ],
       resourceIds: [],
       capabilityIds: []
     },
     {
-      id: 'settings',
+      id: SETTINGS_FEATURE_ID,
       label: 'Settings',
       enabled: true,
       entityIds: [],
-      surfaceIds: [],
+      surfaceIds: [
+        'settings.account',
+        'settings.appearance',
+        'settings.organization',
+        'settings.credentials',
+        'settings.api-keys',
+        'settings.webhooks',
+        'settings.deployments'
+      ],
       resourceIds: [],
       capabilityIds: []
     },
     {
-      id: 'seo',
+      id: SEO_FEATURE_ID,
       label: 'SEO',
       enabled: false,
       entityIds: [],

package/src/organization-model/domains/navigation.ts

@@ -1,9 +1,5 @@
 import { z } from 'zod'
-import {
-  DELIVERY_PROJECTS_VIEW_CAPABILITY_ID,
-  PROJECTS_FEATURE_ID,
-  PROJECTS_INDEX_SURFACE_ID
-} from '../contracts'
+import { DELIVERY_PROJECTS_VIEW_CAPABILITY_ID, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from '../contracts'
 import { DescriptionSchema, IconNameSchema, LabelSchema, ModelIdSchema, PathSchema, ReferenceIdsSchema } from './shared'
 
 export const SurfaceTypeSchema = z.enum(['page', 'dashboard', 'graph', 'detail', 'list', 'settings'])
@@ -14,6 +10,7 @@ export const SurfaceDefinitionSchema = z.object({
   path: PathSchema,
   surfaceType: SurfaceTypeSchema,
   description: DescriptionSchema.optional(),
+  enabled: z.boolean().default(true),
   icon: IconNameSchema.optional(),
   featureId: ModelIdSchema.optional(),
   featureIds: ReferenceIdsSchema,
@@ -44,6 +41,7 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Pipeline',
       path: '/crm/pipeline',
       surfaceType: 'graph',
+      enabled: true,
       featureId: 'crm',
       featureIds: ['crm'],
       entityIds: ['crm.deal'],
@@ -55,6 +53,7 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Lists',
       path: '/lead-gen/lists',
       surfaceType: 'list',
+      enabled: true,
       featureId: 'lead-gen',
       featureIds: ['lead-gen'],
       entityIds: ['leadgen.list'],
@@ -66,6 +65,7 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Projects',
       path: '/projects',
       surfaceType: 'list',
+      enabled: true,
       featureId: PROJECTS_FEATURE_ID,
       featureIds: [PROJECTS_FEATURE_ID],
       entityIds: ['delivery.project'],
@@ -77,6 +77,7 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Organization Graph',
       path: '/operations/organization-graph',
       surfaceType: 'graph',
+      enabled: true,
       featureId: 'operations',
       featureIds: ['operations'],
       entityIds: [],
@@ -88,11 +89,216 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Command View',
       path: '/operations/command-view',
       surfaceType: 'graph',
+      enabled: false,
       featureId: 'operations',
       featureIds: ['operations'],
       entityIds: [],
       resourceIds: [],
       capabilityIds: ['operations.command-view']
+    },
+    {
+      id: 'operations.overview',
+      label: 'Overview',
+      path: '/operations',
+      surfaceType: 'dashboard',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.resources',
+      label: 'Resources',
+      path: '/operations/resources',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.command-queue',
+      label: 'Command Queue',
+      path: '/operations/command-queue',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.sessions',
+      label: 'Sessions',
+      path: '/operations/sessions',
+      surfaceType: 'page',
+      enabled: false,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.task-scheduler',
+      label: 'Task Scheduler',
+      path: '/operations/task-scheduler',
+      surfaceType: 'page',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.activity-log',
+      label: 'Activity Log',
+      path: '/monitoring/activity-log',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.execution-logs',
+      label: 'Execution Logs',
+      path: '/monitoring/execution-logs',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.execution-health',
+      label: 'Execution Health',
+      path: '/monitoring/execution-health',
+      surfaceType: 'dashboard',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.cost-analytics',
+      label: 'Cost Analytics',
+      path: '/monitoring/cost-analytics',
+      surfaceType: 'dashboard',
+      enabled: false,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.notifications',
+      label: 'Notifications',
+      path: '/monitoring/notifications',
+      surfaceType: 'page',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.account',
+      label: 'Account',
+      path: '/settings/account',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.appearance',
+      label: 'Appearance',
+      path: '/settings/appearance',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.organization',
+      label: 'Organization',
+      path: '/settings/organization',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.credentials',
+      label: 'Credentials',
+      path: '/settings/credentials',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.api-keys',
+      label: 'API Keys',
+      path: '/settings/api-keys',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.webhooks',
+      label: 'Webhooks',
+      path: '/settings/webhooks',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.deployments',
+      label: 'Deployments',
+      path: '/settings/deployments',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
     }
   ],
   groups: [
@@ -106,7 +312,41 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       id: 'primary-operations',
       label: 'Operations',
       placement: 'primary',
-      surfaceIds: ['operations.organization-graph', 'operations.command-view']
+      surfaceIds: [
+        'operations.organization-graph',
+        'operations.command-view',
+        'operations.overview',
+        'operations.resources',
+        'operations.command-queue',
+        'operations.sessions',
+        'operations.task-scheduler'
+      ]
+    },
+    {
+      id: 'primary-monitoring',
+      label: 'Monitoring',
+      placement: 'primary',
+      surfaceIds: [
+        'monitoring.activity-log',
+        'monitoring.execution-logs',
+        'monitoring.execution-health',
+        'monitoring.cost-analytics',
+        'monitoring.notifications'
+      ]
+    },
+    {
+      id: 'primary-settings',
+      label: 'Settings',
+      placement: 'bottom',
+      surfaceIds: [
+        'settings.account',
+        'settings.appearance',
+        'settings.organization',
+        'settings.credentials',
+        'settings.api-keys',
+        'settings.webhooks',
+        'settings.deployments'
+      ]
     }
   ]
 }

package/src/organization-model/foundation.ts

@@ -1,6 +1,6 @@
 import { PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from './contracts'
 import { resolveOrganizationModel } from './resolve'
-import type { OrganizationModel, OrganizationModelSurface } from './types'
+import type { DeepPartial, OrganizationModel, OrganizationModelSurface } from './types'
 
 export type FoundationSurfaceType = OrganizationModelSurface['surfaceType']
 
@@ -25,14 +25,14 @@ export interface FoundationBranding {
   shortName: string
 }
 
-export function createFoundationOrganizationModel(branding: FoundationBranding): {
+export function createFoundationOrganizationModel(override: DeepPartial<OrganizationModel>): {
   canonical: OrganizationModel
   model: FoundationOrganizationModel
   homeLabel: string
   quickAccessSurfaceIds: readonly string[]
   getOrganizationSurface: (surfaceId: string) => FoundationNavigationSurface | undefined
 } {
-  const canonical = resolveOrganizationModel({ branding })
+  const canonical = resolveOrganizationModel(override)
 
   function requireCoreSurface(surfaceId: string): OrganizationModelSurface {
     const surface = canonical.navigation.surfaces.find((candidate) => candidate.id === surfaceId)
@@ -60,6 +60,7 @@ export function createFoundationOrganizationModel(branding: FoundationBranding):
       label: 'Settings',
       path: '/settings/account',
       surfaceType: 'settings',
+      enabled: true,
       icon: 'settings',
       featureId: 'settings',
       featureIds: ['settings'],

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

@@ -5,7 +5,7 @@ description: Organization OS Graph layer documentation for the Cytoscape-based o
 
 ## Overview
 
-Within Organization OS, the organization graph is the dedicated **Graph** layer. It treats the organization model as the top-level ontology and bridges in Command View runtime topology so one graph can support semantic exploration and operations-oriented tracing. It is not a replacement renderer for Command View; it is a shared graph product that subsumes Command View as one operational lens.
+Within Organization OS, the organization graph is the dedicated **Graph** layer. It treats the organization model as the top-level ontology and bridges in Command View runtime topology so one graph can support semantic exploration and operations-oriented tracing. Command View is now one lens over this shared graph, not a separate live graph renderer.
 
 Graph contracts live in `@repo/core` alongside the organization model. Rendering lives in `@repo/ui` with Cytoscape.js. The command-center route is a thin wrapper over the shared page.
 
@@ -32,7 +32,7 @@ Graph types are intentionally **not** part of the published `@elevasis/core` sur
 The graph helps users:
 
 - orient themselves in the organization model
-- discover how domains, capabilities, surfaces, entities, resources, and workflows connect
+- discover how features, capabilities, surfaces, entities, resources, and workflows connect
 - trace upstream/downstream dependencies
 - understand ownership and implementation boundaries
 - assess blast radius before changing a workflow, agent, feature, or integration
@@ -46,21 +46,22 @@ The graph does not replace workflow editors, execution-run visualizers, or build
 
 The implementation uses one typed graph, not separate semantic and implementation taxonomies.
 
-- Node kinds: `organization`, `feature`, `domain`, `surface`, `entity`, `capability`, `resource`
+- Node kinds: `organization`, `feature`, `surface`, `entity`, `capability`, `resource`
 - Edge kinds: `contains`, `references`, `exposes`, `maps_to`
 - `resource` nodes carry `resourceType` metadata: `workflow`, `agent`, `trigger`, `integration`, `external`, or `human_checkpoint`
 - `references` edges may also carry `relationshipType`: `triggers`, `uses`, or `approval`
 
-This means runtime topology is represented as bridged `resource` nodes plus relationship metadata on shared edge types, rather than as a second disconnected edge/node vocabulary.
+This means runtime topology is represented as bridged `resource` nodes plus relationship metadata on shared edge types, rather than as a second disconnected edge/node vocabulary. `maps_to` is the main crossover edge: the builder emits it from organization-model resource mappings, and the UI presence helpers also treat it as topology-facing when classifying which non-resource nodes participate in runtime-adjacent views.
 
 ### Compatibility rules with the organization model
 
 - `OrganizationModelSchema` is the source of truth for semantic structure. The graph does not introduce a second ontology.
 - Graph node IDs and references reuse organization-model IDs wherever those IDs already exist.
-- `domain` nodes derive from `organizationModel.domains`.
 - `surface` nodes derive from `organizationModel.navigation.surfaces`; graph routing respects surface `path` and `defaultSurfaceId`.
 - Feature gating and labels respect `organizationModel.features.enabled` and `.labels`.
 - Implementation-resource bridging prefers `organizationModel.resourceMappings`.
+- Semantic grouping now comes from the unified `organizationModel.features` array. The builder no longer emits separate `domain` nodes.
+- Command View resource `domains` metadata is currently bridged onto `feature` references, not onto a distinct domain-node layer.
 - Graph defaults remain valid when produced by `resolveOrganizationModel()`.
 - If the graph needs a concept the model cannot express, extend the model first.
 
@@ -70,7 +71,6 @@ This means runtime topology is represented as bridged `resource` nodes plus rela
 type OrganizationGraphNodeKind =
   | 'organization'
   | 'feature'
-  | 'domain'
   | 'surface'
   | 'entity'
   | 'capability'
@@ -86,7 +86,7 @@ interface OrganizationGraph {
 }
 ```
 
-`OrganizationGraphNode` also includes optional `sourceId`, `description`, `enabled`, `featureKey`, `surfaceType`, and `resourceType`. `OrganizationGraphEdge` includes optional `label` and `relationshipType`.
+`OrganizationGraphNode` also includes optional `sourceId`, `description`, `enabled`, `featureId`, `surfaceType`, and `resourceType`. `OrganizationGraphEdge` includes optional `label` and `relationshipType`.
 
 ### Build pipeline
 
@@ -100,9 +100,9 @@ interface BuildOrganizationGraphInput {
 `buildOrganizationGraph` accepts optional topology input so the semantic graph still renders when operational bridging is sparse. The derivation flow is additive and upsert-oriented:
 
 1. Resolve the active organization model.
-2. Derive semantic nodes and edges from domains, features, surfaces, entities, capabilities, and resource mappings.
+2. Derive semantic nodes and edges from features, surfaces, entities, capabilities, and resource mappings.
 3. Upsert bridged runtime resources from Command View data into shared `resource` nodes.
-4. Merge topology relationships onto the same DTO using `references` or `maps_to` edges plus optional `relationshipType`.
+4. Bridge Command View runtime topology onto the same DTO as `references` edges between `resource` nodes, using `relationshipType` for runtime relationship labels.
 5. Hand the resulting graph to UI-level lensing, filtering, and Cytoscape projection.
 
 Keeping assembly outside the renderer keeps graph semantics testable without UI and prevents Cytoscape concepts from leaking into business logic.
@@ -110,7 +110,7 @@ Keeping assembly outside the renderer keeps graph semantics testable without UI
 ### Ownership split
 
 - `@repo/core` owns normalized node/edge types, schemas, and build/derivation helpers.
-- `@repo/ui` owns Cytoscape element conversion, layout presets, selection/hover/expansion/viewport state, detail panels, and presentation helpers.
+- `@repo/ui` owns Cytoscape element conversion, layout presets, selection state, path tracing, viewport mechanics, detail panels, and presentation helpers.
 - `apps/command-center` owns route wiring and page-level integration.
 
 ## Interaction Model
@@ -124,6 +124,8 @@ The graph ships with two lens presets in UI code:
 
 Lenses do not change the core DTO. They configure how the shared graph is initially presented.
 
+The command-view preset is intentionally narrow. It starts from topology-focused `resource` nodes so runtime traces stay readable, even though the underlying graph still contains semantic nodes and bridge edges.
+
 ### Modes
 
 - **Map mode** -- clustered for broad graph orientation
@@ -138,18 +140,13 @@ Layouts are deterministic presets, not unconstrained force simulation:
 
 ### Interactions
 
-Primary set, kept small and high-value:
+Primary set in the current shared page:
 
 - click node for detail panel
 - click edge for relationship meaning
-- hover for adjacency preview
-- search and jump to node
-- expand immediate neighbors
-- isolate selected node + N-hop neighborhood
 - switch mode
-- pin selected nodes
-- highlight shortest or most relevant path between two nodes
-- filter by node kind, domain, capability, feature, status, environment
+- highlight shortest directed paths between two visible nodes in trace mode
+- filter by node kind, topology presence, and free-text search
 
 Deferred: freeform node placement, collaborative annotations, graph editing/authoring, arbitrary canvas drawing.
 
@@ -163,13 +160,15 @@ Filter inputs:
 - `nodeKinds`
 - `topologyPresence: 'all' | 'semantic-only' | 'topology-only'`
 
-Presence is derived per node:
+Presence is derived per node in UI helpers:
 
 - `resource` nodes are `topology-only`
-- nodes with only semantic edges are `semantic-only`
-- nodes with both semantic and topology edges are treated as bridge nodes internally
+- non-resource nodes with only semantic edges are `semantic-only`
+- non-resource nodes with `maps_to` edges or runtime relationship edges alongside semantic edges are treated as `bridge` nodes internally
+
+`bridge` is an internal classification used by the filtering helpers. The public filter control only exposes `all`, `semantic-only`, and `topology-only`, so bridge nodes appear when presence is `all`.
 
-Search matches node IDs, labels, descriptions, source IDs, feature keys, surface/resource types, edge labels, edge kinds, and `relationshipType`.
+Search matches node IDs, labels, descriptions, source IDs, feature IDs, surface/resource types, edge labels, edge kinds, and `relationshipType`.
 
 The page applies `useDeferredValue()` to the active filters so graph search stays responsive while typing.
 
@@ -188,19 +187,28 @@ The graph is exposed through `ElevasisFeaturesProvider` rather than as app-local
 - The provider resolves that against `organizationModel.navigation.surfaces` and exposes the result as `organizationGraph` in context.
 - Shared UI/operations code stays manifest-driven while remaining aware of semantic organization topology.
 
+This provider bridge resolves the canonical shared graph surface, not a Command View-specific surface. Command View still has its own navigation surface (`operations.command-view`), but the live page delegates into the shared graph renderer.
+
 ## Command View Integration
 
-`CommandViewPage` now delegates to `OrganizationGraphPage` through a command-view lens preset. The lens restores high-value operational context through:
+`CommandViewPage` now delegates to `OrganizationGraphPage` through a command-view lens preset. The shared page adds command-view operational context through:
 
-- route-level execution-health cards
+- command-view summary cards rendered in `OrganizationGraphPage`
 - selection-aware resource and human-checkpoint summaries inside the shared graph detail panel
 - follow-up actions for recent executions and pending tasks inside the detail panel
-- dedicated command-view sidebar content (`Command View` labeling and node filters live in the subshell sidebar, not on the graph canvas)
+- dedicated command-view sidebar content alongside the shared graph controls
 
 Operational summary and drill-down derivation is covered by tests under `packages/ui/src/features/operations/organization-graph/__tests__/`.
 
 The detail experience is shared through `OrganizationGraphDetailPanel`, which can render both semantic context and command-view-specific follow-up sections.
 
+Keep the current seam explicit:
+
+- The graph canvas, selection model, path tracing, shared filters, and detail panel all live in `OrganizationGraphPage`.
+- `OperationsSidebarMiddle` still renders `CommandViewSidebarContent` for `/operations/command-view`.
+- That sidebar remains a companion operational panel with some legacy store/filter assumptions and is not the source of truth for the shared graph's filter state.
+- Older React Flow Command View code still exists in the repo, but it is no longer the live renderer for the current Command View route.
+
 ## Cytoscape Responsibility Split
 
 Cytoscape owns:
@@ -217,16 +225,17 @@ React owns:
 
 - mode switching
 - side panels and inspectors
-- search and command-palette entry
+- filter toolbar search and trace controls
 - route state and deep-linking
 - server data fetching
-- persistence of saved filters and views
 
 ## Package Boundary
 
 - `packages/ui/package.json` declares Cytoscape on the published UI surface.
 - `packages/ui/tsup.config.ts` and `packages/ui/rollup.dts.config.mjs` keep Cytoscape **externalized** for publish output.
-- Graph DTO types are internal to `@repo/core`. The published `@elevasis/core` wrapper still exposes only the narrow organization-model API. External graph adoption should not be assumed.
+- Graph DTO types, schemas, and builders live in monorepo `@repo/core` organization-model modules.
+- Cytoscape rendering, lens presets, filtering helpers, and detail/runtime presentation live in `@repo/ui`.
+- The published `@elevasis/core` wrapper still exposes only the narrow organization-model API; this graph contract should be treated as monorepo-internal for now.
 
 ## Theming