@elevasis/core 0.15.1 → 0.17.0

package/src/knowledge/queries.ts

@@ -0,0 +1,256 @@
+import type { OrganizationGraph } from '../organization-model/graph/types'
+import type { OrgKnowledgeKind, OrgKnowledgeNode } from '../organization-model/domains/knowledge'
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Graph node ID prefix for knowledge nodes.
+ * Graph node IDs follow the convention: `knowledge:<om-node-id>`
+ * e.g. `knowledge:knowledge.outreach-playbook`
+ */
+function toGraphNodeId(omNodeId: string): string {
+  return `knowledge:${omNodeId}`
+}
+
+/**
+ * Resolve the sourceId of every knowledge node in the graph, keyed by graph
+ * node ID.  The `sourceId` on a knowledge graph node is the OM node id
+ * (e.g. `knowledge.outreach-playbook`).
+ */
+function buildKnowledgeSourceIdMap(graph: OrganizationGraph): Map<string, string> {
+  const map = new Map<string, string>()
+  for (const node of graph.nodes) {
+    if (node.kind === 'knowledge' && node.sourceId) {
+      map.set(node.id, node.sourceId)
+    }
+  }
+  return map
+}
+
+// ---------------------------------------------------------------------------
+// Query functions
+// ---------------------------------------------------------------------------
+
+/**
+ * Returns all knowledge nodes whose `governs` edges point to the given
+ * featureId (graph node ID: `feature:<featureId>`).
+ *
+ * @param graph   - The built OrganizationGraph.
+ * @param featureId - The dotted feature id (e.g. `sales.crm`).
+ */
+export function byFeature(
+  graph: OrganizationGraph,
+  featureId: string,
+  knowledgeNodes: OrgKnowledgeNode[]
+): OrgKnowledgeNode[] {
+  const targetGraphNodeId = `feature:${featureId}`
+
+  // Find all knowledge graph node IDs that have a `governs` edge to the target
+  const governingKnowledgeNodeIds = new Set<string>()
+  for (const edge of graph.edges) {
+    if (edge.kind === 'governs' && edge.targetId === targetGraphNodeId && edge.sourceId.startsWith('knowledge:')) {
+      governingKnowledgeNodeIds.add(edge.sourceId)
+    }
+  }
+
+  // Build a lookup from graph-node-id -> OM sourceId
+  const sourceIdMap = buildKnowledgeSourceIdMap(graph)
+
+  // Collect the OM node ids that correspond to those graph nodes
+  const matchingOmIds = new Set<string>()
+  for (const graphNodeId of governingKnowledgeNodeIds) {
+    const omId = sourceIdMap.get(graphNodeId)
+    if (omId) matchingOmIds.add(omId)
+  }
+
+  return knowledgeNodes.filter((n) => matchingOmIds.has(n.id))
+}
+
+/**
+ * Returns all knowledge nodes whose `kind` matches the given kind.
+ *
+ * @param graph          - The built OrganizationGraph (unused structurally; kept for API symmetry).
+ * @param kind           - The knowledge kind (`'playbook' | 'strategy' | 'reference'`).
+ * @param knowledgeNodes - Flat array of OrgKnowledgeNode from the OrganizationModel.
+ */
+export function byKind(
+  _graph: OrganizationGraph,
+  kind: OrgKnowledgeKind,
+  knowledgeNodes: OrgKnowledgeNode[]
+): OrgKnowledgeNode[] {
+  return knowledgeNodes.filter((n) => n.kind === kind)
+}
+
+/**
+ * Returns all knowledge nodes where `ownerIds` includes the given `ownerId`.
+ *
+ * @param _graph         - The built OrganizationGraph (unused; kept for API symmetry).
+ * @param ownerId        - The owner id string (matches values in `node.ownerIds`).
+ * @param knowledgeNodes - Flat array of OrgKnowledgeNode from the OrganizationModel.
+ */
+export function byOwner(
+  _graph: OrganizationGraph,
+  ownerId: string,
+  knowledgeNodes: OrgKnowledgeNode[]
+): OrgKnowledgeNode[] {
+  return knowledgeNodes.filter((n) => n.ownerIds.includes(ownerId))
+}
+
+/**
+ * Returns the IDs of the graph nodes that the given knowledge node governs
+ * (outgoing `governs` edges from the knowledge graph node).
+ *
+ * The graph node ID for a knowledge OM node with id `X` is `knowledge:X`.
+ *
+ * @param graph    - The built OrganizationGraph.
+ * @param nodeId   - The OM knowledge node id (e.g. `knowledge.outreach-playbook`).
+ *                   Also accepts the graph node ID format (`knowledge:knowledge.outreach-playbook`).
+ * @returns Array of target graph node IDs (e.g. `['feature:sales.crm', ...]`).
+ */
+export function governs(graph: OrganizationGraph, nodeId: string): string[] {
+  const graphNodeId = nodeId.startsWith('knowledge:') ? nodeId : toGraphNodeId(nodeId)
+
+  const results: string[] = []
+  for (const edge of graph.edges) {
+    if (edge.kind === 'governs' && edge.sourceId === graphNodeId) {
+      results.push(edge.targetId)
+    }
+  }
+  return results
+}
+
+/**
+ * Returns the IDs of the knowledge graph nodes that govern the given node
+ * (incoming `governs` edges pointing to `nodeId`).
+ *
+ * @param graph   - The built OrganizationGraph.
+ * @param nodeId  - The target graph node ID (e.g. `feature:sales.crm`) or a
+ *                  bare feature id (e.g. `sales.crm` — will be prefixed with `feature:`).
+ * @returns Array of source graph node IDs (e.g. `['knowledge:knowledge.outreach-playbook', ...]`).
+ */
+export function governedBy(graph: OrganizationGraph, nodeId: string): string[] {
+  // Accept both `feature:sales.crm` and bare `sales.crm`
+  const targetId =
+    nodeId.startsWith('feature:') || nodeId.startsWith('knowledge:') || nodeId.startsWith('resource:')
+      ? nodeId
+      : `feature:${nodeId}`
+
+  const results: string[] = []
+  for (const edge of graph.edges) {
+    if (edge.kind === 'governs' && edge.targetId === targetId) {
+      results.push(edge.sourceId)
+    }
+  }
+  return results
+}
+
+// ---------------------------------------------------------------------------
+// Path parser
+// ---------------------------------------------------------------------------
+
+/** The recognized mount axes for Knowledge Map paths. */
+export type KnowledgeMount = 'by-feature' | 'by-kind' | 'by-owner' | 'graph' | 'node'
+
+/**
+ * The result of parsing a Knowledge Map path string.
+ *
+ * Shape: `{ mount: KnowledgeMount, args: string[] }`
+ *
+ * Per-mount arg arrays:
+ * - `by-feature`: `[featureId]`  (e.g. `['sales.crm']`)
+ * - `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)
+ */
+export interface ParsedKnowledgePath {
+  mount: KnowledgeMount
+  args: string[]
+}
+
+/**
+ * Parses a Knowledge Map path string into a `{ mount, args }` descriptor.
+ *
+ * Supported path patterns:
+ *   `/by-feature/<featureId>`         → `{ mount: 'by-feature', args: ['<featureId>'] }`
+ *   `/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>'] }`
+ *
+ * The path MUST start with `/`.  Trailing slashes are stripped before parsing.
+ *
+ * @throws {Error} If the path is empty, missing a leading slash, or does not
+ *   match any supported mount pattern.
+ */
+export function parsePath(pathString: string): ParsedKnowledgePath {
+  if (!pathString || typeof pathString !== 'string') {
+    throw new Error('parsePath: path must be a non-empty string')
+  }
+
+  if (!pathString.startsWith('/')) {
+    throw new Error(`parsePath: path must start with "/", got: "${pathString}"`)
+  }
+
+  // Strip trailing slashes then split
+  const normalized = pathString.replace(/\/+$/, '')
+  const segments = normalized.split('/').filter((s) => s.length > 0)
+
+  if (segments.length === 0) {
+    throw new Error(`parsePath: path resolves to root with no mount: "${pathString}"`)
+  }
+
+  const [first, ...rest] = segments
+
+  // /by-feature/<featureId>
+  if (first === 'by-feature') {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-feature requires a featureId argument, got: "${pathString}"`)
+    }
+    return { mount: 'by-feature', args: [rest.join('/')] }
+  }
+
+  // /by-kind/<kind>
+  if (first === 'by-kind') {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-kind requires a kind argument, got: "${pathString}"`)
+    }
+    return { mount: 'by-kind', args: [rest[0]] }
+  }
+
+  // /by-owner/<ownerId>
+  if (first === 'by-owner') {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-owner requires an ownerId argument, got: "${pathString}"`)
+    }
+    return { mount: 'by-owner', args: [rest.join('/')] }
+  }
+
+  // /graph/<nodeId>/governs  or  /graph/<nodeId>/governed-by
+  if (first === 'graph') {
+    if (rest.length < 2) {
+      throw new Error(`parsePath: /graph requires <nodeId>/<verb> (governs|governed-by), got: "${pathString}"`)
+    }
+    const graphNodeId = rest.slice(0, -1).join('/')
+    const verb = rest[rest.length - 1]
+    if (verb !== 'governs' && verb !== 'governed-by') {
+      throw new Error(
+        `parsePath: /graph/<nodeId> verb must be "governs" or "governed-by", got: "${verb}" in "${pathString}"`
+      )
+    }
+    return { mount: 'graph', args: [graphNodeId, verb] }
+  }
+
+  // /<nodeId>  (single node)
+  // first must not be a recognized mount prefix
+  if (segments.length === 1) {
+    return { mount: 'node', args: [first] }
+  }
+
+  throw new Error(
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-feature/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
+  )
+}

package/src/organization-model/__tests__/defaults.test.ts

@@ -1,85 +1,85 @@
-import { describe, expect, it } from 'vitest'
-import { DEFAULT_ORGANIZATION_MODEL } from '../defaults'
-import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from '../domains/branding'
-import { OrganizationModelBrandingSchema } from '../domains/branding'
-import { DEFAULT_ORGANIZATION_MODEL_SALES } from '../domains/sales'
-import { OrganizationModelSalesSchema } from '../domains/sales'
-import { DEFAULT_ORGANIZATION_MODEL_PROJECTS } from '../domains/projects'
-import { OrganizationModelProjectsSchema } from '../domains/projects'
-import { DEFAULT_ORGANIZATION_MODEL_PROSPECTING } from '../domains/prospecting'
-import { OrganizationModelProspectingSchema } from '../domains/prospecting'
-import { DEFAULT_ORGANIZATION_MODEL_NAVIGATION } from '../domains/navigation'
-import { OrganizationModelNavigationSchema } from '../domains/navigation'
-import { DEFAULT_ORGANIZATION_MODEL_OPERATIONS } from '../domains/operations'
-import { OperationsDomainSchema } from '../domains/operations'
-import { DEFAULT_ORGANIZATION_MODEL_STATUSES } from '../domains/statuses'
-import { StatusesDomainSchema } from '../domains/statuses'
-import { resolveOrganizationModel } from '../resolve'
-import { OrganizationModelSchema } from '../schema'
-
-// All DEFAULT_ORGANIZATION_MODEL* constants and the schemas used to validate them.
-// The composite constant lives in defaults.ts; domain sub-constants live in their
-// respective domain files. All are covered here for roundtrip integrity.
-const domainCases = [
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_BRANDING',
-    constant: DEFAULT_ORGANIZATION_MODEL_BRANDING,
-    schema: OrganizationModelBrandingSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_SALES',
-    constant: DEFAULT_ORGANIZATION_MODEL_SALES,
-    schema: OrganizationModelSalesSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_PROJECTS',
-    constant: DEFAULT_ORGANIZATION_MODEL_PROJECTS,
-    schema: OrganizationModelProjectsSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_PROSPECTING',
-    constant: DEFAULT_ORGANIZATION_MODEL_PROSPECTING,
-    schema: OrganizationModelProspectingSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_NAVIGATION',
-    constant: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
-    schema: OrganizationModelNavigationSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_STATUSES',
-    constant: DEFAULT_ORGANIZATION_MODEL_STATUSES,
-    schema: StatusesDomainSchema
-  },
-  {
-    name: 'DEFAULT_ORGANIZATION_MODEL_OPERATIONS',
-    constant: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
-    schema: OperationsDomainSchema
-  }
-] as const
-
-describe('organization-model defaults', () => {
-  describe('DEFAULT_ORGANIZATION_MODEL (composite)', () => {
-    it('passes OrganizationModelSchema.parse without throwing', () => {
-      expect(() => OrganizationModelSchema.parse(DEFAULT_ORGANIZATION_MODEL)).not.toThrow()
-    })
-
-    it('resolveOrganizationModel(DEFAULT_ORGANIZATION_MODEL) returns a schema-valid model', () => {
-      const result = resolveOrganizationModel(DEFAULT_ORGANIZATION_MODEL)
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-
+import { describe, expect, it } from 'vitest'
+import { DEFAULT_ORGANIZATION_MODEL } from '../defaults'
+import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from '../domains/branding'
+import { OrganizationModelBrandingSchema } from '../domains/branding'
+import { DEFAULT_ORGANIZATION_MODEL_SALES } from '../domains/sales'
+import { OrganizationModelSalesSchema } from '../domains/sales'
+import { DEFAULT_ORGANIZATION_MODEL_PROJECTS } from '../domains/projects'
+import { OrganizationModelProjectsSchema } from '../domains/projects'
+import { DEFAULT_ORGANIZATION_MODEL_PROSPECTING } from '../domains/prospecting'
+import { OrganizationModelProspectingSchema } from '../domains/prospecting'
+import { DEFAULT_ORGANIZATION_MODEL_NAVIGATION } from '../domains/navigation'
+import { OrganizationModelNavigationSchema } from '../domains/navigation'
+import { DEFAULT_ORGANIZATION_MODEL_OPERATIONS } from '../domains/operations'
+import { OperationsDomainSchema } from '../domains/operations'
+import { DEFAULT_ORGANIZATION_MODEL_STATUSES } from '../domains/statuses'
+import { StatusesDomainSchema } from '../domains/statuses'
+import { resolveOrganizationModel } from '../resolve'
+import { OrganizationModelSchema } from '../schema'
+
+// All DEFAULT_ORGANIZATION_MODEL* constants and the schemas used to validate them.
+// The composite constant lives in defaults.ts; domain sub-constants live in their
+// respective domain files. All are covered here for roundtrip integrity.
+const domainCases = [
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_BRANDING',
+    constant: DEFAULT_ORGANIZATION_MODEL_BRANDING,
+    schema: OrganizationModelBrandingSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_SALES',
+    constant: DEFAULT_ORGANIZATION_MODEL_SALES,
+    schema: OrganizationModelSalesSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_PROJECTS',
+    constant: DEFAULT_ORGANIZATION_MODEL_PROJECTS,
+    schema: OrganizationModelProjectsSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_PROSPECTING',
+    constant: DEFAULT_ORGANIZATION_MODEL_PROSPECTING,
+    schema: OrganizationModelProspectingSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_NAVIGATION',
+    constant: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
+    schema: OrganizationModelNavigationSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_STATUSES',
+    constant: DEFAULT_ORGANIZATION_MODEL_STATUSES,
+    schema: StatusesDomainSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_OPERATIONS',
+    constant: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
+    schema: OperationsDomainSchema
+  }
+] as const
+
+describe('organization-model defaults', () => {
+  describe('DEFAULT_ORGANIZATION_MODEL (composite)', () => {
+    it('passes OrganizationModelSchema.parse without throwing', () => {
+      expect(() => OrganizationModelSchema.parse(DEFAULT_ORGANIZATION_MODEL)).not.toThrow()
+    })
+
+    it('resolveOrganizationModel(DEFAULT_ORGANIZATION_MODEL) returns a schema-valid model', () => {
+      const result = resolveOrganizationModel(DEFAULT_ORGANIZATION_MODEL)
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+
     it('resolveOrganizationModel with no override equals resolveOrganizationModel with DEFAULT_ORGANIZATION_MODEL', () => {
       const fromUndefined = resolveOrganizationModel(undefined)
       const fromDefault = resolveOrganizationModel(DEFAULT_ORGANIZATION_MODEL)
       expect(fromDefault).toEqual(fromUndefined)
     })
 
-    it('keeps Command View enabled but development-only in the default Operations navigation', () => {
+    it('keeps Command View enabled but development-only in the default Knowledge navigation', () => {
       const result = resolveOrganizationModel(undefined)
-      const commandViewFeature = result.features.find((feature) => feature.id === 'operations.command-view')
+      const commandViewFeature = result.features.find((feature) => feature.id === 'knowledge.command-view')
       const commandViewSurface = DEFAULT_ORGANIZATION_MODEL_NAVIGATION.surfaces.find(
-        (surface) => surface.id === 'operations.command-view'
+        (surface) => surface.id === 'knowledge.command-view'
       )
 
       expect(commandViewFeature?.enabled).toBe(true)
@@ -88,101 +88,101 @@ describe('organization-model defaults', () => {
       expect(commandViewSurface?.devOnly).toBe(true)
     })
   })
-
-  describe.each(domainCases)('$name (domain sub-constant)', ({ name: _name, constant, schema }) => {
-    it('passes its domain schema parse without throwing', () => {
-      expect(() => schema.parse(constant)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_BRANDING via resolveOrganizationModel', () => {
-    it('resolving with branding override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ branding: DEFAULT_ORGANIZATION_MODEL_BRANDING })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_SALES via resolveOrganizationModel', () => {
-    it('resolving with sales override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ sales: DEFAULT_ORGANIZATION_MODEL_SALES })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_PROJECTS via resolveOrganizationModel', () => {
-    it('resolving with projects override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ projects: DEFAULT_ORGANIZATION_MODEL_PROJECTS })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_PROSPECTING via resolveOrganizationModel', () => {
-    it('resolving with prospecting override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ prospecting: DEFAULT_ORGANIZATION_MODEL_PROSPECTING })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_NAVIGATION via resolveOrganizationModel', () => {
-    it('resolving with navigation override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_OPERATIONS via resolveOrganizationModel', () => {
-    it('resolving with operations override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-
-    it('default operations seed covers all 5 entity categories', () => {
-      expect(DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries).toHaveLength(5)
-    })
-
-    it('every entry has a non-empty id, label, and semanticClass', () => {
-      for (const entry of DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries) {
-        expect(entry.id.length).toBeGreaterThan(0)
-        expect(entry.label.length).toBeGreaterThan(0)
-        expect(entry.semanticClass.length).toBeGreaterThan(0)
-      }
-    })
-
-    it('all entry ids are unique', () => {
-      const ids = DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries.map((e) => e.id)
-      const uniqueIds = new Set(ids)
-      expect(uniqueIds.size).toBe(ids.length)
-    })
-  })
-
-  describe('DEFAULT_ORGANIZATION_MODEL_STATUSES via resolveOrganizationModel', () => {
-    it('resolving with statuses override produces a schema-valid model', () => {
-      const result = resolveOrganizationModel({ statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES })
-      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
-    })
-
-    it('default statuses seed covers all 9 delivery.task values', () => {
-      const taskEntries = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.filter((e) => e.semanticClass === 'delivery.task')
-      expect(taskEntries).toHaveLength(9)
-    })
-
-    it('default statuses seed covers all 5 queue values', () => {
-      const queueEntries = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.filter((e) => e.semanticClass === 'queue')
-      expect(queueEntries).toHaveLength(5)
-    })
-
-    it('every entry has a non-empty id, label, and semanticClass', () => {
-      for (const entry of DEFAULT_ORGANIZATION_MODEL_STATUSES.entries) {
-        expect(entry.id.length).toBeGreaterThan(0)
-        expect(entry.label.length).toBeGreaterThan(0)
-        expect(entry.semanticClass.length).toBeGreaterThan(0)
-      }
-    })
-
-    it('all entry ids are unique', () => {
-      const ids = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.map((e) => e.id)
-      const uniqueIds = new Set(ids)
-      expect(uniqueIds.size).toBe(ids.length)
-    })
-  })
-})
+
+  describe.each(domainCases)('$name (domain sub-constant)', ({ name: _name, constant, schema }) => {
+    it('passes its domain schema parse without throwing', () => {
+      expect(() => schema.parse(constant)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_BRANDING via resolveOrganizationModel', () => {
+    it('resolving with branding override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ branding: DEFAULT_ORGANIZATION_MODEL_BRANDING })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_SALES via resolveOrganizationModel', () => {
+    it('resolving with sales override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ sales: DEFAULT_ORGANIZATION_MODEL_SALES })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_PROJECTS via resolveOrganizationModel', () => {
+    it('resolving with projects override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ projects: DEFAULT_ORGANIZATION_MODEL_PROJECTS })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_PROSPECTING via resolveOrganizationModel', () => {
+    it('resolving with prospecting override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ prospecting: DEFAULT_ORGANIZATION_MODEL_PROSPECTING })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_NAVIGATION via resolveOrganizationModel', () => {
+    it('resolving with navigation override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_OPERATIONS via resolveOrganizationModel', () => {
+    it('resolving with operations override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+
+    it('default operations seed covers all 5 entity categories', () => {
+      expect(DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries).toHaveLength(5)
+    })
+
+    it('every entry has a non-empty id, label, and semanticClass', () => {
+      for (const entry of DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries) {
+        expect(entry.id.length).toBeGreaterThan(0)
+        expect(entry.label.length).toBeGreaterThan(0)
+        expect(entry.semanticClass.length).toBeGreaterThan(0)
+      }
+    })
+
+    it('all entry ids are unique', () => {
+      const ids = DEFAULT_ORGANIZATION_MODEL_OPERATIONS.entries.map((e) => e.id)
+      const uniqueIds = new Set(ids)
+      expect(uniqueIds.size).toBe(ids.length)
+    })
+  })
+
+  describe('DEFAULT_ORGANIZATION_MODEL_STATUSES via resolveOrganizationModel', () => {
+    it('resolving with statuses override produces a schema-valid model', () => {
+      const result = resolveOrganizationModel({ statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES })
+      expect(() => OrganizationModelSchema.parse(result)).not.toThrow()
+    })
+
+    it('default statuses seed covers all 9 delivery.task values', () => {
+      const taskEntries = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.filter((e) => e.semanticClass === 'delivery.task')
+      expect(taskEntries).toHaveLength(9)
+    })
+
+    it('default statuses seed covers all 5 queue values', () => {
+      const queueEntries = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.filter((e) => e.semanticClass === 'queue')
+      expect(queueEntries).toHaveLength(5)
+    })
+
+    it('every entry has a non-empty id, label, and semanticClass', () => {
+      for (const entry of DEFAULT_ORGANIZATION_MODEL_STATUSES.entries) {
+        expect(entry.id.length).toBeGreaterThan(0)
+        expect(entry.label.length).toBeGreaterThan(0)
+        expect(entry.semanticClass.length).toBeGreaterThan(0)
+      }
+    })
+
+    it('all entry ids are unique', () => {
+      const ids = DEFAULT_ORGANIZATION_MODEL_STATUSES.entries.map((e) => e.id)
+      const uniqueIds = new Set(ids)
+      expect(uniqueIds.size).toBe(ids.length)
+    })
+  })
+})

package/src/organization-model/__tests__/foundation.test.ts

@@ -59,13 +59,13 @@ describe('createFoundationOrganizationModel', () => {
       branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
     })
 
-    const crmSurface = result.getOrganizationSurface('crm')
-    expect(crmSurface).toBeDefined()
-    expect(crmSurface?.id).toBe('crm')
-    expect(crmSurface?.icon).toBe('crm')
-
-    expect(result.getOrganizationSurface('nonexistent')).toBeUndefined()
-  })
+    const crmSurface = result.getOrganizationSurface('crm')
+    expect(crmSurface).toBeDefined()
+    expect(crmSurface?.id).toBe('crm')
+    expect(crmSurface?.icon).toBe('feature.crm')
+
+    expect(result.getOrganizationSurface('nonexistent')).toBeUndefined()
+  })
 
   it('throws when a required core surface is missing', () => {
     const override = {

package/src/organization-model/__tests__/icons.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest'
+import {
+  ORGANIZATION_MODEL_ICON_TOKENS,
+  OrganizationModelBuiltinIconTokenSchema,
+  OrganizationModelIconTokenSchema
+} from '../icons'
+import { IconNameSchema } from '../domains/shared'
+
+describe('OrganizationModelIconTokenSchema', () => {
+  it('accepts built-in semantic icon tokens', () => {
+    for (const token of ORGANIZATION_MODEL_ICON_TOKENS) {
+      expect(OrganizationModelBuiltinIconTokenSchema.parse(token)).toBe(token)
+      expect(OrganizationModelIconTokenSchema.parse(token)).toBe(token)
+    }
+  })
+
+  it('accepts custom extension icon tokens', () => {
+    expect(OrganizationModelIconTokenSchema.parse('custom.partner-portal')).toBe('custom.partner-portal')
+    expect(IconNameSchema.parse('custom.acme.ops_queue')).toBe('custom.acme.ops_queue')
+  })
+
+  it('rejects random strings outside the built-in and custom namespaces', () => {
+    for (const token of ['crm', 'lead-gen', 'settings', 'random.icon', 'custom.', 'custom.Bad']) {
+      expect(OrganizationModelIconTokenSchema.safeParse(token).success).toBe(false)
+    }
+  })
+})