Boost Pipeline Laravel Package

Product Decisions This Supports

• Feature/roadmap: Evaluate adding concurrency-limited pipeline steps via Shell::exclusive('name', $capacity) for resource-constrained operations; use Shell::onAbort('<cmd>') for cleanup after timeouts/stops to improve reliability.
• Build vs buy: If you are building internal pipeline orchestration in Laravel, this package can replace custom process management with built-in history, observability, safety checks, and process-tree termination.
• Use cases: Batch processing with limited parallelism, deployment/script pipelines that need cleanup on failure, long-running jobs with timeouts, and UIs that display step waiting states (waiting_for_slot) and durations.
• Prioritization: New duration_ms and slot_wait_ms metrics enable performance monitoring; abandoned run status helps identify orphaned work; open_run refusing after vendor/composer/installed.php changes prevents stale-environment runs.
• Risk management: v0.22.0 tightens process cleanup (timeout/stop now ends every process the step started, not just the shell) and adds a breaking requirement that exclusive() must be used with withResponseWindow().

When to Consider This Package

• Consider it if: You need Laravel-native pipeline orchestration for shell steps with concurrency limits, abort cleanup, run history, and process-tree termination on timeout — without introducing external orchestrators.
• Consider it if: You want observability into step durations, slot wait times, and abandoned runs, and you value safety checks around composer dependency changes.
• Look elsewhere if: You need distributed, multi-node orchestration (e.g., Kubernetes, Airflow), or if you cannot accommodate the v0.22.0 breaking change (exclusive() requires withResponseWindow()) or behavior changes (timeout/stop kills all step-spawned processes; open_run refuses after vendor/composer/installed.php changes).
• Upgrade note: Plan for the breaking change and behavior changes before adopting v0.22.0 in existing pipelines.

How to Pitch It (Stakeholders)

• Executives: This package improves reliability and observability of background pipelines with less custom code. v0.22.0 adds cleanup on abort, concurrency limits, run-history insights (duration, wait time, abandoned runs), and stronger process cleanup — reducing operational risk and engineering overhead.
• Engineering: v0.22.0 adds Shell::onAbort(), Shell::exclusive() with capacity, waiting_for_slot reporting, duration_ms/slot_wait_ms metrics, abandoned run status, full process-tree termination on timeout/stop, and a safety check refusing open_run after composer changes. Be aware: exclusive() now requires withResponseWindow() (breaking), and timeout/stop behavior is broader. Good fit for Laravel apps needing robust pipeline orchestration without external systems.