1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { InstanceStatusEnum } from './instance.enum';
7import {
8	StartWorkflowInputModel,
9	TransitionInputModel,
10	TransitionResultModel,
11	WorkflowInstanceModel,
12} from './instance.schema';
13
14export const TransitionWorkflowContract = defineCommand({
15	meta: {
16		key: 'workflow.instance.transition',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'transition', 'state-machine'],
21		description: 'Transition a workflow instance to the next step.',
22		goal: 'Move workflow forward based on action.',
23		context: 'Task completion, approval decisions.',
24	},
25	io: {
26		input: TransitionInputModel,
27		output: TransitionResultModel,
28	},
29	policy: { auth: 'user' },
30	sideEffects: {
31		emits: [
32			{
33				key: 'workflow.step.exited',
34				version: '1.0.0',
35				when: 'Step is exited',
36				payload: WorkflowInstanceModel,
37			},
38			{
39				key: 'workflow.step.entered',
40				version: '1.0.0',
41				when: 'New step is entered',
42				payload: WorkflowInstanceModel,
43			},
44			{
45				key: 'workflow.instance.completed',
46				version: '1.0.0',
47				when: 'Workflow reaches end',
48				payload: WorkflowInstanceModel,
49			},
50		],
51		audit: ['workflow.instance.transitioned'],
52	},
53	acceptance: {
54		scenarios: [
55			{
56				key: 'transition-workflow-happy-path',
57				given: ['Workflow instance is waiting at step'],
58				when: ['User provides input'],
59				then: ['Instance moves to next step'],
60			},
61		],
62		examples: [
63			{
64				key: 'complete-task',
65				input: {
66					instanceId: 'inst-456',
67					action: 'complete',
68					data: { approved: true },
69				},
70				output: { success: true, nextStep: 'notify-hr' },
71			},
72		],
73	},
74});