@raintree-technology/perps 0.1.2 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # perps
 
-Universal CLI for perpetual DEXes — by [Raintree Technology](https://raintree.technology).
+Universal CLI for perpetual DEXes.
 
 [![CI](https://github.com/raintree-technology/perps/actions/workflows/ci.yml/badge.svg)](https://github.com/raintree-technology/perps/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@raintree-technology/perps)](https://www.npmjs.com/package/@raintree-technology/perps)
@@ -12,6 +12,22 @@ npm install -g @raintree-technology/perps
 perps --help
 ```
 
+## Install Paths
+
+Canonical install path:
+
+```bash
+npm install -g @raintree-technology/perps
+```
+
+GitHub install path (for source snapshots and pre-release testing):
+
+```bash
+npm install github:raintree-technology/perps
+```
+
+The package includes lifecycle build hooks so git installs produce runnable CLI artifacts (`dist/`) automatically.
+
 ## Supported Exchanges
 
 | Exchange | Chain | Status | Onboarding |
@@ -136,6 +152,18 @@ perps doctor                  # Health check
 
 Every command supports `--json` for machine-readable output and `--help` for usage details.
 
+Agent-friendly mode:
+
+```bash
+# Non-interactive execution
+perps setup wizard --yes --json
+
+# Machine-readable responses with schema version
+perps markets ls --json
+```
+
+JSON payloads are schema-versioned, and failures return deterministic exit codes.
+
 ## Exit Codes
 
 | Code | Meaning |
@@ -169,7 +197,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Please read our [Code of
 
 ## Author
 
-[Raintree Technology](https://raintree.technology) ([@raintree_tech](https://x.com/raintree_tech)) — created by [Zachary Roth](https://zacharyr0th.com) ([@zacharyr0th](https://x.com/zacharyr0th))
+[Raintree Technology](https://raintree.technology)
 
 ## License
 

package/dist/cli/experience.js

@@ -107,7 +107,6 @@ export function printSessionBanner(args) {
     for (const line of getPerpsAsciiMark()) {
         console.log(highlighter.brand(line));
     }
-    console.log(highlighter.dim("by Raintree Technology"));
     console.log("");
     console.log(`${highlighter.dim("mode")} ${networkTag}  ${highlighter.dim("exchange")} ${exchangeTag}`);
     console.log(`${highlighter.dim("command")} ${commandTag}  ${highlighter.dim("version")} ${highlighter.dim(`v${args.version}`)}`);

package/dist/cli/program.js

@@ -8,6 +8,8 @@ import { createContext } from "./context.js";
 import { highlighter, printCommandCompletion, printSessionBanner } from "./experience.js";
 import { commandPathFromCommand, resolveTestnetMode } from "./network-defaults.js";
 import { outputError } from "./output.js";
+import { inferExitCode } from "../lib/exit-codes.js";
+import { withJsonContract } from "../lib/contracts.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../../package.json");
 const commandMeta = new WeakMap();
@@ -30,6 +32,7 @@ export function createProgram() {
         .description("Universal CLI for perpetual DEXes")
         .showSuggestionAfterError(true)
         .showHelpAfterError()
+        .exitOverride()
         .version(pkg.version)
         .option("--json", "Output in JSON format", false)
         .option("--human", "Enable human-first output UX (banner, timing, rich formatting)", false)
@@ -62,17 +65,37 @@ Examples:
             setExchange(opts.exchange);
         }
         catch (err) {
-            outputError(err instanceof Error ? err.message : String(err));
-            console.error(highlighter.dim(`Available exchanges: ${getAvailableExchanges().join(", ")}`));
-            process.exit(1);
+            const message = err instanceof Error ? err.message : String(err);
+            const exitCode = inferExitCode(err);
+            if (opts.json) {
+                console.error(JSON.stringify(withJsonContract("perps.error", {
+                    status: "error",
+                    error: { message, exitCode },
+                }), null, 2));
+            }
+            else {
+                outputError(message);
+                console.error(highlighter.dim(`Available exchanges: ${getAvailableExchanges().join(", ")}`));
+            }
+            process.exit(exitCode);
         }
         let config;
         try {
             config = loadConfig(isTestnet, opts.exchange);
         }
         catch (err) {
-            outputError(err instanceof Error ? err.message : String(err));
-            process.exit(1);
+            const message = err instanceof Error ? err.message : String(err);
+            const exitCode = inferExitCode(err);
+            if (opts.json) {
+                console.error(JSON.stringify(withJsonContract("perps.error", {
+                    status: "error",
+                    error: { message, exitCode },
+                }), null, 2));
+            }
+            else {
+                outputError(message);
+            }
+            process.exit(exitCode);
         }
         const context = createContext(config);
         // Store metadata on the root command

package/dist/index.js

@@ -1,4 +1,38 @@
 #!/usr/bin/env node
 import { createProgram } from "./cli/program.js";
+import { withJsonContract } from "./lib/contracts.js";
+import { inferExitCode } from "./lib/exit-codes.js";
+const isJsonMode = process.argv.includes("--json");
 const program = createProgram();
-program.parse();
+if (isJsonMode) {
+    program.configureOutput({
+        writeOut: () => undefined,
+        writeErr: () => undefined,
+    });
+}
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const commanderExitCode = typeof err === "object" && err !== null && "exitCode" in err
+        ? Number(err.exitCode)
+        : Number.NaN;
+    const commanderCode = typeof err === "object" && err !== null && "code" in err
+        ? String(err.code ?? "")
+        : "";
+    const exitCode = Number.isFinite(commanderExitCode) && commanderExitCode === 0
+        ? 0
+        : commanderCode.startsWith("commander.")
+            ? inferExitCode(err)
+            : Number.isFinite(commanderExitCode)
+                ? commanderExitCode
+                : inferExitCode(err);
+    if (isJsonMode && exitCode !== 0) {
+        console.error(JSON.stringify(withJsonContract("perps.error", {
+            status: "error",
+            error: { message, exitCode },
+        }), null, 2));
+    }
+    process.exit(exitCode);
+}

package/dist/lib/exit-codes.js

@@ -25,7 +25,11 @@ export function inferExitCode(err) {
     const message = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
     if (message.includes("must be") ||
         message.includes("invalid") ||
-        message.includes("use --yes with --json")) {
+        message.includes("use --yes with --json") ||
+        message.includes("unknown option") ||
+        message.includes("too many arguments") ||
+        message.includes("missing required argument") ||
+        message.includes("option argument missing")) {
         return EXIT_CODES.VALIDATION_ERROR;
     }
     if (message.includes("not configured") ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raintree-technology/perps",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Universal CLI for perpetual DEXes",
   "author": "Raintree Technology (https://raintree.technology)",
   "contributors": [
@@ -63,6 +63,8 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsc",
+    "prepare": "npm run build",
+    "prepack": "npm run build",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
     "smoke": "node scripts/smoke.mjs",
@@ -82,7 +84,7 @@
     "lint:fix": "biome lint --write src scripts",
     "publint": "publint",
     "attw": "attw --pack . --profile esm-only",
-    "pack:check": "npm pack --dry-run",
+    "pack:check": "npm run build && npm pack --dry-run && node scripts/verify-pack.mjs",
     "prepublishOnly": "npm run build && npm run publint && npm run attw"
   },
   "dependencies": {
@@ -105,6 +107,7 @@
     "zod": "^3.24.0"
   },
   "devDependencies": {
+    "next": "^16.1.6",
     "@arethetypeswrong/cli": "^0.18.2",
     "@biomejs/biome": "^1.9.4",
     "@types/better-sqlite3": "^7.6.13",