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