Command Launcher Bundle Laravel Package

Product Decisions This Supports

• Decoupling CLI and HTTP workflows: Enables executing business logic (e.g., user activation, batch processing) via CLI without duplicating controller logic, reducing technical debt.
• Asynchronous workflows: Supports "fire-and-forget" use cases (e.g., triggering long-running tasks like report generation) where HTTP responses must return immediately.
• Internal tooling: Builds self-service CLI tools for non-technical teams (e.g., "Run this command to reprocess failed orders").
• Roadmap: Justifies investment in Symfony Messenger if not already adopted, or extends existing Messenger-based systems.
• Build vs. buy: Avoids reinventing CLI-to-Messenger integration; lightweight alternative to custom solutions.
• Use cases:
  • Admin operations: Bulk actions (e.g., "Deactivate all inactive users").
  • Data migration: Triggering complex message chains via CLI.
  • Testing: Replaying message queues programmatically.

When to Consider This Package

• Adopt if:
  • Your app uses Symfony Messenger (or a similar bus/handler pattern).
  • You need to execute business logic via CLI without duplicating HTTP routes.
  • Your team prioritizes DRY (Don’t Repeat Yourself) principles for workflows.
  • You’re building internal tools or admin interfaces for power users.
• Look elsewhere if:
  • Your app doesn’t use a message bus (e.g., pure procedural code).
  • You need real-time CLI feedback (this is for async dispatch, not interactive commands).
  • Your use case requires complex argument parsing (consider Symfony Console components instead).
  • You’re constrained by low-code/no-code tools that don’t support CLI integration.

How to Pitch It (Stakeholders)

For Executives: "This package lets us trigger backend business logic (e.g., user activations, data processing) via CLI commands—without writing duplicate HTTP endpoints. It’s ideal for internal tools, batch operations, or testing, and integrates seamlessly with our existing Symfony Messenger setup. Low risk (MIT-licensed, minimal overhead), high reward for reducing manual work and technical debt."

For Engineering: *"If we’re already using Messenger, this bundle lets us dispatch messages from CLI with zero boilerplate. Perfect for:

• Admin scripts: Run php bin/console app:activate-users --batch=1000.
• CI/CD: Kick off async tasks post-deploy (e.g., app:generate-reports).
• Debugging: Replay messages without hitting endpoints. No custom code needed—just configure routes and commands. Tradeoff: Async-only (no real-time feedback), but that’s by design."*