@elevasis/ui 2.40.1 → 2.41.0

package/dist/{chunk-K7GKKETO.js → chunk-FIMGOWOT.js}

@@ -1,6 +1,7 @@
-import { OntologyScopeSchema, OntologyIdSchema, DEFAULT_ONTOLOGY_SCOPE, compileOrganizationOntology, listResolvedOntologyRecords, listAllSystems, defineDomainRecord, ontologyGraphNodeId, parseOntologyId, getAllProspectingStages, getAllPipelines, getAllProjectStatuses, getLeadGenStageCatalog, getAllBuildTemplates } from './chunk-RH5VWWSC.js';
-import { IconMail, IconSend, IconFileText, IconClock, IconArrowUp, IconMessageCircle, IconRocket, IconEye, IconEdit, IconAlertTriangle, IconRefresh, IconX, IconCheck, IconShieldLock, IconActivity, IconTopologyStar3, IconApps, IconBriefcase, IconBuilding, IconBolt, IconSearch, IconChartBar, IconUsers, IconInfoCircle, IconDatabase, IconGitBranch, IconDashboard, IconBuildingStore, IconUser, IconPlug, IconBrain, IconTargetArrow, IconBook, IconLayoutGrid, IconArchive, IconSettings, IconTool, IconCalendar } from '@tabler/icons-react';
+import { OntologyScopeSchema, OntologyIdSchema, DEFAULT_ONTOLOGY_SCOPE, compileOrganizationOntology, listResolvedOntologyRecords, listAllSystems, defineDomainRecord, ontologyGraphNodeId, parseOntologyId, getAllProspectingStages, getAllPipelines, getAllProjectStatuses, getLeadGenStageCatalog, getAllBuildTemplates, devOnlyFor, requiresAdminFor, topLevel, parentOf, ancestorsOf, childrenOf, findById, findByPath, defaultPathFor } from './chunk-RH5VWWSC.js';
+import { IconMail, IconSend, IconFileText, IconClock, IconArrowUp, IconMessageCircle, IconRocket, IconEye, IconEdit, IconAlertTriangle, IconRefresh, IconX, IconCheck, IconShieldLock, IconActivity, IconTopologyStar3, IconApps, IconBriefcase, IconBuilding, IconBolt, IconSearch, IconChartBar, IconUsers, IconInfoCircle, IconMessagePlus, IconDatabase, IconGitBranch, IconDashboard, IconBuildingStore, IconUser, IconPlug, IconBrain, IconTargetArrow, IconBook, IconLayoutGrid, IconArchive, IconSettings, IconTool, IconCalendar } from '@tabler/icons-react';
 import { jsx } from 'react/jsx-runtime';
+import { createContext, useContext, useMemo, useCallback } from 'react';
 import { z } from 'zod';
 
 var DEFAULT_SEMANTIC_ICON_REGISTRY = {
@@ -44,6 +45,8 @@ var DEFAULT_SEMANTIC_ICON_REGISTRY = {
   pipeline: IconGitBranch,
   lists: IconFileText,
   resources: IconDatabase,
+  // Topbar action tokens
+  "message-plus": IconMessagePlus,
   // Actions
   approve: IconCheck,
   reject: IconX,
@@ -143,6 +146,85 @@ function SemanticIcon({
     }
   );
 }
+
+// ../core/src/organization-model/cross-ref.ts
+var ONTOLOGY_REFERENCE_KEY_KINDS = {
+  valueType: "value-type",
+  catalogType: "catalog",
+  objectType: "object",
+  eventType: "event",
+  actionType: "action",
+  linkType: "link",
+  interfaceType: "interface",
+  propertyType: "property",
+  groupType: "group",
+  surfaceType: "surface",
+  stepCatalog: "catalog"
+};
+function buildOmCrossRefIndex(model) {
+  const systemsById = /* @__PURE__ */ new Map();
+  for (const { path, system } of listAllSystems(model)) {
+    systemsById.set(path, system);
+    systemsById.set(system.id, system);
+  }
+  const resourceIds = new Set(Object.keys(model.resources ?? {}));
+  const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}));
+  const roleIds = new Set(Object.keys(model.roles ?? {}));
+  const goalIds = new Set(Object.keys(model.goals ?? {}));
+  const actionIds = new Set(Object.keys(model.actions ?? {}));
+  const customerSegmentIds = new Set(Object.keys(model.customers ?? {}));
+  const offeringIds = new Set(Object.keys(model.offerings ?? {}));
+  const ontologyCompilation = compileOrganizationOntology(model);
+  const ontologyIndexByKind = {
+    object: ontologyCompilation.ontology.objectTypes,
+    link: ontologyCompilation.ontology.linkTypes,
+    action: ontologyCompilation.ontology.actionTypes,
+    catalog: ontologyCompilation.ontology.catalogTypes,
+    event: ontologyCompilation.ontology.eventTypes,
+    interface: ontologyCompilation.ontology.interfaceTypes,
+    "value-type": ontologyCompilation.ontology.valueTypes,
+    property: ontologyCompilation.ontology.sharedProperties,
+    group: ontologyCompilation.ontology.groups,
+    surface: ontologyCompilation.ontology.surfaces
+  };
+  const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
+  const stageIds = /* @__PURE__ */ new Set();
+  for (const catalog of Object.values(ontologyCompilation.ontology.catalogTypes)) {
+    if (catalog.kind !== "stage") continue;
+    const entries = catalog.entries;
+    if (entries !== void 0) {
+      for (const stageId of Object.keys(entries)) {
+        stageIds.add(stageId);
+      }
+    }
+  }
+  return {
+    systemsById,
+    resourceIds,
+    knowledgeIds,
+    roleIds,
+    goalIds,
+    actionIds,
+    customerSegmentIds,
+    offeringIds,
+    ontologyIds,
+    ontologyIndexByKind,
+    stageIds
+  };
+}
+function knowledgeTargetExists(index, kind, id) {
+  if (kind === "system") return index.systemsById.has(id);
+  if (kind === "resource") return index.resourceIds.has(id);
+  if (kind === "knowledge") return index.knowledgeIds.has(id);
+  if (kind === "stage") return index.stageIds.has(id);
+  if (kind === "action") return index.actionIds.has(id);
+  if (kind === "role") return index.roleIds.has(id);
+  if (kind === "goal") return index.goalIds.has(id);
+  if (kind === "customer-segment") return index.customerSegmentIds.has(id);
+  if (kind === "offering") return index.offeringIds.has(id);
+  if (kind === "ontology") return index.ontologyIds.has(id);
+  return false;
+}
 var ORGANIZATION_MODEL_ICON_TOKENS = [
   // Navigation / app areas
   "dashboard",
@@ -192,6 +274,7 @@ var ORGANIZATION_MODEL_ICON_TOKENS = [
   "view",
   "launch",
   "message",
+  "message-plus",
   "escalate",
   "promote",
   "submit",
@@ -268,7 +351,325 @@ DisplayMetadataSchema.extend({
   techStack: TechStackEntrySchema.optional()
 });
 
-// ../core/src/organization-model/domains/entities.ts
+// ../core/src/organization-model/domains/branding.ts
+var OrganizationModelBrandingSchema = z.object({
+  /**
+   * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.organizationName` fall back to this field.
+   */
+  organizationName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.productName` fall back to this field.
+   */
+  productName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.shortName` fall back to this field.
+   */
+  shortName: z.string().trim().min(1).max(40),
+  /**
+   * @deprecated Prefer `identity.description`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.description` fall back to this field.
+   */
+  description: DescriptionSchema.optional(),
+  logos: z.object({
+    light: z.string().trim().min(1).max(2048).optional(),
+    dark: z.string().trim().min(1).max(2048).optional()
+  }).default({}),
+  /**
+   * Brand voice — how the organization communicates. Plain-language description
+   * of tone, register, and personality (e.g. "Direct and human — no jargon").
+   * Max 280 characters.
+   */
+  voice: z.string().trim().max(280).optional(),
+  /**
+   * Brand tagline or positioning statement — the memorable one-liner that
+   * captures the brand's promise or differentiator. Max 200 characters.
+   */
+  tagline: z.string().trim().max(200).optional(),
+  /**
+   * Core brand values — an ordered list of principles the organization stands
+   * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
+   * be a non-empty trimmed string.
+   */
+  values: z.array(z.string().trim().min(1)).optional(),
+  /**
+   * ID of the active UI theme preset from the UI theme-presets registry.
+   * The UI layer resolves this to colors and typography via `usePresetsContext()`.
+   * Free-form string — validation and fallback state are handled at the UI layer.
+   * Min 1, max 64 characters.
+   */
+  themePresetId: z.string().trim().min(1).max(64).optional()
+}).passthrough();
+var DEFAULT_ORGANIZATION_MODEL_BRANDING = {
+  organizationName: "Default Organization",
+  productName: "Organization OS",
+  shortName: "Org OS",
+  logos: {}
+};
+var SurfaceTypeSchema = z.enum(["page", "dashboard", "graph", "detail", "list", "settings"]).meta({ label: "Surface type", color: "blue" });
+var SurfaceDefinitionSchema = z.object({
+  id: ModelIdSchema,
+  label: LabelSchema,
+  path: PathSchema,
+  surfaceType: SurfaceTypeSchema,
+  description: DescriptionSchema.optional(),
+  enabled: z.boolean().default(true),
+  devOnly: z.boolean().optional(),
+  icon: IconNameSchema.optional(),
+  systemIds: z.array(ModelIdSchema.meta({ ref: "system" })).default([]),
+  entityIds: z.array(ModelIdSchema.meta({ ref: "entity" })).default([]),
+  resourceIds: z.array(ModelIdSchema.meta({ ref: "resource" })).default([]),
+  actionIds: z.array(ModelIdSchema.meta({ ref: "action" })).default([]),
+  parentId: ModelIdSchema.meta({ ref: "surface" }).optional()
+});
+var SidebarSurfaceTargetsSchema = z.object({
+  systems: z.array(ModelIdSchema.meta({ ref: "system" })).default([]).optional(),
+  entities: z.array(ModelIdSchema.meta({ ref: "entity" })).default([]).optional(),
+  resources: z.array(ModelIdSchema.meta({ ref: "resource" })).default([]).optional(),
+  actions: z.array(ModelIdSchema.meta({ ref: "action" })).default([]).optional()
+}).default({});
+var SidebarNodeSchema = z.lazy(
+  () => z.discriminatedUnion("type", [
+    z.object({
+      type: z.literal("group"),
+      label: LabelSchema,
+      description: DescriptionSchema.optional(),
+      icon: IconNameSchema.optional(),
+      order: z.number().int().optional(),
+      children: z.record(z.string(), SidebarNodeSchema).default({})
+    }),
+    z.object({
+      type: z.literal("surface"),
+      label: LabelSchema,
+      path: PathSchema,
+      surfaceType: SurfaceTypeSchema,
+      description: DescriptionSchema.optional(),
+      icon: IconNameSchema.optional(),
+      order: z.number().int().optional(),
+      targets: SidebarSurfaceTargetsSchema.optional(),
+      devOnly: z.boolean().optional(),
+      requiresAdmin: z.boolean().optional()
+    })
+  ])
+);
+var SidebarSectionSchema = z.record(z.string(), SidebarNodeSchema).default({});
+var SidebarNavigationSchema = z.object({
+  primary: SidebarSectionSchema,
+  bottom: SidebarSectionSchema
+}).default({ primary: {}, bottom: {} });
+var TopbarActionNodeSchema = z.object({
+  id: ModelIdSchema,
+  label: LabelSchema,
+  tooltip: DescriptionSchema.optional(),
+  icon: IconNameSchema.optional(),
+  order: z.number().int().optional(),
+  enabled: z.boolean().default(true),
+  devOnly: z.boolean().optional(),
+  requiresAdmin: z.boolean().optional(),
+  targets: SidebarSurfaceTargetsSchema.optional()
+});
+var TopbarSectionSchema = z.record(z.string(), TopbarActionNodeSchema).default({});
+var OrganizationModelNavigationSchema = z.object({
+  sidebar: SidebarNavigationSchema,
+  topbar: TopbarSectionSchema
+}).default({ sidebar: { primary: {}, bottom: {} }, topbar: {} });
+function getSortedSidebarEntries(nodes) {
+  return Object.entries(nodes).sort(([leftId, left], [rightId, right]) => {
+    const orderDelta = (left.order ?? Number.MAX_SAFE_INTEGER) - (right.order ?? Number.MAX_SAFE_INTEGER);
+    return orderDelta === 0 ? leftId.localeCompare(rightId) : orderDelta;
+  });
+}
+z.object({
+  id: ModelIdSchema,
+  label: LabelSchema,
+  placement: z.string().trim().min(1).max(50),
+  surfaceIds: z.array(ModelIdSchema.meta({ ref: "surface" })).default([])
+});
+var BusinessHoursDaySchema = z.object({
+  open: z.string().trim().regex(/^\d{2}:\d{2}$/, "Expected HH:MM format"),
+  close: z.string().trim().regex(/^\d{2}:\d{2}$/, "Expected HH:MM format")
+});
+var BusinessHoursSchema = z.object({
+  monday: BusinessHoursDaySchema.optional(),
+  tuesday: BusinessHoursDaySchema.optional(),
+  wednesday: BusinessHoursDaySchema.optional(),
+  thursday: BusinessHoursDaySchema.optional(),
+  friday: BusinessHoursDaySchema.optional(),
+  saturday: BusinessHoursDaySchema.optional(),
+  sunday: BusinessHoursDaySchema.optional()
+}).default({});
+var IdentityDomainSchema = z.object({
+  /** Why the organization exists — one or two plain-language sentences. */
+  mission: z.string().trim().max(1e3).default(""),
+  /** Long-term direction the organization is moving toward. */
+  vision: z.string().trim().max(1e3).default(""),
+  /** Legal registered name of the entity. */
+  legalName: z.string().trim().max(200).default(""),
+  /**
+   * Type of legal entity (e.g. "LLC", "Corporation", "Sole Proprietor",
+   * "Non-profit"). Free-form string so it covers any jurisdiction.
+   */
+  entityType: z.string().trim().max(100).default(""),
+  /**
+   * Primary jurisdiction of registration or operation
+   * (e.g. "United States – Delaware", "Canada – Ontario").
+   */
+  jurisdiction: z.string().trim().max(200).default(""),
+  /**
+   * Industry category — broad classification (e.g. "Marketing Agency",
+   * "Software / SaaS", "Professional Services").
+   */
+  industryCategory: z.string().trim().max(200).default(""),
+  /**
+   * Geographic focus — where the organization primarily operates or serves
+   * (e.g. "North America", "Global", "Southeast Asia").
+   */
+  geographicFocus: z.string().trim().max(200).default(""),
+  /**
+   * IANA timezone identifier for the organization's primary operating timezone
+   * (e.g. "America/Los_Angeles", "Europe/London", "UTC").
+   */
+  timeZone: z.string().trim().max(100).default("UTC"),
+  /** Typical operating hours per day of week. Empty object means not configured. */
+  businessHours: BusinessHoursSchema,
+  /**
+   * Long-form markdown capturing client context, problem narrative, and domain
+   * background. Populated by /setup; surfaced to agents as organizational context.
+   * Optional — many projects have no external client.
+   */
+  clientBrief: z.string().trim().default(""),
+  /**
+   * Display name of the organization as shown to end users.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.organizationName`. Falls back to `branding.organizationName` for
+   * legacy tenants that have not yet migrated.
+   */
+  organizationName: LabelSchema.optional(),
+  /**
+   * Display name of the primary product or platform.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.productName`. Falls back to `branding.productName` for legacy tenants.
+   */
+  productName: LabelSchema.optional(),
+  /**
+   * Short abbreviated name used in space-constrained UI surfaces (max 40 chars).
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.shortName`. Falls back to `branding.shortName` for legacy tenants.
+   */
+  shortName: z.string().trim().min(1).max(40).optional(),
+  /**
+   * Plain-language description of the organization for display and discovery.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.description`. Falls back to `branding.description` for legacy tenants.
+   */
+  description: DescriptionSchema.optional()
+}).passthrough();
+var DEFAULT_ORGANIZATION_MODEL_IDENTITY = {
+  mission: "",
+  vision: "",
+  legalName: "",
+  entityType: "",
+  jurisdiction: "",
+  industryCategory: "",
+  geographicFocus: "",
+  timeZone: "UTC",
+  businessHours: {},
+  clientBrief: ""
+};
+var FirmographicsSchema = z.object({
+  /** Industry vertical (e.g. "Marketing Agency", "Legal", "Real Estate"). */
+  industry: z.string().trim().max(200).optional(),
+  /**
+   * Company headcount band (e.g. "1–10", "11–50", "51–200", "200+").
+   * Free-form string to accommodate any band notation.
+   */
+  companySize: z.string().trim().max(100).optional(),
+  /**
+   * Primary geographic region the segment operates in or is targeted from
+   * (e.g. "North America", "Europe", "Global").
+   */
+  region: z.string().trim().max(200).optional()
+});
+var CustomerSegmentSchema = z.object({
+  /** Stable unique identifier for the segment (e.g. "segment-smb-agencies"). */
+  id: z.string().trim().min(1).max(100),
+  /** Domain-map iteration order. Convention: multiples of 10 (10, 20, 30, ...) to allow easy insertion. */
+  order: z.number(),
+  /** Human-readable name shown to agents and in UI (e.g. "SMB Marketing Agencies"). */
+  name: z.string().trim().max(200).default(""),
+  /** One or two sentences describing who this segment is. */
+  description: z.string().trim().max(2e3).default(""),
+  /**
+   * The primary job(s) this segment is trying to get done — the goal they hire
+   * a product/service to accomplish. Plain-language narrative or bullet list.
+   */
+  jobsToBeDone: z.string().trim().max(2e3).default(""),
+  /**
+   * Pains — frustrations, obstacles, and risks the segment experiences
+   * when trying to accomplish their jobs-to-be-done.
+   */
+  pains: z.array(z.string().trim().max(500)).default([]),
+  /**
+   * Gains — outcomes and benefits the segment desires; positive motivators
+   * beyond merely resolving pains.
+   */
+  gains: z.array(z.string().trim().max(500)).default([]),
+  /** Firmographic profile for targeting and filtering. */
+  firmographics: FirmographicsSchema.default({}),
+  /**
+   * Value proposition — one or two sentences stating why this organization's
+   * offering is uniquely suited for this segment's needs.
+   */
+  valueProp: z.string().trim().max(2e3).default("")
+});
+var CustomersDomainSchema = z.record(z.string(), CustomerSegmentSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each segment entry id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_CUSTOMERS = {};
+var PricingModelSchema = z.enum(["one-time", "subscription", "usage-based", "custom"]).meta({ label: "Pricing model", color: "green" });
+var ProductSchema = z.object({
+  /** Stable unique identifier for the product (e.g. "product-starter-plan"). */
+  id: z.string().trim().min(1).max(100),
+  /** Domain-map iteration order. Convention: multiples of 10 (10, 20, 30, ...) to allow easy insertion. */
+  order: z.number(),
+  /** Human-readable name shown to agents and in UI (e.g. "Starter Plan"). */
+  name: z.string().trim().max(200).default(""),
+  /** One or two sentences describing what this product/service delivers. */
+  description: z.string().trim().max(2e3).default(""),
+  /**
+   * How this product is priced:
+   * - "one-time" — single purchase (setup fee, project fee)
+   * - "subscription" — recurring (monthly/annual SaaS, retainer)
+   * - "usage-based" — metered by consumption (API calls, seats)
+   * - "custom" — negotiated or bespoke pricing
+   */
+  pricingModel: PricingModelSchema.default("custom"),
+  /** Base price amount (≥ 0). Currency unit defined by `currency`. */
+  price: z.number().min(0).default(0),
+  /**
+   * ISO 4217 currency code (e.g. "USD", "EUR", "GBP").
+   * Free-form string to accommodate any currency; defaults to "USD".
+   */
+  currency: z.string().trim().max(10).default("USD"),
+  /**
+   * IDs of customer segments this product targets.
+   * Each id must reference a declared `customers.segments[].id`.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   */
+  targetSegmentIds: z.array(z.string().trim().min(1)).default([]),
+  /**
+   * Optional: ID of the platform system responsible for delivering this product.
+   * When present, must reference a declared `systems.systems[].id`.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   */
+  deliveryFeatureId: z.string().trim().min(1).optional()
+});
+var OfferingsDomainSchema = z.record(z.string(), ProductSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each product entry id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_OFFERINGS = {};
 var EntityIdSchema = ModelIdSchema;
 var EntityLinkKindSchema = z.enum(["belongs-to", "has-many", "has-one", "many-to-many"]).meta({ label: "Link kind" });
 var EntityLinkSchema = z.object({
@@ -464,122 +865,33 @@ var SystemEntrySchema = z.object({
    * System-owned ontology declarations. `systems` is now the canonical child
    * key; this scope holds the object, action, catalog, link, event, and
    * shared contract records owned by this system.
-   */
-  ontology: OntologyScopeSchema.optional(),
-  /**
-   * Recursive child systems, authored via nesting (per L11).
-   * The key is the local system id; the full path is computed by joining
-   * ancestor keys with `.` (e.g. parent key `'sales'` + child key `'crm'` → `'sales.crm'`).
-   * Per Phase 4: `id` and `parentSystemId` fields will be removed in favour of
-   * position-derived paths. Both still exist on this schema for backward compat.
-   */
-  systems: z.lazy(() => z.record(z.string().trim().min(1).max(100), SystemEntrySchema)).optional(),
-  /** @deprecated Use systems. Accepted as a compatibility alias during the ontology bridge. */
-  subsystems: z.lazy(() => z.record(z.string().trim().min(1).max(100), SystemEntrySchema)).optional()
-}).strict().refine((system) => system.label !== void 0 || system.title !== void 0, {
-  path: ["label"],
-  message: "System must provide label or title"
-}).transform((system) => {
-  const normalizedSystem = system.systems !== void 0 && system.subsystems === void 0 ? { ...system, subsystems: system.systems } : system;
-  if (normalizedSystem.status === void 0) return normalizedSystem;
-  console.warn("[organization-model] System.status is deprecated; use System.lifecycle instead.");
-  return normalizedSystem.lifecycle === void 0 ? { ...normalizedSystem, lifecycle: normalizedSystem.status } : normalizedSystem;
-});
-var SystemsDomainSchema = z.record(z.string(), SystemEntrySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
-  message: "Each system entry id must match its map key"
-}).default({});
-var DEFAULT_ORGANIZATION_MODEL_SYSTEMS = {};
-var BusinessHoursDaySchema = z.object({
-  open: z.string().trim().regex(/^\d{2}:\d{2}$/, "Expected HH:MM format"),
-  close: z.string().trim().regex(/^\d{2}:\d{2}$/, "Expected HH:MM format")
-});
-var BusinessHoursSchema = z.object({
-  monday: BusinessHoursDaySchema.optional(),
-  tuesday: BusinessHoursDaySchema.optional(),
-  wednesday: BusinessHoursDaySchema.optional(),
-  thursday: BusinessHoursDaySchema.optional(),
-  friday: BusinessHoursDaySchema.optional(),
-  saturday: BusinessHoursDaySchema.optional(),
-  sunday: BusinessHoursDaySchema.optional()
-}).default({});
-var IdentityDomainSchema = z.object({
-  /** Why the organization exists — one or two plain-language sentences. */
-  mission: z.string().trim().max(1e3).default(""),
-  /** Long-term direction the organization is moving toward. */
-  vision: z.string().trim().max(1e3).default(""),
-  /** Legal registered name of the entity. */
-  legalName: z.string().trim().max(200).default(""),
-  /**
-   * Type of legal entity (e.g. "LLC", "Corporation", "Sole Proprietor",
-   * "Non-profit"). Free-form string so it covers any jurisdiction.
-   */
-  entityType: z.string().trim().max(100).default(""),
-  /**
-   * Primary jurisdiction of registration or operation
-   * (e.g. "United States – Delaware", "Canada – Ontario").
-   */
-  jurisdiction: z.string().trim().max(200).default(""),
-  /**
-   * Industry category — broad classification (e.g. "Marketing Agency",
-   * "Software / SaaS", "Professional Services").
-   */
-  industryCategory: z.string().trim().max(200).default(""),
-  /**
-   * Geographic focus — where the organization primarily operates or serves
-   * (e.g. "North America", "Global", "Southeast Asia").
-   */
-  geographicFocus: z.string().trim().max(200).default(""),
-  /**
-   * IANA timezone identifier for the organization's primary operating timezone
-   * (e.g. "America/Los_Angeles", "Europe/London", "UTC").
-   */
-  timeZone: z.string().trim().max(100).default("UTC"),
-  /** Typical operating hours per day of week. Empty object means not configured. */
-  businessHours: BusinessHoursSchema,
-  /**
-   * Long-form markdown capturing client context, problem narrative, and domain
-   * background. Populated by /setup; surfaced to agents as organizational context.
-   * Optional — many projects have no external client.
-   */
-  clientBrief: z.string().trim().default(""),
-  /**
-   * Display name of the organization as shown to end users.
-   * Recommended placement for display naming — prefer this over the deprecated
-   * `branding.organizationName`. Falls back to `branding.organizationName` for
-   * legacy tenants that have not yet migrated.
-   */
-  organizationName: LabelSchema.optional(),
-  /**
-   * Display name of the primary product or platform.
-   * Recommended placement for display naming — prefer this over the deprecated
-   * `branding.productName`. Falls back to `branding.productName` for legacy tenants.
-   */
-  productName: LabelSchema.optional(),
-  /**
-   * Short abbreviated name used in space-constrained UI surfaces (max 40 chars).
-   * Recommended placement for display naming — prefer this over the deprecated
-   * `branding.shortName`. Falls back to `branding.shortName` for legacy tenants.
-   */
-  shortName: z.string().trim().min(1).max(40).optional(),
-  /**
-   * Plain-language description of the organization for display and discovery.
-   * Recommended placement for display naming — prefer this over the deprecated
-   * `branding.description`. Falls back to `branding.description` for legacy tenants.
-   */
-  description: DescriptionSchema.optional()
-}).passthrough();
-var DEFAULT_ORGANIZATION_MODEL_IDENTITY = {
-  mission: "",
-  vision: "",
-  legalName: "",
-  entityType: "",
-  jurisdiction: "",
-  industryCategory: "",
-  geographicFocus: "",
-  timeZone: "UTC",
-  businessHours: {},
-  clientBrief: ""
-};
+   */
+  ontology: OntologyScopeSchema.optional(),
+  /**
+   * Recursive child systems, authored via nesting (per L11).
+   * The key is the local system id; the full path is computed by joining
+   * ancestor keys with `.` (e.g. parent key `'sales'` + child key `'crm'` → `'sales.crm'`).
+   * Per Phase 4: `id` and `parentSystemId` fields will be removed in favour of
+   * position-derived paths. Both still exist on this schema for backward compat.
+   */
+  systems: z.lazy(() => z.record(z.string().trim().min(1).max(100), SystemEntrySchema)).optional(),
+  /** @deprecated Use systems. Accepted as a compatibility alias during the ontology bridge. */
+  subsystems: z.lazy(() => z.record(z.string().trim().min(1).max(100), SystemEntrySchema)).optional()
+}).strict().refine((system) => system.label !== void 0 || system.title !== void 0, {
+  path: ["label"],
+  message: "System must provide label or title"
+}).transform((system) => {
+  const normalizedSystem = system.systems !== void 0 && system.subsystems === void 0 ? { ...system, subsystems: system.systems } : system;
+  if (normalizedSystem.status === void 0) return normalizedSystem;
+  console.warn("[organization-model] System.status is deprecated; use System.lifecycle instead.");
+  return normalizedSystem.lifecycle === void 0 ? { ...normalizedSystem, lifecycle: normalizedSystem.status } : normalizedSystem;
+});
+var SystemsDomainSchema = z.record(z.string(), SystemEntrySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each system entry id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_SYSTEMS = {};
+
+// ../core/src/organization-model/domains/resources.ts
 var ContractRefSchema = z.string().trim().min(1).max(500).regex(
   /^[A-Za-z0-9@](?:[A-Za-z0-9_./@-]*[A-Za-z0-9_])?\/?[A-Za-z0-9_./@-]*#[A-Za-z_$][A-Za-z0-9_$]*$/,
   "ContractRef must be in the format package/subpath#ExportName (e.g. @repo/elevasis-core/contracts/apollo-import#inputSchema)"
@@ -711,156 +1023,7 @@ function defineResources(resources) {
   );
 }
 
-// ../core/src/organization-model/contracts.ts
-var PROJECTS_VIEW_ACTION_ID = "delivery.projects.view";
-var OrganizationModelBrandingSchema = z.object({
-  /**
-   * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
-   * Legacy tenants that have not set `identity.organizationName` fall back to this field.
-   */
-  organizationName: LabelSchema,
-  /**
-   * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
-   * Legacy tenants that have not set `identity.productName` fall back to this field.
-   */
-  productName: LabelSchema,
-  /**
-   * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
-   * Legacy tenants that have not set `identity.shortName` fall back to this field.
-   */
-  shortName: z.string().trim().min(1).max(40),
-  /**
-   * @deprecated Prefer `identity.description`; branding retains it for back-compat.
-   * Legacy tenants that have not set `identity.description` fall back to this field.
-   */
-  description: DescriptionSchema.optional(),
-  logos: z.object({
-    light: z.string().trim().min(1).max(2048).optional(),
-    dark: z.string().trim().min(1).max(2048).optional()
-  }).default({}),
-  /**
-   * Brand voice — how the organization communicates. Plain-language description
-   * of tone, register, and personality (e.g. "Direct and human — no jargon").
-   * Max 280 characters.
-   */
-  voice: z.string().trim().max(280).optional(),
-  /**
-   * Brand tagline or positioning statement — the memorable one-liner that
-   * captures the brand's promise or differentiator. Max 200 characters.
-   */
-  tagline: z.string().trim().max(200).optional(),
-  /**
-   * Core brand values — an ordered list of principles the organization stands
-   * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
-   * be a non-empty trimmed string.
-   */
-  values: z.array(z.string().trim().min(1)).optional(),
-  /**
-   * ID of the active UI theme preset from the UI theme-presets registry.
-   * The UI layer resolves this to colors and typography via `usePresetsContext()`.
-   * Free-form string — validation and fallback state are handled at the UI layer.
-   * Min 1, max 64 characters.
-   */
-  themePresetId: z.string().trim().min(1).max(64).optional()
-}).passthrough();
-var DEFAULT_ORGANIZATION_MODEL_BRANDING = {
-  organizationName: "Default Organization",
-  productName: "Organization OS",
-  shortName: "Org OS",
-  logos: {}
-};
-var FirmographicsSchema = z.object({
-  /** Industry vertical (e.g. "Marketing Agency", "Legal", "Real Estate"). */
-  industry: z.string().trim().max(200).optional(),
-  /**
-   * Company headcount band (e.g. "1–10", "11–50", "51–200", "200+").
-   * Free-form string to accommodate any band notation.
-   */
-  companySize: z.string().trim().max(100).optional(),
-  /**
-   * Primary geographic region the segment operates in or is targeted from
-   * (e.g. "North America", "Europe", "Global").
-   */
-  region: z.string().trim().max(200).optional()
-});
-var CustomerSegmentSchema = z.object({
-  /** Stable unique identifier for the segment (e.g. "segment-smb-agencies"). */
-  id: z.string().trim().min(1).max(100),
-  /** Domain-map iteration order. Convention: multiples of 10 (10, 20, 30, ...) to allow easy insertion. */
-  order: z.number(),
-  /** Human-readable name shown to agents and in UI (e.g. "SMB Marketing Agencies"). */
-  name: z.string().trim().max(200).default(""),
-  /** One or two sentences describing who this segment is. */
-  description: z.string().trim().max(2e3).default(""),
-  /**
-   * The primary job(s) this segment is trying to get done — the goal they hire
-   * a product/service to accomplish. Plain-language narrative or bullet list.
-   */
-  jobsToBeDone: z.string().trim().max(2e3).default(""),
-  /**
-   * Pains — frustrations, obstacles, and risks the segment experiences
-   * when trying to accomplish their jobs-to-be-done.
-   */
-  pains: z.array(z.string().trim().max(500)).default([]),
-  /**
-   * Gains — outcomes and benefits the segment desires; positive motivators
-   * beyond merely resolving pains.
-   */
-  gains: z.array(z.string().trim().max(500)).default([]),
-  /** Firmographic profile for targeting and filtering. */
-  firmographics: FirmographicsSchema.default({}),
-  /**
-   * Value proposition — one or two sentences stating why this organization's
-   * offering is uniquely suited for this segment's needs.
-   */
-  valueProp: z.string().trim().max(2e3).default("")
-});
-var CustomersDomainSchema = z.record(z.string(), CustomerSegmentSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
-  message: "Each segment entry id must match its map key"
-}).default({});
-var DEFAULT_ORGANIZATION_MODEL_CUSTOMERS = {};
-var PricingModelSchema = z.enum(["one-time", "subscription", "usage-based", "custom"]).meta({ label: "Pricing model", color: "green" });
-var ProductSchema = z.object({
-  /** Stable unique identifier for the product (e.g. "product-starter-plan"). */
-  id: z.string().trim().min(1).max(100),
-  /** Domain-map iteration order. Convention: multiples of 10 (10, 20, 30, ...) to allow easy insertion. */
-  order: z.number(),
-  /** Human-readable name shown to agents and in UI (e.g. "Starter Plan"). */
-  name: z.string().trim().max(200).default(""),
-  /** One or two sentences describing what this product/service delivers. */
-  description: z.string().trim().max(2e3).default(""),
-  /**
-   * How this product is priced:
-   * - "one-time" — single purchase (setup fee, project fee)
-   * - "subscription" — recurring (monthly/annual SaaS, retainer)
-   * - "usage-based" — metered by consumption (API calls, seats)
-   * - "custom" — negotiated or bespoke pricing
-   */
-  pricingModel: PricingModelSchema.default("custom"),
-  /** Base price amount (≥ 0). Currency unit defined by `currency`. */
-  price: z.number().min(0).default(0),
-  /**
-   * ISO 4217 currency code (e.g. "USD", "EUR", "GBP").
-   * Free-form string to accommodate any currency; defaults to "USD".
-   */
-  currency: z.string().trim().max(10).default("USD"),
-  /**
-   * IDs of customer segments this product targets.
-   * Each id must reference a declared `customers.segments[].id`.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   */
-  targetSegmentIds: z.array(z.string().trim().min(1)).default([]),
-  /**
-   * Optional: ID of the platform system responsible for delivering this product.
-   * When present, must reference a declared `systems.systems[].id`.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   */
-  deliveryFeatureId: z.string().trim().min(1).optional()
-});
-var OfferingsDomainSchema = z.record(z.string(), ProductSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
-  message: "Each product entry id must match its map key"
-}).default({});
-var DEFAULT_ORGANIZATION_MODEL_OFFERINGS = {};
+// ../core/src/organization-model/domains/roles.ts
 var RoleIdSchema = ModelIdSchema;
 var HumanRoleHolderSchema = z.object({
   kind: z.literal("human"),
@@ -952,15 +1115,99 @@ var ObjectiveSchema = z.object({
    */
   periodEnd: z.string().regex(ISO_DATE_REGEX, "periodEnd must be an ISO date string (YYYY-MM-DD)"),
   /**
-   * List of measurable outcomes that define success for this goal.
-   * Defaults to empty array so goals can be declared before outcomes are defined.
+   * List of measurable outcomes that define success for this goal.
+   * Defaults to empty array so goals can be declared before outcomes are defined.
+   */
+  keyResults: z.array(KeyResultSchema).default([])
+});
+var GoalsDomainSchema = z.record(z.string(), ObjectiveSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each objective entry id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_GOALS = {};
+var KnowledgeTargetKindSchema = z.enum([
+  "system",
+  "resource",
+  "knowledge",
+  "stage",
+  "action",
+  "role",
+  "goal",
+  "customer-segment",
+  "offering",
+  "ontology"
+]).meta({ label: "Target kind" });
+var KnowledgeTargetRefSchema = z.object({
+  kind: KnowledgeTargetKindSchema,
+  // Ontology targets use the canonical '<scope>:<kind>/<local-id>' ontology id format.
+  // Business-logic validation of target existence is done in OrganizationModelSchema.superRefine.
+  id: z.string().trim().min(1).max(300)
+}).superRefine((target, ctx) => {
+  if (target.kind !== "ontology") return;
+  const result = OntologyIdSchema.safeParse(target.id);
+  if (!result.success) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["id"],
+      message: "Ontology knowledge targets must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>"
+    });
+  }
+});
+var LegacyKnowledgeLinkSchema = z.object({
+  nodeId: z.union([NodeIdStringSchema, z.templateLiteral(["ontology:", OntologyIdSchema])])
+}).superRefine((link, ctx) => {
+  const [kind] = link.nodeId.split(":");
+  if (!KnowledgeTargetKindSchema.safeParse(kind).success) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["nodeId"],
+      message: `Unknown knowledge target kind "${kind}"`
+    });
+  }
+});
+var CanonicalKnowledgeLinkSchema = z.object({
+  target: KnowledgeTargetRefSchema
+});
+function nodeIdFromTarget(target) {
+  return `${target.kind}:${target.id}`;
+}
+function targetFromNodeId(nodeId2) {
+  const [kind, ...idParts] = nodeId2.split(":");
+  return {
+    kind: KnowledgeTargetKindSchema.parse(kind),
+    id: idParts.join(":")
+  };
+}
+var KnowledgeLinkSchema = z.union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema]).transform((link) => {
+  const target = "target" in link ? link.target : targetFromNodeId(link.nodeId);
+  return {
+    target,
+    nodeId: nodeIdFromTarget(target)
+  };
+});
+var OrgKnowledgeKindSchema = z.enum(["playbook", "strategy", "reference"]).meta({ label: "Knowledge kind", color: "grape" });
+var OrgKnowledgeNodeSchema = z.object({
+  id: ModelIdSchema,
+  kind: OrgKnowledgeKindSchema,
+  title: z.string().trim().min(1).max(200),
+  summary: z.string().trim().min(1).max(1e3),
+  icon: IconNameSchema.optional(),
+  /** Canonical documentation URL when body content is a local summary. */
+  externalUrl: z.string().trim().url().max(500).optional(),
+  /** Optional generated source file path for local MDX-backed knowledge nodes. */
+  sourceFilePath: z.string().trim().min(1).max(500).optional(),
+  /** Raw MDX string. Phase 2 will introduce a structured block format. */
+  body: z.string().trim().min(1),
+  /**
+   * Graph links to other OM nodes this knowledge node governs.
+   * Each link emits a `governs` edge: knowledge-node -> target node.
    */
-  keyResults: z.array(KeyResultSchema).default([])
+  links: z.array(KnowledgeLinkSchema).default([]),
+  /** Role identifiers that own this knowledge node. */
+  ownerIds: z.array(RoleIdSchema.meta({ ref: "role" })).default([]),
+  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
+  updatedAt: z.string().trim().min(1).max(50)
 });
-var GoalsDomainSchema = z.record(z.string(), ObjectiveSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
-  message: "Each objective entry id must match its map key"
-}).default({});
-var DEFAULT_ORGANIZATION_MODEL_GOALS = {};
+var KnowledgeDomainSchema = z.record(ModelIdSchema, OrgKnowledgeNodeSchema).default({});
 var SecretLikeMetadataKeySchema = /(?:secret|password|passwd|token|api[-_]?key|credential|private[-_]?key)/i;
 var SecretLikeMetadataValueSchema = /(?:sk-[A-Za-z0-9_-]{12,}|pk_live_[A-Za-z0-9_-]{12,}|eyJ[A-Za-z0-9_-]{20,}|-----BEGIN (?:RSA |OPENSSH |EC )?PRIVATE KEY-----)/;
 z.enum([
@@ -1188,247 +1435,16 @@ var PolicySchema = z.object({
   actions: z.array(PolicyEffectSchema).min(1),
   appliesTo: PolicyApplicabilitySchema.default({
     systemIds: [],
-    actionIds: [],
-    resourceIds: [],
-    roleIds: []
-  }),
-  lifecycle: z.enum(["draft", "beta", "active", "deprecated", "archived"]).meta({ label: "Lifecycle", color: "teal" }).default("active")
-});
-var PoliciesDomainSchema = z.record(z.string(), PolicySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
-  message: "Each policy entry id must match its map key"
-}).default({});
-var DEFAULT_ORGANIZATION_MODEL_POLICIES = {};
-var SurfaceTypeSchema = z.enum(["page", "dashboard", "graph", "detail", "list", "settings"]).meta({ label: "Surface type", color: "blue" });
-var SurfaceDefinitionSchema = z.object({
-  id: ModelIdSchema,
-  label: LabelSchema,
-  path: PathSchema,
-  surfaceType: SurfaceTypeSchema,
-  description: DescriptionSchema.optional(),
-  enabled: z.boolean().default(true),
-  devOnly: z.boolean().optional(),
-  icon: IconNameSchema.optional(),
-  systemIds: z.array(ModelIdSchema.meta({ ref: "system" })).default([]),
-  entityIds: z.array(ModelIdSchema.meta({ ref: "entity" })).default([]),
-  resourceIds: z.array(ModelIdSchema.meta({ ref: "resource" })).default([]),
-  actionIds: z.array(ModelIdSchema.meta({ ref: "action" })).default([]),
-  parentId: ModelIdSchema.meta({ ref: "surface" }).optional()
-});
-var SidebarSurfaceTargetsSchema = z.object({
-  systems: z.array(ModelIdSchema.meta({ ref: "system" })).default([]).optional(),
-  entities: z.array(ModelIdSchema.meta({ ref: "entity" })).default([]).optional(),
-  resources: z.array(ModelIdSchema.meta({ ref: "resource" })).default([]).optional(),
-  actions: z.array(ModelIdSchema.meta({ ref: "action" })).default([]).optional()
-}).default({});
-var SidebarNodeSchema = z.lazy(
-  () => z.discriminatedUnion("type", [
-    z.object({
-      type: z.literal("group"),
-      label: LabelSchema,
-      description: DescriptionSchema.optional(),
-      icon: IconNameSchema.optional(),
-      order: z.number().int().optional(),
-      children: z.record(z.string(), SidebarNodeSchema).default({})
-    }),
-    z.object({
-      type: z.literal("surface"),
-      label: LabelSchema,
-      path: PathSchema,
-      surfaceType: SurfaceTypeSchema,
-      description: DescriptionSchema.optional(),
-      icon: IconNameSchema.optional(),
-      order: z.number().int().optional(),
-      targets: SidebarSurfaceTargetsSchema.optional(),
-      devOnly: z.boolean().optional(),
-      requiresAdmin: z.boolean().optional()
-    })
-  ])
-);
-var SidebarSectionSchema = z.record(z.string(), SidebarNodeSchema).default({});
-var SidebarNavigationSchema = z.object({
-  primary: SidebarSectionSchema,
-  bottom: SidebarSectionSchema
-}).default({ primary: {}, bottom: {} });
-var OrganizationModelNavigationSchema = z.object({
-  sidebar: SidebarNavigationSchema
-}).default({ sidebar: { primary: {}, bottom: {} } });
-function getSortedSidebarEntries(nodes) {
-  return Object.entries(nodes).sort(([leftId, left], [rightId, right]) => {
-    const orderDelta = (left.order ?? Number.MAX_SAFE_INTEGER) - (right.order ?? Number.MAX_SAFE_INTEGER);
-    return orderDelta === 0 ? leftId.localeCompare(rightId) : orderDelta;
-  });
-}
-z.object({
-  id: ModelIdSchema,
-  label: LabelSchema,
-  placement: z.string().trim().min(1).max(50),
-  surfaceIds: z.array(ModelIdSchema.meta({ ref: "surface" })).default([])
-});
-var KnowledgeTargetKindSchema = z.enum([
-  "system",
-  "resource",
-  "knowledge",
-  "stage",
-  "action",
-  "role",
-  "goal",
-  "customer-segment",
-  "offering",
-  "ontology"
-]).meta({ label: "Target kind" });
-var KnowledgeTargetRefSchema = z.object({
-  kind: KnowledgeTargetKindSchema,
-  // Ontology targets use the canonical '<scope>:<kind>/<local-id>' ontology id format.
-  // Business-logic validation of target existence is done in OrganizationModelSchema.superRefine.
-  id: z.string().trim().min(1).max(300)
-}).superRefine((target, ctx) => {
-  if (target.kind !== "ontology") return;
-  const result = OntologyIdSchema.safeParse(target.id);
-  if (!result.success) {
-    ctx.addIssue({
-      code: z.ZodIssueCode.custom,
-      path: ["id"],
-      message: "Ontology knowledge targets must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>"
-    });
-  }
-});
-var LegacyKnowledgeLinkSchema = z.object({
-  nodeId: z.union([NodeIdStringSchema, z.templateLiteral(["ontology:", OntologyIdSchema])])
-}).superRefine((link, ctx) => {
-  const [kind] = link.nodeId.split(":");
-  if (!KnowledgeTargetKindSchema.safeParse(kind).success) {
-    ctx.addIssue({
-      code: z.ZodIssueCode.custom,
-      path: ["nodeId"],
-      message: `Unknown knowledge target kind "${kind}"`
-    });
-  }
-});
-var CanonicalKnowledgeLinkSchema = z.object({
-  target: KnowledgeTargetRefSchema
-});
-function nodeIdFromTarget(target) {
-  return `${target.kind}:${target.id}`;
-}
-function targetFromNodeId(nodeId2) {
-  const [kind, ...idParts] = nodeId2.split(":");
-  return {
-    kind: KnowledgeTargetKindSchema.parse(kind),
-    id: idParts.join(":")
-  };
-}
-var KnowledgeLinkSchema = z.union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema]).transform((link) => {
-  const target = "target" in link ? link.target : targetFromNodeId(link.nodeId);
-  return {
-    target,
-    nodeId: nodeIdFromTarget(target)
-  };
-});
-var OrgKnowledgeKindSchema = z.enum(["playbook", "strategy", "reference"]).meta({ label: "Knowledge kind", color: "grape" });
-var OrgKnowledgeNodeSchema = z.object({
-  id: ModelIdSchema,
-  kind: OrgKnowledgeKindSchema,
-  title: z.string().trim().min(1).max(200),
-  summary: z.string().trim().min(1).max(1e3),
-  icon: IconNameSchema.optional(),
-  /** Canonical documentation URL when body content is a local summary. */
-  externalUrl: z.string().trim().url().max(500).optional(),
-  /** Optional generated source file path for local MDX-backed knowledge nodes. */
-  sourceFilePath: z.string().trim().min(1).max(500).optional(),
-  /** Raw MDX string. Phase 2 will introduce a structured block format. */
-  body: z.string().trim().min(1),
-  /**
-   * Graph links to other OM nodes this knowledge node governs.
-   * Each link emits a `governs` edge: knowledge-node -> target node.
-   */
-  links: z.array(KnowledgeLinkSchema).default([]),
-  /** Role identifiers that own this knowledge node. */
-  ownerIds: z.array(RoleIdSchema.meta({ ref: "role" })).default([]),
-  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
-  updatedAt: z.string().trim().min(1).max(50)
-});
-var KnowledgeDomainSchema = z.record(ModelIdSchema, OrgKnowledgeNodeSchema).default({});
-
-// ../core/src/organization-model/cross-ref.ts
-var ONTOLOGY_REFERENCE_KEY_KINDS = {
-  valueType: "value-type",
-  catalogType: "catalog",
-  objectType: "object",
-  eventType: "event",
-  actionType: "action",
-  linkType: "link",
-  interfaceType: "interface",
-  propertyType: "property",
-  groupType: "group",
-  surfaceType: "surface",
-  stepCatalog: "catalog"
-};
-function buildOmCrossRefIndex(model) {
-  const systemsById = /* @__PURE__ */ new Map();
-  for (const { path, system } of listAllSystems(model)) {
-    systemsById.set(path, system);
-    systemsById.set(system.id, system);
-  }
-  const resourceIds = new Set(Object.keys(model.resources ?? {}));
-  const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}));
-  const roleIds = new Set(Object.keys(model.roles ?? {}));
-  const goalIds = new Set(Object.keys(model.goals ?? {}));
-  const actionIds = new Set(Object.keys(model.actions ?? {}));
-  const customerSegmentIds = new Set(Object.keys(model.customers ?? {}));
-  const offeringIds = new Set(Object.keys(model.offerings ?? {}));
-  const ontologyCompilation = compileOrganizationOntology(model);
-  const ontologyIndexByKind = {
-    object: ontologyCompilation.ontology.objectTypes,
-    link: ontologyCompilation.ontology.linkTypes,
-    action: ontologyCompilation.ontology.actionTypes,
-    catalog: ontologyCompilation.ontology.catalogTypes,
-    event: ontologyCompilation.ontology.eventTypes,
-    interface: ontologyCompilation.ontology.interfaceTypes,
-    "value-type": ontologyCompilation.ontology.valueTypes,
-    property: ontologyCompilation.ontology.sharedProperties,
-    group: ontologyCompilation.ontology.groups,
-    surface: ontologyCompilation.ontology.surfaces
-  };
-  const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
-  const stageIds = /* @__PURE__ */ new Set();
-  for (const catalog of Object.values(ontologyCompilation.ontology.catalogTypes)) {
-    if (catalog.kind !== "stage") continue;
-    const entries = catalog.entries;
-    if (entries !== void 0) {
-      for (const stageId of Object.keys(entries)) {
-        stageIds.add(stageId);
-      }
-    }
-  }
-  return {
-    systemsById,
-    resourceIds,
-    knowledgeIds,
-    roleIds,
-    goalIds,
-    actionIds,
-    customerSegmentIds,
-    offeringIds,
-    ontologyIds,
-    ontologyIndexByKind,
-    stageIds
-  };
-}
-function knowledgeTargetExists(index, kind, id) {
-  if (kind === "system") return index.systemsById.has(id);
-  if (kind === "resource") return index.resourceIds.has(id);
-  if (kind === "knowledge") return index.knowledgeIds.has(id);
-  if (kind === "stage") return index.stageIds.has(id);
-  if (kind === "action") return index.actionIds.has(id);
-  if (kind === "role") return index.roleIds.has(id);
-  if (kind === "goal") return index.goalIds.has(id);
-  if (kind === "customer-segment") return index.customerSegmentIds.has(id);
-  if (kind === "offering") return index.offeringIds.has(id);
-  if (kind === "ontology") return index.ontologyIds.has(id);
-  return false;
-}
-
-// ../core/src/organization-model/schema-refinements.ts
+    actionIds: [],
+    resourceIds: [],
+    roleIds: []
+  }),
+  lifecycle: z.enum(["draft", "beta", "active", "deprecated", "archived"]).meta({ label: "Lifecycle", color: "teal" }).default("active")
+});
+var PoliciesDomainSchema = z.record(z.string(), PolicySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each policy entry id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_POLICIES = {};
 function addIssue(ctx, path, message) {
   ctx.addIssue({
     code: z.ZodIssueCode.custom,
@@ -1533,7 +1549,7 @@ function refineOrganizationModel(model, ctx) {
       currentParentId = systemsById.get(currentParentId)?.parentSystemId;
     }
   });
-  function normalizeRoutePath(path) {
+  function normalizeRoutePath2(path) {
     return path.length > 1 ? path.replace(/\/+$/, "") : path;
   }
   const sidebarNodeIds = /* @__PURE__ */ new Map();
@@ -1553,7 +1569,7 @@ function refineOrganizationModel(model, ctx) {
         return;
       }
       sidebarSurfaces.push({ id: nodeId2, node, path: nodePath });
-      const normalizedPath = normalizeRoutePath(node.path);
+      const normalizedPath = normalizeRoutePath2(node.path);
       const existingSurfaceId = sidebarSurfacePaths.get(normalizedPath);
       if (existingSurfaceId !== void 0) {
         addIssue(
@@ -1882,22 +1898,22 @@ function refineOrganizationModel(model, ctx) {
       );
     }
   });
-  allSystems.forEach(({ path: systemPath, schemaPath, system }) => {
+  allSystems.forEach(({ path: systemPath2, schemaPath, system }) => {
     system.apiInterface?.resourceIds?.forEach((resourceId, resourceIndex) => {
       const resource = resourcesById.get(resourceId);
       if (resource === void 0) {
         addIssue(
           ctx,
           [...schemaPath, "apiInterface", "resourceIds", resourceIndex],
-          `System Interface "${systemPath}/api" scopes unknown resource "${resourceId}"`
+          `System Interface "${systemPath2}/api" scopes unknown resource "${resourceId}"`
         );
         return;
       }
-      if (resource.systemPath !== systemPath) {
+      if (resource.systemPath !== systemPath2) {
         addIssue(
           ctx,
           [...schemaPath, "apiInterface", "resourceIds", resourceIndex],
-          `System Interface "${systemPath}/api" scopes resource "${resourceId}" from system "${resource.systemPath}"`
+          `System Interface "${systemPath2}/api" scopes resource "${resourceId}" from system "${resource.systemPath}"`
         );
       }
     });
@@ -2054,6 +2070,9 @@ var OrganizationModelSchemaBase = z.object({
 });
 var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine(refineOrganizationModel);
 
+// ../core/src/organization-model/contracts.ts
+var PROJECTS_VIEW_ACTION_ID = "delivery.projects.view";
+
 // ../core/src/organization-model/defaults.ts
 var DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE = {};
 var DEFAULT_ORGANIZATION_MODEL_ENTITIES = {};
@@ -2061,7 +2080,8 @@ var DEFAULT_ORGANIZATION_MODEL_NAVIGATION = {
   sidebar: {
     primary: {},
     bottom: {}
-  }
+  },
+  topbar: {}
 };
 var DEFAULT_ORGANIZATION_MODEL = {
   version: 1,
@@ -2146,6 +2166,87 @@ function resolveOrganizationModel(override, organizationIdOrOptions, options) {
   const merged = mergeDefaults ? deepMerge(DEFAULT_ORGANIZATION_MODEL, override) : override ?? {};
   return OrganizationModelSchema.parse(merged);
 }
+
+// ../core/src/organization-model/surface-projection.ts
+function collectSystemsById(model) {
+  const systemsById = /* @__PURE__ */ new Map();
+  for (const { path, system } of listAllSystems(model)) {
+    systemsById.set(path, system);
+    systemsById.set(system.id, system);
+  }
+  return systemsById;
+}
+function getSystemWithAncestors(systemsById, systemId) {
+  const systems = [];
+  let current = systemsById.get(systemId);
+  while (current !== void 0) {
+    systems.unshift(current);
+    current = current.parentSystemId ? systemsById.get(current.parentSystemId) : void 0;
+  }
+  return systems;
+}
+function hasInheritedFlag(systemsById, systemIds, flag) {
+  return systemIds.some(
+    (systemId) => getSystemWithAncestors(systemsById, systemId).some((system) => system[flag] === true)
+  );
+}
+function isLifecycleEnabled2(system) {
+  if (system.enabled === false) return false;
+  return system.lifecycle !== "deprecated" && system.lifecycle !== "archived";
+}
+function isLifecycleDevOnly(system) {
+  return system.devOnly === true || system.lifecycle === "beta";
+}
+function isSystemEnabled(systemsById, systemId) {
+  const systemLineage = getSystemWithAncestors(systemsById, systemId);
+  return systemLineage.length > 0 && systemLineage.every(isLifecycleEnabled2);
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+function collectSidebarSurfaces(nodes, schemaPath, surfaces = []) {
+  getSortedSidebarEntries(nodes).forEach(([id, node]) => {
+    const nodePath = [...schemaPath, id];
+    if (node.type === "group") {
+      collectSidebarSurfaces(node.children, [...nodePath, "children"], surfaces);
+      return;
+    }
+    surfaces.push({ id, surface: node, path: nodePath });
+  });
+  return surfaces;
+}
+function getSidebarSurfaces(model) {
+  return [
+    ...collectSidebarSurfaces(model.navigation.sidebar.primary, ["navigation", "sidebar", "primary"]),
+    ...collectSidebarSurfaces(model.navigation.sidebar.bottom, ["navigation", "sidebar", "bottom"])
+  ];
+}
+function projectOrganizationSurfaces(model) {
+  const systemsById = collectSystemsById(model);
+  return getSidebarSurfaces(model).map(({ id, surface }) => {
+    const targets = surface.targets ?? {};
+    const systemIds = unique((targets.systems ?? []).filter((systemId) => systemsById.has(systemId)));
+    const enabled = systemIds.every((candidate) => isSystemEnabled(systemsById, candidate));
+    const devOnly = surface.devOnly === true || hasInheritedFlag(systemsById, systemIds, "devOnly") || systemIds.some((candidate) => getSystemWithAncestors(systemsById, candidate).some(isLifecycleDevOnly));
+    const requiresAdmin = hasInheritedFlag(systemsById, systemIds, "requiresAdmin");
+    return {
+      id,
+      label: surface.label,
+      path: surface.path,
+      surfaceType: surface.surfaceType,
+      ...surface.description !== void 0 ? { description: surface.description } : {},
+      ...surface.icon !== void 0 ? { icon: surface.icon } : {},
+      ...surface.order !== void 0 ? { order: surface.order } : {},
+      systemIds,
+      entityIds: [...targets.entities ?? []],
+      resourceIds: [...targets.resources ?? []],
+      actionIds: [...targets.actions ?? []],
+      enabled,
+      ...devOnly ? { devOnly } : {},
+      ...surface.requiresAdmin === true || requiresAdmin ? { requiresAdmin: true } : {}
+    };
+  });
+}
 var OrganizationGraphNodeKindSchema = z.enum([
   "organization",
   "system",
@@ -3073,85 +3174,471 @@ function buildOrganizationGraph(input) {
   return OrganizationGraphSchema.parse(graph);
 }
 
-// ../core/src/organization-model/surface-projection.ts
-function collectSystemsById(model) {
-  const systemsById = /* @__PURE__ */ new Map();
-  for (const { path, system } of listAllSystems(model)) {
-    systemsById.set(path, system);
-    systemsById.set(system.id, system);
+// src/provider/resolvers/RouteResolver.ts
+function normalizeRoutePath(path) {
+  const trimmedPath = path.trim();
+  if (!trimmedPath || trimmedPath === "/") {
+    return "/";
   }
-  return systemsById;
+  return trimmedPath.replace(/\/+$/, "") || "/";
 }
-function getSystemWithAncestors(systemsById, systemId) {
-  const systems = [];
-  let current = systemsById.get(systemId);
-  while (current !== void 0) {
-    systems.unshift(current);
-    current = current.parentSystemId ? systemsById.get(current.parentSystemId) : void 0;
+function isRouteMatch(currentPath, route) {
+  const normalizedCurrentPath = normalizeRoutePath(currentPath);
+  const normalizedRoute = normalizeRoutePath(route);
+  return normalizedCurrentPath === normalizedRoute || normalizedCurrentPath.startsWith(`${normalizedRoute}/`);
+}
+
+// src/provider/resolvers/NavResolver.ts
+function uniqueIds(ids) {
+  return ids ? [...new Set(ids)] : [];
+}
+
+// src/provider/validateManifests.ts
+function listSystemRefs(systems) {
+  const refs = [];
+  function walk(map, prefix = "") {
+    for (const [key, system] of Object.entries(map)) {
+      const path = prefix ? `${prefix}.${key}` : key;
+      refs.push(path, system.id);
+      const subsystems = system.subsystems;
+      if (subsystems) {
+        walk(subsystems, path);
+      }
+    }
   }
-  return systems;
+  walk(systems);
+  return refs;
 }
-function hasInheritedFlag(systemsById, systemIds, flag) {
-  return systemIds.some(
-    (systemId) => getSystemWithAncestors(systemsById, systemId).some((system) => system[flag] === true)
-  );
+function validateManifests(manifests, organizationModel) {
+  if (!organizationModel) {
+    return;
+  }
+  const validSystemIds = /* @__PURE__ */ new Set([
+    ...Object.keys(organizationModel.systems ?? {}),
+    ...listSystemRefs(organizationModel.systems ?? {})
+  ]);
+  const errors = [];
+  for (const manifest of manifests) {
+    const key = manifest.key;
+    const systemId = manifest.systemId;
+    if (!systemId) {
+      continue;
+    }
+    if (!validSystemIds.has(systemId)) {
+      errors.push(
+        `Manifest "${key}": systemId "${systemId}" is not a known system id. Valid values: ${[...validSystemIds].sort().join(", ")}`
+      );
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(
+      `System manifest validation failed with ${errors.length} error(s):
+` + errors.map((e, i) => `  ${i + 1}. ${e}`).join("\n")
+    );
+  }
 }
-function isLifecycleEnabled2(system) {
+var ElevasisSystemsContext = createContext(null);
+
+// src/provider/sidebarProjection.ts
+function isLifecycleEnabled3(system) {
   if (system.enabled === false) return false;
   return system.lifecycle !== "deprecated" && system.lifecycle !== "archived";
 }
-function isLifecycleDevOnly(system) {
-  return system.devOnly === true || system.lifecycle === "beta";
+function isSystemAccessible(systemId, context) {
+  const system = context.shellModel.findById(systemId);
+  if (!system || !isLifecycleEnabled3(system)) return false;
+  if (!context.isSystemEnabled(systemId)) return false;
+  if (context.shellModel.requiresAdminFor(systemId) && !context.isPlatformAdmin) return false;
+  if (context.shellModel.devOnlyFor(systemId) && !context.isDev) return false;
+  return true;
 }
-function isSystemEnabled(systemsById, systemId) {
-  const systemLineage = getSystemWithAncestors(systemsById, systemId);
-  return systemLineage.length > 0 && systemLineage.every(isLifecycleEnabled2);
+function isSurfaceAccessible(node, context) {
+  if (node.devOnly && !context.isDev) return false;
+  if (node.requiresAdmin && !context.isPlatformAdmin) return false;
+  const systemTargets = node.targets?.systems ?? [];
+  if (systemTargets.length === 0) return true;
+  return systemTargets.some((systemId) => isSystemAccessible(systemId, context));
 }
-function unique(values) {
-  return [...new Set(values)];
+function iconForNode(node, context) {
+  if (node.type === "surface") {
+    const targetIcon = node.targets?.systems?.map((systemId) => context.shellModel.findById(systemId)?.iconComponent).find(Boolean);
+    if (targetIcon) return targetIcon;
+  }
+  return getSemanticIconComponent(node.icon);
 }
-function collectSidebarSurfaces(nodes, schemaPath, surfaces = []) {
-  getSortedSidebarEntries(nodes).forEach(([id, node]) => {
-    const nodePath = [...schemaPath, id];
-    if (node.type === "group") {
-      collectSidebarSurfaces(node.children, [...nodePath, "children"], surfaces);
-      return;
+function activeMatchPathsForSurface(node, context) {
+  const targets = node.targets?.systems ?? [];
+  if (targets.length !== 1) return void 0;
+  const paths = context.shellModel.childrenOf(targets[0]).map((child) => child.path).filter((path) => Boolean(path && path !== node.path));
+  return paths.length > 0 ? [...new Set(paths)] : void 0;
+}
+function surfaceToLinkItem(node, context, siblings) {
+  if (!isSurfaceAccessible(node, context)) return void 0;
+  const siblingShadows = siblings.some((sibling) => sibling !== node && sibling.path.startsWith(`${node.path}/`));
+  const activeMatchPaths = activeMatchPathsForSurface(node, context);
+  return {
+    label: node.label,
+    link: node.path,
+    ...siblingShadows ? { exact: true } : {},
+    ...activeMatchPaths ? { activeMatchPaths } : {}
+  };
+}
+function projectNode(node, context) {
+  if (node.type === "surface") {
+    if (!isSurfaceAccessible(node, context)) return void 0;
+    return {
+      label: node.label,
+      icon: iconForNode(node, context),
+      link: node.path
+    };
+  }
+  const childEntries = getSortedSidebarEntries(node.children);
+  const childSurfaces = childEntries.map(([, child]) => child).filter((child) => child.type === "surface");
+  const links = childEntries.flatMap(([, child]) => {
+    if (child.type === "surface") {
+      const link = surfaceToLinkItem(child, context, childSurfaces);
+      return link ? [link] : [];
     }
-    surfaces.push({ id, surface: node, path: nodePath });
+    const nestedGroup = projectNode(child, context);
+    return nestedGroup?.link ? [
+      {
+        label: nestedGroup.label,
+        link: nestedGroup.link
+      }
+    ] : nestedGroup?.links ?? [];
   });
-  return surfaces;
+  if (links.length === 0) return void 0;
+  return {
+    label: node.label,
+    icon: iconForNode(node, context),
+    links
+  };
 }
-function getSidebarSurfaces(model) {
-  return [
-    ...collectSidebarSurfaces(model.navigation.sidebar.primary, ["navigation", "sidebar", "primary"]),
-    ...collectSidebarSurfaces(model.navigation.sidebar.bottom, ["navigation", "sidebar", "bottom"])
-  ];
+function projectSection(section, context) {
+  const entries = getSortedSidebarEntries(section);
+  return entries.flatMap(([, node]) => {
+    const group = projectNode(node, context);
+    return group ? [group] : [];
+  });
 }
-function projectOrganizationSurfaces(model) {
-  const systemsById = collectSystemsById(model);
-  return getSidebarSurfaces(model).map(({ id, surface }) => {
-    const targets = surface.targets ?? {};
-    const systemIds = unique((targets.systems ?? []).filter((systemId) => systemsById.has(systemId)));
-    const enabled = systemIds.every((candidate) => isSystemEnabled(systemsById, candidate));
-    const devOnly = surface.devOnly === true || hasInheritedFlag(systemsById, systemIds, "devOnly") || systemIds.some((candidate) => getSystemWithAncestors(systemsById, candidate).some(isLifecycleDevOnly));
-    const requiresAdmin = hasInheritedFlag(systemsById, systemIds, "requiresAdmin");
+function projectSidebarLinks({
+  shellModel,
+  organizationModel,
+  isSystemEnabled: isSystemEnabled2,
+  isPlatformAdmin = false,
+  isDev = false,
+  section
+}) {
+  const context = {
+    shellModel,
+    isSystemEnabled: isSystemEnabled2,
+    isPlatformAdmin,
+    isDev
+  };
+  const sidebar = organizationModel?.navigation.sidebar;
+  if (!sidebar) return [];
+  if (section) {
+    return projectSection(sidebar[section], context);
+  }
+  return [...projectSection(sidebar.primary, context), ...projectSection(sidebar.bottom, context)];
+}
+
+// src/provider/topbarProjection.ts
+function isTopbarActionVisible(node, context) {
+  if (node.enabled === false) return false;
+  if (node.devOnly && !context.isDev) return false;
+  if (node.requiresAdmin && !context.isPlatformAdmin) return false;
+  return true;
+}
+function resolveTopbarAction(node, index) {
+  return {
+    id: node.id,
+    label: node.label,
+    tooltip: node.tooltip,
+    icon: getSemanticIconComponent(node.icon),
+    order: node.order ?? index
+  };
+}
+function projectTopbarActions(topbar, modules, context) {
+  const modulesByKey = new Map(modules.map((m) => [m.key, m]));
+  const entries = Object.values(topbar);
+  const visibleNodes = entries.filter((node) => isTopbarActionVisible(node, context));
+  visibleNodes.sort((a, b) => {
+    const aOrder = a.order ?? Number.MAX_SAFE_INTEGER;
+    const bOrder = b.order ?? Number.MAX_SAFE_INTEGER;
+    if (aOrder !== bOrder) return aOrder - bOrder;
+    return a.id.localeCompare(b.id);
+  });
+  const result = [];
+  for (let i = 0; i < visibleNodes.length; i++) {
+    const node = visibleNodes[i];
+    const module = modulesByKey.get(node.id);
+    if (!module) continue;
+    result.push({
+      node: resolveTopbarAction(node, i),
+      render: module.render
+    });
+  }
+  return result;
+}
+function useElevasisSystems() {
+  const context = useContext(ElevasisSystemsContext);
+  if (!context) {
+    throw new Error(
+      "useElevasisSystems must be used within an ElevasisSystemsProvider. Wrap your app (or the relevant subtree) with <ElevasisSystemsProvider>."
+    );
+  }
+  return context;
+}
+function useOptionalElevasisSystems() {
+  return useContext(ElevasisSystemsContext);
+}
+function defaultSystems(organizationModel) {
+  if (!organizationModel) return [];
+  return listAllSystems(organizationModel).map(({ path, system }) => ({ ...system, id: path }));
+}
+function systemPath(system) {
+  return system.ui?.path ?? system.path ?? defaultPathFor(system.id);
+}
+function systemLabel(system) {
+  return system.label ?? system.title ?? system.id;
+}
+function moduleSystemId(module) {
+  return module.systemId ?? module.key;
+}
+function isLifecycleEnabled4(system) {
+  if (system.enabled === false) return false;
+  return system.lifecycle !== "deprecated" && system.lifecycle !== "archived";
+}
+function isOrganizationModelSystemEnabled(organizationModel, systemId) {
+  const system = defaultSystems(organizationModel).find((candidate) => candidate.id === systemId);
+  return system ? isLifecycleEnabled4(system) : void 0;
+}
+function resolveSystemModules(systems, isSystemEnabled2) {
+  return systems.map((system) => {
+    const systemId = system.systemId;
+    const accessKey = systemId ?? system.key;
     return {
-      id,
-      label: surface.label,
-      path: surface.path,
-      surfaceType: surface.surfaceType,
-      ...surface.description !== void 0 ? { description: surface.description } : {},
-      ...surface.icon !== void 0 ? { icon: surface.icon } : {},
-      ...surface.order !== void 0 ? { order: surface.order } : {},
-      systemIds,
-      entityIds: [...targets.entities ?? []],
-      resourceIds: [...targets.resources ?? []],
-      actionIds: [...targets.actions ?? []],
-      enabled,
-      ...devOnly ? { devOnly } : {},
-      ...surface.requiresAdmin === true || requiresAdmin ? { requiresAdmin: true } : {}
+      ...system,
+      systemId,
+      access: {
+        systemKey: system.key,
+        systemId,
+        enabled: isSystemEnabled2(accessKey)
+      },
+      semantics: {
+        capabilityIds: uniqueIds(system.capabilityIds ?? [])
+      }
     };
   });
 }
+function buildShellSystems(organizationModel, modules) {
+  const iconBySystemId = new Map(
+    modules.flatMap((module) => module.systemId ? [[moduleSystemId(module), module.icon]] : [])
+  );
+  return defaultSystems(organizationModel).map((system) => ({
+    ...system,
+    label: systemLabel(system),
+    path: systemPath(system),
+    iconComponent: iconBySystemId.get(system.id)
+  }));
+}
+function createShellModel(systems) {
+  const systemsRecord = Object.fromEntries(systems.map((s) => [s.id, s]));
+  return {
+    systems,
+    findByPath: (path) => findByPath(systemsRecord, normalizeRoutePath(path)),
+    findById: (id) => findById(systemsRecord, id),
+    childrenOf: (id) => childrenOf(systemsRecord, id),
+    ancestorsOf: (id) => ancestorsOf(systemsRecord, id),
+    parentOf: (id) => parentOf(systemsRecord, id),
+    topLevel: () => topLevel(systemsRecord),
+    requiresAdminFor: (id) => requiresAdminFor(systemsRecord, id),
+    devOnlyFor: (id) => devOnlyFor(systemsRecord, id)
+  };
+}
+function resolveOrganizationGraphSystem(systems, shellModel) {
+  for (const system of systems) {
+    const graphBridge = system.organizationGraph;
+    if (!graphBridge) continue;
+    const systemId = graphBridge.systemId;
+    if (!systemId) continue;
+    const node = shellModel.findById(systemId);
+    return {
+      available: Boolean(node),
+      systemId,
+      systemPath: node ? systemPath(node) : void 0
+    };
+  }
+  return {
+    available: false
+  };
+}
+function findMatchingNode(shellModel, currentPath) {
+  const normalizedPath = normalizeRoutePath(currentPath);
+  const exact = shellModel.findByPath(normalizedPath);
+  if (exact) return exact;
+  return [...shellModel.systems].filter((system) => {
+    const path = normalizeRoutePath(systemPath(system));
+    return path !== "/" && isRouteMatch(normalizedPath, path);
+  }).sort((a, b) => systemPath(b).length - systemPath(a).length)[0];
+}
+function ownsNode(module, node) {
+  if (!node || !module.systemId) return false;
+  return node.id === module.systemId || node.id.startsWith(`${module.systemId}.`);
+}
+function ownsRoutePrefix(module, normalizedPath) {
+  return (module.routePrefixes ?? []).some((prefix) => isRouteMatch(normalizedPath, normalizeRoutePath(prefix)));
+}
+function resolveRoute(systems, shellModel, currentPath, disabledSubsectionPaths) {
+  const node = findMatchingNode(shellModel, currentPath);
+  const normalizedPath = normalizeRoutePath(currentPath);
+  if (disabledSubsectionPaths.some((disabledPath) => isRouteMatch(normalizedPath, disabledPath))) {
+    return {
+      status: "hidden",
+      path: currentPath,
+      node
+    };
+  }
+  const system = systems.find((candidate) => ownsNode(candidate, node)) ?? systems.filter((candidate) => ownsRoutePrefix(candidate, normalizedPath)).sort(
+    (a, b) => Math.max(...(b.routePrefixes ?? []).map((prefix) => prefix.length)) - Math.max(...(a.routePrefixes ?? []).map((prefix) => prefix.length))
+  )[0];
+  if (!system) {
+    return {
+      status: "unmatched",
+      path: currentPath,
+      node
+    };
+  }
+  return {
+    status: "matched",
+    path: currentPath,
+    system,
+    node
+  };
+}
+function ElevasisSystemsProvider({
+  systems,
+  topbarActions,
+  organizationModel,
+  timeRange,
+  operationsApiUrl,
+  operationsSSEManager,
+  deliveryApiUrl,
+  deliverySSEManager,
+  disabledSubsectionPaths = [],
+  children
+}) {
+  const activeSystems = systems ?? [];
+  const resolvedOrganizationModel = useMemo(() => {
+    if (!organizationModel) {
+      return void 0;
+    }
+    return {
+      ...organizationModel,
+      knowledge: organizationModel.knowledge ?? {}
+    };
+  }, [organizationModel]);
+  useMemo(() => validateManifests(activeSystems, resolvedOrganizationModel), [activeSystems, resolvedOrganizationModel]);
+  const hasResolvedSystem = useCallback(
+    (key) => {
+      const organizationModelSystemEnabled = isOrganizationModelSystemEnabled(resolvedOrganizationModel, key);
+      return organizationModelSystemEnabled ?? true;
+    },
+    [resolvedOrganizationModel]
+  );
+  const shellSystems = useMemo(
+    () => buildShellSystems(resolvedOrganizationModel, activeSystems),
+    [resolvedOrganizationModel, activeSystems]
+  );
+  const shellModel = useMemo(() => createShellModel(shellSystems), [shellSystems]);
+  const normalizedDisabledSubsectionPaths = useMemo(
+    () => [...new Set(disabledSubsectionPaths.map((path) => normalizeRoutePath(path)))],
+    [disabledSubsectionPaths]
+  );
+  const resolvedSystems = useMemo(
+    () => resolveSystemModules(activeSystems, hasResolvedSystem),
+    [activeSystems, hasResolvedSystem]
+  );
+  const enabledResolvedSystems = useMemo(
+    () => resolvedSystems.filter((system) => system.access.enabled),
+    [resolvedSystems]
+  );
+  const organizationGraph = useMemo(
+    () => resolveOrganizationGraphSystem(enabledResolvedSystems, shellModel),
+    [enabledResolvedSystems, shellModel]
+  );
+  const getResolvedSystem = useCallback(
+    (key) => resolvedSystems.find((system) => system.key === key),
+    [resolvedSystems]
+  );
+  const isSystemEnabled2 = useCallback((key) => hasResolvedSystem(key), [hasResolvedSystem]);
+  const getSidebarLinks = useCallback(
+    (options = {}) => projectSidebarLinks({
+      shellModel,
+      organizationModel: resolvedOrganizationModel,
+      isSystemEnabled: isSystemEnabled2,
+      ...options
+    }),
+    [shellModel, resolvedOrganizationModel, isSystemEnabled2]
+  );
+  const activeTopbarActions = topbarActions ?? [];
+  const getTopbarActions = useCallback(
+    (options = {}) => projectTopbarActions(resolvedOrganizationModel?.navigation.topbar ?? {}, activeTopbarActions, {
+      isPlatformAdmin: options.isPlatformAdmin ?? false,
+      isDev: options.isDev ?? false
+    }),
+    [resolvedOrganizationModel, activeTopbarActions]
+  );
+  const resolveRouteByPath = useCallback(
+    (path) => resolveRoute(enabledResolvedSystems, shellModel, path, normalizedDisabledSubsectionPaths),
+    [enabledResolvedSystems, shellModel, normalizedDisabledSubsectionPaths]
+  );
+  const shellRuntime = useMemo(
+    () => ({
+      resolveRoute: resolveRouteByPath
+    }),
+    [resolveRouteByPath]
+  );
+  const value = useMemo(
+    () => ({
+      shellModel,
+      shellRuntime,
+      getSidebarLinks,
+      getTopbarActions,
+      enabledResolvedSystems,
+      resolvedSystems,
+      organizationGraph,
+      organizationModel: resolvedOrganizationModel,
+      timeRange,
+      operationsApiUrl,
+      operationsSSEManager,
+      deliveryApiUrl,
+      deliverySSEManager,
+      disabledSubsectionPaths: normalizedDisabledSubsectionPaths,
+      isSystemEnabled: isSystemEnabled2,
+      getResolvedSystem
+    }),
+    [
+      shellModel,
+      shellRuntime,
+      enabledResolvedSystems,
+      resolvedSystems,
+      organizationGraph,
+      resolvedOrganizationModel,
+      timeRange,
+      operationsApiUrl,
+      operationsSSEManager,
+      deliveryApiUrl,
+      deliverySSEManager,
+      normalizedDisabledSubsectionPaths,
+      isSystemEnabled2,
+      getResolvedSystem,
+      getSidebarLinks,
+      getTopbarActions
+    ]
+  );
+  return /* @__PURE__ */ jsx(ElevasisSystemsContext.Provider, { value, children });
+}
 
-export { ActionSchema, AgentResourceEntrySchema, DEFAULT_ORGANIZATION_MODEL, DEFAULT_SEMANTIC_ICON_REGISTRY, EntitySchema, IdentityDomainSchema, IntegrationResourceEntrySchema, OrgKnowledgeNodeSchema, PROJECTS_VIEW_ACTION_ID, PolicySchema, RoleSchema, ScriptResourceEntrySchema, SemanticIcon, SurfaceDefinitionSchema, SystemEntrySchema, WorkflowResourceEntrySchema, buildOrganizationGraph, defineActions, defineEntities, defineResources, defineTopology, extendSemanticIconRegistry, getSemanticIconComponent, getSortedSidebarEntries, projectOrganizationSurfaces, resolveOrganizationModel, resolveSemanticIconComponent, topologyRef, topologyRelationship };
+export { ActionSchema, AgentResourceEntrySchema, DEFAULT_ORGANIZATION_MODEL, DEFAULT_SEMANTIC_ICON_REGISTRY, ElevasisSystemsProvider, EntitySchema, IdentityDomainSchema, IntegrationResourceEntrySchema, OrgKnowledgeNodeSchema, PROJECTS_VIEW_ACTION_ID, PolicySchema, RoleSchema, ScriptResourceEntrySchema, SemanticIcon, SurfaceDefinitionSchema, SystemEntrySchema, WorkflowResourceEntrySchema, buildOrganizationGraph, defineActions, defineEntities, defineResources, defineTopology, extendSemanticIconRegistry, getSemanticIconComponent, getSortedSidebarEntries, projectOrganizationSurfaces, resolveOrganizationModel, resolveSemanticIconComponent, topologyRef, topologyRelationship, useElevasisSystems, useOptionalElevasisSystems };