@elevasis/core 0.42.0 → 0.43.0

package/dist/organization-model/index.js

@@ -1101,8 +1101,6 @@ var SystemEntrySchema = z.object({
   path: PathSchema.optional(),
   /** @deprecated Use ui.icon. Kept for one-cycle Feature compatibility. */
   icon: IconNameSchema.optional(),
-  /** @deprecated Feature color token, retained for one-cycle compatibility. */
-  color: ColorTokenSchema.optional(),
   /** @deprecated UI placement hint, retained for one-cycle compatibility. */
   uiPosition: UiPositionSchema.optional(),
   /** @deprecated Use lifecycle. */
@@ -1803,7 +1801,8 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   surfaceType: "surface",
   stepCatalog: "catalog"
 };
-function buildOmCrossRefIndex(model) {
+var omCompilationContextCache = /* @__PURE__ */ new WeakMap();
+function buildOmCrossRefIndexFromOntology(model, ontologyCompilation) {
   const systemsById = /* @__PURE__ */ new Map();
   for (const { path, system } of listAllSystems(model)) {
     systemsById.set(path, system);
@@ -1817,7 +1816,6 @@ function buildOmCrossRefIndex(model) {
   const actionIds = new Set(Object.keys(model.actions ?? {}));
   const customerSegmentIds = new Set(Object.keys(model.customers ?? {}));
   const offeringIds = new Set(Object.keys(model.offerings ?? {}));
-  const ontologyCompilation = compileOrganizationOntology(model);
   const ontologyIndexByKind = {
     object: ontologyCompilation.ontology.objectTypes,
     link: ontologyCompilation.ontology.linkTypes,
@@ -1856,6 +1854,15 @@ function buildOmCrossRefIndex(model) {
     stageIds
   };
 }
+function buildOmCompilationContext(model) {
+  const cached = omCompilationContextCache.get(model);
+  if (cached !== void 0) return cached;
+  const ontologyCompilation = compileOrganizationOntology(model);
+  const crossRefIndex = buildOmCrossRefIndexFromOntology(model, ontologyCompilation);
+  const context = { crossRefIndex, ontologyCompilation };
+  omCompilationContextCache.set(model, context);
+  return context;
+}
 function knowledgeTargetExists(index, kind, id) {
   if (kind === "system") return index.systemsById.has(id);
   if (kind === "client") return index.clientIds.has(id);
@@ -2192,9 +2199,8 @@ function refineOrganizationModel(model, ctx) {
       }
     });
   });
-  const idx = buildOmCrossRefIndex(model);
+  const { crossRefIndex: idx, ontologyCompilation } = buildOmCompilationContext(model);
   const { ontologyIndexByKind, ontologyIds } = idx;
-  const ontologyCompilation = compileOrganizationOntology(model);
   function topologyTargetExists(ref) {
     if (ref.kind === "system") return systemsById.has(ref.id);
     if (ref.kind === "resource") return resourcesById.has(ref.id);
@@ -3369,12 +3375,34 @@ Capture the durable operating knowledge here.
 }
 
 // src/organization-model/scaffolders/scaffoldOntologyRecord.ts
+function kindSpecificFields(spec) {
+  if (spec.kind === "link") {
+    return {
+      from: makeOntologyId(spec.systemPath, "object", "source-object"),
+      to: makeOntologyId(spec.systemPath, "object", "target-object")
+    };
+  }
+  if (spec.kind === "action") {
+    return { actsOn: [] };
+  }
+  if (spec.kind === "group") {
+    return { members: [] };
+  }
+  return {};
+}
 function scaffoldOntologyRecord(model, spec) {
   assertSystemExists(model, spec.systemPath);
   const localId = spec.localId ?? spec.id;
   const ontologyId = makeOntologyId(spec.systemPath, spec.kind, localId);
   const label = spec.label ?? titleize(localId);
   const mapName = ontologyMapName(spec.kind);
+  const snippetRecord = {
+    id: ontologyId,
+    label,
+    ownerSystemId: spec.systemPath,
+    ...spec.description === void 0 ? {} : { description: spec.description },
+    ...kindSpecificFields(spec)
+  };
   return {
     intent: "ontology",
     id: ontologyId,
@@ -3384,12 +3412,7 @@ function scaffoldOntologyRecord(model, spec) {
       {
         path: "packages/elevasis-core/src/organization-model/systems.ts",
         description: `Add this record under ${spec.systemPath}.ontology.${mapName}.`,
-        snippet: `${JSON.stringify(ontologyId)}: {
-  id: ${JSON.stringify(ontologyId)},
-  label: ${JSON.stringify(label)},
-  ownerSystemId: ${JSON.stringify(spec.systemPath)}${spec.description === void 0 ? "" : `,
-  description: ${JSON.stringify(spec.description)}`}
-}`
+        snippet: `${JSON.stringify(ontologyId)}: ${JSON.stringify(snippetRecord, null, 2)}`
       }
     ],
     warnings: [],
@@ -3503,9 +3526,8 @@ function scaffoldSystem(model, spec) {
         content: `import type { SystemModule } from '@repo/ui'
 
 export const ${featureSlug.replaceAll("-", "_")}Manifest: SystemModule = {
-  systemId: ${JSON.stringify(systemPath)},
-  label: ${JSON.stringify(label)},
-  routes: []
+  key: ${JSON.stringify(featureSlug)},
+  systemId: ${JSON.stringify(systemPath)}
 }
 `
       },

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

@@ -3448,7 +3448,7 @@ interface MockSupabaseFixtures {
  *
  * Usage:
  * ```typescript
- * import { createMockSupabaseClient, TEST_USERS, TEST_ORGS } from '@repo/core/test-utils'
+ * import { createMockSupabaseClient, TEST_USERS, TEST_ORGS } from '@elevasis/core/test-utils'
  *
  * const mockClient = createMockSupabaseClient({
  *   users: [TEST_USERS.admin, TEST_USERS.regularUser],
@@ -3501,7 +3501,7 @@ interface UserContext {
  *
  * Usage:
  * ```typescript
- * import { createMockWorkOSClient, TEST_USERS } from '@repo/core/test-utils'
+ * import { createMockWorkOSClient, TEST_USERS } from '@elevasis/core/test-utils'
  *
  * const mockWorkOS = createMockWorkOSClient({
  *   validTokens: {
@@ -3542,7 +3542,7 @@ declare function createMockWorkOSClient(options?: {
  *
  * Usage:
  * ```typescript
- * import { createMockVerifyJWT, TEST_USERS } from '@repo/core/test-utils'
+ * import { createMockVerifyJWT, TEST_USERS } from '@elevasis/core/test-utils'
  *
  * const mockVerifyJWT = createMockVerifyJWT({
  *   'valid-token': {
@@ -3843,7 +3843,6 @@ interface SystemEntry {
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
     icon?: string;
-    color?: string;
     uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
     enabled?: boolean;
     devOnly?: boolean;

package/dist/test-utils/index.js

@@ -20415,8 +20415,6 @@ var SystemEntrySchema = z.object({
   path: PathSchema.optional(),
   /** @deprecated Use ui.icon. Kept for one-cycle Feature compatibility. */
   icon: IconNameSchema.optional(),
-  /** @deprecated Feature color token, retained for one-cycle compatibility. */
-  color: ColorTokenSchema.optional(),
   /** @deprecated UI placement hint, retained for one-cycle compatibility. */
   uiPosition: UiPositionSchema.optional(),
   /** @deprecated Use lifecycle. */
@@ -20942,7 +20940,8 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   surfaceType: "surface",
   stepCatalog: "catalog"
 };
-function buildOmCrossRefIndex(model) {
+var omCompilationContextCache = /* @__PURE__ */ new WeakMap();
+function buildOmCrossRefIndexFromOntology(model, ontologyCompilation) {
   const systemsById = /* @__PURE__ */ new Map();
   for (const { path, system } of listAllSystems(model)) {
     systemsById.set(path, system);
@@ -20956,7 +20955,6 @@ function buildOmCrossRefIndex(model) {
   const actionIds = new Set(Object.keys(model.actions ?? {}));
   const customerSegmentIds = new Set(Object.keys(model.customers ?? {}));
   const offeringIds = new Set(Object.keys(model.offerings ?? {}));
-  const ontologyCompilation = compileOrganizationOntology(model);
   const ontologyIndexByKind = {
     object: ontologyCompilation.ontology.objectTypes,
     link: ontologyCompilation.ontology.linkTypes,
@@ -20995,6 +20993,15 @@ function buildOmCrossRefIndex(model) {
     stageIds
   };
 }
+function buildOmCompilationContext(model) {
+  const cached = omCompilationContextCache.get(model);
+  if (cached !== void 0) return cached;
+  const ontologyCompilation = compileOrganizationOntology(model);
+  const crossRefIndex = buildOmCrossRefIndexFromOntology(model, ontologyCompilation);
+  const context = { crossRefIndex, ontologyCompilation };
+  omCompilationContextCache.set(model, context);
+  return context;
+}
 function knowledgeTargetExists(index2, kind, id) {
   if (kind === "system") return index2.systemsById.has(id);
   if (kind === "client") return index2.clientIds.has(id);
@@ -21331,9 +21338,8 @@ function refineOrganizationModel(model, ctx) {
       }
     });
   });
-  const idx = buildOmCrossRefIndex(model);
+  const { crossRefIndex: idx, ontologyCompilation } = buildOmCompilationContext(model);
   const { ontologyIndexByKind, ontologyIds } = idx;
-  const ontologyCompilation = compileOrganizationOntology(model);
   function topologyTargetExists(ref) {
     if (ref.kind === "system") return systemsById.has(ref.id);
     if (ref.kind === "resource") return resourcesById.has(ref.id);

package/package.json

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

package/src/auth/__tests__/access-test-fixtures.ts

@@ -6,7 +6,15 @@ export const accessTestOrganizationModel = {
       id: 'platform',
       label: 'Platform',
       lifecycle: 'active',
-      order: 10
+      order: 10,
+      systems: {
+        projects: {
+          id: 'projects',
+          label: 'Projects',
+          lifecycle: 'active',
+          order: 10
+        }
+      }
     },
     sales: {
       id: 'sales',
@@ -28,12 +36,6 @@ export const accessTestOrganizationModel = {
         }
       }
     },
-    projects: {
-      id: 'projects',
-      label: 'Projects',
-      lifecycle: 'active',
-      order: 30
-    },
     clients: {
       id: 'clients',
       label: 'Clients',

package/src/auth/access-keys.ts

@@ -51,14 +51,20 @@ export const AccessKeys = {
   organizationManage: { systemPath: 'permission.org', action: 'manage' },
   membersManage: { systemPath: 'permission.members', action: 'manage' },
   rolesManage: { systemPath: 'permission.roles', action: 'manage' },
+  /** @reserved Reserved for first-class secret administration routes and command surfaces. */
   secretsManage: { systemPath: 'permission.secrets', action: 'manage' },
   operationsRead: { systemPath: 'permission.operations', action: DEFAULT_ACCESS_ACTION },
+  /** @reserved Reserved for write-level operations administration beyond read-only monitoring. */
   operationsManage: { systemPath: 'permission.operations', action: 'manage' },
   leadGenManage: { systemPath: 'sales.lead-gen', action: 'manage' },
+  /** @reserved Reserved for acquisition administration once that permission namespace is wired. */
   acquisitionManage: { systemPath: 'permission.acquisition', action: 'manage' },
+  /** @reserved Reserved for project administration permission catalog compatibility. */
   projectsManage: { systemPath: 'permission.projects', action: 'manage' },
+  /** @reserved Reserved for client administration permission catalog compatibility. */
   clientsManage: { systemPath: 'permission.clients', action: 'manage' },
   operationsOverview: { systemPath: 'diagnostic.operations.overview', action: DEFAULT_ACCESS_ACTION },
+  /** @reserved Reserved for a diagnostics surface that lists recent operations executions. */
   operationsRecentExecutions: { systemPath: 'diagnostic.operations.recent-executions', action: DEFAULT_ACCESS_ACTION },
   monitoringExecutionLogs: { systemPath: 'diagnostic.monitoring.execution-logs', action: DEFAULT_ACCESS_ACTION },
   monitoringNotifications: { systemPath: 'diagnostic.monitoring.notifications', action: DEFAULT_ACCESS_ACTION }

package/src/business/base-entities.ts

@@ -12,7 +12,7 @@ import { z } from 'zod'
  * layer; use the row types internally for direct Supabase access.
  *
  * Usage in a client project:
- *   import { BaseProject } from '@elevasis/core' (or '@repo/core' internally)
+ *   import { BaseProject } from '@elevasis/core'
  *   type Project = BaseProject<{ budget: number; riskScore: 'low' | 'medium' | 'high' }>
  *
  * Extending a Zod schema in a client project:

package/src/business/clients/api-schemas.test.ts

@@ -114,7 +114,6 @@ describe('client API schemas', () => {
         source: 'word_of_mouth',
         metadata: {
           externalProjectSlug: 'developer-workspace-slug',
-          workspacePath: 'client-workspace',
           campaignSlug: 'byron-for-irvine'
         }
       }).success

package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts

@@ -159,20 +159,15 @@ export class GmailAdapter implements BaseIntegrationAdapter {
         requestBody: {
           raw: encodedMessage
         }
-      })
-
-      if (context?.logger) {
-        console.log('[GmailAdapter] Email sent:', {
-          organizationId: context.organizationId,
-          executionId: context.executionId,
-          to: params.to,
-          subject: params.subject,
-          messageId: response.data.id,
-          threadId: response.data.threadId
-        })
-      }
-
-      return {
+      })
+
+      if (context?.logger) {
+        context.logger.info(
+          `[GmailAdapter] Email sent: organizationId=${context.organizationId} executionId=${context.executionId} messageId=${response.data.id} threadId=${response.data.threadId} to=${params.to}`
+        )
+      }
+
+      return {
         messageId: response.data.id!,
         threadId: response.data.threadId!
       }

package/src/knowledge/cli-helpers.ts

@@ -0,0 +1,211 @@
+import type {
+  OrganizationModel,
+  OrganizationModelAction,
+  OrganizationModelActionInvocation,
+  OrganizationModelAgentResourceEntry
+} from '../organization-model/types'
+import { getSystem } from '../organization-model/helpers'
+import type { listAllResources, listAllRoles, listAllSystemsFlat, OmSearchHitKind } from './queries'
+
+export const OM_SEARCH_HIT_KINDS: OmSearchHitKind[] = ['system', 'resource', 'knowledge', 'ontology', 'role', 'policy']
+
+export function parseKnowledgeSearchLimit(raw: string | undefined, commandName = 'knowledge:search'): number {
+  if (raw === undefined) return 10
+  const n = Number.parseInt(raw, 10)
+  if (Number.isNaN(n) || n < 0) {
+    throw new Error(`${commandName}: --limit must be a non-negative integer (got "${raw}")`)
+  }
+  return n
+}
+
+export function parseKnowledgeSearchKinds(
+  raw: string | undefined,
+  commandName = 'knowledge:search'
+): OmSearchHitKind[] | undefined {
+  if (raw === undefined) return undefined
+  const requested = raw
+    .split(',')
+    .map((s) => s.trim().toLowerCase())
+    .filter((s) => s.length > 0)
+  const valid: OmSearchHitKind[] = []
+  const invalid: string[] = []
+  for (const kind of requested) {
+    if (OM_SEARCH_HIT_KINDS.includes(kind as OmSearchHitKind)) {
+      valid.push(kind as OmSearchHitKind)
+    } else {
+      invalid.push(kind)
+    }
+  }
+  if (invalid.length > 0) {
+    throw new Error(`${commandName}: unknown kind(s) "${invalid.join(', ')}". Valid: ${OM_SEARCH_HIT_KINDS.join(', ')}`)
+  }
+  return valid.length > 0 ? valid : undefined
+}
+
+export function formatKnowledgeSystemsList(entries: ReturnType<typeof listAllSystemsFlat>): string {
+  if (entries.length === 0) return '(no results)'
+  const pathWidth = Math.max(...entries.map((e) => e.path.length), 4)
+  const header = `${'PATH'.padEnd(pathWidth)}  LABEL`
+  const divider = '-'.repeat(header.length + 20)
+  const rows = entries.map((e) => {
+    const label = e.system.label ?? e.system.title ?? e.path
+    return `${e.path.padEnd(pathWidth)}  ${label}`
+  })
+  return [header, divider, ...rows].join('\n')
+}
+
+export function formatKnowledgeResourcesList(resources: ReturnType<typeof listAllResources>): string {
+  if (resources.length === 0) return '(no results)'
+  const idWidth = Math.max(...resources.map((r) => r.id.length), 4)
+  const kindWidth = Math.max(...resources.map((r) => r.kind.length), 4)
+  const header = `${'ID'.padEnd(idWidth)}  ${'KIND'.padEnd(kindWidth)}  TITLE`
+  const divider = '-'.repeat(header.length + 20)
+  const rows = resources.map((r) => {
+    const title = r.title ?? r.id
+    return `${r.id.padEnd(idWidth)}  ${r.kind.padEnd(kindWidth)}  ${title}`
+  })
+  return [header, divider, ...rows].join('\n')
+}
+
+export function formatKnowledgeRolesList(roles: ReturnType<typeof listAllRoles>): string {
+  if (roles.length === 0) return '(no results)'
+  const idWidth = Math.max(...roles.map((r) => r.id.length), 4)
+  const header = `${'ID'.padEnd(idWidth)}  TITLE`
+  const divider = '-'.repeat(header.length + 20)
+  const rows = roles.map((r) => `${r.id.padEnd(idWidth)}  ${r.title}`)
+  return [header, divider, ...rows].join('\n')
+}
+
+export interface KnowledgeInvocationSource {
+  kind: 'action' | 'agent-resource'
+  id: string
+  label: string
+  targetNodeId: string
+  invocations: OrganizationModelActionInvocation[]
+}
+
+export interface KnowledgeInvocationNeighborsResult {
+  id: string
+  title: string
+  invocationSources: KnowledgeInvocationSource[]
+}
+
+export function normalizeKnowledgeNodeId(id: string): string {
+  return id.startsWith('knowledge:') ? id.slice('knowledge:'.length) : id
+}
+
+export function formatKnowledgeInvocationLabel(invocation: OrganizationModelActionInvocation): string {
+  switch (invocation.kind) {
+    case 'slash-command':
+      return invocation.command
+    case 'mcp-tool':
+      return `${invocation.server}/${invocation.name}`
+    case 'api-endpoint':
+      return `${invocation.method} ${invocation.path}`
+    case 'script-execution':
+      return invocation.resourceId
+  }
+}
+
+function pushActionSource(
+  sources: KnowledgeInvocationSource[],
+  seen: Set<string>,
+  action: OrganizationModelAction | undefined
+): void {
+  if (!action || action.invocations.length === 0) return
+
+  const key = `action:${action.id}`
+  if (seen.has(key)) return
+  seen.add(key)
+
+  sources.push({
+    kind: 'action',
+    id: action.id,
+    label: action.label,
+    targetNodeId: `action:${action.id}`,
+    invocations: action.invocations
+  })
+}
+
+function pushAgentResourceSource(
+  sources: KnowledgeInvocationSource[],
+  seen: Set<string>,
+  resource: OrganizationModel['resources'][string] | undefined
+): void {
+  if (!resource || resource.kind !== 'agent' || resource.invocations.length === 0) return
+
+  const agentResource = resource as OrganizationModelAgentResourceEntry
+  const key = `agent-resource:${agentResource.id}`
+  if (seen.has(key)) return
+  seen.add(key)
+
+  sources.push({
+    kind: 'agent-resource',
+    id: agentResource.id,
+    label: agentResource.id,
+    targetNodeId: `resource:${agentResource.id}`,
+    invocations: agentResource.invocations
+  })
+}
+
+export function resolveKnowledgeInvocationNeighbors(
+  model: OrganizationModel,
+  id: string
+): KnowledgeInvocationNeighborsResult | undefined {
+  const normalizedNodeId = normalizeKnowledgeNodeId(id)
+  const node = model.knowledge[normalizedNodeId]
+  if (!node) return undefined
+
+  const sources: KnowledgeInvocationSource[] = []
+  const seen = new Set<string>()
+
+  for (const link of node.links) {
+    const target = link.target
+
+    if (target.kind === 'action') {
+      pushActionSource(sources, seen, model.actions[target.id])
+      continue
+    }
+
+    if (target.kind === 'resource') {
+      pushAgentResourceSource(sources, seen, model.resources[target.id])
+      continue
+    }
+
+    if (target.kind === 'system') {
+      const system = getSystem(model, target.id)
+      for (const actionRef of system?.actions ?? []) {
+        pushActionSource(sources, seen, model.actions[actionRef.actionId])
+      }
+
+      for (const resource of Object.values(model.resources)) {
+        if (resource.systemPath === target.id) {
+          pushAgentResourceSource(sources, seen, resource)
+        }
+      }
+    }
+  }
+
+  return {
+    id: node.id,
+    title: node.title,
+    invocationSources: sources.sort((a, b) => a.targetNodeId.localeCompare(b.targetNodeId))
+  }
+}
+
+export function formatKnowledgeInvocationNeighbors(result: KnowledgeInvocationNeighborsResult): string {
+  const lines = [`Invocation-bearing graph neighbors for ${result.id}`, '']
+
+  if (result.invocationSources.length === 0) {
+    lines.push('  (none)')
+  } else {
+    for (const source of result.invocationSources) {
+      lines.push(`${source.kind}: ${source.id}`)
+      for (const invocation of source.invocations) {
+        lines.push(`  ${invocation.kind}: ${formatKnowledgeInvocationLabel(invocation)}`)
+      }
+    }
+  }
+
+  return lines.join('\n')
+}

package/src/knowledge/index.ts

@@ -29,3 +29,16 @@ export type {
 
 export { formatText, formatJson, formatIdsOnly, formatOmSearchHits, formatOmDescribe } from './format'
 export type { KnowledgeJsonEnvelope } from './format'
+export {
+  OM_SEARCH_HIT_KINDS,
+  parseKnowledgeSearchLimit,
+  parseKnowledgeSearchKinds,
+  formatKnowledgeSystemsList,
+  formatKnowledgeResourcesList,
+  formatKnowledgeRolesList,
+  normalizeKnowledgeNodeId,
+  formatKnowledgeInvocationLabel,
+  resolveKnowledgeInvocationNeighbors,
+  formatKnowledgeInvocationNeighbors
+} from './cli-helpers'
+export type { KnowledgeInvocationSource, KnowledgeInvocationNeighborsResult } from './cli-helpers'

package/src/knowledge/published.ts

@@ -1,5 +1,18 @@
-export { bySystem, byKind, byOwner, governs, governedBy, parsePath } from './queries'
-export type { KnowledgeMount, ParsedKnowledgePath } from './queries'
-
-export { formatText, formatJson, formatIdsOnly } from './format'
-export type { KnowledgeJsonEnvelope } from './format'
+export { bySystem, byKind, byOwner, governs, governedBy, parsePath } from './queries'
+export type { KnowledgeMount, ParsedKnowledgePath, OmSearchHitKind } from './queries'
+
+export { formatText, formatJson, formatIdsOnly } from './format'
+export type { KnowledgeJsonEnvelope } from './format'
+export {
+  OM_SEARCH_HIT_KINDS,
+  parseKnowledgeSearchLimit,
+  parseKnowledgeSearchKinds,
+  formatKnowledgeSystemsList,
+  formatKnowledgeResourcesList,
+  formatKnowledgeRolesList,
+  normalizeKnowledgeNodeId,
+  formatKnowledgeInvocationLabel,
+  resolveKnowledgeInvocationNeighbors,
+  formatKnowledgeInvocationNeighbors
+} from './cli-helpers'
+export type { KnowledgeInvocationSource, KnowledgeInvocationNeighborsResult } from './cli-helpers'

package/src/organization-model/__tests__/cross-ref.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest'
 import { DEFAULT_ORGANIZATION_MODEL } from '../defaults'
-import { buildOmCrossRefIndex, knowledgeTargetExists } from '../cross-ref'
+import { buildOmCompilationContext, buildOmCrossRefIndex, knowledgeTargetExists } from '../cross-ref'
 import { OrganizationModelSchema } from '../schema'
 import type { OrganizationModel } from '../types'
 
@@ -80,6 +80,16 @@ function makeModelWithStage(): OrganizationModel {
 // ---------------------------------------------------------------------------
 
 describe('knowledgeTargetExists — stage kind', () => {
+  it('buildOmCompilationContext returns a memoized cross-ref index plus ontology compilation', () => {
+    const model = makeModelWithStage()
+    const context = buildOmCompilationContext(model)
+
+    expect(buildOmCompilationContext(model)).toBe(context)
+    expect(context.crossRefIndex.stageIds.has('prospect')).toBe(true)
+    expect(context.ontologyCompilation.ontology.catalogTypes['sales.lead-gen:catalog/company-stage']).toBeDefined()
+    expect(buildOmCrossRefIndex(model)).toBe(context.crossRefIndex)
+  })
+
   it('returns true for a stage id that exists in a stage-kind catalog', () => {
     const model = makeModelWithStage()
     const idx = buildOmCrossRefIndex(model)

package/src/organization-model/__tests__/domains/systems.test.ts

@@ -123,10 +123,10 @@ describe('SystemEntrySchema - positive parse', () => {
     }
   })
 
-  it('accepts deprecated status and maps it to lifecycle for one-cycle compatibility', () => {
-    const warn = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
-
-    const result = SystemEntrySchema.safeParse({
+  it('accepts deprecated status and maps it to lifecycle for one-cycle compatibility', () => {
+    const warn = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
+
+    const result = SystemEntrySchema.safeParse({
       ...VALID_SYSTEM,
       status: 'deprecated'
     })
@@ -137,10 +137,32 @@ describe('SystemEntrySchema - positive parse', () => {
       expect(result.data.lifecycle).toBe('deprecated')
     }
     expect(warn).toHaveBeenCalledWith('[organization-model] System.status is deprecated; use System.lifecycle instead.')
-
-    warn.mockRestore()
-  })
-})
+
+    warn.mockRestore()
+  })
+
+  it('keeps non-color compatibility fields readable', () => {
+    const result = SystemEntrySchema.safeParse({
+      ...VALID_SYSTEM,
+      path: '/lead-gen',
+      icon: 'settings',
+      uiPosition: 'sidebar-primary',
+      enabled: true,
+      devOnly: false
+    })
+
+    expect(result.success).toBe(true)
+    if (result.success) {
+      expect(result.data).toMatchObject({
+        path: '/lead-gen',
+        icon: 'settings',
+        uiPosition: 'sidebar-primary',
+        enabled: true,
+        devOnly: false
+      })
+    }
+  })
+})
 
 describe('SystemEntrySchema - negative parse', () => {
   it('rejects missing required fields', () => {
@@ -159,6 +181,10 @@ describe('SystemEntrySchema - negative parse', () => {
     expect(SystemEntrySchema.safeParse({ ...VALID_SYSTEM, id: 'Sys Lead Gen' }).success).toBe(false)
   })
 
+  it('rejects the retired color compatibility field', () => {
+    expect(SystemEntrySchema.safeParse({ ...VALID_SYSTEM, color: 'blue' }).success).toBe(false)
+  })
+
   it('rejects malformed System Interface states', () => {
     expect(SystemApiInterfaceSchema.safeParse({ kind: 'api', lifecycle: 'active' }).success).toBe(false)
     expect(SystemApiInterfaceSchema.safeParse({ lifecycle: 'paused' }).success).toBe(false)