feat: Add trading agent enhancements, backtesting system, and meta-agent improvements

.devwork/plan.md

@@ -0,0 +1,5 @@
+# Execution Plan
+
+## Tasks: 1
+
+{"summary":"This is a PR analysis request without a specific implementation task. The provided information describes PR #283 which has already been merged. There is no actionable implementation to perform - no files need to be created, modified, or built.","tasks":[{"id":"T001","tool":"Bash","args":{"command":"echo \"No implementation task specified. PR #283 describes changes that have already been merged. No action required.\""},"depends_on":[],"description":"Verify current state - PR describes completed changes, no pending implementation"}]}

.devwork/plan_response.txt

@@ -0,0 +1 @@
+{"summary":"This is a PR analysis request without a specific implementation task. The provided information describes PR #283 which has already been merged. There is no actionable implementation to perform - no files need to be created, modified, or built.","tasks":[{"id":"T001","tool":"Bash","args":{"command":"echo \"No implementation task specified. PR #283 describes changes that have already been merged. No action required.\""},"depends_on":[],"description":"Verify current state - PR describes completed changes, no pending implementation"}]}

.devwork/prompt.txt

@@ -0,0 +1,161 @@
+# PR #283: feat: Add trading agent enhancements, backtesting system, and meta-agent improvements
+
+## Description
+## Summary
+
+This PR adds comprehensive trading agent enhancements, a complete backtesting system, meta-agent decision engine, and extensive documentation.
+
+## Key Features
+
+### 🤖 Meta-Agent Decision Engine
+- Autonomous agent spawning/killing based on performance analysis
+- Multi-strategy reasoning (debate, reflexion, plan-and-solve)
+- Rate limiting protection (max 20 AI calls/hour)
+- Crash recovery with state snapshots
+- Emergency shutdown with verified process cleanup
+
+### 📊 Trading Agent Improvements
+- **Book-informed enhancements** (6 features from disaster lessons):
+  - Honeypot prevention with pump.fun bonding curve detection
+  - Holder momentum analysis
+  - Lifecycle stage awareness (avoid dead memes)
+  - Tiered profit-taking (2x/5x/10x strategy)
+  - Trailing stop loss
+  - Quick wins detection (overpromise filtering)
+- Historical USD price integration for wallet tracing
+- Improved AI timeout handling
+
+### 🔬 Backtesting System
+- **Decision logging** in JSONL format with full context
+- **Multi-timeframe validation** (15min, 30min, 1h, 2h, 4h)
+- Opportunity cost calculation for missed trades
+- Automated decision categorization (Correct/Missed/Unknown)
+- Integration with self-optimization loop
+
+### 📚 Documentation (11 new files, 3,503 lines)
+- Complete backtesting system guide
+- Trading agent validation procedures
+- Solana snapshot/transaction analysis guides
+- Self-ask critical analysis (identified and fixed memory leak)
+- Master documentation index
+
+### 🐛 Bug Fixes
+- **Memory leak**: Fixed unbounded decision_history growth by using logger's bounded cache
+- **Rate limiter**: Added negative time delta handling for clock skew
+- **UTF-8 safety**: Fixed string truncation panic with `is_char_boundary()`
+- **Honeypot false positives**: Recognize pump.fun bonding curve sellability
+
+## Test Results
+
+✅ All tests passing: 842/842 unit tests (0 failed)
+✅ Build successful
+✅ Code formatted with `cargo fmt`
+
+## Breaking Changes
+
+None - all changes are backward compatible.
+
+## Documentation
+
+See new file
+... (truncated)
+
+## Diff
+```diff
+could not find pull request diff: HTTP 406: Sorry, the diff exceeded the maximum number of lines (20000) (https://api.github.com/repos/openSVM/osvm-cli/pulls/283)
+PullRequest.diff too_large
+```
+
+## Task
+## Summary
+
+This PR adds comprehensive trading agent enhancements, a complete backtesting system, meta-agent decision engine, and extensive documentation.
+
+## Key Features
+
+### 🤖 Meta-Agent Decision Engine
+- Autonomous agent spawning/killing based on performance analysis
+- Multi-strategy reasoning (debate, reflexion, plan-and-solve)
+- Rate limiting protection (max 20 AI calls/hour)
+- Crash recovery with state snapshots
+- Emergency shutdown with verified process cleanup
+
+### 📊 Trading Agent Improvements
+- **Book-informed enhancements** (6 features from disaster lessons):
+  - Honeypot prevention with pump.fun bonding curve detection
+  - Holder momentum analysis
+  - Lifecycle stage awareness (avoid dead memes)
+  - Tiered profit-taking (2x/5x/10x strategy)
+  - Trailing stop loss
+  - Quick wins detection (overpromise filtering)
+- Historical USD price integration for wallet tracing
+- Improved AI timeout handling
+
+### 🔬 Backtesting System
+- **Decision logging** in JSONL format with full context
+- **Multi-timeframe validation** (15min, 30min, 1h, 2h, 4h)
+- Opportunity cost calculation for missed trades
+- Automated decision categorization (Correct/Missed/Unknown)
+- Integration with self-optimization loop
+
+### 📚 Documentation (11 new files, 3,503 lines)
+- Complete backtesting system guide
+- Trading agent validation procedures
+- Solana snapshot/transaction analysis guides
+- Self-ask critical analysis (identified and fixed memory leak)
+- Master documentation index
+
+### 🐛 Bug Fixes
+- **Memory leak**: Fixed unbounded decision_history growth by using logger's bounded cache
+- **Rate limiter**: Added negative time delta handling for clock skew
+- **UTF-8 safety**: Fixed string truncation panic with `is_char_boundary()`
+- **Honeypot false positives**: Recognize pump.fun bonding curve sellability
+
+## Test Results
+
+✅ All tests passing: 842/842 unit tests (0 failed)
+✅ Build successful
+✅ Code formatted with `cargo fmt`
+
+## Breaking Changes
+
+None - all changes are backward compatible.
+
+## Documentation
+
+See new files in `docs/`:
+- `BACKTEST_SYSTEM.md` - Core backtesting architecture
+- `MULTI_TIMEFRAME_BACKTEST.md` - Multi-interval validation
+- `book_enhancements_implemented.md` - Trading strategies
+- `DOCUMENTATION_INDEX.md` - Master index
+- And 7 more comprehensive guides
+
+---
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+## Summary by Sourcery
+
+Enhance the trading and meta-agent systems with decision logging for backtesting, improved wallet tracing with historical pricing, and stronger resilience features, alongside extensive documentation for validation, backtesting, and Solana snapshot analysis.
+
+New Features:
+- Add a decision logging service and integrate it into the trading agent to record decisions for later backtesting.
+- Extend wallet trace analysis to build USD-valued token flow graphs and show unique transfer patterns, including historical price lookup via external APIs.
+- Introduce additional meta-agent APIs for graceful shutdown and state inspection, and document key components such as the backtesting system and validation flows.
+
+Bug Fixes:
+- Fix a potential memory leak in the meta-agent by sourcing decision history from the logger’s bounded cache instead of an unbounded internal queue.
+- Harden the meta-agent rate limiter against system clock skew that could previously prevent proper reset.
+- Prevent potential panics when parsing AI analysis responses by using safe prefix stripping instead of unchecked string slicing.
+
+Enhancements:
+- Improve wallet trace logging, sampling, and counterparty reporting to focus on unique transfer patterns and include USD aggregates.
+- Refine meta-agent logging with snapshot error messages and automatic log rotation with retention policies.
+- Expand and clarify documentation comments across meta-agent components, performance analysis, and decision engine APIs.
+
+Documentation:
+- Add comprehensive documentation covering the backtesting system, multi-timeframe validation, Solana snapshot and transaction analysis, validation procedures, and funding attribution reporting.
+- Provide a master documentation index that catalogs all validation, backtesting, and operational docs for the trading and meta-agent systems.
+
+Tests:
+- Document and support a backtesting and validation workflow that can be exercised via provided scripts and decision logs, enabling systematic evaluation of trading decisions over multiple timeframes.