@perpscope/percolator-adapter 0.4.0 → 0.5.0

package/README.md

@@ -2,6 +2,10 @@
 
 Read-only adapter helpers for Solana perps terminals that want PerpScope DTOs without adopting the cockpit UI.
 
+```bash
+npm install @perpscope/percolator-adapter
+```
+
 ```js
 import {
   buildPercolatorCompatibilityReport,

package/index.js

@@ -2,8 +2,11 @@ export {
   assertReadOnlySnapshot,
   buildPercolatorCompatibilityReport,
   detectPercolatorInputShape,
+  exportCompatibilityReport,
+  exportCompatibilityReportFromReport,
   normalizePercolatorCliBundle,
   normalizePercolatorSnapshot,
+  PERPSCOPE_ADAPTER_VERSION,
   parsePercolatorJson,
   simulatePriceShock,
   toTerminalMarketDto

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perpscope/percolator-adapter",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Read-only Percolator adapter helpers for Solana perps terminals.",
   "main": "./index.js",

package/src/lib/percolator-adapter.js

@@ -1,5 +1,7 @@
 import { normalizeFundingSkewHistory } from "./funding-history.js";
 
+export const PERPSCOPE_ADAPTER_VERSION = "0.5.0";
+
 const KEYPAIR_FIELD_PATTERN = /(^|_)(secret|private|keypair|mnemonic|seed|walletPath|wallet)(_|$)/i;
 const HISTORY_COMMAND_KEYS = new Set([
   "fundinghistory",
@@ -137,6 +139,38 @@ export function buildPercolatorCompatibilityReport(input, normalizedSnapshot) {
   };
 }
 
+export function exportCompatibilityReport(input, normalizedSnapshot, options = {}) {
+  const snapshot = normalizedSnapshot || normalizePercolatorSnapshot(input);
+  const report = buildPercolatorCompatibilityReport(input, snapshot);
+  return exportCompatibilityReportFromReport(report, options);
+}
+
+export function exportCompatibilityReportFromReport(report, options = {}) {
+  return {
+    schema: "perpscope.compatibility-report",
+    version: 1,
+    package: {
+      name: "@perpscope/percolator-adapter",
+      version: options.packageVersion || PERPSCOPE_ADAPTER_VERSION
+    },
+    generatedAt: options.generatedAt || new Date().toISOString(),
+    safety: {
+      mode: "read-only",
+      rejected: report.status === "rejected"
+    },
+    shape: report.shape,
+    status: report.status,
+    compatible: report.compatible,
+    tone: report.tone,
+    score: report.score,
+    recognizedSections: report.recognizedSections,
+    missingFields: report.missingFields,
+    ignoredFields: report.ignoredFields,
+    source: report.source,
+    summary: report.summary
+  };
+}
+
 const COMPATIBILITY_SECTION_SPECS = [
   {
     id: "safety",