@memberjunction/cli 2.55.0 → 2.57.0

package/dist/commands/sync/push.js

@@ -0,0 +1,183 @@
+"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("@oclif/core");
+const prompts_1 = require("@inquirer/prompts");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+const chalk_1 = __importDefault(require("chalk"));
+const metadata_sync_1 = require("@memberjunction/metadata-sync");
+const path_1 = __importDefault(require("path"));
+class Push extends core_1.Command {
+    static description = 'Push local file changes to the database';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>`,
+        `<%= config.bin %> <%= command.id %> --dry-run`,
+        `<%= config.bin %> <%= command.id %> --dir="ai-prompts"`,
+        `<%= config.bin %> <%= command.id %> --ci`,
+    ];
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Specific entity directory to push' }),
+        'dry-run': core_1.Flags.boolean({ description: 'Show what would be pushed without actually pushing' }),
+        ci: core_1.Flags.boolean({ description: 'CI mode - no prompts, fail on issues' }),
+        verbose: core_1.Flags.boolean({ char: 'v', description: 'Show detailed field-level output' }),
+        'no-validate': core_1.Flags.boolean({ description: 'Skip validation before push' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Push);
+        const spinner = (0, ora_classic_1.default)();
+        const startTime = Date.now();
+        try {
+            // Load configurations
+            spinner.start('Loading configuration');
+            const mjConfig = (0, metadata_sync_1.loadMJConfig)();
+            if (!mjConfig) {
+                this.error('No mj.config.cjs found in current directory or parent directories');
+            }
+            // Load sync config (currently only used internally by PushService)
+            const syncConfigDir = flags.dir ? path_1.default.resolve(metadata_sync_1.configManager.getOriginalCwd(), flags.dir) : metadata_sync_1.configManager.getOriginalCwd();
+            await (0, metadata_sync_1.loadSyncConfig)(syncConfigDir);
+            // Stop spinner before provider initialization
+            spinner.stop();
+            // Initialize data provider
+            await (0, metadata_sync_1.initializeProvider)(mjConfig);
+            // Initialize sync engine
+            const syncEngine = await (0, metadata_sync_1.getSyncEngine)((0, metadata_sync_1.getSystemUser)());
+            // Show success after initialization
+            if (flags.verbose) {
+                spinner.succeed('Configuration and metadata loaded');
+            }
+            else {
+                spinner.stop();
+            }
+            // Run validation unless disabled
+            if (!flags['no-validate']) {
+                spinner.start('Validating metadata...');
+                const validator = new metadata_sync_1.ValidationService({ verbose: flags.verbose });
+                const formatter = new metadata_sync_1.FormattingService();
+                const targetDir = flags.dir ? path_1.default.resolve(metadata_sync_1.configManager.getOriginalCwd(), flags.dir) : metadata_sync_1.configManager.getOriginalCwd();
+                const validationResult = await validator.validateDirectory(targetDir);
+                spinner.stop();
+                if (!validationResult.isValid || validationResult.warnings.length > 0) {
+                    // Show validation results
+                    this.log('\n' + formatter.formatValidationResult(validationResult, flags.verbose));
+                    if (!validationResult.isValid) {
+                        // In CI mode, fail immediately
+                        if (flags.ci) {
+                            this.error('Validation failed. Cannot proceed with push.');
+                        }
+                        // Otherwise, ask for confirmation
+                        const shouldContinue = await (0, prompts_1.confirm)({
+                            message: 'Validation failed with errors. Do you want to continue anyway?',
+                            default: false,
+                        });
+                        if (!shouldContinue) {
+                            this.log(chalk_1.default.yellow('\n⚠️  Push cancelled due to validation errors.'));
+                            // Exit cleanly without throwing an error
+                            return;
+                        }
+                    }
+                }
+                else {
+                    this.log(chalk_1.default.green('✓ Validation passed'));
+                }
+            }
+            // Create push service and execute
+            const pushService = new metadata_sync_1.PushService(syncEngine, (0, metadata_sync_1.getSystemUser)());
+            const result = await pushService.push({
+                dir: flags.dir,
+                dryRun: flags['dry-run'],
+                verbose: flags.verbose,
+                noValidate: flags['no-validate'],
+            }, {
+                onProgress: (message) => {
+                    spinner.start(message);
+                },
+                onSuccess: (message) => {
+                    spinner.succeed(message);
+                },
+                onError: (message) => {
+                    this.error(message);
+                },
+                onWarn: (message) => {
+                    this.warn(message);
+                },
+                onLog: (message) => {
+                    this.log(message);
+                },
+                onConfirm: async (message) => {
+                    if (flags.ci) {
+                        return true; // Always confirm in CI mode
+                    }
+                    return await (0, prompts_1.confirm)({ message });
+                },
+            });
+            // Show summary
+            const endTime = Date.now();
+            const formatter = new metadata_sync_1.FormattingService();
+            const summary = formatter.formatSyncSummary('push', {
+                created: result.created,
+                updated: result.updated,
+                unchanged: result.unchanged,
+                deleted: 0,
+                skipped: 0,
+                errors: result.errors,
+                duration: endTime - startTime,
+            });
+            this.log('\n' + summary);
+            // Handle result
+            if (result.errors > 0) {
+                if (flags.ci) {
+                    this.error('Push failed with errors in CI mode');
+                }
+                const shouldContinue = await (0, prompts_1.confirm)({
+                    message: 'Push completed with errors. Do you want to commit the successful changes?',
+                    default: false,
+                });
+                if (!shouldContinue) {
+                    throw new Error('Push cancelled due to errors');
+                }
+            }
+            // Show warnings summary
+            if (result.warnings.length > 0) {
+                this.log(chalk_1.default.yellow(`\n⚠️  ${result.warnings.length} warning${result.warnings.length > 1 ? 's' : ''} during push`));
+                if (flags.verbose) {
+                    result.warnings.forEach((warning) => this.log(`   - ${warning}`));
+                }
+            }
+            // Show final status
+            if (!flags['dry-run']) {
+                if (result.errors === 0) {
+                    this.log(chalk_1.default.green('\n✅ Push completed successfully'));
+                }
+                else {
+                    this.log(chalk_1.default.yellow('\n⚠️  Push completed with errors'));
+                }
+                if (result.sqlLogPath) {
+                    this.log(`\n📄 SQL log saved to: ${path_1.default.relative(process.cwd(), result.sqlLogPath)}`);
+                }
+            }
+        }
+        catch (error) {
+            spinner.fail('Push failed');
+            // Error handling - individual operations may have partially succeeded
+            // Enhanced error logging
+            this.log('\n=== Push Error Details ===');
+            this.log(`Error type: ${error?.constructor?.name || 'Unknown'}`);
+            this.log(`Error message: ${error instanceof Error ? error.message : String(error)}`);
+            if (error instanceof Error && error.stack) {
+                this.log(`\nStack trace:`);
+                this.log(error.stack);
+            }
+            this.error(error);
+        }
+        finally {
+            // Reset singletons
+            (0, metadata_sync_1.resetSyncEngine)();
+            // Exit process
+            process.exit(0);
+        }
+    }
+}
+exports.default = Push;

package/dist/commands/sync/status.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class Status extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/sync/status.js

@@ -0,0 +1,112 @@
+"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("@oclif/core");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+const chalk_1 = __importDefault(require("chalk"));
+const metadata_sync_1 = require("@memberjunction/metadata-sync");
+class Status extends core_1.Command {
+    static description = 'Show status of local files vs database';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>`,
+        `<%= config.bin %> <%= command.id %> --dir="ai-prompts"`,
+        `<%= config.bin %> <%= command.id %> --verbose`,
+    ];
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Specific entity directory to check status' }),
+        verbose: core_1.Flags.boolean({ char: 'v', description: 'Show detailed field-level differences' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Status);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            // Load configuration
+            spinner.start('Loading configuration');
+            const mjConfig = (0, metadata_sync_1.loadMJConfig)();
+            if (!mjConfig) {
+                this.error('No mj.config.cjs found in current directory or parent directories');
+            }
+            // Stop spinner before provider initialization
+            spinner.stop();
+            // Initialize data provider
+            await (0, metadata_sync_1.initializeProvider)(mjConfig);
+            // Initialize sync engine
+            const syncEngine = await (0, metadata_sync_1.getSyncEngine)((0, metadata_sync_1.getSystemUser)());
+            // Show success after initialization
+            if (flags.verbose) {
+                spinner.succeed('Configuration and metadata loaded');
+            }
+            else {
+                spinner.stop();
+            }
+            // Create status service and execute
+            const statusService = new metadata_sync_1.StatusService(syncEngine);
+            spinner.start('Checking status...');
+            const result = await statusService.checkStatus({
+                dir: flags.dir
+            }, {
+                onProgress: (message) => {
+                    spinner.start(message);
+                },
+                onWarn: (message) => {
+                    this.warn(message);
+                },
+                onLog: (message) => {
+                    this.log(message);
+                }
+            });
+            spinner.stop();
+            // Display results
+            // Show summary
+            const summary = result.summary;
+            const totalFiles = summary.new + summary.modified + summary.deleted + summary.unchanged;
+            if (totalFiles === 0) {
+                this.log(chalk_1.default.yellow('\nNo metadata files found in the specified directory.'));
+            }
+            else {
+                this.log(chalk_1.default.bold('\nSummary:'));
+                if (summary.new > 0) {
+                    this.log(chalk_1.default.green(`  ${summary.new} new file(s) to push`));
+                }
+                if (summary.modified > 0) {
+                    this.log(chalk_1.default.yellow(`  ${summary.modified} modified file(s) to push`));
+                }
+                if (summary.deleted > 0) {
+                    this.log(chalk_1.default.red(`  ${summary.deleted} deleted file(s) to remove`));
+                }
+                if (summary.unchanged > 0) {
+                    this.log(chalk_1.default.gray(`  ${summary.unchanged} unchanged file(s)`));
+                }
+                // Show details by entity if verbose
+                if (flags.verbose && result.details.length > 0) {
+                    this.log(chalk_1.default.bold('\nDetails by entity:'));
+                    for (const detail of result.details) {
+                        this.log(`\n  ${detail.entityName} (${detail.directory}):`);
+                        this.log(`    New: ${detail.new}, Modified: ${detail.modified}, Deleted: ${detail.deleted}, Unchanged: ${detail.unchanged}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            spinner.fail('Status check failed');
+            // Enhanced error logging
+            this.log('\n=== Status Error Details ===');
+            this.log(`Error type: ${error?.constructor?.name || 'Unknown'}`);
+            this.log(`Error message: ${error instanceof Error ? error.message : String(error)}`);
+            if (error instanceof Error && error.stack) {
+                this.log(`\nStack trace:`);
+                this.log(error.stack);
+            }
+            this.error(error);
+        }
+        finally {
+            // Reset singletons
+            (0, metadata_sync_1.resetSyncEngine)();
+            // Exit process
+            process.exit(0);
+        }
+    }
+}
+exports.default = Status;

package/dist/commands/sync/validate.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class Validate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'save-report': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/sync/validate.js

@@ -0,0 +1,131 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+const chalk_1 = __importDefault(require("chalk"));
+const path = __importStar(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const metadata_sync_1 = require("@memberjunction/metadata-sync");
+class Validate extends core_1.Command {
+    static description = 'Validate metadata files';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>`,
+        `<%= config.bin %> <%= command.id %> --dir="ai-prompts"`,
+        `<%= config.bin %> <%= command.id %> --save-report`,
+        `<%= config.bin %> <%= command.id %> --verbose`,
+    ];
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Specific entity directory to validate' }),
+        verbose: core_1.Flags.boolean({ char: 'v', description: 'Show detailed validation output' }),
+        'save-report': core_1.Flags.boolean({ description: 'Save validation report as markdown file' }),
+        'output': core_1.Flags.string({ description: 'Output file path for validation report (default: validation-report.md)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Validate);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            // Load configuration
+            spinner.start('Loading configuration');
+            const mjConfig = (0, metadata_sync_1.loadMJConfig)();
+            if (!mjConfig) {
+                this.error('No mj.config.cjs found in current directory or parent directories');
+            }
+            // Stop spinner before provider initialization
+            spinner.stop();
+            // Initialize data provider
+            await (0, metadata_sync_1.initializeProvider)(mjConfig);
+            // Initialize sync engine (needed for metadata access)
+            await (0, metadata_sync_1.getSyncEngine)((0, metadata_sync_1.getSystemUser)());
+            // Show success after initialization
+            if (flags.verbose) {
+                spinner.succeed('Configuration and metadata loaded');
+            }
+            else {
+                spinner.stop();
+            }
+            // Create validation service
+            const validator = new metadata_sync_1.ValidationService({ verbose: flags.verbose });
+            const formatter = new metadata_sync_1.FormattingService();
+            // Determine directory to validate
+            const targetDir = flags.dir
+                ? path.resolve(metadata_sync_1.configManager.getOriginalCwd(), flags.dir)
+                : metadata_sync_1.configManager.getOriginalCwd();
+            spinner.start(`Validating metadata in ${path.relative(process.cwd(), targetDir)}...`);
+            // Run validation
+            const validationResult = await validator.validateDirectory(targetDir);
+            spinner.stop();
+            // Format and display results
+            const formattedResult = formatter.formatValidationResult(validationResult, flags.verbose);
+            this.log('\n' + formattedResult);
+            // Save report if requested
+            if (flags['save-report']) {
+                const reportPath = flags.output || 'validation-report.md';
+                const fullReportPath = path.resolve(reportPath);
+                // Generate markdown report
+                const report = formatter.formatValidationResultAsMarkdown(validationResult);
+                await fs_extra_1.default.writeFile(fullReportPath, report, 'utf8');
+                this.log(chalk_1.default.green(`\n✅ Validation report saved to: ${path.relative(process.cwd(), fullReportPath)}`));
+            }
+            // Show summary
+            const totalIssues = validationResult.errors.length + validationResult.warnings.length;
+            if (validationResult.isValid && validationResult.warnings.length === 0) {
+                this.log(chalk_1.default.green('\n✅ All metadata files are valid!'));
+            }
+            else if (validationResult.isValid && validationResult.warnings.length > 0) {
+                this.log(chalk_1.default.yellow(`\n⚠️  Validation passed with ${validationResult.warnings.length} warning(s)`));
+            }
+            else {
+                this.log(chalk_1.default.red(`\n❌ Validation failed with ${validationResult.errors.length} error(s) and ${validationResult.warnings.length} warning(s)`));
+            }
+            // Exit with error code if validation failed
+            if (!validationResult.isValid) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            spinner.fail('Validation failed');
+            // Enhanced error logging
+            this.log('\n=== Validation Error Details ===');
+            this.log(`Error type: ${error?.constructor?.name || 'Unknown'}`);
+            this.log(`Error message: ${error instanceof Error ? error.message : String(error)}`);
+            if (error instanceof Error && error.stack) {
+                this.log(`\nStack trace:`);
+                this.log(error.stack);
+            }
+            this.error(error);
+        }
+        finally {
+            // Reset singletons
+            (0, metadata_sync_1.resetSyncEngine)();
+            // Exit process
+            process.exit(0);
+        }
+    }
+}
+exports.default = Validate;

package/dist/commands/sync/watch.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Watch extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        debounce: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-validate': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    private watchController?;
+    run(): Promise<void>;
+}

package/dist/commands/sync/watch.js

@@ -0,0 +1,148 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+const chalk_1 = __importDefault(require("chalk"));
+const path = __importStar(require("path"));
+const metadata_sync_1 = require("@memberjunction/metadata-sync");
+class Watch extends core_1.Command {
+    static description = 'Watch for file changes and sync automatically';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>`,
+        `<%= config.bin %> <%= command.id %> --dir="ai-prompts"`,
+        `<%= config.bin %> <%= command.id %> --debounce=1000`,
+        `<%= config.bin %> <%= command.id %> --no-validate`,
+    ];
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Specific entity directory to watch' }),
+        debounce: core_1.Flags.integer({ description: 'Debounce delay in milliseconds (default: 500)' }),
+        'no-validate': core_1.Flags.boolean({ description: 'Skip validation before sync' }),
+        verbose: core_1.Flags.boolean({ char: 'v', description: 'Show detailed output' }),
+    };
+    watchController;
+    async run() {
+        const { flags } = await this.parse(Watch);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            // Load configuration
+            spinner.start('Loading configuration');
+            const mjConfig = (0, metadata_sync_1.loadMJConfig)();
+            if (!mjConfig) {
+                this.error('No mj.config.cjs found in current directory or parent directories');
+            }
+            // Load sync config
+            const syncConfigDir = flags.dir ? path.resolve(metadata_sync_1.configManager.getOriginalCwd(), flags.dir) : metadata_sync_1.configManager.getOriginalCwd();
+            const syncConfig = await (0, metadata_sync_1.loadSyncConfig)(syncConfigDir);
+            // Stop spinner before provider initialization
+            spinner.stop();
+            // Initialize data provider
+            await (0, metadata_sync_1.initializeProvider)(mjConfig);
+            // Initialize sync engine
+            const syncEngine = await (0, metadata_sync_1.getSyncEngine)((0, metadata_sync_1.getSystemUser)());
+            // Show success after initialization
+            spinner.succeed('Configuration and metadata loaded');
+            // Determine watch directory
+            const watchDir = flags.dir
+                ? path.resolve(metadata_sync_1.configManager.getOriginalCwd(), flags.dir)
+                : metadata_sync_1.configManager.getOriginalCwd();
+            // Create watch service
+            const watchService = new metadata_sync_1.WatchService(syncEngine);
+            // Setup graceful shutdown
+            process.on('SIGINT', async () => {
+                this.log(chalk_1.default.yellow('\n\n⏹️  Stopping file watcher...'));
+                if (this.watchController) {
+                    await this.watchController.stop();
+                }
+                (0, metadata_sync_1.resetSyncEngine)();
+                process.exit(0);
+            });
+            process.on('SIGTERM', async () => {
+                if (this.watchController) {
+                    await this.watchController.stop();
+                }
+                (0, metadata_sync_1.resetSyncEngine)();
+                process.exit(0);
+            });
+            // Start watching
+            this.log(chalk_1.default.bold(`\n👀 Watching for changes in: ${path.relative(process.cwd(), watchDir)}`));
+            this.log(chalk_1.default.gray('Press Ctrl+C to stop watching\n'));
+            this.watchController = await watchService.watch({
+                dir: flags.dir,
+                debounceMs: flags.debounce || 500
+            }, {
+                onFileAdd: (filePath, entityDir, entityConfig) => {
+                    const relativePath = path.relative(process.cwd(), filePath);
+                    this.log(chalk_1.default.gray(`➕ added: ${relativePath}`));
+                },
+                onFileChange: (filePath, entityDir, entityConfig) => {
+                    const relativePath = path.relative(process.cwd(), filePath);
+                    this.log(chalk_1.default.gray(`📝 changed: ${relativePath}`));
+                },
+                onFileDelete: (filePath, entityDir, entityConfig) => {
+                    const relativePath = path.relative(process.cwd(), filePath);
+                    this.log(chalk_1.default.gray(`❌ deleted: ${relativePath}`));
+                },
+                onRecordSaved: (entity, isNew, entityConfig) => {
+                    const action = isNew ? 'created' : 'updated';
+                    this.log(chalk_1.default.green(`✅ Record ${action} for ${entityConfig.entity}`));
+                },
+                onError: (error) => {
+                    spinner.fail('Watch error');
+                    this.error(error);
+                },
+                onWarn: (message) => {
+                    this.warn(message);
+                },
+                onLog: (message) => {
+                    if (flags.verbose) {
+                        this.log(message);
+                    }
+                }
+            });
+            // Keep process alive
+            await new Promise(() => {
+                // This promise never resolves, keeping the process running
+                // until interrupted by SIGINT/SIGTERM
+            });
+        }
+        catch (error) {
+            spinner.fail('Watch failed');
+            // Enhanced error logging
+            this.log('\n=== Watch Error Details ===');
+            this.log(`Error type: ${error?.constructor?.name || 'Unknown'}`);
+            this.log(`Error message: ${error instanceof Error ? error.message : String(error)}`);
+            if (error instanceof Error && error.stack) {
+                this.log(`\nStack trace:`);
+                this.log(error.stack);
+            }
+            this.error(error);
+        }
+    }
+}
+exports.default = Watch;

package/dist/hooks/init.d.ts

@@ -0,0 +1,7 @@
+import { Hook } from '@oclif/core';
+/**
+ * Init hook runs once when the CLI starts up.
+ * Currently unused but required by oclif configuration.
+ */
+declare const hook: Hook<'init'>;
+export default hook;

package/dist/hooks/init.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Init hook runs once when the CLI starts up.
+ * Currently unused but required by oclif configuration.
+ */
+const hook = async function () {
+    // No initialization needed at this time
+};
+exports.default = hook;