dexbot 1.1.10

package/scripts/clear-all.sh

@@ -0,0 +1,195 @@
+#!/bin/bash
+# Clear persisted order, log, and market adapter files in one operation.
+#
+# This combines the behavior of clear-orders.sh, clear-logs.sh, and
+# clear-market-adapter.sh while using a single confirmation prompt.
+# Usage: ./scripts/clear-all.sh or bash scripts/clear-all.sh
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PROFILE_ROOT="${DEXBOT_PROFILE_ROOT:-${PROJECT_ROOT}/profiles}"
+ORDERS_DIR="${PROFILE_ROOT}/orders"
+LOGS_DIR="${PROFILE_ROOT}/logs"
+MA_DATA_DIR="${PROJECT_ROOT}/market_adapter/data"
+MA_STATE_DIR="${PROJECT_ROOT}/market_adapter/state"
+
+# Functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_info "=========================================="
+log_info "DEXBot2 Clear All Script"
+log_info "=========================================="
+log_info "Orders directory:              $ORDERS_DIR"
+log_info "Logs directory:                $LOGS_DIR"
+log_info "Market adapter data directory: $MA_DATA_DIR"
+log_info "Market adapter state directory: $MA_STATE_DIR"
+log_info ""
+log_warning "WARNING: This will delete all persisted order, log, and market adapter files!"
+log_warning "Bots will regenerate grids and market adapter will re-bootstrap from Kibana."
+log_info ""
+
+# Check directories and count files
+ORDER_COUNT=0
+LOG_COUNT=0
+MA_DATA_COUNT=0
+MA_STATE_COUNT=0
+
+if [ -d "$ORDERS_DIR" ]; then
+    ORDER_COUNT=$(find "$ORDERS_DIR" -type f 2>/dev/null | wc -l)
+else
+    log_warning "Orders directory does not exist: $ORDERS_DIR"
+fi
+
+if [ -d "$LOGS_DIR" ]; then
+    LOG_COUNT=$(find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | wc -l)
+else
+    log_warning "Logs directory does not exist: $LOGS_DIR"
+fi
+
+if [ -d "$MA_DATA_DIR" ]; then
+    MA_DATA_COUNT=$(find "$MA_DATA_DIR" -type f 2>/dev/null | wc -l)
+else
+    log_warning "Market adapter data directory does not exist: $MA_DATA_DIR"
+fi
+
+if [ -d "$MA_STATE_DIR" ]; then
+    MA_STATE_COUNT=$(find "$MA_STATE_DIR" -type f 2>/dev/null | wc -l)
+else
+    log_warning "Market adapter state directory does not exist: $MA_STATE_DIR"
+fi
+
+TOTAL_COUNT=$((ORDER_COUNT + LOG_COUNT + MA_DATA_COUNT + MA_STATE_COUNT))
+
+if [ "$TOTAL_COUNT" -eq 0 ]; then
+    log_info "No matching files found to delete."
+    exit 0
+fi
+
+log_info "Found $ORDER_COUNT order, $LOG_COUNT log, $MA_DATA_COUNT data, and $MA_STATE_COUNT state file(s) to delete"
+log_info ""
+
+# Show what will be deleted
+if [ "$ORDER_COUNT" -gt 0 ]; then
+    log_info "Order files to be deleted:"
+    find "$ORDERS_DIR" -type f 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+if [ "$LOG_COUNT" -gt 0 ]; then
+    log_info "Log files to be deleted:"
+    find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+if [ "$MA_DATA_COUNT" -gt 0 ]; then
+    log_info "Market adapter data files to be deleted:"
+    find "$MA_DATA_DIR" -type f 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+if [ "$MA_STATE_COUNT" -gt 0 ]; then
+    log_info "Market adapter state files to be deleted:"
+    find "$MA_STATE_DIR" -type f 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+# Ask for confirmation
+read -p "Delete all listed files? (y/n): " -r CONFIRM
+
+if [ "$CONFIRM" != "y" ] && [ "$CONFIRM" != "Y" ]; then
+    log_warning "Cancelled"
+    exit 0
+fi
+
+# Delete files
+if [ "$ORDER_COUNT" -gt 0 ]; then
+    find "$ORDERS_DIR" -type f 2>/dev/null -delete
+fi
+
+if [ "$LOG_COUNT" -gt 0 ]; then
+    find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null -delete
+fi
+
+if [ "$MA_DATA_COUNT" -gt 0 ]; then
+    find "$MA_DATA_DIR" -type f 2>/dev/null -delete
+    find "$MA_DATA_DIR" -type d -empty 2>/dev/null -delete
+fi
+
+if [ "$MA_STATE_COUNT" -gt 0 ]; then
+    find "$MA_STATE_DIR" -type f 2>/dev/null -delete
+fi
+
+# Re-count to confirm
+REMAINING_ORDERS=0
+REMAINING_LOGS=0
+REMAINING_MA_DATA=0
+REMAINING_MA_STATE=0
+
+if [ -d "$ORDERS_DIR" ]; then
+    REMAINING_ORDERS=$(find "$ORDERS_DIR" -type f 2>/dev/null | wc -l)
+fi
+
+if [ -d "$LOGS_DIR" ]; then
+    REMAINING_LOGS=$(find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | wc -l)
+fi
+
+if [ -d "$MA_DATA_DIR" ]; then
+    REMAINING_MA_DATA=$(find "$MA_DATA_DIR" -type f 2>/dev/null | wc -l)
+fi
+
+if [ -d "$MA_STATE_DIR" ]; then
+    REMAINING_MA_STATE=$(find "$MA_STATE_DIR" -type f 2>/dev/null | wc -l)
+fi
+
+log_info "=========================================="
+if [ "$REMAINING_ORDERS" -eq 0 ] && [ "$REMAINING_LOGS" -eq 0 ] && [ "$REMAINING_MA_DATA" -eq 0 ] && [ "$REMAINING_MA_STATE" -eq 0 ]; then
+    log_success "All files cleared!"
+    log_info "Total deleted: $TOTAL_COUNT (orders: $ORDER_COUNT, logs: $LOG_COUNT, ma_data: $MA_DATA_COUNT, ma_state: $MA_STATE_COUNT)"
+    log_info ""
+    log_info "Next steps:"
+    log_info "- Bots will regenerate their grids on next run"
+    log_info "- Market adapter will re-bootstrap candle data from Kibana on next run"
+    log_info "- Start bots normally: pm2 start all (or specific bot name)"
+    log_info "- Monitor startup with: pm2 logs"
+else
+    log_warning "Cleanup incomplete — remaining: orders=$REMAINING_ORDERS logs=$REMAINING_LOGS ma_data=$REMAINING_MA_DATA ma_state=$REMAINING_MA_STATE"
+fi
+log_info "=========================================="
+
+exit 0

package/scripts/clear-logs.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# Clear all log files from profiles/logs directory
+#
+# This script safely removes all log files while preserving the logs directory structure.
+# Usage: ./scripts/clear-logs.sh or bash scripts/clear-logs.sh
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PROFILE_ROOT="${DEXBOT_PROFILE_ROOT:-${PROJECT_ROOT}/profiles}"
+LOGS_DIR="${PROFILE_ROOT}/logs"
+
+# Functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_info "=========================================="
+log_info "DEXBot2 Clear Logs Script"
+log_info "=========================================="
+log_info "Logs Directory: $LOGS_DIR"
+
+# Check if logs directory exists
+if [ ! -d "$LOGS_DIR" ]; then
+    log_warning "Logs directory does not exist: $LOGS_DIR"
+    log_info "Nothing to clean"
+    exit 0
+fi
+
+# Count log files
+LOG_COUNT=$(find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | wc -l)
+
+if [ "$LOG_COUNT" -eq 0 ]; then
+    log_info "No log files found in $LOGS_DIR"
+    exit 0
+fi
+
+log_info "Found $LOG_COUNT log file(s) to delete"
+log_info ""
+
+# Show what will be deleted
+log_info "Log files to be deleted:"
+find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | while read file; do
+    SIZE=$(du -h "$file" | cut -f1)
+    echo -e "${BLUE}  -${NC} $(basename "$file") ($SIZE)"
+done
+
+log_info ""
+
+# Ask for confirmation
+read -p "Delete these log files? (y/n): " -r CONFIRM
+
+if [ "$CONFIRM" != "y" ] && [ "$CONFIRM" != "Y" ]; then
+    log_warning "Cancelled"
+    exit 0
+fi
+
+# Delete log files
+find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null -delete
+DELETED=$?
+
+# Re-count to confirm
+REMAINING=$(find "$LOGS_DIR" -type f \( -name "*.log" -o -name "*.jsonl" \) 2>/dev/null | wc -l)
+
+log_info "=========================================="
+if [ "$REMAINING" -eq 0 ]; then
+    log_success "All log files cleared!"
+    log_info "Total deleted: $LOG_COUNT"
+else
+    log_warning "Cleanup incomplete. Remaining log files: $REMAINING"
+fi
+log_info "=========================================="
+
+exit 0

package/scripts/clear-market-adapter.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+# Clear market adapter data, state files, and runtime log.
+#
+# Removes all persisted candle data and state files from market_adapter/data/
+# and market_adapter/state/, plus profiles/logs/market_adapter.log,
+# dexbot-adapter.log, and dexbot-adapter-error.log. The market
+# adapter will bootstrap fresh from Kibana and regenerate state on next run.
+#
+# Usage: ./scripts/clear-market-adapter.sh or bash scripts/clear-market-adapter.sh
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PROFILE_ROOT="${DEXBOT_PROFILE_ROOT:-${PROJECT_ROOT}/profiles}"
+DATA_DIR="${PROJECT_ROOT}/market_adapter/data"
+STATE_DIR="${PROJECT_ROOT}/market_adapter/state"
+MARKET_ADAPTER_LOG="${PROFILE_ROOT}/logs/market_adapter.log"
+ADAPTER_OUT_LOG="${PROFILE_ROOT}/logs/dexbot-adapter.log"
+ADAPTER_ERR_LOG="${PROFILE_ROOT}/logs/dexbot-adapter-error.log"
+
+# Functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_info "=========================================="
+log_info "DEXBot2 Clear Market Adapter Script"
+log_info "=========================================="
+log_info "Data directory:  $DATA_DIR"
+log_info "State directory: $STATE_DIR"
+log_info "Log file:        $MARKET_ADAPTER_LOG"
+log_info "Adapter out log: $ADAPTER_OUT_LOG"
+log_info "Adapter err log: $ADAPTER_ERR_LOG"
+log_info ""
+log_warning "WARNING: This will delete all persisted candle data and state files!"
+log_warning "This also deletes the market adapter runtime log."
+log_warning "The market adapter will bootstrap fresh from Kibana on next run."
+log_info ""
+
+# Count files
+DATA_COUNT=0
+STATE_COUNT=0
+LOG_COUNT=0
+
+if [ -d "$DATA_DIR" ]; then
+    DATA_COUNT=$(find "$DATA_DIR" -type f 2>/dev/null | wc -l)
+else
+    log_warning "Data directory does not exist: $DATA_DIR"
+fi
+
+if [ -d "$STATE_DIR" ]; then
+    STATE_COUNT=$(find "$STATE_DIR" -type f 2>/dev/null | wc -l)
+else
+    log_warning "State directory does not exist: $STATE_DIR"
+fi
+
+if [ -f "$MARKET_ADAPTER_LOG" ]; then
+    LOG_COUNT=$((LOG_COUNT + 1))
+fi
+
+if [ -f "$ADAPTER_OUT_LOG" ]; then
+    LOG_COUNT=$((LOG_COUNT + 1))
+fi
+
+if [ -f "$ADAPTER_ERR_LOG" ]; then
+    LOG_COUNT=$((LOG_COUNT + 1))
+fi
+
+TOTAL_COUNT=$((DATA_COUNT + STATE_COUNT + LOG_COUNT))
+
+if [ "$TOTAL_COUNT" -eq 0 ]; then
+    log_info "No files found to delete."
+    exit 0
+fi
+
+log_info "Found $DATA_COUNT data file(s), $STATE_COUNT state file(s), and $LOG_COUNT log file(s) to delete"
+log_info ""
+
+# Show what will be deleted
+if [ "$DATA_COUNT" -gt 0 ]; then
+    log_info "Data files to be deleted:"
+    find "$DATA_DIR" -type f 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+if [ "$STATE_COUNT" -gt 0 ]; then
+    log_info "State files to be deleted:"
+    find "$STATE_DIR" -type f 2>/dev/null | while read -r file; do
+        SIZE=$(du -h "$file" | cut -f1)
+        echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$file") ($SIZE)"
+    done
+    log_info ""
+fi
+
+if [ "$LOG_COUNT" -gt 0 ]; then
+    log_info "Log files to be deleted:"
+    for logfile in "$MARKET_ADAPTER_LOG" "$ADAPTER_OUT_LOG" "$ADAPTER_ERR_LOG"; do
+        if [ -f "$logfile" ]; then
+            SIZE=$(du -h "$logfile" | cut -f1)
+            echo -e "${BLUE}  -${NC} $(realpath --relative-to="$PROJECT_ROOT" "$logfile") ($SIZE)"
+        fi
+    done
+    log_info ""
+fi
+
+# Ask for confirmation
+read -p "Delete all listed market adapter files? (y/n): " -r CONFIRM
+
+if [ "$CONFIRM" != "y" ] && [ "$CONFIRM" != "Y" ]; then
+    log_warning "Cancelled"
+    exit 0
+fi
+
+# Delete data files
+if [ "$DATA_COUNT" -gt 0 ]; then
+    log_info "Deleting data files..."
+    find "$DATA_DIR" -type f 2>/dev/null -delete
+    # Clean up empty subdirectories
+    find "$DATA_DIR" -type d -empty 2>/dev/null -delete
+fi
+
+# Delete state files
+if [ "$STATE_COUNT" -gt 0 ]; then
+    log_info "Deleting state files..."
+    find "$STATE_DIR" -type f 2>/dev/null -delete
+fi
+
+if [ "$LOG_COUNT" -gt 0 ]; then
+    log_info "Deleting market adapter logs..."
+    rm -f "$MARKET_ADAPTER_LOG" "$ADAPTER_OUT_LOG" "$ADAPTER_ERR_LOG"
+fi
+
+# Re-count to confirm
+REMAINING_DATA=0
+REMAINING_STATE=0
+REMAINING_LOG=0
+
+if [ -d "$DATA_DIR" ]; then
+    REMAINING_DATA=$(find "$DATA_DIR" -type f 2>/dev/null | wc -l)
+fi
+
+if [ -d "$STATE_DIR" ]; then
+    REMAINING_STATE=$(find "$STATE_DIR" -type f 2>/dev/null | wc -l)
+fi
+
+if [ -f "$MARKET_ADAPTER_LOG" ]; then
+    REMAINING_LOG=$((REMAINING_LOG + 1))
+fi
+
+if [ -f "$ADAPTER_OUT_LOG" ]; then
+    REMAINING_LOG=$((REMAINING_LOG + 1))
+fi
+
+if [ -f "$ADAPTER_ERR_LOG" ]; then
+    REMAINING_LOG=$((REMAINING_LOG + 1))
+fi
+
+log_info "=========================================="
+if [ "$REMAINING_DATA" -eq 0 ] && [ "$REMAINING_STATE" -eq 0 ] && [ "$REMAINING_LOG" -eq 0 ]; then
+    log_success "All market adapter files cleared!"
+    log_info "Total deleted: $TOTAL_COUNT (data: $DATA_COUNT, state: $STATE_COUNT, log: $LOG_COUNT)"
+    log_info ""
+    log_info "Next steps:"
+    log_info "- The market adapter will bootstrap fresh candle data from Kibana on next run"
+    log_info "- All bot center prices and AMA state will be recomputed"
+    log_info "- Start market adapter: tsx market_adapter/market_adapter.ts"
+else
+    log_warning "Cleanup incomplete. Remaining data files: $REMAINING_DATA, remaining state files: $REMAINING_STATE, remaining logs: $REMAINING_LOG"
+fi
+log_info "=========================================="
+
+exit 0

package/scripts/clear-orders.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+# Clear all persisted order files from profiles/orders directory
+#
+# This script safely removes all bot order state files while preserving the orders directory.
+# Use this to reset bot order grids and start fresh (clears cached order data).
+# WARNING: This will lose all persisted grid information. Bots will regenerate grids on next run.
+# Usage: ./scripts/clear-orders.sh or bash scripts/clear-orders.sh
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PROFILE_ROOT="${DEXBOT_PROFILE_ROOT:-${PROJECT_ROOT}/profiles}"
+ORDERS_DIR="${PROFILE_ROOT}/orders"
+
+# Functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_info "=========================================="
+log_info "DEXBot2 Clear Orders Script"
+log_info "=========================================="
+log_info "Orders Directory: $ORDERS_DIR"
+log_info ""
+log_warning "WARNING: This will delete all persisted order state files!"
+log_warning "Bots will regenerate their grids on the next run."
+log_info ""
+
+# Check if orders directory exists
+if [ ! -d "$ORDERS_DIR" ]; then
+    log_warning "Orders directory does not exist: $ORDERS_DIR"
+    log_info "Nothing to clean"
+    exit 0
+fi
+
+# Count order files
+FILE_COUNT=$(find "$ORDERS_DIR" -type f 2>/dev/null | wc -l)
+
+if [ "$FILE_COUNT" -eq 0 ]; then
+    log_info "No order files found in $ORDERS_DIR"
+    exit 0
+fi
+
+log_info "Found $FILE_COUNT file(s) to delete"
+log_info ""
+
+# Show what will be deleted
+log_info "Files to be deleted:"
+find "$ORDERS_DIR" -type f 2>/dev/null | while read file; do
+    SIZE=$(du -h "$file" | cut -f1)
+    echo -e "${BLUE}  -${NC} $(basename "$file") ($SIZE)"
+done
+
+log_info ""
+
+# Ask for confirmation
+read -p "Delete these order files? (y/n): " -r CONFIRM
+
+if [ "$CONFIRM" != "y" ] && [ "$CONFIRM" != "Y" ]; then
+    log_warning "Cancelled"
+    exit 0
+fi
+
+# Delete order files
+log_info "Deleting files..."
+find "$ORDERS_DIR" -type f 2>/dev/null -delete
+DELETE_STATUS=$?
+
+if [ $DELETE_STATUS -eq 0 ]; then
+    log_success "Delete operation completed"
+else
+    log_warning "Delete operation encountered issues (exit code: $DELETE_STATUS)"
+fi
+
+# Re-count to confirm
+REMAINING=$(find "$ORDERS_DIR" -type f 2>/dev/null | wc -l)
+
+log_info "=========================================="
+if [ "$REMAINING" -eq 0 ]; then
+    log_success "All order files cleared!"
+    log_info "Total deleted: $FILE_COUNT"
+    log_info ""
+    log_info "Next steps:"
+    log_info "- Bots will regenerate their grids on next run"
+    log_info "- Start bots normally: pm2 start all (or specific bot name)"
+    log_info "- Monitor the startup with: pm2 logs"
+else
+    log_warning "Cleanup incomplete. Remaining files: $REMAINING"
+fi
+log_info "=========================================="
+
+exit 0

package/scripts/create-bot-symlinks.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# create-bot-symlinks.sh - Create ecosystem config symlinks for each bot
+#
+# This allows: pm2 start bot-name (or: pm2 start bot-name.config.js)
+#
+# Usage: ./scripts/create-bot-symlinks.sh
+
+REPO_ROOT=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+PROFILE_ROOT="${DEXBOT_PROFILE_ROOT:-${REPO_ROOT}/profiles}"
+BOTS_CONFIG="${PROFILE_ROOT}/bots.json"
+ECOSYSTEM_CONFIG="${PROFILE_ROOT}/ecosystem.config.js"
+PROFILES_DIR="${PROFILE_ROOT}"
+
+if [ ! -f "$BOTS_CONFIG" ]; then
+    echo "Error: $BOTS_CONFIG not found"
+    exit 1
+fi
+
+if [ ! -f "$ECOSYSTEM_CONFIG" ]; then
+    echo "Error: $ECOSYSTEM_CONFIG not found"
+    exit 1
+fi
+
+echo "Creating PM2 bot symlinks in profiles directory..."
+
+# Parse bots.json and create symlinks
+node -e "
+const fs = require('fs');
+const path = require('path');
+const botsConfig = JSON.parse(fs.readFileSync('$BOTS_CONFIG', 'utf8'));
+const profilesDir = '$PROFILES_DIR';
+const ecoConfig = '$ECOSYSTEM_CONFIG';
+
+(botsConfig.bots || []).forEach(bot => {
+    const botName = bot.name;
+    const symlink = path.join(profilesDir, botName + '.config.js');
+
+    // Remove old symlink if exists
+    if (fs.existsSync(symlink)) {
+        fs.unlinkSync(symlink);
+    }
+
+    // Create symlink
+    try {
+        fs.symlinkSync(ecoConfig, symlink);
+        console.log('✓ Created symlink: profiles/' + botName + '.config.js -> ecosystem.config.js');
+    } catch (err) {
+        console.error('✗ Error creating symlink for ' + botName + ':', err.message);
+    }
+});
+"

package/scripts/postinstall.js

@@ -0,0 +1,9 @@
+'use strict';
+if (process.env.npm_config_global !== 'true') process.exit(0);
+console.log('');
+console.log('DEXBot2 installed! To get started:');
+console.log('  dexbot keys        Set up master password');
+console.log('  dexbot bots        Create and manage bots');
+console.log('  dexbot unlock      Run credential daemon + bot');
+console.log('  dexbot help        Show all commands');
+console.log('');