OpenParable
Skip to content
← Back to skills

Create Cqrs Bulk Commands

Development
create-cqrs-bulk-commands

Create Cqrs Bulk Commands is an Agent Skill for development published in the PrestaShop/PrestaShop repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create bulk action commands and their handlers. All bulk handlers extend AbstractBulkCommandHandler, catch errors per item, and report failures via BulkCommandExceptionInterface. Trigger: "create bulk commands for {Domain}".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/PrestaShop/PrestaShop/blob/HEAD/.ai/Component/CQRS/skills/create-cqrs-bulk-commands/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/create-cqrs-bulk-commands, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

create-cqrs-bulk-commands

See CQRS/CONTEXT.md for the bulk handler pattern (AbstractBulkCommandHandler, BulkCommandExceptionInterface, continue after failure).

1. Bulk delete command

Create src/Core/Domain/{Domain}/Command/BulkDelete{Domain}sCommand.php:

  • Constructor takes array $ids (scalar int[])
  • Single getter: getIds(): array

2. Bulk status command

Create src/Core/Domain/{Domain}/Command/BulkToggle{Domain}StatusCommand.php:

  • Constructor takes array $ids (int[]) and bool $expectedStatus
  • $expectedStatus = true means enable, false means disable
  • Getters: getIds(): array and getExpectedStatus(): bool

3. Bulk handlers

All bulk handlers follow the same structure. Create in src/Adapter/{Domain}/CommandHandler/:

Bulk delete handler

BulkDelete{Domain}sHandler.php:

  • For each ID, call the repository delete
  • Collect failures, continue with remaining IDs

Bulk status handler

BulkToggle{Domain}StatusHandler.php:

  • For each ID, load entity, set active = $command->getExpectedStatus(), update
  • Use the target status from the command — do not flip the current value

4. Handler interfaces

Create in src/Core/Domain/{Domain}/CommandHandler/:

  • BulkDelete{Domain}sHandlerInterface
  • BulkToggle{Domain}StatusHandlerInterface

Both return void. The bulk exception is thrown, not returned.

Rules

Conventions (AbstractBulkCommandHandler, continue after failure, BulkCommandExceptionInterface) are in CQRS/CONTEXT.md. Skill-specific reminders:

  • Be consistent with the single-entity commands on ID typing
  • Skip this skill entirely if the entity has no bulk grid actions