pal-explorer-cli 0.4.11 → 0.4.13

package/lib/commands/federation.js

@@ -1,270 +1,270 @@
-import chalk from 'chalk';
-
-export default function federationCommand(program) {
-  const cmd = program
-    .command('federation')
-    .description('manage federation between discovery servers (Enterprise)')
-    .addHelpText('after', `
-Examples:
-  $ pe federation registry add https://discovery2.example.com
-  $ pe federation registry list
-  $ pe federation registry resolve @user@server.com
-  $ pe federation bridge add https://network2.example.com
-  $ pe federation bridge stats
-`)
-    .action(() => { cmd.outputHelp(); });
-
-  // --- Registry subcommands ---
-  const registry = cmd
-    .command('registry')
-    .description('manage federated discovery server registry')
-    .action(() => { registry.outputHelp(); });
-
-  registry
-    .command('add <url>')
-    .description('add a discovery server to federation registry')
-    .option('--trust <level>', 'trust level: trusted, verified, unknown', 'unknown')
-    .action(async (url, opts) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const servers = extConfig.get('ext_store.federation-registry')?.registry || {};
-        const id = url.replace(/[^a-z0-9]/gi, '_');
-        servers[id] = {
-          url,
-          trust: opts.trust,
-          category: 'public',
-          trustScore: opts.trust === 'trusted' ? 100 : 0,
-          lastSeen: null,
-          healthy: null,
-          addedAt: new Date().toISOString(),
-        };
-        const store = extConfig.get('ext_store.federation-registry') || {};
-        store.registry = servers;
-        extConfig.set('ext_store.federation-registry', store);
-        console.log(chalk.green(`✔ Server added to federation registry: ${url}`));
-        console.log(`  Trust: ${chalk.white(opts.trust)}`);
-      } catch (err) {
-        console.log(chalk.red(`Failed to add server: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  registry
-    .command('remove <url>')
-    .description('remove a server from federation registry')
-    .action(async (url) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-registry') || {};
-        const registry = store.registry || {};
-        const id = url.replace(/[^a-z0-9]/gi, '_');
-        if (!registry[id]) {
-          console.log(chalk.yellow(`Server not found in registry: ${url}`));
-          process.exitCode = 1;
-          return;
-        }
-        delete registry[id];
-        store.registry = registry;
-        extConfig.set('ext_store.federation-registry', store);
-        console.log(chalk.green(`✔ Server removed from registry: ${url}`));
-      } catch (err) {
-        console.log(chalk.red(`Failed to remove server: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  registry
-    .command('list')
-    .description('list all servers in federation registry')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-registry') || {};
-        const registry = store.registry || {};
-        const entries = Object.values(registry);
-        if (entries.length === 0) {
-          console.log(chalk.dim('No servers in federation registry.'));
-          return;
-        }
-        console.log(chalk.bold(`Federation Registry (${entries.length} servers)\n`));
-        for (const s of entries) {
-          const health = s.healthy === true ? chalk.green('●') : s.healthy === false ? chalk.red('●') : chalk.dim('○');
-          console.log(`  ${health} ${chalk.cyan(s.url)}`);
-          console.log(`    Trust: ${chalk.white(s.trust)}  Score: ${s.trustScore}  Added: ${s.addedAt || 'unknown'}`);
-        }
-      } catch (err) {
-        console.log(chalk.red(`Failed to list registry: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  registry
-    .command('peer <url>')
-    .description('initiate peering handshake with another server')
-    .action(async (url) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-registry') || {};
-        const registry = store.registry || {};
-        const id = url.replace(/[^a-z0-9]/gi, '_');
-        if (!registry[id]) {
-          console.log(chalk.yellow(`Server not in registry. Add it first with: pe federation registry add ${url}`));
-          process.exitCode = 1;
-          return;
-        }
-        registry[id].trust = 'verified';
-        registry[id].trustScore = Math.max(registry[id].trustScore || 0, 50);
-        registry[id].lastSeen = new Date().toISOString();
-        store.registry = registry;
-        extConfig.set('ext_store.federation-registry', store);
-        console.log(chalk.green(`✔ Peering initiated with: ${url}`));
-        console.log(`  Trust level upgraded to: ${chalk.white('verified')}`);
-      } catch (err) {
-        console.log(chalk.red(`Peering failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  registry
-    .command('resolve <handle>')
-    .description('resolve a handle across federated servers (e.g. @user@server.com)')
-    .action(async (handle) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-registry') || {};
-        const registry = store.registry || {};
-        const entries = Object.values(registry).filter(s => s.healthy !== false);
-
-        if (entries.length === 0) {
-          console.log(chalk.yellow('No healthy servers in federation registry.'));
-          process.exitCode = 1;
-          return;
-        }
-
-        let parts = handle.replace(/^@/, '').split('@');
-        let username = parts[0];
-        let server = parts[1] || null;
-
-        console.log(chalk.dim(`Resolving ${handle} across ${entries.length} server(s)...`));
-
-        if (server) {
-          const match = entries.find(s => s.url.includes(server));
-          if (match) {
-            console.log(chalk.green(`✔ Resolved via ${match.url}`));
-            console.log(`  Handle: ${chalk.cyan('@' + username)}`);
-            console.log(`  Server: ${chalk.white(match.url)}`);
-          } else {
-            console.log(chalk.yellow(`Server ${server} not in registry.`));
-            process.exitCode = 1;
-          }
-        } else {
-          console.log(chalk.dim(`Querying all ${entries.length} servers for @${username}...`));
-          for (const s of entries) {
-            console.log(`  ${chalk.dim('→')} ${s.url}: ${chalk.dim('queried')}`);
-          }
-          console.log(chalk.green(`✔ Resolution complete.`));
-        }
-      } catch (err) {
-        console.log(chalk.red(`Resolution failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  // --- Bridge subcommands ---
-  const bridge = cmd
-    .command('bridge')
-    .description('manage federation bridge connections')
-    .action(() => { bridge.outputHelp(); });
-
-  bridge
-    .command('add <url>')
-    .description('connect to a federated network')
-    .option('--relay-policy <policy>', 'relay policy: none, all', 'none')
-    .action(async (url, opts) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-bridge') || {};
-        const networks = store.bridgedNetworks || [];
-        if (networks.includes(url)) {
-          console.log(chalk.yellow(`Already bridged to: ${url}`));
-          return;
-        }
-        networks.push(url);
-        store.bridgedNetworks = networks;
-        store.relayPolicy = opts.relayPolicy;
-        extConfig.set('ext_store.federation-bridge', store);
-        console.log(chalk.green(`✔ Bridge connected to: ${url}`));
-        console.log(`  Relay policy: ${chalk.white(opts.relayPolicy)}`);
-      } catch (err) {
-        console.log(chalk.red(`Bridge failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  bridge
-    .command('remove <url>')
-    .description('disconnect from a federated network')
-    .action(async (url) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-bridge') || {};
-        const networks = store.bridgedNetworks || [];
-        const idx = networks.indexOf(url);
-        if (idx === -1) {
-          console.log(chalk.yellow(`Not bridged to: ${url}`));
-          process.exitCode = 1;
-          return;
-        }
-        networks.splice(idx, 1);
-        store.bridgedNetworks = networks;
-        extConfig.set('ext_store.federation-bridge', store);
-        console.log(chalk.green(`✔ Bridge disconnected from: ${url}`));
-      } catch (err) {
-        console.log(chalk.red(`Failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  bridge
-    .command('list')
-    .description('list all bridge connections')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-bridge') || {};
-        const networks = store.bridgedNetworks || [];
-        if (networks.length === 0) {
-          console.log(chalk.dim('No bridge connections.'));
-          return;
-        }
-        console.log(chalk.bold(`Federation Bridges (${networks.length})\n`));
-        for (const url of networks) {
-          console.log(`  ${chalk.green('●')} ${chalk.cyan(url)}`);
-        }
-        console.log(`\n  Relay policy: ${chalk.white(store.relayPolicy || 'none')}`);
-      } catch (err) {
-        console.log(chalk.red(`Failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  bridge
-    .command('stats')
-    .description('show bridge relay statistics')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.federation-bridge') || {};
-        const networks = store.bridgedNetworks || [];
-        const messageLog = store.messageLog || [];
-        console.log(chalk.bold('Bridge Statistics\n'));
-        console.log(`  Connected networks: ${chalk.white(networks.length)}`);
-        console.log(`  Messages relayed:   ${chalk.white(messageLog.length)}`);
-        console.log(`  Relay policy:       ${chalk.white(store.relayPolicy || 'none')}`);
-        console.log(`  Last activity:      ${chalk.white(store.lastActivity || 'never')}`);
-      } catch (err) {
-        console.log(chalk.red(`Failed: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-}
+import chalk from 'chalk';
+
+export default function federationCommand(program) {
+  const cmd = program
+    .command('federation')
+    .description('manage federation between discovery servers (Enterprise)')
+    .addHelpText('after', `
+Examples:
+  $ pal federation registry add https://discovery2.example.com
+  $ pal federation registry list
+  $ pal federation registry resolve @user@server.com
+  $ pal federation bridge add https://network2.example.com
+  $ pal federation bridge stats
+`)
+    .action(() => { cmd.outputHelp(); });
+
+  // --- Registry subcommands ---
+  const registry = cmd
+    .command('registry')
+    .description('manage federated discovery server registry')
+    .action(() => { registry.outputHelp(); });
+
+  registry
+    .command('add <url>')
+    .description('add a discovery server to federation registry')
+    .option('--trust <level>', 'trust level: trusted, verified, unknown', 'unknown')
+    .action(async (url, opts) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const servers = extConfig.get('ext_store.federation-registry')?.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        servers[id] = {
+          url,
+          trust: opts.trust,
+          category: 'public',
+          trustScore: opts.trust === 'trusted' ? 100 : 0,
+          lastSeen: null,
+          healthy: null,
+          addedAt: new Date().toISOString(),
+        };
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        store.registry = servers;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Server added to federation registry: ${url}`));
+        console.log(`  Trust: ${chalk.white(opts.trust)}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed to add server: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('remove <url>')
+    .description('remove a server from federation registry')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        if (!registry[id]) {
+          console.log(chalk.yellow(`Server not found in registry: ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        delete registry[id];
+        store.registry = registry;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Server removed from registry: ${url}`));
+      } catch (err) {
+        console.log(chalk.red(`Failed to remove server: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('list')
+    .description('list all servers in federation registry')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const entries = Object.values(registry);
+        if (entries.length === 0) {
+          console.log(chalk.dim('No servers in federation registry.'));
+          return;
+        }
+        console.log(chalk.bold(`Federation Registry (${entries.length} servers)\n`));
+        for (const s of entries) {
+          const health = s.healthy === true ? chalk.green('●') : s.healthy === false ? chalk.red('●') : chalk.dim('○');
+          console.log(`  ${health} ${chalk.cyan(s.url)}`);
+          console.log(`    Trust: ${chalk.white(s.trust)}  Score: ${s.trustScore}  Added: ${s.addedAt || 'unknown'}`);
+        }
+      } catch (err) {
+        console.log(chalk.red(`Failed to list registry: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('peer <url>')
+    .description('initiate peering handshake with another server')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        if (!registry[id]) {
+          console.log(chalk.yellow(`Server not in registry. Add it first with: pal federation registry add ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        registry[id].trust = 'verified';
+        registry[id].trustScore = Math.max(registry[id].trustScore || 0, 50);
+        registry[id].lastSeen = new Date().toISOString();
+        store.registry = registry;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Peering initiated with: ${url}`));
+        console.log(`  Trust level upgraded to: ${chalk.white('verified')}`);
+      } catch (err) {
+        console.log(chalk.red(`Peering failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('resolve <handle>')
+    .description('resolve a handle across federated servers (e.g. @user@server.com)')
+    .action(async (handle) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const entries = Object.values(registry).filter(s => s.healthy !== false);
+
+        if (entries.length === 0) {
+          console.log(chalk.yellow('No healthy servers in federation registry.'));
+          process.exitCode = 1;
+          return;
+        }
+
+        let parts = handle.replace(/^@/, '').split('@');
+        let username = parts[0];
+        let server = parts[1] || null;
+
+        console.log(chalk.dim(`Resolving ${handle} across ${entries.length} server(s)...`));
+
+        if (server) {
+          const match = entries.find(s => s.url.includes(server));
+          if (match) {
+            console.log(chalk.green(`✔ Resolved via ${match.url}`));
+            console.log(`  Handle: ${chalk.cyan('@' + username)}`);
+            console.log(`  Server: ${chalk.white(match.url)}`);
+          } else {
+            console.log(chalk.yellow(`Server ${server} not in registry.`));
+            process.exitCode = 1;
+          }
+        } else {
+          console.log(chalk.dim(`Querying all ${entries.length} servers for @${username}...`));
+          for (const s of entries) {
+            console.log(`  ${chalk.dim('→')} ${s.url}: ${chalk.dim('queried')}`);
+          }
+          console.log(chalk.green(`✔ Resolution complete.`));
+        }
+      } catch (err) {
+        console.log(chalk.red(`Resolution failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  // --- Bridge subcommands ---
+  const bridge = cmd
+    .command('bridge')
+    .description('manage federation bridge connections')
+    .action(() => { bridge.outputHelp(); });
+
+  bridge
+    .command('add <url>')
+    .description('connect to a federated network')
+    .option('--relay-policy <policy>', 'relay policy: none, all', 'none')
+    .action(async (url, opts) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        if (networks.includes(url)) {
+          console.log(chalk.yellow(`Already bridged to: ${url}`));
+          return;
+        }
+        networks.push(url);
+        store.bridgedNetworks = networks;
+        store.relayPolicy = opts.relayPolicy;
+        extConfig.set('ext_store.federation-bridge', store);
+        console.log(chalk.green(`✔ Bridge connected to: ${url}`));
+        console.log(`  Relay policy: ${chalk.white(opts.relayPolicy)}`);
+      } catch (err) {
+        console.log(chalk.red(`Bridge failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('remove <url>')
+    .description('disconnect from a federated network')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        const idx = networks.indexOf(url);
+        if (idx === -1) {
+          console.log(chalk.yellow(`Not bridged to: ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        networks.splice(idx, 1);
+        store.bridgedNetworks = networks;
+        extConfig.set('ext_store.federation-bridge', store);
+        console.log(chalk.green(`✔ Bridge disconnected from: ${url}`));
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('list')
+    .description('list all bridge connections')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        if (networks.length === 0) {
+          console.log(chalk.dim('No bridge connections.'));
+          return;
+        }
+        console.log(chalk.bold(`Federation Bridges (${networks.length})\n`));
+        for (const url of networks) {
+          console.log(`  ${chalk.green('●')} ${chalk.cyan(url)}`);
+        }
+        console.log(`\n  Relay policy: ${chalk.white(store.relayPolicy || 'none')}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('stats')
+    .description('show bridge relay statistics')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        const messageLog = store.messageLog || [];
+        console.log(chalk.bold('Bridge Statistics\n'));
+        console.log(`  Connected networks: ${chalk.white(networks.length)}`);
+        console.log(`  Messages relayed:   ${chalk.white(messageLog.length)}`);
+        console.log(`  Relay policy:       ${chalk.white(store.relayPolicy || 'none')}`);
+        console.log(`  Last activity:      ${chalk.white(store.lastActivity || 'never')}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+}