perp-cli 0.9.8 → 0.12.0

package/dist/commands/jobs.d.ts

@@ -1,2 +1,2 @@
 import { Command } from "commander";
-export declare function registerJobsCommands(program: Command, isJson: () => boolean): void;
+export declare function registerBackgroundCommands(program: Command, isJson: () => boolean): void;

package/dist/commands/jobs.js

@@ -3,8 +3,8 @@ import { printJson, jsonOk } from "../utils.js";
 import chalk from "chalk";
 import { existsSync, readFileSync } from "node:fs";
 import { execSync } from "node:child_process";
-export function registerJobsCommands(program, isJson) {
-    const jobs = program.command("jobs").description("Background job management (tmux)");
+export function registerBackgroundCommands(program, isJson) {
+    const jobs = program.command("background").description("Background process supervisor (tmux sessions for strategies, alerts, etc.)");
     jobs
         .command("list", { isDefault: true })
         .description("List all jobs")

package/dist/commands/manage.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
 import type { ExchangeAdapter } from "../exchanges/index.js";
-export declare function registerManageCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean, getPacificaAdapter: () => unknown): void;
+export declare function registerWalletManageCommands(parent: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean, getPacificaAdapter: () => unknown): void;

package/dist/commands/manage.js

@@ -1,9 +1,8 @@
 import { printJson, jsonOk, jsonError } from "../utils.js";
-import { setEnvVar } from "./init.js";
 import chalk from "chalk";
-import { hasPacificaSdk, hasLighterAccount } from "../exchanges/capabilities.js";
-export function registerManageCommands(program, getAdapter, isJson, getPacificaAdapter) {
-    const manage = program.command("manage").description("Exchange account settings (margin, subaccount, API keys, builder)");
+import { hasPacificaSdk } from "../exchanges/capabilities.js";
+export function registerWalletManageCommands(parent, getAdapter, isJson, getPacificaAdapter) {
+    const manage = parent.command("manage").description("Exchange account settings (margin, subaccount, API keys, builder) — Pacifica + Lighter");
     // Ensure adapter is initialized before accessing PacificaAdapter
     async function pac() {
         const adapter = await getAdapter();
@@ -71,48 +70,10 @@ export function registerManageCommands(program, getAdapter, isJson, getPacificaA
             return printJson(jsonOk(result));
         console.log(chalk.green(`\n  Transferred $${amount}.\n`));
     });
-    // Agent wallets
-    const agent = manage.command("agent").description("Agent wallet management");
-    agent
-        .command("bind <wallet>")
-        .description("Bind an agent wallet")
-        .action(async (wallet) => {
-        const a = await pac();
-        const result = await a.sdk.bindAgentWallet(wallet, a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(chalk.green(`\n  Agent wallet ${wallet} bound.\n`));
-    });
-    agent
-        .command("list")
-        .description("List agent wallets")
-        .action(async () => {
-        const a = await pac();
-        const result = await a.sdk.listAgentWallets(a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(JSON.stringify(result, null, 2));
-    });
-    agent
-        .command("revoke <wallet>")
-        .description("Revoke an agent wallet")
-        .action(async (wallet) => {
-        const a = await pac();
-        const result = await a.sdk.revokeAgentWallet(wallet, a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(chalk.green(`\n  Agent wallet ${wallet} revoked.\n`));
-    });
-    agent
-        .command("revoke-all")
-        .description("Revoke all agent wallets")
-        .action(async () => {
-        const a = await pac();
-        const result = await a.sdk.revokeAllAgentWallets(a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(chalk.green("\n  All agent wallets revoked.\n"));
-    });
+    // Legacy `manage agent` removed in v0.12 (Phase 2c) — superseded by the
+    // unified `wallet agent {approve,revoke,rotate,list,verify} pacifica` flow.
+    // The unified command tree provides 3-tier signer routing, expiry tracking,
+    // and OWS at-rest encryption. See `wallet agent approve pacifica --help`.
     // Lake (liquidity vaults)
     const lake = manage.command("lake").description("Lake (liquidity vault) management");
     lake
@@ -270,42 +231,9 @@ export function registerManageCommands(program, getAdapter, isJson, getPacificaA
             return printJson(jsonOk(result));
         console.log(chalk.green(`\n  API key revoked.\n`));
     });
-    // === Lighter API Key Setup ===
-    manage
-        .command("setup-api-key")
-        .description("Generate & register a Lighter API key (required for trading)")
-        .option("--key-index <n>", "API key index (4-254, default: 4)", "4")
-        .action(async (opts) => {
-        const adapter = await getAdapter();
-        if (!hasLighterAccount(adapter)) {
-            throw new Error("This command requires --exchange lighter");
-        }
-        const keyIndex = parseInt(opts.keyIndex);
-        if (!isJson()) {
-            console.log(chalk.cyan.bold("\n  Lighter API Key Setup\n"));
-            console.log(chalk.gray(`  Account: ${adapter.address} (index: ${adapter.accountIndex})`));
-            console.log(chalk.gray(`  API Key Index: ${keyIndex}\n`));
-            console.log(chalk.gray("  Generating key pair + registering on-chain...\n"));
-        }
-        const { privateKey, publicKey } = await adapter.setupApiKey(keyIndex);
-        // Auto-save to .env
-        setEnvVar("LIGHTER_API_KEY", privateKey);
-        setEnvVar("LIGHTER_ACCOUNT_INDEX", String(adapter.accountIndex));
-        setEnvVar("LIGHTER_API_KEY_INDEX", String(keyIndex));
-        if (isJson()) {
-            return printJson(jsonOk({
-                privateKey,
-                publicKey,
-                address: adapter.address,
-                accountIndex: adapter.accountIndex,
-                apiKeyIndex: keyIndex,
-                savedToEnv: true,
-            }));
-        }
-        console.log(chalk.green("  API Key Registered & saved to ~/.perp/.env\n"));
-        console.log(`  ${chalk.bold("Private Key:")} ${privateKey}`);
-        console.log(`  ${chalk.bold("Public Key:")}  ${publicKey}`);
-        console.log(`  ${chalk.bold("Account:")}     ${adapter.accountIndex}`);
-        console.log();
-    });
+    // Legacy `manage setup-api-key` removed in v0.12 (Phase 2d) — superseded by
+    // the unified `wallet agent approve lighter` flow. The agent flow provides
+    // 3-tier signer routing, expiry tracking, free-slot picking, and AgentMeta
+    // persistence. The auto-setup path in LighterAdapter.init() remains as the
+    // env-key fallback for users who haven't run the unified command yet.
 }

package/dist/commands/plan.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
 import type { ExchangeAdapter } from "../exchanges/index.js";
-export declare function registerPlanCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean): void;
+export declare function registerStrategyPlanCommands(parent: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/plan.js

@@ -2,8 +2,8 @@ import { readFileSync } from "fs";
 import { printJson, jsonOk, jsonError, withJsonErrors } from "../utils.js";
 import { validatePlan, executePlan } from "../plan-executor.js";
 import chalk from "chalk";
-export function registerPlanCommands(program, getAdapter, isJson) {
-    const plan = program.command("plan").description("Composite execution plans (multi-step atomic operations)");
+export function registerStrategyPlanCommands(parent, getAdapter, isJson) {
+    const plan = parent.command("plan").description("Composite execution plans (multi-step atomic operations)");
     // ── plan validate ──
     plan
         .command("validate <file>")

package/dist/commands/portfolio.d.ts

@@ -1,3 +1,19 @@
-import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
-export declare function registerPortfolioCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;
+/**
+ * Unified `perp portfolio` command — replaces:
+ *   - `perp account balance` (single-exchange detail)  → `perp portfolio -e <ex>`
+ *   - prior `perp portfolio`                            → `perp portfolio` (rebuilt)
+ *   - `perp status`                                     → `perp portfolio --arb`
+ *   - `perp status --health`                            → `perp portfolio --health`
+ *   - `perp dashboard`                                  → `perp portfolio --serve`
+ *
+ * Modes (mutually exclusive, picked by flag):
+ *   snapshot (default) | health | watch | serve
+ *
+ * I/O contract:
+ *   - Text mode  → human-friendly tables + side-by-side panels (status-like)
+ *   - JSON mode  → canonical envelope (see spec); arb / health / serve keys conditional
+ *   - --stdin    → read JSON args from stdin, overrides CLI flags
+ */
+import type { Command } from "commander";
+import type { ExchangeAdapter } from "../exchanges/index.js";
+export declare function registerPortfolioCommand(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean, version: string, getHLAdapterForDex?: (dex: string) => Promise<ExchangeAdapter>): void;