@zintrust/core 0.1.22 → 0.1.24

package/src/cli/CLI.js

@@ -15,18 +15,22 @@ import { KeyGenerateCommand } from './commands/KeyGenerateCommand.js';
 import { MakeMailTemplateCommand } from './commands/MakeMailTemplateCommand.js';
 import { MakeNotificationTemplateCommand } from './commands/MakeNotificationTemplateCommand.js';
 import { MigrateCommand } from './commands/MigrateCommand.js';
+import { MigrateWorkerCommand } from './commands/MigrateWorkerCommand.js';
 import { NewCommand } from './commands/NewCommand.js';
 import { NotificationWorkCommand } from './commands/NotificationWorkCommand.js';
 import { PluginCommand } from './commands/PluginCommand.js';
 import { PrepareCommand } from './commands/PrepareCommand.js';
+import { PublishCommand } from './commands/PublishCommand.js';
 import { QACommand } from './commands/QACommand.js';
 import { QueueCommand } from './commands/QueueCommand.js';
+import { ResourceControlCommand } from './commands/ResourceControlCommand.js';
 import { RoutesCommand } from './commands/RoutesCommand.js';
 import { SecretsCommand } from './commands/SecretsCommand.js';
 import { SimulateCommand } from './commands/SimulateCommand.js';
 import { StartCommand } from './commands/StartCommand.js';
 import { TemplatesCommand } from './commands/TemplatesCommand.js';
 import { UpgradeCommand } from './commands/UpgradeCommand.js';
+import { WorkerCommands } from './commands/WorkerCommands.js';
 import { ErrorHandler } from './ErrorHandler.js';
 import { esmDirname } from '../common/index.js';
 import { Logger } from '../config/logger.js';
@@ -56,7 +60,7 @@ const loadVersion = () => {
 const setupProgram = (program, version) => {
     program
         .name('zintrust')
-        .description('Zintrust Framework CLI - Build production-grade TypeScript APIs')
+        .description('ZinTrust Framework CLI - Build production-grade TypeScript APIs')
         .version(version, '-v, --version', 'Output version number')
         .helpOption('-h, --help', 'Display help for command')
         .usage('[command] [options]');
@@ -79,6 +83,8 @@ const registerCommands = (program) => {
         QueueCommand.create(),
         BroadcastWorkCommand.create(),
         NotificationWorkCommand.create(),
+        ResourceControlCommand,
+        MigrateWorkerCommand.create(),
         MigrateCommand.create(),
         DbSeedCommand.create(),
         D1MigrateCommand.create(),
@@ -86,6 +92,7 @@ const registerCommands = (program) => {
         SecretsCommand.create(),
         ConfigCommand.create(),
         PluginCommand.create(),
+        PublishCommand.create(),
         QACommand(),
         FixCommand.create(),
         KeyGenerateCommand.create(),
@@ -95,6 +102,13 @@ const registerCommands = (program) => {
         MakeNotificationTemplateCommand.create(),
         RoutesCommand.create(),
         JwtDevCommand,
+        // Worker management commands
+        WorkerCommands.createWorkerListCommand(),
+        WorkerCommands.createWorkerStatusCommand(),
+        WorkerCommands.createWorkerStartCommand(),
+        WorkerCommands.createWorkerStopCommand(),
+        WorkerCommands.createWorkerRestartCommand(),
+        WorkerCommands.createWorkerSummaryCommand(),
     ];
     for (const command of commands) {
         program.addCommand(command.getCommand());

package/src/cli/ErrorHandler.js

@@ -43,10 +43,10 @@ const displayInfo = (message) => {
  */
 const displayBanner = (version) => {
     /* eslint-disable no-console */
-    const framework = 'Zintrust Framework';
+    const framework = 'ZinTrust Framework';
     const bannerWidth = 46;
-    const env = Env.NODE_ENV || 'development';
-    const db = Env.DB_CONNECTION || 'sqlite';
+    const env = Env.NODE_ENV ?? 'development';
+    const db = Env.DB_CONNECTION ?? 'sqlite';
     const border = chalk.cyanBright;
     const label = chalk.bold.white;
     const frameworkValue = chalk.bold.cyanBright;

package/src/cli/commands/AddCommand.d.ts

@@ -1,6 +1,6 @@
 /**
  * Add Command - Phase 4 Integration
- * Add services and features to existing Zintrust project
+ * Add services and features to existing ZinTrust project
  */
 import type { IBaseCommand } from '../BaseCommand';
 import type { ResponseField } from '../scaffolding/ResponseFactoryGenerator';

package/src/cli/commands/AddCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/AddCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarE,OAAO,KAAK,EAEV,aAAa,EAAC,MAAM,2CAA2C,CAAC;AA0ClE,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC7C;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,2BAA2B;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,4BAA4B;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsmCD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;IAWtB;;;OAGG;;2CAnlC2C,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC;mCA2EhD,OAAO,CAAC,oBAAoB,CAAC;qCA8D3B,OAAO,CAAC,sBAAsB,CAAC;iCAwGnC,OAAO,CAAC,kBAAkB,CAAC;sCA4DtB,OAAO,CAAC,uBAAuB,CAAC;kCAwDpC,OAAO,CAAC,mBAAmB,CAAC;mCAkE3B,OAAO,CAAC,oBAAoB,CAAC;kCA8I9B,OAAO,CAAC,mBAAmB,CAAC;0CAiHpB,OAAO,CAAC,2BAA2B,CAAC;yCAwFrC,OAAO,CAAC,MAAM,CAAC;2DAkBpC,MAAM,KAC1B,OAAO,CAAC,4BAA4B,CAAC;4CAoHzB,MAAM,KAClB,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAA;SAAE,CAAC;iDAlE5C,MAAM,KAAG,aAAa,EAAE;;EA+RtE,CAAC"}
+{"version":3,"file":"AddCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/AddCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarE,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,2CAA2C,CAAC;AAwCnD,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC7C;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,2BAA2B;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,4BAA4B;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsmCD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;IAWtB;;;OAGG;;2CAnlC2C,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC;mCA2EhD,OAAO,CAAC,oBAAoB,CAAC;qCA8D3B,OAAO,CAAC,sBAAsB,CAAC;iCAwGnC,OAAO,CAAC,kBAAkB,CAAC;sCA4DtB,OAAO,CAAC,uBAAuB,CAAC;kCAwDpC,OAAO,CAAC,mBAAmB,CAAC;mCAkE3B,OAAO,CAAC,oBAAoB,CAAC;kCA8I9B,OAAO,CAAC,mBAAmB,CAAC;0CAiHpB,OAAO,CAAC,2BAA2B,CAAC;yCAwFrC,OAAO,CAAC,MAAM,CAAC;2DAkBpC,MAAM,KAC1B,OAAO,CAAC,4BAA4B,CAAC;4CAoHzB,MAAM,KAClB,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAA;SAAE,CAAC;iDAlE5C,MAAM,KAAG,aAAa,EAAE;;EA+RtE,CAAC"}

package/src/cli/commands/AddCommand.js

@@ -1,6 +1,6 @@
 /**
  * Add Command - Phase 4 Integration
- * Add services and features to existing Zintrust project
+ * Add services and features to existing ZinTrust project
  */
 import { BaseCommand } from '../BaseCommand.js';
 import { ControllerGenerator } from '../scaffolding/ControllerGenerator.js';

package/src/cli/commands/DbSeedCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DbSeedCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DbSeedCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6MrE,eAAO,MAAM,aAAa;cACd,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"DbSeedCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DbSeedCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkKrE,eAAO,MAAM,aAAa;cACd,YAAY;EAUtB,CAAC"}

package/src/cli/commands/DbSeedCommand.js

@@ -5,7 +5,7 @@
 import { SeederDiscovery } from '../../seeders/SeederDiscovery.js';
 import { SeederLoader } from '../../seeders/SeederLoader.js';
 import { BaseCommand } from '../BaseCommand.js';
-import { PromptHelper } from '../PromptHelper.js';
+import { confirmProductionRun, mapConnectionToOrmConfig } from '../utils/DatabaseCliUtils.js';
 import { databaseConfig } from '../../config/database.js';
 import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
@@ -17,48 +17,12 @@ const addSeedOptions = (command) => {
         .option('--only-service <domain/name>', 'Run only service-local seeders')
         .option('--no-interactive', 'Skip interactive prompts');
 };
-const getInteractive = (options) => options['interactive'] !== false && process.env['CI'] !== 'true';
+const getInteractive = (options) => options['interactive'] !== false && Env.CI !== 'true';
 const ensureNonD1Driver = (driver) => {
     if (driver === 'd1' || driver === 'd1-remote') {
         throw ErrorFactory.createCliError('This project is configured for D1. Seeding via `zin db:seed` is not supported yet.');
     }
 };
-const mapConnectionToOrmConfig = (conn) => {
-    switch (conn.driver) {
-        case 'sqlite':
-            return { driver: 'sqlite', database: conn.database };
-        case 'postgresql':
-            return {
-                driver: 'postgresql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'mysql':
-            return {
-                driver: 'mysql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        default:
-            return { driver: 'sqlite', database: ':memory:' };
-    }
-};
-const confirmProductionRun = async (cmd, interactive) => {
-    if (Env.NODE_ENV !== 'production')
-        return true;
-    const confirmed = await PromptHelper.confirm('NODE_ENV=production. Continue running seeders?', false, interactive);
-    if (!confirmed) {
-        cmd.warn('Cancelled.');
-        return false;
-    }
-    return true;
-};
 const getServiceArgs = (options) => {
     let serviceArg;
     if (typeof options['onlyService'] === 'string') {
@@ -105,7 +69,11 @@ const selectSeederFiles = (files, seederName) => {
 };
 const executeSeed = async (options, cmd) => {
     const interactive = getInteractive(options);
-    const okToProceed = await confirmProductionRun(cmd, interactive);
+    const okToProceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        message: 'NODE_ENV=production. Continue running seeders?',
+    });
     if (!okToProceed)
         return;
     const conn = databaseConfig.getConnection();

package/src/cli/commands/MakeMailTemplateCommand.js

@@ -7,6 +7,7 @@ import { ErrorHandler } from '../ErrorHandler.js';
 import { PromptHelper } from '../PromptHelper.js';
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
 import { TemplateGenerator } from '../scaffolding/TemplateGenerator.js';
+import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import * as path from '../../node-singletons/path.js';
 const addOptions = (command) => {
@@ -16,7 +17,7 @@ const addOptions = (command) => {
     command.option('--overwrite', 'Overwrite existing file');
     command.option('--no-interactive', 'Disable prompts (requires args/options)');
 };
-const defaultCopyright = () => process.env['TEMPLATE_COPYRIGHT'] ?? '© 2025 Zintrust Framework. All rights reserved.';
+const defaultCopyright = () => Env.TEMPLATE_COPYRIGHT;
 export const MakeMailTemplateCommand = Object.freeze({
     create() {
         return BaseCommand.create({

package/src/cli/commands/MakeNotificationTemplateCommand.js

@@ -7,6 +7,7 @@ import { ErrorHandler } from '../ErrorHandler.js';
 import { PromptHelper } from '../PromptHelper.js';
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
 import { TemplateGenerator } from '../scaffolding/TemplateGenerator.js';
+import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import * as path from '../../node-singletons/path.js';
 import inquirer from 'inquirer';
@@ -18,7 +19,7 @@ const addOptions = (command) => {
     command.option('--overwrite', 'Overwrite existing file');
     command.option('--no-interactive', 'Disable prompts (requires args/options)');
 };
-const defaultCopyright = () => process.env['TEMPLATE_COPYRIGHT'] ?? '© 2025 Zintrust Framework. All rights reserved.';
+const defaultCopyright = () => Env.TEMPLATE_COPYRIGHT;
 const parseChannelsCsv = (csv) => {
     if (csv === undefined || csv.trim() === '')
         return [];

package/src/cli/commands/MigrateCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkdrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4ZrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateCommand.js

@@ -7,8 +7,9 @@ import { D1SqlMigrations } from '../d1/D1SqlMigrations.js';
 import { WranglerConfig } from '../d1/WranglerConfig.js';
 import { WranglerD1 } from '../d1/WranglerD1.js';
 import { PromptHelper } from '../PromptHelper.js';
+import { confirmProductionRun, mapConnectionToOrmConfig, parseRollbackSteps, } from '../utils/DatabaseCliUtils.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import { databaseConfig } from '../../config/database.js';
-import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { Migrator } from '../../migrations/Migrator.js';
 import * as path from '../../node-singletons/path.js';
@@ -32,9 +33,10 @@ const addMigrateOptions = (command) => {
 };
 const getInteractive = (options) => options['interactive'] !== false;
 const getMigrationDirs = () => {
-    const globalDir = Env.get('MIGRATIONS_GLOBAL_DIR', databaseConfig.migrations.directory);
+    const globalDir = readEnvString('MIGRATIONS_GLOBAL_DIR', databaseConfig.migrations.directory);
     const extension = databaseConfig.migrations.extension;
-    const separateTracking = Env.getBool('MIGRATIONS_SEPARATE_TRACKING', false);
+    const separateTrackingRaw = readEnvString('MIGRATIONS_SEPARATE_TRACKING', '').trim();
+    const separateTracking = separateTrackingRaw === '1' || separateTrackingRaw.toLowerCase() === 'true';
     return { globalDir, extension, separateTracking };
 };
 const getServiceArgs = (options) => {
@@ -64,53 +66,6 @@ const describeTargetDatabase = (conn) => {
             return `${conn.driver}`;
     }
 };
-const mapConnectionToOrmConfig = (conn) => {
-    switch (conn.driver) {
-        case 'sqlite':
-            return { driver: 'sqlite', database: conn.database };
-        case 'postgresql':
-            return {
-                driver: 'postgresql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'mysql':
-            return {
-                driver: 'mysql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'sqlserver':
-            return {
-                driver: 'sqlserver',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        default:
-            return { driver: 'sqlite', database: ':memory:' };
-    }
-};
-const confirmProductionRun = async (cmd, interactive, destructive, force) => {
-    if (Env.NODE_ENV !== 'production')
-        return true;
-    if (force)
-        return true;
-    const confirmed = await PromptHelper.confirm(`NODE_ENV=production. Continue running migrations${destructive ? ' (destructive)' : ''}?`, false, interactive);
-    if (!confirmed) {
-        cmd.warn('Cancelled.');
-        return false;
-    }
-    return true;
-};
 const printStatus = (cmd, rows) => {
     if (rows.length === 0) {
         cmd.info('No migrations found.');
@@ -133,10 +88,6 @@ const logAppliedMigrations = (cmd, appliedNames) => {
         cmd.info(`✓ ${name}`);
     }
 };
-const parseRollbackSteps = (options) => {
-    const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
-    return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
-};
 const handleStatusAction = async (migrator, cmd, driver) => {
     cmd.info(`Adapter: ${driver}`);
     const rows = await migrator.status();
@@ -267,7 +218,13 @@ const processConnection = async (conn, options, cmd, interactive) => {
     const ormConfig = mapConnectionToOrmConfig(conn);
     const destructive = isDestructiveAction(options);
     const force = options['force'] === true;
-    const okToProceed = await confirmProductionRun(cmd, interactive, destructive, force);
+    const okToProceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        destructive,
+        force,
+        message: 'NODE_ENV=production. Continue running migrations?',
+    });
     if (!okToProceed)
         return;
     cmd.info(`[i] Target database: ${describeTargetDatabase(conn)}`);

package/src/cli/commands/MigrateWorkerCommand.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migrate Worker Command
+ * Run worker package migrations
+ */
+import type { IBaseCommand } from '../BaseCommand';
+export declare const MigrateWorkerCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+//# sourceMappingURL=MigrateWorkerCommand.d.ts.map

package/src/cli/commands/MigrateWorkerCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmKrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateWorkerCommand.js

@@ -0,0 +1,136 @@
+/**
+ * Migrate Worker Command
+ * Run worker package migrations
+ */
+import { BaseCommand } from '../BaseCommand.js';
+import { confirmProductionRun, mapConnectionToOrmConfig, parseRollbackSteps, } from '../utils/DatabaseCliUtils.js';
+import { databaseConfig } from '../../config/database.js';
+import { Migrator } from '../../migrations/Migrator.js';
+import * as path from '../../node-singletons/path.js';
+import { Database } from '../../orm/Database.js';
+import { DatabaseAdapterRegistry } from '../../orm/DatabaseAdapterRegistry.js';
+const addOptions = (command) => {
+    command
+        .option('--status', 'Display migration status (applied, pending, failed)')
+        .option('--fresh', 'Reset database: drop all tables and re-run all migrations')
+        .option('--reset', 'Rollback all migrations to initial state')
+        .option('--rollback', 'Rollback last migration batch')
+        .option('--step <number>', 'Number of batches to rollback (use with --rollback)', '1')
+        .option('--force', 'Skip production confirmation (allow unsafe operations in production)')
+        .option('--all', 'Run migrations for all configured database connections')
+        .option('--no-interactive', 'Disable interactive prompts (useful for CI/CD)');
+};
+const getInteractive = (options) => options['interactive'] !== false;
+const isDestructiveAction = (options) => options['fresh'] === true || options['reset'] === true || options['rollback'] === true;
+const printStatus = async (migrator, cmd) => {
+    const rows = await migrator.status();
+    if (rows.length === 0) {
+        cmd.info('No migrations found.');
+        return;
+    }
+    for (const row of rows) {
+        const tag = row.status ?? (row.applied ? 'applied' : 'pending');
+        const extra = row.applied ? ` (batch=${row.batch ?? '?'}, at=${row.appliedAt ?? '?'})` : '';
+        cmd.info(`${tag}: ${row.name}${extra}`);
+    }
+};
+const applyMigrations = async (migrator, cmd) => {
+    const result = await migrator.migrate();
+    if (result.appliedNames.length === 0) {
+        cmd.info('No pending worker migrations.');
+        return;
+    }
+    cmd.success('Worker migrations applied.');
+    for (const name of result.appliedNames) {
+        cmd.info(`✓ ${name}`);
+    }
+};
+const runActions = async (migrator, options, cmd, driver) => {
+    if (options['status'] === true) {
+        cmd.info(`Adapter: ${driver}`);
+        await printStatus(migrator, cmd);
+        return;
+    }
+    if (options['fresh'] === true) {
+        await migrator.fresh();
+        cmd.success('Worker migrations applied (fresh).');
+        return;
+    }
+    if (options['reset'] === true) {
+        await migrator.resetAll();
+        cmd.success('Worker migrations reset.');
+        return;
+    }
+    if (options['rollback'] === true) {
+        const steps = parseRollbackSteps(options);
+        const result = await migrator.rollbackLastBatch(steps);
+        cmd.success(`Worker migrations rolled back (${result.rolledBack}).`);
+        return;
+    }
+    await applyMigrations(migrator, cmd);
+};
+const runForConnection = async (conn, options, cmd, interactive) => {
+    const destructive = isDestructiveAction(options);
+    const proceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        destructive,
+        force: options['force'] === true,
+        message: 'NODE_ENV=production. Continue running worker migrations?',
+    });
+    if (!proceed)
+        return;
+    if (!DatabaseAdapterRegistry.has(conn.driver)) {
+        cmd.warn(`Missing adapter for driver: ${conn.driver}`);
+        cmd.warn('Install via `zin plugin install adapter:postgres` (or `zin add db:postgres`).');
+    }
+    const ormConfig = mapConnectionToOrmConfig(conn);
+    const db = Database.create(ormConfig);
+    await db.connect();
+    try {
+        const migrator = Migrator.create({
+            db,
+            projectRoot: process.cwd(),
+            globalDir: path.join(process.cwd(), 'packages', 'workers', 'migrations'),
+            extension: databaseConfig.migrations.extension,
+            separateTracking: true,
+        });
+        await runActions(migrator, options, cmd, conn.driver);
+    }
+    finally {
+        await db.disconnect();
+    }
+};
+const executeMigrateWorker = async (options, cmd) => {
+    const interactive = getInteractive(options);
+    const targets = [];
+    if (options['all'] === true) {
+        for (const [name, config] of Object.entries(databaseConfig.connections)) {
+            targets.push({ name, config });
+        }
+    }
+    else {
+        targets.push({ name: 'default', config: databaseConfig.getConnection() });
+    }
+    let sequence = Promise.resolve();
+    for (const { name, config } of targets) {
+        sequence = sequence.then(async () => {
+            if (targets.length > 1) {
+                cmd.info(`\n--- Connection: ${name} (${config.driver}) ---`);
+            }
+            await runForConnection(config, options, cmd, interactive);
+        });
+    }
+    await sequence;
+};
+export const MigrateWorkerCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'migrate:worker',
+            description: 'Run worker package migrations',
+            addOptions,
+            execute: async (options) => executeMigrateWorker(options, cmd),
+        });
+        return cmd;
+    },
+});

package/src/cli/commands/NewCommand.d.ts

@@ -1,6 +1,6 @@
 /**
  * New Command - Project scaffolding CLI command
- * Handles creation of new Zintrust projects
+ * Handles creation of new ZinTrust projects
  */
 import type { CommandOptions, IBaseCommand } from '../BaseCommand';
 type TemplateType = 'basic' | 'api' | 'microservice' | 'fullstack';

package/src/cli/commands/NewCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAcrE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuPhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAwOD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}
+{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAerE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwPhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAwOD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}

package/src/cli/commands/NewCommand.js

@@ -3,6 +3,7 @@ import { PromptHelper } from '../PromptHelper.js';
 import { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder.js';
 import { ProjectScaffolder } from '../scaffolding/ProjectScaffolder.js';
 import { SpawnUtil } from '../utils/spawn.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import { extractErrorMessage, resolvePackageManager } from '../../common/index.js';
 import { appConfig } from '../../config/app.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
@@ -26,7 +27,7 @@ const initializeGitRepo = (projectPath, log) => {
         const env = appConfig.getSafeEnv();
         execFileSync(git, ['init'], { cwd: projectPath, stdio: 'ignore', env });
         execFileSync(git, ['add', '.'], { cwd: projectPath, stdio: 'ignore', env });
-        execFileSync(git, ['commit', '-m', 'Initial commit from Zintrust'], {
+        execFileSync(git, ['commit', '-m', 'Initial commit from ZinTrust'], {
             cwd: projectPath,
             stdio: 'ignore',
             env,
@@ -69,7 +70,7 @@ const getProjectDefaults = (name, options) => {
     const portParsed = Number.parseInt(portRaw, 10);
     const port = Number.isFinite(portParsed) && portParsed > 0 ? portParsed : 7777;
     const author = getStringOption(options, 'author', '');
-    const description = getStringOption(options, 'description', `A new Zintrust project: ${name}`);
+    const description = getStringOption(options, 'description', `A new ZinTrust project: ${name}`);
     const interactive = getBooleanOption(options, 'interactive', true);
     return { name, template, database, port, author, description, interactive };
 };
@@ -122,7 +123,7 @@ const getQuestions = (name, defaults) => {
             type: 'input',
             name: 'description',
             message: 'Project description:',
-            default: defaults.description === '' ? `A new Zintrust project: ${name}` : defaults.description,
+            default: defaults.description === '' ? `A new ZinTrust project: ${name}` : defaults.description,
         },
     ];
 };
@@ -192,8 +193,9 @@ const promptForPackageManager = async (defaultPm) => {
 };
 const installDependencies = async (projectPath, log, packageManager, force = false) => {
     // Respect CI by default — avoid network installs in CI unless explicitly allowed
-    const isCi = Boolean(process.env['CI']);
-    const allowAuto = process.env['ZINTRUST_ALLOW_AUTO_INSTALL'] === '1' || force;
+    const ciRaw = readEnvString('CI').trim().toLowerCase();
+    const isCi = ciRaw !== '' && ciRaw !== '0' && ciRaw !== 'false';
+    const allowAuto = readEnvString('ZINTRUST_ALLOW_AUTO_INSTALL') === '1' || force;
     if (isCi && !allowAuto) {
         log.info('Skipping automatic dependency installation in CI environment.');
         return;
@@ -267,7 +269,7 @@ const resolveProjectTarget = async (options) => {
 };
 const createProject = async (target, options, command) => {
     const config = await command.getProjectConfig(target.name, options);
-    command.info(chalk.bold(`\n🚀 Creating new Zintrust project in ${target.display}...\n`));
+    command.info(chalk.bold(`\n🚀 Creating new ZinTrust project in ${target.display}...\n`));
     const overwrite = options['overwrite'] === true || options['force'] === true ? true : undefined;
     const result = await command.runScaffolding(target.basePath, target.name, config, overwrite);
     if (isFailureResult(result)) {
@@ -337,7 +339,7 @@ const createNewCommandInstance = () => {
     };
     const base = BaseCommand.create({
         name: 'new',
-        description: 'Create a new Zintrust project',
+        description: 'Create a new ZinTrust project',
         addOptions,
         execute: async (options) => {
             await executeImpl(options);

package/src/cli/commands/PublishCommand.d.ts

@@ -0,0 +1,5 @@
+import { type IBaseCommand } from '../BaseCommand';
+export declare const PublishCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+//# sourceMappingURL=PublishCommand.d.ts.map

package/src/cli/commands/PublishCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublishCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/PublishCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0DlE,eAAO,MAAM,cAAc;cACf,YAAY;EAmBtB,CAAC"}

package/src/cli/commands/PublishCommand.js

@@ -0,0 +1,54 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import fs from '../../node-singletons/fs.js';
+import path from '../../node-singletons/path.js';
+const publishQueueMonitorConfig = (cwd) => {
+    const targetPath = path.join(cwd, 'config', 'queueMonitor.ts');
+    if (fs.existsSync(targetPath)) {
+        Logger.warn('Configuration file already exists: config/queueMonitor.ts');
+        return;
+    }
+    // 1. Try resolving through node_modules (production usage)
+    const nodeModulesPath = path.join(cwd, 'node_modules', '@zintrust', 'queue-monitor', 'src', 'config', 'queueMonitor.ts');
+    // 2. Fallback for monorepo development (local usage)
+    const monorepoPath = path.join(cwd, 'packages', 'queue-monitor', 'src', 'config', 'queueMonitor.ts');
+    let sourcePath = '';
+    if (fs.existsSync(nodeModulesPath)) {
+        sourcePath = nodeModulesPath;
+    }
+    else if (fs.existsSync(monorepoPath)) {
+        sourcePath = monorepoPath;
+    }
+    else {
+        throw ErrorFactory.createCliError(`Could not locate source configuration file. Ensure @zintrust/queue-monitor is installed.`);
+    }
+    // Ensure config directory exists
+    const configDir = path.dirname(targetPath);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    fs.copyFileSync(sourcePath, targetPath);
+    Logger.info('Published configuration: config/queueMonitor.ts');
+};
+export const PublishCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'publish:config',
+            description: 'Publish configuration files from packages to your project',
+            aliases: ['p:config'],
+            addOptions: (command) => {
+                command.option('--queue-monitor', 'Publish Queue Monitor configuration');
+            },
+            execute: async (options) => {
+                const cwd = process.cwd();
+                if (options['queueMonitor'] !== undefined && options['queueMonitor'] !== null) {
+                    await publishQueueMonitorConfig(cwd); //NOSONAR
+                }
+                else {
+                    Logger.warn('Please specify a configuration to publish (e.g., --queue-monitor)');
+                }
+            },
+        });
+    },
+});