@zintrust/core 0.1.21 → 0.1.23

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.js

@@ -17,7 +17,7 @@ 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.');

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;AAGH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAidrE;;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;AAkdrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateCommand.js

@@ -2,7 +2,6 @@
  * Migrate Command
  * Run database migrations
  */
-import { Migrator } from '../../migrations/Migrator.js';
 import { BaseCommand } from '../BaseCommand.js';
 import { D1SqlMigrations } from '../d1/D1SqlMigrations.js';
 import { WranglerConfig } from '../d1/WranglerConfig.js';
@@ -11,6 +10,7 @@ import { PromptHelper } from '../PromptHelper.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';
 import { Database } from '../../orm/Database.js';
 import { DatabaseAdapterRegistry } from '../../orm/DatabaseAdapterRegistry.js';

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;AAkOrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateWorkerCommand.js

@@ -0,0 +1,182 @@
+/**
+ * Migrate Worker Command
+ * Run worker package migrations
+ */
+import { BaseCommand } from '../BaseCommand.js';
+import { PromptHelper } from '../PromptHelper.js';
+import { databaseConfig } from '../../config/database.js';
+import { Env } from '../../config/env.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 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 isDestructiveAction = (options) => options['fresh'] === true || options['reset'] === true || options['rollback'] === true;
+const parseRollbackSteps = (options) => {
+    const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
+    return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
+};
+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 worker migrations${destructive ? ' (destructive)' : ''}?`, false, interactive);
+    if (!confirmed) {
+        cmd.warn('Cancelled.');
+        return false;
+    }
+    return 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, options['force'] === true);
+    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;AAmQhD,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

@@ -5,6 +5,7 @@ import { ProjectScaffolder } from '../scaffolding/ProjectScaffolder.js';
 import { SpawnUtil } from '../utils/spawn.js';
 import { extractErrorMessage, resolvePackageManager } from '../../common/index.js';
 import { appConfig } from '../../config/app.js';
+import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { execFileSync } from '../../node-singletons/child-process.js';
 import * as path from '../../node-singletons/path.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,21 @@ 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 readEnvString = (key) => {
+        const anyEnv = Env;
+        const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
+        if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
+            return fromEnv;
+        if (typeof process !== 'undefined') {
+            const raw = process.env?.[key];
+            if (typeof raw === 'string')
+                return raw;
+        }
+        return fromEnv ?? '';
+    };
+    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 +281,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 +351,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)');
+                }
+            },
+        });
+    },
+});

package/src/cli/commands/QACommand.js

@@ -331,7 +331,7 @@ const generateQAReport = (results) => {
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Zintrust QA Report</title>
+    <title>ZinTrust QA Report</title>
     <link rel="stylesheet" href="base.css">
     <link rel="stylesheet" href="qa-report.css">
 </head>
@@ -339,7 +339,7 @@ const generateQAReport = (results) => {
     <main class="qa-shell">
       <section class="qa-panel">
         <header class="qa-hero">
-          <h1 class="qa-title">Zintrust QA Report</h1>
+          <h1 class="qa-title">ZinTrust QA Report</h1>
           <p class="qa-subtitle">Quality Assurance Suite Results</p>
           <div class="qa-meta">Generated on ${timestamp}</div>
         </header>
@@ -360,7 +360,7 @@ const generateQAReport = (results) => {
           </div>
         </div>
 
-        <footer class="qa-footer">Zintrust Framework QA Suite | Generated automatically</footer>
+        <footer class="qa-footer">ZinTrust Framework QA Suite | Generated automatically</footer>
       </section>
     </main>
 </body>
@@ -430,7 +430,7 @@ const addOptions = (command) => {
 };
 const executeQA = async (qa, options) => {
     try {
-        qa.info('Starting Zintrust QA Suite...');
+        qa.info('Starting ZinTrust QA Suite...');
         const results = createResults();
         await qa.runLint(results.lint);
         await qa.runTypeCheck(results.typeCheck);

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

@@ -0,0 +1,6 @@
+/**
+ * Resource Control Command
+ * Control the resource monitor (start/stop) on the running worker service via HTTP
+ */
+export declare const ResourceControlCommand: import("../BaseCommand").IBaseCommand;
+//# sourceMappingURL=ResourceControlCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceControlCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ResourceControlCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,eAAO,MAAM,sBAAsB,yCAuCjC,CAAC"}

package/src/cli/commands/ResourceControlCommand.js

@@ -0,0 +1,43 @@
+/**
+ * Resource Control Command
+ * Control the resource monitor (start/stop) on the running worker service via HTTP
+ */
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { BaseCommand } from '../BaseCommand.js';
+import { Logger } from '../../config/logger.js';
+export const ResourceControlCommand = BaseCommand.create({
+    name: 'resource:monitor',
+    description: 'Control the resource monitor (start/stop) on the running worker service',
+    aliases: ['rm'],
+    addOptions: (cmd) => {
+        cmd.argument('<action>', 'Action to perform: start or stop');
+        cmd.option('--port <port>', 'Worker service port', '7777');
+        cmd.option('--host <host>', 'Worker service host', '127.0.0.1');
+    },
+    execute: async (options) => {
+        const action = options.args?.[0];
+        const port = options['port'] ?? '7777';
+        const host = options['host'] ?? '127.0.0.1';
+        if (action === undefined || !['start', 'stop'].includes(action)) {
+            Logger.error('Invalid action. Use "start" or "stop".');
+            return;
+        }
+        const url = `http://${host}:${port}/api/resources/${action}`;
+        try {
+            Logger.info(`Sending ${action} request to ${url}...`);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+            });
+            if (!response.ok) {
+                throw ErrorFactory.createCliError(`HTTP ${response.status}: ${await response.text()}`);
+            }
+            const data = (await response.json());
+            Logger.info(`Success: ${data.message}`);
+        }
+        catch (e) {
+            Logger.error(`Failed to ${action} resource monitor: ${e.message}`);
+            Logger.info('Ensure the worker service is running and the port is correct.');
+        }
+    },
+});

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

@@ -1,6 +1,6 @@
 /**
  * Simulate Command
- * Internal dev tool that generates a simulated Zintrust app under ./simulate/
+ * Internal dev tool that generates a simulated ZinTrust app under ./simulate/
  * IMPORTANT: this uses the same ProjectScaffolder as `zin new`.
  * Usage: zin -sim my-blog
  */