@elevasis/core 0.24.0 → 0.25.0

package/dist/organization-model/index.js

@@ -281,7 +281,6 @@ function addLegacyEntityProjections(index, diagnostics, sourcesById, entities) {
           table: entity.table
         }
       } : {},
-      legacyEntityId: entity.id,
       ...entity.rowSchema !== void 0 ? { rowSchema: entity.rowSchema } : {},
       ...entity.stateCatalogId !== void 0 ? { stateCatalogId: entity.stateCatalogId } : {}
     };
@@ -306,8 +305,7 @@ function addLegacyEntityProjections(index, diagnostics, sourcesById, entities) {
         from: legacyObjectId(entity),
         to: legacyObjectId(targetEntity),
         cardinality: link.kind,
-        ...link.via !== void 0 ? { via: link.via } : {},
-        legacyEntityId: entity.id
+        ...link.via !== void 0 ? { via: link.via } : {}
       };
       addRecord(index, diagnostics, sourcesById, "linkTypes", linkType, {
         source: "legacy.entities.links",
@@ -365,8 +363,7 @@ function addSystemContentProjections(index, diagnostics, sourcesById, systemPath
       kind: node.type,
       ...typeof node.data?.["entityId"] === "string" ? { appliesTo: formatOntologyId({ scope: systemPath, kind: "object", localId: node.data["entityId"] }) } : {},
       ...Object.keys(entries).length > 0 ? { entries } : {},
-      ...node.data !== void 0 ? { data: node.data } : {},
-      legacyContentId: `${systemPath}:${localId}`
+      ...node.data !== void 0 ? { data: node.data } : {}
     };
     addRecord(index, diagnostics, sourcesById, "catalogTypes", catalogType, {
       source: "legacy.system.content",
@@ -597,6 +594,7 @@ var ORGANIZATION_MODEL_ICON_TOKENS = [
   "crm",
   "lead-gen",
   "projects",
+  "clients",
   "operations",
   "monitoring",
   "knowledge",
@@ -1508,11 +1506,20 @@ var EventDescriptorSchema = EventEmissionDescriptorSchema.extend({
   ownerKind: z.enum(["resource", "entity"]).meta({ label: "Owner kind" })
 });
 var ResourceOntologyBindingSchema = z.object({
-  implements: z.array(OntologyIdSchema).optional(),
+  actions: z.array(OntologyIdSchema).optional(),
+  primaryAction: OntologyIdSchema.optional(),
   reads: z.array(OntologyIdSchema).optional(),
   writes: z.array(OntologyIdSchema).optional(),
   usesCatalogs: z.array(OntologyIdSchema).optional(),
   emits: z.array(OntologyIdSchema).optional()
+}).superRefine((binding, ctx) => {
+  if (binding.primaryAction === void 0) return;
+  if (binding.actions?.includes(binding.primaryAction)) return;
+  ctx.addIssue({
+    code: z.ZodIssueCode.custom,
+    path: ["primaryAction"],
+    message: "Resource ontology primaryAction must be included in actions"
+  });
 });
 var CodeReferenceSchema = z.object({
   path: z.string().trim().min(1).max(500).regex(/^[A-Za-z0-9_./$@()[\] -]+$/, "Code reference paths must be repo-relative paths"),
@@ -1527,6 +1534,10 @@ var ResourceEntryBaseSchema = z.object({
   order: z.number().default(0),
   /** Required single System membership — value is a dot-separated system path (e.g. "sales.lead-gen"). */
   systemPath: SystemPathSchema.meta({ ref: "system" }),
+  /** Executable display title owned by the OM Resource descriptor. */
+  title: LabelSchema.optional(),
+  /** Executable display description owned by the OM Resource descriptor. */
+  description: DescriptionSchema.optional(),
   /** Optional role responsible for maintaining this resource. */
   ownerRoleId: ModelIdSchema.meta({ ref: "role" }).optional(),
   status: ResourceGovernanceStatusSchema,
@@ -1541,8 +1552,6 @@ var ResourceEntryBaseSchema = z.object({
 });
 var WorkflowResourceEntrySchema = ResourceEntryBaseSchema.extend({
   kind: z.literal("workflow"),
-  /** Mirrors WorkflowConfig.actionKey when the runtime workflow has one. */
-  actionKey: z.string().trim().min(1).max(255).optional(),
   emits: z.array(EventEmissionDescriptorSchema).optional()
 });
 var AgentResourceEntrySchema = ResourceEntryBaseSchema.extend({
@@ -1590,6 +1599,22 @@ function defineResources(resources) {
     Object.entries(resources).map(([key, resource]) => [key, ResourceEntrySchema.parse(resource)])
   );
 }
+function ontologyIdFrom(input) {
+  return typeof input === "string" ? input : input.id;
+}
+function ontologyIdArrayFrom(input) {
+  return input?.map(ontologyIdFrom);
+}
+function defineResourceOntology(input) {
+  return ResourceOntologyBindingSchema.parse({
+    actions: ontologyIdArrayFrom(input.actions),
+    primaryAction: input.primaryAction === void 0 ? void 0 : ontologyIdFrom(input.primaryAction),
+    reads: ontologyIdArrayFrom(input.reads),
+    writes: ontologyIdArrayFrom(input.writes),
+    usesCatalogs: ontologyIdArrayFrom(input.usesCatalogs),
+    emits: ontologyIdArrayFrom(input.emits)
+  });
+}
 
 // src/organization-model/domains/roles.ts
 var RoleIdSchema = ModelIdSchema;
@@ -1770,6 +1795,179 @@ var OrgKnowledgeNodeSchema = z.object({
   updatedAt: z.string().trim().min(1).max(50)
 });
 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-----)/;
+var OmTopologyNodeKindSchema = z.enum([
+  "system",
+  "resource",
+  "ontology",
+  "policy",
+  "role",
+  "trigger",
+  "humanCheckpoint",
+  "externalResource"
+]);
+var OmTopologyRelationshipKindSchema = z.enum(["triggers", "uses", "approval"]);
+var OmTopologyNodeRefSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("system"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("resource"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("ontology"), id: OntologyIdSchema }),
+  z.object({ kind: z.literal("policy"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("role"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("trigger"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("humanCheckpoint"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("externalResource"), id: ResourceIdSchema })
+]);
+var OmTopologyMetadataSchema = z.record(z.string().trim().min(1).max(120), JsonValueSchema).superRefine((metadata, ctx) => {
+  function visit(value, path) {
+    if (typeof value === "string" && SecretLikeMetadataValueSchema.test(value)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path,
+        message: "Topology metadata must not contain secret-like values"
+      });
+      return;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((entry, index) => visit(entry, [...path, index]));
+      return;
+    }
+    if (typeof value !== "object" || value === null) return;
+    Object.entries(value).forEach(([key, entry]) => {
+      if (SecretLikeMetadataKeySchema.test(key)) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: [...path, key],
+          message: `Topology metadata key "${key}" looks secret-like`
+        });
+      }
+      visit(entry, [...path, key]);
+    });
+  }
+  visit(metadata, []);
+});
+var OmTopologyRelationshipSchema = z.object({
+  from: OmTopologyNodeRefSchema,
+  kind: OmTopologyRelationshipKindSchema,
+  to: OmTopologyNodeRefSchema,
+  systemPath: SystemPathSchema.optional(),
+  required: z.boolean().optional(),
+  metadata: OmTopologyMetadataSchema.optional()
+});
+var OmTopologyDomainSchema = z.object({
+  version: z.literal(1).default(1),
+  relationships: z.record(z.string().trim().min(1).max(255), OmTopologyRelationshipSchema).default({})
+}).default({ version: 1, relationships: {} });
+var DEFAULT_ORGANIZATION_MODEL_TOPOLOGY = {
+  version: 1,
+  relationships: {}
+};
+function idFrom(input) {
+  return typeof input === "string" ? input : input.id;
+}
+function parseRef(kind, id) {
+  return OmTopologyNodeRefSchema.parse({ kind, id });
+}
+function isNodeRef(input) {
+  return OmTopologyNodeRefSchema.safeParse(input).success;
+}
+function isResourceEntry(input) {
+  if (typeof input !== "object" || input === null) return false;
+  const candidate = input;
+  return typeof candidate.id === "string" && typeof candidate.systemPath === "string" && typeof candidate.status === "string" && ["workflow", "agent", "integration", "script"].includes(String(candidate.kind));
+}
+var topologyRef = {
+  system: (system) => parseRef("system", idFrom(system)),
+  resource: (resource) => parseRef("resource", idFrom(resource)),
+  ontology: (record) => parseRef("ontology", idFrom(record)),
+  policy: (policy) => parseRef("policy", idFrom(policy)),
+  role: (role) => parseRef("role", idFrom(role)),
+  trigger: (trigger) => parseRef("trigger", idFrom(trigger)),
+  humanCheckpoint: (checkpoint) => parseRef("humanCheckpoint", idFrom(checkpoint)),
+  externalResource: (externalResource) => parseRef("externalResource", idFrom(externalResource))
+};
+var topologyRelationship = {
+  triggers: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "triggers",
+    to
+  }),
+  uses: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "uses",
+    to
+  }),
+  approval: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "approval",
+    to
+  }),
+  usesIntegration: (from, integration, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from,
+    kind: "uses",
+    to: integration
+  }),
+  requestsApproval: (from, checkpoint, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from,
+    kind: "approval",
+    to: topologyRef.humanCheckpoint(checkpoint)
+  }),
+  checkpointRoutesTo: (checkpoint, to, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from: topologyRef.humanCheckpoint(checkpoint),
+    kind: "triggers",
+    to
+  })
+};
+function compileTopologyNodeRef(input) {
+  if (isNodeRef(input)) return input;
+  if (isResourceEntry(input)) return topologyRef.resource(input);
+  throw new Error("Topology node refs must be typed node objects or serializable { kind, id } refs");
+}
+function parseTopologyNodeRef(input) {
+  if (typeof input !== "string") return OmTopologyNodeRefSchema.parse(input);
+  const separatorIndex = input.indexOf(":");
+  if (separatorIndex === -1) {
+    throw new Error(`Topology node ref "${input}" must use <kind>:<id>`);
+  }
+  const kind = input.slice(0, separatorIndex);
+  const id = input.slice(separatorIndex + 1);
+  if (!OmTopologyNodeKindSchema.safeParse(kind).success) {
+    throw new Error(`Topology node ref "${input}" has unsupported kind "${kind}"`);
+  }
+  return OmTopologyNodeRefSchema.parse({ kind, id });
+}
+function defineTopologyRelationship(input) {
+  return OmTopologyRelationshipSchema.parse({
+    ...input,
+    from: compileTopologyNodeRef(input.from),
+    to: compileTopologyNodeRef(input.to)
+  });
+}
+function defineTopology(relationships) {
+  const entries = Array.isArray(relationships) ? relationships.map((relationship, index) => [`relationship-${index + 1}`, relationship]) : Object.entries(relationships);
+  return OmTopologyDomainSchema.parse({
+    version: 1,
+    relationships: Object.fromEntries(entries.map(([key, relationship]) => [key, defineTopologyRelationship(relationship)]))
+  });
+}
+function isOntologyTopologyRef(value) {
+  if (!isNodeRef(value) || value.kind !== "ontology") return false;
+  try {
+    parseOntologyId(value.id);
+    return true;
+  } catch {
+    return false;
+  }
+}
 var PolicyIdSchema = ModelIdSchema;
 var PolicyApplicabilitySchema = z.object({
   systemIds: z.array(ModelIdSchema.meta({ ref: "system" })).default([]),
@@ -1859,6 +2057,7 @@ var OrganizationModelDomainKeySchema = z.enum([
   "systems",
   "ontology",
   "resources",
+  "topology",
   "actions",
   "entities",
   "policies",
@@ -1878,6 +2077,7 @@ var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
   systems: { version: 1, lastModified: "2026-05-10" },
   ontology: { version: 1, lastModified: "2026-05-14" },
   resources: { version: 1, lastModified: "2026-05-10" },
+  topology: { version: 1, lastModified: "2026-05-14" },
   actions: { version: 1, lastModified: "2026-05-10" },
   entities: { version: 1, lastModified: "2026-05-10" },
   policies: { version: 1, lastModified: "2026-05-10" },
@@ -1893,6 +2093,7 @@ var OrganizationModelDomainMetadataByDomainSchema = z.object({
   systems: OrganizationModelDomainMetadataSchema,
   ontology: OrganizationModelDomainMetadataSchema,
   resources: OrganizationModelDomainMetadataSchema,
+  topology: OrganizationModelDomainMetadataSchema,
   actions: OrganizationModelDomainMetadataSchema,
   entities: OrganizationModelDomainMetadataSchema,
   policies: OrganizationModelDomainMetadataSchema,
@@ -1911,6 +2112,7 @@ var OrganizationModelSchemaBase = z.object({
   systems: SystemsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_SYSTEMS),
   ontology: OntologyScopeSchema.default(DEFAULT_ONTOLOGY_SCOPE),
   resources: ResourcesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_RESOURCES),
+  topology: OmTopologyDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_TOPOLOGY),
   actions: ActionsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ACTIONS),
   entities: EntitiesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ENTITIES),
   policies: PoliciesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_POLICIES),
@@ -2253,6 +2455,25 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
     surface: ontologyCompilation.ontology.surfaces
   };
   const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
+  function topologyTargetExists(ref) {
+    if (ref.kind === "system") return systemsById.has(ref.id);
+    if (ref.kind === "resource") return resourcesById.has(ref.id);
+    if (ref.kind === "ontology") return ontologyIds.has(ref.id);
+    if (ref.kind === "policy") return policiesById.has(ref.id);
+    if (ref.kind === "role") return rolesById.has(ref.id);
+    return true;
+  }
+  Object.entries(model.topology.relationships).forEach(([relationshipId, relationship]) => {
+    ["from", "to"].forEach((side) => {
+      const ref = relationship[side];
+      if (topologyTargetExists(ref)) return;
+      addIssue(
+        ctx,
+        ["topology", "relationships", relationshipId, side],
+        `Topology relationship "${relationshipId}" ${side} references unknown ${ref.kind} "${ref.id}"`
+      );
+    });
+  });
   const ontologyReferenceKeyKinds = {
     valueType: "value-type",
     catalogType: "catalog",
@@ -2391,11 +2612,18 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
     }
   });
   function validateResourceOntologyBinding(resourceId, bindingKey, expectedKind, ids) {
-    ids?.forEach((ontologyId, ontologyIndex) => {
+    const ontologyIds2 = ids === void 0 ? [] : Array.isArray(ids) ? ids : [ids];
+    ontologyIds2.forEach((ontologyId, ontologyIndex) => {
       if (ontologyIndexByKind[expectedKind][ontologyId] === void 0) {
         addIssue(
           ctx,
-          ["resources", resourceId, "ontology", bindingKey, ontologyIndex],
+          [
+            "resources",
+            resourceId,
+            "ontology",
+            bindingKey,
+            ...Array.isArray(ids) ? [ontologyIndex] : []
+          ],
           `Resource "${resourceId}" ontology binding "${bindingKey}" references unknown ${expectedKind} ontology ID "${ontologyId}"`
         );
       }
@@ -2404,7 +2632,8 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
   Object.values(model.resources).forEach((resource) => {
     const binding = resource.ontology;
     if (binding === void 0) return;
-    validateResourceOntologyBinding(resource.id, "implements", "action", binding.implements);
+    validateResourceOntologyBinding(resource.id, "actions", "action", binding.actions);
+    validateResourceOntologyBinding(resource.id, "primaryAction", "action", binding.primaryAction);
     validateResourceOntologyBinding(resource.id, "reads", "object", binding.reads);
     validateResourceOntologyBinding(resource.id, "writes", "object", binding.writes);
     validateResourceOntologyBinding(resource.id, "usesCatalogs", "catalog", binding.usesCatalogs);
@@ -2550,9 +2779,10 @@ var OrganizationGraphEdgeKindSchema = z.enum([
   "emits",
   "originates_from",
   "triggers",
+  "approval",
   "applies_to",
   "effects",
-  "implements",
+  "actions",
   "reads",
   "writes",
   "uses_catalog"
@@ -2635,7 +2865,7 @@ var DEFAULT_ORGANIZATION_MODEL_NAVIGATION2 = {
       business: {
         type: "group",
         label: "Business",
-        icon: "business",
+        icon: "briefcase",
         order: 20,
         children: {
           sales: {
@@ -2652,7 +2882,7 @@ var DEFAULT_ORGANIZATION_MODEL_NAVIGATION2 = {
             label: "Clients",
             path: "/clients",
             surfaceType: "list",
-            icon: "projects",
+            icon: "clients",
             order: 20,
             targets: { systems: ["clients"] }
           },
@@ -3026,7 +3256,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       enabled: true,
       lifecycle: "active",
       color: "orange",
-      icon: "projects",
+      icon: "clients",
       path: "/clients"
     },
     operations: {
@@ -3330,6 +3560,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   },
   ontology: DEFAULT_ONTOLOGY_SCOPE,
   resources: DEFAULT_ORGANIZATION_MODEL_RESOURCES,
+  topology: DEFAULT_ORGANIZATION_MODEL_TOPOLOGY,
   actions: DEFAULT_ORGANIZATION_MODEL_ACTIONS,
   entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES2,
   policies: DEFAULT_ORGANIZATION_MODEL_POLICIES,
@@ -3978,4 +4209,331 @@ function createFoundationOrganizationModel(override) {
   };
 }
 
-export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, CRM_ACTION_ENTRIES, CodeReferenceRoleSchema, CodeReferenceSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, DEFAULT_ORGANIZATION_MODEL_ENTITIES, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_NAVIGATION, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_POLICIES, DEFAULT_ORGANIZATION_MODEL_RESOURCES, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, DEFAULT_ORGANIZATION_MODEL_SYSTEMS, EntitiesDomainSchema, EntityIdSchema, EntityLinkKindSchema, EntityLinkSchema, EntitySchema, EventDescriptorSchema, EventEmissionDescriptorSchema, EventIdSchema, FirmographicsSchema, GoalsDomainSchema, HumanRoleHolderSchema, IconNameSchema, IntegrationResourceEntrySchema, KNOWLEDGE_FEATURE_ID, KNOWLEDGE_SYSTEM_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, KnowledgeTargetKindSchema, KnowledgeTargetRefSchema, LEAD_GEN_ACTION_ENTRIES, LEAD_GEN_STAGE_CATALOG, LinkSchema, MONITORING_FEATURE_ID, MONITORING_SYSTEM_ID, McpToolInvocationSchema, NavigationGroupSchema, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, OPERATIONS_SYSTEM_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OntologyActionTypeSchema, OntologyCatalogTypeSchema, OntologyEventTypeSchema, OntologyGroupSchema, OntologyIdSchema, OntologyInterfaceTypeSchema, OntologyKindSchema, OntologyLinkTypeSchema, OntologyObjectTypeSchema, OntologyScopeSchema, OntologySharedPropertySchema, OntologySurfaceTypeSchema, OntologyValueTypeSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelDomainKeySchema, OrganizationModelDomainMetadataByDomainSchema, OrganizationModelDomainMetadataSchema, OrganizationModelIconTokenSchema, OrganizationModelNavigationSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_SYSTEM_ID, PROJECTS_VIEW_ACTION_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PROSPECTING_SYSTEM_ID, PoliciesDomainSchema, PolicyApplicabilitySchema, PolicyEffectSchema, PolicyIdSchema, PolicyPredicateSchema, PolicySchema, PolicyTriggerSchema, PricingModelSchema, ProductSchema, ResourceEntrySchema, ResourceGovernanceStatusSchema, ResourceIdSchema, ResourceKindSchema, ResourceOntologyBindingSchema, ResourcesDomainSchema, RoleHolderSchema, RoleHoldersSchema, RoleIdSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SALES_SYSTEM_ID, SEO_FEATURE_ID, SEO_SYSTEM_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, SETTINGS_SYSTEM_ID, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemEntrySchema, SystemIdSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, createFoundationOrganizationModel, defineOrganizationModel, defineResource, defineResources, findOrganizationActionById, formatOntologyId, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseOntologyId, resolveOrganizationModel, resolveOrganizationModelWithResources };
+// src/organization-model/scaffolders/helpers.ts
+function slugify(input) {
+  return input.trim().replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function titleize(input) {
+  return input.split(/[-._\s]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function assertSystemPathAvailable(model, path) {
+  if (getSystem(model, path) !== void 0) {
+    throw new Error(`system already exists: ${path}`);
+  }
+  const parent = parentPathOf(path);
+  if (parent !== void 0 && getSystem(model, parent) === void 0) {
+    throw new Error(`parent system does not exist: ${parent}`);
+  }
+}
+function assertSystemExists(model, path) {
+  if (getSystem(model, path) === void 0) {
+    throw new Error(`system does not exist: ${path}`);
+  }
+}
+function parentPathOf(path) {
+  const index = path.lastIndexOf(".");
+  return index === -1 ? void 0 : path.slice(0, index);
+}
+function localIdOf(path) {
+  return path.split(".").at(-1) ?? path;
+}
+function nextSystemOrder(model, parentPath) {
+  const siblings = parentPath === void 0 ? listAllSystems(model).filter(({ path }) => !path.includes(".")) : listAllSystems(model).filter(({ path }) => parentPathOf(path) === parentPath);
+  const maxOrder = siblings.reduce((max, { system }) => Math.max(max, system.order), 0);
+  return Math.ceil((maxOrder + 10) / 10) * 10;
+}
+function ontologyMapName(kind) {
+  const map = {
+    object: "objectTypes",
+    link: "linkTypes",
+    action: "actionTypes",
+    catalog: "catalogTypes",
+    event: "eventTypes",
+    interface: "interfaceTypes",
+    "value-type": "valueTypes",
+    property: "sharedProperties",
+    group: "groups",
+    surface: "surfaces"
+  };
+  return map[kind];
+}
+function makeOntologyId(systemPath, kind, localId) {
+  return formatOntologyId({ scope: systemPath, kind, localId: slugify(localId) });
+}
+function addProjectNextStep(plan, enabled, command) {
+  if (!enabled) return plan;
+  return {
+    ...plan,
+    projectCommand: command,
+    nextSteps: [...plan.nextSteps, `Run project handoff: ${command}`]
+  };
+}
+
+// src/organization-model/scaffolders/scaffoldKnowledgeNode.ts
+function scaffoldKnowledgeNode(model, spec) {
+  if (spec.systemPath !== void 0) assertSystemExists(model, spec.systemPath);
+  if (model.knowledge?.[spec.id] !== void 0) {
+    throw new Error(`knowledge node already exists: ${spec.id}`);
+  }
+  const title = spec.label ?? titleize(spec.id.replace(/^knowledge\./, ""));
+  const slug = slugify(spec.id.replace(/^knowledge\./, ""));
+  const kind = spec.kind ?? "reference";
+  const links = spec.systemPath === void 0 ? "" : `links:
+  - system:${spec.systemPath}
+`;
+  const ownerIds = spec.ownerRoleId === void 0 ? "" : `ownerIds:
+  - ${spec.ownerRoleId}
+`;
+  return {
+    intent: "knowledge",
+    id: spec.id,
+    summary: `Scaffold ${kind} knowledge node "${spec.id}".`,
+    writes: [
+      {
+        path: `packages/elevasis-core/src/knowledge/nodes/${slug}.mdx.stub`,
+        mode: "create",
+        description: "Knowledge node MDX skeleton.",
+        content: `---
+id: ${spec.id}
+kind: ${kind}
+title: ${JSON.stringify(title)}
+summary: ${JSON.stringify(spec.description ?? `${title} knowledge node.`)}
+${links}${ownerIds}updatedAt: 2026-05-15
+---
+
+## Overview
+
+Capture the durable operating knowledge here.
+`
+      }
+    ],
+    edits: [
+      {
+        path: "packages/elevasis-core/src/organization-model/knowledge.ts",
+        description: "Register this generated node after replacing the .stub suffix.",
+        snippet: `${JSON.stringify(spec.id)}`
+      }
+    ],
+    warnings: [],
+    nextSteps: [
+      "Replace the .stub suffix after the node is ready to become canonical.",
+      spec.systemPath === void 0 ? "Add links to the OM nodes this knowledge governs." : `Run pnpm exec elevasis om:verify --scope ${spec.systemPath}.`
+    ],
+    projectCommand: spec.withProject && spec.systemPath !== void 0 ? `pnpm exec elevasis project:create --link-om ${spec.systemPath} --title "Add ${title} knowledge" --kind om-change` : void 0
+  };
+}
+
+// src/organization-model/scaffolders/scaffoldOntologyRecord.ts
+function scaffoldOntologyRecord(model, spec) {
+  assertSystemExists(model, spec.systemPath);
+  const localId = spec.localId ?? spec.id;
+  const ontologyId = makeOntologyId(spec.systemPath, spec.kind, localId);
+  const label = spec.label ?? titleize(localId);
+  const mapName = ontologyMapName(spec.kind);
+  return {
+    intent: "ontology",
+    id: ontologyId,
+    summary: `Scaffold ${spec.kind} ontology record "${ontologyId}".`,
+    writes: [],
+    edits: [
+      {
+        path: "packages/elevasis-core/src/organization-model/systems.ts",
+        description: `Add this record under ${spec.systemPath}.ontology.${mapName}.`,
+        snippet: `${JSON.stringify(ontologyId)}: {
+  id: ${JSON.stringify(ontologyId)},
+  label: ${JSON.stringify(label)},
+  ownerSystemId: ${JSON.stringify(spec.systemPath)}${spec.description === void 0 ? "" : `,
+  description: ${JSON.stringify(spec.description)}`}
+}`
+      }
+    ],
+    warnings: [],
+    nextSteps: [
+      "Wire any cross-references using canonical ontology IDs.",
+      `Run pnpm exec elevasis om:verify --scope ${spec.systemPath}.`
+    ],
+    projectCommand: spec.withProject ? `pnpm exec elevasis project:create --link-om ${spec.systemPath} --title "Add ${label} ontology" --kind om-change` : void 0
+  };
+}
+
+// src/organization-model/scaffolders/scaffoldResource.ts
+function scaffoldResource(model, spec) {
+  assertSystemExists(model, spec.systemPath);
+  if (model.resources?.[spec.id] !== void 0) {
+    throw new Error(`resource already exists: ${spec.id}`);
+  }
+  const label = spec.label ?? titleize(spec.id);
+  const kind = spec.kind ?? "workflow";
+  const slug = slugify(spec.id);
+  const writes = spec.withStubWorkflow ? [
+    {
+      path: `packages/elevasis-core/src/workflows/${slug}.stub.ts`,
+      mode: "create",
+      description: "Optional workflow implementation stub. Runtime wiring remains manual.",
+      content: `// Stub only. Replace with a real workflow implementation before registering the resource.
+export const ${slug.replaceAll("-", "_")}Workflow = {
+  id: ${JSON.stringify(spec.id)}
+}
+`
+    }
+  ] : [];
+  return {
+    intent: "resource",
+    id: spec.id,
+    summary: `Scaffold ${kind} Resource "${spec.id}" for System "${spec.systemPath}".`,
+    writes,
+    edits: [
+      {
+        path: "packages/elevasis-core/src/organization-model/resources.ts",
+        description: "Add this descriptor to platformResources/platformResourceDescriptors.",
+        snippet: `${JSON.stringify(spec.id)}: {
+  id: ${JSON.stringify(spec.id)},
+  order: 0,
+  kind: ${JSON.stringify(kind)},
+  systemPath: ${JSON.stringify(spec.systemPath)},
+  title: ${JSON.stringify(label)},
+  ${spec.description === void 0 ? "" : `description: ${JSON.stringify(spec.description)},
+  `}${spec.ownerRoleId === void 0 ? "" : `ownerRoleId: ${JSON.stringify(spec.ownerRoleId)},
+  `}status: 'active',
+  codeRefs: []
+}`
+      },
+      {
+        path: "packages/elevasis-core/src/organization-model/topology.ts",
+        description: "Add topology relationships only when this resource triggers, uses, or requires approval from another OM node.",
+        snippet: `// topologyRelationship({ from: topologyRef('resource', ${JSON.stringify(spec.id)}), kind: 'uses', to: ... })`
+      }
+    ],
+    warnings: ["Resource ontology bindings are intentionally omitted until action/read/write contracts are known."],
+    nextSteps: [
+      "Bind resource.ontology.actions/reads/writes after the ontology records exist.",
+      `Run pnpm exec elevasis om:verify --scope ${spec.systemPath}.`
+    ],
+    projectCommand: spec.withProject ? `pnpm exec elevasis project:create --link-om ${spec.systemPath} --title "Add ${label} resource" --kind om-change` : void 0
+  };
+}
+
+// src/organization-model/scaffolders/scaffoldSystem.ts
+function scaffoldSystem(model, spec) {
+  const systemPath = spec.parent !== void 0 && !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 === void 0 ? "" : `parentSystemId: ${JSON.stringify(parentPath)},
+    `}responsibleRoleId: ${JSON.stringify(roleId)},
+    governedByKnowledge: [${JSON.stringify(knowledgeId)}],
+    drivesGoals: [],
+    lifecycle: 'draft',
+    ui: {
+      path: ${JSON.stringify(uiPath)},
+      surfaces: [],
+      ${spec.icon === void 0 ? "" : `icon: ${JSON.stringify(spec.icon)},`}
+    }${spec.withOntology ? `,
+    ontology: {
+      objectTypes: {}
+    }` : ""}
+  }`;
+  const plan = {
+    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'
+
+export const ${featureSlug.replaceAll("-", "_")}Manifest: SystemModule = {
+  systemId: ${JSON.stringify(systemPath)},
+  label: ${JSON.stringify(label)},
+  routes: []
+}
+`
+      },
+      {
+        path: `packages/elevasis-core/src/knowledge/nodes/${featureSlug}-system-overview.mdx.stub`,
+        mode: "create",
+        description: "Governing knowledge skeleton for the new System.",
+        content: `---
+id: ${knowledgeId}
+kind: reference
+title: ${JSON.stringify(`${label} System Overview`)}
+summary: ${JSON.stringify(`Governing context for the ${label} System.`)}
+links:
+  - system:${systemPath}
+ownerIds:
+  - ${roleId}
+updatedAt: 2026-05-15
+---
+
+## Purpose
+
+Document the operating boundaries, decisions, and ownership for ${label}.
+`
+      }
+    ],
+    edits: [
+      {
+        path: "packages/elevasis-core/src/organization-model/systems.ts",
+        description: parentPath === void 0 ? "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)}:
+  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`
+  );
+}
+
+// src/organization-model/scaffolders/index.ts
+function scaffoldOrganizationModel(model, spec) {
+  if (spec.intent === "system") return scaffoldSystem(model, spec);
+  if (spec.intent === "ontology") return scaffoldOntologyRecord(model, spec);
+  if (spec.intent === "resource") return scaffoldResource(model, spec);
+  return scaffoldKnowledgeNode(model, spec);
+}
+
+export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, CRM_ACTION_ENTRIES, CodeReferenceRoleSchema, CodeReferenceSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, DEFAULT_ORGANIZATION_MODEL_ENTITIES, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_NAVIGATION, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_POLICIES, DEFAULT_ORGANIZATION_MODEL_RESOURCES, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, DEFAULT_ORGANIZATION_MODEL_SYSTEMS, DEFAULT_ORGANIZATION_MODEL_TOPOLOGY, EntitiesDomainSchema, EntityIdSchema, EntityLinkKindSchema, EntityLinkSchema, EntitySchema, EventDescriptorSchema, EventEmissionDescriptorSchema, EventIdSchema, FirmographicsSchema, GoalsDomainSchema, HumanRoleHolderSchema, IconNameSchema, IntegrationResourceEntrySchema, KNOWLEDGE_FEATURE_ID, KNOWLEDGE_SYSTEM_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, KnowledgeTargetKindSchema, KnowledgeTargetRefSchema, LEAD_GEN_ACTION_ENTRIES, LEAD_GEN_STAGE_CATALOG, LinkSchema, MONITORING_FEATURE_ID, MONITORING_SYSTEM_ID, McpToolInvocationSchema, NavigationGroupSchema, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, OPERATIONS_SYSTEM_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OmTopologyDomainSchema, OmTopologyMetadataSchema, OmTopologyNodeKindSchema, OmTopologyNodeRefSchema, OmTopologyRelationshipKindSchema, OmTopologyRelationshipSchema, OntologyActionTypeSchema, OntologyCatalogTypeSchema, OntologyEventTypeSchema, OntologyGroupSchema, OntologyIdSchema, OntologyInterfaceTypeSchema, OntologyKindSchema, OntologyLinkTypeSchema, OntologyObjectTypeSchema, OntologyScopeSchema, OntologySharedPropertySchema, OntologySurfaceTypeSchema, OntologyValueTypeSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelDomainKeySchema, OrganizationModelDomainMetadataByDomainSchema, OrganizationModelDomainMetadataSchema, OrganizationModelIconTokenSchema, OrganizationModelNavigationSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_SYSTEM_ID, PROJECTS_VIEW_ACTION_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PROSPECTING_SYSTEM_ID, PoliciesDomainSchema, PolicyApplicabilitySchema, PolicyEffectSchema, PolicyIdSchema, PolicyPredicateSchema, PolicySchema, PolicyTriggerSchema, PricingModelSchema, ProductSchema, ResourceEntrySchema, ResourceGovernanceStatusSchema, ResourceIdSchema, ResourceKindSchema, ResourceOntologyBindingSchema, ResourcesDomainSchema, RoleHolderSchema, RoleHoldersSchema, RoleIdSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SALES_SYSTEM_ID, SEO_FEATURE_ID, SEO_SYSTEM_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, SETTINGS_SYSTEM_ID, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemEntrySchema, SystemIdSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, compileTopologyNodeRef, createFoundationOrganizationModel, defineOrganizationModel, defineResource, defineResourceOntology, defineResources, defineTopology, defineTopologyRelationship, findOrganizationActionById, formatOntologyId, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, isOntologyTopologyRef, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseOntologyId, parseTopologyNodeRef, resolveOrganizationModel, resolveOrganizationModelWithResources, scaffoldOrganizationModel, topologyRef, topologyRelationship };