1import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
2import { docId } from '../../docs/registry';
3import type { DocBlock } from '../../docs/types';
4import { defineCommand } from '../../operations';
5import {
6	PROVIDER_RANKING_DOMAIN,
7	PROVIDER_RANKING_OWNERS,
8	PROVIDER_RANKING_STABILITY,
9	PROVIDER_RANKING_TAGS,
10} from '../constants';
11import { RankingUpdatedEvent } from '../events/rankingUpdated.event';
12
13export const RankingRefreshCommand = defineCommand({
14	meta: {
15		key: 'provider-ranking.ranking.refresh',
16		title: 'Refresh Rankings',
17		version: '1.0.0',
18		description: 'Recompute composite rankings from latest benchmark data.',
19		goal: 'Keep the leaderboard current after new benchmark data arrives.',
20		context:
21			'Triggered after ingestion or on a schedule to update model rankings.',
22		domain: PROVIDER_RANKING_DOMAIN,
23		owners: PROVIDER_RANKING_OWNERS,
24		tags: [...PROVIDER_RANKING_TAGS, 'refresh'],
25		stability: PROVIDER_RANKING_STABILITY,
26		docId: [docId('docs.tech.provider-ranking.ranking.refresh')],
27	},
28	capability: {
29		key: 'provider-ranking.system',
30		version: '1.0.0',
31	},
32	io: {
33		input: RankingRefreshInput,
34		output: RankingRefreshOutput,
35	},
36	policy: {
37		auth: 'user',
38		pii: [],
39	},
40	sideEffects: {
41		emits: [
42			{
43				ref: RankingUpdatedEvent.meta,
44				when: 'Composite rankings are successfully recomputed.',
45			},
46		],
47	},
48});