1import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
2import { defineCommand } from '../../operations';
3import {
4	DOCS_DOMAIN,
5	DOCS_OWNERS,
6	DOCS_STABILITY,
7	DOCS_TAGS,
8} from '../constants';
9import { DocsPublishedEvent } from '../events/docsPublished.event';
10import { docId } from '../registry';
11import type { DocBlock } from '../types';
12
13export const DocsPublishCommand = defineCommand({
14	meta: {
15		key: 'docs.publish',
16		title: 'Publish Documentation',
17		version: '1.0.0',
18		description: 'Publish generated documentation artifacts.',
19		goal: 'Deploy docs to the public docs surface with consistent versioning.',
20		context:
21			'Used by release pipelines to push generated docs to hosting targets.',
22		domain: DOCS_DOMAIN,
23		owners: DOCS_OWNERS,
24		tags: [...DOCS_TAGS, 'publish'],
25		stability: DOCS_STABILITY,
26		docId: [docId('docs.tech.docs-publish')],
27	},
28	capability: {
29		key: 'docs.system',
30		version: '1.0.0',
31	},
32	io: {
33		input: DocsPublishInput,
34		output: DocsPublishOutput,
35		errors: {
36			DEPLOY_FAILED: {
37				description: 'Failed to deploy documentation artifacts.',
38				http: 500,
39				when: 'The docs publish step fails to deploy to the target host.',
40			},
41		},
42	},
43	policy: {
44		auth: 'admin',
45		pii: [],
46	},
47	sideEffects: {
48		emits: [
49			{
50				ref: DocsPublishedEvent.meta,
51				when: 'Docs publish completes successfully.',
52			},
53		],
54	},
55});