synthesis-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# synthesis-cli
+
+`synthesis-cli` is a deliberately thin wrapper around child CLIs.
+
+## Vision
+
+One entrypoint (`synthesis`) that routes directly to domain CLIs (uniswap, lido, moonpay, 8004, filecoin), without adding abstraction layers that drift from upstream tools.
+
+## Philosophy: thin and direct
+
+- No business logic duplication.
+- No protocol-specific wrappers inside this package.
+- Forward args as-is to child CLIs.
+- Keep maintenance surface tiny.
+
+## Usage
+
+```bash
+synthesis <moonpay|uniswap|lido|8004|filecoin> [...args]
+```
+
+Examples:
+
+```bash
+synthesis uniswap swap --help
+synthesis lido stake 1
+synthesis 8004 status
+synthesis filecoin --version
+```
+
+## Install
+
+```bash
+npm i -g synthesis-cli
+```
+
+> Note: Child CLIs must also be installed and available on your PATH.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { spawnSync, SpawnSyncReturns } from 'node:child_process';
+
+declare const ROUTES: Record<string, string>;
+declare function helpText(): string;
+declare function routeArgs(argv: string[]): {
+    command?: string;
+    forwardedArgs: string[];
+};
+type SpawnFn = (command: string, args: string[], options: Parameters<typeof spawnSync>[2]) => SpawnSyncReturns<Buffer>;
+declare function run(argv: string[], spawnFn?: SpawnFn): number;
+
+export { ROUTES, helpText, routeArgs, run };

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { spawnSync } from "child_process";
+var ROUTES = {
+  moonpay: "moonpay",
+  uniswap: "uniswap",
+  lido: "lido",
+  "8004": "8004",
+  filecoin: "filecoin"
+};
+var HELP_TEXT = `synthesis-cli
+
+A thin command router for child CLIs.
+
+Usage:
+  synthesis <moonpay|uniswap|lido|8004|filecoin> [...args]
+
+Examples:
+  synthesis uniswap swap --help
+  synthesis lido stake 1
+  synthesis 8004 status
+
+Philosophy:
+  synthesis does not reimplement child CLI logic.
+  It forwards argv directly to installed child CLIs.
+`;
+function helpText() {
+  return HELP_TEXT;
+}
+function routeArgs(argv) {
+  const [command, ...forwardedArgs] = argv;
+  return { command, forwardedArgs };
+}
+function run(argv, spawnFn = spawnSync) {
+  const { command, forwardedArgs } = routeArgs(argv);
+  if (!command || command === "-h" || command === "--help" || command === "help") {
+    process.stdout.write(`${helpText()}
+`);
+    return 0;
+  }
+  const target = ROUTES[command];
+  if (!target) {
+    process.stderr.write(`Unknown command: ${command}
+
+${helpText()}
+`);
+    return 1;
+  }
+  const result = spawnFn(target, forwardedArgs, {
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    const msg = result.error.message || String(result.error);
+    process.stderr.write(`Failed to execute '${target}': ${msg}
+`);
+    return 1;
+  }
+  return result.status ?? 0;
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const code = run(process.argv.slice(2));
+  process.exit(code);
+}
+export {
+  ROUTES,
+  helpText,
+  routeArgs,
+  run
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "synthesis-cli",
+  "version": "0.1.0",
+  "description": "Thin wrapper CLI that routes to DeFi and infra child CLIs",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "synthesis": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts --clean",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "wrapper",
+    "uniswap",
+    "lido",
+    "moonpay",
+    "filecoin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "provenance": false,
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.2.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0",
+    "vitest": "^2.1.8"
+  }
+}