mage-remote-run 0.12.0 → 0.14.0

package/bin/mage-remote-run.js

@@ -11,24 +11,24 @@ const pkg = require('../package.json');
 const program = new Command();
 
 program
-    .name('mage-remote-run')
-    .description('The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce')
-    .version(pkg.version)
-    .configureHelp({
-        visibleCommands: (cmd) => {
-            const commands = cmd.commands.filter(c => !c._hidden);
-            return commands.sort((a, b) => {
-                if (a.name() === 'connection') return -1;
-                if (b.name() === 'connection') return 1;
-                return a.name().localeCompare(b.name());
-            });
-        },
-        subcommandTerm: (cmd) => chalk.cyan(cmd.name()),
-        subcommandDescription: (cmd) => chalk.gray(cmd.description()),
-        optionTerm: (option) => chalk.yellow(option.flags),
-        optionDescription: (option) => chalk.gray(option.description)
-    })
-    .addHelpText('before', chalk.hex('#FFA500')(`
+  .name('mage-remote-run')
+  .description('The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce')
+  .version(pkg.version)
+  .configureHelp({
+    visibleCommands: (cmd) => {
+      const commands = cmd.commands.filter(c => !c._hidden);
+      return commands.sort((a, b) => {
+        if (a.name() === 'connection') return -1;
+        if (b.name() === 'connection') return 1;
+        return a.name().localeCompare(b.name());
+      });
+    },
+    subcommandTerm: (cmd) => chalk.cyan(cmd.name()),
+    subcommandDescription: (cmd) => chalk.gray(cmd.description()),
+    optionTerm: (option) => chalk.yellow(option.flags),
+    optionDescription: (option) => chalk.gray(option.description)
+  })
+  .addHelpText('before', chalk.hex('#FFA500')(`
    _ __ ___   __ _  __ _  ___      _ __ ___ _ __ ___   ___ | |_ ___      _ __ _   _ _ __ 
   | '_ \` _ \\ / _\` |/ _\` |/ _ \\____| '__/ _ \\ '_ \` _ \\ / _ \\| __/ _ \\____| '__| | | | '_ \\
   | | | | | | (_| | (_| |  __/____| | |  __/ | | | | | (_) | ||  __/____| |  | |_| | | | |
@@ -38,55 +38,49 @@ program
 
 
 
-import { registerWebsitesCommands } from '../lib/commands/websites.js';
-import { registerStoresCommands } from '../lib/commands/stores.js';
-import { registerConnectionCommands } from '../lib/commands/connections.js';
-import { registerCustomersCommands } from '../lib/commands/customers.js';
-import { registerOrdersCommands } from '../lib/commands/orders.js';
-import { registerEavCommands } from '../lib/commands/eav.js';
-import { registerProductsCommands } from '../lib/commands/products.js';
-import { registerCompanyCommands } from '../lib/commands/company.js';
-import { registerTaxCommands } from '../lib/commands/tax.js';
-import { registerInventoryCommands } from '../lib/commands/inventory.js';
-import { registerAdobeIoEventsCommands } from '../lib/commands/adobe-io-events.js';
-import { registerWebhooksCommands } from '../lib/commands/webhooks.js';
+import {
+  registerConnectionCommands,
+  registerCoreCommands,
+  registerCloudCommands
+} from '../lib/command-registry.js';
 import { getActiveProfile } from '../lib/config.js';
+import { startMcpServer } from '../lib/mcp.js';
 
 registerConnectionCommands(program);
 
+program.command('mcp')
+  .description('Run as MCP server')
+  .option('--transport <type>', 'Transport type (stdio, http)', 'stdio')
+  .option('--host <host>', 'HTTP Host', '127.0.0.1')
+  .option('--port <port>', 'HTTP Port', '18098')
+  .action(async (options) => {
+    await startMcpServer(options);
+  });
+
 const profile = await getActiveProfile();
 
 if (profile) {
-    registerWebsitesCommands(program);
-    registerStoresCommands(program);
-    registerCustomersCommands(program);
-    registerOrdersCommands(program);
-    registerEavCommands(program);
-    registerProductsCommands(program);
-    registerTaxCommands(program);
-    registerInventoryCommands(program);
-
-    if (profile.type === 'ac-cloud-paas' || profile.type === 'ac-saas') {
-        registerAdobeIoEventsCommands(program);
-        registerCompanyCommands(program);
-        registerWebhooksCommands(program);
-    }
+  registerCoreCommands(program);
+
+  if (profile.type === 'ac-cloud-paas' || profile.type === 'ac-saas') {
+    registerCloudCommands(program);
+  }
 }
 
 program.hook('preAction', async (thisCommand, actionCommand) => {
-    // Check if we have an active profile and if format is not json/xml
-    // Note: 'options' are available on the command that has them defined.
-    // actionCommand is the command actually being executed.
-    if (profile) {
-        const config = await loadConfig();
-        if (config.showActiveConnectionHeader !== false) {
-            const opts = actionCommand.opts();
-            if (opts.format !== 'json' && opts.format !== 'xml') {
-                console.log(chalk.cyan(`Active Connection: ${chalk.bold(profile.name)} (${profile.type})`));
-                console.log(chalk.gray('━'.repeat(60)) + '\n');
-            }
-        }
+  // Check if we have an active profile and if format is not json/xml
+  // Note: 'options' are available on the command that has them defined.
+  // actionCommand is the command actually being executed.
+  if (profile) {
+    const config = await loadConfig();
+    if (config.showActiveConnectionHeader !== false) {
+      const opts = actionCommand.opts();
+      if (opts.format !== 'json' && opts.format !== 'xml') {
+        console.log(chalk.cyan(`Active Connection: ${chalk.bold(profile.name)} (${profile.type})`));
+        console.log(chalk.gray('━'.repeat(60)) + '\n');
+      }
     }
+  }
 });
 
 import { expandCommandAbbreviations } from '../lib/command-helper.js';
@@ -100,28 +94,28 @@ const config = await loadConfig();
 const hasProfiles = Object.keys(config.profiles || {}).length > 0;
 
 if (!hasProfiles && args.length === 0) {
-    console.log(chalk.bold.blue('Welcome to mage-remote-run! 🚀'));
-    console.log(chalk.gray('The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce'));
-    console.log(chalk.gray('It looks like you haven\'t configured any connections yet.'));
-    console.log(chalk.gray('Let\'s set up your first connection now.\n'));
-
-    // Trigger the interactive add command directly
-    // We can simulate running the 'connection add' command
-    // But since we are at top level, we might need to invoke it manually or parse specific args.
-    // Easiest is to manually invoke program.parse with ['node', 'script', 'connection', 'add']
-    // BUT program.parse executes asynchronously usually? commander is synchronous by default but actions are async.
-    // Let's modify process.argv before parsing.
-    args = ['connection', 'add'];
+  console.log(chalk.bold.blue('Welcome to mage-remote-run! 🚀'));
+  console.log(chalk.gray('The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce'));
+  console.log(chalk.gray('It looks like you haven\'t configured any connections yet.'));
+  console.log(chalk.gray('Let\'s set up your first connection now.\n'));
+
+  // Trigger the interactive add command directly
+  // We can simulate running the 'connection add' command
+  // But since we are at top level, we might need to invoke it manually or parse specific args.
+  // Easiest is to manually invoke program.parse with ['node', 'script', 'connection', 'add']
+  // BUT program.parse executes asynchronously usually? commander is synchronous by default but actions are async.
+  // Let's modify process.argv before parsing.
+  args = ['connection', 'add'];
 }
 
 try {
-    args = expandCommandAbbreviations(program, args);
+  args = expandCommandAbbreviations(program, args);
 } catch (e) {
-    if (e.isAmbiguous) {
-        console.error(e.message);
-        process.exit(1);
-    }
-    throw e;
+  if (e.isAmbiguous) {
+    console.error(e.message);
+    process.exit(1);
+  }
+  throw e;
 }
 process.argv = [...process.argv.slice(0, 2), ...args];
 

package/lib/command-registry.js

@@ -0,0 +1,68 @@
+import { registerWebsitesCommands } from './commands/websites.js';
+import { registerStoresCommands } from './commands/stores.js';
+import { registerConnectionCommands } from './commands/connections.js';
+import { registerCustomersCommands } from './commands/customers.js';
+import { registerOrdersCommands } from './commands/orders.js';
+import { registerEavCommands } from './commands/eav.js';
+import { registerProductsCommands } from './commands/products.js';
+import { registerCompanyCommands } from './commands/company.js';
+import { registerTaxCommands } from './commands/tax.js';
+import { registerInventoryCommands } from './commands/inventory.js';
+import { registerAdobeIoEventsCommands } from './commands/adobe-io-events.js';
+import { registerWebhooksCommands } from './commands/webhooks.js';
+import { registerConsoleCommand } from './commands/console.js';
+
+export { registerConnectionCommands, registerConsoleCommand };
+
+export function registerCoreCommands(program) {
+  registerWebsitesCommands(program);
+  registerStoresCommands(program);
+  registerCustomersCommands(program);
+  registerOrdersCommands(program);
+  registerEavCommands(program);
+  registerProductsCommands(program);
+  registerTaxCommands(program);
+  registerInventoryCommands(program);
+  registerConsoleCommand(program);
+}
+
+export function registerCloudCommands(program) {
+  registerAdobeIoEventsCommands(program);
+  registerCompanyCommands(program);
+  registerWebhooksCommands(program);
+}
+
+export function registerAllCommands(program) {
+  registerConnectionCommands(program);
+  registerCoreCommands(program);
+  registerCloudCommands(program);
+}
+
+// Alias for backwards compatibility with console.js (and potential other usages)
+export const registerCommands = (program, profile) => {
+  // Note: console.js passes profile, but registerAllCommands doesn't strictly use it 
+  // (it registers everything, profile checks happen inside or via selective registration).
+  // The original behavior in console.js:
+  // const profile = await getActiveProfile();
+  // registerCommands(localProgram, profile);
+
+  // In bin/mage-remote-run.js old logic:
+  // registerConnectionCommands(program);
+  // if (profile) { registerWebsitesCommands... }
+
+  // We should replicate that 'selective' registration if we want to match exact behavior?
+  // BUT console.js wants to register ALL available commands for the profile.
+
+  registerConnectionCommands(program);
+
+  // Simple logic: If profile exists, register all. 
+  // console.js usage implies profile is present if it's running (or it tries to get it).
+
+  if (profile) {
+    registerCoreCommands(program);
+    // Cloud check
+    if (profile.type === 'ac-cloud-paas' || profile.type === 'ac-saas') {
+      registerCloudCommands(program);
+    }
+  }
+};

package/lib/commands/adobe-io-events.js

@@ -5,6 +5,10 @@ import chalk from 'chalk';
 export function registerAdobeIoEventsCommands(program) {
     const adobeIoEvents = program.command('adobe-io-event').description('Manage Adobe I/O Events');
 
+
+    //-------------------------------------------------------
+    // "adobe-io-event check-configuration" Command
+    //-------------------------------------------------------
     adobeIoEvents.command('check-configuration')
         .description('Check Adobe I/O Event configuration')
         .option('-f, --format <type>', 'Output format (text, json, xml)', 'text')

package/lib/commands/company.js

@@ -5,6 +5,10 @@ import chalk from 'chalk';
 export function registerCompanyCommands(program) {
     const company = program.command('company').description('Manage companies');
 
+
+    //-------------------------------------------------------
+    // "company list" Command
+    //-------------------------------------------------------
     company.command('list')
         .description('List companies')
         .option('-p, --page <number>', 'Page number', '1')
@@ -56,6 +60,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "company show" Command
+    //-------------------------------------------------------
     company.command('show <companyId>')
         .description('Show company details')
         .option('-f, --format <type>', 'Output format (text, json, xml)', 'text')

package/lib/commands/connections.js

@@ -60,6 +60,10 @@ async function configureAndTestConnection(name, initialSettings = {}) {
 export function registerConnectionCommands(program) {
     const connections = program.command('connection').description('Manage mage-remote-run connection profiles');
 
+
+    //-------------------------------------------------------
+    // "connection add" Command
+    //-------------------------------------------------------
     connections.command('add')
         .description('Configure a new connection profile')
         .addHelpText('after', `
@@ -106,6 +110,10 @@ Examples:
             }
         });
 
+
+    //-------------------------------------------------------
+    // "connection list" Command
+    //-------------------------------------------------------
     connections.command('list')
         .description('List connection profiles')
         .addHelpText('after', `
@@ -125,6 +133,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection search" Command
+    //-------------------------------------------------------
     connections.command('search <query>')
         .description('Search connection profiles')
         .addHelpText('after', `
@@ -140,6 +152,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection delete" Command
+    //-------------------------------------------------------
     connections.command('delete <name>')
         .description('Delete a connection profile')
         .addHelpText('after', `
@@ -161,6 +177,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection edit" Command
+    //-------------------------------------------------------
     connections.command('edit [name]')
         .description('Edit a connection profile')
         .addHelpText('after', `
@@ -208,6 +228,10 @@ Examples:
             }
         });
 
+
+    //-------------------------------------------------------
+    // "connection test" Command
+    //-------------------------------------------------------
     connections.command('test')
         .description('Test connection(s)')
         .option('--all', 'Test all configured connections')
@@ -270,6 +294,10 @@ Examples:
                 if (process.env.DEBUG) console.error(e);
             }
         });
+
+    //-------------------------------------------------------
+    // "connection status" Command
+    //-------------------------------------------------------
     connections.command('status')
         .description('Show current configuration status')
         .addHelpText('after', `
@@ -294,6 +322,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection select" Command
+    //-------------------------------------------------------
     connections.command('select')
         .description('Select the active connection profile (aliases: change, switch)')
         .aliases(['switch', 'change'])
@@ -317,12 +349,20 @@ Examples:
                     default: config.activeProfile
                 });
 
+                if (process.env.DEBUG) {
+                    console.log(chalk.gray(`DEBUG: Selected profile: ${selected}`));
+                }
+
                 config.activeProfile = selected;
                 await saveConfig(config);
                 console.log(chalk.green(`Active profile set to "${selected}".`));
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection clear-token-cache" Command
+    //-------------------------------------------------------
     connections.command('clear-token-cache')
         .description('Clear cached access tokens')
         .addHelpText('after', `
@@ -336,6 +376,10 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+
+    //-------------------------------------------------------
+    // "connection status-header" Command
+    //-------------------------------------------------------
     connections.command('status-header <state>')
         .description('Enable or disable the active connection header (on|off)')
         .addHelpText('after', `
@@ -353,6 +397,8 @@ Examples:
                 config.showActiveConnectionHeader = state === 'on';
                 await saveConfig(config);
                 console.log(chalk.green(`Active connection header is now ${state === 'on' ? 'enabled' : 'disabled'}.`));
-            } catch (e) { handleError(e); }
+            } catch (e) {
+                handleError(e);
+            }
         });
 }