@jackwener/opencli 1.7.1 → 1.7.2

package/dist/src/main.js

@@ -45,14 +45,15 @@ if (argv[0] === 'completion' && argv.length >= 2) {
 // Fast path: --get-completions — read from manifest, skip discovery
 const getCompIdx = process.argv.indexOf('--get-completions');
 if (getCompIdx !== -1) {
-    // Only require manifest for directories that actually exist.
-    // If user clis dir doesn't exist, there are no user adapters to miss.
+    // Only include manifests that actually exist on disk.
+    // With sparse override, the user clis dir may exist but have no manifest.
     const manifestPaths = [getCliManifestPath(BUILTIN_CLIS)];
+    const userManifest = getCliManifestPath(USER_CLIS);
     try {
-        fs.accessSync(USER_CLIS);
-        manifestPaths.push(getCliManifestPath(USER_CLIS));
+        fs.accessSync(userManifest);
+        manifestPaths.push(userManifest);
     }
-    catch { /* no user dir */ }
+    catch { /* no user manifest */ }
     if (hasAllManifests(manifestPaths)) {
         const rest = process.argv.slice(getCompIdx + 1);
         let cursor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "publishConfig": {
     "access": "public"
   },
@@ -52,8 +52,8 @@
     "typecheck": "tsc --noEmit",
     "prepare": "[ -d src ] && npm run build || true",
     "prepublishOnly": "npm run build",
-    "test": "vitest run --project unit --project extension",
-    "test:bun": "bun vitest run --project unit --project extension",
+    "test": "vitest run --project unit --project extension --project adapter",
+    "test:bun": "bun vitest run --project unit --project extension --project adapter",
     "test:adapter": "vitest run --project adapter",
     "test:all": "vitest run",
     "test:e2e": "vitest run --project e2e",

package/scripts/fetch-adapters.js

@@ -1,21 +1,26 @@
 #!/usr/bin/env node
 
 /**
- * Copy official CLI adapters from the installed package to ~/.opencli/clis/.
+ * Sparse adapter sync: keeps ~/.opencli/clis/ clean by removing stale overrides.
  *
- * Update strategy (file-level granularity via adapter-manifest.json):
- * - Official files (in new manifest) are unconditionally overwritten
- * - Removed official files (in old manifest but not new) are cleaned up
- * - User-created files (never in any manifest) are preserved
- * - Skips if already installed at the same version
+ * Strategy (hash-based, site-level granularity):
+ * - When an official site has upstream changes: DELETE the local override
+ *   (do NOT copy new version — runtime falls back to package baseline)
+ * - When an official site has no changes: leave local override intact
+ * - User-created custom sites (not in package): always preserved
+ * - Skips entirely if already synced at the same version
+ *
+ * ~/.opencli/clis/ is a sparse override layer, not a full copy.
+ * Only eject-ed or user-modified sites appear here.
  *
  * Only runs on global install (npm install -g) or explicit OPENCLI_FETCH=1.
- * No network calls — copies directly from clis/ in the installed package.
+ * No network calls — reads hashes from clis/ in the installed package.
  *
  * This is an ESM script (package.json type: module). No TypeScript, no src/ imports.
  */
 
-import { existsSync, mkdirSync, rmSync, cpSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { createHash } from 'node:crypto';
 import { join, resolve, dirname } from 'node:path';
 import { homedir } from 'node:os';
 
@@ -38,7 +43,14 @@ function getPackageVersion() {
 }
 
 /**
- * Read existing manifest. Returns { version, files } or null.
+ * Compute SHA-256 hash of file content.
+ */
+function fileHash(filePath) {
+  return createHash('sha256').update(readFileSync(filePath)).digest('hex');
+}
+
+/**
+ * Read existing manifest. Returns { version, files, hashes } or null.
  */
 function readManifest() {
   try {
@@ -101,30 +113,48 @@ export function fetchAdapters() {
 
   const newOfficialFiles = new Set(walkFiles(BUILTIN_CLIS));
   const oldOfficialFiles = new Set(oldManifest?.files ?? []);
+  const oldHashes = oldManifest?.hashes ?? {};
   mkdirSync(USER_CLIS_DIR, { recursive: true });
 
-  // 1. Copy official files (unconditionally overwrite)
-  let copied = 0;
+  // 1. Compute new hashes and detect which sites have changes
+  const newHashes = {};
+  const siteFiles = new Map(); // site -> [relPath, ...]
   for (const relPath of newOfficialFiles) {
     const src = join(BUILTIN_CLIS, relPath);
-    const dst = join(USER_CLIS_DIR, relPath);
-    mkdirSync(dirname(dst), { recursive: true });
-    cpSync(src, dst, { force: true });
-    copied++;
+    const srcHash = fileHash(src);
+    newHashes[relPath] = srcHash;
+
+    const site = relPath.split('/')[0];
+    if (!siteFiles.has(site)) siteFiles.set(site, []);
+    siteFiles.get(site).push(relPath);
   }
 
-  // 2. Remove files that were official but are no longer (upstream deleted)
-  let removed = 0;
+  // Determine which sites have any changed/new/removed files
+  const changedSites = new Set();
+  for (const [site, files] of siteFiles) {
+    for (const relPath of files) {
+      if (oldHashes[relPath] !== newHashes[relPath]) {
+        changedSites.add(site);
+        break;
+      }
+    }
+  }
+  // Also mark sites that had files removed
   for (const relPath of oldOfficialFiles) {
     if (!newOfficialFiles.has(relPath)) {
-      const dst = join(USER_CLIS_DIR, relPath);
-      try {
-        unlinkSync(dst);
-        pruneEmptyDirs(dst, USER_CLIS_DIR);
-        removed++;
-      } catch {
-        // File may not exist locally
-      }
+      changedSites.add(relPath.split('/')[0]);
+    }
+  }
+
+  // 2. Sparse cleanup: for changed/removed official sites, delete local overrides.
+  //    Do NOT copy new versions — runtime falls back to package baseline.
+  //    Only eject-ed sites live in ~/.opencli/clis/.
+  let cleared = 0;
+  for (const site of changedSites) {
+    const siteDir = join(USER_CLIS_DIR, site);
+    if (existsSync(siteDir)) {
+      rmSync(siteDir, { recursive: true, force: true });
+      cleared++;
     }
   }
 
@@ -206,15 +236,16 @@ export function fetchAdapters() {
     log(`Cleaned up${legacyCleaned > 0 ? ` ${legacyCleaned} legacy shim files` : ''}${tmpCleaned > 0 ? `${legacyCleaned > 0 ? ',' : ''} ${tmpCleaned} stale tmp files` : ''}`);
   }
 
-  // 6. Write updated manifest
+  // 6. Write updated manifest (with per-file hashes for smart sync)
   writeFileSync(MANIFEST_PATH, JSON.stringify({
     version: currentVersion,
     files: [...newOfficialFiles].sort(),
+    hashes: newHashes,
     updatedAt: new Date().toISOString(),
   }, null, 2));
 
-  log(`Installed ${copied} adapter files to ${USER_CLIS_DIR}` +
-    (removed > 0 ? `, removed ${removed} deprecated files` : ''));
+  log(`Synced adapters: ${cleared} local override(s) cleared` +
+    (tsCleaned > 0 ? `, ${tsCleaned} stale .ts files removed` : ''));
 }
 
 function main() {

package/dist/src/clis/binance/asks.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/asks.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'asks',
-    description: 'Order book ask prices for a trading pair',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
-    ],
-    columns: ['rank', 'ask_price', 'ask_qty'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
-        { select: 'asks' },
-        { map: { rank: '${{ index + 1 }}', ask_price: '${{ item.0 }}', ask_qty: '${{ item.1 }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/commands.test.d.ts

@@ -1,3 +0,0 @@
-import './top.js';
-import './gainers.js';
-import './pairs.js';

package/dist/src/clis/binance/commands.test.js

@@ -1,58 +0,0 @@
-import { getRegistry } from '@jackwener/opencli/registry';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { executePipeline } from '../../pipeline/index.js';
-// Import all binance adapters to register them
-import './top.js';
-import './gainers.js';
-import './pairs.js';
-function loadPipeline(name) {
-    const cmd = getRegistry().get(`binance/${name}`);
-    if (!cmd?.pipeline)
-        throw new Error(`Command binance/${name} not found or has no pipeline`);
-    return cmd.pipeline;
-}
-function mockJsonOnce(payload) {
-    vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-        ok: true,
-        status: 200,
-        statusText: 'OK',
-        json: vi.fn().mockResolvedValue(payload),
-    }));
-}
-afterEach(() => {
-    vi.unstubAllGlobals();
-    vi.restoreAllMocks();
-});
-describe('binance adapters', () => {
-    it('sorts top pairs by numeric quote volume', async () => {
-        mockJsonOnce([
-            { symbol: 'SMALL', lastPrice: '1', priceChangePercent: '1.2', highPrice: '1', lowPrice: '1', quoteVolume: '9.9' },
-            { symbol: 'LARGE', lastPrice: '2', priceChangePercent: '2.3', highPrice: '2', lowPrice: '2', quoteVolume: '100.0' },
-            { symbol: 'MID', lastPrice: '3', priceChangePercent: '3.4', highPrice: '3', lowPrice: '3', quoteVolume: '11.0' },
-        ]);
-        const result = await executePipeline(null, loadPipeline('top'), { args: { limit: 3 } });
-        expect(result.map((item) => item.symbol)).toEqual(['LARGE', 'MID', 'SMALL']);
-        expect(result.map((item) => item.rank)).toEqual([1, 2, 3]);
-    });
-    it('sorts gainers by numeric percent change', async () => {
-        mockJsonOnce([
-            { symbol: 'TEN', lastPrice: '1', priceChangePercent: '10.0', quoteVolume: '100' },
-            { symbol: 'NINE', lastPrice: '1', priceChangePercent: '9.5', quoteVolume: '100' },
-            { symbol: 'HUNDRED', lastPrice: '1', priceChangePercent: '100.0', quoteVolume: '100' },
-        ]);
-        const result = await executePipeline(null, loadPipeline('gainers'), { args: { limit: 3 } });
-        expect(result.map((item) => item.symbol)).toEqual(['HUNDRED', 'TEN', 'NINE']);
-    });
-    it('keeps only TRADING pairs', async () => {
-        mockJsonOnce({
-            symbols: [
-                { symbol: 'BTCUSDT', baseAsset: 'BTC', quoteAsset: 'USDT', status: 'TRADING' },
-                { symbol: 'OLDPAIR', baseAsset: 'OLD', quoteAsset: 'USDT', status: 'BREAK' },
-            ],
-        });
-        const result = await executePipeline(null, loadPipeline('pairs'), { args: { limit: 10 } });
-        expect(result).toEqual([
-            { symbol: 'BTCUSDT', base: 'BTC', quote: 'USDT', status: 'TRADING' },
-        ]);
-    });
-});

package/dist/src/clis/binance/depth.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/depth.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'depth',
-    description: 'Order book bid prices for a trading pair',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
-    ],
-    columns: ['rank', 'bid_price', 'bid_qty'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
-        { select: 'bids' },
-        { map: { rank: '${{ index + 1 }}', bid_price: '${{ item.0 }}', bid_qty: '${{ item.1 }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/gainers.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/gainers.js

@@ -1,21 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'gainers',
-    description: 'Top gaining trading pairs by 24h price change',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 10, help: 'Number of trading pairs' },
-    ],
-    columns: ['rank', 'symbol', 'price', 'change_24h', 'volume'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
-        { filter: 'item.priceChangePercent' },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}', sort_change: '${{ Number(item.priceChangePercent) }}' } },
-        { sort: { by: 'sort_change', order: 'desc' } },
-        { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/klines.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/klines.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'klines',
-    description: 'Candlestick/kline data for a trading pair',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
-        { name: 'interval', type: 'str', default: '1d', help: 'Kline interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M)' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of klines (max 1000)' },
-    ],
-    columns: ['open', 'high', 'low', 'close', 'volume'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/klines?symbol=${{ args.symbol }}&interval=${{ args.interval }}&limit=${{ args.limit }}' } },
-        { map: { open: '${{ item.1 }}', high: '${{ item.2 }}', low: '${{ item.3 }}', close: '${{ item.4 }}', volume: '${{ item.5 }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/losers.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/losers.js

@@ -1,21 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'losers',
-    description: 'Top losing trading pairs by 24h price change',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 10, help: 'Number of trading pairs' },
-    ],
-    columns: ['rank', 'symbol', 'price', 'change_24h', 'volume'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
-        { filter: 'item.priceChangePercent' },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}', sort_change: '${{ Number(item.priceChangePercent) }}' } },
-        { sort: { by: 'sort_change' } },
-        { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/pairs.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/pairs.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'pairs',
-    description: 'List active trading pairs on Binance',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of trading pairs' },
-    ],
-    columns: ['symbol', 'base', 'quote', 'status'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/exchangeInfo' } },
-        { select: 'symbols' },
-        { filter: 'item.status === \'TRADING\'' },
-        { map: { symbol: '${{ item.symbol }}', base: '${{ item.baseAsset }}', quote: '${{ item.quoteAsset }}', status: '${{ item.status }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/price.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/price.js

@@ -1,17 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'price',
-    description: 'Quick price check for a trading pair',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
-    ],
-    columns: ['symbol', 'price', 'change', 'change_pct', 'high', 'low', 'volume', 'quote_volume', 'trades'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr?symbol=${{ args.symbol }}' } },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change: '${{ item.priceChange }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_volume: '${{ item.quoteVolume }}', trades: '${{ item.count }}' } },
-    ],
-});

package/dist/src/clis/binance/prices.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/prices.js

@@ -1,18 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'prices',
-    description: 'Latest prices for all trading pairs',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of prices' },
-    ],
-    columns: ['rank', 'symbol', 'price'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/price' } },
-        { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.price }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/ticker.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/ticker.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'ticker',
-    description: '24h ticker statistics for top trading pairs by volume',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of tickers' },
-    ],
-    columns: ['symbol', 'price', 'change_pct', 'high', 'low', 'volume', 'quote_vol', 'trades'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_vol: '${{ item.quoteVolume }}', trades: '${{ item.count }}', sort_volume: '${{ Number(item.quoteVolume) }}' } },
-        { sort: { by: 'sort_volume', order: 'desc' } },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_vol: '${{ item.quoteVolume }}', trades: '${{ item.count }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/top.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/top.js

@@ -1,20 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'top',
-    description: 'Top trading pairs by 24h volume on Binance',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of trading pairs' },
-    ],
-    columns: ['rank', 'symbol', 'price', 'change_24h', 'high', 'low', 'volume'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
-        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.quoteVolume }}', sort_volume: '${{ Number(item.quoteVolume) }}' } },
-        { sort: { by: 'sort_volume', order: 'desc' } },
-        { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.quoteVolume }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});

package/dist/src/clis/binance/trades.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/clis/binance/trades.js

@@ -1,19 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'binance',
-    name: 'trades',
-    description: 'Recent trades for a trading pair',
-    domain: 'data-api.binance.vision',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of trades (max 1000)' },
-    ],
-    columns: ['id', 'price', 'qty', 'quote_qty', 'buyer_maker'],
-    pipeline: [
-        { fetch: { url: 'https://data-api.binance.vision/api/v3/trades?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
-        { map: { id: '${{ item.id }}', price: '${{ item.price }}', qty: '${{ item.qty }}', quote_qty: '${{ item.quoteQty }}', buyer_maker: '${{ item.isBuyerMaker }}' } },
-        { limit: '${{ args.limit }}' },
-    ],
-});