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 CancelWorkflowContract = defineCommand({
15	meta: {
16		key: 'workflow.instance.cancel',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'cancel'],
21		description: 'Cancel a workflow instance.',
22		goal: 'Terminate workflow without completion.',
23		context: 'User request, system cancellation.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'CancelWorkflowInput',
28			fields: {
29				instanceId: {
30					type: ScalarTypeEnum.String_unsecure(),
31					isOptional: false,
32				},
33				reason: {
34					type: ScalarTypeEnum.String_unsecure(),
35					isOptional: false,
36				},
37			},
38		}),
39		output: WorkflowInstanceModel,
40	},
41	policy: { auth: 'user' },
42	sideEffects: {
43		emits: [
44			{
45				key: 'workflow.instance.cancelled',
46				version: '1.0.0',
47				when: 'Workflow is cancelled',
48				payload: WorkflowInstanceModel,
49			},
50		],
51		audit: ['workflow.instance.cancelled'],
52	},
53	acceptance: {
54		scenarios: [
55			{
56				key: 'cancel-workflow-happy-path',
57				given: ['Workflow is running'],
58				when: ['User cancels workflow'],
59				then: ['Instance status becomes CANCELLED'],
60			},
61		],
62		examples: [
63			{
64				key: 'cancel-mistake',
65				input: { instanceId: 'inst-456', reason: 'Created by mistake' },
66				output: { id: 'inst-456', status: 'cancelled' },
67			},
68		],
69	},
70});