1import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
2import { docRef } from '../../docs/registry';
3import type { DocBlock } from '../../docs/types';
4import { defineCommand } from '../../operations';
5import {
6	CONTEXT_DOMAIN,
7	CONTEXT_OWNERS,
8	CONTEXT_STABILITY,
9	CONTEXT_TAGS,
10} from '../constants';
11import { ContextSnapshotCreatedEvent } from '../events/contextSnapshotCreated.event';
12
13export const ContextPackSnapshotCommand = defineCommand({
14	meta: {
15		key: 'context.pack.snapshot',
16		title: 'Create Context Snapshot',
17		version: '1.0.0',
18		description: 'Create an immutable snapshot from a context pack.',
19		goal: 'Persist a versioned, auditable context snapshot for agents.',
20		context:
21			'Used when launching background agents or when operators want to lock context state.',
22		domain: CONTEXT_DOMAIN,
23		owners: CONTEXT_OWNERS,
24		tags: [...CONTEXT_TAGS, 'snapshot', 'create'],
25		stability: CONTEXT_STABILITY,
26		docId: [docRef(ContextPackSnapshotDocBlock.id)],
27	},
28	capability: {
29		key: 'context.system',
30		version: '1.0.0',
31	},
32	io: {
33		input: ContextPackSnapshotInput,
34		output: ContextPackSnapshotOutput,
35	},
36	policy: {
37		auth: 'admin',
38		pii: [],
39	},
40	sideEffects: {
41		emits: [
42			{
43				ref: ContextSnapshotCreatedEvent.meta,
44				when: 'A new snapshot has been created and persisted.',
45			},
46		],
47	},
48});