@elevasis/core 0.15.1 → 0.16.0

package/dist/organization-model/index.js

@@ -1,11 +1,82 @@
 import { z } from 'zod';
 
 // src/organization-model/schema.ts
+var ORGANIZATION_MODEL_ICON_TOKENS = [
+  "nav.dashboard",
+  "nav.sales",
+  "nav.crm",
+  "nav.lead-gen",
+  "nav.projects",
+  "nav.operations",
+  "nav.monitoring",
+  "nav.knowledge",
+  "nav.settings",
+  "nav.admin",
+  "nav.archive",
+  "knowledge.playbook",
+  "knowledge.strategy",
+  "knowledge.reference",
+  "feature.dashboard",
+  "feature.sales",
+  "feature.crm",
+  "feature.finance",
+  "feature.lead-gen",
+  "feature.platform",
+  "feature.projects",
+  "feature.operations",
+  "feature.knowledge",
+  "feature.monitoring",
+  "feature.settings",
+  "feature.admin",
+  "feature.archive",
+  "feature.seo",
+  "resource.agent",
+  "resource.workflow",
+  "resource.integration",
+  "resource.database",
+  "resource.user",
+  "resource.team",
+  "integration.gmail",
+  "integration.google-sheets",
+  "integration.attio",
+  "surface.dashboard",
+  "surface.overview",
+  "surface.command-view",
+  "surface.command-queue",
+  "surface.pipeline",
+  "surface.lists",
+  "surface.resources",
+  "surface.settings",
+  "status.success",
+  "status.error",
+  "status.warning",
+  "status.info",
+  "status.pending",
+  "action.approve",
+  "action.reject",
+  "action.retry",
+  "action.edit",
+  "action.view",
+  "action.launch",
+  "action.message",
+  "action.escalate",
+  "action.promote",
+  "action.submit",
+  "action.email"
+];
+var CustomIconTokenSchema = z.string().trim().max(80).regex(/^custom\.[a-z0-9]+(?:[-._][a-z0-9]+)*$/, "Custom icon tokens must start with custom.");
+var OrganizationModelBuiltinIconTokenSchema = z.enum(ORGANIZATION_MODEL_ICON_TOKENS);
+var OrganizationModelIconTokenSchema = z.union([
+  OrganizationModelBuiltinIconTokenSchema,
+  CustomIconTokenSchema
+]);
+
+// src/organization-model/domains/shared.ts
 var ModelIdSchema = z.string().trim().min(1).max(100).regex(/^[a-z0-9]+(?:[-._][a-z0-9]+)*$/, "IDs must be lowercase and use -, _, or . separators");
 var LabelSchema = z.string().trim().min(1).max(120);
 var DescriptionSchema = z.string().trim().min(1).max(2e3);
 var ColorTokenSchema = z.string().trim().min(1).max(50);
-var IconNameSchema = z.string().trim().min(1).max(80);
+var IconNameSchema = OrganizationModelIconTokenSchema;
 var PathSchema = z.string().trim().startsWith("/").max(300);
 var ReferenceIdsSchema = z.array(ModelIdSchema).default([]);
 var DisplayMetadataSchema = z.object({
@@ -434,6 +505,7 @@ var DEFAULT_ORGANIZATION_MODEL_PROSPECTING = {
 };
 
 // src/organization-model/contracts.ts
+var KNOWLEDGE_FEATURE_ID = "knowledge";
 var PROJECTS_FEATURE_ID = "projects";
 var PROJECTS_INDEX_SURFACE_ID = "projects.index";
 var PROJECTS_VIEW_CAPABILITY_ID = "delivery.projects.view";
@@ -445,7 +517,7 @@ var SETTINGS_FEATURE_ID = "settings";
 var SEO_FEATURE_ID = "seo";
 var SALES_PIPELINE_SURFACE_ID = "crm.pipeline";
 var PROSPECTING_LISTS_SURFACE_ID = "lead-gen.lists";
-var OPERATIONS_COMMAND_VIEW_SURFACE_ID = "operations.command-view";
+var OPERATIONS_COMMAND_VIEW_SURFACE_ID = "knowledge.command-view";
 var SETTINGS_ROLES_SURFACE_ID = "settings.roles";
 
 // src/organization-model/domains/navigation.ts
@@ -870,6 +942,31 @@ var DEFAULT_ORGANIZATION_MODEL_STATUSES = {
     { id: "request.wont_fix", label: "Won't Fix", semanticClass: "request", category: "request" }
   ]
 };
+var KnowledgeLinkSchema = z.object({
+  nodeId: NodeIdStringSchema
+});
+var OrgKnowledgeKindSchema = z.enum(["playbook", "strategy", "reference"]);
+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(),
+  /** 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([]),
+  /** Identifiers of the roles or members who own this knowledge node. */
+  ownerIds: z.array(ModelIdSchema).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.object({
+  nodes: z.array(OrgKnowledgeNodeSchema).default([])
+});
 
 // src/organization-model/schema.ts
 var OrganizationModelSchemaBase = z.object({
@@ -886,7 +983,8 @@ var OrganizationModelSchemaBase = z.object({
   roles: RolesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ROLES),
   goals: GoalsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_GOALS),
   statuses: StatusesDomainSchema.default({ entries: [] }),
-  operations: OperationsDomainSchema.default({ entries: [] })
+  operations: OperationsDomainSchema.default({ entries: [] }),
+  knowledge: KnowledgeDomainSchema.default({ nodes: [] })
 });
 function addIssue(ctx, path, message) {
   ctx.addIssue({
@@ -921,7 +1019,11 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
     if (segments.length > 1) {
       const parentId = segments.slice(0, -1).join(".");
       if (!featuresById.has(parentId)) {
-        addIssue(ctx, ["features", featureIndex, "id"], `Feature "${feature.id}" references unknown parent "${parentId}"`);
+        addIssue(
+          ctx,
+          ["features", featureIndex, "id"],
+          `Feature "${feature.id}" references unknown parent "${parentId}"`
+        );
       }
     }
     const hasChildren = model.features.some(
@@ -985,7 +1087,8 @@ var OrganizationGraphNodeKindSchema = z.enum([
   "surface",
   "entity",
   "capability",
-  "resource"
+  "resource",
+  "knowledge"
 ]);
 var OrganizationGraphEdgeKindSchema = z.enum([
   "contains",
@@ -993,7 +1096,8 @@ var OrganizationGraphEdgeKindSchema = z.enum([
   "exposes",
   "maps_to",
   "operates-on",
-  "uses"
+  "uses",
+  "governs"
 ]);
 var OrganizationGraphNodeSchema = z.object({
   id: z.string().trim().min(1).max(200),
@@ -1001,6 +1105,7 @@ var OrganizationGraphNodeSchema = z.object({
   label: LabelSchema,
   sourceId: z.string().trim().min(1).max(255).optional(),
   description: DescriptionSchema.optional(),
+  icon: IconNameSchema.optional(),
   enabled: z.boolean().optional(),
   featureId: z.string().trim().min(1).max(100).optional(),
   resourceType: z.enum(["workflow", "agent", "trigger", "integration", "external", "human_checkpoint"]).optional()
@@ -1031,6 +1136,9 @@ var LinkSchema = z.object({
 });
 
 // src/organization-model/defaults.ts
+var DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE = {
+  nodes: []
+};
 var DEFAULT_ORGANIZATION_MODEL = {
   version: 1,
   features: [
@@ -1039,16 +1147,39 @@ var DEFAULT_ORGANIZATION_MODEL = {
       label: "Dashboard",
       enabled: true,
       path: "/",
-      icon: "dashboard",
+      icon: "feature.dashboard",
       uiPosition: "sidebar-primary"
     },
+    {
+      id: "identity",
+      label: "Identity",
+      description: "Company identity, positioning, and market context",
+      enabled: true,
+      color: "indigo"
+    },
+    {
+      id: "platform",
+      label: "Platform",
+      description: "Elevasis platform architecture, capabilities, and implementation patterns",
+      enabled: true,
+      color: "cyan",
+      icon: "feature.platform"
+    },
+    {
+      id: "finance",
+      label: "Finance",
+      description: "Finance operations, accounting, billing, reconciliation, and tax prep",
+      enabled: true,
+      color: "green",
+      icon: "feature.finance"
+    },
     {
       id: "sales",
       label: "Sales",
       description: "Revenue workflows and customer acquisition",
       enabled: true,
       color: "blue",
-      icon: "crm",
+      icon: "feature.sales",
       uiPosition: "sidebar-primary"
     },
     {
@@ -1057,7 +1188,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       description: "Relationship pipeline and deal management",
       enabled: true,
       color: "blue",
-      icon: "crm",
+      icon: "feature.crm",
       path: "/crm"
     },
     {
@@ -1066,7 +1197,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       description: "Prospecting, qualification, and outreach preparation",
       enabled: true,
       color: "cyan",
-      icon: "lead-gen",
+      icon: "feature.lead-gen",
       path: "/lead-gen"
     },
     {
@@ -1075,7 +1206,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       description: "Projects, milestones, and client work execution",
       enabled: true,
       color: "orange",
-      icon: "projects",
+      icon: "feature.projects",
       path: "/projects",
       uiPosition: "sidebar-primary"
     },
@@ -1085,14 +1216,14 @@ var DEFAULT_ORGANIZATION_MODEL = {
       description: "Operational resources, topology, and orchestration visibility",
       enabled: true,
       color: "violet",
-      icon: "operations",
+      icon: "feature.operations",
       uiPosition: "sidebar-primary"
     },
     {
-      id: "operations.command-view",
+      id: "knowledge.command-view",
       label: "Command View",
       enabled: true,
-      path: "/operations/command-view",
+      path: "/knowledge/command-view",
       devOnly: true
     },
     {
@@ -1171,7 +1302,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       id: "settings",
       label: "Settings",
       enabled: true,
-      icon: "settings",
+      icon: "feature.settings",
       uiPosition: "sidebar-bottom"
     },
     {
@@ -1227,7 +1358,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       label: "Admin",
       enabled: true,
       path: "/admin",
-      icon: "settings",
+      icon: "feature.admin",
       uiPosition: "sidebar-bottom",
       requiresAdmin: true
     },
@@ -1266,7 +1397,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
       label: "Archive",
       enabled: true,
       path: "/archive",
-      icon: "archive",
+      icon: "feature.archive",
       uiPosition: "sidebar-bottom",
       devOnly: true
     },
@@ -1287,6 +1418,21 @@ var DEFAULT_ORGANIZATION_MODEL = {
       label: "SEO",
       enabled: false,
       path: "/seo"
+    },
+    {
+      id: "knowledge",
+      label: "Knowledge",
+      description: "Operational knowledge, playbooks, and strategy docs",
+      enabled: true,
+      color: "teal",
+      icon: "feature.knowledge",
+      uiPosition: "sidebar-primary"
+    },
+    {
+      id: "knowledge.base",
+      label: "Knowledge Base",
+      enabled: true,
+      path: "/knowledge"
     }
   ],
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
@@ -1300,7 +1446,8 @@ var DEFAULT_ORGANIZATION_MODEL = {
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
   goals: DEFAULT_ORGANIZATION_MODEL_GOALS,
   statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES,
-  operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS
+  operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
+  knowledge: DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE
 };
 
 // src/organization-model/resolve.ts
@@ -1355,11 +1502,11 @@ function createFoundationOrganizationModel(override) {
   const leadGenFeature = requireCoreFeature("sales.lead-gen");
   const crmFeature = requireCoreFeature("sales.crm");
   const navigationSurfaces = [
-    { ...operationsFeature, id: "operations", path: "/operations", icon: "operations", surfaceType: "dashboard" },
-    { ...projectsFeature, icon: "projects", surfaceType: "list" },
-    { ...leadGenFeature, id: "lead-gen", icon: "lead-gen", surfaceType: "list" },
-    { ...crmFeature, id: "crm", icon: "crm", surfaceType: "graph" },
-    { ...requireCoreFeature("settings.account"), id: "settings", icon: "settings", surfaceType: "settings" }
+    { ...operationsFeature, id: "operations", path: "/operations", icon: "feature.operations", surfaceType: "dashboard" },
+    { ...projectsFeature, icon: "feature.projects", surfaceType: "list" },
+    { ...leadGenFeature, id: "lead-gen", icon: "feature.lead-gen", surfaceType: "list" },
+    { ...crmFeature, id: "crm", icon: "feature.crm", surfaceType: "graph" },
+    { ...requireCoreFeature("settings.account"), id: "settings", icon: "feature.settings", surfaceType: "settings" }
   ];
   const homeLabel = "Dashboard";
   const quickAccessSurfaceIds = ["operations", "projects", "lead-gen", "crm"];
@@ -1384,4 +1531,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, KeyResultSchema, LinkSchema, MONITORING_FEATURE_ID, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, ObjectiveSchema, OfferingsDomainSchema, OperationEntrySchema, OperationSemanticClassSchema, OperationsDomainSchema, 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 { 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 };