feat: Complete ESM migration for all CLI commands (P1.T010)

Massive parallel ESM conversion - 28 files transformed from CommonJS to pure ES modules:

Database Commands:
- Converted QueryCommand, ResetCommand to ESM
- Migrated all 10 migrate subcommands (clean, generate, history, promote, rollback, squash, status, test, test-v2, verify)
- Added proper handler exports for router integration

Function Commands:
- DeployCommand, StatusCommand, ValidateCommand converted to ESM
- InitCommand migrated with proper imports

Test Commands:
- 7 test commands converted (Compile, Coverage, DevCycle, Generate, GenerateTemplate, Validate, Watch)
- Dynamic imports for conditional loading
- Proper .js extensions on all imports

Library Classes:
- Command.js fixed event imports
- SupabaseTestCommand, BuildCommand, CommandRouter converted
- All base classes now pure ESM

Technical improvements:
- All require() → import statements
- All module.exports → export default
- Added .js extensions to relative imports
- Converted to async/await patterns where applicable
- Zero CommonJS artifacts remaining in main codebase

This completes P1.T010 - the entire CLI is now running on pure ES modules!

🖖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>

Author: flyingrobots

starfleet/data-cli/src/commands/InitCommand.js

@@ -1,6 +1,6 @@
-const fs = require('fs/promises');
-const path = require('path');
-const Command = require('../lib/Command.js');
+import fs from 'fs/promises';
+import path from 'path';
+import Command from '../lib/Command.js';
 
 class InitCommand extends Command {
   constructor(options = {}) {
@@ -133,4 +133,4 @@ CREATE POLICY "Allow public read" ON public.maintenance_mode
   }
 }
 
-module.exports = InitCommand;
+export default InitCommand;

starfleet/data-cli/src/commands/db/QueryCommand.js

@@ -2,12 +2,13 @@
  * Database Query Command
  */
 
-const fs = require('fs').promises;
-const { Client } = require('pg');
-const DatabaseCommand = require('../../lib/DatabaseCommand');
+import { promises as fs } from 'fs';
+import { Client } from 'pg';
+import DatabaseCommand from '../../lib/DatabaseCommand.js';
 
 /**
  * Execute SQL queries against the database
+ * @class
  */
 class QueryCommand extends DatabaseCommand {
   constructor(databaseUrl, serviceRoleKey = null, anonKey = null, logger = null, isProd = false) {
@@ -125,4 +126,5 @@ class QueryCommand extends DatabaseCommand {
   }
 }
 
-module.exports = QueryCommand;
+export { QueryCommand };
+export default QueryCommand;

starfleet/data-cli/src/commands/db/ResetCommand.js

@@ -2,14 +2,15 @@
  * Database Reset Command
  */
 
-const { exec } = require('child_process');
-const { promisify } = require('util');
-const DatabaseCommand = require('../../lib/DatabaseCommand');
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import DatabaseCommand from '../../lib/DatabaseCommand.js';
 
 const execAsync = promisify(exec);
 
 /**
  * Reset database command
+ * @class
  */
 class ResetCommand extends DatabaseCommand {
   constructor(databaseUrl, serviceRoleKey = null, anonKey = null, logger = null, isProd = false) {
@@ -93,4 +94,5 @@ class ResetCommand extends DatabaseCommand {
   }
 }
 
-module.exports = ResetCommand;
+export { ResetCommand };
+export default ResetCommand;

starfleet/data-cli/src/commands/db/migrate/clean.js

@@ -2,13 +2,16 @@
  * Migration Clean Command
  */
 
-const Command = require('../../../lib/Command');
-const fs = require('fs').promises;
-const path = require('path');
+import Command from '../../../lib/Command.js';
+import { promises as fs } from 'fs';
+import path from 'path';
 
 /**
  * Clean up temporary migration files and staging directories
  */
+/**
+ * @class
+ */
 class MigrateCleanCommand extends Command {
   static description = 'Clean up temporary migration files';
 
@@ -283,4 +286,17 @@ class MigrateCleanCommand extends Command {
   }
 }
 
-module.exports = MigrateCleanCommand;
+/**
+ * Migration clean handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} Clean result
+ */
+export default async function cleanHandler(args, config, logger, isProd) {
+  const command = new MigrateCleanCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigrateCleanCommand };

starfleet/data-cli/src/commands/db/migrate/generate.js

@@ -1,7 +1,7 @@
-const Command = require('../../../lib/Command');
-const MigrationMetadata = require('../../../lib/MigrationMetadata');
-const fs = require('fs').promises;
-const path = require('path');
+import Command from '../../../lib/Command.js';
+import MigrationMetadata from '../../../lib/MigrationMetadata.js';
+import { promises as fs } from 'fs';
+import path from 'path';
 
 /**
  * MigrateGenerateCommand - Generate migration from schema diff
@@ -15,6 +15,7 @@ const path = require('path');
  * --dry-run             Show diff without saving migration
  * --current-db <url>    Current database URL (defaults to local)
  * --desired-db <url>    Desired database URL (defaults to compiled SQL)
+ * @class
  */
 class MigrateGenerateCommand extends Command {
   static description = 'Generate migration from schema diff';
@@ -359,4 +360,17 @@ INSERT INTO example_table (name) VALUES ('test_data');
   }
 }
 
-module.exports = MigrateGenerateCommand;
+/**
+ * Generate migration from schema diff handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} Migration generation result
+ */
+export default async function generateHandler(args, config, logger, isProd) {
+  const command = new MigrateGenerateCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigrateGenerateCommand };

starfleet/data-cli/src/commands/db/migrate/history.js

@@ -2,13 +2,16 @@
  * Migration History Command
  */
 
-const Command = require('../../../lib/Command');
-const fs = require('fs').promises;
-const path = require('path');
+import Command from '../../../lib/Command.js';
+import { promises as fs } from 'fs';
+import path from 'path';
 
 /**
  * Show migration history and timeline
  */
+/**
+ * @class
+ */
 class MigrateHistoryCommand extends Command {
   static description = 'Show migration history';
 
@@ -219,4 +222,17 @@ class MigrateHistoryCommand extends Command {
   }
 }
 
-module.exports = MigrateHistoryCommand;
+/**
+ * Migration history handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} History result
+ */
+export default async function historyHandler(args, config, logger, isProd) {
+  const command = new MigrateHistoryCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigrateHistoryCommand };

starfleet/data-cli/src/commands/db/migrate/index.js

@@ -4,12 +4,24 @@
  * Exports all migration subcommands for the data CLI
  */
 
-module.exports = {
-  MigrateStatusCommand: require('./status'),
-  MigrateRollbackCommand: require('./rollback'),
-  MigrateCleanCommand: require('./clean'),
-  MigrateHistoryCommand: require('./history'),
-  MigrateVerifyCommand: require('./verify'),
-  MigrateSquashCommand: require('./squash'),
-  MigrateGenerateCommand: require('./generate')
+import { MigrateStatusCommand } from './status.js';
+import { MigrateRollbackCommand } from './rollback.js';
+import { MigrateCleanCommand } from './clean.js';
+import { MigrateHistoryCommand } from './history.js';
+import { MigrateVerifyCommand } from './verify.js';
+import { MigrateSquashCommand } from './squash.js';
+import { MigrateGenerateCommand } from './generate.js';
+import { MigrateTestCommand } from './test.js';
+import { MigrateTestCommand as MigrateTestV2Command } from './test-v2.js';
+
+export {
+  MigrateStatusCommand,
+  MigrateRollbackCommand,
+  MigrateCleanCommand,
+  MigrateHistoryCommand,
+  MigrateVerifyCommand,
+  MigrateSquashCommand,
+  MigrateGenerateCommand,
+  MigrateTestCommand,
+  MigrateTestV2Command
 };

starfleet/data-cli/src/commands/db/migrate/promote.js

@@ -3,13 +3,15 @@
  * Promotes tested migrations from staging to production with safety checks
  */
 
-const Command = require('../../../lib/Command');
-const MigrationMetadata = require('../../../lib/MigrationMetadata');
-const fs = require('fs').promises;
-const path = require('path');
+import Command from '../../../lib/Command.js';
+import MigrationMetadata from '../../../lib/MigrationMetadata.js';
+import { promises as fs, statSync } from 'fs';
+import path from 'path';
+import { spawn } from 'child_process';
 
 /**
  * Command to promote a tested migration to production
+ * @class
  */
 class MigratePromoteCommand extends Command {
   static description = 'Promote tested migration to production';
@@ -245,8 +247,6 @@ class MigratePromoteCommand extends Command {
   async stageInGit(productionPath) {
     this.progress('Staging migration in Git...');
 
-    const { spawn } = require('child_process');
-
     return new Promise((resolve, reject) => {
       const git = spawn('git', ['add', productionPath], {
         stdio: ['ignore', 'pipe', 'pipe']
@@ -285,7 +285,7 @@ class MigratePromoteCommand extends Command {
     while (currentDir !== path.dirname(currentDir)) {
       const supabasePath = path.join(currentDir, 'supabase');
       try {
-        require('fs').statSync(supabasePath);
+        statSync(supabasePath);
         return supabasePath;
       } catch {
         currentDir = path.dirname(currentDir);
@@ -320,4 +320,17 @@ class MigratePromoteCommand extends Command {
   }
 }
 
-module.exports = MigratePromoteCommand;
+/**
+ * Promote tested migration to production handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} Promotion result
+ */
+export default async function promoteHandler(args, config, logger, isProd) {
+  const command = new MigratePromoteCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigratePromoteCommand };

starfleet/data-cli/src/commands/db/migrate/rollback.js

@@ -2,13 +2,16 @@
  * Migration Rollback Command
  */
 
-const DatabaseCommand = require('../../../lib/DatabaseCommand');
-const fs = require('fs').promises;
-const path = require('path');
+import DatabaseCommand from '../../../lib/DatabaseCommand.js';
+import { promises as fs } from 'fs';
+import path from 'path';
 
 /**
  * Rollback migration to previous state with confirmation
  */
+/**
+ * @class
+ */
 class MigrateRollbackCommand extends DatabaseCommand {
   static description = 'Rollback migration to previous state';
   static requiresConfirmation = true;
@@ -182,4 +185,17 @@ class MigrateRollbackCommand extends DatabaseCommand {
   }
 }
 
-module.exports = MigrateRollbackCommand;
+/**
+ * Migration rollback handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} Rollback result
+ */
+export default async function rollbackHandler(args, config, logger, isProd) {
+  const command = new MigrateRollbackCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigrateRollbackCommand };

starfleet/data-cli/src/commands/db/migrate/squash.js

@@ -2,13 +2,16 @@
  * Migration Squash Command
  */
 
-const Command = require('../../../lib/Command');
-const fs = require('fs').promises;
-const path = require('path');
+import Command from '../../../lib/Command.js';
+import { promises as fs } from 'fs';
+import path from 'path';
 
 /**
  * Squash multiple migrations into a single migration file
  */
+/**
+ * @class
+ */
 class MigrateSquashCommand extends Command {
   static description = 'Squash multiple migrations';
 
@@ -348,4 +351,17 @@ class MigrateSquashCommand extends Command {
   }
 }
 
-module.exports = MigrateSquashCommand;
+/**
+ * Migration squash handler
+ * @param {Object} args - Command arguments
+ * @param {Object} config - Configuration object
+ * @param {Object} logger - Logger instance
+ * @param {boolean} isProd - Production flag
+ * @returns {Promise<Object>} Squash result
+ */
+export default async function squashHandler(args, config, logger, isProd) {
+  const command = new MigrateSquashCommand(config, logger, isProd);
+  return await command.performExecute(args);
+}
+
+export { MigrateSquashCommand };