@elevasis/core 0.39.0 → 0.41.0

package/dist/organization-model/index.js

@@ -740,6 +740,15 @@ function defineDomainRecord(schema, entries) {
 function childSystemsOf2(system) {
   return system.systems ?? system.subsystems ?? {};
 }
+function listClientProfiles(model) {
+  return Object.values(model.clients ?? {}).sort((a, b) => a.slug.localeCompare(b.slug));
+}
+function getClientProfile(model, id) {
+  return model.clients?.[id];
+}
+function getClientProfileBySlug(model, slug) {
+  return Object.values(model.clients ?? {}).find((client) => client.slug === slug);
+}
 function getSystem(model, path) {
   const flatMatch = model.systems[path];
   if (flatMatch !== void 0) return flatMatch;
@@ -1425,6 +1434,7 @@ function defineGoals(entries) {
 }
 var KnowledgeTargetKindSchema = z.enum([
   "system",
+  "client",
   "resource",
   "knowledge",
   "stage",
@@ -1800,6 +1810,7 @@ function buildOmCrossRefIndex(model) {
     systemsById.set(system.id, system);
   }
   const resourceIds = new Set(Object.keys(model.resources ?? {}));
+  const clientIds = new Set(Object.keys(model.clients ?? {}));
   const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}));
   const roleIds = new Set(Object.keys(model.roles ?? {}));
   const goalIds = new Set(Object.keys(model.goals ?? {}));
@@ -1833,6 +1844,7 @@ function buildOmCrossRefIndex(model) {
   return {
     systemsById,
     resourceIds,
+    clientIds,
     knowledgeIds,
     roleIds,
     goalIds,
@@ -1846,6 +1858,7 @@ function buildOmCrossRefIndex(model) {
 }
 function knowledgeTargetExists(index, kind, id) {
   if (kind === "system") return index.systemsById.has(id);
+  if (kind === "client") return index.clientIds.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);
@@ -1879,10 +1892,10 @@ function asRoleHolderArray(heldBy) {
 function isKnowledgeKindCompatibleWithTarget(knowledgeKind, targetKind) {
   if (knowledgeKind === "reference") return true;
   if (knowledgeKind === "playbook") {
-    return ["system", "resource", "stage", "action", "ontology"].includes(targetKind);
+    return ["system", "client", "resource", "stage", "action", "ontology"].includes(targetKind);
   }
   if (knowledgeKind === "strategy") {
-    return ["system", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
+    return ["system", "client", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
   }
   return false;
 }
@@ -2410,9 +2423,68 @@ function refineOrganizationModel(model, ctx) {
 }
 
 // src/organization-model/schema.ts
+var ClientProfileIdSchema = z.string().uuid();
+var ClientProfileStatusSchema = z.enum(["active", "onboarding", "paused", "completed", "churned"]);
+var ClientProfileSourceSchema = z.string().trim().min(1).max(64).regex(/^[a-z][a-z0-9_]*$/, "Source must use lowercase letters, numbers, and underscores");
+var ClientProfileIdentitySchema = z.object({
+  organizationName: LabelSchema.optional(),
+  shortName: z.string().trim().min(1).max(40).optional(),
+  clientBrief: z.string().trim().max(4e3).default(""),
+  geographicFocus: z.array(z.string().trim().min(1).max(200)).default([]),
+  timeZone: z.string().trim().min(1).max(100).default("UTC")
+}).passthrough().default({
+  clientBrief: "",
+  geographicFocus: [],
+  timeZone: "UTC"
+});
+var ClientProfileBrandingSchema = z.object({
+  voice: z.string().trim().max(280).optional(),
+  tagline: z.string().trim().max(200).optional(),
+  values: z.array(z.string().trim().min(1).max(100)).default([])
+}).passthrough().default({
+  values: []
+});
+var ClientProfileWorkspaceSchema = z.object({
+  kind: z.enum(["external-project", "internal-project", "none"]).optional(),
+  owner: z.enum(["developer", "client", "platform"]).optional(),
+  projectId: z.string().trim().min(1).max(200).optional(),
+  workspacePath: z.string().trim().min(1).max(500).optional()
+}).passthrough().default({});
+var ClientProfileLinksSchema = z.object({
+  projectIds: z.array(z.string().uuid()).default([]),
+  primaryCompanyId: z.string().uuid().optional(),
+  primaryContactId: z.string().uuid().optional(),
+  sourceDealId: z.string().uuid().optional()
+}).default({
+  projectIds: []
+});
+var ClientProfilePromptsSchema = z.object({
+  defaultContext: z.string().trim().max(8e3).default("")
+}).passthrough().default({
+  defaultContext: ""
+});
+var ClientProfileSchema = z.object({
+  id: ClientProfileIdSchema,
+  slug: ModelIdSchema,
+  name: LabelSchema,
+  status: ClientProfileStatusSchema.default("onboarding"),
+  source: ClientProfileSourceSchema.optional(),
+  identity: ClientProfileIdentitySchema,
+  branding: ClientProfileBrandingSchema,
+  workspace: ClientProfileWorkspaceSchema,
+  links: ClientProfileLinksSchema,
+  prompts: ClientProfilePromptsSchema,
+  config: z.record(z.string().trim().min(1).max(200), JsonValueSchema).default({}),
+  customValues: z.record(z.string().trim().min(1).max(200), JsonValueSchema).default({})
+}).strict();
+var ClientProfilesDomainSchema = z.record(ClientProfileIdSchema, ClientProfileSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each client profile id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_CLIENTS = {};
 var OrganizationModelDomainKeySchema = z.enum([
   "branding",
   "identity",
+  "clients",
   "customers",
   "offerings",
   "roles",
@@ -2433,6 +2505,7 @@ var OrganizationModelDomainMetadataSchema = z.object({
 var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
   branding: { version: 1, lastModified: "2026-05-10" },
   identity: { version: 1, lastModified: "2026-05-10" },
+  clients: { version: 1, lastModified: "2026-05-30" },
   customers: { version: 1, lastModified: "2026-05-10" },
   offerings: { version: 1, lastModified: "2026-05-10" },
   roles: { version: 1, lastModified: "2026-05-10" },
@@ -2449,6 +2522,7 @@ var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
 var OrganizationModelDomainMetadataByDomainSchema = z.object({
   branding: OrganizationModelDomainMetadataSchema,
   identity: OrganizationModelDomainMetadataSchema,
+  clients: OrganizationModelDomainMetadataSchema,
   customers: OrganizationModelDomainMetadataSchema,
   offerings: OrganizationModelDomainMetadataSchema,
   roles: OrganizationModelDomainMetadataSchema,
@@ -2464,10 +2538,23 @@ var OrganizationModelDomainMetadataByDomainSchema = z.object({
 }).partial().default(DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA).transform((metadata) => ({ ...DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, ...metadata }));
 var OrganizationModelSchemaBase = z.object({
   version: z.literal(1).default(1),
+  /**
+   * Deterministic SHA-256 hex hash of the full resolved model, excluding this
+   * field itself and volatile domainMetadata.lastModified values.
+   *
+   * Stamped at deploy time by the platform OM assembly and persisted alongside
+   * the snapshot in the DB. Compared at API boot to detect stale deployed
+   * snapshots (primary gate: deploy; secondary backstop: boot).
+   *
+   * Optional — absent on models that predate Step 2 versioning or that have
+   * not been stamped (e.g. tenant partial overrides before re-deploy).
+   */
+  snapshotHash: z.string().optional(),
   domainMetadata: OrganizationModelDomainMetadataByDomainSchema,
   branding: OrganizationModelBrandingSchema.default(DEFAULT_ORGANIZATION_MODEL_BRANDING),
   navigation: OrganizationModelNavigationSchema,
   identity: IdentityDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_IDENTITY),
+  clients: ClientProfilesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CLIENTS),
   customers: CustomersDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CUSTOMERS),
   offerings: OfferingsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_OFFERINGS),
   roles: RolesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ROLES),
@@ -2486,6 +2573,7 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine(refineOrga
 var OrganizationGraphNodeKindSchema = z.enum([
   "organization",
   "system",
+  "client",
   "role",
   "action",
   "entity",
@@ -2597,6 +2685,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION2,
   identity: DEFAULT_ORGANIZATION_MODEL_IDENTITY,
+  clients: DEFAULT_ORGANIZATION_MODEL_CLIENTS,
   customers: DEFAULT_ORGANIZATION_MODEL_CUSTOMERS,
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
@@ -3492,4 +3581,4 @@ function scaffoldOrganizationModel(model, spec) {
   return scaffoldKnowledgeNode(model, spec);
 }
 
-export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, CodeReferenceRoleSchema, CodeReferenceSchema, ContractRefSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, 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, 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, OmTopologySystemInterfaceGrantMetadataSchema, OmTopologySystemInterfaceGrantSchema, 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, SYSTEM_INTERFACE_PROFILES, SYSTEM_INTERFACE_READINESS_PROFILES, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemApiInterfaceSchema, SystemEntrySchema, SystemIdSchema, SystemInterfaceKeySchema, SystemInterfaceLifecycleSchema, SystemInterfaceReadinessProfileSchema, SystemInterfaceRefSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, TopbarActionNodeSchema, TopbarSectionSchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, compileTopologyNodeRef, createFoundationOrganizationModel, defineAction, defineActions, defineCustomer, defineCustomers, defineDomainRecord, defineEntities, defineEntity, defineGoal, defineGoals, defineKnowledgeNode, defineKnowledgeNodes, defineOffering, defineOfferings, defineOrganizationModel, definePolicies, definePolicy, defineResource, defineResourceOntology, defineResources, defineRole, defineRoles, defineStatus, defineStatuses, defineSystem, defineSystems, defineTopology, defineTopologyRelationship, findOrganizationActionById, formatOntologyId, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, isOntologyTopologyRef, listAllSystems, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseContractRef, parseOntologyId, parseTopologyNodeRef, projectOrganizationSurfaces, resolveOrganizationModel, resolveOrganizationModelWithResources, scaffoldOrganizationModel, topologyRef, topologyRelationship, validateOrganizationSurfaceProjection };
+export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, ClientProfileBrandingSchema, ClientProfileIdentitySchema, ClientProfileLinksSchema, ClientProfilePromptsSchema, ClientProfileSchema, ClientProfileSourceSchema, ClientProfileStatusSchema, ClientProfileWorkspaceSchema, ClientProfilesDomainSchema, CodeReferenceRoleSchema, CodeReferenceSchema, ContractRefSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, 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, 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, OmTopologySystemInterfaceGrantMetadataSchema, OmTopologySystemInterfaceGrantSchema, 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, SYSTEM_INTERFACE_PROFILES, SYSTEM_INTERFACE_READINESS_PROFILES, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemApiInterfaceSchema, SystemEntrySchema, SystemIdSchema, SystemInterfaceKeySchema, SystemInterfaceLifecycleSchema, SystemInterfaceReadinessProfileSchema, SystemInterfaceRefSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, TopbarActionNodeSchema, TopbarSectionSchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, compileTopologyNodeRef, createFoundationOrganizationModel, defineAction, defineActions, defineCustomer, defineCustomers, defineDomainRecord, defineEntities, defineEntity, defineGoal, defineGoals, defineKnowledgeNode, defineKnowledgeNodes, defineOffering, defineOfferings, defineOrganizationModel, definePolicies, definePolicy, defineResource, defineResourceOntology, defineResources, defineRole, defineRoles, defineStatus, defineStatuses, defineSystem, defineSystems, defineTopology, defineTopologyRelationship, findOrganizationActionById, formatOntologyId, getClientProfile, getClientProfileBySlug, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, isOntologyTopologyRef, listAllSystems, listClientProfiles, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseContractRef, parseOntologyId, parseTopologyNodeRef, projectOrganizationSurfaces, resolveOrganizationModel, resolveOrganizationModelWithResources, scaffoldOrganizationModel, topologyRef, topologyRelationship, validateOrganizationSurfaceProjection };

package/dist/test-utils/index.d.ts

@@ -1255,6 +1255,7 @@ type Database = {
                     organization_id: string;
                     primary_company_id: string | null;
                     primary_contact_id: string | null;
+                    source: string;
                     source_deal_id: string | null;
                     status: string;
                     updated_at: string;
@@ -1268,6 +1269,7 @@ type Database = {
                     organization_id: string;
                     primary_company_id?: string | null;
                     primary_contact_id?: string | null;
+                    source?: string;
                     source_deal_id?: string | null;
                     status?: string;
                     updated_at?: string;
@@ -1281,6 +1283,7 @@ type Database = {
                     organization_id?: string;
                     primary_company_id?: string | null;
                     primary_contact_id?: string | null;
+                    source?: string;
                     source_deal_id?: string | null;
                     status?: string;
                     updated_at?: string;
@@ -3757,6 +3760,41 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
 }, z.core.$strip>>;
 type OntologyScope = z.infer<typeof OntologyScopeSchema>;
 
+declare const SurfaceTypeSchema: z.ZodEnum<{
+    dashboard: "dashboard";
+    settings: "settings";
+    graph: "graph";
+    page: "page";
+    detail: "detail";
+    list: "list";
+}>;
+interface SidebarSurfaceNode {
+    type: 'surface';
+    label: string;
+    path: string;
+    surfaceType: z.infer<typeof SurfaceTypeSchema>;
+    description?: string;
+    icon?: string;
+    order?: number;
+    targets?: {
+        systems?: string[];
+        entities?: string[];
+        resources?: string[];
+        actions?: string[];
+    };
+    devOnly?: boolean;
+    requiresAdmin?: boolean;
+}
+interface SidebarGroupNode {
+    type: 'group';
+    label: string;
+    description?: string;
+    icon?: string;
+    order?: number;
+    children: Record<string, SidebarNode>;
+}
+type SidebarNode = SidebarSurfaceNode | SidebarGroupNode;
+
 declare const SystemApiInterfaceSchema: z.ZodObject<{
     lifecycle: z.ZodDefault<z.ZodEnum<{
         active: "active";
@@ -3817,41 +3855,6 @@ interface SystemEntry {
     subsystems?: Record<string, SystemEntry>;
 }
 
-declare const SurfaceTypeSchema: z.ZodEnum<{
-    dashboard: "dashboard";
-    settings: "settings";
-    graph: "graph";
-    page: "page";
-    detail: "detail";
-    list: "list";
-}>;
-interface SidebarSurfaceNode {
-    type: 'surface';
-    label: string;
-    path: string;
-    surfaceType: z.infer<typeof SurfaceTypeSchema>;
-    description?: string;
-    icon?: string;
-    order?: number;
-    targets?: {
-        systems?: string[];
-        entities?: string[];
-        resources?: string[];
-        actions?: string[];
-    };
-    devOnly?: boolean;
-    requiresAdmin?: boolean;
-}
-interface SidebarGroupNode {
-    type: 'group';
-    label: string;
-    description?: string;
-    icon?: string;
-    order?: number;
-    children: Record<string, SidebarNode>;
-}
-type SidebarNode = SidebarSurfaceNode | SidebarGroupNode;
-
 type OrganizationModel = z.infer<typeof OrganizationModelSchema>;
 type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? {
     [K in keyof T]?: DeepPartial<T[K]>;
@@ -3859,6 +3862,7 @@ type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T exten
 
 declare const OrganizationModelSchema: z.ZodObject<{
     version: z.ZodDefault<z.ZodLiteral<1>>;
+    snapshotHash: z.ZodOptional<z.ZodString>;
     domainMetadata: z.ZodPipe<z.ZodDefault<z.ZodObject<{
         branding: z.ZodOptional<z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
@@ -3868,6 +3872,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
             lastModified: z.ZodString;
         }, z.core.$strip>>;
+        clients: z.ZodOptional<z.ZodObject<{
+            version: z.ZodDefault<z.ZodLiteral<1>>;
+            lastModified: z.ZodString;
+        }, z.core.$strip>>;
         customers: z.ZodOptional<z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
             lastModified: z.ZodString;
@@ -3925,6 +3933,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         };
+        clients: {
+            version: 1;
+            lastModified: string;
+        };
         customers: {
             version: 1;
             lastModified: string;
@@ -3982,6 +3994,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         } | undefined;
+        clients?: {
+            version: 1;
+            lastModified: string;
+        } | undefined;
         customers?: {
             version: 1;
             lastModified: string;
@@ -4174,6 +4190,56 @@ declare const OrganizationModelSchema: z.ZodObject<{
         shortName: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
+    clients: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<{
+            active: "active";
+            onboarding: "onboarding";
+            paused: "paused";
+            completed: "completed";
+            churned: "churned";
+        }>>;
+        source: z.ZodOptional<z.ZodString>;
+        identity: z.ZodDefault<z.ZodObject<{
+            organizationName: z.ZodOptional<z.ZodString>;
+            shortName: z.ZodOptional<z.ZodString>;
+            clientBrief: z.ZodDefault<z.ZodString>;
+            geographicFocus: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            timeZone: z.ZodDefault<z.ZodString>;
+        }, z.core.$loose>>;
+        branding: z.ZodDefault<z.ZodObject<{
+            voice: z.ZodOptional<z.ZodString>;
+            tagline: z.ZodOptional<z.ZodString>;
+            values: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$loose>>;
+        workspace: z.ZodDefault<z.ZodObject<{
+            kind: z.ZodOptional<z.ZodEnum<{
+                "external-project": "external-project";
+                "internal-project": "internal-project";
+                none: "none";
+            }>>;
+            owner: z.ZodOptional<z.ZodEnum<{
+                platform: "platform";
+                client: "client";
+                developer: "developer";
+            }>>;
+            projectId: z.ZodOptional<z.ZodString>;
+            workspacePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        links: z.ZodDefault<z.ZodObject<{
+            projectIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            primaryCompanyId: z.ZodOptional<z.ZodString>;
+            primaryContactId: z.ZodOptional<z.ZodString>;
+            sourceDealId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        prompts: z.ZodDefault<z.ZodObject<{
+            defaultContext: z.ZodDefault<z.ZodString>;
+        }, z.core.$loose>>;
+        config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        customValues: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>>>>;
     customers: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;
@@ -4827,6 +4893,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
                     action: "action";
                     ontology: "ontology";
                     role: "role";
+                    client: "client";
                     stage: "stage";
                     goal: "goal";
                     "customer-segment": "customer-segment";
@@ -4838,7 +4905,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             nodeId: z.ZodUnion<readonly [z.ZodString, z.ZodTemplateLiteral<`ontology:${string}`>]>;
         }, z.core.$strip>]>, z.ZodTransform<{
             target: {
-                kind: "knowledge" | "system" | "resource" | "action" | "ontology" | "role" | "stage" | "goal" | "customer-segment" | "offering";
+                kind: "knowledge" | "system" | "resource" | "action" | "ontology" | "role" | "client" | "stage" | "goal" | "customer-segment" | "offering";
                 id: string;
             };
             nodeId: string;
@@ -4846,7 +4913,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             nodeId: string;
         } | {
             target: {
-                kind: "knowledge" | "system" | "resource" | "action" | "ontology" | "role" | "stage" | "goal" | "customer-segment" | "offering";
+                kind: "knowledge" | "system" | "resource" | "action" | "ontology" | "role" | "client" | "stage" | "goal" | "customer-segment" | "offering";
                 id: string;
             };
         }>>>>;

package/dist/test-utils/index.js

@@ -20691,6 +20691,7 @@ var GoalsDomainSchema = z.record(z.string(), ObjectiveSchema).refine((record) =>
 var DEFAULT_ORGANIZATION_MODEL_GOALS = {};
 var KnowledgeTargetKindSchema = z.enum([
   "system",
+  "client",
   "resource",
   "knowledge",
   "stage",
@@ -20948,6 +20949,7 @@ function buildOmCrossRefIndex(model) {
     systemsById.set(system.id, system);
   }
   const resourceIds = new Set(Object.keys(model.resources ?? {}));
+  const clientIds = new Set(Object.keys(model.clients ?? {}));
   const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}));
   const roleIds = new Set(Object.keys(model.roles ?? {}));
   const goalIds = new Set(Object.keys(model.goals ?? {}));
@@ -20981,6 +20983,7 @@ function buildOmCrossRefIndex(model) {
   return {
     systemsById,
     resourceIds,
+    clientIds,
     knowledgeIds,
     roleIds,
     goalIds,
@@ -20994,6 +20997,7 @@ function buildOmCrossRefIndex(model) {
 }
 function knowledgeTargetExists(index2, kind, id) {
   if (kind === "system") return index2.systemsById.has(id);
+  if (kind === "client") return index2.clientIds.has(id);
   if (kind === "resource") return index2.resourceIds.has(id);
   if (kind === "knowledge") return index2.knowledgeIds.has(id);
   if (kind === "stage") return index2.stageIds.has(id);
@@ -21027,10 +21031,10 @@ function asRoleHolderArray(heldBy) {
 function isKnowledgeKindCompatibleWithTarget(knowledgeKind, targetKind) {
   if (knowledgeKind === "reference") return true;
   if (knowledgeKind === "playbook") {
-    return ["system", "resource", "stage", "action", "ontology"].includes(targetKind);
+    return ["system", "client", "resource", "stage", "action", "ontology"].includes(targetKind);
   }
   if (knowledgeKind === "strategy") {
-    return ["system", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
+    return ["system", "client", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
   }
   return false;
 }
@@ -21558,9 +21562,68 @@ function refineOrganizationModel(model, ctx) {
 }
 
 // src/organization-model/schema.ts
+var ClientProfileIdSchema = z.string().uuid();
+var ClientProfileStatusSchema = z.enum(["active", "onboarding", "paused", "completed", "churned"]);
+var ClientProfileSourceSchema = z.string().trim().min(1).max(64).regex(/^[a-z][a-z0-9_]*$/, "Source must use lowercase letters, numbers, and underscores");
+var ClientProfileIdentitySchema = z.object({
+  organizationName: LabelSchema.optional(),
+  shortName: z.string().trim().min(1).max(40).optional(),
+  clientBrief: z.string().trim().max(4e3).default(""),
+  geographicFocus: z.array(z.string().trim().min(1).max(200)).default([]),
+  timeZone: z.string().trim().min(1).max(100).default("UTC")
+}).passthrough().default({
+  clientBrief: "",
+  geographicFocus: [],
+  timeZone: "UTC"
+});
+var ClientProfileBrandingSchema = z.object({
+  voice: z.string().trim().max(280).optional(),
+  tagline: z.string().trim().max(200).optional(),
+  values: z.array(z.string().trim().min(1).max(100)).default([])
+}).passthrough().default({
+  values: []
+});
+var ClientProfileWorkspaceSchema = z.object({
+  kind: z.enum(["external-project", "internal-project", "none"]).optional(),
+  owner: z.enum(["developer", "client", "platform"]).optional(),
+  projectId: z.string().trim().min(1).max(200).optional(),
+  workspacePath: z.string().trim().min(1).max(500).optional()
+}).passthrough().default({});
+var ClientProfileLinksSchema = z.object({
+  projectIds: z.array(z.string().uuid()).default([]),
+  primaryCompanyId: z.string().uuid().optional(),
+  primaryContactId: z.string().uuid().optional(),
+  sourceDealId: z.string().uuid().optional()
+}).default({
+  projectIds: []
+});
+var ClientProfilePromptsSchema = z.object({
+  defaultContext: z.string().trim().max(8e3).default("")
+}).passthrough().default({
+  defaultContext: ""
+});
+var ClientProfileSchema = z.object({
+  id: ClientProfileIdSchema,
+  slug: ModelIdSchema,
+  name: LabelSchema,
+  status: ClientProfileStatusSchema.default("onboarding"),
+  source: ClientProfileSourceSchema.optional(),
+  identity: ClientProfileIdentitySchema,
+  branding: ClientProfileBrandingSchema,
+  workspace: ClientProfileWorkspaceSchema,
+  links: ClientProfileLinksSchema,
+  prompts: ClientProfilePromptsSchema,
+  config: z.record(z.string().trim().min(1).max(200), JsonValueSchema).default({}),
+  customValues: z.record(z.string().trim().min(1).max(200), JsonValueSchema).default({})
+}).strict();
+var ClientProfilesDomainSchema = z.record(ClientProfileIdSchema, ClientProfileSchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
+  message: "Each client profile id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_CLIENTS = {};
 z.enum([
   "branding",
   "identity",
+  "clients",
   "customers",
   "offerings",
   "roles",
@@ -21581,6 +21644,7 @@ var OrganizationModelDomainMetadataSchema = z.object({
 var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
   branding: { version: 1, lastModified: "2026-05-10" },
   identity: { version: 1, lastModified: "2026-05-10" },
+  clients: { version: 1, lastModified: "2026-05-30" },
   customers: { version: 1, lastModified: "2026-05-10" },
   offerings: { version: 1, lastModified: "2026-05-10" },
   roles: { version: 1, lastModified: "2026-05-10" },
@@ -21597,6 +21661,7 @@ var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
 var OrganizationModelDomainMetadataByDomainSchema = z.object({
   branding: OrganizationModelDomainMetadataSchema,
   identity: OrganizationModelDomainMetadataSchema,
+  clients: OrganizationModelDomainMetadataSchema,
   customers: OrganizationModelDomainMetadataSchema,
   offerings: OrganizationModelDomainMetadataSchema,
   roles: OrganizationModelDomainMetadataSchema,
@@ -21612,10 +21677,23 @@ var OrganizationModelDomainMetadataByDomainSchema = z.object({
 }).partial().default(DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA).transform((metadata) => ({ ...DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, ...metadata }));
 var OrganizationModelSchemaBase = z.object({
   version: z.literal(1).default(1),
+  /**
+   * Deterministic SHA-256 hex hash of the full resolved model, excluding this
+   * field itself and volatile domainMetadata.lastModified values.
+   *
+   * Stamped at deploy time by the platform OM assembly and persisted alongside
+   * the snapshot in the DB. Compared at API boot to detect stale deployed
+   * snapshots (primary gate: deploy; secondary backstop: boot).
+   *
+   * Optional — absent on models that predate Step 2 versioning or that have
+   * not been stamped (e.g. tenant partial overrides before re-deploy).
+   */
+  snapshotHash: z.string().optional(),
   domainMetadata: OrganizationModelDomainMetadataByDomainSchema,
   branding: OrganizationModelBrandingSchema.default(DEFAULT_ORGANIZATION_MODEL_BRANDING),
   navigation: OrganizationModelNavigationSchema,
   identity: IdentityDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_IDENTITY),
+  clients: ClientProfilesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CLIENTS),
   customers: CustomersDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CUSTOMERS),
   offerings: OfferingsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_OFFERINGS),
   roles: RolesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ROLES),
@@ -21648,6 +21726,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
   identity: DEFAULT_ORGANIZATION_MODEL_IDENTITY,
+  clients: DEFAULT_ORGANIZATION_MODEL_CLIENTS,
   customers: DEFAULT_ORGANIZATION_MODEL_CUSTOMERS,
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/core",
-  "version": "0.39.0",
+  "version": "0.41.0",
   "license": "MIT",
   "description": "Minimal shared constants across Elevasis monorepo",
   "sideEffects": false,

package/src/_gen/__tests__/__snapshots__/contracts.md.snap

@@ -39,6 +39,60 @@ export type OrganizationModelDomainMetadataByDomain = z.infer<typeof Organizatio
 export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
 ```
 
+### `ClientProfile`
+
+```typescript
+export type ClientProfile = z.infer<typeof ClientProfileSchema>
+```
+
+### `ClientProfileBranding`
+
+```typescript
+export type ClientProfileBranding = z.infer<typeof ClientProfileBrandingSchema>
+```
+
+### `ClientProfileIdentity`
+
+```typescript
+export type ClientProfileIdentity = z.infer<typeof ClientProfileIdentitySchema>
+```
+
+### `ClientProfileLinks`
+
+```typescript
+export type ClientProfileLinks = z.infer<typeof ClientProfileLinksSchema>
+```
+
+### `ClientProfilePrompts`
+
+```typescript
+export type ClientProfilePrompts = z.infer<typeof ClientProfilePromptsSchema>
+```
+
+### `ClientProfileSource`
+
+```typescript
+export type ClientProfileSource = z.infer<typeof ClientProfileSourceSchema>
+```
+
+### `ClientProfileStatus`
+
+```typescript
+export type ClientProfileStatus = z.infer<typeof ClientProfileStatusSchema>
+```
+
+### `ClientProfileWorkspace`
+
+```typescript
+export type ClientProfileWorkspace = z.infer<typeof ClientProfileWorkspaceSchema>
+```
+
+### `OrganizationModelClients`
+
+```typescript
+export type OrganizationModelClients = z.infer<typeof ClientProfilesDomainSchema>
+```
+
 ### `SalesPipeline`
 
 ```typescript