@elevasis/core 0.23.0 → 0.24.0

package/src/business/acquisition/crm-state-actions.test.ts

@@ -1,153 +1,153 @@
-import { describe, expect, it } from 'vitest'
-// Phase 4 (D8): DEFAULT_ORGANIZATION_MODEL_SALES no longer exported — pipeline data moved to
-// system.content. CRM_PIPELINE_DEFINITION is retained as the Stateful pipeline shape
-// for CRM business logic (separate from the OM content nodes).
-import { CRM_PIPELINE_DEFINITION, LEAD_GEN_PIPELINE_DEFINITIONS } from '../../organization-model/domains/sales'
-import { ActivityEventSchema } from './activity-events'
-import { DealStageSchema, TransitionItemRequestSchema } from './api-schemas'
-import { deriveActions } from './derive-actions'
-import type { DealStage } from './types'
-
-const DEAL_STAGES = [
-  'interested',
-  'proposal',
-  'closing',
-  'closed_won',
-  'closed_lost',
-  'nurturing'
-] as const satisfies readonly DealStage[]
-
-function deal(stageKey: string | null, stateKey: string | null = null): Parameters<typeof deriveActions>[0] {
-  return { stage_key: stageKey, state_key: stateKey } as Parameters<typeof deriveActions>[0]
-}
-
-describe('CRM deal action derivation', () => {
-  it('derives the exact base actions for interested deals', () => {
-    expect(deriveActions(deal('interested'))).toEqual([
-      { key: 'move_to_proposal', label: 'Move to Proposal' },
-      { key: 'move_to_closed_lost', label: 'Close Lost' },
-      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
-    ])
-  })
-
-  it.each([
-    ['discovery_replied', { key: 'send_link', label: 'Send Booking Link' }],
-    ['discovery_link_sent', { key: 'send_nudge', label: 'Send Nudge' }],
-    ['discovery_booking_cancelled', { key: 'rebook', label: 'Rebook' }]
-  ] as const)('adds the expected workflow action for interested/%s', (stateKey, expectedAction) => {
-    const expected = [
-      { key: 'move_to_proposal', label: 'Move to Proposal' },
-      { key: 'move_to_closed_lost', label: 'Close Lost' },
-      { key: 'move_to_nurturing', label: 'Move to Nurturing' },
-      expectedAction
-    ]
-
-    expect(deriveActions(deal('interested', stateKey))).toEqual(expected)
-  })
-
-  it('adds nudge and no-show actions for interested/discovery_nudging', () => {
-    expect(deriveActions(deal('interested', 'discovery_nudging'))).toEqual([
-      { key: 'move_to_proposal', label: 'Move to Proposal' },
-      { key: 'move_to_closed_lost', label: 'Close Lost' },
-      { key: 'move_to_nurturing', label: 'Move to Nurturing' },
-      { key: 'send_nudge', label: 'Send Nudge' },
-      { key: 'mark_no_show', label: 'Mark No-Show' }
-    ])
-  })
-
-  it('derives exact proposal and closing transitions', () => {
-    expect(deriveActions(deal('proposal'))).toEqual([
-      { key: 'move_to_closing', label: 'Move to Closing' },
-      { key: 'move_to_closed_lost', label: 'Close Lost' },
-      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
-    ])
-
-    expect(deriveActions(deal('closing'))).toEqual([
-      { key: 'move_to_closed_won', label: 'Close Won' },
-      { key: 'move_to_closed_lost', label: 'Close Lost' },
-      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
-    ])
-  })
-
-  it.each(['closed_won', 'closed_lost', 'nurturing', 'legacy_stage', null] as const)(
-    'derives no actions for terminal or non-canonical stage %s',
-    (stageKey) => {
-      expect(deriveActions(deal(stageKey))).toEqual([])
-    }
-  )
-})
-
-describe('ActivityEventSchema', () => {
-  const timestamp = '2026-04-27T12:34:56.000Z'
-
-  // Platform events only (8 members). Domain events (reply_received, booking_nudge_sent, etc.)
-  // live in @repo/elevasis-operations as CrmDomainActivityEventSchema.
-  // See Open Decision #5 in crm-action-system.mdx for rationale.
-  it.each([
-    [{ type: 'stage_change', timestamp, stageBefore: 'interested', stageAfter: 'proposal', reason: 'qualified' }],
-    [{ type: 'state_change', timestamp, stateBefore: null, stateAfter: 'discovery_replied' }],
-    [{ type: 'action_taken', timestamp, actionKey: 'send_link', payload: { channel: 'email' } }],
-    [{ type: 'approval_created', timestamp, commandId: 'cmd_123', dealStageBefore: 'proposal' }],
-    [{ type: 'approval_resolved', timestamp, commandId: 'cmd_123', resolution: 'superseded' }],
-    [{ type: 'approval_stale', timestamp, commandId: 'cmd_123', dealStageAfter: 'closing' }],
-    [{ type: 'task_created', timestamp, taskId: 'task_123' }],
-    [{ type: 'deal_created', timestamp }]
-  ])('accepts expected %s events', (event) => {
-    expect(ActivityEventSchema.safeParse(event).success).toBe(true)
-  })
-
-  it.each([
-    [{ type: 'deal_created', timestamp: 'not-a-date' }],
-    [{ type: 'unknown_event', timestamp }],
-    [{ type: 'stage_change', timestamp, stageBefore: 'interested' }],
-    [{ type: 'approval_resolved', timestamp, commandId: 'cmd_123', resolution: 'approved' }],
-    [{ type: 'booking_nudge_sent', timestamp, followupDay: '2' }],
-    [{ type: 'action_taken', timestamp }]
-  ])('rejects malformed event payload %o', (event) => {
-    expect(ActivityEventSchema.safeParse(event).success).toBe(false)
-  })
-})
-
-describe('CRM stage and transition vocabulary contracts', () => {
-  // Phase 4 (D8): DEFAULT_ORGANIZATION_MODEL_SALES.pipelines removed.
-  // CRM_PIPELINE_DEFINITION (StatefulPipelineDefinition) is the retained Stateful-trait
-  // pipeline shape used by CRM business logic. stageKey → DealStageSchema alignment
-  // is now verified against CRM_PIPELINE_DEFINITION.stages[*].stageKey.
-  it('keeps DealStage, DealStageSchema, and CRM_PIPELINE_DEFINITION stages aligned', () => {
-    const crmStageKeys = CRM_PIPELINE_DEFINITION.stages.map((stage) => stage.stageKey)
-
-    expect(crmStageKeys).toEqual([...DEAL_STAGES])
-    expect(DealStageSchema.options).toEqual([...DEAL_STAGES])
-  })
-
-  it('accepts every canonical CRM deal stage in transition requests', () => {
-    for (const stageKey of DEAL_STAGES) {
-      expect(
-        TransitionItemRequestSchema.safeParse({
-          pipelineKey: CRM_PIPELINE_DEFINITION.pipelineKey,
-          stageKey,
-          stateKey: null,
-          expectedUpdatedAt: '2026-04-27T12:34:56.000Z'
-        }).success
-      ).toBe(true)
-    }
-  })
-
-  it('accepts canonical lead-gen stage/state pairs in transition requests', () => {
-    for (const pipelineDefinitions of Object.values(LEAD_GEN_PIPELINE_DEFINITIONS)) {
-      for (const pipeline of pipelineDefinitions) {
-        for (const stage of pipeline.stages) {
-          for (const state of stage.states) {
-            expect(
-              TransitionItemRequestSchema.safeParse({
-                pipelineKey: pipeline.pipelineKey,
-                stageKey: stage.stageKey,
-                stateKey: state.stateKey
-              }).success
-            ).toBe(true)
-          }
-        }
-      }
-    }
-  })
-})
+import { describe, expect, it } from 'vitest'
+// Phase 4 (D8): DEFAULT_ORGANIZATION_MODEL_SALES no longer exported — pipeline data moved to
+// system.content. CRM_PIPELINE_DEFINITION is retained as the Stateful pipeline shape
+// for CRM business logic (separate from the OM content nodes).
+import { CRM_PIPELINE_DEFINITION, LEAD_GEN_PIPELINE_DEFINITIONS } from '../../organization-model/domains/sales'
+import { ActivityEventSchema } from './activity-events'
+import { DealStageSchema, TransitionItemRequestSchema } from './api-schemas'
+import { deriveActions } from './derive-actions'
+import type { DealStage } from './types'
+
+const DEAL_STAGES = [
+  'interested',
+  'proposal',
+  'closing',
+  'closed_won',
+  'closed_lost',
+  'nurturing'
+] as const satisfies readonly DealStage[]
+
+function deal(stageKey: string | null, stateKey: string | null = null): Parameters<typeof deriveActions>[0] {
+  return { stage_key: stageKey, state_key: stateKey } as Parameters<typeof deriveActions>[0]
+}
+
+describe('CRM deal action derivation', () => {
+  it('derives the exact base actions for interested deals', () => {
+    expect(deriveActions(deal('interested'))).toEqual([
+      { key: 'move_to_proposal', label: 'Move to Proposal' },
+      { key: 'move_to_closed_lost', label: 'Close Lost' },
+      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
+    ])
+  })
+
+  it.each([
+    ['discovery_replied', { key: 'send_link', label: 'Send Booking Link' }],
+    ['discovery_link_sent', { key: 'send_nudge', label: 'Send Nudge' }],
+    ['discovery_booking_cancelled', { key: 'rebook', label: 'Rebook' }]
+  ] as const)('adds the expected workflow action for interested/%s', (stateKey, expectedAction) => {
+    const expected = [
+      { key: 'move_to_proposal', label: 'Move to Proposal' },
+      { key: 'move_to_closed_lost', label: 'Close Lost' },
+      { key: 'move_to_nurturing', label: 'Move to Nurturing' },
+      expectedAction
+    ]
+
+    expect(deriveActions(deal('interested', stateKey))).toEqual(expected)
+  })
+
+  it('adds nudge and no-show actions for interested/discovery_nudging', () => {
+    expect(deriveActions(deal('interested', 'discovery_nudging'))).toEqual([
+      { key: 'move_to_proposal', label: 'Move to Proposal' },
+      { key: 'move_to_closed_lost', label: 'Close Lost' },
+      { key: 'move_to_nurturing', label: 'Move to Nurturing' },
+      { key: 'send_nudge', label: 'Send Nudge' },
+      { key: 'mark_no_show', label: 'Mark No-Show' }
+    ])
+  })
+
+  it('derives exact proposal and closing transitions', () => {
+    expect(deriveActions(deal('proposal'))).toEqual([
+      { key: 'move_to_closing', label: 'Move to Closing' },
+      { key: 'move_to_closed_lost', label: 'Close Lost' },
+      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
+    ])
+
+    expect(deriveActions(deal('closing'))).toEqual([
+      { key: 'move_to_closed_won', label: 'Close Won' },
+      { key: 'move_to_closed_lost', label: 'Close Lost' },
+      { key: 'move_to_nurturing', label: 'Move to Nurturing' }
+    ])
+  })
+
+  it.each(['closed_won', 'closed_lost', 'nurturing', 'legacy_stage', null] as const)(
+    'derives no actions for terminal or non-canonical stage %s',
+    (stageKey) => {
+      expect(deriveActions(deal(stageKey))).toEqual([])
+    }
+  )
+})
+
+describe('ActivityEventSchema', () => {
+  const timestamp = '2026-04-27T12:34:56.000Z'
+
+  // Platform events only (8 members). Domain events (reply_received, booking_nudge_sent, etc.)
+  // live in @repo/elevasis-operations as CrmDomainActivityEventSchema.
+  // See Open Decision #5 in crm-action-system.mdx for rationale.
+  it.each([
+    [{ type: 'stage_change', timestamp, stageBefore: 'interested', stageAfter: 'proposal', reason: 'qualified' }],
+    [{ type: 'state_change', timestamp, stateBefore: null, stateAfter: 'discovery_replied' }],
+    [{ type: 'action_taken', timestamp, actionKey: 'send_link', payload: { channel: 'email' } }],
+    [{ type: 'approval_created', timestamp, commandId: 'cmd_123', dealStageBefore: 'proposal' }],
+    [{ type: 'approval_resolved', timestamp, commandId: 'cmd_123', resolution: 'superseded' }],
+    [{ type: 'approval_stale', timestamp, commandId: 'cmd_123', dealStageAfter: 'closing' }],
+    [{ type: 'task_created', timestamp, taskId: 'task_123' }],
+    [{ type: 'deal_created', timestamp }]
+  ])('accepts expected %s events', (event) => {
+    expect(ActivityEventSchema.safeParse(event).success).toBe(true)
+  })
+
+  it.each([
+    [{ type: 'deal_created', timestamp: 'not-a-date' }],
+    [{ type: 'unknown_event', timestamp }],
+    [{ type: 'stage_change', timestamp, stageBefore: 'interested' }],
+    [{ type: 'approval_resolved', timestamp, commandId: 'cmd_123', resolution: 'approved' }],
+    [{ type: 'booking_nudge_sent', timestamp, followupDay: '2' }],
+    [{ type: 'action_taken', timestamp }]
+  ])('rejects malformed event payload %o', (event) => {
+    expect(ActivityEventSchema.safeParse(event).success).toBe(false)
+  })
+})
+
+describe('CRM stage and transition vocabulary contracts', () => {
+  // Phase 4 (D8): DEFAULT_ORGANIZATION_MODEL_SALES.pipelines removed.
+  // CRM_PIPELINE_DEFINITION (StatefulPipelineDefinition) is the retained Stateful-trait
+  // pipeline shape used by CRM business logic. stageKey → DealStageSchema alignment
+  // is now verified against CRM_PIPELINE_DEFINITION.stages[*].stageKey.
+  it('keeps DealStage, DealStageSchema, and CRM_PIPELINE_DEFINITION stages aligned', () => {
+    const crmStageKeys = CRM_PIPELINE_DEFINITION.stages.map((stage) => stage.stageKey)
+
+    expect(crmStageKeys).toEqual([...DEAL_STAGES])
+    expect(DealStageSchema.options).toEqual([...DEAL_STAGES])
+  })
+
+  it('accepts every canonical CRM deal stage in transition requests', () => {
+    for (const stageKey of DEAL_STAGES) {
+      expect(
+        TransitionItemRequestSchema.safeParse({
+          pipelineKey: CRM_PIPELINE_DEFINITION.pipelineKey,
+          stageKey,
+          stateKey: null,
+          expectedUpdatedAt: '2026-04-27T12:34:56.000Z'
+        }).success
+      ).toBe(true)
+    }
+  })
+
+  it('accepts canonical lead-gen stage/state pairs in transition requests', () => {
+    for (const pipelineDefinitions of Object.values(LEAD_GEN_PIPELINE_DEFINITIONS)) {
+      for (const pipeline of pipelineDefinitions) {
+        for (const stage of pipeline.stages) {
+          for (const state of stage.states) {
+            expect(
+              TransitionItemRequestSchema.safeParse({
+                pipelineKey: pipeline.pipelineKey,
+                stageKey: stage.stageKey,
+                stateKey: state.stateKey
+              }).success
+            ).toBe(true)
+          }
+        }
+      }
+    }
+  })
+})