Interface LaravelUi5\Sdk\Shell\CmdK\Contracts\CollectorInterface

Defines a database-backed CmdK collector.

Architectural Role

A Collector is responsible for domain-specific discovery.

It builds the maximum candidate set of searchable entities and materializes them into CmdK Action DTOs.

It MUST:

It MUST NOT:

Visibility is applied exclusively via paired VisibilityConstrainer implementations in the search pipeline.

query() → discovery (what could be shown) constrain → visibility filtering (external) collect() → materialization (what will be shown)

The Collector is intentionally split into query-building and materialization to guarantee that:

Security operates at query level.
- No O(n) authorization filtering happens in PHP.
- Results are only materialized once fully constrained.

CmdK Layer:

Security Layer:

Collectors MUST remain unaware of Security internals.

LaravelUi5\Sdk\Shell\CmdK\Contracts\CollectorInterface
- LaravelUi5\Sdk\Shell\Context\Ui5ContextContributor implements ContextContributorInterface, CollectorInterface
- LaravelUi5\Sdk\Shell\CmdK\Ui5ArtifactCollector implements CollectorInterface

Methods
`public`	`count(string $search, SdkContext $context): int` Counts based on the discovery query the number of entries for this collector. Counts based on the discovery query the number of entries for this collector. count() MUST be derived from query() and MUST NOT apply additional constraints. Implemented by `LaravelUi5\Sdk\Shell\Context\Ui5ContextContributor::count()` `LaravelUi5\Sdk\Shell\CmdK\Ui5ArtifactCollector::count()`	#
`public`	`query(string $search, SdkContext $context): Builder` Builds the base discovery query for this collector. Builds the base discovery query for this collector. The returned query represents the complete set of domain candidates before any visibility constraints are applied. Implemented by `LaravelUi5\Sdk\Shell\Context\Ui5ContextContributor::query()` `LaravelUi5\Sdk\Shell\CmdK\Ui5ArtifactCollector::query()`	#
`public`	`collect(Builder $query, SdkContext $context): Action[]` Materializes the constrained query result into CmdK Actions. Materializes the constrained query result into CmdK Actions. This method MUST assume that all visibility constraints have already been applied to the provided query. It MUST NOT: Apply authorization checks. Filter results in PHP for security reasons. Implemented by `LaravelUi5\Sdk\Shell\Context\Ui5ContextContributor::collect()` `LaravelUi5\Sdk\Shell\CmdK\Ui5ArtifactCollector::collect()`	#