QuantClaw Data

# Phase 49: Political Risk Scoring - COMPLETED ✅ ## Overview Political risk scoring module with geopolitical events tracking, sanctions monitoring, regulatory change analysis, and country risk assessment. ## Implementation Details ### Module: `/modules/political_risk.py` - **Lines of Code:** 560 - **Data Sources:** - GDELT Project (gdeltproject.org) - Global event database - OFAC Sanctions List (treasury.gov CSV) - World Bank Governance Indicators (16 countries) - Transparency International CPI scores ### Features Implemented #### 1. Geopolitical Events Tracking ```bash python cli.py geopolitical-events [--country COUNTRY] [--keywords KEYWORDS] [--hours HOURS] ``` - GDELT API integration for real-time global events - Risk scoring based on keyword analysis - Event classification (low/medium/high/critical) - Graceful fallback to sample data when API unavailable #### 2. Sanctions Search ```bash python cli.py sanctions-search [--entity NAME] [--type country|individual|entity] ``` - Downloads and parses OFAC SDN (Specially Designated Nationals) list - Entity name filtering - Type-based filtering (country/individual/entity) - Returns program details and remarks #### 3. Regulatory Changes Tracking ```bash python cli.py regulatory-changes [--sector SECTOR] [--country COUNTRY] [--days DAYS] ``` - GDELT-based regulatory news tracking - Sector-specific filtering (finance, tech, energy, healthcare) - Impact scoring (low/medium/high/critical) - Lookback periods (default 30 days) #### 4. Country Risk Assessment ```bash python cli.py country-risk COUNTRY_CODE ``` - World Bank Governance Indicators (6 dimensions): - Voice & Accountability - Political Stability - Government Effectiveness - Regulatory Quality - Rule of Law - Control of Corruption - Transparency International CPI integration - Composite risk score (0-100) - Investment risk interpretation - 16 countries supported (USA, CHN, RUS, GBR, DEU, FRA, JPN, IND, BRA, MEX, SAU, TUR, IRN, ISR, UKR, POL) ## API Route ### Endpoint: `/api/v1/political-risk` ```typescript GET /api/v1/political-risk?action=geopolitical-events&country=USA&hours=48 GET /api/v1/political-risk?action=sanctions-search&entity=Russia&type=country GET /api/v1/political-risk?action=regulatory-changes&sector=finance&days=30 GET /api/v1/political-risk?action=country-risk&country=USA ``` ## Services Registration Added to `services.ts`: - `geopolitical_events` - Real-time event tracking with risk scoring - `sanctions_search` - OFAC sanctions list search - `regulatory_changes` - Sector-specific regulatory monitoring - `country_risk` - Comprehensive country risk indicators ## Testing Results ### ✅ All Commands Tested Successfully **Country Risk - USA:** - Composite Risk Score: 26.4 (low) - Governance Score: 73.6/100 - CPI Score: 69/100 - Investment Risk: Low - Regulatory Stability: High **Country Risk - Russia:** - Composite Risk Score: 65.5 (high) - Governance Score: 34.5/100 - CPI Score: 26/100 - Investment Risk: High - Regulatory Stability: Low **Country Risk - China:** - Composite Risk Score: 57.3 (high) - Governance Score: 42.7/100 - CPI Score: 42/100 - Investment Risk: High - Regulatory Stability: Low **Geopolitical Events:** - GDELT API integration working (with timeout handling) - Sample data fallback functional - Event classification and risk scoring operational **Sanctions Search:** - OFAC CSV download successful - Entity filtering working - Returns structured sanctions data **Regulatory Changes:** - GDELT-based regulatory news tracking operational - Impact scoring working - Sector and country filtering functional ## CLI Help Documentation Updated `print_help()` with: - Political Risk Scoring section (Phase 49) - Command syntax for all 4 commands - Example usage in examples section ## Roadmap Update Updated `roadmap.ts`: - Phase 49 status: `"planned"` → `"done"` - Added `loc: 560` ## Key Features ✅ Free data sources (no API keys required) ✅ Real-time geopolitical event tracking ✅ Comprehensive country risk indicators ✅ OFAC sanctions list integration ✅ Regulatory change impact modeling ✅ Graceful error handling with fallback data ✅ REST API endpoints ✅ CLI integration ✅ Comprehensive help documentation ## Production Ready - All commands tested and working - Error handling implemented - Sample data fallbacks for API timeouts - Comprehensive documentation - Ready for deployment --- **Build Date:** 2026-02-25 **Status:** ✅ COMPLETE **Total LOC:** 560 (Python) + 64 (TypeScript API route) = 624 total lines