@constructive-io/cli 0.0.2 → 5.1.0

package/commands/migrate.js

@@ -1,69 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const utils_1 = require("../utils");
-const deps_1 = __importDefault(require("./migrate/deps"));
-// Migrate subcommands
-const init_1 = __importDefault(require("./migrate/init"));
-const list_1 = __importDefault(require("./migrate/list"));
-const status_1 = __importDefault(require("./migrate/status"));
-const subcommandMap = {
-    init: init_1.default,
-    status: status_1.default,
-    list: list_1.default,
-    deps: deps_1.default
-};
-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)
-`;
-exports.default = async (argv, prompter, options) => {
-    let { first: subcommand, newArgv } = (0, utils_1.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/commands/package.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
-export default _default;

package/commands/package.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@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
-`;
-exports.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 core_1.LaunchQLPackage(cwd);
-    project.ensureModule();
-    const info = project.getModuleInfo();
-    info.version;
-    await (0, core_1.writePackage)({
-        version: info.version,
-        extension: true,
-        usePlan: plan,
-        packageDir: project.modulePath,
-        pretty,
-        functionDelimiter
-    });
-    return argv;
-};

package/commands/plan.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
-export default _default;

package/commands/plan.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const logger_1 = require("@launchql/logger");
-const log = new logger_1.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
-`;
-exports.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 core_1.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/commands/remove.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
-export default _default;

package/commands/remove.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const env_1 = require("@launchql/env");
-const logger_1 = require("@launchql/logger");
-const pg_env_1 = require("pg-env");
-const utils_1 = require("../utils");
-const cli_error_1 = require("../utils/cli-error");
-const log = new logger_1.Logger('remove');
-exports.default = async (argv, prompter, _options) => {
-    if (!argv.to) {
-        await (0, cli_error_1.cliExitWithError)('No change specified. Usage: constructive remove --to <change>');
-    }
-    const database = await (0, utils_1.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 core_1.LaunchQLPackage(cwd);
-    if (!pkg.isInModule()) {
-        throw new Error('Not in a LaunchQL module directory. Please run this command from within a module.');
-    }
-    const opts = (0, env_1.getEnvOptions)({
-        pg: (0, pg_env_1.getPgEnvOptions)({ database })
-    });
-    const toChange = argv.to;
-    await pkg.removeFromPlan(toChange);
-    log.success(`✅ Successfully removed changes from '${toChange}' to end of plan.`);
-    return argv;
-};

package/commands/rename.d.ts

@@ -1,4 +0,0 @@
-import { Inquirerer } from 'inquirerer';
-import { ParsedArgs } from 'minimist';
-declare const _default: (argv: Partial<ParsedArgs>, _prompter: Inquirerer) => Promise<void>;
-export default _default;

package/commands/rename.js

@@ -1,35 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const path_1 = __importDefault(require("path"));
-const cli_error_1 = require("../utils/cli-error");
-exports.default = async (argv, _prompter) => {
-    const cwd = argv.cwd || process.cwd();
-    const to = argv.to || (argv._ && argv._[0]);
-    if (!to) {
-        await (0, cli_error_1.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 core_1.LaunchQLPackage(path_1.default.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/commands/revert.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
-export default _default;

package/commands/revert.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const env_1 = require("@launchql/env");
-const logger_1 = require("@launchql/logger");
-const pg_env_1 = require("pg-env");
-const utils_1 = require("../utils");
-const cli_error_1 = require("../utils/cli-error");
-const deployed_changes_1 = require("../utils/deployed-changes");
-const log = new logger_1.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
-`;
-exports.default = async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(revertUsageText);
-        process.exit(0);
-    }
-    const database = await (0, utils_1.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 (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'revert');
-        if (!packageName) {
-            await (0, cli_error_1.cliExitWithError)('No package found to revert');
-        }
-    }
-    const pkg = new core_1.LaunchQLPackage(cwd);
-    const opts = (0, env_1.getEnvOptions)({
-        pg: (0, pg_env_1.getPgEnvOptions)({ database }),
-        deployment: {
-            useTx: tx
-        }
-    });
-    let target;
-    if (argv.to === true) {
-        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'revert');
-        if (!target) {
-            await (0, cli_error_1.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;
-};

package/commands/tag.d.ts

@@ -1,6 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<{
-    _: string[];
-    "--"?: string[] | undefined;
-}>;
-export default _default;

package/commands/tag.js

@@ -1,168 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const logger_1 = require("@launchql/logger");
-const types_1 = require("@launchql/types");
-const path = __importStar(require("path"));
-const argv_1 = require("../utils/argv");
-const module_utils_1 = require("../utils/module-utils");
-const log = new logger_1.Logger('tag');
-const tagUsageText = `
-Tag Command:
-
-  constructive tag [tag_name] [OPTIONS]
-
-  Add tags to changes for versioning.
-
-Arguments:
-  tag_name                Name of the tag to create
-
-Options:
-  --help, -h              Show this help message
-  --package <name>        Target specific package
-  --changeName <name>     Target specific change (default: latest)
-  --comment <text>        Optional tag comment
-  --cwd <directory>       Working directory (default: current directory)
-
-Examples:
-  constructive tag v1.0.0                                    Add tag to latest change
-  constructive tag v1.0.0 --comment "Initial release"       Add tag with comment
-  constructive tag v1.1.0 --package mypackage --changeName my-change  Tag specific change in package
-`;
-exports.default = async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(tagUsageText);
-        process.exit(0);
-    }
-    const { first: tagName, newArgv } = (0, argv_1.extractFirst)(argv);
-    const cwdResult = await prompter.prompt(newArgv, [
-        {
-            type: 'text',
-            name: 'cwd',
-            message: 'Working directory',
-            required: false,
-            default: process.cwd(),
-            useDefault: true
-        }
-    ]);
-    const cwd = cwdResult.cwd || process.cwd();
-    const pkg = new core_1.LaunchQLPackage(cwd);
-    let packageName;
-    if (argv.package) {
-        packageName = argv.package;
-        log.info(`Using specified package: ${packageName}`);
-    }
-    else if (pkg.isInModule()) {
-        packageName = pkg.getModuleName();
-        log.info(`Using current module: ${packageName}`);
-    }
-    else if (pkg.isInWorkspace()) {
-        packageName = await (0, module_utils_1.selectPackage)(newArgv, prompter, cwd, 'add tag to', log);
-        if (!packageName) {
-            throw new Error('No package selected. Cannot add tag without specifying a target package.');
-        }
-    }
-    else {
-        throw new Error('This command must be run inside a LaunchQL workspace or module.');
-    }
-    const questions = [];
-    if (!tagName) {
-        questions.push({
-            type: 'text',
-            name: 'tagName',
-            message: 'Tag name',
-            required: true,
-            validate: (value) => {
-                if (!value || value.trim().length === 0) {
-                    return false;
-                }
-                if (value.includes('/')) {
-                    return false;
-                }
-                if (value.includes('@')) {
-                    return false;
-                }
-                return true;
-            }
-        });
-    }
-    questions.push({
-        type: 'text',
-        name: 'changeName',
-        message: 'Target change name (leave empty for latest change)',
-        required: false
-    }, {
-        type: 'text',
-        name: 'comment',
-        message: 'Tag comment (optional)',
-        required: false
-    });
-    const answers = await prompter.prompt(newArgv, questions);
-    const finalTagName = tagName || answers.tagName;
-    const changeName = answers.changeName;
-    const comment = answers.comment;
-    try {
-        if (argv.package || !pkg.isInModule()) {
-            const moduleMap = pkg.getModuleMap();
-            const module = moduleMap[packageName];
-            if (!module) {
-                throw types_1.errors.MODULE_NOT_FOUND({ name: packageName });
-            }
-            const workspacePath = pkg.getWorkspacePath();
-            const absoluteModulePath = path.resolve(workspacePath, module.path);
-            const originalCwd = process.cwd();
-            process.chdir(absoluteModulePath);
-            try {
-                const modulePkg = new core_1.LaunchQLPackage(absoluteModulePath);
-                modulePkg.addTag(finalTagName.trim(), changeName?.trim() || undefined, comment?.trim() || undefined);
-                log.info(`Successfully added tag '${finalTagName}' to ${changeName || 'latest change'} in package '${packageName}'`);
-            }
-            finally {
-                process.chdir(originalCwd);
-            }
-        }
-        else {
-            pkg.addTag(finalTagName.trim(), changeName?.trim() || undefined, comment?.trim() || undefined);
-            log.info(`Successfully added tag '${finalTagName}' to ${changeName || 'latest change'}`);
-        }
-    }
-    catch (error) {
-        log.error(`Failed to add tag: ${error instanceof Error ? error.message : String(error)}`);
-        throw error;
-    }
-    return newArgv;
-};

package/commands/verify.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, any>>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
-export default _default;

package/commands/verify.js

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@launchql/core");
-const env_1 = require("@launchql/env");
-const logger_1 = require("@launchql/logger");
-const pg_env_1 = require("pg-env");
-const utils_1 = require("../utils");
-const cli_error_1 = require("../utils/cli-error");
-const deployed_changes_1 = require("../utils/deployed-changes");
-const log = new logger_1.Logger('verify');
-const verifyUsageText = `
-Verify Command:
-
-  constructive verify [OPTIONS]
-
-  Verify database state matches expected migrations.
-
-Options:
-  --help, -h         Show this help message
-  --recursive        Verify recursively through dependencies
-  --package <name>   Verify specific package
-  --to <target>      Verify up to specific change or tag
-  --to               Interactive selection of deployed changes
-  --cwd <directory>  Working directory (default: current directory)
-
-Examples:
-  constructive verify                    Verify current database state
-  constructive verify --package mypackage  Verify specific package
-  constructive verify --to              Interactive selection from deployed changes
-`;
-exports.default = async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(verifyUsageText);
-        process.exit(0);
-    }
-    const database = await (0, utils_1.getTargetDatabase)(argv, prompter, {
-        message: 'Select database'
-    });
-    const questions = [
-        {
-            name: 'recursive',
-            type: 'confirm',
-            message: 'Deploy recursively through dependencies?',
-            useDefault: true,
-            default: true,
-            required: false
-        },
-    ];
-    let { recursive, cwd } = await prompter.prompt(argv, questions);
-    log.debug(`Using current directory: ${cwd}`);
-    let packageName;
-    if (recursive && argv.to !== true) {
-        packageName = await (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'verify');
-        if (!packageName) {
-            await (0, cli_error_1.cliExitWithError)('No package found to verify');
-        }
-    }
-    const project = new core_1.LaunchQLPackage(cwd);
-    const opts = (0, env_1.getEnvOptions)({
-        pg: (0, pg_env_1.getPgEnvOptions)({ database })
-    });
-    let target;
-    if (argv.to === true) {
-        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'verify');
-        if (!target) {
-            await (0, cli_error_1.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 project.verify(opts, target, recursive);
-    log.success('Verify complete.');
-    return argv;
-};