1import { defineCommand, defineQuery } from '@lssm-tech/lib.contracts-spec';
2import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
3import {
4	KBSnapshotModel,
5	RuleVersionModel,
6	SourceDocumentModel,
7	SourceRefModel,
8} from '../entities/models';
9
10export const KbUpsertRuleVersionContract = defineCommand({
11	meta: {
12		key: 'kb.upsertRuleVersion',
13		title: 'Upsert Rule Version',
14		version: '1.0.0',
15		stability: 'experimental',
16		owners: ['@examples'],
17		tags: ['knowledge', 'rules', 'versioning'],
18		description: 'Create a new draft rule version with source references.',
19		goal: 'Propose curated knowledge updates with traceability.',
20		context: 'Automation or curators propose draft rule versions.',
21	},
22	io: {
23		input: UpsertRuleVersionInput,
24		output: RuleVersionModel,
25		errors: {
26			SOURCE_REFS_REQUIRED: {
27				description: 'Rule version must cite at least one sourceRef',
28				http: 400,
29				gqlCode: 'SOURCE_REFS_REQUIRED',
30				when: 'sourceRefs is empty',
31			},
32			RULE_NOT_FOUND: {
33				description: 'Rule does not exist',
34				http: 404,
35				gqlCode: 'RULE_NOT_FOUND',
36				when: 'ruleId is unknown',
37			},
38		},
39	},
40	policy: { auth: 'user' },
41});