fix: replace all hardcoded version + outdated command references

- index.ts: v0.3.7 → dynamic _pkg.version, status→portfolio, arb rates→arb scan
- init.ts: status→portfolio
- agent.ts: status→portfolio, arb rates→arb scan, arb auto→arb exec
- mcp-server.ts: status→portfolio, arb rates→arb scan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Hiksang

src/commands/agent.ts

@@ -175,7 +175,7 @@ export function registerAgentCommands(
               "perp account orders --json",
               "perp account history --json",
               "perp account trades --json",
-              "perp status --json",
+              "perp portfolio --json",
             ],
             description: "Read account state: balances, positions, open orders, trade history",
           },
@@ -211,7 +211,7 @@ export function registerAgentCommands(
             category: "arbitrage",
             commands: [
               "perp arb funding --json",
-              "perp arb rates --json",
+              "perp arb scan --min 5 --json",
               "perp arb scan --json",
               "perp arb dex --json",
               "perp arb dex-monitor --min 10",
@@ -397,14 +397,12 @@ export function registerAgentCommands(
         }
       } else if (g.includes("arb") || g.includes("arbitrage") || g.includes("funding")) {
         steps.push(
-          { step: 1, command: "perp arb rates --json", description: "Compare funding rates across exchanges" },
-          { step: 2, command: "perp arb scan --json", description: "Find high-spread opportunities" },
-          { step: 3, command: "perp gap show --json", description: "Check price gaps" },
-          { step: 4, command: "perp arb auto --dry-run --min-spread 30", description: "Dry-run auto arb bot" },
+          { step: 1, command: "perp arb scan --min 5 --json", description: "Scan funding rate arbitrage opportunities" },
+          { step: 2, command: "perp arb exec <SYM> <longEx> <shortEx> <$> --leverage 2 --isolated --dry-run --json", description: "Dry-run arb execution" },
         );
       } else if (g.includes("status") || g.includes("check") || g.includes("overview")) {
         steps.push(
-          { step: 1, command: "perp status --json", description: "Full account overview" },
+          { step: 1, command: "perp portfolio --json", description: "Balances + positions + risk" },
           { step: 2, command: "perp account positions --json", description: "Detailed positions" },
           { step: 3, command: "perp account orders --json", description: "Open orders" },
         );
@@ -432,7 +430,7 @@ export function registerAgentCommands(
       } else {
         steps.push(
           { step: 1, command: "perp agent capabilities", description: "List all available capabilities" },
-          { step: 2, command: "perp status --json", description: "Check account status" },
+          { step: 2, command: "perp portfolio --json", description: "Check account status" },
         );
       }
 

src/commands/init.ts

@@ -248,7 +248,7 @@ export function registerInitCommand(program: Command) {
         }
 
         console.log(chalk.white.bold("\n  Next steps:"));
-        console.log(`    ${chalk.green("perp status")}                     account overview`);
+        console.log(`    ${chalk.green("perp portfolio")}                  balances + positions + risk`);
         if (selected.includes("hyperliquid")) {
           console.log(`    ${chalk.green("perp deposit hyperliquid <amt>")}   deposit USDC`);
         }

src/index.ts

@@ -417,19 +417,19 @@ if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawAr
 
       if (!status.hasWallets && !hasEnvKey && !settings.defaultExchange) {
         // Fresh install — onboarding
-        console.log(chalk.cyan.bold("\n  Welcome to perp-cli!") + chalk.gray("  v0.3.7\n"));
+        console.log(chalk.cyan.bold("\n  Welcome to perp-cli!") + chalk.gray(`  v${_pkg.version}\n`));
         console.log("  Multi-DEX perpetual futures CLI for Pacifica, Hyperliquid, and Lighter.\n");
-        console.log(`  Get started:  ${chalk.cyan("perp init")}`);
+        console.log(`  Get started:  ${chalk.cyan("perp wallet set <exchange> <key>")}`);
         console.log(chalk.gray(`\n  Or explore without a wallet:`));
         console.log(`    ${chalk.green("perp market list")}              available markets`);
         console.log(`    ${chalk.green("perp -e hyperliquid market list")}  Hyperliquid markets`);
-        console.log(`    ${chalk.green("perp arb rates")}                funding rate comparison`);
+        console.log(`    ${chalk.green("perp arb scan")}                 funding rate arbitrage`);
         console.log(`    ${chalk.green("perp --help")}                   all commands\n`);
       } else {
         // Configured — show status overview
         const defaultEx = settings.defaultExchange || "pacifica";
         const activeEntries = Object.entries(status.active);
-        console.log(chalk.cyan.bold("\n  perp-cli") + chalk.gray("  v0.3.7\n"));
+        console.log(chalk.cyan.bold("\n  perp-cli") + chalk.gray(`  v${_pkg.version}\n`));
         console.log(`  Default exchange: ${chalk.cyan(defaultEx)}`);
 
         if (activeEntries.length > 0) {
@@ -460,10 +460,10 @@ if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawAr
         }
 
         console.log(chalk.white.bold("\n  Quick commands:"));
-        console.log(`    ${chalk.green("perp status")}       account overview`);
+        console.log(`    ${chalk.green("perp portfolio")}     balances + positions + risk`);
         console.log(`    ${chalk.green("perp market list")}   available markets`);
+        console.log(`    ${chalk.green("perp arb scan")}      funding rate arbitrage`);
         console.log(`    ${chalk.green("perp dashboard")}     live monitoring`);
-        console.log(`    ${chalk.green("perp arb rates")}     funding rate comparison`);
         console.log(`    ${chalk.green("perp --help")}        all commands\n`);
       }
     } catch {

src/mcp-server.ts

@@ -461,7 +461,7 @@ server.tool(
         );
       } else if (g.includes("arb") || g.includes("arbitrage")) {
         steps.push(
-          { step: 1, command: "perp --json arb rates", description: "Compare funding rates across exchanges" },
+          { step: 1, command: "perp --json arb scan --min 5", description: "Scan funding rate arbitrage opportunities" },
           { step: 2, command: "perp --json arb scan", description: "Find high-spread opportunities" },
           { step: 3, command: "perp --json gap show", description: "Check cross-exchange price gaps" },
           { step: 4, command: "perp --json arb dex", description: "HIP-3 cross-dex arb opportunities (Hyperliquid)" },
@@ -923,7 +923,7 @@ server.tool(
           parameters: [],
           risks: [],
           category: "read",
-          relatedCommands: ["perp status", "perp portfolio"],
+          relatedCommands: ["perp portfolio", "perp portfolio"],
         };
       } else if (category === "arb") {
         explanation = {
@@ -941,7 +941,7 @@ server.tool(
           parameters: [],
           risks: ["auto" === sub ? "Auto-executes trades on both exchanges" : ""].filter(Boolean),
           category: sub === "auto" || sub === "close" ? "write" : "analysis",
-          relatedCommands: ["perp arb rates", "perp arb scan", "perp gap show"],
+          relatedCommands: ["perp arb scan", "perp arb scan", "perp gap show"],
         };
       } else if (category === "bridge") {
         explanation = {
@@ -1037,7 +1037,7 @@ server.tool(
           parameters: [],
           risks: [],
           category: "read",
-          relatedCommands: ["perp funding rates", "perp arb rates"],
+          relatedCommands: ["perp funding rates", "perp arb scan"],
         };
       } else if (category === "backtest") {
         explanation = {
@@ -1249,7 +1249,7 @@ server.resource(
         arb: {
           description: "Funding rate arbitrage & basis trading",
           subcommands: {
-            rates: { usage: "perp arb rates", description: "Compare funding rates" },
+            rates: { usage: "perp arb scan", description: "Compare funding rates" },
             scan: { usage: "perp arb scan --min <bps>", description: "Find arb opportunities" },
             funding: { usage: "perp arb funding", description: "Detailed funding analysis" },
             dex: { usage: "perp arb dex", description: "HIP-3 cross-dex arb" },
@@ -1388,7 +1388,7 @@ server.resource(
         deposit: { usage: "perp deposit <exchange> <amount>", description: "Deposit USDC to exchange" },
         withdraw: { usage: "perp withdraw <exchange> <amount>", description: "Withdraw USDC from exchange" },
         portfolio: { usage: "perp portfolio", description: "Cross-exchange portfolio summary" },
-        status: { usage: "perp status", description: "Full account overview" },
+        status: { usage: "perp portfolio", description: "Full account overview" },
         health: { usage: "perp health", description: "Exchange connectivity check" },
         settings: {
           description: "CLI settings",