1export const DocsGenerateCommand = defineCommand({
2  meta: {
3    key: 'docs.generate',
4    title: 'Generate Documentation',
5    version: '1.0.0',
6    description: 'Generate documentation artifacts from ContractSpecs.',
7    goal: 'Produce up-to-date reference docs and guides from specs and DocBlocks.',
8    context:
9      'Used by CLI and CI to keep docs in sync with contract definitions.',
10    domain: DOCS_DOMAIN,
11    owners: DOCS_OWNERS,
12    tags: [...DOCS_TAGS, 'generation'],
13    stability: DOCS_STABILITY,
14    docId: [docId('docs.tech.docs-generator')],
15  },
16  capability: {
17    key: 'docs.system',
18    version: '1.0.0',
19  },
20  io: {
21    input: DocsGenerateInput,
22    output: DocsGenerateOutput,
23    errors: {
24      OUTPUT_WRITE_FAILED: {
25        description: 'Failed to write generated docs output.',
26        http: 500,
27        when: 'The generator cannot persist artifacts to the output path.',
28      },
29    },
30  },
31  policy: {
32    auth: 'admin',
33    pii: [],
34  },
35  sideEffects: {
36    emits: [
37      {
38        ref: DocsGeneratedEvent.meta,
39        when: 'Docs generation completes successfully.',
40      },
41    ],
42  },
43});