@elevasis/core 0.30.0 → 0.32.0

package/dist/organization-model/index.js

@@ -494,15 +494,55 @@ DisplayMetadataSchema.extend({
 
 // src/organization-model/domains/branding.ts
 var OrganizationModelBrandingSchema = z.object({
+  /**
+   * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.organizationName` fall back to this field.
+   */
   organizationName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.productName` fall back to this field.
+   */
   productName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.shortName` fall back to this field.
+   */
   shortName: z.string().trim().min(1).max(40),
+  /**
+   * @deprecated Prefer `identity.description`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.description` fall back to this field.
+   */
   description: DescriptionSchema.optional(),
   logos: z.object({
     light: z.string().trim().min(1).max(2048).optional(),
     dark: z.string().trim().min(1).max(2048).optional()
-  }).default({})
-});
+  }).default({}),
+  /**
+   * Brand voice — how the organization communicates. Plain-language description
+   * of tone, register, and personality (e.g. "Direct and human — no jargon").
+   * Max 280 characters.
+   */
+  voice: z.string().trim().max(280).optional(),
+  /**
+   * Brand tagline or positioning statement — the memorable one-liner that
+   * captures the brand's promise or differentiator. Max 200 characters.
+   */
+  tagline: z.string().trim().max(200).optional(),
+  /**
+   * Core brand values — an ordered list of principles the organization stands
+   * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
+   * be a non-empty trimmed string.
+   */
+  values: z.array(z.string().trim().min(1)).optional(),
+  /**
+   * ID of the active UI theme preset from the UI theme-presets registry.
+   * The UI layer resolves this to colors and typography via `usePresetsContext()`.
+   * Free-form string — validation and fallback state are handled at the UI layer.
+   * Min 1, max 64 characters.
+   */
+  themePresetId: z.string().trim().min(1).max(64).optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_BRANDING = {
   organizationName: "Default Organization",
   productName: "Organization OS",
@@ -633,8 +673,33 @@ var IdentityDomainSchema = z.object({
    * background. Populated by /setup; surfaced to agents as organizational context.
    * Optional — many projects have no external client.
    */
-  clientBrief: z.string().trim().default("")
-});
+  clientBrief: z.string().trim().default(""),
+  /**
+   * Display name of the organization as shown to end users.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.organizationName`. Falls back to `branding.organizationName` for
+   * legacy tenants that have not yet migrated.
+   */
+  organizationName: LabelSchema.optional(),
+  /**
+   * Display name of the primary product or platform.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.productName`. Falls back to `branding.productName` for legacy tenants.
+   */
+  productName: LabelSchema.optional(),
+  /**
+   * Short abbreviated name used in space-constrained UI surfaces (max 40 chars).
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.shortName`. Falls back to `branding.shortName` for legacy tenants.
+   */
+  shortName: z.string().trim().min(1).max(40).optional(),
+  /**
+   * Plain-language description of the organization for display and discovery.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.description`. Falls back to `branding.description` for legacy tenants.
+   */
+  description: DescriptionSchema.optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_IDENTITY = {
   mission: "",
   vision: "",
@@ -831,107 +896,6 @@ var EntitySchema = z.object({
 var EntitiesDomainSchema = z.record(z.string(), EntitySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
   message: "Each entity entry id must match its map key"
 }).default({});
-var ENTITY_ENTRY_INPUTS = [
-  {
-    id: "crm.deal",
-    order: 10,
-    label: "Deal",
-    description: "A CRM opportunity or sales pipeline record.",
-    ownedBySystemId: "sales.crm",
-    table: "crm_deals",
-    stateCatalogId: "crm.pipeline",
-    links: [{ toEntity: "crm.contact", kind: "has-many", via: "deal_contacts", label: "contacts" }]
-  },
-  {
-    id: "crm.contact",
-    order: 20,
-    label: "CRM Contact",
-    description: "A person associated with a CRM relationship or deal.",
-    ownedBySystemId: "sales.crm",
-    table: "crm_contacts"
-  },
-  {
-    id: "leadgen.list",
-    order: 30,
-    label: "Lead List",
-    description: "A prospecting list that groups companies and contacts for acquisition workflows.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_lists",
-    links: [
-      { toEntity: "leadgen.company", kind: "has-many", via: "acq_list_companies", label: "companies" },
-      { toEntity: "leadgen.contact", kind: "has-many", via: "acq_list_members", label: "contacts" }
-    ]
-  },
-  {
-    id: "leadgen.company",
-    order: 40,
-    label: "Lead Company",
-    description: "A company record sourced, enriched, and qualified during prospecting.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_list_companies",
-    stateCatalogId: "lead-gen.company",
-    links: [
-      { toEntity: "leadgen.list", kind: "belongs-to", via: "list_id", label: "list" },
-      { toEntity: "leadgen.contact", kind: "has-many", via: "company_id", label: "contacts" }
-    ]
-  },
-  {
-    id: "leadgen.contact",
-    order: 50,
-    label: "Lead Contact",
-    description: "A prospect contact discovered or enriched during lead generation.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_list_members",
-    stateCatalogId: "lead-gen.contact",
-    links: [
-      { toEntity: "leadgen.list", kind: "belongs-to", via: "list_id", label: "list" },
-      { toEntity: "leadgen.company", kind: "belongs-to", via: "company_id", label: "company" }
-    ]
-  },
-  {
-    id: "delivery.project",
-    order: 60,
-    label: "Project",
-    description: "A client delivery project.",
-    ownedBySystemId: "projects",
-    table: "projects",
-    links: [
-      { toEntity: "delivery.milestone", kind: "has-many", via: "project_id", label: "milestones" },
-      { toEntity: "delivery.task", kind: "has-many", via: "project_id", label: "tasks" }
-    ]
-  },
-  {
-    id: "delivery.milestone",
-    order: 70,
-    label: "Milestone",
-    description: "A delivery checkpoint within a project.",
-    ownedBySystemId: "projects",
-    table: "project_milestones",
-    links: [
-      { toEntity: "delivery.project", kind: "belongs-to", via: "project_id", label: "project" },
-      { toEntity: "delivery.task", kind: "has-many", via: "milestone_id", label: "tasks" }
-    ]
-  },
-  {
-    id: "delivery.task",
-    order: 80,
-    label: "Task",
-    description: "A delivery task that can move through the task status catalog.",
-    ownedBySystemId: "projects",
-    table: "project_tasks",
-    stateCatalogId: "delivery.task",
-    links: [
-      { toEntity: "delivery.project", kind: "belongs-to", via: "project_id", label: "project" },
-      { toEntity: "delivery.milestone", kind: "belongs-to", via: "milestone_id", label: "milestone" }
-    ]
-  }
-];
-var DEFAULT_ORGANIZATION_MODEL_ENTITIES = Object.fromEntries(
-  ENTITY_ENTRY_INPUTS.map((entity) => {
-    const parsed = EntitySchema.parse(entity);
-    return [parsed.id, parsed];
-  })
-);
 function defineEntity(entry) {
   return EntitySchema.parse(entry);
 }
@@ -2428,7 +2392,7 @@ var OrganizationModelSchemaBase = z.object({
   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),
+  entities: EntitiesDomainSchema.default({}),
   policies: PoliciesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_POLICIES),
   // D3: flat Record<id, OrgKnowledgeNode> — no wrapper object
   knowledge: KnowledgeDomainSchema.default({})
@@ -2534,7 +2498,7 @@ var SETTINGS_ROLES_SURFACE_ID = "settings.roles";
 
 // src/organization-model/defaults.ts
 var DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE = {};
-var DEFAULT_ORGANIZATION_MODEL_ENTITIES2 = {};
+var DEFAULT_ORGANIZATION_MODEL_ENTITIES = {};
 var DEFAULT_ORGANIZATION_MODEL_NAVIGATION2 = {
   sidebar: {
     primary: {},
@@ -2562,7 +2526,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   // Generic empty actions map. Elevasis-specific action entries have been relocated to
   // `@repo/elevasis-core/src/organization-model/actions.ts`.
   actions: {},
-  entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES2,
+  entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES,
   policies: DEFAULT_ORGANIZATION_MODEL_POLICIES,
   knowledge: DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE
 };
@@ -3442,4 +3406,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_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, 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, 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, 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, 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, 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 };

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

@@ -1464,6 +1464,51 @@ type Database = {
                     }
                 ];
             };
+            deployment_organization_models: {
+                Row: {
+                    created_at: string;
+                    deployment_id: string;
+                    model_hash: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    deployment_id: string;
+                    model_hash?: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    deployment_id?: string;
+                    model_hash?: string | null;
+                    organization_id?: string;
+                    organization_model?: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "deployment_organization_models_deployment_id_fkey";
+                        columns: ["deployment_id"];
+                        isOneToOne: true;
+                        referencedRelation: "deployments";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "deployment_organization_models_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             deployments: {
                 Row: {
                     created_at: string;
@@ -3961,7 +4006,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             light: z.ZodOptional<z.ZodString>;
             dark: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        voice: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        themePresetId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     navigation: z.ZodDefault<z.ZodObject<{
         sidebar: z.ZodDefault<z.ZodObject<{
             primary: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SidebarNode, unknown, z.core.$ZodTypeInternals<SidebarNode, unknown>>>>;
@@ -4008,7 +4057,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         clientBrief: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
+        organizationName: z.ZodOptional<z.ZodString>;
+        productName: z.ZodOptional<z.ZodString>;
+        shortName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     customers: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;

package/dist/test-utils/index.js

@@ -19895,15 +19895,55 @@ DisplayMetadataSchema.extend({
 
 // src/organization-model/domains/branding.ts
 var OrganizationModelBrandingSchema = z.object({
+  /**
+   * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.organizationName` fall back to this field.
+   */
   organizationName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.productName` fall back to this field.
+   */
   productName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.shortName` fall back to this field.
+   */
   shortName: z.string().trim().min(1).max(40),
+  /**
+   * @deprecated Prefer `identity.description`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.description` fall back to this field.
+   */
   description: DescriptionSchema.optional(),
   logos: z.object({
     light: z.string().trim().min(1).max(2048).optional(),
     dark: z.string().trim().min(1).max(2048).optional()
-  }).default({})
-});
+  }).default({}),
+  /**
+   * Brand voice — how the organization communicates. Plain-language description
+   * of tone, register, and personality (e.g. "Direct and human — no jargon").
+   * Max 280 characters.
+   */
+  voice: z.string().trim().max(280).optional(),
+  /**
+   * Brand tagline or positioning statement — the memorable one-liner that
+   * captures the brand's promise or differentiator. Max 200 characters.
+   */
+  tagline: z.string().trim().max(200).optional(),
+  /**
+   * Core brand values — an ordered list of principles the organization stands
+   * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
+   * be a non-empty trimmed string.
+   */
+  values: z.array(z.string().trim().min(1)).optional(),
+  /**
+   * ID of the active UI theme preset from the UI theme-presets registry.
+   * The UI layer resolves this to colors and typography via `usePresetsContext()`.
+   * Free-form string — validation and fallback state are handled at the UI layer.
+   * Min 1, max 64 characters.
+   */
+  themePresetId: z.string().trim().min(1).max(64).optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_BRANDING = {
   organizationName: "Default Organization",
   productName: "Organization OS",
@@ -20022,8 +20062,33 @@ var IdentityDomainSchema = z.object({
    * background. Populated by /setup; surfaced to agents as organizational context.
    * Optional — many projects have no external client.
    */
-  clientBrief: z.string().trim().default("")
-});
+  clientBrief: z.string().trim().default(""),
+  /**
+   * Display name of the organization as shown to end users.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.organizationName`. Falls back to `branding.organizationName` for
+   * legacy tenants that have not yet migrated.
+   */
+  organizationName: LabelSchema.optional(),
+  /**
+   * Display name of the primary product or platform.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.productName`. Falls back to `branding.productName` for legacy tenants.
+   */
+  productName: LabelSchema.optional(),
+  /**
+   * Short abbreviated name used in space-constrained UI surfaces (max 40 chars).
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.shortName`. Falls back to `branding.shortName` for legacy tenants.
+   */
+  shortName: z.string().trim().min(1).max(40).optional(),
+  /**
+   * Plain-language description of the organization for display and discovery.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.description`. Falls back to `branding.description` for legacy tenants.
+   */
+  description: DescriptionSchema.optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_IDENTITY = {
   mission: "",
   vision: "",
@@ -20173,107 +20238,6 @@ var EntitySchema = z.object({
 var EntitiesDomainSchema = z.record(z.string(), EntitySchema).refine((record) => Object.entries(record).every(([key, entry]) => entry.id === key), {
   message: "Each entity entry id must match its map key"
 }).default({});
-var ENTITY_ENTRY_INPUTS = [
-  {
-    id: "crm.deal",
-    order: 10,
-    label: "Deal",
-    description: "A CRM opportunity or sales pipeline record.",
-    ownedBySystemId: "sales.crm",
-    table: "crm_deals",
-    stateCatalogId: "crm.pipeline",
-    links: [{ toEntity: "crm.contact", kind: "has-many", via: "deal_contacts", label: "contacts" }]
-  },
-  {
-    id: "crm.contact",
-    order: 20,
-    label: "CRM Contact",
-    description: "A person associated with a CRM relationship or deal.",
-    ownedBySystemId: "sales.crm",
-    table: "crm_contacts"
-  },
-  {
-    id: "leadgen.list",
-    order: 30,
-    label: "Lead List",
-    description: "A prospecting list that groups companies and contacts for acquisition workflows.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_lists",
-    links: [
-      { toEntity: "leadgen.company", kind: "has-many", via: "acq_list_companies", label: "companies" },
-      { toEntity: "leadgen.contact", kind: "has-many", via: "acq_list_members", label: "contacts" }
-    ]
-  },
-  {
-    id: "leadgen.company",
-    order: 40,
-    label: "Lead Company",
-    description: "A company record sourced, enriched, and qualified during prospecting.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_list_companies",
-    stateCatalogId: "lead-gen.company",
-    links: [
-      { toEntity: "leadgen.list", kind: "belongs-to", via: "list_id", label: "list" },
-      { toEntity: "leadgen.contact", kind: "has-many", via: "company_id", label: "contacts" }
-    ]
-  },
-  {
-    id: "leadgen.contact",
-    order: 50,
-    label: "Lead Contact",
-    description: "A prospect contact discovered or enriched during lead generation.",
-    ownedBySystemId: "sales.lead-gen",
-    table: "acq_list_members",
-    stateCatalogId: "lead-gen.contact",
-    links: [
-      { toEntity: "leadgen.list", kind: "belongs-to", via: "list_id", label: "list" },
-      { toEntity: "leadgen.company", kind: "belongs-to", via: "company_id", label: "company" }
-    ]
-  },
-  {
-    id: "delivery.project",
-    order: 60,
-    label: "Project",
-    description: "A client delivery project.",
-    ownedBySystemId: "projects",
-    table: "projects",
-    links: [
-      { toEntity: "delivery.milestone", kind: "has-many", via: "project_id", label: "milestones" },
-      { toEntity: "delivery.task", kind: "has-many", via: "project_id", label: "tasks" }
-    ]
-  },
-  {
-    id: "delivery.milestone",
-    order: 70,
-    label: "Milestone",
-    description: "A delivery checkpoint within a project.",
-    ownedBySystemId: "projects",
-    table: "project_milestones",
-    links: [
-      { toEntity: "delivery.project", kind: "belongs-to", via: "project_id", label: "project" },
-      { toEntity: "delivery.task", kind: "has-many", via: "milestone_id", label: "tasks" }
-    ]
-  },
-  {
-    id: "delivery.task",
-    order: 80,
-    label: "Task",
-    description: "A delivery task that can move through the task status catalog.",
-    ownedBySystemId: "projects",
-    table: "project_tasks",
-    stateCatalogId: "delivery.task",
-    links: [
-      { toEntity: "delivery.project", kind: "belongs-to", via: "project_id", label: "project" },
-      { toEntity: "delivery.milestone", kind: "belongs-to", via: "milestone_id", label: "milestone" }
-    ]
-  }
-];
-var DEFAULT_ORGANIZATION_MODEL_ENTITIES = Object.fromEntries(
-  ENTITY_ENTRY_INPUTS.map((entity) => {
-    const parsed = EntitySchema.parse(entity);
-    return [parsed.id, parsed];
-  })
-);
 
 // src/organization-model/domains/actions.ts
 var ActionResourceIdSchema = z.string().trim().min(1).max(255).regex(/^[A-Za-z0-9]+(?:[-._][A-Za-z0-9]+)*$/, "Resource IDs must use letters, numbers, -, _, or . separators");
@@ -21579,7 +21543,7 @@ var OrganizationModelSchemaBase = z.object({
   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),
+  entities: EntitiesDomainSchema.default({}),
   policies: PoliciesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_POLICIES),
   // D3: flat Record<id, OrgKnowledgeNode> — no wrapper object
   knowledge: KnowledgeDomainSchema.default({})
@@ -21588,7 +21552,7 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine(refineOrga
 
 // src/organization-model/defaults.ts
 var DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE = {};
-var DEFAULT_ORGANIZATION_MODEL_ENTITIES2 = {};
+var DEFAULT_ORGANIZATION_MODEL_ENTITIES = {};
 var DEFAULT_ORGANIZATION_MODEL_NAVIGATION = {
   sidebar: {
     primary: {},
@@ -21616,7 +21580,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   // Generic empty actions map. Elevasis-specific action entries have been relocated to
   // `@repo/elevasis-core/src/organization-model/actions.ts`.
   actions: {},
-  entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES2,
+  entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES,
   policies: DEFAULT_ORGANIZATION_MODEL_POLICIES,
   knowledge: DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE
 };

package/package.json

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