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 StartWorkflowContract = defineCommand({
15	meta: {
16		key: 'workflow.instance.start',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'start'],
21		description: 'Start a new workflow instance.',
22		goal: 'Initiate a workflow for a business process.',
23		context: 'Order creation, request submission, etc.',
24	},
25	io: {
26		input: StartWorkflowInputModel,
27		output: WorkflowInstanceModel,
28	},
29	policy: { auth: 'user' },
30	sideEffects: {
31		emits: [
32			{
33				key: 'workflow.instance.started',
34				version: '1.0.0',
35				when: 'Workflow starts',
36				payload: WorkflowInstanceModel,
37			},
38			{
39				key: 'workflow.step.entered',
40				version: '1.0.0',
41				when: 'First step entered',
42				payload: WorkflowInstanceModel,
43			},
44		],
45		audit: ['workflow.instance.started'],
46	},
47	acceptance: {
48		scenarios: [
49			{
50				key: 'start-workflow-happy-path',
51				given: ['Workflow definition exists'],
52				when: ['User starts workflow'],
53				then: ['Instance is created and started'],
54			},
55		],
56		examples: [
57			{
58				key: 'start-onboarding',
59				input: {
60					workflowKey: 'onboarding-v1',
61					context: { employeeId: 'emp-123' },
62				},
63				output: { id: 'inst-456', status: 'running' },
64			},
65		],
66	},
67});