@decatalyst/hummingbird 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+<div align="center">
+  <img src="https://media.vylth.com/images/Inhr2N9T.png" width="90" alt="Hummingbird" />
+  <h2>hummingbird</h2>
+  <p>Autonomous pump.fun trading agent — CLI</p>
+</div>
+
+---
+
+```bash
+npm install -g @iamdecatalyst/hummingbird
+```
+
+Then just run:
+
+```bash
+hummingbird          # interactive TUI dashboard
+hummingbird login    # save your API credentials
+hummingbird status   # one-shot stats
+hummingbird positions
+hummingbird logs
+```
+
+---
+
+## What it does
+
+Connects to a running [Hummingbird](https://github.com/iamdecatalyst/hummingbird) orchestrator and gives you a full terminal dashboard to monitor and control your trading bot:
+
+- Live P&L, win rate, open positions
+- Trade history with entry/exit prices
+- Real-time event log
+- Start / stop / resume the bot from the terminal
+- Emergency exit all positions
+
+---
+
+## Requirements
+
+You need a running Hummingbird orchestrator to connect to.
+Get started: [github.com/iamdecatalyst/hummingbird](https://github.com/iamdecatalyst/hummingbird)
+
+---
+
+## Supported platforms
+
+| Platform | Architecture |
+|---|---|
+| Linux | x64, arm64 |
+| macOS | x64 (Intel), arm64 (Apple Silicon) |
+| Windows | x64 |
+
+---
+
+Built by [@iamdecatalyst](https://github.com/iamdecatalyst) · [VYLTH Strategies](https://vylth.com)

package/bin/hummingbird.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+'use strict'
+
+const { spawnSync } = require('child_process')
+const path = require('path')
+const os = require('os')
+
+function getBinaryPath() {
+  const platform = os.platform() // 'linux' | 'darwin' | 'win32'
+  const arch = os.arch()         // 'x64' | 'arm64'
+
+  // Map Node arch names to our package arch names
+  const archMap = { x64: 'x64', arm64: 'arm64' }
+  const mappedArch = archMap[arch]
+
+  if (!mappedArch) {
+    fatal(`unsupported architecture: ${arch}`)
+  }
+
+  const pkgName = `@decatalyst/hummingbird-${platform}-${mappedArch}`
+  const binaryName = platform === 'win32' ? 'hummingbird.exe' : 'hummingbird'
+
+  try {
+    const pkgDir = path.dirname(require.resolve(`${pkgName}/package.json`))
+    return path.join(pkgDir, 'bin', binaryName)
+  } catch {
+    fatal(
+      `no binary found for ${platform}/${arch}\n` +
+      `  expected package: ${pkgName}\n` +
+      `  install manually: https://github.com/iamdecatalyst/hummingbird/releases`
+    )
+  }
+}
+
+function fatal(msg) {
+  process.stderr.write(`\nhummingbird: ${msg}\n\n`)
+  process.exit(1)
+}
+
+const bin = getBinaryPath()
+const result = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' })
+
+if (result.error) {
+  fatal(`failed to run binary: ${result.error.message}`)
+}
+
+process.exit(result.status ?? 1)

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@decatalyst/hummingbird",
+  "version": "1.0.0",
+  "description": "Autonomous pump.fun trading agent — CLI",
+  "keywords": ["solana", "trading", "pump.fun", "cli", "defi"],
+  "homepage": "https://github.com/iamdecatalyst/hummingbird",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iamdecatalyst/hummingbird.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Isaac Wisdom <decatalyst@vylth.com> (https://github.com/iamdecatalyst)",
+  "bin": {
+    "hummingbird": "./bin/hummingbird.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/hummingbird.js --version 2>/dev/null || true"
+  },
+  "optionalDependencies": {
+    "@decatalyst/hummingbird-linux-x64":   "1.0.0",
+    "@decatalyst/hummingbird-linux-arm64":  "1.0.0",
+    "@decatalyst/hummingbird-darwin-x64":   "1.0.0",
+    "@decatalyst/hummingbird-darwin-arm64":  "1.0.0",
+    "@decatalyst/hummingbird-win32-x64":    "1.0.0"
+  },
+  "engines": {
+    "node": ">=14"
+  }
+}