pal-explorer-cli 0.4.13 → 0.4.15

package/bin/pal.js

@@ -3,9 +3,13 @@
 // Enable V8 code caching for faster subsequent boots
 import 'v8-compile-cache-lib';
 
+import { createRequire } from 'module';
 import { program } from 'commander';
 import chalk from 'chalk';
 
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+
 // Utility for lazy loading commands
 const lazy = (path) => async (program) => {
   const mod = await import(path);
@@ -49,7 +53,7 @@ logger.applyGlobalOverride();
 program
   .name('pal')
   .description('p2p file sharing for friends')
-  .version('0.4.0')
+  .version(version)
   .option('--json', 'output in JSON format')
   .option('--log-level <level>', 'set log level (debug, info, warn, error, silent)');
 
@@ -98,6 +102,10 @@ const commands = [
   ['network', '../lib/commands/network.js'],
   ['search', '../lib/commands/search.js'],
   ['connect', '../lib/commands/connect.js'],
+  ['disconnect', '../lib/commands/connect.js'],
+  ['login', '../lib/commands/user.js'],
+  ['logout', '../lib/commands/user.js'],
+  ['verify', '../lib/commands/register.js'],
   ['protocol', '../lib/commands/protocol.js'],
   ['workspace', '../lib/commands/workspace.js'],
   ['favorite', '../lib/commands/favorite.js'],
@@ -146,9 +154,21 @@ if (cmdMatch) {
 } else if (isVersionOrHelp) {
   // Help/version — load all commands for full help text, skip migrations
   await Promise.all(commands.map(c => lazy(c[1])(program)));
+} else if (currentCmd && !currentCmd.startsWith('-')) {
+  // Unknown command — suggest similar commands
+  const { suggest } = await import('../lib/utils/fuzzy.js');
+  const allNames = commands.map(c => c[0]);
+  const suggestions = suggest(currentCmd, allNames);
+  if (suggestions.length) {
+    console.error(chalk.red(`Unknown command: ${currentCmd}`));
+    console.error(chalk.yellow(`\nDid you mean?\n${suggestions.map(s => `  pal ${s}`).join('\n')}`));
+  } else {
+    console.error(chalk.red(`Unknown command: ${currentCmd}`));
+    console.error(chalk.gray('Run "pal --help" to see available commands.'));
+  }
+  process.exitCode = 1;
 } else {
-  // Unknown command — load all for Commander to handle
-  await runMigrations();
+  // Flag-only args (--help, --version handled above) — load all
   await Promise.all(commands.map(c => lazy(c[1])(program)));
 }
 
@@ -158,7 +178,7 @@ ${chalk.cyan.bold('Command Groups:')}
 
   ${chalk.yellow('Identity:')}     init, whoami, register, verify, recover
   ${chalk.yellow('Users:')}        user list/add/remove/promote, login
-  ${chalk.yellow('Sharing:')}      share, list, revoke, serve, download, share-link, share-rename, permissions
+  ${chalk.yellow('Sharing:')}      share, list, revoke, serve, download, share-link, permissions
   ${chalk.yellow('Sync:')}         sync push/pull/status/watch/list/remove/diff
   ${chalk.yellow('Files:')}        file ls/tree/info/copy/move/rename/mkdir/delete/search/open/reveal/audit
   ${chalk.yellow('Remote:')}       remote browse/files/download
@@ -279,7 +299,7 @@ if (!process.argv.slice(2).length) {
 }
 
 // keytar's native D-Bus handles block the event loop on headless Linux
-const longRunning = new Set(['serve', 'nearby', 'stream']);
+const longRunning = new Set(['serve', 'nearby', 'stream', 'download']);
 if (!longRunning.has(currentCmd)) {
   // Flush analytics and run shutdown hooks before exiting
   if (extensionsLoaded) {

package/lib/commands/backup.js

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
 import { createBackup, restoreBackup } from '../core/backup.js';
+import { isPro } from '../core/pro.js';
 
 export default function backupCommand(program) {
   const cmd = program
@@ -25,6 +26,11 @@ Examples:
     .option('-p, --password <password>', 'Encryption password')
     .action(async (opts) => {
       try {
+        if (!isPro()) {
+          console.log(chalk.red('Backup requires a Pro plan. Upgrade with `pal upgrade`.'));
+          process.exitCode = 1;
+          return;
+        }
         const password = opts.password || process.env.PAL_BACKUP_PASSWORD;
         if (!password) {
           console.log(chalk.red('Password required. Use --password or PAL_BACKUP_PASSWORD env var.'));

package/lib/commands/chat.js

@@ -19,9 +19,24 @@ Examples:
       const chatStore = config.get('chatHistory') || {};
       const keys = Object.keys(chatStore);
       if (keys.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray('No conversations yet. Use `pal chat send <handle> "message"` to start one.'));
         return;
       }
+
+      if (program.opts().json) {
+        const conversations = keys.map(key => {
+          const msgs = chatStore[key] || [];
+          const last = msgs[msgs.length - 1];
+          return { handle: key, messageCount: msgs.length, lastMessage: last || null };
+        });
+        console.log(JSON.stringify(conversations, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Conversations:'));
       for (const key of keys) {
@@ -108,11 +123,21 @@ Examples:
       const chatStore = config.get('chatHistory') || {};
       const msgs = chatStore[handle] || [];
       if (msgs.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray(`No messages with ${handle}.`));
         return;
       }
       const limit = parseInt(opts.limit) || 20;
       const shown = msgs.slice(-limit);
+
+      if (program.opts().json) {
+        console.log(JSON.stringify(shown, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan(`Chat with ${handle} (${shown.length}/${msgs.length}):`));
       for (const m of shown) {

package/lib/commands/completion.js

@@ -8,10 +8,21 @@ _pal_completions() {
 
   local commands="init whoami register recover share download list revoke serve pal invite nearby group sync transfers config device server explorer status log completion web gui-share vfs file remote user schedule chat backup api-keys share-link comment update auth network search connect protocol workspace favorite pin stream uninstall extension ext billing permissions org su federation analytics webhook relay compliance sso rbac scim audit scanner notify cloud-backup dept"
 
+  local global_flags="--help --version --json --log-level"
+
+  # Complete flags anywhere
+  if [[ "\$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "\$global_flags" -- "\$cur") )
+    return
+  fi
+
+  # Handle top-level vs subcommand completion
+  if [[ \$COMP_CWORD -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "\$commands" -- "\$cur") )
+    return
+  fi
+
   case "\$prev" in
-    pal)
-      COMPREPLY=( $(compgen -W "\$commands" -- "\$cur") )
-      ;;
     pal)
       COMPREPLY=( $(compgen -W "add list remove" -- "\$cur") )
       ;;
@@ -66,6 +77,39 @@ _pal_completions() {
     explorer)
       COMPREPLY=( $(compgen -W "install uninstall" -- "\$cur") )
       ;;
+    network)
+      COMPREPLY=( $(compgen -W "create list info invite join members groups connect disconnect" -- "\$cur") )
+      ;;
+    stream)
+      COMPREPLY=( $(compgen -W "local remote stop status broadcast join transport" -- "\$cur") )
+      ;;
+    extension|ext)
+      COMPREPLY=( $(compgen -W "list install remove enable disable info config create" -- "\$cur") )
+      ;;
+    billing)
+      COMPREPLY=( $(compgen -W "status plans activate deactivate checkout" -- "\$cur") )
+      ;;
+    org)
+      COMPREPLY=( $(compgen -W "create list info invite remove subscribe unsubscribe billing" -- "\$cur") )
+      ;;
+    protocol)
+      COMPREPLY=( $(compgen -W "info policy route envelope keys" -- "\$cur") )
+      ;;
+    workspace)
+      COMPREPLY=( $(compgen -W "list create delete add remove" -- "\$cur") )
+      ;;
+    pin)
+      COMPREPLY=( $(compgen -W "set remove status" -- "\$cur") )
+      ;;
+    auth)
+      COMPREPLY=( $(compgen -W "login logout status" -- "\$cur") )
+      ;;
+    cloud-backup)
+      COMPREPLY=( $(compgen -W "create restore list status" -- "\$cur") )
+      ;;
+    --log-level)
+      COMPREPLY=( $(compgen -W "debug info warn error silent" -- "\$cur") )
+      ;;
     *)
       COMPREPLY=()
       ;;
@@ -148,6 +192,14 @@ _pe() {
     'dept:Department management'
   )
 
+  # Complete flags
+  if [[ "\$words[CURRENT]" == -* ]]; then
+    local -a flags
+    flags=('--help:Show help' '--version:Show version' '--json:Output as JSON' '--log-level:Set log level')
+    _describe 'flag' flags
+    return
+  fi
+
   if (( CURRENT == 2 )); then
     _describe 'command' commands
   elif (( CURRENT == 3 )); then
@@ -171,6 +223,16 @@ _pe() {
       api-keys) subcommands=('create:Create key' 'revoke:Revoke key'); _describe 'subcommand' subcommands ;;
       share-link) subcommands=('create:Create link' 'list:List links'); _describe 'subcommand' subcommands ;;
       update) subcommands=('check:Check for updates'); _describe 'subcommand' subcommands ;;
+      network) subcommands=('create:Create network' 'list:List networks' 'info:Network info' 'invite:Invite to network' 'join:Join network' 'members:List members' 'groups:List groups' 'connect:Connect' 'disconnect:Disconnect'); _describe 'subcommand' subcommands ;;
+      stream) subcommands=('local:Stream local file' 'remote:Stream remote file' 'stop:Stop stream' 'status:Stream status' 'broadcast:Broadcast stream' 'join:Join broadcast' 'transport:Transport settings'); _describe 'subcommand' subcommands ;;
+      extension|ext) subcommands=('list:List extensions' 'install:Install extension' 'remove:Remove extension' 'enable:Enable extension' 'disable:Disable extension' 'info:Extension info' 'config:Extension config' 'create:Create extension'); _describe 'subcommand' subcommands ;;
+      billing) subcommands=('status:Billing status' 'plans:View plans' 'activate:Activate plan' 'deactivate:Cancel plan' 'checkout:Open checkout'); _describe 'subcommand' subcommands ;;
+      org) subcommands=('create:Create org' 'list:List orgs' 'info:Org info' 'invite:Invite member' 'remove:Remove member' 'subscribe:Subscribe' 'unsubscribe:Unsubscribe' 'billing:Org billing'); _describe 'subcommand' subcommands ;;
+      protocol) subcommands=('info:Protocol info' 'policy:Policy rules' 'route:Routing table' 'envelope:Envelope tools' 'keys:Key management'); _describe 'subcommand' subcommands ;;
+      workspace) subcommands=('list:List workspaces' 'create:Create workspace' 'delete:Delete workspace' 'add:Add to workspace' 'remove:Remove from workspace'); _describe 'subcommand' subcommands ;;
+      pin) subcommands=('set:Pin a share' 'remove:Unpin a share' 'status:Pin status'); _describe 'subcommand' subcommands ;;
+      auth) subcommands=('login:Log in' 'logout:Log out' 'status:Auth status'); _describe 'subcommand' subcommands ;;
+      cloud-backup) subcommands=('create:Create backup' 'restore:Restore backup' 'list:List backups' 'status:Backup status'); _describe 'subcommand' subcommands ;;
     esac
   fi
 }

package/lib/commands/device.js

@@ -31,7 +31,7 @@ Examples:
     console.log(chalk.cyan('This Device:'));
     console.log(`  Device Name: ${chalk.white(device.name)}`);
     console.log(`  Device ID:   ${chalk.gray(device.id)}`);
-    console.log(`  Identity:    ${chalk.white(identity.name)}${identity.handle ? chalk.cyan(` @${identity.handle}`) : ''}`);
+    console.log(`  Identity:    ${chalk.white(identity.name)}${identity.handle ? chalk.cyan(` ${identity.handle.startsWith('@') ? identity.handle : '@' + identity.handle}`) : ''}`);
     console.log(`  Public Key:  ${chalk.gray(identity.publicKey)}`);
     console.log(`  Created At:  ${chalk.gray(device.createdAt)}`);
     console.log('');
@@ -103,8 +103,17 @@ Examples:
         const id = config.get('identity');
         handle = id?.handle;
         if (!handle) {
-          console.log(chalk.yellow('No handle registered. Provide one: pal device list <handle>'));
-          process.exitCode = 1;
+          const device = getDeviceInfo();
+          if (program.opts().json) {
+            console.log(JSON.stringify({ devices: [{ deviceName: device.name, deviceId: device.id, status: 'local', updatedAt: device.createdAt }] }, null, 2));
+            return;
+          }
+          console.log('');
+          console.log(chalk.cyan('Local device (no handle registered):'));
+          console.log(`  ${chalk.white(device.name)}  [${chalk.green('local')}]  ${chalk.gray(device.id)}`);
+          console.log(`    Created: ${chalk.gray(device.createdAt)}`);
+          console.log('');
+          console.log(chalk.gray('Register a handle to see remote devices: pal device register <handle>'));
           return;
         }
       }
@@ -124,7 +133,7 @@ Examples:
             console.log(JSON.stringify({ handle, devices: [] }, null, 2));
             return;
           }
-          console.log(chalk.gray(`No devices found for @${handle}.`));
+          console.log(chalk.gray(`No devices found for ${handle.startsWith('@') ? handle : '@' + handle}.`));
           return;
         }
         if (program.opts().json) {
@@ -132,7 +141,7 @@ Examples:
           return;
         }
         console.log('');
-        console.log(chalk.cyan(`Devices for @${handle}:`));
+        console.log(chalk.cyan(`Devices for ${handle.startsWith('@') ? handle : '@' + handle}:`));
         devices.forEach(d => {
           const status = d.status === 'online' ? chalk.green('online') : chalk.gray(d.status || 'offline');
           console.log(`  ${chalk.white(d.deviceName)}  [${status}]  ${chalk.gray(d.deviceId)}`);

package/lib/commands/download.js

@@ -18,7 +18,11 @@ function startMdnsIfNeeded() {
   if (identity?.publicKey) {
     const pidPath = path.join(path.dirname(config.path), 'serve.pid');
     const daemonRunning = fs.existsSync(pidPath);
-    startMdns(identity, { advertise: !daemonRunning });
+    try {
+      startMdns(identity, { advertise: !daemonRunning });
+    } catch (e) {
+      logger.warn(`mDNS start failed (port in use?): ${e.message}`);
+    }
   }
 }
 
@@ -51,7 +55,7 @@ Examples:
 
       if (allMagnets.length > 1) {
         console.log(chalk.blue(`Batch downloading ${allMagnets.length} items...`));
-        const client = new WebTorrent();
+        const client = new WebTorrent({ utp: false, lsd: false });
         let completed = 0;
         let failed = 0;
 
@@ -80,11 +84,14 @@ Examples:
                 });
               });
 
-              // Inject LAN peers and manual peer
-              if (lanPeers.length > 0) injectLanPeers(t, lanPeers);
-              if (opts.peer) {
-                try { t.addPeer(opts.peer); } catch (e) { console.error(chalk.yellow(`  Warning: Could not add peer ${opts.peer}: ${e.message}`)); }
-              }
+              // Inject LAN peers and manual peer after infoHash resolves
+              const injectBatchPeers = () => {
+                if (lanPeers.length > 0) injectLanPeers(t, lanPeers);
+                if (opts.peer) {
+                  try { t.addPeer(opts.peer); } catch (e) { console.error(chalk.yellow(`  Warning: Could not add peer ${opts.peer}: ${e.message}`)); }
+                }
+              };
+              if (t.infoHash) { injectBatchPeers(); } else { t.once('infoHash', injectBatchPeers); }
 
               client.on('error', (err) => { clearTimeout(timeout); reject(err); });
             });
@@ -151,7 +158,7 @@ Examples:
       }
       const spinner = ora('Finding peers...').start();
 
-      const client = new WebTorrent();
+      const client = new WebTorrent({ utp: false, lsd: false });
 
       const peerTimeout = setTimeout(() => {
         const torrents = client.torrents;
@@ -165,21 +172,23 @@ Examples:
       const addOpts = { path: dlDir };
       const torrentSrc = opts.lanOnly ? magnet : magnet;
 
+      const pendingPeer = opts.peer || null;
       client.add(torrentSrc, addOpts, (torrent) => {
         clearTimeout(peerTimeout);
         spinner.succeed(chalk.green(`Connected! Downloading: ${torrent.name}`));
-
         // Track transfer, storing the encrypted key if provided
         trackTransfer(magnet, torrent.name, dlDir, opts.key || null);
 
         const progressSpinner = ora('Downloading... 0%').start();
+        // Keep event loop alive until download completes (Node may exit early otherwise)
+        const keepAlive = setInterval(() => {}, 1000);
 
         torrent.on('download', (bytes) => {
           const progress = (torrent.progress * 100).toFixed(1);
           progressSpinner.text = `Downloading... ${progress}% (${(torrent.downloaded / 1024 / 1024).toFixed(2)} MB / ${(torrent.length / 1024 / 1024).toFixed(2)} MB)`;
         });
 
-        torrent.on('done', async () => {
+        const onDone = async () => {
           logger.info(`Download complete: ${torrent.name}`, { size: torrent.length });
           progressSpinner.succeed(chalk.green('Download Complete!'));
           const downloadedDir = path.join(dlDir, torrent.name);
@@ -208,25 +217,39 @@ Examples:
           }
 
           completeTransfer(magnet);
-          client.destroy();
-          process.exit(0);
-        });
+          clearInterval(keepAlive);
+          // Wait for file system writes to flush before exiting
+          setTimeout(() => {
+            client.destroy();
+            setTimeout(() => process.exit(0), 500);
+          }, 1000);
+        };
+        torrent.on('done', onDone);
+        // For small files, done may fire before handler is registered
+        if (torrent.progress === 1) onDone();
       });
 
-      // Inject LAN peers into the torrent right after adding
+      // Inject LAN peers and manual peer after infoHash is resolved
       const currentTorrent = client.torrents[client.torrents.length - 1];
       if (currentTorrent) {
-        if (lanPeers.length > 0) {
-          const injected = injectLanPeers(currentTorrent, lanPeers);
-          if (injected > 0) logger.info(`Injected ${injected} LAN peer(s) into torrent`);
-        }
-        if (opts.peer) {
-          try {
-            currentTorrent.addPeer(opts.peer);
-            logger.info(`Injected manual peer ${opts.peer} into torrent`);
-          } catch (e) {
-            console.error(chalk.yellow(`Warning: Could not add peer ${opts.peer}: ${e.message}`));
+        const injectPeers = () => {
+          if (lanPeers.length > 0) {
+            const injected = injectLanPeers(currentTorrent, lanPeers);
+            if (injected > 0) logger.info(`Injected ${injected} LAN peer(s) into torrent`);
+          }
+          if (pendingPeer) {
+            try {
+              currentTorrent.addPeer(pendingPeer);
+              logger.info(`Injected manual peer ${pendingPeer} into torrent`);
+            } catch (e) {
+              console.error(chalk.yellow(`Warning: Could not add peer ${pendingPeer}: ${e.message}`));
+            }
           }
+        };
+        if (currentTorrent.infoHash) {
+          injectPeers();
+        } else {
+          currentTorrent.once('infoHash', injectPeers);
         }
       }
 

package/lib/commands/extension.js

@@ -46,13 +46,13 @@ Examples:
   $ pal ext audit                         Security audit all extensions
 `)
       .action(async () => {
-        await listExtensions();
+        await listExtensions(program);
       });
 
     cmd
       .command('list')
       .description('list installed extensions')
-      .action(async () => { await listExtensions(); });
+      .action(async () => { await listExtensions(program); });
 
     cmd
       .command('install <source>')
@@ -426,7 +426,7 @@ Examples:
             const stars = '\u2605'.repeat(Math.round(ext.rating || 0)) + '\u2606'.repeat(5 - Math.round(ext.rating || 0));
             console.log(`  ${chalk.white(ext.name)} v${ext.version}${verified}${pro}`);
             console.log(`    ${chalk.gray(ext.description || '')}`);
-            console.log(`    ${chalk.yellow(stars)} (${ext.reviewCount || 0}) \u00b7 ${chalk.cyan(ext.downloads || 0)} downloads \u00b7 by ${chalk.blue('@' + (ext.authorHandle || 'unknown'))}`);
+            console.log(`    ${chalk.yellow(stars)} (${ext.reviewCount || 0}) \u00b7 ${chalk.cyan(ext.downloads || 0)} downloads \u00b7 by ${chalk.blue((ext.authorHandle?.startsWith('@') ? ext.authorHandle : '@' + (ext.authorHandle || 'unknown')))}`);
             console.log('');
           }
           console.log(chalk.gray('Install: pal ext install-remote <name>'));
@@ -1035,16 +1035,32 @@ Why this tier?
       });
 }
 
-async function listExtensions() {
+async function listExtensions(program) {
   const { getInstalledExtensions } = await import('../core/extensions.js');
   const extensions = getInstalledExtensions();
   if (extensions.length === 0) {
+    if (program?.opts().json) {
+      console.log(JSON.stringify([], null, 2));
+      return;
+    }
     console.log(chalk.gray('No extensions installed.'));
     console.log(chalk.gray('  pal ext install <path|git-url>'));
     console.log(chalk.gray('  pal ext create <name>'));
     return;
   }
 
+  if (program?.opts().json) {
+    console.log(JSON.stringify(extensions.map(ext => ({
+      name: ext.name,
+      version: ext.version,
+      enabled: ext.enabled,
+      bundled: !!ext.bundled,
+      tier: ext.tier || (ext.pro ? 'pro' : 'free'),
+      description: ext.description || null,
+    })), null, 2));
+    return;
+  }
+
   console.log('');
   console.log(chalk.cyan('Extensions:'));
   for (const ext of extensions) {

package/lib/commands/group.js

@@ -135,7 +135,7 @@ Examples:
         const members = getGroupMembers(groupName);
         checkLimit('maxGroupMembers', members.length);
         addMemberToGroup(groupName, pal);
-        console.log(chalk.green(`Added '${pal.name}' to '${groupName}'.`));
+        console.log(chalk.green(`Added '${pal.name || pal.publicKey?.substring(0, 8) + '...' || palName}' to '${groupName}'.`));
       } catch (err) {
         console.log(chalk.red(err.message));
         process.exitCode = 1;
@@ -188,7 +188,7 @@ Examples:
       for (const g of groups) {
         console.log(`  ${chalk.white(g.name)}  ${chalk.gray(`(${g.members.length} members)`)}`);
         for (const m of g.members) {
-          console.log(`    - ${m.name}${m.handle ? chalk.gray(` @${m.handle}`) : ''}`);
+          console.log(`    - ${m.name || m.publicKey?.substring(0, 8) + '...' || 'unknown'}${m.handle ? chalk.gray(` ${m.handle.startsWith('@') ? m.handle : '@' + m.handle}`) : ''}`);
         }
       }
       console.log('');
@@ -245,11 +245,11 @@ Examples:
             if (res.ok) {
               sent++;
             } else {
-              console.log(chalk.yellow(`  Failed to send to @${handle}`));
+              console.log(chalk.yellow(`  Failed to send to ${handle.startsWith('@') ? handle : '@' + handle}`));
               failed++;
             }
           } catch {
-            console.log(chalk.yellow(`  Failed to send to @${handle}`));
+            console.log(chalk.yellow(`  Failed to send to ${handle.startsWith('@') ? handle : '@' + handle}`));
             failed++;
           }
         }

package/lib/commands/log.js

@@ -78,6 +78,14 @@ Examples:
       const count = parseInt(opts.lines, 10) || 20;
       lines = lines.slice(-count);
 
+      if (program.opts().json) {
+        const entries = lines.map(line => {
+          try { return JSON.parse(line); } catch { return { raw: line }; }
+        });
+        console.log(JSON.stringify(entries, null, 2));
+        return;
+      }
+
       for (const line of lines) {
         console.log(formatEntry(line));
       }

package/lib/commands/network.js

@@ -152,7 +152,7 @@ Examples:
         console.log(chalk.cyan('Members:'));
         for (const m of members) {
           const role = m.role ? chalk.yellow(` [${m.role}]`) : '';
-          const handle = m.handle ? chalk.gray(` @${m.handle}`) : '';
+          const handle = m.handle ? chalk.gray(` ${m.handle.startsWith('@') ? m.handle : '@' + m.handle}`) : '';
           console.log(`  ${chalk.white(m.name || m.userId)}${handle}${role}`);
         }
         console.log('');

package/lib/commands/pal.js

@@ -375,10 +375,19 @@ Examples:
 
       const profile = getProfile();
       if (!profile) {
+        if (program.opts().json) {
+          console.log(JSON.stringify(null, null, 2));
+          return;
+        }
         console.log(chalk.yellow('No identity found. Run `pal init` first.'));
         return;
       }
 
+      if (program.opts().json) {
+        console.log(JSON.stringify(profile, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Your Profile:'));
       const rows = [

package/lib/commands/permissions.js

@@ -33,7 +33,7 @@ Examples:
       const summary = getShareSummary();
       const groups = getGroups();
 
-      if (opts.json) {
+      if (opts.json || program.opts().json) {
         console.log(JSON.stringify(summary, null, 2));
         return;
       }

package/lib/commands/protocol.js

@@ -31,6 +31,23 @@ Examples:
         const { getRelayLimits } = await import('../protocol/router.js');
         const { FREE_POLICY_LIMITS, PRO_POLICY_LIMITS } = await import('../protocol/policy.js');
 
+        if (program.opts().json) {
+          const caps = ['share', 'sync', 'chat', 'relay'];
+          if (isPro()) caps.push('delta-sync', 'receipts');
+          const limits = getRelayLimits();
+          const pl = isPro() ? PRO_POLICY_LIMITS : FREE_POLICY_LIMITS;
+          console.log(JSON.stringify({
+            protocol: PROTOCOL_NAME,
+            version: PROTOCOL_VERSION,
+            tier: isPro() ? 'pro' : 'free',
+            capabilities: caps,
+            relayLimits: limits,
+            policyLimits: pl,
+            identity: identity ? { publicKey: identity.publicKey, handle: identity.handle || null } : null,
+          }, null, 2));
+          return;
+        }
+
         console.log('');
         console.log(chalk.cyan.bold('PAL Protocol'));
         console.log(`  Protocol:      ${chalk.white(PROTOCOL_NAME)}`);

package/lib/commands/serve.js

@@ -47,6 +47,7 @@ export default function serveCommand(program) {
     .option('--web-port <port>', 'Web dashboard port (default: 8585)', '8585')
     .option('--lan', 'Bind web server to 0.0.0.0 for LAN access')
     .option('--public-ip <ip>', 'Public IP/hostname for serveUrl announcement (for VPS/cloud)')
+    .option('--torrent-port <port>', 'BitTorrent listening port (default: random)')
     .addHelpText('after', `
 Examples:
   $ pal serve                        Start seeding in foreground
@@ -95,6 +96,7 @@ Examples:
           if (opts.lan) args.push('--lan');
           if (opts.publicIp) args.push('--public-ip', opts.publicIp);
         }
+        if (opts.torrentPort) args.push('--torrent-port', opts.torrentPort);
         const child = spawn(process.execPath, args, {
           detached: true,
           stdio: 'ignore'
@@ -207,7 +209,9 @@ Examples:
         console.log(chalk.gray('No active shares to seed. Signaling server still running.'));
       }
 
-      const client = new WebTorrent();
+      const wtOpts = {};
+      if (opts.torrentPort) wtOpts.torrentPort = parseInt(opts.torrentPort, 10);
+      const client = new WebTorrent(wtOpts);
       client.setMaxListeners(Math.max(shares.length, 10) + 20);
 
       // Auto-expire old shares before seeding

package/lib/commands/server.js

@@ -232,9 +232,26 @@ Examples:
     .description('list all configured discovery servers with health status and roles')
     .action(async () => {
       const servers = getServers();
+      const checks = await Promise.all(servers.map(s => checkServer(s)));
+
+      if (program.opts().json) {
+        const result = checks.map((c, i) => {
+          const meta = getServerRoles(c.url);
+          return {
+            url: c.url,
+            reachable: c.reachable,
+            primary: i === 0,
+            roles: meta.roles,
+            addedBy: meta.addedBy,
+            writeTrusted: isWriteTrusted(c.url),
+          };
+        });
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Discovery Servers:'));
-      const checks = await Promise.all(servers.map(s => checkServer(s)));
       for (let i = 0; i < checks.length; i++) {
         const c = checks[i];
         const primary = i === 0 ? chalk.cyan(' (primary)') : '';

package/lib/commands/share-link.js

@@ -128,8 +128,20 @@ Examples:
       try {
         const identity = await getIdentity();
         if (!identity?.handle) {
-          console.log(chalk.red('You must register a handle first: pal register'));
-          process.exitCode = 1;
+          const shares = listShares();
+          const sharedLinks = shares.filter(s => s.magnet);
+          if (sharedLinks.length === 0) {
+            console.log(chalk.gray('No share links. Register a handle to manage server-side links: pal register'));
+          } else {
+            console.log('');
+            console.log(chalk.cyan('Local shares with magnets:'));
+            for (const s of sharedLinks) {
+              console.log(`  ${chalk.white(s.name || s.id)}`);
+              console.log(`    Magnet: ${chalk.gray(s.magnet.substring(0, 60) + '...')}`);
+            }
+            console.log('');
+            console.log(chalk.gray('Register a handle to create web share links: pal register'));
+          }
           return;
         }
 

package/lib/commands/sync.js

@@ -480,14 +480,23 @@ async function watchSync(dirPath, palName, opts) {
 
 // --- pal sync status <path> ---
 
-async function syncStatus(dirPath) {
+async function syncStatus(dirPath, program) {
   if (!dirPath) {
     const pairs = getSyncPairs();
     if (pairs.length === 0) {
+      if (program?.opts().json) {
+        console.log(JSON.stringify([], null, 2));
+        return;
+      }
       console.log(chalk.gray('No sync pairs configured. Use `pal sync <path> <pal>` to start.'));
       return;
     }
 
+    if (program?.opts().json) {
+      console.log(JSON.stringify(pairs, null, 2));
+      return;
+    }
+
     const friends = getFriends();
     console.log('');
     console.log(chalk.cyan.bold('Sync Pairs'));
@@ -674,14 +683,14 @@ export default function syncCommand(program) {
     .command('status [path]')
     .description('show sync status and changes since last sync')
     .action((syncPath) => {
-      syncStatus(syncPath);
+      syncStatus(syncPath, program);
     });
 
   cmd
     .command('list')
     .description('list all sync pairs')
     .action(() => {
-      syncStatus();
+      syncStatus(undefined, program);
     });
 
   cmd

package/lib/commands/transfers.js

@@ -129,11 +129,17 @@ Examples:
       const days = parseInt(opts.days, 10) || 90;
       pruneOldHistory(days);
       const stats = getTransferStats(days);
+
+      if (program.opts().json) {
+        console.log(JSON.stringify(stats, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan(`Transfer Stats (last ${days} days):`));
       console.log(`  Total transfers:  ${chalk.white(stats.totalTransfers)}`);
       console.log(`  Total data:       ${chalk.white(formatBytes(stats.totalBytes))}`);
-      console.log(`  Avg speed:        ${chalk.white(formatBytes(stats.avgSpeed) + '/s')}`);
+      console.log(`  Avg speed:        ${chalk.white(formatSpeed(stats.avgSpeed))}`);
       if (Object.keys(stats.perDay).length > 0) {
         console.log('');
         console.log(chalk.cyan('  Per day:'));
@@ -145,8 +151,12 @@ Examples:
 }
 
 function formatBytes(bytes) {
-  if (bytes === 0) return '0 B';
+  if (!bytes || !isFinite(bytes) || bytes <= 0) return '0 B';
   const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  const i = Math.max(0, Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1));
   return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
 }
+
+function formatSpeed(bytesPerSec) {
+  return formatBytes(bytesPerSec) + '/s';
+}

package/lib/commands/user.js

@@ -28,10 +28,26 @@ export default function userCommand(program) {
       const active = getActiveUser();
 
       if (profiles.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray('No profiles. Run `pal init <name>` to create one.'));
         return;
       }
 
+      if (program.opts().json) {
+        console.log(JSON.stringify(profiles.map(p => ({
+          name: p.name,
+          handle: p.handle || null,
+          role: p.role,
+          publicKey: p.publicKey,
+          lastLogin: p.lastLogin || null,
+          active: active?.publicKey === p.publicKey,
+        })), null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan.bold('User Profiles'));
       console.log('');

package/lib/commands/workspace.js

@@ -19,14 +19,14 @@ Examples:
   $ pal workspace remove <wsId> <shareId>  Remove share from workspace
 `)
     .action(() => {
-      printWorkspaces();
+      printWorkspaces(program);
     });
 
   cmd
     .command('list')
     .description('list all workspaces')
     .action(() => {
-      printWorkspaces();
+      printWorkspaces(program);
     });
 
   cmd
@@ -105,12 +105,22 @@ Examples:
     });
 }
 
-function printWorkspaces() {
+function printWorkspaces(program) {
   const workspaces = config.get('workspaces') || [];
   if (workspaces.length === 0) {
+    if (program?.opts().json) {
+      console.log(JSON.stringify([], null, 2));
+      return;
+    }
     console.log(chalk.gray('No workspaces. Use `pal workspace create <name>` to create one.'));
     return;
   }
+
+  if (program?.opts().json) {
+    console.log(JSON.stringify(workspaces, null, 2));
+    return;
+  }
+
   console.log('');
   console.log(chalk.cyan('Workspaces:'));
   for (const ws of workspaces) {

package/lib/core/networks.js

@@ -3,11 +3,13 @@ import { getIdentity } from './identity.js';
 import { getPrimaryServer } from './discoveryClient.js';
 
 async function authHeaders() {
-  const identity = await getIdentity();
+  const token = config.get('ext.@palexplorer/auth-email')?.verifiedToken;
+  if (!token) {
+    throw new Error('Not authenticated. Run `pal auth login` first to link your account.');
+  }
   return {
     'Content-Type': 'application/json',
-    'X-Public-Key': identity?.publicKey || '',
-    'X-Handle': identity?.handle || '',
+    'Authorization': `Bearer ${token}`,
   };
 }
 

package/lib/utils/fuzzy.js

@@ -0,0 +1,47 @@
+function levenshtein(a, b) {
+  const m = a.length, n = b.length;
+  const dp = Array.from({ length: m + 1 }, (_, i) => {
+    const row = new Array(n + 1);
+    row[0] = i;
+    return row;
+  });
+  for (let j = 1; j <= n; j++) dp[0][j] = j;
+
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1]
+        ? dp[i - 1][j - 1]
+        : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+
+export function suggest(input, candidates, { maxDistance = 3, maxResults = 3 } = {}) {
+  if (!input) return [];
+
+  const scored = candidates
+    .map(cmd => ({ cmd, dist: levenshtein(input.toLowerCase(), cmd.toLowerCase()) }))
+    .filter(({ dist, cmd }) => {
+      if (dist > maxDistance) return false;
+      // Also allow prefix matches (e.g., "ser" → "serve", "server", "search")
+      return true;
+    });
+
+  // Also add prefix matches not already included
+  const prefixMatches = candidates
+    .filter(cmd => cmd.toLowerCase().startsWith(input.toLowerCase()))
+    .map(cmd => ({ cmd, dist: 0.5 })); // give prefix matches high priority
+
+  const merged = new Map();
+  for (const entry of [...prefixMatches, ...scored]) {
+    if (!merged.has(entry.cmd) || entry.dist < merged.get(entry.cmd)) {
+      merged.set(entry.cmd, entry.dist);
+    }
+  }
+
+  return [...merged.entries()]
+    .sort((a, b) => a[1] - b[1])
+    .slice(0, maxResults)
+    .map(([cmd]) => cmd);
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "pal-explorer-cli",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "P2P encrypted file sharing CLI — share files directly with friends, not with the cloud",
   "main": "bin/pal.js",
   "bin": {
-    "pal": "./bin/pal.js"
+    "pal": "bin/pal.js"
   },
   "files": [
     "bin/",