capability

type Conflict struct {
	ID    ID
	Group string
}

type Descriptor struct {
	ID   ID
	Kind Kind
	// Group is the command-factory group; empty means the ID is the group.
	Group string
	// CLIName is the top-level command name; empty means not CLI-facing.
	CLIName string
	// Summary is the word shown in the CLI command summary line.
	Summary string
	// UsageLine is the pre-aligned row shown in the scanner usage block.
	UsageLine string
	// Usage renders the command's full help lazily, so registering a
	// capability never costs the work of building its usage text.
	Usage func() string
	// Skills lists skill names this capability unlocks.
	Skills []string
	// Optional marks a group selectable through --tools.
	Optional bool
	// Default enables an Optional group when --tools is empty.
	Default bool
	// Requires names the dependencies the factory needs, for the skip log.
	Requires []string
}

type ID string

type Kind uint8

type Options struct {
	// Groups limits the plan to these assembly groups. Nil means every linked
	// group. Entry points use this to describe their runtime surface without
	// keeping private factory lists.
	Groups []string
	// OptionalTools is --tools / config tools. Empty selects the defaults.
	OptionalTools []string
	// Extra force-enables capabilities that become available at runtime, such
	// as ioa once a client has connected.
	Extra []ID
}

type Plan struct {
	// contains filtered or unexported fields
}