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 PauseWorkflowContract = defineCommand({
15	meta: {
16		key: 'workflow.instance.pause',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'pause'],
21		description: 'Pause a running workflow instance.',
22		goal: 'Temporarily halt workflow execution.',
23		context: 'Administrative action, emergency stop.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'PauseResumeInput',
28			fields: {
29				instanceId: {
30					type: ScalarTypeEnum.String_unsecure(),
31					isOptional: false,
32				},
33				reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
34			},
35		}),
36		output: WorkflowInstanceModel,
37	},
38	policy: { auth: 'user' },
39	sideEffects: {
40		emits: [
41			{
42				key: 'workflow.instance.paused',
43				version: '1.0.0',
44				when: 'Workflow is paused',
45				payload: WorkflowInstanceModel,
46			},
47		],
48		audit: ['workflow.instance.paused'],
49	},
50	acceptance: {
51		scenarios: [
52			{
53				key: 'pause-workflow-happy-path',
54				given: ['Workflow is running'],
55				when: ['Admin pauses workflow'],
56				then: ['Instance status becomes PAUSED'],
57			},
58		],
59		examples: [
60			{
61				key: 'pause-maintenance',
62				input: { instanceId: 'inst-456', reason: 'System maintenance' },
63				output: { id: 'inst-456', status: 'paused' },
64			},
65		],
66	},
67});