laracrew 0.1.1 → 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,55 +1,63 @@
-{
-  "name": "laracrew",
-  "version": "0.1.1",
-  "description": "Boot and supervise all the long-running processes of your Laravel projects with one command.",
-  "keywords": [
-    "laravel",
-    "cli",
-    "tui",
-    "queue",
-    "horizon",
-    "redis",
-    "process-manager",
-    "dev-tools"
-  ],
-  "license": "MIT",
-  "type": "module",
-  "engines": {
-    "node": ">=20"
-  },
-  "bin": {
-    "laracrew": "./dist/index.js"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "examples",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "commander": "^12.1.0",
-    "yaml": "^2.5.1",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^22.7.4",
-    "tsup": "^8.3.0",
-    "tsx": "^4.19.1",
-    "typescript": "^5.6.2",
-    "vitest": "^2.1.1"
-  },
-  "author": "viduranga <https://github.com/vidux>"
-}
+{
+  "name": "laracrew",
+  "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",
+    "tui",
+    "queue",
+    "horizon",
+    "redis",
+    "process-manager",
+    "dev-tools"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vidux/laracrew.git"
+  },
+  "homepage": "https://github.com/vidux/laracrew#readme",
+  "bugs": {
+    "url": "https://github.com/vidux/laracrew/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "laracrew": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "yaml": "^2.5.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.4",
+    "tsup": "^8.3.0",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.1"
+  },
+  "author": "viduranga <https://github.com/vidux>"
+}