@constructive-io/cli 0.0.2 → 5.1.0

package/esm/commands/migrate/init.js

@@ -1,63 +0,0 @@
-import { LaunchQLMigrate } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../../utils/database';
-const log = new Logger('migrate-init');
-export default async (argv, prompter, _options) => {
-    const pgEnv = getPgEnvOptions();
-    // Get target database
-    const database = await getTargetDatabase(argv, prompter, {
-        message: 'Select database to initialize migration tracking'
-    });
-    const questions = [
-        {
-            name: 'yes',
-            type: 'confirm',
-            message: `Initialize constructive migration schema in database "${database}"?`,
-            required: true
-        }
-    ];
-    const { yes } = await prompter.prompt(argv, questions);
-    if (!yes) {
-        log.info('Operation cancelled.');
-        return;
-    }
-    log.info(`Initializing migration schema in database ${database}...`);
-    const config = {
-        host: pgEnv.host,
-        port: pgEnv.port,
-        user: pgEnv.user,
-        password: pgEnv.password,
-        database
-    };
-    const client = new LaunchQLMigrate(config);
-    try {
-        await client.initialize();
-        log.success('Migration schema initialized successfully.');
-        // Check if there's an existing Sqitch deployment to import
-        const hasSquitch = await client.hasSqitchTables();
-        if (hasSquitch) {
-            const { importSquitch } = await prompter.prompt(argv, [
-                {
-                    name: 'importSquitch',
-                    type: 'confirm',
-                    message: 'Existing Sqitch deployment detected. Import it?',
-                    required: true
-                }
-            ]);
-            if (importSquitch) {
-                log.info('Importing Sqitch deployment history...');
-                await client.importFromSqitch();
-                log.success('Sqitch deployment imported successfully.');
-            }
-        }
-    }
-    catch (error) {
-        log.error(`Failed to initialize migration schema: ${error instanceof Error ? error.message : error}`);
-        throw error;
-    }
-    finally {
-        await client.close();
-    }
-    return argv;
-};

package/esm/commands/migrate/list.js

@@ -1,83 +0,0 @@
-import { LaunchQLMigrate } from '@launchql/core';
-import { parsePlanFile } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../../utils/database';
-const log = new Logger('migrate-list');
-export default async (argv, prompter, options) => {
-    const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'pgpm.plan');
-    if (!existsSync(planPath)) {
-        log.error(`No pgpm.plan found in ${cwd}`);
-        process.exit(1);
-    }
-    // Get database configuration
-    const pgEnv = getPgEnvOptions();
-    const targetDatabase = await getTargetDatabase(argv, prompter, {
-        message: 'Select database to list migrations'
-    });
-    const client = new LaunchQLMigrate({
-        host: pgEnv.host,
-        port: pgEnv.port,
-        user: pgEnv.user,
-        password: pgEnv.password,
-        database: pgEnv.database
-    });
-    try {
-        // Get all changes from plan file
-        const planResult = parsePlanFile(planPath);
-        if (!planResult.data || planResult.errors.length > 0) {
-            log.error('Failed to parse plan file:', planResult.errors);
-            process.exit(1);
-        }
-        const plan = planResult.data;
-        const allChanges = plan.changes;
-        // Get deployed changes from database
-        const deployedChanges = await client.getDeployedChanges(targetDatabase, plan.package);
-        console.log('\n📋 All Changes\n');
-        console.log(`Package: ${plan.package}`);
-        console.log(`Total Changes: ${allChanges.length}`);
-        console.log(`Deployed: ${deployedChanges.length}`);
-        console.log(`Pending: ${allChanges.length - deployedChanges.length}\n`);
-        // Create a map for quick lookup
-        const deployedMap = new Map(deployedChanges.map(c => [c.change_name, c]));
-        // List all changes with their status
-        const showAll = argv.all || allChanges.length <= 20;
-        const changesToShow = showAll ? allChanges : allChanges.slice(0, 20);
-        console.log('Status  Change Name                    Dependencies');
-        console.log('------  -----------------------------  --------------------------------');
-        changesToShow.forEach(change => {
-            const deployed = deployedMap.get(change.name);
-            const status = deployed ? '✅' : '⏳';
-            const deps = change.dependencies.length > 0 ? change.dependencies.join(', ') : '-';
-            const depsDisplay = deps.length > 30 ? deps.substring(0, 27) + '...' : deps;
-            console.log(`${status}      ${change.name.padEnd(30)} ${depsDisplay}`);
-        });
-        if (!showAll && allChanges.length > 20) {
-            console.log(`\n... and ${allChanges.length - 20} more changes. Use --all to see all changes.`);
-        }
-        // Show summary by status
-        if (argv.summary !== false) {
-            console.log('\n📊 Summary by Status:\n');
-            const pending = allChanges.filter(c => !deployedMap.has(c.name));
-            const deployed = allChanges.filter(c => deployedMap.has(c.name));
-            console.log(`✅ Deployed: ${deployed.length}`);
-            console.log(`⏳ Pending:  ${pending.length}`);
-            // Show deployment timeline
-            if (deployedChanges.length > 0) {
-                const sortedDeployed = [...deployedChanges].sort((a, b) => new Date(a.deployed_at).getTime() - new Date(b.deployed_at).getTime());
-                const firstDeploy = new Date(sortedDeployed[0].deployed_at);
-                const lastDeploy = new Date(sortedDeployed[sortedDeployed.length - 1].deployed_at);
-                console.log(`\n📅 Deployment Timeline:`);
-                console.log(`   First: ${firstDeploy.toLocaleString()}`);
-                console.log(`   Last:  ${lastDeploy.toLocaleString()}`);
-            }
-        }
-    }
-    catch (error) {
-        log.error('Failed to list changes:', error);
-        process.exit(1);
-    }
-};

package/esm/commands/migrate/status.js

@@ -1,92 +0,0 @@
-import { LaunchQLMigrate } from '@launchql/core';
-import { parsePlanFile } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../../utils/database';
-const log = new Logger('migrate-status');
-export default async (argv, prompter, options) => {
-    const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'pgpm.plan');
-    if (!existsSync(planPath)) {
-        log.error(`No pgpm.plan found in ${cwd}`);
-        process.exit(1);
-    }
-    // Get database configuration
-    const pgEnv = getPgEnvOptions();
-    const targetDatabase = await getTargetDatabase(argv, prompter, {
-        message: 'Select database to check migration status'
-    });
-    const client = new LaunchQLMigrate({
-        host: pgEnv.host,
-        port: pgEnv.port,
-        user: pgEnv.user,
-        password: pgEnv.password,
-        database: pgEnv.database
-    });
-    try {
-        // Parse plan file to get package name
-        const planResult = parsePlanFile(planPath);
-        if (!planResult.data || planResult.errors.length > 0) {
-            log.error('Failed to parse plan file:', planResult.errors);
-            process.exit(1);
-        }
-        const plan = planResult.data;
-        // Switch to target database
-        const targetClient = new LaunchQLMigrate({
-            host: pgEnv.host,
-            port: pgEnv.port,
-            user: pgEnv.user,
-            password: pgEnv.password,
-            database: targetDatabase
-        });
-        const statusResults = await targetClient.status(plan.package);
-        console.log('\n📊 Migration Status\n');
-        console.log(`Database: ${targetDatabase}`);
-        if (statusResults.length > 0) {
-            const status = statusResults[0];
-            console.log(`Package: ${status.package}`);
-            console.log(`Total Deployed: ${status.totalDeployed}`);
-            if (status.lastChange) {
-                console.log(`Last Change: ${status.lastChange}`);
-                console.log(`Last Deployed: ${status.lastDeployed.toLocaleString()}`);
-            }
-            else {
-                console.log('No changes deployed yet');
-            }
-        }
-        else {
-            console.log(`Package: ${plan.package}`);
-            console.log('No deployment history found');
-        }
-        // Show recent changes
-        const recentChanges = await targetClient.getRecentChanges(targetDatabase, 5);
-        if (recentChanges.length > 0) {
-            console.log('\n📋 Recent Changes:\n');
-            recentChanges.forEach((change) => {
-                const status = change.deployed_at ? '✅' : '⏳';
-                const date = change.deployed_at ? new Date(change.deployed_at).toLocaleString() : 'Not deployed';
-                console.log(`${status} ${change.change_name.padEnd(30)} ${date}`);
-            });
-        }
-        // Show pending changes
-        const pendingChanges = await targetClient.getPendingChanges(planPath, targetDatabase);
-        if (pendingChanges.length > 0) {
-            console.log(`\n⏳ Pending Changes: ${pendingChanges.length}\n`);
-            pendingChanges.slice(0, 5).forEach((change) => {
-                console.log(`   - ${change}`);
-            });
-            if (pendingChanges.length > 5) {
-                console.log(`   ... and ${pendingChanges.length - 5} more`);
-            }
-        }
-        else {
-            console.log('\n✅ All changes deployed');
-        }
-    }
-    catch (error) {
-        log.error('Failed to get migration status:', error);
-        process.exit(1);
-    }
-};

package/esm/commands/migrate.js

@@ -1,64 +0,0 @@
-import { extractFirst } from '../utils';
-import deps from './migrate/deps';
-// Migrate subcommands
-import init from './migrate/init';
-import list from './migrate/list';
-import status from './migrate/status';
-const subcommandMap = {
-    init,
-    status,
-    list,
-    deps
-};
-const migrateUsageText = `
-Migrate Commands:
-
-  launchql migrate init      Initialize migration tracking in database
-  launchql migrate status    Show current migration status
-  launchql migrate list      List all changes (deployed and pending)
-  launchql migrate deps      Show change dependencies
-
-Options:
-  --help, -h     Show this help message
-  --cwd          Working directory (default: current directory)
-`;
-export default async (argv, prompter, options) => {
-    let { first: subcommand, newArgv } = extractFirst(argv);
-    // Show usage if explicitly requested
-    if (argv.help || argv.h || subcommand === 'help') {
-        console.log(migrateUsageText);
-        process.exit(0);
-    }
-    // Prompt if no subcommand provided
-    if (!subcommand) {
-        const answer = await prompter.prompt(argv, [
-            {
-                type: 'autocomplete',
-                name: 'subcommand',
-                message: 'What migrate operation do you want to perform?',
-                options: Object.keys(subcommandMap).map(cmd => ({
-                    name: cmd,
-                    value: cmd,
-                    description: getSubcommandDescription(cmd)
-                }))
-            }
-        ]);
-        subcommand = answer.subcommand;
-    }
-    const subcommandFn = subcommandMap[subcommand];
-    if (!subcommandFn) {
-        console.error(`Unknown migrate subcommand: ${subcommand}`);
-        console.log(migrateUsageText);
-        process.exit(1);
-    }
-    await subcommandFn(newArgv, prompter, options);
-};
-function getSubcommandDescription(cmd) {
-    const descriptions = {
-        init: 'Initialize migration tracking in database',
-        status: 'Show current migration status',
-        list: 'List all changes (deployed and pending)',
-        deps: 'Show change dependencies'
-    };
-    return descriptions[cmd] || '';
-}

package/esm/commands/package.js

@@ -1,63 +0,0 @@
-import { LaunchQLPackage, writePackage } from '@launchql/core';
-const packageUsageText = `
-Package Command:
-
-  constructive package [OPTIONS]
-
-  Package module for distribution.
-
-Options:
-  --help, -h                      Show this help message
-  --plan                          Include deployment plan (default: true)
-  --pretty                        Pretty-print output (default: true)
-  --functionDelimiter <delimiter> Function delimiter (default: $EOFCODE$)
-  --cwd <directory>               Working directory (default: current directory)
-
-Examples:
-  constructive package                     Package with defaults
-  constructive package --no-plan           Package without plan
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(packageUsageText);
-        process.exit(0);
-    }
-    const questions = [
-        {
-            type: 'confirm',
-            name: 'plan',
-            default: true,
-            useDefault: true,
-            required: true
-        },
-        {
-            type: 'confirm',
-            name: 'pretty',
-            default: true,
-            useDefault: true,
-            required: true
-        },
-        {
-            type: 'text',
-            name: 'functionDelimiter',
-            default: '$EOFCODE$',
-            useDefault: true,
-            required: false
-        }
-    ];
-    let { cwd, plan, pretty, functionDelimiter } = await prompter.prompt(argv, questions);
-    const project = new LaunchQLPackage(cwd);
-    project.ensureModule();
-    const info = project.getModuleInfo();
-    info.version;
-    await writePackage({
-        version: info.version,
-        extension: true,
-        usePlan: plan,
-        packageDir: project.modulePath,
-        pretty,
-        functionDelimiter
-    });
-    return argv;
-};

package/esm/commands/plan.js

@@ -1,60 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-const log = new Logger('plan');
-const planUsageText = `
-Plan Command:
-
-  constructive plan [OPTIONS]
-
-  Generate module deployment plans.
-
-Options:
-  --help, -h                     Show this help message
-  --includePackages              Include packages in plan (default: true)
-  --includeTags                  Prefer @tag references for external packages when available (default: true)
-  --cwd <directory>              Working directory (default: current directory)
-
-Examples:
-  constructive plan                                 Generate deployment plan for current module with defaults
-  constructive plan --includePackages false         Disable including external packages
-  constructive plan --includeTags false              Do not prefer tags for external packages
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(planUsageText);
-        process.exit(0);
-    }
-    const questions = [
-        {
-            type: 'confirm',
-            name: 'includePackages',
-            message: 'Include packages in plan?',
-            useDefault: true,
-            default: true
-        },
-        {
-            type: 'confirm',
-            name: 'includeTags',
-            message: 'Prefer @tag references for external packages when available?',
-            useDefault: true,
-            default: true
-        }
-    ];
-    let { cwd, includePackages, includeTags } = await prompter.prompt(argv, questions);
-    if (!cwd) {
-        cwd = process.cwd();
-        log.info(`Using current directory: ${cwd}`);
-    }
-    const pkg = new LaunchQLPackage(cwd);
-    if (!pkg.isInModule()) {
-        throw new Error('This command must be run inside a LaunchQL module.');
-    }
-    const includePackagesFlag = typeof includePackages === 'boolean' ? includePackages : true;
-    const includeTagsFlag = typeof includeTags === 'boolean' ? includeTags : true;
-    pkg.writeModulePlan({
-        includePackages: includePackagesFlag,
-        includeTags: includeTagsFlag
-    });
-    return argv;
-};

package/esm/commands/remove.js

@@ -1,40 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-import { getEnvOptions } from '@launchql/env';
-import { Logger } from '@launchql/logger';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../utils';
-import { cliExitWithError } from '../utils/cli-error';
-const log = new Logger('remove');
-export default async (argv, prompter, _options) => {
-    if (!argv.to) {
-        await cliExitWithError('No change specified. Usage: constructive remove --to <change>');
-    }
-    const database = await getTargetDatabase(argv, prompter, {
-        message: 'Select database'
-    });
-    const questions = [
-        {
-            name: 'yes',
-            type: 'confirm',
-            message: 'Are you sure you want to proceed with removing changes?',
-            required: true
-        }
-    ];
-    let { yes, cwd } = await prompter.prompt(argv, questions);
-    if (!yes) {
-        log.info('Operation cancelled.');
-        return;
-    }
-    log.debug(`Using current directory: ${cwd}`);
-    const pkg = new LaunchQLPackage(cwd);
-    if (!pkg.isInModule()) {
-        throw new Error('Not in a LaunchQL module directory. Please run this command from within a module.');
-    }
-    const opts = getEnvOptions({
-        pg: getPgEnvOptions({ database })
-    });
-    const toChange = argv.to;
-    await pkg.removeFromPlan(toChange);
-    log.success(`✅ Successfully removed changes from '${toChange}' to end of plan.`);
-    return argv;
-};

package/esm/commands/rename.js

@@ -1,30 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-import path from 'path';
-import { cliExitWithError } from '../utils/cli-error';
-export default async (argv, _prompter) => {
-    const cwd = argv.cwd || process.cwd();
-    const to = argv.to || (argv._ && argv._[0]);
-    if (!to) {
-        await cliExitWithError('Missing new name. Use --to <name> or provide as positional argument.');
-    }
-    const dryRun = !!argv['dry-run'] || !!argv.dryRun;
-    const syncPkg = !!argv['sync-pkg-name'] || !!argv.syncPkgName;
-    const proj = new LaunchQLPackage(path.resolve(cwd));
-    const res = proj.renameModule(to, { dryRun, syncPackageJsonName: syncPkg });
-    if (dryRun) {
-        console.log('Dry run');
-    }
-    if (res.changed.length > 0) {
-        console.log('Changed:');
-        for (const f of res.changed)
-            console.log(`- ${f}`);
-    }
-    else {
-        console.log('No changes');
-    }
-    if (res.warnings.length > 0) {
-        console.log('Warnings:');
-        for (const w of res.warnings)
-            console.log(`- ${w}`);
-    }
-};

package/esm/commands/revert.js

@@ -1,105 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-import { getEnvOptions } from '@launchql/env';
-import { Logger } from '@launchql/logger';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../utils';
-import { cliExitWithError } from '../utils/cli-error';
-import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
-const log = new Logger('revert');
-const revertUsageText = `
-Revert Command:
-
-  constructive revert [OPTIONS]
-
-  Revert database changes and migrations.
-
-Options:
-  --help, -h         Show this help message
-  --recursive        Revert recursively through dependencies
-  --package <name>   Revert specific package
-  --to <target>      Revert to specific change or tag
-  --to               Interactive selection of deployed changes
-  --tx               Use transactions (default: true)
-  --cwd <directory>  Working directory (default: current directory)
-
-Examples:
-  constructive revert                    Revert latest changes
-  constructive revert --to @v1.0.0      Revert to specific tag
-  constructive revert --to              Interactive selection from deployed changes
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(revertUsageText);
-        process.exit(0);
-    }
-    const database = await getTargetDatabase(argv, prompter, {
-        message: 'Select database'
-    });
-    const questions = [
-        {
-            name: 'yes',
-            type: 'confirm',
-            message: 'Are you sure you want to proceed?',
-            required: true
-        },
-        {
-            name: 'recursive',
-            type: 'confirm',
-            message: 'Deploy recursively through dependencies?',
-            useDefault: true,
-            default: true,
-            required: false
-        },
-        {
-            name: 'tx',
-            type: 'confirm',
-            message: 'Use Transaction?',
-            useDefault: true,
-            default: true,
-            required: false
-        }
-    ];
-    let { yes, recursive, cwd, tx } = await prompter.prompt(argv, questions);
-    if (!yes) {
-        log.info('Operation cancelled.');
-        return;
-    }
-    log.debug(`Using current directory: ${cwd}`);
-    let packageName;
-    if (recursive && argv.to !== true) {
-        packageName = await selectDeployedPackage(database, argv, prompter, log, 'revert');
-        if (!packageName) {
-            await cliExitWithError('No package found to revert');
-        }
-    }
-    const pkg = new LaunchQLPackage(cwd);
-    const opts = getEnvOptions({
-        pg: getPgEnvOptions({ database }),
-        deployment: {
-            useTx: tx
-        }
-    });
-    let target;
-    if (argv.to === true) {
-        target = await selectDeployedChange(database, argv, prompter, log, 'revert');
-        if (!target) {
-            await cliExitWithError('No target selected, operation cancelled');
-        }
-    }
-    else if (packageName && argv.to) {
-        target = `${packageName}:${argv.to}`;
-    }
-    else if (packageName) {
-        target = packageName;
-    }
-    else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
-    }
-    else if (argv.package) {
-        target = argv.package;
-    }
-    await pkg.revert(opts, target, recursive);
-    log.success('Revert complete.');
-    return argv;
-};