// Schema lifecycle: experimental | stable | deprecated
@status("experimental")
package gemara

@go(gemara)

// CapabilityCatalog describes a collection of system capabilities
#CapabilityCatalog: {
	#Catalog
	metadata: type: "CapabilityCatalog"

	// capabilities is a list of capabilities defined by this catalog
	capabilities?: [#Capability, ...#Capability] @go(Capabilities)

	if capabilities != _|_ {
		_uniqueCapabilityIds: {for i, c in capabilities {(c.id): i}}
		groups: [#Group, ...#Group]
	}
}

// Capability describes a system capability such as a feature, component or object.
#Capability: {
	// id allows this entry to be referenced by other elements
	id: string

	// title describes this capability at a glance
	title: string

	// description provides a detailed overview of this capability
	description: string

	// group references by id a catalog group that this capability belongs to
	group: string @go(Group)
}