@elevasis/core 0.21.0 → 0.22.0

package/dist/organization-model/index.js

@@ -19,6 +19,7 @@ var ORGANIZATION_MODEL_ICON_TOKENS = [
   "knowledge.reference",
   "feature.dashboard",
   "feature.calendar",
+  "feature.business",
   "feature.sales",
   "feature.crm",
   "feature.finance",
@@ -969,13 +970,113 @@ var OfferingsDomainSchema = z.object({
 var DEFAULT_ORGANIZATION_MODEL_OFFERINGS = {
   products: []
 };
+var SystemKindSchema = z.enum(["product", "operational", "platform", "diagnostic"]);
+var SystemStatusSchema = z.enum(["active", "deprecated", "archived"]);
+var SystemIdSchema = ModelIdSchema;
+var SystemEntrySchema = z.object({
+  /** Stable tenant-defined system id (e.g. "sys.lead-gen"). */
+  id: SystemIdSchema,
+  /** Human-readable system title shown in governance and operations UI. */
+  title: LabelSchema,
+  /** One-paragraph purpose statement for the bounded context. */
+  description: DescriptionSchema,
+  /** Closed system shape enum; catalog values remain tenant-defined. */
+  kind: SystemKindSchema,
+  /** Optional role responsible for this system. */
+  responsibleRoleId: ModelIdSchema.optional(),
+  /** Optional knowledge nodes that govern this system. */
+  governedByKnowledge: ReferenceIdsSchema,
+  /** Optional goals this system contributes to. */
+  drivesGoals: ReferenceIdsSchema,
+  status: SystemStatusSchema
+});
+var SystemsDomainSchema = z.object({
+  systems: z.array(SystemEntrySchema).default([])
+});
+var DEFAULT_ORGANIZATION_MODEL_SYSTEMS = {
+  systems: []
+};
+
+// src/organization-model/domains/resources.ts
+var ResourceKindSchema = z.enum(["workflow", "agent", "integration"]);
+var ResourceGovernanceStatusSchema = z.enum(["active", "deprecated", "archived"]);
+var AgentKindSchema = z.enum(["orchestrator", "specialist", "utility", "system"]);
+var ResourceIdSchema = z.string().trim().min(1).max(255).regex(/^[A-Za-z0-9]+(?:[-._][A-Za-z0-9]+)*$/, "Resource IDs must use letters, numbers, -, _, or . separators");
+var ResourceEntryBaseSchema = z.object({
+  /** Canonical resource id; runtime resourceId derives from this value. */
+  id: ResourceIdSchema,
+  /** Required single System membership. */
+  systemId: SystemIdSchema,
+  /** Optional role responsible for maintaining this resource. */
+  ownerRoleId: ModelIdSchema.optional(),
+  status: ResourceGovernanceStatusSchema
+});
+var WorkflowResourceEntrySchema = ResourceEntryBaseSchema.extend({
+  kind: z.literal("workflow"),
+  /** Mirrors WorkflowConfig.capabilityKey when the runtime workflow has one. */
+  capabilityKey: z.string().trim().min(1).max(255).optional()
+});
+var AgentResourceEntrySchema = ResourceEntryBaseSchema.extend({
+  kind: z.literal("agent"),
+  /** Mirrors code-side AgentConfig.kind. */
+  agentKind: AgentKindSchema,
+  /** Role this agent embodies, if any. */
+  actsAsRoleId: ModelIdSchema.optional(),
+  /** Mirrors AgentConfig.sessionCapable. */
+  sessionCapable: z.boolean()
+});
+var IntegrationResourceEntrySchema = ResourceEntryBaseSchema.extend({
+  kind: z.literal("integration"),
+  provider: z.string().trim().min(1).max(100)
+});
+var ResourceEntrySchema = z.discriminatedUnion("kind", [
+  WorkflowResourceEntrySchema,
+  AgentResourceEntrySchema,
+  IntegrationResourceEntrySchema
+]);
+var ResourcesDomainSchema = z.object({
+  entries: z.array(ResourceEntrySchema).default([])
+});
+var DEFAULT_ORGANIZATION_MODEL_RESOURCES = {
+  entries: []
+};
+function defineResource(resource) {
+  return ResourceEntrySchema.parse(resource);
+}
+function defineResources(resources) {
+  for (const resource of Object.values(resources)) {
+    ResourceEntrySchema.parse(resource);
+  }
+  return resources;
+}
+
+// src/organization-model/domains/roles.ts
+var RoleIdSchema = ModelIdSchema;
+var HumanRoleHolderSchema = z.object({
+  kind: z.literal("human"),
+  userId: z.string().trim().min(1).max(200)
+});
+var AgentRoleHolderSchema = z.object({
+  kind: z.literal("agent"),
+  agentId: ResourceIdSchema
+});
+var TeamRoleHolderSchema = z.object({
+  kind: z.literal("team"),
+  memberIds: z.array(z.string().trim().min(1).max(200)).min(1)
+});
+var RoleHolderSchema = z.discriminatedUnion("kind", [
+  HumanRoleHolderSchema,
+  AgentRoleHolderSchema,
+  TeamRoleHolderSchema
+]);
+var RoleHoldersSchema = z.union([RoleHolderSchema, z.array(RoleHolderSchema).min(1)]);
 var RoleSchema = z.object({
   /** Stable unique identifier for the role (e.g. "role-ceo", "role-head-of-sales"). */
-  id: z.string().trim().min(1).max(100),
+  id: RoleIdSchema,
   /** Human-readable title shown to agents and in UI (e.g. "CEO", "Head of Sales"). */
   title: z.string().trim().min(1).max(200),
   /**
-   * List of responsibilities this role owns — plain-language descriptions of
+   * List of responsibilities this role owns - plain-language descriptions of
    * what the person in this role is accountable for delivering.
    * Defaults to empty array so minimal role definitions stay concise.
    */
@@ -983,16 +1084,18 @@ var RoleSchema = z.object({
   /**
    * Optional: ID of another role this role reports to.
    * When present, must reference another `roles[].id` in the same organization.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   * Absence indicates a top-level role (no reporting line).
    */
-  reportsToId: z.string().trim().min(1).max(100).optional(),
+  reportsToId: RoleIdSchema.optional(),
   /**
-   * Optional: name or email of the person currently holding this role.
-   * Free-form string — supports "Alice Johnson", "alice@example.com", or
-   * any human-readable identifier. Not validated against any user registry.
+   * Optional: human, agent, or team holder currently filling this role.
+   * Agent holders reference OM Resource IDs and are validated at the model level.
    */
-  heldBy: z.string().trim().max(200).optional()
+  heldBy: RoleHoldersSchema.optional(),
+  /**
+   * Optional Systems this role is accountable for.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   */
+  responsibleFor: z.array(SystemIdSchema).optional()
 });
 var RolesDomainSchema = z.object({
   roles: z.array(RoleSchema).default([])
@@ -1227,8 +1330,8 @@ var OrgKnowledgeNodeSchema = z.object({
   skills: z.array(KnowledgeSkillBindingSchema).optional(),
   /** Domain key used to derive fast graph->skill registries. */
   domain: KnowledgeDomainBindingSchema.optional(),
-  /** Identifiers of the roles or members who own this knowledge node. */
-  ownerIds: z.array(ModelIdSchema).default([]),
+  /** Role identifiers that own this knowledge node. */
+  ownerIds: z.array(RoleIdSchema).default([]),
   /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
   updatedAt: z.string().trim().min(1).max(50)
 });
@@ -1250,6 +1353,8 @@ var OrganizationModelSchemaBase = z.object({
   offerings: OfferingsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_OFFERINGS),
   roles: RolesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ROLES),
   goals: GoalsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_GOALS),
+  systems: SystemsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_SYSTEMS),
+  resources: ResourcesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_RESOURCES),
   statuses: StatusesDomainSchema.default({ entries: [] }),
   operations: OperationsDomainSchema.default({ entries: [] }),
   knowledge: KnowledgeDomainSchema.default({ nodes: [] })
@@ -1283,6 +1388,9 @@ function hasFeature(featuresById, featureId) {
 function defaultFeaturePathFor(id) {
   return `/${id.replaceAll(".", "/")}`;
 }
+function asRoleHolderArray(heldBy) {
+  return Array.isArray(heldBy) ? heldBy : [heldBy];
+}
 var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ctx) => {
   const featuresById = collectIds(model.features, ctx, ["features"], "Feature");
   const featureIdsByEffectivePath = /* @__PURE__ */ new Map();
@@ -1393,6 +1501,8 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
       );
     }
   });
+  const goalsById = new Map(model.goals.objectives.map((objective) => [objective.id, objective]));
+  const knowledgeById = new Map(model.knowledge.nodes.map((node) => [node.id, node]));
   const rolesById = new Map(model.roles.roles.map((role) => [role.id, role]));
   model.roles.roles.forEach((role, roleIndex) => {
     if (role.reportsToId !== void 0 && !rolesById.has(role.reportsToId)) {
@@ -1403,6 +1513,102 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
       );
     }
   });
+  const systemsById = collectIds(model.systems.systems, ctx, ["systems", "systems"], "System");
+  model.roles.roles.forEach((role, roleIndex) => {
+    role.responsibleFor?.forEach((systemId, systemIndex) => {
+      if (!systemsById.has(systemId)) {
+        addIssue(
+          ctx,
+          ["roles", "roles", roleIndex, "responsibleFor", systemIndex],
+          `Role "${role.id}" references unknown responsibleFor system "${systemId}"`
+        );
+      }
+    });
+  });
+  model.systems.systems.forEach((system, systemIndex) => {
+    if (system.responsibleRoleId !== void 0 && !rolesById.has(system.responsibleRoleId)) {
+      addIssue(
+        ctx,
+        ["systems", "systems", systemIndex, "responsibleRoleId"],
+        `System "${system.id}" references unknown responsibleRoleId "${system.responsibleRoleId}"`
+      );
+    }
+    system.governedByKnowledge.forEach((nodeId, nodeIndex) => {
+      if (!knowledgeById.has(nodeId)) {
+        addIssue(
+          ctx,
+          ["systems", "systems", systemIndex, "governedByKnowledge", nodeIndex],
+          `System "${system.id}" references unknown knowledge node "${nodeId}"`
+        );
+      }
+    });
+    system.drivesGoals.forEach((goalId, goalIndex) => {
+      if (!goalsById.has(goalId)) {
+        addIssue(
+          ctx,
+          ["systems", "systems", systemIndex, "drivesGoals", goalIndex],
+          `System "${system.id}" references unknown goal "${goalId}"`
+        );
+      }
+    });
+  });
+  const resourcesById = collectIds(model.resources.entries, ctx, ["resources", "entries"], "Resource");
+  model.resources.entries.forEach((resource, resourceIndex) => {
+    if (!systemsById.has(resource.systemId)) {
+      addIssue(
+        ctx,
+        ["resources", "entries", resourceIndex, "systemId"],
+        `Resource "${resource.id}" references unknown systemId "${resource.systemId}"`
+      );
+    }
+    if (resource.ownerRoleId !== void 0 && !rolesById.has(resource.ownerRoleId)) {
+      addIssue(
+        ctx,
+        ["resources", "entries", resourceIndex, "ownerRoleId"],
+        `Resource "${resource.id}" references unknown ownerRoleId "${resource.ownerRoleId}"`
+      );
+    }
+    if (resource.kind === "agent" && resource.actsAsRoleId !== void 0 && !rolesById.has(resource.actsAsRoleId)) {
+      addIssue(
+        ctx,
+        ["resources", "entries", resourceIndex, "actsAsRoleId"],
+        `Agent resource "${resource.id}" references unknown actsAsRoleId "${resource.actsAsRoleId}"`
+      );
+    }
+  });
+  model.roles.roles.forEach((role, roleIndex) => {
+    if (role.heldBy === void 0) return;
+    asRoleHolderArray(role.heldBy).forEach((holder, holderIndex) => {
+      if (holder.kind !== "agent") return;
+      const resource = resourcesById.get(holder.agentId);
+      if (resource === void 0) {
+        addIssue(
+          ctx,
+          ["roles", "roles", roleIndex, "heldBy", Array.isArray(role.heldBy) ? holderIndex : "agentId"],
+          `Role "${role.id}" references unknown agent holder resource "${holder.agentId}"`
+        );
+        return;
+      }
+      if (resource.kind !== "agent") {
+        addIssue(
+          ctx,
+          ["roles", "roles", roleIndex, "heldBy", Array.isArray(role.heldBy) ? holderIndex : "agentId"],
+          `Role "${role.id}" agent holder "${holder.agentId}" must reference an agent resource`
+        );
+      }
+    });
+  });
+  model.knowledge.nodes.forEach((node, nodeIndex) => {
+    node.ownerIds.forEach((roleId, ownerIndex) => {
+      if (!rolesById.has(roleId)) {
+        addIssue(
+          ctx,
+          ["knowledge", "nodes", nodeIndex, "ownerIds", ownerIndex],
+          `Knowledge node "${node.id}" references unknown owner role "${roleId}"`
+        );
+      }
+    });
+  });
 });
 var OrganizationGraphNodeKindSchema = z.enum([
   "organization",
@@ -1497,6 +1703,15 @@ var DEFAULT_ORGANIZATION_MODEL = {
       color: "green",
       icon: "feature.finance"
     },
+    {
+      id: "business",
+      label: "Business",
+      description: "Revenue, client relationships, and project delivery",
+      enabled: true,
+      color: "blue",
+      icon: "feature.business",
+      uiPosition: "sidebar-primary"
+    },
     {
       id: "sales",
       label: "Sales",
@@ -1504,7 +1719,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       enabled: true,
       color: "blue",
       icon: "feature.sales",
-      uiPosition: "sidebar-primary"
+      path: "/sales"
     },
     {
       id: "sales.crm",
@@ -1531,8 +1746,16 @@ var DEFAULT_ORGANIZATION_MODEL = {
       enabled: true,
       color: "orange",
       icon: "feature.projects",
-      path: "/projects",
-      uiPosition: "sidebar-primary"
+      path: "/projects"
+    },
+    {
+      id: "clients",
+      label: "Clients",
+      description: "Client relationships, accounts, and business context",
+      enabled: true,
+      color: "orange",
+      icon: "feature.projects",
+      path: "/business/clients"
     },
     {
       id: "operations",
@@ -1777,6 +2000,8 @@ var DEFAULT_ORGANIZATION_MODEL = {
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
   goals: DEFAULT_ORGANIZATION_MODEL_GOALS,
+  systems: DEFAULT_ORGANIZATION_MODEL_SYSTEMS,
+  resources: DEFAULT_ORGANIZATION_MODEL_RESOURCES,
   statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES,
   operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
   knowledge: DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE
@@ -1863,4 +2088,4 @@ function createFoundationOrganizationModel(override) {
   };
 }
 
-export { CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_OPERATIONS, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, FeatureSchema, FirmographicsSchema, GoalsDomainSchema, IconNameSchema, KNOWLEDGE_FEATURE_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, LinkSchema, MONITORING_FEATURE_ID, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OperationEntrySchema, OperationSemanticClassSchema, OperationsDomainSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelIconTokenSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_VIEW_CAPABILITY_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PricingModelSchema, ProductSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SEO_FEATURE_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, TechStackEntrySchema, UiPositionSchema, createFoundationOrganizationModel, defineOrganizationModel, resolveOrganizationModel };
+export { AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_OPERATIONS, DEFAULT_ORGANIZATION_MODEL_RESOURCES, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, DEFAULT_ORGANIZATION_MODEL_SYSTEMS, FeatureSchema, FirmographicsSchema, GoalsDomainSchema, HumanRoleHolderSchema, IconNameSchema, IntegrationResourceEntrySchema, KNOWLEDGE_FEATURE_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, LinkSchema, MONITORING_FEATURE_ID, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OperationEntrySchema, OperationSemanticClassSchema, OperationsDomainSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelIconTokenSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_VIEW_CAPABILITY_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PricingModelSchema, ProductSchema, ResourceEntrySchema, ResourceGovernanceStatusSchema, ResourceIdSchema, ResourceKindSchema, ResourcesDomainSchema, RoleHolderSchema, RoleHoldersSchema, RoleIdSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SEO_FEATURE_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SystemEntrySchema, SystemIdSchema, SystemKindSchema, SystemStatusSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, UiPositionSchema, WorkflowResourceEntrySchema, createFoundationOrganizationModel, defineOrganizationModel, defineResource, defineResources, resolveOrganizationModel };