@perpscope/percolator-adapter 0.6.0 → 0.7.0

package/README.md

@@ -63,6 +63,19 @@ The full field-level contract is documented in `../../docs/field-compatibility-m
 
 `compareCompatibilityReports(previous, current)` returns `perpscope.compatibility-diff` with score delta, status change, new/resolved fields, section drift, and merged alias suggestions.
 
+## CLI
+
+```bash
+perpscope compat report capture.json
+perpscope compat diff previous.json current.json
+```
+
+Try it locally with:
+
+```bash
+perpscope compat diff ../../examples/fixture-pack-minimal-terminal.json ../../examples/fixture-pack-drifted-aliases.json
+```
+
 ## DTO Example
 
 ```js

package/bin/perpscope.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import {
+  buildPercolatorCompatibilityReport,
+  compareCompatibilityReports,
+  exportCompatibilityReport,
+  normalizePercolatorSnapshot,
+  parsePercolatorJson
+} from "../index.js";
+
+const [, , ...args] = process.argv;
+
+function usage() {
+  return [
+    "Usage:",
+    "  perpscope compat report <capture.json>",
+    "  perpscope compat diff <previous.json> <current.json>",
+    "",
+    "Read-only only: the adapter rejects wallet, signer, transaction, instruction, order, private key, seed, mnemonic, and API key fields."
+  ].join("\n");
+}
+
+function readCapture(path) {
+  if (!path) throw new Error("Missing capture path.");
+  return parsePercolatorJson(readFileSync(path, "utf8"));
+}
+
+function buildReport(input) {
+  const snapshot = normalizePercolatorSnapshot(input);
+  return buildPercolatorCompatibilityReport(input, snapshot);
+}
+
+function main() {
+  const [scope, command, ...rest] = args;
+  if (!scope || scope === "--help" || scope === "-h") {
+    console.log(usage());
+    return;
+  }
+  if (scope !== "compat") throw new Error(`Unknown scope: ${scope}`);
+  if (command === "report") {
+    const input = readCapture(rest[0]);
+    console.log(JSON.stringify(exportCompatibilityReport(input), null, 2));
+    return;
+  }
+  if (command === "diff") {
+    const previous = buildReport(readCapture(rest[0]));
+    const current = buildReport(readCapture(rest[1]));
+    console.log(JSON.stringify(compareCompatibilityReports(previous, current), null, 2));
+    return;
+  }
+  throw new Error(`Unknown compat command: ${command || ""}`.trim());
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error.message);
+  console.error("");
+  console.error(usage());
+  process.exitCode = 1;
+}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@perpscope/percolator-adapter",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Read-only Percolator adapter helpers for Solana perps terminals.",
   "main": "./index.js",
+  "bin": {
+    "perpscope": "bin/perpscope.mjs"
+  },
   "exports": {
     ".": "./index.js"
   },

package/src/lib/percolator-adapter.js

@@ -1,6 +1,6 @@
 import { normalizeFundingSkewHistory } from "./funding-history.js";
 
-export const PERPSCOPE_ADAPTER_VERSION = "0.6.0";
+export const PERPSCOPE_ADAPTER_VERSION = "0.7.0";
 
 const KEYPAIR_FIELD_PATTERN = /(^|_)(secret|private|keypair|mnemonic|seed|walletPath|wallet)(_|$)/i;
 const HISTORY_COMMAND_KEYS = new Set([