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 GetInstanceContract = defineQuery({
15	meta: {
16		key: 'workflow.instance.get',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'get'],
21		description: 'Get a workflow instance with details.',
22		goal: 'View workflow instance details.',
23		context: 'Instance detail view.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'GetInstanceInput',
28			fields: {
29				instanceId: {
30					type: ScalarTypeEnum.String_unsecure(),
31					isOptional: false,
32				},
33			},
34		}),
35		output: WorkflowInstanceModel,
36	},
37	policy: { auth: 'user' },
38	acceptance: {
39		scenarios: [
40			{
41				key: 'get-instance-happy-path',
42				given: ['Instance exists'],
43				when: ['User requests instance details'],
44				then: ['Instance details are returned'],
45			},
46		],
47		examples: [
48			{
49				key: 'get-details',
50				input: { instanceId: 'inst-456' },
51				output: { id: 'inst-456', workflowKey: 'onboarding-v1' },
52			},
53		],
54	},
55});