@zintrust/core 0.1.19 → 0.1.21

package/src/cli/CLI.js

@@ -5,9 +5,12 @@
 import { AddCommand } from './commands/AddCommand.js';
 import { BroadcastWorkCommand } from './commands/BroadcastWorkCommand.js';
 import { ConfigCommand } from './commands/ConfigCommand.js';
+import { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from './commands/CreateCommand.js';
 import { D1MigrateCommand } from './commands/D1MigrateCommand.js';
+import { DbSeedCommand } from './commands/DbSeedCommand.js';
 import { DebugCommand } from './commands/DebugCommand.js';
 import { FixCommand } from './commands/FixCommand.js';
+import { JwtDevCommand } from './commands/JwtDevCommand.js';
 import { KeyGenerateCommand } from './commands/KeyGenerateCommand.js';
 import { MakeMailTemplateCommand } from './commands/MakeMailTemplateCommand.js';
 import { MakeNotificationTemplateCommand } from './commands/MakeNotificationTemplateCommand.js';
@@ -18,6 +21,7 @@ import { PluginCommand } from './commands/PluginCommand.js';
 import { PrepareCommand } from './commands/PrepareCommand.js';
 import { QACommand } from './commands/QACommand.js';
 import { QueueCommand } from './commands/QueueCommand.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';
@@ -31,10 +35,6 @@ import { readFileSync } from '../node-singletons/fs.js';
 import { join } from '../node-singletons/path.js';
 import { Command } from 'commander';
 const __dirname = esmDirname(import.meta.url);
-/**
- * CLI - Main CLI Class
- * Orchestrates all CLI commands using Commander
- */
 /**
  * Load version from package.json
  */
@@ -72,11 +72,15 @@ const registerCommands = (program) => {
         UpgradeCommand.create(),
         PrepareCommand,
         AddCommand.create(),
+        CreateCommand.create(),
+        CreateMigrationCommand.create(),
+        AddMigrationCommand.create(),
         StartCommand.create(),
         QueueCommand.create(),
         BroadcastWorkCommand.create(),
         NotificationWorkCommand.create(),
         MigrateCommand.create(),
+        DbSeedCommand.create(),
         D1MigrateCommand.create(),
         DebugCommand.create(),
         SecretsCommand.create(),
@@ -89,6 +93,8 @@ const registerCommands = (program) => {
         TemplatesCommand,
         MakeMailTemplateCommand.create(),
         MakeNotificationTemplateCommand.create(),
+        RoutesCommand.create(),
+        JwtDevCommand,
     ];
     for (const command of commands) {
         program.addCommand(command.getCommand());

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

@@ -2,8 +2,8 @@
  * Add Command - Phase 4 Integration
  * Add services and features to existing Zintrust project
  */
-import { IBaseCommand } from '../BaseCommand';
-import { ResponseField } from '../scaffolding/ResponseFactoryGenerator';
+import type { IBaseCommand } from '../BaseCommand';
+import type { ResponseField } from '../scaffolding/ResponseFactoryGenerator';
 interface ServicePromptAnswers {
     name: string;
     domain: string;

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,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAO7E,OAAO,EAGL,aAAa,EACd,MAAM,2CAA2C,CAAC;AAsCnD,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;AAy/BD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;IAWtB;;;OAGG;;2CAx+B2C,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC;mCA2EhD,OAAO,CAAC,oBAAoB,CAAC;qCA8D3B,OAAO,CAAC,sBAAsB,CAAC;iCAmDnC,OAAO,CAAC,kBAAkB,CAAC;sCA4DtB,OAAO,CAAC,uBAAuB,CAAC;kCAwDpC,OAAO,CAAC,mBAAmB,CAAC;mCAkE3B,OAAO,CAAC,oBAAoB,CAAC;kCAuI9B,OAAO,CAAC,mBAAmB,CAAC;0CAkGpB,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+PtE,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,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"}

package/src/cli/commands/AddCommand.js

@@ -6,14 +6,17 @@ import { BaseCommand } from '../BaseCommand.js';
 import { ControllerGenerator } from '../scaffolding/ControllerGenerator.js';
 import { FactoryGenerator } from '../scaffolding/FactoryGenerator.js';
 import { FeatureScaffolder } from '../scaffolding/FeatureScaffolder.js';
+import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder.js';
 import { MigrationGenerator } from '../scaffolding/MigrationGenerator.js';
 import { ModelGenerator } from '../scaffolding/ModelGenerator.js';
 import { RequestFactoryGenerator } from '../scaffolding/RequestFactoryGenerator.js';
-import { ResponseFactoryGenerator, } from '../scaffolding/ResponseFactoryGenerator.js';
+import { ResponseFactoryGenerator } from '../scaffolding/ResponseFactoryGenerator.js';
 import { RouteGenerator } from '../scaffolding/RouteGenerator.js';
 import { SeederGenerator } from '../scaffolding/SeederGenerator.js';
 import { ServiceScaffolder } from '../scaffolding/ServiceScaffolder.js';
 import { WorkflowGenerator } from '../scaffolding/WorkflowGenerator.js';
+import { CommonUtils } from '../../common/index.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import fs from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
@@ -21,12 +24,14 @@ import { PluginManager } from '../../runtime/PluginManager.js';
 import inquirer from 'inquirer';
 const addOptions = (command) => {
     command
-        .argument('<type>', 'What to add: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, or workflow')
-        .argument('[name]', 'Name of service/feature/migration/model/controller/factory/seeder/requestfactory/responsefactory/workflow')
+        .argument('<type>', 'What to add: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, workflow, or governance')
+        .argument('[name]', 'Name of service/feature/migration/model/controller/factory/seeder/requestfactory/responsefactory/workflow (governance takes no name)')
         .option('--package-manager <pm>', 'Specify package manager to use when installing plugins (npm|yarn|pnpm)')
+        .option('--domain <name>', 'Service domain (e.g., ecommerce, payments) - for services')
         .option('--database <type>', 'Database (shared|isolated) - for services')
         .option('--auth <strategy>', 'Auth strategy (api-key|jwt|none|custom) - for services')
         .option('--port <number>', 'Service port - for services')
+        .option('--service <path>', 'Service path (relative to project root) - for features')
         .option('--with-test', 'Generate test files - for features')
         .option('--controller-type <type>', 'Controller type: crud, resource, api, graphql, websocket, webhook - for controllers')
         .option('--soft-delete', 'Add soft delete to model')
@@ -172,9 +177,31 @@ const promptMigrationConfig = async () => {
         },
     ]);
 };
-const addMigration = async (cmd, migrationName, opts) => {
+const pluralize = (snake) => (snake.endsWith('s') ? snake : `${snake}s`);
+const findMigrationBySuffix = (migrationsPath, suffix) => {
+    const files = FileGenerator.listFiles(migrationsPath, false);
+    for (const file of files) {
+        if (path.basename(file).endsWith(suffix))
+            return file;
+    }
+    return undefined;
+};
+const buildCreateTableMigrationName = (model) => {
+    const modelSnake = CommonUtils.toSnakeCase(model).replaceAll(/[^a-z0-9_]+/g, '_');
+    const tablePlural = pluralize(modelSnake);
+    return `create_${tablePlural}_table`;
+};
+const buildAddColumnMigrationName = (column, model) => {
+    const colSnake = CommonUtils.toSnakeCase(column).replaceAll(/[^a-z0-9_]+/g, '_');
+    const modelSnake = CommonUtils.toSnakeCase(model).replaceAll(/[^a-z0-9_]+/g, '_');
+    const tablePlural = pluralize(modelSnake);
+    return `add_${colSnake}_${tablePlural}_table`;
+};
+const addMigration = async (cmd, migrationArgs, opts) => {
     const projectRoot = process.cwd();
-    let name = migrationName ?? '';
+    let name = migrationArgs[0] ?? '';
+    let table;
+    let column;
     if (name === '' && opts.noInteractive !== true) {
         const answers = await promptMigrationConfig();
         name = answers.name;
@@ -184,11 +211,32 @@ const addMigration = async (cmd, migrationName, opts) => {
         throw ErrorFactory.createValidationError('Migration name is required');
     }
     const migrationsPath = path.join(projectRoot, 'database', 'migrations');
+    // New shorthand semantics:
+    // `zin add migration <column> <model>` => add_<column>_<models>_table
+    if (migrationArgs.length >= 2) {
+        const columnArg = migrationArgs[0] ?? '';
+        const modelArg = migrationArgs[1] ?? '';
+        if (columnArg === '' || modelArg === '') {
+            throw ErrorFactory.createValidationError('Usage: zin add migration <column> <model>');
+        }
+        const createName = buildCreateTableMigrationName(modelArg);
+        const createSuffix = `_${createName}.ts`;
+        const existingCreate = findMigrationBySuffix(migrationsPath, createSuffix);
+        if (existingCreate === undefined) {
+            throw ErrorFactory.createCliError(`Missing required create migration for model '${modelArg}'. Create it first: zin create migration ${modelArg}`);
+        }
+        name = buildAddColumnMigrationName(columnArg, modelArg);
+        table = pluralize(CommonUtils.toSnakeCase(modelArg).replaceAll(/[^a-z0-9_]+/g, '_'));
+        // Store the normalized column name for generator placeholder.
+        column = CommonUtils.toSnakeCase(columnArg).replaceAll(/[^a-z0-9_]+/g, '_');
+    }
     cmd.info(`Creating migration: ${name}...`);
     const result = await MigrationGenerator.generateMigration({
         name,
         migrationsPath,
-        type: (opts.type ?? 'create'),
+        type: opts.type ?? undefined,
+        table,
+        column,
     });
     if (result.success === false)
         throw ErrorFactory.createCliError(result.message);
@@ -386,6 +434,7 @@ const addFactory = async (cmd, factoryName, opts) => {
         throw ErrorFactory.createValidationError('Model name is required for factory generation');
     }
     const factoriesPath = path.join(projectRoot, 'database', 'factories');
+    ensureDirectoryExists(factoriesPath);
     cmd.info(`Creating factory: ${config.name} for model ${config.modelName}...`);
     const result = await FactoryGenerator.generateFactory({
         factoryName: config.name,
@@ -426,6 +475,11 @@ const displaySeederSuccess = (cmd, name, count, filePath, states, relationships)
     }
     cmd.info(`\nOther methods:\n  await ${name}.reset()            // Truncate table\n  await ${name}.runWithTruncate()  // Reset and seed`);
 };
+const displayDatabaseSeederSuccess = (cmd, filePath) => {
+    cmd.success(`Seeder 'DatabaseSeeder' created successfully!`);
+    cmd.info(`File: ${path.basename(filePath)}`);
+    cmd.info(`\nNext steps:\n  • Add additional seeders into this directory\n  • Run: zin db:seed`);
+};
 const promptSeederConfig = async () => {
     return inquirer.prompt([
         {
@@ -438,6 +492,7 @@ const promptSeederConfig = async () => {
             type: 'input',
             name: 'model',
             message: 'Model name (e.g., User, Post):',
+            when: (ans) => ans.name !== 'DatabaseSeeder',
             validate: (v) => /^[A-Z][a-zA-Z\d]*$/.test(v) || 'Must be PascalCase',
         },
         {
@@ -445,6 +500,7 @@ const promptSeederConfig = async () => {
             name: 'count',
             message: 'Number of records to seed (1-100,000):',
             default: '100',
+            when: (ans) => ans.name !== 'DatabaseSeeder',
             validate: (v) => {
                 const num = Number.parseInt(v, 10);
                 return (num >= 1 && num <= 100000) || 'Must be between 1 and 100,000';
@@ -455,18 +511,21 @@ const promptSeederConfig = async () => {
             name: 'states',
             message: 'Use state distribution (50% active, 30% inactive, 20% deleted)?',
             default: false,
+            when: (ans) => ans.name !== 'DatabaseSeeder',
         },
         {
             type: 'confirm',
             name: 'relationships',
             message: 'Seed with relationships?',
             default: false,
+            when: (ans) => ans.name !== 'DatabaseSeeder',
         },
         {
             type: 'confirm',
             name: 'truncate',
             message: 'Truncate table before seeding?',
             default: true,
+            when: (ans) => ans.name !== 'DatabaseSeeder',
         },
     ]);
 };
@@ -487,11 +546,19 @@ const addSeeder = async (cmd, seederName, opts) => {
     else if (config.name === '') {
         throw ErrorFactory.createValidationError('Seeder name is required');
     }
+    const seedersPath = path.join(projectRoot, 'database', 'seeders');
+    ensureDirectoryExists(seedersPath);
+    if (config.name === 'DatabaseSeeder') {
+        cmd.info('Creating seeder: DatabaseSeeder...');
+        const result = await SeederGenerator.generateDatabaseSeeder({ seedersPath });
+        if (result.success === false)
+            throw ErrorFactory.createCliError(result.message);
+        displayDatabaseSeederSuccess(cmd, result.filePath);
+        return;
+    }
     if (config.modelName === '') {
         throw ErrorFactory.createValidationError('Model name is required for seeder generation');
     }
-    const seedersPath = path.join(projectRoot, 'database', 'seeders');
-    ensureDirectoryExists(seedersPath);
     cmd.info(`Creating seeder: ${config.name} for model ${config.modelName}...`);
     const result = await SeederGenerator.generateSeeder({
         seederName: config.name,
@@ -739,48 +806,65 @@ const addWorkflow = async (cmd, workflowName, opts) => {
         throw ErrorFactory.createCliError(result.message);
     cmd.success(result.message);
 };
+const addGovernance = async (cmd, name, opts) => {
+    if (typeof name === 'string' && name.trim() !== '') {
+        throw ErrorFactory.createValidationError('governance does not take a name argument. Usage: zin add governance');
+    }
+    const projectRoot = process.cwd();
+    cmd.info('Installing governance tooling (ESLint + architecture tests)...');
+    const result = await GovernanceScaffolder.scaffold(projectRoot, {
+        writeEslintConfig: true,
+        writeArchTests: true,
+        install: true,
+        packageManager: opts.packageManager,
+    });
+    if (result.success === false) {
+        throw ErrorFactory.createCliError(result.message ?? 'Governance installation failed', result);
+    }
+    cmd.success('Governance installed successfully!');
+    if (result.filesCreated.length > 0) {
+        cmd.info(`Files created: ${result.filesCreated.length}`);
+    }
+};
+const TYPE_HANDLERS = {
+    service: addService,
+    feature: addFeature,
+    migration: async (cmd, name, opts) => addMigration(cmd, typeof name === 'string' && name.length > 0 ? [name] : [], opts),
+    model: addModel,
+    controller: addController,
+    routes: addRoutes,
+    factory: addFactory,
+    seeder: addSeeder,
+    requestfactory: addRequestFactory,
+    'request-factory': addRequestFactory,
+    responsefactory: addResponseFactory,
+    'response-factory': addResponseFactory,
+    workflow: addWorkflow,
+    governance: addGovernance,
+};
 const handleType = async (cmd, type, name, opts) => {
-    switch (type) {
-        case 'service':
-            await addService(cmd, name, opts);
-            break;
-        case 'feature':
-            await addFeature(cmd, name, opts);
-            break;
-        case 'migration':
-            await addMigration(cmd, name, opts);
-            break;
-        case 'model':
-            await addModel(cmd, name, opts);
-            break;
-        case 'controller':
-            await addController(cmd, name, opts);
-            break;
-        case 'routes':
-            await addRoutes(cmd, name, opts);
-            break;
-        case 'factory':
-            await addFactory(cmd, name, opts);
-            break;
-        case 'seeder':
-            await addSeeder(cmd, name, opts);
-            break;
-        case 'requestfactory':
-        case 'request-factory':
-            await addRequestFactory(cmd, name, opts);
-            break;
-        case 'responsefactory':
-        case 'response-factory':
-            await addResponseFactory(cmd, name, opts);
-            break;
-        case 'workflow':
-            await addWorkflow(cmd, name, opts);
-            break;
-        default:
-            throw ErrorFactory.createCliError(`Unknown type "${type}". Use: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, or workflow`);
+    const handler = TYPE_HANDLERS[type];
+    if (handler === undefined) {
+        throw ErrorFactory.createCliError(`Unknown type "${type}". Use: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, workflow, or governance`);
     }
+    await handler(cmd, name, opts);
 };
 const getArgs = (args) => Array.isArray(args) ? args : undefined;
+const installPlugin = async (cmd, type, name, addOpts) => {
+    const normalizedType = type.toLowerCase();
+    if (name !== undefined && name.length > 0) {
+        throw ErrorFactory.createCliError(`"${type}" looks like a plugin id. Run: zin add ${type} (without a name argument).`);
+    }
+    cmd.info(`Installing plugin: ${normalizedType}...`);
+    const pm = typeof addOpts.packageManager === 'string' ? addOpts.packageManager : undefined;
+    if (pm === undefined) {
+        await PluginManager.install(normalizedType);
+    }
+    else {
+        await PluginManager.install(normalizedType, { packageManager: pm });
+    }
+    cmd.success(`Plugin '${normalizedType}' installed successfully!`);
+};
 const executeAdd = async (cmd, options) => {
     const command = cmd.getCommand();
     const args = getArgs(options.args) ?? getArgs(command.args) ?? [];
@@ -795,18 +879,11 @@ const executeAdd = async (cmd, options) => {
         // Planned modular adapter syntax: `zin add db:sqlite` (delegate to plugin installer)
         const normalizedType = type.toLowerCase();
         if (normalizedType.includes(':')) {
-            if (name !== undefined && name.length > 0) {
-                throw ErrorFactory.createCliError(`"${type}" looks like a plugin id. Run: zin add ${type} (without a name argument).`);
-            }
-            cmd.info(`Installing plugin: ${normalizedType}...`);
-            const pm = typeof addOpts.packageManager === 'string' ? addOpts.packageManager : undefined;
-            if (pm === undefined) {
-                await PluginManager.install(normalizedType);
-            }
-            else {
-                await PluginManager.install(normalizedType, { packageManager: pm });
-            }
-            cmd.success(`Plugin '${normalizedType}' installed successfully!`);
+            await installPlugin(cmd, type, name, addOpts);
+            return;
+        }
+        if (normalizedType === 'migration') {
+            await addMigration(cmd, args.slice(1), addOpts);
             return;
         }
         await handleType(cmd, normalizedType, name, addOpts);

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

@@ -2,7 +2,7 @@
  * Config Command - Configuration management CLI command
  * Handles configuration operations: get, set, list, reset, edit, export
  */
-import { IBaseCommand } from '../BaseCommand';
+import type { IBaseCommand } from '../BaseCommand';
 /**
  * Config Command Factory
  */

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

@@ -1 +1 @@
-{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiV7E;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}
+{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmVrE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Create Command
+ * Shortcuts for common scaffolding tasks.
+ */
+import { type IBaseCommand } from '../BaseCommand';
+export declare const CreateCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export declare const CreateMigrationCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export declare const AddMigrationCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+//# sourceMappingURL=CreateCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/CreateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+HvF,eAAO,MAAM,aAAa;cACd,YAAY;EAUtB,CAAC;AAEH,eAAO,MAAM,sBAAsB;cACvB,YAAY;EAatB,CAAC;AAEH,eAAO,MAAM,mBAAmB;cACpB,YAAY;EActB,CAAC"}

package/src/cli/commands/CreateCommand.js

@@ -0,0 +1,143 @@
+/**
+ * Create Command
+ * Shortcuts for common scaffolding tasks.
+ */
+import { BaseCommand } from '../BaseCommand.js';
+import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { MigrationGenerator } from '../scaffolding/MigrationGenerator.js';
+import { CommonUtils } from '../../common/index.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import * as path from '../../node-singletons/path.js';
+const pluralize = (snake) => (snake.endsWith('s') ? snake : `${snake}s`);
+const buildCreateTableMigrationName = (model) => {
+    const modelSnake = CommonUtils.toSnakeCase(model).replaceAll(/[^a-z0-9_]+/g, '_');
+    const tablePlural = pluralize(modelSnake);
+    return `create_${tablePlural}_table`;
+};
+const buildAddColumnMigrationName = (column, model) => {
+    const colSnake = CommonUtils.toSnakeCase(column).replaceAll(/[^a-z0-9_]+/g, '_');
+    const modelSnake = CommonUtils.toSnakeCase(model).replaceAll(/[^a-z0-9_]+/g, '_');
+    const tablePlural = pluralize(modelSnake);
+    return `add_${colSnake}_${tablePlural}_table`;
+};
+const findMigrationBySuffix = (migrationsPath, suffix) => {
+    const files = FileGenerator.listFiles(migrationsPath, false);
+    for (const file of files) {
+        if (path.basename(file).endsWith(suffix))
+            return file;
+    }
+    return undefined;
+};
+const addOptions = (command) => {
+    command
+        .argument('<type>', 'What to create (currently: migration)')
+        .argument('<name>', 'Name (for migration: model name like "user")');
+    // Accepted for consistency with other CLI commands.
+    command.option('--no-interactive', 'Skip interactive prompts');
+};
+const executeCreate = async (cmd, options) => {
+    const args = Array.isArray(options.args) ? options.args : [];
+    const type = args[0];
+    const name = args[1];
+    if (type !== 'migration') {
+        throw ErrorFactory.createCliError('Usage: zin create migration <model>');
+    }
+    if (typeof name !== 'string' || name.trim() === '') {
+        throw ErrorFactory.createValidationError('Model name is required');
+    }
+    const projectRoot = process.cwd();
+    const migrationsPath = path.join(projectRoot, 'database', 'migrations');
+    const migrationName = buildCreateTableMigrationName(name);
+    const tableName = pluralize(CommonUtils.toSnakeCase(name).replaceAll(/[^a-z0-9_]+/g, '_'));
+    cmd.info(`Creating migration: ${migrationName}...`);
+    const result = await MigrationGenerator.generateMigration({
+        name: migrationName,
+        migrationsPath,
+        type: 'create',
+        table: tableName,
+    });
+    if (result.success === false)
+        throw ErrorFactory.createCliError(result.message);
+    cmd.success('Migration created successfully!');
+    cmd.info(`File: ${path.basename(result.filePath)}`);
+};
+const executeCm = async (cmd, options) => {
+    const args = Array.isArray(options.args) ? options.args : [];
+    const model = args[0];
+    if (typeof model !== 'string' || model.trim() === '') {
+        throw ErrorFactory.createCliError('Usage: zin cm <model>');
+    }
+    await executeCreate(cmd, { ...options, args: ['migration', model] });
+};
+const executeAm = async (cmd, options) => {
+    const args = Array.isArray(options.args) ? options.args : [];
+    const column = args[0];
+    const model = args[1];
+    if (typeof column !== 'string' ||
+        column.trim() === '' ||
+        typeof model !== 'string' ||
+        model.trim() === '') {
+        throw ErrorFactory.createCliError('Usage: zin am <column> <model>');
+    }
+    const projectRoot = process.cwd();
+    const migrationsPath = path.join(projectRoot, 'database', 'migrations');
+    const tableName = pluralize(CommonUtils.toSnakeCase(model).replaceAll(/[^a-z0-9_]+/g, '_'));
+    const createName = buildCreateTableMigrationName(model);
+    const existingCreate = findMigrationBySuffix(migrationsPath, `_${createName}.ts`);
+    if (existingCreate === undefined) {
+        throw ErrorFactory.createCliError(`Missing required create migration for model '${model}'. Create it first: zin cm ${model}`);
+    }
+    const migrationName = buildAddColumnMigrationName(column, model);
+    cmd.info(`Creating migration: ${migrationName}...`);
+    const result = await MigrationGenerator.generateMigration({
+        name: migrationName,
+        migrationsPath,
+        // Let generator infer type from name (add_* => alter)
+        table: tableName,
+        column: CommonUtils.toSnakeCase(column).replaceAll(/[^a-z0-9_]+/g, '_'),
+    });
+    if (result.success === false)
+        throw ErrorFactory.createCliError(result.message);
+    cmd.success('Migration created successfully!');
+    cmd.info(`File: ${path.basename(result.filePath)}`);
+};
+export const CreateCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'create',
+            description: 'Create resources (e.g. migrations) with opinionated naming',
+            addOptions,
+            execute: async (options) => executeCreate(cmd, options),
+        });
+        return cmd;
+    },
+});
+export const CreateMigrationCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'cm',
+            description: 'Shortcut: create migration for a model (create_<models>_table)',
+            addOptions: (command) => {
+                command.argument('<model>', 'Model name (e.g. user)');
+                command.option('--no-interactive', 'Skip interactive prompts');
+            },
+            execute: async (options) => executeCm(cmd, options),
+        });
+        return cmd;
+    },
+});
+export const AddMigrationCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'am',
+            description: 'Shortcut: add column migration for a model (add_<col>_<models>_table)',
+            addOptions: (command) => {
+                command.argument('<column>', 'Column name (e.g. bio)');
+                command.argument('<model>', 'Model name (e.g. user)');
+                command.option('--no-interactive', 'Skip interactive prompts');
+            },
+            execute: async (options) => executeAm(cmd, options),
+        });
+        return cmd;
+    },
+});

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

@@ -2,7 +2,7 @@
  * D1 Migrate Command
  * Run Cloudflare D1 migrations using Wrangler
  */
-import { IBaseCommand } from '../BaseCommand';
+import type { IBaseCommand } from '../BaseCommand';
 /**
  * D1 Migrate Command
  * Run Cloudflare D1 migrations using Wrangler

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

@@ -1 +1 @@
-{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsD7E;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAqBtB,CAAC"}
+{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyDrE;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAwBtB,CAAC"}

package/src/cli/commands/D1MigrateCommand.js

@@ -1,31 +1,27 @@
-/**
- * D1 Migrate Command
- * Run Cloudflare D1 migrations using Wrangler
- */
 import { BaseCommand } from '../BaseCommand.js';
+import { WranglerD1 } from '../d1/WranglerD1.js';
 import { resolveNpmPath } from '../../common/index.js';
 import { appConfig } from '../../config/app.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-import { execFileSync } from '../../node-singletons/child-process.js';
-// eslint-disable-next-line @typescript-eslint/require-await
+const RESOLVED_VOID = Promise.resolve();
 const runWrangler = async (cmd, args) => {
-    const npmPath = resolveNpmPath();
-    cmd.debug(`Executing: npm exec --yes -- wrangler ${args.join(' ')}`);
-    const result = execFileSync(npmPath, ['exec', '--yes', '--', 'wrangler', ...args], {
-        stdio: 'pipe',
-        encoding: 'utf8',
-        env: appConfig.getSafeEnv(),
-    });
-    return result;
+    // Back-compat entrypoint for tests; we only use this for D1 migrations apply.
+    const dbName = args[3];
+    const mode = args[4];
+    const isLocal = mode === '--local';
+    await RESOLVED_VOID;
+    return WranglerD1.applyMigrations({ cmd, dbName, isLocal });
 };
 const executeD1Migrate = async (cmd, options) => {
     const isLocal = options['local'] === true || options['remote'] !== true;
-    const dbName = typeof options['database'] === 'string' ? options['database'] : 'zintrust_db';
-    const target = isLocal ? '--local' : '--remote';
+    const dbName = typeof options['database'] === 'string' && options['database'].trim() !== ''
+        ? options['database']
+        : 'zintrust_db';
     cmd.info(`Running D1 migrations for ${dbName} (${isLocal ? 'local' : 'remote'})...`);
+    await RESOLVED_VOID;
     try {
-        const output = await runWrangler(cmd, ['d1', 'migrations', 'apply', dbName, target]);
+        const output = WranglerD1.applyMigrations({ cmd, dbName, isLocal });
         if (output !== '')
             cmd.info(output);
         cmd.info('✓ D1 migrations completed successfully');
@@ -57,9 +53,9 @@ export const D1MigrateCommand = Object.freeze({
     create() {
         const addOptions = (command) => {
             command
-                .option('--local', 'Run migrations against local D1 database')
-                .option('--remote', 'Run migrations against remote D1 database')
-                .option('--database <name>', 'D1 database name', 'zintrust_db');
+                .option('--local', 'Run against local D1 database (via wrangler dev)')
+                .option('--remote', 'Run against remote D1 database (production)')
+                .option('--database <name>', 'Wrangler D1 database binding name (from wrangler.toml). Defaults to "zintrust_db"');
         };
         const cmd = BaseCommand.create({
             name: 'd1:migrate',

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

@@ -0,0 +1,9 @@
+/**
+ * Db Seed Command
+ * Run database seeders from database/seeders
+ */
+import type { IBaseCommand } from '../BaseCommand';
+export declare const DbSeedCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+//# sourceMappingURL=DbSeedCommand.d.ts.map