laracrew 0.1.2 → 0.2.0

package/examples/README.md

@@ -76,4 +76,10 @@ here, it stops when the rest of the stack stops.
 mis-split on a path containing spaces the way a shell string can.
 
 **A gate with nothing to start is fine.** An `external: true` service is just a health check, so
-it can stand in as a named wait step — see `kafka-wait` in the microservices example.
+it can stand in as a named wait step — see `kafka-wait` in the microservices example. `laracrew
+doctor` probes those gates before boot, so declaring your Postgres and Redis this way is also how
+you get them checked.
+
+**The Laravel checks only apply to Laravel.** `doctor` works out which projects actually run PHP
+and which actually talk to Redis, from the commands they declare and the `.env` they read. A
+Django or Node stack gets the port and dependency checks and none of the PHP ones.

package/examples/django-celery/stack.yaml

@@ -61,6 +61,11 @@ services:
     env:
       PYTHONUNBUFFERED: "1"
     ready: { logMatch: "ready\\.$|celery@.* ready", timeoutMs: 30000 }
+    # The Celery equivalent of `artisan queue:restart`: ask the worker to finish the task it
+    # holds and exit by itself. Only if it is still there after 25s does laracrew signal it.
+    stop:
+      exec: [".venv/bin/celery", "-A", "bookstore", "control", "shutdown"]
+      graceMs: 25000
 
   - name: celery:beat
     project: app

package/examples/node-api-and-web/stack.yaml

@@ -64,8 +64,11 @@ services:
     cmd: ["npm", "run", "worker"] # BullMQ / Bee-Queue consumer
     groups: [backend, workers]
     needs: [redis, types:build]
-    # Give an in-flight job a moment to settle before the process is taken down.
-    stop: { graceMs: 10000 }
+    # Same deal as a Laravel queue worker: ask it to drain, give it 10s, then escalate.
+    # The script closes the BullMQ worker and exits once the current job is acked.
+    stop:
+      exec: ["npm", "run", "worker:drain"]
+      graceMs: 10000
 
   - name: web
     project: web

package/examples/polyglot-microservices/stack.yaml

@@ -44,8 +44,10 @@ services:
     groups: [infra]
     # Ready when every port we depend on is actually accepting connections.
     ready: { tcp: "127.0.0.1:5432", timeoutMs: 120000, intervalMs: 1000 }
-    # Compose needs time to stop its own containers cleanly.
-    stop: { graceMs: 30000 }
+    # Let Compose stop its own containers the way it wants to, before anything is killed.
+    stop:
+      exec: ["docker", "compose", "stop"]
+      graceMs: 30000
 
   - name: kafka-wait
     external: true # nothing to start; this row exists purely as a gate

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "laracrew",
-  "version": "0.1.2",
-  "description": "Boot and supervise all the long-running processes of your Laravel projects with one command.",
+  "version": "0.2.0",
+  "description": "Boot and supervise all the long-running processes of your projects with one command. Laravel-aware, works with anything.",
   "keywords": [
     "laravel",
     "cli",