@zintrust/workers 0.4.27 → 0.4.36

package/dist/ClusterLock.js

@@ -131,7 +131,7 @@ export const ClusterLock = Object.freeze({
             Logger.warn('ClusterLock already initialized');
             return;
         }
-        const client = createRedisConnection(config);
+        const client = createRedisConnection(config, 3, { subsystem: 'worker-cluster-lock' });
         redisClient = client;
         startHeartbeat(client);
         Logger.info('ClusterLock initialized', { instanceId: getInstanceId() });

package/dist/ComplianceManager.js

@@ -191,7 +191,7 @@ export const ComplianceManager = Object.freeze({
             Logger.warn('ComplianceManager already initialized');
             return;
         }
-        redisClient = createRedisConnection(redisConfig);
+        redisClient = createRedisConnection(redisConfig, 3, { subsystem: 'worker-compliance' });
         complianceConfig = {
             gdpr: { ...DEFAULT_CONFIG.gdpr, ...config?.gdpr },
             hipaa: { ...DEFAULT_CONFIG.hipaa, ...config?.hipaa },

package/dist/DeadLetterQueue.js

@@ -161,7 +161,7 @@ export const DeadLetterQueue = Object.freeze({
             Logger.warn('DeadLetterQueue already initialized');
             return;
         }
-        redisClient = createRedisConnection(config);
+        redisClient = createRedisConnection(config, 3, { subsystem: 'worker-dlq' });
         retentionPolicy = policy;
         // Start cleanup interval if auto-delete is enabled
         if (policy.enabled && policy.autoDeleteAfterDays !== undefined) {

package/dist/WorkerFactory.js

@@ -100,7 +100,6 @@ const resolvePackageSpecifierUrl = (specifier) => {
         return resolveLocalPackageFallback(specifier);
     }
 };
-const escapeRegExp = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
 const rewriteProcessorImports = (code) => {
     const replacements = [];
     const coreUrl = resolvePackageSpecifierUrl('@zintrust/core');
@@ -113,8 +112,8 @@ const rewriteProcessorImports = (code) => {
         return code;
     let updated = code;
     for (const { from, to } of replacements) {
-        const pattern = new RegExp(String.raw `(['"])${escapeRegExp(from)}\1`, 'g');
-        updated = updated.replace(pattern, `$1${to}$1`);
+        updated = updated.replaceAll(`'${from}'`, `'${to}'`);
+        updated = updated.replaceAll(`"${from}"`, `"${to}"`);
     }
     return updated;
 };
@@ -330,14 +329,43 @@ const parseCacheControl = (value) => {
 };
 const getProcessorSpecConfig = () => workersConfig.processorSpec;
 const toPosixPath = (value) => value.split(path.sep).join('/');
+const isUpperAlpha = (value) => /^[A-Z]$/.test(value);
+const isLowerAlphaOrDigit = (value) => /^[a-z\d]$/.test(value);
+const isAlphaNumeric = (value) => /^[A-Za-z\d]$/.test(value);
+const shouldInsertWorkerNameDash = (previous, current, next) => {
+    if (!isAlphaNumeric(previous) || !isAlphaNumeric(current))
+        return false;
+    if (isLowerAlphaOrDigit(previous) && isUpperAlpha(current)) {
+        return true;
+    }
+    if (isUpperAlpha(previous) && isUpperAlpha(current) && isLowerAlphaOrDigit(next ?? '')) {
+        return true;
+    }
+    return false;
+};
+const toKebabWorkerName = (value) => {
+    if (!isNonEmptyString(value))
+        return value;
+    let normalized = '';
+    for (let index = 0; index < value.length; index += 1) {
+        const current = value[index] ?? '';
+        const previous = index > 0 ? (value[index - 1] ?? '') : '';
+        const next = value[index + 1];
+        if (current === ' ' || current === '_') {
+            if (!normalized.endsWith('-'))
+                normalized += '-';
+            continue;
+        }
+        if (shouldInsertWorkerNameDash(previous, current, next) && !normalized.endsWith('-')) {
+            normalized += '-';
+        }
+        normalized += current;
+    }
+    return normalized.replaceAll(/-+/g, '-');
+};
 const normalizeWorkerFileName = (fileName) => {
-    const baseName = fileName.replaceAll(/\.[^.]+$/, '');
-    return baseName
-        .replaceAll(/([a-z\d])([A-Z])/g, '$1-$2')
-        .replaceAll(/([A-Z]+)([A-Z][a-z\d]+)/g, '$1-$2')
-        .replaceAll(/[\s_]+/g, '-')
-        .replaceAll(/-+/g, '-')
-        .toLowerCase();
+    const baseName = fileName.replace(/\.[^.]+$/, '');
+    return toKebabWorkerName(baseName).toLowerCase();
 };
 const supportsWorkerFileDiscovery = () => {
     return (isNodeRuntime() &&
@@ -1364,19 +1392,15 @@ const resolveRedisConfigFromEnv = (config, context) => {
 };
 const resolveRedisConfigFromDirect = (config, context) => {
     const fallbackDb = Env.getInt('REDIS_QUEUE_DB', ZintrustLang.REDIS_DEFAULT_DB);
-    const redisConfigWithDatabase = config;
     let normalizedDb = fallbackDb;
     if (typeof config.db === 'number') {
         normalizedDb = config.db;
     }
-    else if (typeof redisConfigWithDatabase.database === 'number') {
-        normalizedDb = redisConfigWithDatabase.database;
-    }
     return {
         host: requireRedisHost(config.host, context),
         port: config.port,
         db: normalizedDb,
-        password: config.password ?? Env.get('REDIS_PASSWORD', undefined),
+        password: config.password ?? Env.get('REDIS_PASSWORD'),
     };
 };
 const resolveRedisConfig = (config, context) => isRedisEnvConfig(config)
@@ -1498,7 +1522,7 @@ const resolveWorkerStore = async (config) => {
         const redisConfig = resolveRedisConfigWithFallback(persistence.redis, config.infrastructure?.redis, 'Worker persistence requires redis config (persistence.redis or infrastructure.redis)', 'infrastructure.persistence.redis');
         const key_prefix = persistence.keyPrefix ?? keyPrefix();
         logRedisPersistenceConfig(redisConfig, key_prefix, 'resolveWorkerStore');
-        const client = createRedisConnection(redisConfig);
+        const client = createRedisConnection(redisConfig, 3, { subsystem: 'worker-persistence' });
         next = RedisWorkerStore.create(client, key_prefix);
     }
     else if (persistence.driver === 'database') {
@@ -1542,7 +1566,7 @@ const createWorkerStore = async (persistence) => {
         const redisConfig = resolveRedisConfigWithFallback(persistence.redis ?? { env: true }, undefined, 'Worker persistence requires redis config (persistence.redis or REDIS_* env values)', 'persistence.redis');
         const key_prefix = persistence.keyPrefix ?? keyPrefix();
         logRedisPersistenceConfig(redisConfig, key_prefix, 'createWorkerStore');
-        const client = createRedisConnection(redisConfig);
+        const client = createRedisConnection(redisConfig, 3, { subsystem: 'worker-persistence' });
         return RedisWorkerStore.create(client, key_prefix);
     }
     // Database driver

package/dist/WorkerMetrics.js

@@ -31,7 +31,7 @@ const getValidClient = async () => {
     }
     // If no client, create one
     if (!redisClient) {
-        redisClient = createRedisConnection(cachedConfig);
+        redisClient = createRedisConnection(cachedConfig, 3, { subsystem: 'worker-metrics' });
     }
     const client = redisClient;
     if (!client) {
@@ -220,7 +220,7 @@ const WorkerMetrics = Object.freeze({
             return;
         }
         cachedConfig = config;
-        redisClient = createRedisConnection(config);
+        redisClient = createRedisConnection(config, 3, { subsystem: 'worker-metrics' });
         Logger.info('WorkerMetrics initialized');
     },
     /**

package/dist/build-manifest.json

@@ -1,15 +1,15 @@
 {
   "name": "@zintrust/workers",
-  "version": "0.1.52",
-  "buildDate": "2026-03-26T09:12:29.177Z",
+  "version": "0.4.36",
+  "buildDate": "2026-03-30T17:20:12.328Z",
   "buildEnvironment": {
-    "node": "v25.6.1",
+    "node": "v22.22.1",
     "platform": "darwin",
     "arch": "arm64"
   },
   "git": {
-    "commit": "597f453f",
-    "branch": "dev"
+    "commit": "a45b4628",
+    "branch": "release"
   },
   "package": {
     "engines": {
@@ -19,7 +19,6 @@
       "@opentelemetry/api",
       "hot-shots",
       "ioredis",
-      "ml.js",
       "prom-client",
       "simple-statistics"
     ],
@@ -47,8 +46,8 @@
       "sha256": "1a6d9ea39ba9e17fc16eb52294c10c3912024cb3009a8f9c07ffa576e754c7f4"
     },
     "BroadcastWorker.d.ts": {
-      "size": 793,
-      "sha256": "63d5877e1363fd8f43cd0b0f63efca27a46e46fc2203cc073bd4110bb8e673b9"
+      "size": 934,
+      "sha256": "ea5b05820fdd30d80f4483f476e400c78fa842ebbb29a442b2f1261dc0b2de8a"
     },
     "BroadcastWorker.js": {
       "size": 821,
@@ -83,16 +82,16 @@
       "sha256": "77439b1e80a344ff2de380082886addda0e8ca0419e57e7039e9f6ad4c596462"
     },
     "ClusterLock.js": {
-      "size": 13447,
-      "sha256": "bd7da9158c7badf096057cf44d45d244a4a2fd5e2e34c7a858642ccf943645f2"
+      "size": 13488,
+      "sha256": "d216923cb5829a14155f2acfd7691075e9ee1d262fd25711afe877a7920642ca"
     },
     "ComplianceManager.d.ts": {
       "size": 5142,
       "sha256": "19a2695093bc102680cd8f28775d2b2b5efea5ad52b682c89fedbf4424b4b711"
     },
     "ComplianceManager.js": {
-      "size": 19614,
-      "sha256": "e29a36bbf663f30da08a59200b0fbb760e67f908faa95ed56e21aac2868f1b0f"
+      "size": 19653,
+      "sha256": "79fd228c4bae3d13fa64a75809fb112c65624560558fa57d6b7544a5ad1cf4f5"
     },
     "DatacenterOrchestrator.d.ts": {
       "size": 3532,
@@ -107,8 +106,8 @@
       "sha256": "dd82e7e2c23a2fcaefc0cb87a1a7931594d6a5f76b758f608c77063f5e8533cd"
     },
     "DeadLetterQueue.js": {
-      "size": 19444,
-      "sha256": "d17c60d3b938ed141760c7cc8b75b14e8c20ce98c3962265f4d12f2f1edba69c"
+      "size": 19476,
+      "sha256": "de0ac7ee53a71e375536041a3ce65be22bc29f1901af8564f1e60307007c061e"
     },
     "HealthMonitor.d.ts": {
       "size": 1485,
@@ -127,8 +126,8 @@
       "sha256": "23837171b31c5242e4b43226cb0acae815dea0ce7b1628aa1428a86b24689230"
     },
     "NotificationWorker.d.ts": {
-      "size": 811,
-      "sha256": "dd22674e6955c32c7ac7af8af8fee583e62d4f0e224da14a72a7f1799e734f96"
+      "size": 952,
+      "sha256": "facdae5d7e82364ad9aab4398f8a3f8b5be8d8e9cb3aaa18fde76a88cd05b959"
     },
     "NotificationWorker.js": {
       "size": 828,
@@ -175,28 +174,28 @@
       "sha256": "555277c91f87899415cebf35eddc08d7c0b80cc55bfac7cb7fe96529cc927257"
     },
     "WorkerFactory.d.ts": {
-      "size": 7447,
-      "sha256": "b31131698eae955a7fcd6d3ef872d0bc1d3557c7f18695850e9407707fcf548d"
+      "size": 7716,
+      "sha256": "3869f960c87260588e40941ff91bffcfa0757be7a04815fd28b57dd4840c51df"
     },
     "WorkerFactory.js": {
-      "size": 90728,
-      "sha256": "231c5af0f6b472649e82a9a062479f68dec18ea8c8298443e40d02fe3c9338f4"
+      "size": 102863,
+      "sha256": "1024756e603ca67461a955723dc004de9395267e50c7f59c9f8f0c13b2f0f7d8"
     },
     "WorkerInit.d.ts": {
-      "size": 2391,
-      "sha256": "8a6fdec7b592dd92162b3ad1b3d3fd6462abcf11028e510dbdb747748774d626"
+      "size": 3284,
+      "sha256": "f902550cda7fca36f2db6297d39a4339ed6b5ff1c738da867233309cf0ca8fe1"
     },
     "WorkerInit.js": {
-      "size": 11908,
-      "sha256": "71e4fd64b44d48b0bbd2fbebfb71fcf75c528734e90359994c492f9cc2590df6"
+      "size": 14031,
+      "sha256": "51f44ca085a1682130aa36fed3acfd575108e974bf4c21eaa772001719c18853"
     },
     "WorkerMetrics.d.ts": {
       "size": 3304,
       "sha256": "5b684f87668bba86825625c20dda162915674e8c0fe3c3a32e05a2d9951c985f"
     },
     "WorkerMetrics.js": {
-      "size": 20584,
-      "sha256": "51dfef790aa2531387b193c5194ef3fbe021a238e0b021666aab4a605ced5879"
+      "size": 20656,
+      "sha256": "a3888a82cdc8311887e1320a320d11630cf9358d80681be21f6fc02c90fee2fa"
     },
     "WorkerRegistry.d.ts": {
       "size": 3941,
@@ -231,8 +230,8 @@
       "sha256": "8af20d462270e7044c6ea983821f5b6e6ce8a5caf39b6e8fefff07c9a0bf071e"
     },
     "build-manifest.json": {
-      "size": 19603,
-      "sha256": "ee6386bb995df82724f76c33f1333c0f77863bff9c3cb6007ac2fd20969dec90"
+      "size": 19591,
+      "sha256": "09f2e951c3a969cd97fcfc9ed8133e14da9e4b4250453c84d69ef973dd7bedec"
     },
     "config/workerConfig.d.ts": {
       "size": 132,
@@ -243,12 +242,12 @@
       "sha256": "189c3b1d8a31de1c04206fcfacc1fed974a74684d7d70895cd20a03b35860ac6"
     },
     "createQueueWorker.d.ts": {
-      "size": 890,
-      "sha256": "c0e07ac27f1ec74fff817ce82eb1cbcfae45ab3cd079748766dcbf4a73c5ec98"
+      "size": 1031,
+      "sha256": "dacd49f6c112eba439bdd9bb457eea90daedbf32efc381cd3189ce562fa5b0a8"
     },
     "createQueueWorker.js": {
-      "size": 13717,
-      "sha256": "b8cfe312445a150824d26ba3867147aa6a10e8dece2e342c7447404fb7fa4991"
+      "size": 14103,
+      "sha256": "8e619da00200c0c1270674a6a2941ae050c8ade3e38925b5446916cddc2a8b65"
     },
     "dashboard/index.d.ts": {
       "size": 109,
@@ -271,8 +270,8 @@
       "sha256": "8e0e04329e1119d8ae835dd4458efead084293bcc2c263c09dd5a19d467e5ca4"
     },
     "dashboard/workers-api.js": {
-      "size": 26774,
-      "sha256": "8d49b06c88df07afabfb49a4d3a4459e3f40340eccd03610d6be9095409e422e"
+      "size": 28207,
+      "sha256": "ae1ff0e962b1f64e6d200a35c3b8b1de968341d8df6283625a3efce50a23826c"
     },
     "helper/index.d.ts": {
       "size": 159,
@@ -411,20 +410,20 @@
       "sha256": "e90a171f2d8f6a62518099f825775b80299b934a7d48421bc1a3ebd6b065d617"
     },
     "index.d.ts": {
-      "size": 2601,
-      "sha256": "6943403aba7442451a5abd3eb64a12d2842bb310360477b5a7180cf3b4373efa"
+      "size": 2721,
+      "sha256": "0dcb7ca21683ab210eeb23d067e41b55ae996fa9e52c688371dc177f070ec059"
     },
     "index.js": {
-      "size": 2261,
-      "sha256": "afd4bf4715321d1e073366a7cb93ac17a1f9f647500ac4027102de65f26bc213"
+      "size": 2337,
+      "sha256": "d6f01d1d1f313d649fd5072e70617e3e28061e9c55d25ce24c3ea2d06e2cb8eb"
     },
     "register.d.ts": {
       "size": 256,
       "sha256": "07753654e043fd8ac0d42c4d74a26406929fc076c8c86b3d0513898c7da0d0aa"
     },
     "register.js": {
-      "size": 1555,
-      "sha256": "993d453ba69ea637d3674684032fc6dd47755c23c491920c04d12e006290cfe6"
+      "size": 1626,
+      "sha256": "4c404dfb2df0ac42da904bf30cece14ddbe127b8408d1ded951bf60ca86d07a3"
     },
     "routes/workers.d.ts": {
       "size": 498,

package/dist/createQueueWorker.js

@@ -1,5 +1,6 @@
 import * as Core from '@zintrust/core';
 import { Env, Logger, Queue } from '@zintrust/core';
+const TypedQueue = Queue;
 const RETRY_BASE_DELAY_MS = 1000;
 const RETRY_MAX_DELAY_MS = 30000;
 const getJobStateTracker = () => {
@@ -92,6 +93,12 @@ const buildBaseLogFields = (message, getLogFields) => {
         ...getLogFields(message.payload),
     };
 };
+const toBullMQPayload = (payload) => {
+    if (typeof payload === 'object' && payload !== null) {
+        return { ...payload };
+    }
+    return { payload };
+};
 const getWorkerInstanceId = () => {
     return typeof Env['WORKER_INSTANCE_ID'] === 'string'
         ? String(Env['WORKER_INSTANCE_ID'])
@@ -139,12 +146,12 @@ const checkAndRequeueIfNotDue = async (options, queueName, driverName, message,
         ...baseLogFields,
         dueAt: new Date(timestamp).toISOString(),
     });
-    await Queue.enqueue(queueName, message.payload, driverName);
-    await Queue.ack(queueName, message.id, driverName);
+    await TypedQueue.enqueue(queueName, toBullMQPayload(message.payload), driverName);
+    await TypedQueue.ack(queueName, message.id, driverName);
     return true;
 };
 const onProcessSuccess = async (input) => {
-    await Queue.ack(input.queueName, input.message.id, input.driverName);
+    await TypedQueue.ack(input.queueName, input.message.id, input.driverName);
     if (typeof input.trackerApi.completed === 'function') {
         await input.trackerApi.completed({
             queueName: input.queueName,
@@ -177,22 +184,20 @@ const onProcessFailure = async (input) => {
     if (nextAttempts < input.options.maxAttempts) {
         const retryDelayMs = getRetryDelayMs(nextAttempts);
         retryAt = new Date(Date.now() + retryDelayMs).toISOString();
-        const currentPayload = typeof input.message.payload === 'object' && input.message.payload !== null
-            ? input.message.payload
-            : { payload: input.message.payload };
+        const currentPayload = toBullMQPayload(input.message.payload);
         const payloadForRetry = {
             ...currentPayload,
             attempts: nextAttempts,
             timestamp: Date.now() + retryDelayMs,
         };
-        await Queue.enqueue(input.queueName, payloadForRetry, input.driverName);
+        await TypedQueue.enqueue(input.queueName, payloadForRetry, input.driverName);
         Logger.info(`${input.options.kindLabel} re-queued for retry`, {
             ...input.baseLogFields,
             attempts: nextAttempts,
             retryDelayMs,
         });
     }
-    await Queue.ack(input.queueName, input.message.id, input.driverName);
+    await TypedQueue.ack(input.queueName, input.message.id, input.driverName);
     await removeHeartbeatIfSupported(input.queueName, input.message.id);
     if (typeof input.trackerApi.failed === 'function') {
         await input.trackerApi.failed({
@@ -235,7 +240,7 @@ const startTrackingAndHeartbeat = async (input) => {
     return { startedAtMs, heartbeatTimer };
 };
 const processQueueMessage = async (options, queueName, driverName) => {
-    const message = (await Queue.dequeue(queueName, driverName));
+    const message = await TypedQueue.dequeue(queueName, driverName);
     if (!message)
         return false;
     const baseLogFields = buildBaseLogFields(message, options.getLogFields);

package/dist/index.d.ts

@@ -32,11 +32,12 @@ export { BroadcastWorker } from './BroadcastWorker';
 export { createQueueWorker } from './createQueueWorker';
 export type { CreateQueueWorkerOptions } from './createQueueWorker';
 export { NotificationWorker } from './NotificationWorker';
-export type { RedisConfig, WorkerAutoScalingConfig, WorkerComplianceConfig, WorkerConfig, WorkerCostConfig, WorkerObservabilityConfig, WorkerStatus, WorkerVersioningConfig, WorkersConfigOverrides, WorkersGlobalConfig, } from '@zintrust/core';
+export type { RedisConfig, WorkerAutoScalingConfig, WorkerComplianceConfig, WorkerConfig, WorkerCostConfig, WorkerObservabilityConfig, WorkersConfigOverrides, WorkersGlobalConfig, WorkerStatus, WorkerVersioningConfig, } from '@zintrust/core';
 export type { Job, Worker, WorkerOptions } from 'bullmq';
 export type { IAnomaly, IAnomalyConfig, IForecast, IMetric, IPrediction, IRecommendation, IRootCauseAnalysis, } from './AnomalyDetection';
 export type { IChaosComparison, IChaosExperiment, IChaosReport, IChaosStatus, } from './ChaosEngineering';
 export type { ISLAConfig, ISLAReport, ISLAStatus, ISLAViolation, ITimeRange } from './SLAMonitor';
+export type * from './config/workerConfig';
 export type * from './type';
 /**
  * Package version and build metadata

package/dist/register.js

@@ -16,6 +16,7 @@ const getWorkerProviders = () => {
         ['worker:start-all', WorkerCommands.createWorkerStartAllCommand()],
         ['worker:stop', WorkerCommands.createWorkerStopCommand()],
         ['worker:restart', WorkerCommands.createWorkerRestartCommand()],
+        ['worker:doctor', WorkerCommands.createWorkerDoctorCommand()],
         ['worker:summary', WorkerCommands.createWorkerSummaryCommand()],
     ];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/workers",
-  "version": "0.4.27",
+  "version": "0.4.36",
   "description": "Worker orchestration and background job management for ZinTrust.",
   "private": false,
   "type": "module",
@@ -40,7 +40,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.4.27",
+    "@zintrust/core": "^0.4.36",
     "@zintrust/queue-monitor": "*",
     "@zintrust/queue-redis": "*"
   },
@@ -67,10 +67,10 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api": "^1.9.1",
     "hot-shots": "^14.2.0",
-    "ioredis": "^5.10.0",
+    "ioredis": "^5.10.1",
     "prom-client": "^15.1.3",
     "simple-statistics": "^7.8.9"
   }
-}
+}

package/src/ClusterLock.ts

@@ -193,7 +193,7 @@ export const ClusterLock = Object.freeze({
       return;
     }
 
-    const client = createRedisConnection(config);
+    const client = createRedisConnection(config, 3, { subsystem: 'worker-cluster-lock' });
     redisClient = client;
     startHeartbeat(client);
 

package/src/ComplianceManager.ts

@@ -344,7 +344,7 @@ export const ComplianceManager = Object.freeze({
       return;
     }
 
-    redisClient = createRedisConnection(redisConfig);
+    redisClient = createRedisConnection(redisConfig, 3, { subsystem: 'worker-compliance' });
     complianceConfig = {
       gdpr: { ...DEFAULT_CONFIG.gdpr, ...config?.gdpr },
       hipaa: { ...DEFAULT_CONFIG.hipaa, ...config?.hipaa },

package/src/DeadLetterQueue.ts

@@ -260,7 +260,7 @@ export const DeadLetterQueue = Object.freeze({
       return;
     }
 
-    redisClient = createRedisConnection(config);
+    redisClient = createRedisConnection(config, 3, { subsystem: 'worker-dlq' });
     retentionPolicy = policy;
 
     // Start cleanup interval if auto-delete is enabled

package/src/WorkerFactory.ts

@@ -141,9 +141,6 @@ const resolvePackageSpecifierUrl = (specifier: string): string | null => {
   }
 };
 
-const escapeRegExp = (value: string): string =>
-  value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
-
 const rewriteProcessorImports = (code: string): string => {
   const replacements: Array<{ from: string; to: string }> = [];
   const coreUrl = resolvePackageSpecifierUrl('@zintrust/core');
@@ -155,8 +152,8 @@ const rewriteProcessorImports = (code: string): string => {
 
   let updated = code;
   for (const { from, to } of replacements) {
-    const pattern = new RegExp(String.raw`(['"])${escapeRegExp(from)}\1`, 'g');
-    updated = updated.replace(pattern, `$1${to}$1`);
+    updated = updated.replaceAll(`'${from}'`, `'${to}'`);
+    updated = updated.replaceAll(`"${from}"`, `"${to}"`);
   }
 
   return updated;
@@ -548,14 +545,58 @@ const getProcessorSpecConfig = (): typeof workersConfig.processorSpec =>
 
 const toPosixPath = (value: string): string => value.split(path.sep).join('/');
 
+const isUpperAlpha = (value: string): boolean => /^[A-Z]$/.test(value);
+
+const isLowerAlphaOrDigit = (value: string): boolean => /^[a-z\d]$/.test(value);
+
+const isAlphaNumeric = (value: string): boolean => /^[A-Za-z\d]$/.test(value);
+
+const shouldInsertWorkerNameDash = (
+  previous: string,
+  current: string,
+  next: string | undefined
+): boolean => {
+  if (!isAlphaNumeric(previous) || !isAlphaNumeric(current)) return false;
+
+  if (isLowerAlphaOrDigit(previous) && isUpperAlpha(current)) {
+    return true;
+  }
+
+  if (isUpperAlpha(previous) && isUpperAlpha(current) && isLowerAlphaOrDigit(next ?? '')) {
+    return true;
+  }
+
+  return false;
+};
+
+const toKebabWorkerName = (value: string): string => {
+  if (!isNonEmptyString(value)) return value;
+
+  let normalized = '';
+
+  for (let index = 0; index < value.length; index += 1) {
+    const current = value[index] ?? '';
+    const previous = index > 0 ? (value[index - 1] ?? '') : '';
+    const next = value[index + 1];
+
+    if (current === ' ' || current === '_') {
+      if (!normalized.endsWith('-')) normalized += '-';
+      continue;
+    }
+
+    if (shouldInsertWorkerNameDash(previous, current, next) && !normalized.endsWith('-')) {
+      normalized += '-';
+    }
+
+    normalized += current;
+  }
+
+  return normalized.replaceAll(/-+/g, '-');
+};
+
 const normalizeWorkerFileName = (fileName: string): string => {
-  const baseName = fileName.replaceAll(/\.[^.]+$/, '');
-  return baseName
-    .replaceAll(/([a-z\d])([A-Z])/g, '$1-$2')
-    .replaceAll(/([A-Z]+)([A-Z][a-z\d]+)/g, '$1-$2')
-    .replaceAll(/[\s_]+/g, '-')
-    .replaceAll(/-+/g, '-')
-    .toLowerCase();
+  const baseName = fileName.replace(/\.[^.]+$/, '');
+  return toKebabWorkerName(baseName).toLowerCase();
 };
 
 const supportsWorkerFileDiscovery = (): boolean => {
@@ -1984,20 +2025,17 @@ const resolveRedisConfigFromEnv = (config: RedisEnvConfig, context: string): Red
 
 const resolveRedisConfigFromDirect = (config: RedisConfig, context: string): RedisConfig => {
   const fallbackDb = Env.getInt('REDIS_QUEUE_DB', ZintrustLang.REDIS_DEFAULT_DB);
-  const redisConfigWithDatabase = config as RedisConfig & { database?: number };
 
   let normalizedDb = fallbackDb;
   if (typeof config.db === 'number') {
     normalizedDb = config.db;
-  } else if (typeof redisConfigWithDatabase.database === 'number') {
-    normalizedDb = redisConfigWithDatabase.database;
   }
 
   return {
     host: requireRedisHost(config.host, context),
     port: config.port,
     db: normalizedDb,
-    password: config.password ?? Env.get('REDIS_PASSWORD', undefined),
+    password: config.password ?? Env.get('REDIS_PASSWORD'),
   };
 };
 
@@ -2163,7 +2201,7 @@ const resolveWorkerStore = async (config: WorkerFactoryConfig): Promise<WorkerSt
     );
     const key_prefix = persistence.keyPrefix ?? keyPrefix();
     logRedisPersistenceConfig(redisConfig, key_prefix, 'resolveWorkerStore');
-    const client = createRedisConnection(redisConfig);
+    const client = createRedisConnection(redisConfig, 3, { subsystem: 'worker-persistence' });
     next = RedisWorkerStore.create(client, key_prefix);
   } else if (persistence.driver === 'database') {
     const explicitConnection =
@@ -2217,7 +2255,7 @@ const createWorkerStore = async (persistence: WorkerPersistenceConfig): Promise<
     );
     const key_prefix = persistence.keyPrefix ?? keyPrefix();
     logRedisPersistenceConfig(redisConfig, key_prefix, 'createWorkerStore');
-    const client = createRedisConnection(redisConfig);
+    const client = createRedisConnection(redisConfig, 3, { subsystem: 'worker-persistence' });
     return RedisWorkerStore.create(client, key_prefix);
   }
 

package/src/WorkerMetrics.ts

@@ -111,7 +111,7 @@ const getValidClient = async (): Promise<RedisConnection> => {
 
   // If no client, create one
   if (!redisClient) {
-    redisClient = createRedisConnection(cachedConfig);
+    redisClient = createRedisConnection(cachedConfig, 3, { subsystem: 'worker-metrics' });
   }
 
   const client = redisClient;
@@ -358,7 +358,7 @@ const WorkerMetrics = Object.freeze({
     }
 
     cachedConfig = config;
-    redisClient = createRedisConnection(config);
+    redisClient = createRedisConnection(config, 3, { subsystem: 'worker-metrics' });
     Logger.info('WorkerMetrics initialized');
   },
 

package/src/createQueueWorker.ts

@@ -2,6 +2,17 @@ import type { BullMQPayload, QueueMessage } from '@zintrust/core';
 import * as Core from '@zintrust/core';
 import { Env, Logger, Queue } from '@zintrust/core';
 
+type QueueApi = Readonly<{
+  enqueue: (queue: string, payload: BullMQPayload, driverName?: string) => Promise<string>;
+  dequeue: <TPayload>(
+    queue: string,
+    driverName?: string
+  ) => Promise<QueueMessage<TPayload> | undefined>;
+  ack: (queue: string, id: string, driverName?: string) => Promise<void>;
+}>;
+
+const TypedQueue = Queue as QueueApi;
+
 const RETRY_BASE_DELAY_MS = 1000;
 const RETRY_MAX_DELAY_MS = 30000;
 
@@ -97,9 +108,7 @@ const getAttemptsFromMessage = <TPayload>(message: QueueMessage<TPayload>): numb
     typeof message.payload === 'object' && message.payload !== null
       ? normalizeAttempts((message.payload as Record<string, unknown>)['attempts'])
       : 0;
-  const messageAttempts = normalizeAttempts(
-    (message as QueueMessage<TPayload> & { attempts?: number }).attempts
-  );
+  const messageAttempts = normalizeAttempts(message.attempts);
   return Math.max(payloadAttempts, messageAttempts);
 };
 
@@ -152,6 +161,14 @@ const buildBaseLogFields = <TPayload>(
   };
 };
 
+const toBullMQPayload = <TPayload>(payload: TPayload): BullMQPayload => {
+  if (typeof payload === 'object' && payload !== null) {
+    return { ...(payload as Record<string, unknown>) };
+  }
+
+  return { payload };
+};
+
 type TrackerApi = {
   started?: (input: {
     queueName: string;
@@ -263,8 +280,8 @@ const checkAndRequeueIfNotDue = async <TPayload>(
     ...baseLogFields,
     dueAt: new Date(timestamp).toISOString(),
   });
-  await Queue.enqueue(queueName, message.payload as BullMQPayload, driverName);
-  await Queue.ack(queueName, message.id, driverName);
+  await TypedQueue.enqueue(queueName, toBullMQPayload(message.payload), driverName);
+  await TypedQueue.ack(queueName, message.id, driverName);
   return true;
 };
 
@@ -277,7 +294,7 @@ const onProcessSuccess = async <TPayload>(input: {
   startedAtMs: number;
   baseLogFields: Record<string, unknown>;
 }): Promise<boolean> => {
-  await Queue.ack(input.queueName, input.message.id, input.driverName);
+  await TypedQueue.ack(input.queueName, input.message.id, input.driverName);
 
   if (typeof input.trackerApi.completed === 'function') {
     await input.trackerApi.completed({
@@ -324,10 +341,7 @@ const onProcessFailure = async <TPayload>(input: {
   if (nextAttempts < input.options.maxAttempts) {
     const retryDelayMs = getRetryDelayMs(nextAttempts);
     retryAt = new Date(Date.now() + retryDelayMs).toISOString();
-    const currentPayload =
-      typeof input.message.payload === 'object' && input.message.payload !== null
-        ? (input.message.payload as Record<string, unknown>)
-        : ({ payload: input.message.payload } as Record<string, unknown>);
+    const currentPayload = toBullMQPayload(input.message.payload);
 
     const payloadForRetry: BullMQPayload = {
       ...currentPayload,
@@ -335,7 +349,7 @@ const onProcessFailure = async <TPayload>(input: {
       timestamp: Date.now() + retryDelayMs,
     };
 
-    await Queue.enqueue(input.queueName, payloadForRetry, input.driverName);
+    await TypedQueue.enqueue(input.queueName, payloadForRetry, input.driverName);
     Logger.info(`${input.options.kindLabel} re-queued for retry`, {
       ...input.baseLogFields,
       attempts: nextAttempts,
@@ -343,7 +357,7 @@ const onProcessFailure = async <TPayload>(input: {
     });
   }
 
-  await Queue.ack(input.queueName, input.message.id, input.driverName);
+  await TypedQueue.ack(input.queueName, input.message.id, input.driverName);
   await removeHeartbeatIfSupported(input.queueName, input.message.id);
 
   if (typeof input.trackerApi.failed === 'function') {
@@ -409,7 +423,7 @@ const processQueueMessage = async <TPayload>(
   queueName: string,
   driverName?: string
 ): Promise<boolean> => {
-  const message = (await Queue.dequeue(queueName, driverName)) as QueueMessage<TPayload> | null;
+  const message = await TypedQueue.dequeue<TPayload>(queueName, driverName);
   if (!message) return false;
 
   const baseLogFields = buildBaseLogFields(message, options.getLogFields);

package/src/index.ts

@@ -71,10 +71,10 @@ export type {
   WorkerConfig,
   WorkerCostConfig,
   WorkerObservabilityConfig,
-  WorkerStatus,
-  WorkerVersioningConfig,
   WorkersConfigOverrides,
   WorkersGlobalConfig,
+  WorkerStatus,
+  WorkerVersioningConfig,
 } from '@zintrust/core';
 
 // Re-export bullmq types for type compatibility
@@ -97,6 +97,7 @@ export type {
 } from './ChaosEngineering';
 export type { ISLAConfig, ISLAReport, ISLAStatus, ISLAViolation, ITimeRange } from './SLAMonitor';
 
+export type * from './config/workerConfig';
 export type * from './type';
 
 /**

package/src/register.ts

@@ -15,6 +15,7 @@ type WorkerCommandsModule = {
     createWorkerStartAllCommand: () => CliCommandProvider;
     createWorkerStopCommand: () => CliCommandProvider;
     createWorkerRestartCommand: () => CliCommandProvider;
+    createWorkerDoctorCommand: () => CliCommandProvider;
     createWorkerSummaryCommand: () => CliCommandProvider;
   };
 };
@@ -38,6 +39,7 @@ const getWorkerProviders = (): Array<[string, CliCommandProvider]> => {
     ['worker:start-all', WorkerCommands.createWorkerStartAllCommand()],
     ['worker:stop', WorkerCommands.createWorkerStopCommand()],
     ['worker:restart', WorkerCommands.createWorkerRestartCommand()],
+    ['worker:doctor', WorkerCommands.createWorkerDoctorCommand()],
     ['worker:summary', WorkerCommands.createWorkerSummaryCommand()],
   ];
 };