@getstrata/cli 2.2.20 → 2.2.21

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @getstrata/cli changelog
 
+## 2.2.21
+
+Make registered queue/outbox workers discoverable in CLI help and generated startup guidance. Announce polling after boot and when it stops without claiming dependency health, printing secrets, or starting workers automatically. Preserve explicit process ownership, delivery semantics and graceful lifecycle; cover idle, boot/runtime/cleanup failures and real SIGTERM draining.
+
 ## 2.2.20
 
 Validate complete migration definitions before callbacks, locks or database effects; reject malformed exports and duplicate names with source diagnostics. Refuse fresh with missing applied definitions and rollback with incomplete latest batches; preserve partial forward migration and remove blanket history deletion. Cover physical schema/data/history preservation and reset recovery on real Postgres, MySQL and SQLite, plus loader and preflight regressions; document safe missing-file recovery and unchanged atomicity limits.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/cli",
-  "version": "2.2.20",
+  "version": "2.2.21",
   "description": "Strata CLI: framework commands for Bun apps (dev, start, migrate, run)",
   "type": "module",
   "license": "MIT",
@@ -54,8 +54,8 @@
   ],
   "scripts": {},
   "peerDependencies": {
-    "@getstrata/bootstrap": "^2.2.20",
-    "@getstrata/core": "^2.2.20"
+    "@getstrata/bootstrap": "^2.2.21",
+    "@getstrata/core": "^2.2.21"
   },
   "publishConfig": {
     "access": "public"

package/src/commands/help.ts

@@ -1,7 +1,22 @@
 function printHelp(commandNames: string[]): void {
   const unique = [...new Set(commandNames)].sort();
-  const list = unique.map((name) => `- ${name}`).join("\n");
-  console.log(`Available commands:\n${list}`);
+  const descriptions: Record<string, string> = {
+    dev: "HTTP development server; workers run separately",
+    start: "HTTP server; workers run separately",
+    "queue:work": "Poll Redis for queued jobs; requires REDIS_URL",
+    "outbox:work":
+      "Poll SQL for durable listener deliveries; requires migrations and registered listeners",
+  };
+  const list = unique
+    .map(
+      (name) => `- ${name}${Object.hasOwn(descriptions, name) ? ` — ${descriptions[name]}` : ""}`,
+    )
+    .join("\n");
+  const workers = unique.filter((name) => name === "queue:work" || name === "outbox:work");
+  const guidance = workers.length
+    ? `\n\nBackground workers are explicit. Run ${workers.map((name) => `strata ${name}`).join(" and ")} in separate terminals when your app uses those mechanisms. Use the same application configuration as HTTP. dev/start do not start workers. Idle polling is normal; startup output is not a dependency health check.`
+    : "";
+  console.log(`Available commands:\n${list}${guidance}`);
 }
 
 export { printHelp };

package/src/outboxWorker.ts

@@ -43,6 +43,7 @@ async function runOutboxWorkerCommand(options: OutboxWorkerOptions): Promise<voi
     async () => {
       await booting?.catch(() => {});
       await running?.catch(() => {});
+      if (running) console.log("[outbox:work] Polling stopped.");
       await options.drain?.();
     },
     "drain",
@@ -69,6 +70,9 @@ async function runOutboxWorkerCommand(options: OutboxWorkerOptions): Promise<voi
     await booting;
     if (!stopping && !lifecycle.isShuttingDown) {
       const outbox = options.outbox ?? new SqlOutbox({ listeners: options.listeners ?? [] });
+      console.log(
+        "[outbox:work] Starting SQL outbox polling; idle until deliveries are available.",
+      );
       running = outbox.work({ signal: admission.signal });
       await running;
     }

package/src/queueWorker.ts

@@ -38,6 +38,7 @@ async function runQueueWorkerCommand(options: {
       // Completion, including failed startup/run, means no admitted worker remains.
       await booting?.catch(() => {});
       await running?.catch(() => {});
+      if (running) console.log("[queue:work] Polling stopped.");
       await options.drain?.();
     },
     "drain",
@@ -78,10 +79,9 @@ async function runQueueWorkerCommand(options: {
     await booting;
     if (!stopping && !lifecycle.isShuttingDown) {
       worker = createQueueWorker(redisUrl, options.failedJobs ?? createFailedJobService());
-      console.log("[queue:work] Listening for jobs on Redis...");
+      console.log("[queue:work] Starting Redis queue polling; idle until jobs are available.");
       running = worker.run();
       await running;
-      console.log("[queue:work] Worker stopped.");
     }
   } catch (error) {
     failed = true;