1import { defineCapability } from '../../capabilities';
2import { docRef } from '../../docs/registry';
3import type { DocBlock } from '../../docs/types';
4import {
5	DATABASE_DOMAIN,
6	DATABASE_OWNERS,
7	DATABASE_STABILITY,
8	DATABASE_TAGS,
9} from '../constants';
10
11export const DatabaseContextCapability = defineCapability({
12	meta: {
13		key: 'database.context',
14		version: '1.0.0',
15		kind: 'data',
16		title: 'Database Context',
17		description: 'Schema, migration, dictionary, and read-only query surfaces.',
18		domain: DATABASE_DOMAIN,
19		owners: DATABASE_OWNERS,
20		tags: [...DATABASE_TAGS, 'context'],
21		stability: DATABASE_STABILITY,
22		docId: [docRef(DatabaseContextDocBlock.id)],
23	},
24	provides: [
25		{
26			surface: 'operation',
27			key: 'database.schema.describe',
28			version: '1.0.0',
29			description: 'Describe schemas and models.',
30		},
31		{
32			surface: 'operation',
33			key: 'database.migrations.list',
34			version: '1.0.0',
35			description: 'List database migrations.',
36		},
37		{
38			surface: 'operation',
39			key: 'database.dictionary.get',
40			version: '1.0.0',
41			description: 'Get data dictionary entry.',
42		},
43		{
44			surface: 'operation',
45			key: 'database.query.readonly',
46			version: '1.0.0',
47			description: 'Perform read-only data query via data views.',
48		},
49	],
50});