@elevasis/core 0.24.1 → 0.25.0

package/src/organization-model/scaffolders/scaffoldSystem.ts

@@ -0,0 +1,110 @@
+import type { OrganizationModel } from '..'
+import {
+  addProjectNextStep,
+  assertSystemPathAvailable,
+  localIdOf,
+  nextSystemOrder,
+  parentPathOf,
+  slugify,
+  titleize
+} from './helpers'
+import type { OmScaffoldPlan, SystemScaffoldSpec } from './types'
+
+export function scaffoldSystem(model: OrganizationModel, spec: SystemScaffoldSpec): OmScaffoldPlan {
+  const systemPath = spec.parent !== undefined && !spec.id.includes('.') ? `${spec.parent}.${spec.id}` : spec.id
+  assertSystemPathAvailable(model, systemPath)
+
+  const parentPath = parentPathOf(systemPath)
+  const localId = localIdOf(systemPath)
+  const label = spec.label ?? titleize(localId)
+  const roleId = spec.role ?? 'role.ops-lead'
+  const uiPath = spec.uiPath ?? `/${localId}`
+  const featureSlug = slugify(systemPath.replaceAll('.', '-'))
+  const knowledgeId = `knowledge.${featureSlug}-system-overview`
+  const order = nextSystemOrder(model, parentPath)
+  const withProject = spec.withProject ?? !spec.noProject
+
+  const systemEntry = `  ${JSON.stringify(localId)}: {
+    id: ${JSON.stringify(systemPath)},
+    order: ${order},
+    label: ${JSON.stringify(label)},
+    description: ${JSON.stringify(spec.description ?? `${label} bounded context.`)},
+    kind: ${JSON.stringify(spec.kind ?? 'operational')},
+    ${parentPath === undefined ? '' : `parentSystemId: ${JSON.stringify(parentPath)},\n    `}responsibleRoleId: ${JSON.stringify(roleId)},
+    governedByKnowledge: [${JSON.stringify(knowledgeId)}],
+    drivesGoals: [],
+    lifecycle: 'draft',
+    ui: {
+      path: ${JSON.stringify(uiPath)},
+      surfaces: [],
+      ${spec.icon === undefined ? '' : `icon: ${JSON.stringify(spec.icon)},`}
+    }${spec.withOntology ? `,
+    ontology: {
+      objectTypes: {}
+    }` : ''}
+  }`
+
+  const plan: OmScaffoldPlan = {
+    intent: 'system',
+    id: systemPath,
+    summary: `Scaffold System "${systemPath}" with nav, role wiring, governing knowledge, and a UI manifest stub.`,
+    writes: [
+      {
+        path: `packages/ui/src/features/${featureSlug}/manifest.stub.ts`,
+        mode: 'create',
+        description: 'SystemModule manifest stub. Route files are intentionally not generated.',
+        content: `import type { SystemModule } from '@repo/ui'\n\nexport const ${featureSlug.replaceAll('-', '_')}Manifest: SystemModule = {\n  systemId: ${JSON.stringify(systemPath)},\n  label: ${JSON.stringify(label)},\n  routes: []\n}\n`
+      },
+      {
+        path: `packages/elevasis-core/src/knowledge/nodes/${featureSlug}-system-overview.mdx.stub`,
+        mode: 'create',
+        description: 'Governing knowledge skeleton for the new System.',
+        content: `---\nid: ${knowledgeId}\nkind: reference\ntitle: ${JSON.stringify(`${label} System Overview`)}\nsummary: ${JSON.stringify(`Governing context for the ${label} System.`)}\nlinks:\n  - system:${systemPath}\nownerIds:\n  - ${roleId}\nupdatedAt: 2026-05-15\n---\n\n## Purpose\n\nDocument the operating boundaries, decisions, and ownership for ${label}.\n`
+      }
+    ],
+    edits: [
+      {
+        path: 'packages/elevasis-core/src/organization-model/systems.ts',
+        description:
+          parentPath === undefined
+            ? 'Add this entry to platformSystems.'
+            : `Add this entry under platformSystems ${parentPath}.systems.`,
+        snippet: systemEntry
+      },
+      {
+        path: 'packages/elevasis-core/src/organization-model/navigation.ts',
+        description: 'Confirm sidebar placement derives from ui.path or add explicit surface targeting if needed.',
+        snippet: `// System "${systemPath}" declares ui.path ${JSON.stringify(uiPath)}. Do not add route files in /om create.`
+      },
+      {
+        path: 'packages/elevasis-core/src/organization-model/roles.ts',
+        description: `Confirm ${roleId} exists or add the owning role before merging.`,
+        snippet: `// responsibleRoleId: ${JSON.stringify(roleId)}`
+      },
+      {
+        path: 'packages/elevasis-core/src/organization-model/assembly.ts',
+        description: 'Confirm roleFor()/owner routing covers the new System.',
+        snippet: `case ${JSON.stringify(systemPath)}:\n  return ${JSON.stringify(roleId)}`
+      },
+      {
+        path: 'packages/elevasis-core/src/organization-model/knowledge.ts',
+        description: 'Register the generated governing knowledge node after replacing the .stub suffix.',
+        snippet: `${JSON.stringify(knowledgeId)}`
+      }
+    ],
+    warnings: spec.withOntology
+      ? ['Ontology was requested; the default objectTypes block is intentionally empty until the domain language is known.']
+      : ['Ontology is opt-in. Re-run with --with-ontology when the object/action/catalog language is known.'],
+    nextSteps: [
+      'Review the planned OM edits and apply them in the listed source files.',
+      'Replace .stub suffixes only after the System entry is merged.',
+      `Run pnpm exec elevasis om:verify --scope ${systemPath}.`
+    ]
+  }
+
+  return addProjectNextStep(
+    plan,
+    withProject,
+    `pnpm exec elevasis project:create --link-om ${systemPath} --title "Build ${label} System" --kind system-build`
+  )
+}

package/src/organization-model/scaffolders/types.ts

@@ -0,0 +1,81 @@
+import type {
+  OrganizationModelIconToken,
+  OrganizationModelResourceKind,
+  OrganizationModelSystemKind
+} from '../types'
+import type { OntologyKind } from '../ontology'
+
+export type OmScaffoldIntent = 'system' | 'ontology' | 'resource' | 'knowledge'
+
+export interface OmScaffoldWrite {
+  path: string
+  content: string
+  description: string
+  mode: 'create'
+}
+
+export interface OmScaffoldEdit {
+  path: string
+  description: string
+  snippet: string
+}
+
+export interface OmScaffoldPlan {
+  intent: OmScaffoldIntent
+  id: string
+  summary: string
+  writes: OmScaffoldWrite[]
+  edits: OmScaffoldEdit[]
+  warnings: string[]
+  nextSteps: string[]
+  projectCommand?: string
+}
+
+export interface BaseOmScaffoldSpec {
+  id: string
+  label?: string
+  description?: string
+}
+
+export interface SystemScaffoldSpec extends BaseOmScaffoldSpec {
+  intent: 'system'
+  parent?: string
+  kind?: OrganizationModelSystemKind
+  uiPath?: string
+  icon?: OrganizationModelIconToken
+  role?: string
+  withOntology?: boolean
+  noProject?: boolean
+  withProject?: boolean
+}
+
+export interface OntologyRecordScaffoldSpec extends BaseOmScaffoldSpec {
+  intent: 'ontology'
+  systemPath: string
+  kind: OntologyKind
+  localId?: string
+  withProject?: boolean
+}
+
+export interface ResourceScaffoldSpec extends BaseOmScaffoldSpec {
+  intent: 'resource'
+  systemPath: string
+  kind?: OrganizationModelResourceKind
+  ownerRoleId?: string
+  withStubWorkflow?: boolean
+  withProject?: boolean
+}
+
+export interface KnowledgeNodeScaffoldSpec extends BaseOmScaffoldSpec {
+  intent: 'knowledge'
+  systemPath?: string
+  kind?: 'playbook' | 'strategy' | 'reference'
+  ownerRoleId?: string
+  withProject?: boolean
+}
+
+export type OmScaffoldSpec =
+  | SystemScaffoldSpec
+  | OntologyRecordScaffoldSpec
+  | ResourceScaffoldSpec
+  | KnowledgeNodeScaffoldSpec

package/src/platform/constants/versions.ts

@@ -1,3 +1,3 @@
 export const VERSION = {
-  CURRENT: '1.9.2'
+  CURRENT: '1.10.2'
 }

package/src/reference/_generated/contracts.md

@@ -634,8 +634,8 @@ export type DeepPartial<T> =
 ### `ElevasisOrganizationModel`
 
 ```typescript
-export type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
-  knowledge?: OrganizationModel['knowledge']
+export type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
+  knowledge?: OrganizationModel['knowledge']
 }
 ```
 
@@ -660,107 +660,107 @@ export type SystemSidebarWidthResolver = number | ((context: { currentPath: stri
 ### `SystemModule`
 
 ```typescript
-export interface SystemModule {
-  /** Unique stable identifier for this UI system module. */
-  key: string
-  /** Organization Model system id this module presents. Omit for navigation-only app surfaces. */
-  systemId?: string
-  /** Route prefixes owned by navigation-only app surfaces. */
-  routePrefixes?: string[]
-  /** Capability identifiers contributed by this system module. */
-  capabilityIds?: string[]
-  /** Icon used when this system node appears in shell navigation. */
-  icon?: SystemIconComponent
-  /** Sidebar component rendered when this system's subtree route is active. */
-  sidebar?: SystemSidebarComponent
-  /** Optional shell sidebar width override. Defaults to 250px. */
-  sidebarWidth?: SystemSidebarWidthResolver
-  /** Operations-only bridge connecting this system to the organization graph node. */
-  organizationGraph?: OrganizationGraphSystemBridge
+export interface SystemModule {
+  /** Unique stable identifier for this UI system module. */
+  key: string
+  /** Organization Model system id this module presents. Omit for navigation-only app surfaces. */
+  systemId?: string
+  /** Route prefixes owned by navigation-only app surfaces. */
+  routePrefixes?: string[]
+  /** Capability identifiers contributed by this system module. */
+  capabilityIds?: string[]
+  /** Icon used when this system node appears in shell navigation. */
+  icon?: SystemIconComponent
+  /** Sidebar component rendered when this system's subtree route is active. */
+  sidebar?: SystemSidebarComponent
+  /** Optional shell sidebar width override. Defaults to 250px. */
+  sidebarWidth?: SystemSidebarWidthResolver
+  /** Operations-only bridge connecting this system to the organization graph node. */
+  organizationGraph?: OrganizationGraphSystemBridge
 }
 ```
 
 ### `ResolvedSystemAccess`
 
 ```typescript
-export interface ResolvedSystemAccess {
-  featureKey: string
-  systemId?: string
-  enabled: boolean
+export interface ResolvedSystemAccess {
+  systemKey: string
+  systemId?: string
+  enabled: boolean
 }
 ```
 
 ### `ResolvedSystemSemantics`
 
 ```typescript
-export interface ResolvedSystemSemantics {
-  capabilityIds: string[]
+export interface ResolvedSystemSemantics {
+  capabilityIds: string[]
 }
 ```
 
 ### `ResolvedSystemModule`
 
 ```typescript
-export interface ResolvedSystemModule extends SystemModule {
-  access: ResolvedSystemAccess
-  semantics: ResolvedSystemSemantics
+export interface ResolvedSystemModule extends SystemModule {
+  access: ResolvedSystemAccess
+  semantics: ResolvedSystemSemantics
 }
 ```
 
 ### `ResolvedShellSystem`
 
 ```typescript
-export type ResolvedShellSystem = OrganizationModelSystemEntry & {
-  label: string
-  iconComponent?: SystemIconComponent
+export type ResolvedShellSystem = OrganizationModelSystemEntry & {
+  label: string
+  iconComponent?: SystemIconComponent
 }
 ```
 
 ### `ResolvedShellModel`
 
 ```typescript
-export interface ResolvedShellModel {
-  systems: readonly ResolvedShellSystem[]
-  findByPath: (path: string) => ResolvedShellSystem | undefined
-  findById: (id: string) => ResolvedShellSystem | undefined
-  childrenOf: (id: string) => ResolvedShellSystem[]
-  ancestorsOf: (id: string) => ResolvedShellSystem[]
-  parentOf: (id: string) => ResolvedShellSystem | undefined
-  topLevel: () => ResolvedShellSystem[]
-  requiresAdminFor: (id: string) => boolean
-  devOnlyFor: (id: string) => boolean
+export interface ResolvedShellModel {
+  systems: readonly ResolvedShellSystem[]
+  findByPath: (path: string) => ResolvedShellSystem | undefined
+  findById: (id: string) => ResolvedShellSystem | undefined
+  childrenOf: (id: string) => ResolvedShellSystem[]
+  ancestorsOf: (id: string) => ResolvedShellSystem[]
+  parentOf: (id: string) => ResolvedShellSystem | undefined
+  topLevel: () => ResolvedShellSystem[]
+  requiresAdminFor: (id: string) => boolean
+  devOnlyFor: (id: string) => boolean
 }
 ```
 
 ### `ShellSidebarLinkItem`
 
 ```typescript
-export interface ShellSidebarLinkItem {
-  label: string
-  link: string
-  exact?: boolean
-  activeMatchPaths?: string[]
+export interface ShellSidebarLinkItem {
+  label: string
+  link: string
+  exact?: boolean
+  activeMatchPaths?: string[]
 }
 ```
 
 ### `ShellSidebarLinkGroup`
 
 ```typescript
-export interface ShellSidebarLinkGroup {
-  icon: SystemIconComponent
-  label: string
-  links?: ShellSidebarLinkItem[]
-  link?: string
+export interface ShellSidebarLinkGroup {
+  icon: SystemIconComponent
+  label: string
+  links?: ShellSidebarLinkItem[]
+  link?: string
 }
 ```
 
 ### `ShellSidebarProjectionOptions`
 
 ```typescript
-export interface ShellSidebarProjectionOptions {
-  isPlatformAdmin?: boolean
-  isDev?: boolean
-  section?: 'primary' | 'bottom'
+export interface ShellSidebarProjectionOptions {
+  isPlatformAdmin?: boolean
+  isDev?: boolean
+  section?: 'primary' | 'bottom'
 }
 ```
 
@@ -773,75 +773,75 @@ export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
 ### `ResolvedShellRouteMatch`
 
 ```typescript
-export interface ResolvedShellRouteMatch {
-  status: ShellRouteMatchStatus
-  path: string
-  system?: ResolvedSystemModule
-  node?: ResolvedShellSystem
+export interface ResolvedShellRouteMatch {
+  status: ShellRouteMatchStatus
+  path: string
+  system?: ResolvedSystemModule
+  node?: ResolvedShellSystem
 }
 ```
 
 ### `ShellRuntime`
 
 ```typescript
-export interface ShellRuntime {
-  resolveRoute: (path: string) => ResolvedShellRouteMatch
+export interface ShellRuntime {
+  resolveRoute: (path: string) => ResolvedShellRouteMatch
 }
 ```
 
 ### `OrganizationGraphSystemBridge`
 
 ```typescript
-export interface OrganizationGraphSystemBridge {
-  systemId?: string
+export interface OrganizationGraphSystemBridge {
+  systemId?: string
 }
 ```
 
 ### `OrganizationGraphContextValue`
 
 ```typescript
-export interface OrganizationGraphContextValue {
-  available: boolean
-  systemId?: string
-  systemPath?: string
+export interface OrganizationGraphContextValue {
+  available: boolean
+  systemId?: string
+  systemPath?: string
 }
 ```
 
 ### `ElevasisSystemsProviderProps`
 
 ```typescript
-export interface ElevasisSystemsProviderProps {
-  systems?: SystemModule[]
-  organizationModel?: ElevasisOrganizationModel
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths?: string[]
-  children: ReactNode
+export interface ElevasisSystemsProviderProps {
+  systems?: SystemModule[]
+  organizationModel?: ElevasisOrganizationModel
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths?: string[]
+  children: ReactNode
 }
 ```
 
 ### `ElevasisSystemsContextValue`
 
 ```typescript
-export interface ElevasisSystemsContextValue {
-  shellModel: ResolvedShellModel
-  shellRuntime: ShellRuntime
-  getSidebarLinks: (options?: ShellSidebarProjectionOptions) => ShellSidebarLinkGroup[]
-  enabledResolvedSystems: ResolvedSystemModule[]
-  resolvedSystems: ResolvedSystemModule[]
-  organizationGraph: OrganizationGraphContextValue
-  organizationModel?: OrganizationModel
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths: string[]
-  isSystemEnabled: (key: string) => boolean
-  getResolvedSystem: (key: string) => ResolvedSystemModule | undefined
+export interface ElevasisSystemsContextValue {
+  shellModel: ResolvedShellModel
+  shellRuntime: ShellRuntime
+  getSidebarLinks: (options?: ShellSidebarProjectionOptions) => ShellSidebarLinkGroup[]
+  enabledResolvedSystems: ResolvedSystemModule[]
+  resolvedSystems: ResolvedSystemModule[]
+  organizationGraph: OrganizationGraphContextValue
+  organizationModel?: OrganizationModel
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths: string[]
+  isSystemEnabled: (key: string) => boolean
+  getResolvedSystem: (key: string) => ResolvedSystemModule | undefined
 }
 ```
 

package/src/reference/glossary.md

@@ -1,76 +1,78 @@
----
-title: Glossary
-description: Terminology disambiguation for Organization OS concepts used in the template scaffold, core package, and published packages.
----
-
-# Glossary
-
-## Terms
-
-**AdminGuard** -- route-level admin wrapper from `@elevasis/ui/features/auth`. Must nest inside `ProtectedRoute`.
-
-**Contract** -- the publishable boundary a consumer depends on: Zod schemas, TypeScript types, provider props, resource definitions, or workflow I/O schemas.
-
-**DeploymentSpec** -- runtime/deploy assembly for one organization: workflows, agents, triggers, integrations, relationships, external resources, and human checkpoints. It assembles executable behavior around Organization Model resource descriptors; it is not the source of resource identity.
-
-**Feature** -- legacy or UI-package wording for a platform capability area. In the current Organization Model, use **System** for semantic ownership and **navigation surface** for shell placement. Keep "feature" only when referring to existing UI package folders, exported manifest names, or legacy compatibility recipes.
-
-**SystemGuard** -- route-level System gate from `@elevasis/ui/features/auth`.
-
+---
+title: Glossary
+description: Terminology disambiguation for Organization OS concepts used in the template scaffold, core package, and published packages.
+---
+
+# Glossary
+
+## Terms
+
+**AdminGuard** -- route-level admin wrapper from `@elevasis/ui/features/auth`. Must nest inside `ProtectedRoute`.
+
+**Contract** -- the publishable boundary a consumer depends on: Zod schemas, TypeScript types, provider props, resource definitions, or workflow I/O schemas.
+
+**DeploymentSpec** -- runtime/deploy assembly for one organization: workflows, agents, triggers, integrations, relationships, external resources, and human checkpoints. It assembles executable behavior around Organization Model resource descriptors; it is not the source of resource identity.
+
+**Feature** -- legacy or UI-package wording for a platform capability area. In the current Organization Model, use **System** for semantic ownership and **navigation surface** for shell placement. Keep "feature" only when referring to existing UI package folders, exported manifest names, or legacy compatibility recipes.
+
+**SystemGuard** -- route-level System gate from `@elevasis/ui/features/auth`.
+
 **SystemModule** -- manifest contract a shell module provides to `ElevasisSystemsProvider`. Key fields are `key`, optional `systemId`, optional `routePrefixes`, optional `capabilityIds`, optional `icon`, optional `sidebar`, and optional `sidebarWidth`. Graph bridge metadata is compatibility-only; new semantic bindings belong in the Organization Model System, ontology, navigation, and Resource descriptors.
-
-**systemId** -- the `SystemModule` field that points to an `OrganizationModel.systems` entry. Navigation-only app modules may omit it and use route prefixes/surface metadata instead.
-
-**Foundations** -- local adapter layer in external projects that exports `canonicalOrganizationModel`, `organizationModel`, and workflow I/O schemas.
-
-**Graph node ID** -- kind-prefixed cross-collection identifier such as `system:sales.crm`, `integration:instantly`, or `resource:lead-import`.
-
-**Manifest** -- a runtime declaration for a feature or resource collection.
-
+
+**systemId** -- the `SystemModule` field that points to an `OrganizationModel.systems` entry. Navigation-only app modules may omit it and use route prefixes/surface metadata instead.
+
+**systemId (resource — deprecated)** -- the legacy `resource.systemId` field on Organization Model resource descriptors. Removed from the target contract; the canonical attachment is **`resource.systemPath`** (dot-separated path resolved against the system tree). Some external templates still ship a `systemId` compatibility mirror while published `@elevasis/core` releases catch up; treat that field as legacy adapter data only and author new resource relationships against `systemPath`. Query with `getResourcesForSystem(model, path)`.
+
+**Foundations** -- local adapter layer in external projects that exports `canonicalOrganizationModel`, `organizationModel`, and workflow I/O schemas.
+
+**Graph node ID** -- kind-prefixed cross-collection identifier such as `system:sales.crm`, `integration:instantly`, or `resource:lead-import`.
+
+**Manifest** -- a runtime declaration for a feature or resource collection.
+
 **MembershipFeatureConfig** -- legacy per-member feature override config. Current System visibility should be authored through Organization Model System lifecycle/access metadata and resolved through provider compatibility layers for older consumers.
-
+
 **OrganizationModel** -- top-level semantic contract for an organization. Current primary fields include `version`, `domainMetadata`, `branding`, `navigation`, `ontology`, `systems`, `resources`, `topology`, `identity`, `customers`, `offerings`, `roles`, `goals`, `policies`, `statuses`, and `knowledge`. Legacy domain keys such as `sales`, `prospecting`, `projects`, `actions`, and `entities` remain compatibility inputs while projects migrate to System-owned ontology/config/resource contracts.
-
+
 **OrganizationModelSystemEntry** -- System node in `OrganizationModel.systems`. Primary authoring fields include `id`, `label`, `description`, `parentSystemId`, `systems`, `lifecycle`, `ui`, `requiresAdmin`, `devOnly`, `responsibleRoleId`, `governedByKnowledge`, `drivesGoals`, `actions`, `policies`, `ontology`, `config`, and `order`. `subsystems` and `content` are retained compatibility inputs for older projects and should not be used for new recursive Systems, schemas, catalogs, or config.
-
-**Provider / ElevasisSystemsProvider** -- runtime that registers System modules, resolves System access against the org model, projects sidebar navigation, and exposes shell helpers through `useElevasisSystems()`.
-
-**Resource** -- governance-only descriptor in `OrganizationModel.resources` for a workflow, agent, integration, or script. Runtime code derives `resourceId` and kind from the descriptor, then attaches executable behavior in operations.
-
+
+**Provider / ElevasisSystemsProvider** -- runtime that registers System modules, resolves System access against the org model, projects sidebar navigation, and exposes shell helpers through `useElevasisSystems()`.
+
+**Resource** -- governance-only descriptor in `OrganizationModel.resources` for a workflow, agent, integration, or script. Runtime code derives `resourceId` and kind from the descriptor, then attaches executable behavior in operations.
+
 **Resource descriptor** -- OM entry with canonical `id`, required `systemPath`, descriptor `title` / `description`, governance `status`, optional role ownership, `codeRefs`, and nested `ontology` bindings for `actions`, optional `primaryAction`, read/write objects, used catalogs, and emitted events. Top-level `emits` remains a compatibility mirror for older descriptors.
-
+
 **System** -- tenant-defined bounded context in `OrganizationModel.systems` that groups operational resources and carries governance metadata such as responsible role, governing knowledge, driven goals, kind, lifecycle, System-local ontology, and System-local config.
-
-**ResourceCategory** -- resource metadata category: `production`, `diagnostic`, `internal`, or `testing`.
-
-**ResourceLink** -- graph binding on resource metadata: `{ nodeId, kind }`.
-
-**Settings asymmetry** -- Settings is a navigation/app surface whose individual pages are normally governed by admin checks rather than user-facing System toggles.
-
-**Shell model** -- provider output used by sidebars and breadcrumbs. Includes `systems`, `childrenOf`, `ancestorsOf`, `parentOf`, `topLevel`, `findByPath`, `requiresAdminFor`, and `devOnlyFor`.
-
-**Subshell / Sidebar** -- System- or route-prefix-scoped UI region rendered when the current route matches a module whose manifest supplies a sidebar.
-
+
+**ResourceCategory** -- resource metadata category: `production`, `diagnostic`, `internal`, or `testing`.
+
+**ResourceLink** -- graph binding on resource metadata: `{ nodeId, kind }`.
+
+**Settings asymmetry** -- Settings is a navigation/app surface whose individual pages are normally governed by admin checks rather than user-facing System toggles.
+
+**Shell model** -- provider output used by sidebars and breadcrumbs. Includes `systems`, `childrenOf`, `ancestorsOf`, `parentOf`, `topLevel`, `findByPath`, `requiresAdminFor`, and `devOnlyFor`.
+
+**Subshell / Sidebar** -- System- or route-prefix-scoped UI region rendered when the current route matches a module whose manifest supplies a sidebar.
+
 **Topology** -- durable OM operational wiring declared in `OrganizationModel.topology.relationships`. Initial relationship kinds are `triggers`, `uses`, and `approval`; relationships use typed refs such as `{ kind: 'resource', id: 'lead-import' }`.
-
-## Package Boundary
-
-**`@elevasis/core`**
-
-- `OrganizationModel`, `OrganizationModelSystemEntry`
-- `SystemEntry`, `ResourceEntry`
-- `resolveOrganizationModel`, `defineOrganizationModel`, `DEFAULT_ORGANIZATION_MODEL`
-- `MembershipFeatureConfig`
-- `DeploymentSpec`, `ResourceLink`, `ResourceCategory`
-
-**`@elevasis/ui`**
-
-- `SystemModule`
-- `SystemGuard`, `AdminGuard`, `ProtectedRoute`
-- `ElevasisSystemsProvider`, `ElevasisCoreProvider`, `useElevasisSystems`
-
-**External project source**
-
-- `canonicalOrganizationModel`
-- `organizationModel`
-- workflow I/O schemas
+
+## Package Boundary
+
+**`@elevasis/core`**
+
+- `OrganizationModel`, `OrganizationModelSystemEntry`
+- `SystemEntry`, `ResourceEntry`
+- `resolveOrganizationModel`, `defineOrganizationModel`, `DEFAULT_ORGANIZATION_MODEL`
+- `MembershipFeatureConfig`
+- `DeploymentSpec`, `ResourceLink`, `ResourceCategory`
+
+**`@elevasis/ui`**
+
+- `SystemModule`
+- `SystemGuard`, `AdminGuard`, `ProtectedRoute`
+- `ElevasisSystemsProvider`, `ElevasisCoreProvider`, `useElevasisSystems`
+
+**External project source**
+
+- `canonicalOrganizationModel`
+- `organizationModel`
+- workflow I/O schemas