@elevasis/core 0.39.0 → 0.41.0

package/dist/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/knowledge/index.d.ts

@@ -278,6 +278,7 @@ declare const OrgKnowledgeNodeSchema: z.ZodObject<{
                 action: "action";
                 ontology: "ontology";
                 role: "role";
+                client: "client";
                 stage: "stage";
                 goal: "goal";
                 "customer-segment": "customer-segment";
@@ -289,7 +290,7 @@ declare const OrgKnowledgeNodeSchema: 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;
@@ -297,7 +298,7 @@ declare const OrgKnowledgeNodeSchema: 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;
         };
     }>>>>;
@@ -374,6 +375,7 @@ type OrganizationModelIconToken = z.infer<typeof OrganizationModelIconTokenSchem
 
 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>>;
@@ -383,6 +385,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;
@@ -440,6 +446,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         };
+        clients: {
+            version: 1;
+            lastModified: string;
+        };
         customers: {
             version: 1;
             lastModified: string;
@@ -497,6 +507,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         } | undefined;
+        clients?: {
+            version: 1;
+            lastModified: string;
+        } | undefined;
         customers?: {
             version: 1;
             lastModified: string;
@@ -689,6 +703,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;
@@ -1342,6 +1406,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
                     action: "action";
                     ontology: "ontology";
                     role: "role";
+                    client: "client";
                     stage: "stage";
                     goal: "goal";
                     "customer-segment": "customer-segment";
@@ -1353,7 +1418,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;
@@ -1361,7 +1426,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;
             };
         }>>>>;
@@ -1391,7 +1456,7 @@ type OrganizationModel = z.infer<typeof OrganizationModelSchema>;
  */
 type RelationshipType = 'triggers' | 'uses' | 'approval';
 
-type OrganizationGraphNodeKind = 'organization' | 'system' | 'role' | 'action' | 'entity' | 'event' | 'policy' | 'stage' | 'resource' | 'knowledge' | 'customer-segment' | 'offering' | 'goal' | 'surface' | 'navigation-group' | 'ontology';
+type OrganizationGraphNodeKind = 'organization' | 'system' | 'client' | 'role' | 'action' | 'entity' | 'event' | 'policy' | 'stage' | 'resource' | 'knowledge' | 'customer-segment' | 'offering' | 'goal' | 'surface' | 'navigation-group' | 'ontology';
 type OrganizationGraphEdgeKind = 'contains' | 'references' | 'maps_to' | 'uses' | 'governs' | 'links' | 'affects' | 'emits' | 'originates_from' | 'triggers' | 'approval' | 'applies_to' | 'effects' | 'actions' | 'reads' | 'writes' | 'uses_catalog';
 
 interface OrganizationGraphNode {
@@ -1467,19 +1532,22 @@ declare function governs(graph: OrganizationGraph, nodeId: string): string[];
  */
 declare function governedBy(graph: OrganizationGraph, nodeId: string): string[];
 /** The recognized mount axes for Knowledge Map paths. */
-type KnowledgeMount = 'by-system' | 'by-ontology' | 'by-kind' | 'by-owner' | 'graph' | 'node';
+type KnowledgeMount = 'by-system' | 'by-ontology' | 'by-kind' | 'by-owner' | 'graph' | 'node' | 'all-systems' | 'all-resources' | 'all-roles';
 /**
  * The result of parsing a Knowledge Map path string.
  *
  * Shape: `{ mount: KnowledgeMount, args: string[] }`
  *
  * Per-mount arg arrays:
- * - `by-system`:  `[systemId]`   (e.g. `['sales.crm']`)
- * - `by-ontology`:`[ontologyId]` (e.g. `['sales.crm:object/deal']`)
- * - `by-kind`:    `[kind]`       (e.g. `['playbook']`)
- * - `by-owner`:   `[ownerId]`    (e.g. `['role.ops-lead']`)
- * - `graph`:      `[nodeId, verb]` where verb is `'governs'` or `'governed-by'`
- * - `node`:       `[nodeId]`     (single node lookup, no sub-path)
+ * - `by-system`:    `[systemId]`   (e.g. `['sales.crm']`)
+ * - `by-ontology`:  `[ontologyId]` (e.g. `['sales.crm:object/deal']`)
+ * - `by-kind`:      `[kind]`       (e.g. `['playbook']`)
+ * - `by-owner`:     `[ownerId]`    (e.g. `['role.ops-lead']`)
+ * - `graph`:        `[nodeId, verb]` where verb is `'governs'` or `'governed-by'`
+ * - `node`:         `[nodeId]`     (single node lookup, no sub-path)
+ * - `all-systems`:  `[]`           (no args — returns all systems flattened)
+ * - `all-resources`:`[]`           (no args — returns all resources)
+ * - `all-roles`:    `[]`           (no args — returns all roles)
  */
 interface ParsedKnowledgePath {
     mount: KnowledgeMount;
@@ -1489,13 +1557,16 @@ interface ParsedKnowledgePath {
  * Parses a Knowledge Map path string into a `{ mount, args }` descriptor.
  *
  * Supported path patterns:
- *   `/by-system/<systemId>`           -> `{ mount: 'by-system', args: ['<systemId>'] }`
- *   `/by-ontology/<ontologyId>`       -> `{ mount: 'by-ontology', args: ['<ontologyId>'] }`
- *   `/by-kind/<kind>`                 → `{ mount: 'by-kind',    args: ['<kind>'] }`
- *   `/by-owner/<ownerId>`             → `{ mount: 'by-owner',   args: ['<ownerId>'] }`
- *   `/graph/<nodeId>/governs`         → `{ mount: 'graph',      args: ['<nodeId>', 'governs'] }`
- *   `/graph/<nodeId>/governed-by`     → `{ mount: 'graph',      args: ['<nodeId>', 'governed-by'] }`
- *   `/<nodeId>`                       → `{ mount: 'node',       args: ['<nodeId>'] }`
+ *   `/by-system/<systemId>`           -> `{ mount: ‘by-system’,    args: [‘<systemId>’] }`
+ *   `/by-ontology/<ontologyId>`       -> `{ mount: ‘by-ontology’,  args: [‘<ontologyId>’] }`
+ *   `/by-kind/<kind>`                 -> `{ mount: ‘by-kind’,      args: [‘<kind>’] }`
+ *   `/by-owner/<ownerId>`             -> `{ mount: ‘by-owner’,     args: [‘<ownerId>’] }`
+ *   `/graph/<nodeId>/governs`         -> `{ mount: ‘graph’,        args: [‘<nodeId>’, ‘governs’] }`
+ *   `/graph/<nodeId>/governed-by`     -> `{ mount: ‘graph’,        args: [‘<nodeId>’, ‘governed-by’] }`
+ *   `/<nodeId>`                       -> `{ mount: ‘node’,         args: [‘<nodeId>’] }`
+ *   `/all-systems`                    -> `{ mount: ‘all-systems’,  args: [] }`
+ *   `/all-resources`                  -> `{ mount: ‘all-resources’,args: [] }`
+ *   `/all-roles`                      -> `{ mount: ‘all-roles’,    args: [] }`
  *
  * The path MUST start with `/`.  Trailing slashes are stripped before parsing.
  *

package/dist/knowledge/index.js

@@ -200,11 +200,20 @@ function parsePath(pathString) {
     }
     return { mount: "graph", args: [graphNodeId, verb] };
   }
+  if (first === "all-systems" && rest.length === 0) {
+    return { mount: "all-systems", args: [] };
+  }
+  if (first === "all-resources" && rest.length === 0) {
+    return { mount: "all-resources", args: [] };
+  }
+  if (first === "all-roles" && rest.length === 0) {
+    return { mount: "all-roles", args: [] };
+  }
   if (segments.length === 1) {
     return { mount: "node", args: [first] };
   }
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
   );
 }