@ultimat3/cli 22.4.0 → 22.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/cli",
-  "version": "22.4.0",
+  "version": "22.5.0",
   "description": "The `x` binary: new, dev, build, verify, generate, db, mcp, doctor, deploy",
   "license": "MIT",
   "type": "module",
@@ -38,33 +38,33 @@
   },
   "dependencies": {
     "@babel/core": "^8.0.1",
-    "@ultimat3/action": "22.4.0",
-    "@ultimat3/admin": "22.4.0",
-    "@ultimat3/ai": "22.4.0",
-    "@ultimat3/auth": "22.4.0",
-    "@ultimat3/cache": "22.4.0",
-    "@ultimat3/core": "22.4.0",
-    "@ultimat3/db": "22.4.0",
-    "@ultimat3/entity": "22.4.0",
-    "@ultimat3/flags": "22.4.0",
-    "@ultimat3/http": "22.4.0",
-    "@ultimat3/i18n": "22.4.0",
-    "@ultimat3/jobs": "22.4.0",
-    "@ultimat3/mail": "22.4.0",
-    "@ultimat3/manifest": "22.4.0",
-    "@ultimat3/mcp": "22.4.0",
-    "@ultimat3/money": "22.4.0",
-    "@ultimat3/notify": "22.4.0",
-    "@ultimat3/policy": "22.4.0",
-    "@ultimat3/pwa": "22.4.0",
-    "@ultimat3/query": "22.4.0",
-    "@ultimat3/realtime": "22.4.0",
-    "@ultimat3/render": "22.4.0",
-    "@ultimat3/schema": "22.4.0",
-    "@ultimat3/seo": "22.4.0",
-    "@ultimat3/storage": "22.4.0",
-    "@ultimat3/testing": "22.4.0",
-    "@ultimat3/time": "22.4.0",
+    "@ultimat3/action": "22.5.0",
+    "@ultimat3/admin": "22.5.0",
+    "@ultimat3/ai": "22.5.0",
+    "@ultimat3/auth": "22.5.0",
+    "@ultimat3/cache": "22.5.0",
+    "@ultimat3/core": "22.5.0",
+    "@ultimat3/db": "22.5.0",
+    "@ultimat3/entity": "22.5.0",
+    "@ultimat3/flags": "22.5.0",
+    "@ultimat3/http": "22.5.0",
+    "@ultimat3/i18n": "22.5.0",
+    "@ultimat3/jobs": "22.5.0",
+    "@ultimat3/mail": "22.5.0",
+    "@ultimat3/manifest": "22.5.0",
+    "@ultimat3/mcp": "22.5.0",
+    "@ultimat3/money": "22.5.0",
+    "@ultimat3/notify": "22.5.0",
+    "@ultimat3/policy": "22.5.0",
+    "@ultimat3/pwa": "22.5.0",
+    "@ultimat3/query": "22.5.0",
+    "@ultimat3/realtime": "22.5.0",
+    "@ultimat3/render": "22.5.0",
+    "@ultimat3/schema": "22.5.0",
+    "@ultimat3/seo": "22.5.0",
+    "@ultimat3/storage": "22.5.0",
+    "@ultimat3/testing": "22.5.0",
+    "@ultimat3/time": "22.5.0",
     "babel-preset-solid": "^1.9.15"
   }
 }

package/src/serve-boot.ts

@@ -4,6 +4,7 @@
 // — are this file's.
 
 import type { Role } from '@ultimat3/core';
+import { configureLifecycle } from '@ultimat3/core';
 import type { Route } from '@ultimat3/http';
 import { describeRoutes } from '@ultimat3/render';
 import { createIsrController } from '@ultimat3/render/server';
@@ -26,7 +27,7 @@ import { replicaOverrides } from './runtime-replica';
 import type { RunningServices } from './runtime-services';
 import { servedStorage, storageRoutes } from './runtime-storage';
 import { seoRoutes } from './seo-routes';
-import { loadDrainConfig } from './serve-drain';
+import { loadDrainConfig, loadHealthConfig } from './serve-drain';
 import { configureReporting, containerBinding, metricsPortFor, portFromEnv } from './serve-env';
 import type { ServedApp, ServeOptions } from './serve-types';
 import { loadSiteSettings, publicOrigin } from './site-config';
@@ -77,6 +78,9 @@ export async function bootRoles(boot: {
   // still wins — that is the deploy talking.
   const metricsPort = metricsPortFor(options.env, port, options.metricsPort);
   const drain = await loadDrainConfig(options.root);
+  // Process-wide, so every role's `/readyz` — web, sync, worker — answers in the declared mode.
+  const health = await loadHealthConfig(options.root);
+  if (health?.readiness !== undefined) configureLifecycle({ readiness: health.readiness });
   const replicaOverride = replicaOverrides(options.runtime, runtime.services.db, options.env);
   const running = await startRoles({
     roles: [role],

package/src/serve-drain.ts

@@ -1,7 +1,8 @@
-// `app.config.ts`'s `drain` section, read for the production boot — the same import every other
-// config reader here makes (`theme-boot.ts`, `app-auth.ts`), because the config is a module.
+// `app.config.ts`'s `drain` and `health` sections, read for the production boot — the same import
+// every other config reader here makes (`theme-boot.ts`, `app-auth.ts`), because the config is a
+// module. Both shape what `/readyz` tells the load balancer.
 
-import type { DrainConfig } from '@ultimat3/core';
+import type { DrainConfig, HealthConfig } from '@ultimat3/core';
 import { APP_CONFIG_EXPORT } from './app-auth';
 import { APP_CONFIG_FILE } from './app-root';
 
@@ -22,3 +23,19 @@ export async function loadDrainConfig(root: string): Promise<Partial<DrainConfig
   if (!isRecord(drain) || !Object.hasOwn(drain, 'readinessGraceMs')) return undefined;
   return { readinessGraceMs: drain['readinessGraceMs'] as number };
 }
+
+/**
+ * `health.readiness`, or `undefined` when the app declares none (core keeps `'dependencies'`). The
+ * value is handed to `configureLifecycle` as written, so a bad one is refused by core's own rule.
+ */
+export async function loadHealthConfig(root: string): Promise<Partial<HealthConfig> | undefined> {
+  const path = `${root}/${APP_CONFIG_FILE}`;
+  if (!(await Bun.file(path).exists())) return undefined;
+  const module = (await import(path)) as Record<string, unknown>;
+  const config = module[APP_CONFIG_EXPORT];
+  const health = isRecord(config)
+    ? (config['health'] as Partial<HealthConfig> | undefined)
+    : undefined;
+  if (!isRecord(health) || health.readiness === undefined) return undefined;
+  return { readiness: health.readiness };
+}