feat: Add LangGraph Hello World example with requirements, README, and tests

Author: ruvnet

example/Completion/agentic_editor/config/trading_config_example.yaml

@@ -0,0 +1,91 @@
+# Trading System Configuration Example
+
+market_data:
+  providers:
+    - name: "PROVIDER_A"
+      type: "REST_API"
+      api_key: "${PROVIDER_A_API_KEY}"
+      base_url: "https://api.provider-a.com/v1"
+      timeout_ms: 5000
+    - name: "PROVIDER_B" 
+      type: "WEBSOCKET"
+      api_key: "${PROVIDER_B_API_KEY}"
+      ws_endpoint: "wss://stream.provider-b.com"
+      reconnect_interval_s: 30
+
+trading_platforms:
+  - name: "EXCHANGE_1"
+    type: "SPOT"
+    api_credentials:
+      key: "${EXCHANGE_1_API_KEY}"
+      secret: "${EXCHANGE_1_SECRET}"
+    rate_limits:
+      requests_per_minute: 60
+      orders_per_second: 10
+  - name: "EXCHANGE_2"
+    type: "FUTURES"
+    api_credentials:
+      key: "${EXCHANGE_2_API_KEY}"
+      secret: "${EXCHANGE_2_SECRET}"
+    rate_limits:
+      requests_per_minute: 120
+      orders_per_second: 20
+
+risk_parameters:
+  max_drawdown_percent: 5.0
+  daily_loss_limit_usd: 10000
+  position_sizing:
+    max_position_size_percent: 2.0
+    risk_per_trade_percent: 1.0
+  volatility_controls:
+    max_daily_volatility: 0.25
+    vol_lookback_days: 20
+
+position_limits:
+  global:
+    max_notional_usd: 1000000
+    max_leverage: 3.0
+  per_asset:
+    BTC:
+      max_position_usd: 100000
+      max_leverage: 2.0
+    ETH:
+      max_position_usd: 50000
+      max_leverage: 2.0
+
+order_execution:
+  default_order_type: "LIMIT"
+  time_in_force: "GTC"
+  execution_algorithms:
+    twap:
+      enabled: true
+      default_duration_minutes: 30
+      min_participation_rate: 0.1
+    iceberg:
+      enabled: true
+      default_visible_size_percent: 0.2
+  smart_routing:
+    enabled: true
+    min_spread_threshold: 0.001
+
+monitoring:
+  logging:
+    level: "INFO"
+    file_path: "/var/log/trading/system.log"
+    rotation_size_mb: 100
+  alerts:
+    email:
+      enabled: true
+      recipients: ["[email protected]"]
+    slack:
+      enabled: true
+      webhook_url: "${SLACK_WEBHOOK_URL}"
+      channel: "#trading-alerts"
+  metrics:
+    prometheus:
+      enabled: true
+      port: 9090
+    statsd:
+      enabled: false
+      host: "localhost"
+      port: 8125

example/Completion/agentic_editor/docs/market_data.md

@@ -0,0 +1,79 @@
+# Market Data Provider Documentation
+
+## Interface
+
+The `AbstractMarketDataProvider` interface defines the standard contract for market data providers:
+
+```python
+class AbstractMarketDataProvider:
+    def get_current_price(self, symbol: str) -> float
+    def get_historical_data(self, symbol: str, start_date: datetime, end_date: datetime) -> List[Dict]
+    def subscribe_to_updates(self, symbol: str, callback: Callable[[PriceUpdate], None]) -> None
+    def unsubscribe(self, symbol: str) -> None
+```
+
+## Available Implementations
+
+### SimpleMarketDataProvider
+A basic implementation providing simulated market data:
+
+- Maintains in-memory price cache
+- Generates synthetic historical data
+- Simulates price updates using random walk
+- Supports real-time price subscriptions
+
+Configuration:
+```python
+provider = SimpleMarketDataProvider()
+```
+
+### Data Update Frequency
+- Real-time price updates: Every 1 second
+- Historical data: Daily OHLCV bars
+- Cache refresh: On-demand
+
+## Usage Examples
+
+### Getting Current Prices
+```python
+provider = SimpleMarketDataProvider()
+price = provider.get_current_price("AAPL")
+```
+
+### Historical Data
+```python
+history = provider.get_historical_data(
+    symbol="AAPL",
+    start_date=datetime(2024, 1, 1),
+    end_date=datetime(2024, 1, 9)
+)
+```
+
+### Price Updates Subscription
+```python
+def price_callback(update: PriceUpdate):
+    print(f"{update.symbol}: {update.price}")
+
+provider.subscribe_to_updates("AAPL", price_callback)
+```
+
+## Caching Behavior
+
+- Current prices cached in memory
+- Historical data cached after first request
+- Cache invalidation: Manual via provider restart
+- No persistent storage
+
+## Error Handling
+
+The provider throws standard exceptions:
+- KeyError: Unknown symbol
+- ValueError: Invalid date range
+- RuntimeError: Provider connection issues
+
+## Best Practices
+
+1. Unsubscribe when done with real-time updates
+2. Use date ranges within reasonable bounds
+3. Handle provider exceptions gracefully
+4. Monitor callback performance

example/Completion/agentic_editor/docs/risk_management.md

@@ -0,0 +1,162 @@
+# Risk Management System Documentation
+
+## System Overview
+
+The risk management system provides comprehensive trading risk controls through the `RiskManager` class and supporting utilities.
+
+### Core Components
+
+1. **RiskManager**: Central risk management class
+2. **PositionConfig**: Risk parameter configuration
+3. **RiskLevel**: Risk classification (LOW, MEDIUM, HIGH)
+4. **Utility Functions**: Position sizing and risk calculations
+
+## Position and Order Validation
+
+### Position Size Validation
+```python
+def validate_position_size(size: float, price: float) -> bool
+```
+Validates if position size is within configured limits:
+- Checks against max_position_size
+- Considers portfolio value
+- Returns boolean validation result
+
+### Stop Level Calculations
+```python
+def calculate_stop_levels(entry_price: float, risk_level: RiskLevel) -> Tuple[float, float]
+```
+Determines stop loss and take profit levels based on:
+- Entry price
+- Risk level multipliers
+- Configured risk percentages
+- Minimum risk/reward ratio
+
+## Risk Metrics and Calculations
+
+### Position Size Calculation
+```python
+def calculate_position_size(
+    account_value: float,
+    risk_per_trade: float,
+    entry_price: float,
+    stop_loss: float
+) -> float
+```
+
+### Risk/Reward Ratio
+```python
+def calculate_risk_reward_ratio(
+    entry_price: float,
+    stop_loss: float,
+    take_profit: float
+) -> float
+```
+
+### Portfolio Metrics
+```python
+def calculate_portfolio_metrics(
+    positions: Dict[str, float],
+    prices: Dict[str, float]
+) -> Dict[str, float]
+```
+Returns:
+- Total portfolio value
+- Concentration risk
+- Largest position percentage
+- Number of positions
+
+### Drawdown Monitoring
+```python
+def update_drawdown(current_value: float) -> bool
+```
+- Tracks portfolio drawdown
+- Validates against maximum limits
+- Returns compliance status
+
+## Configuration Options
+
+### Position Configuration
+```python
+@dataclass
+class PositionConfig:
+    max_position_size: float  # Maximum position size as % of portfolio
+    max_drawdown: float      # Maximum allowed drawdown %
+    risk_per_trade: float    # Risk per trade as % of portfolio
+    min_risk_reward: float   # Minimum risk/reward ratio
+```
+
+### Risk Levels
+```python
+class RiskLevel(Enum):
+    LOW = "low"      # Base risk
+    MEDIUM = "medium"  # 1.5x risk multiplier
+    HIGH = "high"    # 2.0x risk multiplier
+```
+
+## Best Practices
+
+1. **Position Sizing**
+   - Always use position calculator
+   - Consider volatility adjustments
+   - Respect maximum limits
+
+2. **Stop Levels**
+   - Set appropriate risk level
+   - Validate risk/reward ratios
+   - Use stop level calculator
+
+3. **Portfolio Management**
+   - Monitor concentration risk
+   - Track drawdown regularly
+   - Maintain position diversity
+
+4. **Risk Configuration**
+   - Document risk parameters
+   - Review regularly
+   - Adjust for market conditions
+
+## Implementation Example
+
+```python
+# Initialize risk manager
+risk_config = PositionConfig(
+    max_position_size=5.0,  # 5% max position
+    max_drawdown=20.0,      # 20% max drawdown
+    risk_per_trade=1.0,     # 1% risk per trade
+    min_risk_reward=2.0     # 2:1 minimum R/R
+)
+
+risk_manager = RiskManager(
+    portfolio_value=100000.0,
+    config=risk_config
+)
+
+# Calculate position size
+position_size = risk_manager.calculate_position_size(
+    size=1000,
+    price=100.0,
+    volatility=15.0
+)
+
+# Validate and get stop levels
+if risk_manager.validate_position_size(position_size, price=100.0):
+    stop_loss, take_profit = risk_manager.calculate_stop_levels(
+        entry_price=100.0,
+        risk_level=RiskLevel.MEDIUM
+    )
+```
+
+## Error Handling
+
+- Invalid position sizes
+- Risk limit breaches
+- Drawdown violations
+- Configuration errors
+
+## Additional Resources
+
+- Strategy Documentation
+- Trading System Integration Guide
+- Risk Monitoring Dashboard
+- Historical Performance Analysis