clodds 1.2.8 → 1.3.0

package/dist/skills/bundled/harden/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: harden
+description: VPS security auditing and hardening
+emoji: "🔒"
+commands:
+  - /harden
+---
+
+# VPS Hardening
+
+Security auditing and automated hardening for remote servers.
+
+## Commands
+
+### `/harden audit <host>`
+Run security audit against a server. Checks:
+- System updates
+- Auto-updates configuration
+- SSH root login status
+- Password authentication
+- Firewall status
+- Fail2ban status
+- System uptime
+- Listening services
+- Sudo user configuration
+
+### `/harden fix <host>`
+Apply safe fixes that won't lock you out:
+- Install system updates
+- Enable unattended-upgrades
+- Configure UFW firewall
+- Install and enable fail2ban
+- Set SSH MaxAuthTries
+
+### `/harden emergency <host>`
+Quick 10-minute hardening for new servers:
+- Full system update
+- Firewall setup
+- Fail2ban installation
+- Root password lock
+
+### `/harden report <host>`
+Generate markdown security report.
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--user=NAME` | SSH user (default: root) |
+| `--dry-run` | Preview changes without applying |
+
+## Examples
+
+```
+/harden audit 192.168.1.100
+/harden fix myserver.com --user=admin
+/harden emergency vps.example.com --dry-run
+/harden report server.io > security-report.md
+```
+
+## Security Checks
+
+| Check | Pass Criteria |
+|-------|---------------|
+| System Updates | 0 pending updates |
+| Auto Updates | unattended-upgrades installed |
+| Root Login | PermitRootLogin no |
+| Password Auth | PasswordAuthentication no |
+| Firewall | UFW active or iptables configured |
+| Fail2ban | Service running |
+| Uptime | < 90 days |
+| Services | < 10 listening ports |
+| Sudo Users | At least one non-root sudo user |
+| MaxAuthTries | Set to 3 or less |

package/dist/skills/bundled/history/SKILL.md

@@ -0,0 +1,257 @@
+---
+name: history
+description: "Trade history tracking, sync, and performance analytics"
+emoji: "📊"
+gates:
+  envs:
+    anyOf:
+      - POLY_API_KEY
+      - KALSHI_API_KEY
+---
+
+# Trade History - Complete API Reference
+
+Fetch, sync, and analyze trade history from Polymarket and Kalshi with detailed performance metrics.
+
+---
+
+## Chat Commands
+
+### Fetch & Sync
+
+```
+/history fetch                              # Fetch all trades from APIs
+/history fetch poly                         # Fetch Polymarket only
+/history fetch --from 2024-01-01            # From specific date
+/history sync                               # Sync to local database
+```
+
+### View History
+
+```
+/history list                               # Recent trades
+/history list --limit 50                    # Last 50 trades
+/history list --platform poly               # Polymarket only
+/history list --market <id>                 # Specific market
+```
+
+### Statistics
+
+```
+/history stats                              # Overall statistics
+/history stats --period 30d                 # Last 30 days
+/history stats --platform kalshi            # Platform-specific
+```
+
+### P&L Analysis
+
+```
+/history daily-pnl                          # Daily P&L
+/history weekly-pnl                         # Weekly P&L
+/history monthly-pnl                        # Monthly P&L
+/history by-market                          # P&L by market category
+```
+
+### Export
+
+```
+/history export                             # Export to CSV
+/history export --format json               # Export as JSON
+/history export --from 2024-01-01           # Date range
+```
+
+### Filtering
+
+```
+/history filter --side buy                  # Only buys
+/history filter --pnl positive              # Only winners
+/history filter --pnl negative              # Only losers
+/history filter --min-size 100              # Min $100 trades
+```
+
+---
+
+## TypeScript API Reference
+
+### Create History Service
+
+```typescript
+import { createTradeHistoryService } from 'clodds/history';
+
+const history = createTradeHistoryService({
+  polymarket: {
+    apiKey: process.env.POLY_API_KEY,
+    address: process.env.POLY_ADDRESS,
+  },
+  kalshi: {
+    apiKey: process.env.KALSHI_API_KEY,
+  },
+
+  // Local storage
+  dbPath: './trade-history.db',
+});
+```
+
+### Fetch Trades from APIs
+
+```typescript
+// Fetch all trades from exchange APIs
+const trades = await history.fetchTrades({
+  platforms: ['polymarket', 'kalshi'],
+  from: '2024-01-01',
+});
+
+console.log(`Fetched ${trades.length} trades`);
+
+// Fetch from specific platform
+const polyTrades = await history.fetchTrades({
+  platforms: ['polymarket'],
+  limit: 100,
+});
+```
+
+### Sync to Database
+
+```typescript
+// Sync fetched trades to local database
+await history.syncToDatabase();
+
+console.log('Trades synced to database');
+```
+
+### Get Trades
+
+```typescript
+// Get trades from local storage
+const trades = await history.getTrades({
+  platform: 'polymarket',
+  from: '2024-01-01',
+  to: '2024-12-31',
+  limit: 100,
+});
+
+for (const trade of trades) {
+  console.log(`${trade.timestamp}: ${trade.side} ${trade.market}`);
+  console.log(`  Size: $${trade.size}`);
+  console.log(`  Price: ${trade.price}`);
+  console.log(`  P&L: $${trade.pnl?.toFixed(2) || 'open'}`);
+}
+```
+
+### Statistics
+
+```typescript
+// Get comprehensive statistics
+const stats = await history.getStats({
+  period: '30d',
+  platform: 'polymarket',
+});
+
+console.log(`=== Trading Statistics (30d) ===`);
+console.log(`Total trades: ${stats.totalTrades}`);
+console.log(`Winning trades: ${stats.winningTrades}`);
+console.log(`Losing trades: ${stats.losingTrades}`);
+console.log(`Win rate: ${(stats.winRate * 100).toFixed(1)}%`);
+console.log(`\nP&L:`);
+console.log(`  Total: $${stats.totalPnl.toLocaleString()}`);
+console.log(`  Gross profit: $${stats.grossProfit.toLocaleString()}`);
+console.log(`  Gross loss: $${stats.grossLoss.toLocaleString()}`);
+console.log(`  Profit factor: ${stats.profitFactor.toFixed(2)}`);
+console.log(`\nTrade sizes:`);
+console.log(`  Average: $${stats.avgTradeSize.toFixed(2)}`);
+console.log(`  Largest win: $${stats.largestWin.toFixed(2)}`);
+console.log(`  Largest loss: $${stats.largestLoss.toFixed(2)}`);
+console.log(`\nRisk metrics:`);
+console.log(`  Sharpe ratio: ${stats.sharpeRatio.toFixed(2)}`);
+console.log(`  Max drawdown: ${(stats.maxDrawdown * 100).toFixed(1)}%`);
+```
+
+### Daily P&L
+
+```typescript
+// Get daily P&L breakdown
+const dailyPnl = await history.getDailyPnL({
+  days: 30,
+  platform: 'polymarket',
+});
+
+console.log('=== Daily P&L ===');
+for (const day of dailyPnl) {
+  const sign = day.pnl >= 0 ? '+' : '';
+  const bar = day.pnl >= 0
+    ? '█'.repeat(Math.min(Math.floor(day.pnl / 10), 20))
+    : '▓'.repeat(Math.min(Math.floor(Math.abs(day.pnl) / 10), 20));
+
+  console.log(`${day.date} | ${sign}$${day.pnl.toFixed(2).padStart(8)} | ${bar}`);
+}
+```
+
+### Performance by Market
+
+```typescript
+// Get performance breakdown by market category
+const byMarket = await history.getPerformanceByMarket({
+  period: '30d',
+});
+
+console.log('=== Performance by Market Category ===');
+for (const [category, data] of Object.entries(byMarket)) {
+  console.log(`\n${category}:`);
+  console.log(`  Trades: ${data.trades}`);
+  console.log(`  Win rate: ${(data.winRate * 100).toFixed(1)}%`);
+  console.log(`  P&L: $${data.pnl.toLocaleString()}`);
+  console.log(`  Avg trade: $${data.avgTrade.toFixed(2)}`);
+}
+```
+
+### Export
+
+```typescript
+// Export to CSV
+await history.exportCsv({
+  path: './trades.csv',
+  from: '2024-01-01',
+  to: '2024-12-31',
+  columns: ['timestamp', 'platform', 'market', 'side', 'size', 'price', 'pnl'],
+});
+
+// Export to JSON
+const json = await history.exportJson({
+  from: '2024-01-01',
+});
+```
+
+---
+
+## Database Schema
+
+```sql
+CREATE TABLE trades (
+  id TEXT PRIMARY KEY,
+  platform TEXT NOT NULL,
+  market_id TEXT NOT NULL,
+  market_question TEXT,
+  side TEXT NOT NULL,  -- 'buy' or 'sell'
+  outcome TEXT,        -- 'YES' or 'NO'
+  size REAL NOT NULL,
+  price REAL NOT NULL,
+  fee REAL DEFAULT 0,
+  pnl REAL,
+  timestamp INTEGER NOT NULL,
+  created_at INTEGER DEFAULT (strftime('%s', 'now'))
+);
+
+CREATE INDEX idx_trades_platform ON trades(platform);
+CREATE INDEX idx_trades_timestamp ON trades(timestamp);
+CREATE INDEX idx_trades_market ON trades(market_id);
+```
+
+---
+
+## Best Practices
+
+1. **Sync regularly** - Keep local database up to date
+2. **Export backups** - Periodically export to CSV
+3. **Review weekly** - Analyze performance patterns
+4. **Track by category** - Identify strong/weak areas
+5. **Monitor drawdown** - Set alerts for max drawdown

package/dist/skills/bundled/hyperliquid/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: hyperliquid
+description: Hyperliquid L1 perps DEX (69% market share)
+emoji: "🔷"
+commands:
+  - /hl
+---
+
+# Hyperliquid
+
+Full integration with the dominant perpetual futures DEX. 130+ perp markets, spot trading, HLP vault, TWAP orders.
+
+## Quick Start
+
+```bash
+# Set credentials
+export HYPERLIQUID_WALLET="0x..."
+export HYPERLIQUID_PRIVATE_KEY="0x..."
+
+# Check balance
+/hl balance
+
+# Open a position
+/hl long BTC 0.1
+/hl short ETH 1 3000
+
+# Close position
+/hl close BTC
+```
+
+## Commands
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/hl stats` | HLP TVL, APR, top funding rates |
+| `/hl markets [query]` | List perp/spot markets |
+| `/hl price <coin>` | Get current price |
+| `/hl book <coin>` | Show orderbook depth |
+| `/hl candles <coin> [1m\|5m\|15m\|1h\|4h\|1d]` | OHLCV candle data |
+| `/hl funding [coin]` | Funding rates (current + predicted) |
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/hl balance` | Positions, balances, margin |
+| `/hl portfolio` | PnL breakdown (day/week/month/all) |
+| `/hl orders` | List open orders |
+| `/hl orders cancel <coin> [orderId]` | Cancel orders |
+| `/hl orders cancelall` | Cancel all orders |
+| `/hl fills [coin]` | Recent trade fills |
+| `/hl history` | Order history |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/hl long <coin> <size> [price]` | Open long position |
+| `/hl short <coin> <size> [price]` | Open short position |
+| `/hl close <coin>` | Close position at market |
+| `/hl closeall` | Close all positions |
+| `/hl leverage <coin> <1-50>` | Set leverage |
+| `/hl margin <coin> <amount>` | Add/remove isolated margin |
+
+**Examples:**
+```bash
+/hl long BTC 0.1           # Market long 0.1 BTC
+/hl long BTC 0.1 45000     # Limit long at $45,000
+/hl short ETH 1            # Market short 1 ETH
+/hl close BTC              # Close BTC position
+/hl leverage BTC 10        # Set 10x leverage
+```
+
+### TWAP Orders
+
+Execute large orders over time to minimize slippage.
+
+| Command | Description |
+|---------|-------------|
+| `/hl twap buy <coin> <size> <minutes>` | Start TWAP buy |
+| `/hl twap sell <coin> <size> <minutes>` | Start TWAP sell |
+| `/hl twap cancel <coin> <twapId>` | Cancel TWAP |
+| `/hl twap status` | Show active TWAP fills |
+
+**Example:**
+```bash
+/hl twap buy BTC 1 60      # Buy 1 BTC over 60 minutes
+/hl twap sell ETH 10 30    # Sell 10 ETH over 30 minutes
+```
+
+### Spot Trading
+
+| Command | Description |
+|---------|-------------|
+| `/hl spot markets` | List spot markets |
+| `/hl spot book <coin>` | Spot orderbook |
+| `/hl spot buy <coin> <amount> [price]` | Buy spot |
+| `/hl spot sell <coin> <amount> [price]` | Sell spot |
+
+### HLP Vault
+
+Earn yield by providing liquidity to the HLP vault.
+
+| Command | Description |
+|---------|-------------|
+| `/hl hlp` | Show vault stats (TVL, APR) |
+| `/hl hlp deposit <amount>` | Deposit USDC to vault |
+| `/hl hlp withdraw <amount>` | Withdraw from vault |
+| `/hl vaults` | Your vault positions |
+
+### Transfers
+
+| Command | Description |
+|---------|-------------|
+| `/hl transfer spot2perp <amount>` | Move USDC to perps |
+| `/hl transfer perp2spot <amount>` | Move USDC to spot |
+| `/hl transfer send <address> <amount>` | Send USDC on Hyperliquid |
+| `/hl transfer withdraw <address> <amount>` | Withdraw to L1 (Arbitrum) |
+
+### Account Info
+
+| Command | Description |
+|---------|-------------|
+| `/hl fees` | Your fee tier & rate limits |
+| `/hl points` | Points balance |
+| `/hl referral` | Referral info & rewards |
+| `/hl claim` | Claim referral rewards |
+| `/hl leaderboard [day\|week\|month\|allTime]` | Top traders |
+| `/hl sub` | List subaccounts |
+| `/hl sub create <name>` | Create subaccount |
+| `/hl lend` | Borrow/lend rates |
+
+## Shortcuts
+
+Most commands have short aliases:
+
+| Full | Short |
+|------|-------|
+| `/hl balance` | `/hl b` |
+| `/hl markets` | `/hl m` |
+| `/hl price` | `/hl p` |
+| `/hl book` | `/hl ob` |
+| `/hl candles` | `/hl c` |
+| `/hl funding` | `/hl f` |
+| `/hl orders` | `/hl o` |
+| `/hl history` | `/hl h` |
+| `/hl long` | `/hl l` |
+| `/hl short` | `/hl s` |
+| `/hl leverage` | `/hl lev` |
+| `/hl portfolio` | `/hl pf` |
+| `/hl leaderboard` | `/hl lb` |
+| `/hl referral` | `/hl ref` |
+
+## Configuration
+
+```bash
+# Required for trading
+export HYPERLIQUID_WALLET="0x..."
+export HYPERLIQUID_PRIVATE_KEY="0x..."
+
+# Optional: dry run mode (no real trades)
+export DRY_RUN=true
+```
+
+## Features
+
+- **130+ Perp Markets** with up to 50x leverage
+- **Spot Trading** with native HYPE token
+- **HLP Vault** - Earn yield providing liquidity
+- **TWAP Orders** - Execute large orders over time
+- **Points System** - Earn rewards for activity
+- **Subaccounts** - Manage multiple strategies
+- **Real-time WebSocket** - Live orderbook and fills
+
+### Database/History
+
+All trades are automatically logged to SQLite for tracking.
+
+| Command | Description |
+|---------|-------------|
+| `/hl trades [coin] [limit]` | Trade history from database |
+| `/hl dbstats [coin] [period]` | Win rate, PnL, profit factor |
+| `/hl dbfunding [coin]` | Funding payments history |
+| `/hl dbpositions [all]` | Position history |
+
+**Stats periods:** `day`, `week`, `month`
+
+**Example:**
+```bash
+/hl trades BTC 10           # Last 10 BTC trades
+/hl dbstats week            # This week's performance
+/hl dbstats ETH month       # ETH stats for the month
+```
+
+## Resources
+
+- [Hyperliquid App](https://app.hyperliquid.xyz)
+- [API Documentation](https://hyperliquid.gitbook.io/hyperliquid-docs)

package/dist/skills/bundled/hyperliquid/index.d.ts

@@ -11,9 +11,6 @@ export declare const skill: {
         description: string;
         usage: string;
     }[];
-    requires: {
-        env: string[];
-    };
     handler(args: string): Promise<string>;
 };
 export default skill;

package/dist/skills/bundled/hyperliquid/index.js

@@ -1120,7 +1120,6 @@ exports.skill = {
             usage: '/hl <command>',
         },
     ],
-    requires: { env: ['HYPERLIQUID_PRIVATE_KEY'] },
     async handler(args) {
         const parts = args.trim().split(/\s+/);
         const cmd = parts[0]?.toLowerCase();