quantwise 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/.claude/skills/README.md +80 -0
  2. package/.claude/skills/backtest-expert/SKILL.md +206 -0
  3. package/.claude/skills/backtest-expert/references/failed_tests.md +236 -0
  4. package/.claude/skills/backtest-expert/references/methodology.md +227 -0
  5. package/.claude/skills/breadth-chart-analyst/SKILL.md +583 -0
  6. package/.claude/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  7. package/.claude/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  8. package/.claude/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  9. package/.claude/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  10. package/.claude/skills/canslim-screener/SKILL.md +599 -0
  11. package/.claude/skills/canslim-screener/references/canslim_methodology.md +606 -0
  12. package/.claude/skills/canslim-screener/references/fmp_api_endpoints.md +707 -0
  13. package/.claude/skills/canslim-screener/references/interpretation_guide.md +516 -0
  14. package/.claude/skills/canslim-screener/references/scoring_system.md +597 -0
  15. package/.claude/skills/canslim-screener/scripts/calculators/earnings_calculator.py +343 -0
  16. package/.claude/skills/canslim-screener/scripts/calculators/growth_calculator.py +334 -0
  17. package/.claude/skills/canslim-screener/scripts/calculators/institutional_calculator.py +347 -0
  18. package/.claude/skills/canslim-screener/scripts/calculators/leadership_calculator.py +380 -0
  19. package/.claude/skills/canslim-screener/scripts/calculators/market_calculator.py +244 -0
  20. package/.claude/skills/canslim-screener/scripts/calculators/new_highs_calculator.py +194 -0
  21. package/.claude/skills/canslim-screener/scripts/calculators/supply_demand_calculator.py +221 -0
  22. package/.claude/skills/canslim-screener/scripts/finviz_stock_client.py +227 -0
  23. package/.claude/skills/canslim-screener/scripts/fmp_client.py +393 -0
  24. package/.claude/skills/canslim-screener/scripts/report_generator.py +405 -0
  25. package/.claude/skills/canslim-screener/scripts/scorer.py +625 -0
  26. package/.claude/skills/canslim-screener/scripts/screen_canslim.py +361 -0
  27. package/.claude/skills/canslim-screener/scripts/test_institutional_endpoint.py +109 -0
  28. package/.claude/skills/chart/SKILL.md +20 -0
  29. package/.claude/skills/dividend-growth-pullback-screener/SKILL.md +322 -0
  30. package/.claude/skills/dividend-growth-pullback-screener/references/dividend_growth_compounding.md +400 -0
  31. package/.claude/skills/dividend-growth-pullback-screener/references/fmp_api_guide.md +642 -0
  32. package/.claude/skills/dividend-growth-pullback-screener/references/rsi_oversold_strategy.md +333 -0
  33. package/.claude/skills/dividend-growth-pullback-screener/scripts/screen_dividend_growth_rsi.py +1155 -0
  34. package/.claude/skills/earnings-calendar/SKILL.md +721 -0
  35. package/.claude/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  36. package/.claude/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  37. package/.claude/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  38. package/.claude/skills/earnings-calendar/scripts/generate_report.py +366 -0
  39. package/.claude/skills/economic-calendar-fetcher/SKILL.md +365 -0
  40. package/.claude/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  41. package/.claude/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  42. package/.claude/skills/ftd-detector/SKILL.md +147 -0
  43. package/.claude/skills/ftd-detector/references/ftd_methodology.md +188 -0
  44. package/.claude/skills/ftd-detector/references/post_ftd_guide.md +185 -0
  45. package/.claude/skills/ftd-detector/scripts/fmp_client.py +158 -0
  46. package/.claude/skills/ftd-detector/scripts/ftd_detector.py +280 -0
  47. package/.claude/skills/ftd-detector/scripts/post_ftd_monitor.py +404 -0
  48. package/.claude/skills/ftd-detector/scripts/rally_tracker.py +508 -0
  49. package/.claude/skills/ftd-detector/scripts/report_generator.py +341 -0
  50. package/.claude/skills/ftd-detector/scripts/tests/conftest.py +9 -0
  51. package/.claude/skills/ftd-detector/scripts/tests/helpers.py +107 -0
  52. package/.claude/skills/ftd-detector/scripts/tests/test_post_ftd_monitor.py +311 -0
  53. package/.claude/skills/ftd-detector/scripts/tests/test_rally_tracker.py +302 -0
  54. package/.claude/skills/institutional-flow-tracker/README.md +362 -0
  55. package/.claude/skills/institutional-flow-tracker/SKILL.md +357 -0
  56. package/.claude/skills/institutional-flow-tracker/references/13f_filings_guide.md +383 -0
  57. package/.claude/skills/institutional-flow-tracker/references/institutional_investor_types.md +580 -0
  58. package/.claude/skills/institutional-flow-tracker/references/interpretation_framework.md +573 -0
  59. package/.claude/skills/institutional-flow-tracker/scripts/analyze_single_stock.py +457 -0
  60. package/.claude/skills/institutional-flow-tracker/scripts/track_institution_portfolio.py +108 -0
  61. package/.claude/skills/institutional-flow-tracker/scripts/track_institutional_flow.py +450 -0
  62. package/.claude/skills/macro-regime-detector/SKILL.md +86 -0
  63. package/.claude/skills/macro-regime-detector/references/historical_regimes.md +124 -0
  64. package/.claude/skills/macro-regime-detector/references/indicator_interpretation_guide.md +144 -0
  65. package/.claude/skills/macro-regime-detector/references/regime_detection_methodology.md +138 -0
  66. package/.claude/skills/macro-regime-detector/scripts/calculators/__init__.py +1 -0
  67. package/.claude/skills/macro-regime-detector/scripts/calculators/concentration_calculator.py +165 -0
  68. package/.claude/skills/macro-regime-detector/scripts/calculators/credit_conditions_calculator.py +124 -0
  69. package/.claude/skills/macro-regime-detector/scripts/calculators/equity_bond_calculator.py +198 -0
  70. package/.claude/skills/macro-regime-detector/scripts/calculators/sector_rotation_calculator.py +123 -0
  71. package/.claude/skills/macro-regime-detector/scripts/calculators/size_factor_calculator.py +131 -0
  72. package/.claude/skills/macro-regime-detector/scripts/calculators/utils.py +347 -0
  73. package/.claude/skills/macro-regime-detector/scripts/calculators/yield_curve_calculator.py +279 -0
  74. package/.claude/skills/macro-regime-detector/scripts/fmp_client.py +134 -0
  75. package/.claude/skills/macro-regime-detector/scripts/macro_regime_detector.py +278 -0
  76. package/.claude/skills/macro-regime-detector/scripts/report_generator.py +327 -0
  77. package/.claude/skills/macro-regime-detector/scripts/scorer.py +574 -0
  78. package/.claude/skills/macro-regime-detector/scripts/tests/conftest.py +9 -0
  79. package/.claude/skills/macro-regime-detector/scripts/tests/test_concentration.py +78 -0
  80. package/.claude/skills/macro-regime-detector/scripts/tests/test_credit_conditions.py +59 -0
  81. package/.claude/skills/macro-regime-detector/scripts/tests/test_equity_bond.py +74 -0
  82. package/.claude/skills/macro-regime-detector/scripts/tests/test_helpers.py +90 -0
  83. package/.claude/skills/macro-regime-detector/scripts/tests/test_scorer.py +439 -0
  84. package/.claude/skills/macro-regime-detector/scripts/tests/test_sector_rotation.py +78 -0
  85. package/.claude/skills/macro-regime-detector/scripts/tests/test_size_factor.py +59 -0
  86. package/.claude/skills/macro-regime-detector/scripts/tests/test_utils.py +126 -0
  87. package/.claude/skills/macro-regime-detector/scripts/tests/test_yield_curve.py +64 -0
  88. package/.claude/skills/market-breadth-analyzer/SKILL.md +121 -0
  89. package/.claude/skills/market-breadth-analyzer/references/breadth_analysis_methodology.md +168 -0
  90. package/.claude/skills/market-breadth-analyzer/scripts/calculators/__init__.py +1 -0
  91. package/.claude/skills/market-breadth-analyzer/scripts/calculators/bearish_signal_calculator.py +150 -0
  92. package/.claude/skills/market-breadth-analyzer/scripts/calculators/cycle_calculator.py +168 -0
  93. package/.claude/skills/market-breadth-analyzer/scripts/calculators/divergence_calculator.py +119 -0
  94. package/.claude/skills/market-breadth-analyzer/scripts/calculators/historical_context_calculator.py +120 -0
  95. package/.claude/skills/market-breadth-analyzer/scripts/calculators/ma_crossover_calculator.py +115 -0
  96. package/.claude/skills/market-breadth-analyzer/scripts/calculators/trend_level_calculator.py +103 -0
  97. package/.claude/skills/market-breadth-analyzer/scripts/csv_client.py +225 -0
  98. package/.claude/skills/market-breadth-analyzer/scripts/market_breadth_analyzer.py +307 -0
  99. package/.claude/skills/market-breadth-analyzer/scripts/report_generator.py +330 -0
  100. package/.claude/skills/market-breadth-analyzer/scripts/scorer.py +271 -0
  101. package/.claude/skills/market-environment-analysis/SKILL.md +139 -0
  102. package/.claude/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  103. package/.claude/skills/market-environment-analysis/references/indicators.md +99 -0
  104. package/.claude/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  105. package/.claude/skills/market-news-analyst/SKILL.md +714 -0
  106. package/.claude/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  107. package/.claude/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  108. package/.claude/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  109. package/.claude/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  110. package/.claude/skills/market-top-detector/SKILL.md +159 -0
  111. package/.claude/skills/market-top-detector/references/distribution_day_guide.md +100 -0
  112. package/.claude/skills/market-top-detector/references/historical_tops.md +142 -0
  113. package/.claude/skills/market-top-detector/references/market_top_methodology.md +167 -0
  114. package/.claude/skills/market-top-detector/scripts/calculators/__init__.py +17 -0
  115. package/.claude/skills/market-top-detector/scripts/calculators/breadth_calculator.py +116 -0
  116. package/.claude/skills/market-top-detector/scripts/calculators/defensive_rotation_calculator.py +127 -0
  117. package/.claude/skills/market-top-detector/scripts/calculators/distribution_day_calculator.py +161 -0
  118. package/.claude/skills/market-top-detector/scripts/calculators/index_technical_calculator.py +254 -0
  119. package/.claude/skills/market-top-detector/scripts/calculators/leading_stock_calculator.py +198 -0
  120. package/.claude/skills/market-top-detector/scripts/calculators/sentiment_calculator.py +213 -0
  121. package/.claude/skills/market-top-detector/scripts/fmp_client.py +158 -0
  122. package/.claude/skills/market-top-detector/scripts/market_top_detector.py +349 -0
  123. package/.claude/skills/market-top-detector/scripts/report_generator.py +314 -0
  124. package/.claude/skills/market-top-detector/scripts/scorer.py +473 -0
  125. package/.claude/skills/market-top-detector/scripts/tests/conftest.py +9 -0
  126. package/.claude/skills/market-top-detector/scripts/tests/helpers.py +49 -0
  127. package/.claude/skills/market-top-detector/scripts/tests/test_breadth.py +62 -0
  128. package/.claude/skills/market-top-detector/scripts/tests/test_defensive_rotation.py +56 -0
  129. package/.claude/skills/market-top-detector/scripts/tests/test_distribution_day.py +92 -0
  130. package/.claude/skills/market-top-detector/scripts/tests/test_index_technical.py +73 -0
  131. package/.claude/skills/market-top-detector/scripts/tests/test_leading_stock.py +57 -0
  132. package/.claude/skills/market-top-detector/scripts/tests/test_scorer.py +180 -0
  133. package/.claude/skills/market-top-detector/scripts/tests/test_sentiment.py +64 -0
  134. package/.claude/skills/options-strategy-advisor/README.md +469 -0
  135. package/.claude/skills/options-strategy-advisor/SKILL.md +959 -0
  136. package/.claude/skills/options-strategy-advisor/scripts/black_scholes.py +495 -0
  137. package/.claude/skills/pair-trade-screener/README.md +389 -0
  138. package/.claude/skills/pair-trade-screener/SKILL.md +622 -0
  139. package/.claude/skills/pair-trade-screener/references/cointegration_guide.md +745 -0
  140. package/.claude/skills/pair-trade-screener/references/methodology.md +853 -0
  141. package/.claude/skills/pair-trade-screener/scripts/analyze_spread.py +394 -0
  142. package/.claude/skills/pair-trade-screener/scripts/find_pairs.py +535 -0
  143. package/.claude/skills/portfolio-manager/README.md +394 -0
  144. package/.claude/skills/portfolio-manager/SKILL.md +750 -0
  145. package/.claude/skills/portfolio-manager/references/alpaca-mcp-setup.md +367 -0
  146. package/.claude/skills/portfolio-manager/references/asset-allocation.md +502 -0
  147. package/.claude/skills/portfolio-manager/references/diversification-principles.md +553 -0
  148. package/.claude/skills/portfolio-manager/references/portfolio-risk-metrics.md +603 -0
  149. package/.claude/skills/portfolio-manager/references/position-evaluation.md +477 -0
  150. package/.claude/skills/portfolio-manager/references/rebalancing-strategies.md +715 -0
  151. package/.claude/skills/portfolio-manager/references/risk-profile-questionnaire.md +608 -0
  152. package/.claude/skills/portfolio-manager/references/target-allocations.md +558 -0
  153. package/.claude/skills/portfolio-manager/scripts/test_alpaca_connection.py +286 -0
  154. package/.claude/skills/scenario-analyzer/SKILL.md +317 -0
  155. package/.claude/skills/scenario-analyzer/references/headline_event_patterns.md +264 -0
  156. package/.claude/skills/scenario-analyzer/references/scenario_playbooks.md +320 -0
  157. package/.claude/skills/scenario-analyzer/references/sector_sensitivity_matrix.md +217 -0
  158. package/.claude/skills/sector-analyst/SKILL.md +206 -0
  159. package/.claude/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  160. package/.claude/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  161. package/.claude/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  162. package/.claude/skills/sector-analyst/references/sector_rotation.md +170 -0
  163. package/.claude/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  164. package/.claude/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  165. package/.claude/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  166. package/.claude/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  167. package/.claude/skills/stock/NOTION_SETUP.md +33 -0
  168. package/.claude/skills/stock/SKILL.md +38 -0
  169. package/.claude/skills/technical-analyst/SKILL.md +238 -0
  170. package/.claude/skills/technical-analyst/assets/analysis_template.md +183 -0
  171. package/.claude/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  172. package/.claude/skills/theme-detector/SKILL.md +320 -0
  173. package/.claude/skills/theme-detector/assets/report_template.md +155 -0
  174. package/.claude/skills/theme-detector/references/cross_sector_themes.md +252 -0
  175. package/.claude/skills/theme-detector/references/finviz_industry_codes.md +403 -0
  176. package/.claude/skills/theme-detector/references/thematic_etf_catalog.md +333 -0
  177. package/.claude/skills/theme-detector/references/theme_detection_methodology.md +430 -0
  178. package/.claude/skills/theme-detector/scripts/calculators/__init__.py +1 -0
  179. package/.claude/skills/theme-detector/scripts/calculators/heat_calculator.py +123 -0
  180. package/.claude/skills/theme-detector/scripts/calculators/industry_ranker.py +98 -0
  181. package/.claude/skills/theme-detector/scripts/calculators/lifecycle_calculator.py +172 -0
  182. package/.claude/skills/theme-detector/scripts/calculators/theme_classifier.py +195 -0
  183. package/.claude/skills/theme-detector/scripts/calculators/theme_discoverer.py +280 -0
  184. package/.claude/skills/theme-detector/scripts/config_loader.py +142 -0
  185. package/.claude/skills/theme-detector/scripts/default_theme_config.py +254 -0
  186. package/.claude/skills/theme-detector/scripts/etf_scanner.py +609 -0
  187. package/.claude/skills/theme-detector/scripts/finviz_performance_client.py +131 -0
  188. package/.claude/skills/theme-detector/scripts/report_generator.py +490 -0
  189. package/.claude/skills/theme-detector/scripts/representative_stock_selector.py +673 -0
  190. package/.claude/skills/theme-detector/scripts/scorer.py +87 -0
  191. package/.claude/skills/theme-detector/scripts/tests/README.md +21 -0
  192. package/.claude/skills/theme-detector/scripts/tests/conftest.py +9 -0
  193. package/.claude/skills/theme-detector/scripts/tests/test_config_loader.py +239 -0
  194. package/.claude/skills/theme-detector/scripts/tests/test_etf_scanner.py +810 -0
  195. package/.claude/skills/theme-detector/scripts/tests/test_heat_calculator.py +245 -0
  196. package/.claude/skills/theme-detector/scripts/tests/test_industry_ranker.py +256 -0
  197. package/.claude/skills/theme-detector/scripts/tests/test_lifecycle_calculator.py +301 -0
  198. package/.claude/skills/theme-detector/scripts/tests/test_report_generator.py +624 -0
  199. package/.claude/skills/theme-detector/scripts/tests/test_representative_stock_selector.py +898 -0
  200. package/.claude/skills/theme-detector/scripts/tests/test_scorer.py +185 -0
  201. package/.claude/skills/theme-detector/scripts/tests/test_theme_classifier.py +534 -0
  202. package/.claude/skills/theme-detector/scripts/tests/test_theme_detector_e2e.py +467 -0
  203. package/.claude/skills/theme-detector/scripts/tests/test_theme_discoverer.py +458 -0
  204. package/.claude/skills/theme-detector/scripts/tests/test_uptrend_client.py +76 -0
  205. package/.claude/skills/theme-detector/scripts/theme_detector.py +815 -0
  206. package/.claude/skills/theme-detector/scripts/themes.yaml +168 -0
  207. package/.claude/skills/theme-detector/scripts/uptrend_client.py +241 -0
  208. package/.claude/skills/uptrend-analyzer/SKILL.md +108 -0
  209. package/.claude/skills/uptrend-analyzer/references/uptrend_methodology.md +215 -0
  210. package/.claude/skills/uptrend-analyzer/scripts/calculators/__init__.py +1 -0
  211. package/.claude/skills/uptrend-analyzer/scripts/calculators/historical_context_calculator.py +122 -0
  212. package/.claude/skills/uptrend-analyzer/scripts/calculators/market_breadth_calculator.py +145 -0
  213. package/.claude/skills/uptrend-analyzer/scripts/calculators/momentum_calculator.py +183 -0
  214. package/.claude/skills/uptrend-analyzer/scripts/calculators/sector_participation_calculator.py +204 -0
  215. package/.claude/skills/uptrend-analyzer/scripts/calculators/sector_rotation_calculator.py +218 -0
  216. package/.claude/skills/uptrend-analyzer/scripts/data_fetcher.py +236 -0
  217. package/.claude/skills/uptrend-analyzer/scripts/report_generator.py +329 -0
  218. package/.claude/skills/uptrend-analyzer/scripts/scorer.py +276 -0
  219. package/.claude/skills/uptrend-analyzer/scripts/uptrend_analyzer.py +219 -0
  220. package/.claude/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  221. package/.claude/skills/us-market-bubble-detector/SKILL.md +545 -0
  222. package/.claude/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  223. package/.claude/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  224. package/.claude/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  225. package/.claude/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  226. package/.claude/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  227. package/.claude/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  228. package/.claude/skills/us-stock-analysis/SKILL.md +294 -0
  229. package/.claude/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  230. package/.claude/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  231. package/.claude/skills/us-stock-analysis/references/report-template.md +207 -0
  232. package/.claude/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  233. package/.claude/skills/value-dividend-screener/SKILL.md +562 -0
  234. package/.claude/skills/value-dividend-screener/references/fmp_api_guide.md +348 -0
  235. package/.claude/skills/value-dividend-screener/references/screening_methodology.md +315 -0
  236. package/.claude/skills/value-dividend-screener/scripts/screen_dividend_stocks.py +1138 -0
  237. package/.claude/skills/vcp-screener/SKILL.md +79 -0
  238. package/.claude/skills/vcp-screener/references/fmp_api_endpoints.md +45 -0
  239. package/.claude/skills/vcp-screener/references/scoring_system.md +154 -0
  240. package/.claude/skills/vcp-screener/references/vcp_methodology.md +124 -0
  241. package/.claude/skills/vcp-screener/scripts/calculators/__init__.py +1 -0
  242. package/.claude/skills/vcp-screener/scripts/calculators/pivot_proximity_calculator.py +139 -0
  243. package/.claude/skills/vcp-screener/scripts/calculators/relative_strength_calculator.py +161 -0
  244. package/.claude/skills/vcp-screener/scripts/calculators/trend_template_calculator.py +228 -0
  245. package/.claude/skills/vcp-screener/scripts/calculators/vcp_pattern_calculator.py +322 -0
  246. package/.claude/skills/vcp-screener/scripts/calculators/volume_pattern_calculator.py +121 -0
  247. package/.claude/skills/vcp-screener/scripts/fmp_client.py +162 -0
  248. package/.claude/skills/vcp-screener/scripts/report_generator.py +317 -0
  249. package/.claude/skills/vcp-screener/scripts/scorer.py +155 -0
  250. package/.claude/skills/vcp-screener/scripts/screen_vcp.py +536 -0
  251. package/.claude/skills/vcp-screener/scripts/tests/__init__.py +0 -0
  252. package/.claude/skills/vcp-screener/scripts/tests/conftest.py +9 -0
  253. package/.claude/skills/vcp-screener/scripts/tests/test_vcp_screener.py +834 -0
  254. package/.claude/skills/weekly-trade-strategy/.claude/agents/druckenmiller-strategy-planner.md +300 -0
  255. package/.claude/skills/weekly-trade-strategy/.claude/agents/market-news-analyzer.md +239 -0
  256. package/.claude/skills/weekly-trade-strategy/.claude/agents/technical-market-analyst.md +187 -0
  257. package/.claude/skills/weekly-trade-strategy/.claude/agents/us-market-analyst.md +218 -0
  258. package/.claude/skills/weekly-trade-strategy/.claude/agents/weekly-trade-blog-writer.md +318 -0
  259. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/SKILL.md +662 -0
  260. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  261. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  262. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  263. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  264. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/SKILL.md +721 -0
  265. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  266. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/earnings_calendar_2025-11-02.md +447 -0
  267. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  268. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  269. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/scripts/generate_report.py +366 -0
  270. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/SKILL.md +365 -0
  271. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  272. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  273. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/SKILL.md +139 -0
  274. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  275. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/references/indicators.md +99 -0
  276. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  277. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/SKILL.md +714 -0
  278. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  279. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  280. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  281. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  282. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/SKILL.md +206 -0
  283. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  284. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  285. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  286. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/references/sector_rotation.md +170 -0
  287. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  288. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  289. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  290. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  291. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/SKILL.md +238 -0
  292. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/assets/analysis_template.md +183 -0
  293. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  294. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  295. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/SKILL.md +545 -0
  296. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  297. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  298. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  299. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  300. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  301. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  302. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/SKILL.md +294 -0
  303. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  304. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  305. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/report-template.md +207 -0
  306. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  307. package/.claude/skills/weekly-trade-strategy/CLAUDE.md +454 -0
  308. package/.claude/skills/weekly-trade-strategy/README.md +287 -0
  309. package/.claude/skills/weekly-trade-strategy/blogs/.gitkeep +0 -0
  310. package/.claude/skills/weekly-trade-strategy/charts/.gitkeep +0 -0
  311. package/.claude/skills/weekly-trade-strategy/earnings_data.json +10054 -0
  312. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/SKILL.md +662 -0
  313. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  314. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  315. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  316. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  317. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/SKILL.md +721 -0
  318. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  319. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/earnings_calendar_2025-11-02.md +447 -0
  320. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  321. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  322. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/scripts/generate_report.py +366 -0
  323. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/SKILL.md +365 -0
  324. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  325. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  326. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/SKILL.md +139 -0
  327. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  328. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/references/indicators.md +99 -0
  329. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  330. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/SKILL.md +714 -0
  331. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  332. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  333. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  334. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  335. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/SKILL.md +206 -0
  336. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  337. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  338. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  339. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/references/sector_rotation.md +170 -0
  340. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  341. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  342. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  343. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  344. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/SKILL.md +238 -0
  345. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/assets/analysis_template.md +183 -0
  346. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  347. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  348. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/SKILL.md +545 -0
  349. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  350. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  351. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  352. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  353. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  354. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  355. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/SKILL.md +294 -0
  356. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  357. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  358. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/report-template.md +207 -0
  359. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  360. package/.mcp.json +3 -0
  361. package/cli.mjs +16 -16
  362. package/package.json +4 -2
@@ -0,0 +1,499 @@
1
+ # Geopolitical Events and Commodity Correlations
2
+
3
+ ## Energy Commodities
4
+
5
+ ### Crude Oil (WTI / Brent)
6
+
7
+ **Middle East Conflicts:**
8
+
9
+ **Supply Disruption Risk:**
10
+ - Strait of Hormuz tensions: ~20% of global oil supply passes through
11
+ - Iran tensions: Oil +5-15% immediately
12
+ - Historical: 2019 Saudi Aramco attacks: Oil +15% in single day
13
+ - Saudi Arabia/UAE production: ~15% of global supply
14
+ - Instability: Oil rallies sharply
15
+ - Iraq/Libya disruptions: Regional conflicts impact production
16
+ - Libya civil war: Removed 1M+ barrels/day periodically
17
+
18
+ **Israel-Palestine Conflicts:**
19
+ - Direct impact minimal (neither major producer)
20
+ - Indirect via regional escalation concerns
21
+ - Safe-haven bid for oil typically +2-5%
22
+
23
+ **Iranian Tensions:**
24
+ - Nuclear program concerns
25
+ - Sanctions/sanctions relief
26
+ - Sanctions: Removes ~1-2M barrels/day, oil +10-20%
27
+ - Sanctions relief: Adds supply, oil -10-15%
28
+ - Proxy conflicts (Yemen, Syria, Lebanon)
29
+
30
+ **Russia-Ukraine Conflict:**
31
+
32
+ **Natural Gas:**
33
+ - European dependence on Russian gas (~40% pre-conflict)
34
+ - Nord Stream disruptions: Natural gas prices +300-400% (2022)
35
+ - Coal as alternative: Thermal coal rallied strongly
36
+ - LNG exports from US/Qatar beneficiaries
37
+
38
+ **Crude Oil:**
39
+ - Russia ~10% of global supply
40
+ - Sanctions impact: Removed ~1M barrels/day from market
41
+ - Oil price: +40% in initial months (2022)
42
+ - Urals discount to Brent widened to $30-40/barrel
43
+
44
+ **Petroleum Products:**
45
+ - Diesel shortages in Europe (Russia major supplier)
46
+ - Gasoline prices globally impacted
47
+
48
+ **US-China Tensions:**
49
+
50
+ **Energy Demand Implications:**
51
+ - Trade war: Chinese growth slowdown concerns, oil -5-10%
52
+ - Taiwan tensions: Regional instability premium, oil +3-7%
53
+ - Technology restrictions: Minimal direct impact on oil
54
+
55
+ **US-Iran Relations:**
56
+ - Sanctions enforcement cycles
57
+ - Oil supply ~1-2M barrels/day swing factor
58
+ - Price impact: ±10-15% depending on direction
59
+
60
+ **Venezuela Political Crisis:**
61
+ - Production collapsed from ~3M to ~0.7M barrels/day
62
+ - Sanctions impact
63
+ - Regime change prospects: Oil price sensitive to potential supply return
64
+
65
+ ### Natural Gas
66
+
67
+ **European Energy Crisis (Russia-Ukraine):**
68
+ - As detailed above, massive impact
69
+ - Coal-to-gas switching reversed
70
+ - Renewables acceleration
71
+
72
+ **US Production Growth:**
73
+ - Shale revolution reduced geopolitical sensitivity
74
+ - LNG export capacity growth
75
+ - Winter weather events still create volatility
76
+
77
+ **Asian LNG Markets:**
78
+ - Japan/South Korea/China major importers
79
+ - Competition for LNG cargoes during crises
80
+ - Price spikes in supply disruptions
81
+
82
+ ### Coal
83
+
84
+ **Russia-Ukraine Conflict:**
85
+ - Russian coal sanctions
86
+ - European utilities switching gas-to-coal
87
+ - Thermal coal prices +200% (2022)
88
+
89
+ **China-Australia Trade Tensions:**
90
+ - Informal coal import ban (2020-2021)
91
+ - China shifted to Indonesian/Russian coal
92
+ - Australian coal exporters found alternative buyers
93
+ - Metallurgical coal (steel-making) less impacted
94
+
95
+ **Climate Policy:**
96
+ - Long-term decline narrative
97
+ - Short-term supply tightness from underinvestment
98
+
99
+ ## Precious Metals
100
+
101
+ ### Gold
102
+
103
+ **Geopolitical Risk Premium:**
104
+
105
+ **General Pattern:**
106
+ - Conflicts/crises: Gold +2-10% immediate rally
107
+ - Safe-haven flows dominate
108
+ - Negative real rates amplify gains
109
+
110
+ **Specific Events:**
111
+
112
+ **Russia-Ukraine Conflict:**
113
+ - Gold rallied from $1,800 to $2,070 (March 2022)
114
+ - Central bank buying increased (dedollarization theme)
115
+ - Physical demand surge
116
+
117
+ **Middle East Escalations:**
118
+ - Historical: Iraq War (2003): Gold +7%
119
+ - Syria conflicts: Moderate impact (+2-4%)
120
+ - Recent Israel-Gaza: Gold +5-8%
121
+
122
+ **US-China Tensions:**
123
+ - Gradual safe-haven bid
124
+ - Central bank reserve diversification (China buying gold)
125
+ - Currency war implications
126
+
127
+ **Banking Crises:**
128
+ - 2008: Gold rallied during acute stress
129
+ - 2023 regional bank failures: Gold +10% in weeks
130
+ - Trust in fiat currency undermined
131
+
132
+ **Currency Debasement Concerns:**
133
+ - Massive fiscal deficits
134
+ - QE programs
135
+ - Inflation hedging demand
136
+
137
+ **Interest Rate Interaction:**
138
+ - Geopolitical premium can override rate headwinds
139
+ - Real rates still primary driver long-term
140
+ - Risk-off overrides opportunity cost considerations short-term
141
+
142
+ ### Silver
143
+
144
+ **Industrial Demand Component:**
145
+ - 50% industrial use (solar, electronics, EVs)
146
+ - Economic slowdown from geopolitics: Negative
147
+ - Green energy push: Positive
148
+
149
+ **Gold Correlation:**
150
+ - Trades with gold during risk-off (0.7-0.8 correlation)
151
+ - Amplified moves (higher beta to gold)
152
+
153
+ **Russia-Ukraine Example:**
154
+ - Industrial recession fears limited silver gains vs gold
155
+ - Gold/Silver ratio widened (gold outperformed)
156
+
157
+ ### Platinum/Palladium
158
+
159
+ **Russian Supply Dominance:**
160
+ - Russia ~40% of palladium supply
161
+ - ~10% of platinum supply
162
+ - Sanctions concerns: Prices spiked 2022
163
+
164
+ **Automotive Demand:**
165
+ - Catalytic converters
166
+ - EV transition threat long-term
167
+ - Recession fears negative
168
+
169
+ **South African Supply Risks:**
170
+ - Political instability
171
+ - Power shortages (load-shedding)
172
+ - Mining strikes frequent
173
+
174
+ ## Base Metals
175
+
176
+ ### Copper
177
+
178
+ **"Dr. Copper" - Economic Barometer:**
179
+
180
+ **China Demand (50% of global):**
181
+ - China-US trade war: Copper -20% (2018-2019)
182
+ - China stimulus: Copper rallies sharply
183
+ - Property sector troubles: Negative (major copper consumer)
184
+ - Infrastructure spending: Positive
185
+
186
+ **Chilean Supply (25% of global):**
187
+ - Political instability (2019 protests): Copper +5%
188
+ - Mining strikes: Immediate price spikes
189
+ - Environmental restrictions: Long-term supply concerns
190
+ - Water scarcity issues
191
+
192
+ **Peruvian Supply (10% of global):**
193
+ - Political instability frequent
194
+ - Community protests at mines
195
+ - Supply disruptions: Price supportive
196
+
197
+ **Zambia/DRC (African Copper Belt):**
198
+ - Political risk elevated
199
+ - Infrastructure challenges
200
+ - Chinese investment dominance
201
+
202
+ **Energy Transition Demand:**
203
+ - EVs use 4x copper vs ICE vehicles
204
+ - Grid infrastructure buildout
205
+ - Long-term bullish narrative
206
+
207
+ **Geopolitical Implications:**
208
+ - US-China tech war: Copper demand impact (semiconductors, data centers)
209
+ - Green energy policies: Demand support
210
+ - Recession fears: Demand destruction
211
+
212
+ ### Aluminum
213
+
214
+ **China Production Dominance (60%):**
215
+ - Energy-intensive production
216
+ - Power shortages: Production curtailments, price spikes
217
+ - Environmental regulations: Supply constraints
218
+
219
+ **Russia Supply (~6%):**
220
+ - Sanctions concerns (Ukraine war)
221
+ - Aluminum rallied 2022
222
+ - European smelters curtailed (high energy costs)
223
+
224
+ **Guinea Bauxite (Major Supplier):**
225
+ - Political instability (2021 coup)
226
+ - Supply concerns for aluminum feedstock
227
+
228
+ **Applications:**
229
+ - Aerospace (geopolitical tensions affect demand)
230
+ - Automotive (EVs increasing content)
231
+ - Construction (economic growth sensitive)
232
+
233
+ ### Nickel
234
+
235
+ **Indonesia Supply Dominance (Growing):**
236
+ - Ore export ban (2020): Reshuffled global supply chains
237
+ - Chinese investment in Indonesian processing
238
+ - Environmental concerns
239
+
240
+ **Russia Supply (~10%):**
241
+ - Sanctions risk (Ukraine war)
242
+ - Nickel short squeeze (LME chaos, March 2022): +250% in days
243
+ - Tsingshan vs LME positions
244
+
245
+ **Philippines Supply:**
246
+ - Environmental regulations
247
+ - Mining permit uncertainties
248
+ - Typhoon disruptions
249
+
250
+ **EV Battery Demand:**
251
+ - Nickel-rich cathodes (NMC, NCA)
252
+ - Competition with iron-phosphate (LFP) batteries
253
+ - Indonesia-China battery supply chain
254
+
255
+ ### Zinc
256
+
257
+ **China Production/Consumption (~40%):**
258
+ - Galvanizing steel (construction, auto)
259
+ - Smelter margins squeeze when energy costs high
260
+ - Production cuts when unprofitable
261
+
262
+ **Peru/Australia Supply:**
263
+ - Mining disruptions
264
+ - Concentrate availability
265
+
266
+ **Russia Supply (~5%):**
267
+ - Sanctions impact moderate
268
+
269
+ ## Agricultural Commodities
270
+
271
+ ### Wheat
272
+
273
+ **Russia-Ukraine (30% of Global Exports):**
274
+ - Black Sea export disruptions
275
+ - Ukraine ports blockaded (2022): Wheat +50%
276
+ - Russia export restrictions/export tax adjustments
277
+ - Grain deal negotiations critical
278
+
279
+ **Weather Events:**
280
+ - Droughts in major producers (US Plains, Australia, Argentina)
281
+ - Floods in harvest seasons
282
+ - Climate change increasing volatility
283
+
284
+ **India Export Bans:**
285
+ - Domestic food security priorities
286
+ - Heat waves trigger export restrictions
287
+ - Sudden policy changes create price spikes
288
+
289
+ **North Africa/Middle East Importers:**
290
+ - Political instability when bread prices spike
291
+ - Arab Spring correlation with wheat prices
292
+ - Food security national security issue
293
+
294
+ ### Corn
295
+
296
+ **US Production Dominance (35% of Global):**
297
+ - Weather in Midwest (drought/floods)
298
+ - USDA crop reports market-moving
299
+
300
+ **Brazil/Argentina (Major Exporters):**
301
+ - Weather patterns (La Niña impacts)
302
+ - Currency fluctuations affect export competitiveness
303
+ - Infrastructure challenges (Brazil transport)
304
+
305
+ **China Demand:**
306
+ - Livestock feed demand
307
+ - Trade deal purchase commitments
308
+ - ASF (African Swine Fever) impacts herd sizes
309
+
310
+ **Ukraine Supply Disruptions:**
311
+ - Corn exports halted during war
312
+ - Black Sea logistics
313
+
314
+ **Ethanol Demand:**
315
+ - US biofuel mandates
316
+ - Energy prices correlation
317
+
318
+ ### Soybeans
319
+
320
+ **Brazil-China Trade:**
321
+ - China imports 60% of global soybeans
322
+ - US-China trade war: Brazil beneficiary
323
+ - Brazil overtook US as top exporter
324
+
325
+ **Argentina Processing:**
326
+ - Crushing industry
327
+ - Export taxes policy changes
328
+
329
+ **Weather Risks:**
330
+ - Brazil (drought in key states)
331
+ - Argentina (La Niña flooding/drought cycles)
332
+ - US Midwest (flash droughts)
333
+
334
+ **China Demand Drivers:**
335
+ - Livestock feed (pig herd cycles)
336
+ - African Swine Fever devastation (2019): Demand collapsed
337
+ - Herd rebuilding: Demand recovery
338
+
339
+ **Geopolitical Leverage:**
340
+ - US-China trade tool
341
+ - Brazil-China relationship benefits
342
+
343
+ ## Rare Earth Elements / Critical Minerals
344
+
345
+ ### Rare Earths
346
+
347
+ **China Dominance (60% Production, 90% Processing):**
348
+ - Export restrictions as geopolitical tool
349
+ - US-China tensions: Supply security concerns
350
+ - Price manipulation capability
351
+
352
+ **Applications:**
353
+ - Defense systems (missiles, jets)
354
+ - EVs (motors)
355
+ - Wind turbines
356
+ - Electronics
357
+
358
+ **Alternative Supply Development:**
359
+ - US (Mountain Pass mine)
360
+ - Australia (Lynas)
361
+ - Processing capacity bottleneck
362
+
363
+ **Historical Example:**
364
+ - 2010 China-Japan dispute: China restricted exports, prices surged
365
+
366
+ ### Lithium
367
+
368
+ **EV Battery Critical Component:**
369
+
370
+ **Australia/Chile Supply (~75%):**
371
+ - Australia: Spodumene (hard rock)
372
+ - Chile: Brine deposits (Atacama)
373
+ - Political risks moderate
374
+
375
+ **China Processing Dominance (~60%):**
376
+ - Refining bottleneck
377
+ - US/Europe scrambling to build capacity
378
+
379
+ **Argentina "Lithium Triangle":**
380
+ - Chile-Argentina-Bolivia
381
+ - Nationalization risks
382
+ - Water usage controversies
383
+
384
+ **Price Volatility:**
385
+ - 2022: +400% on EV demand surge
386
+ - 2023: -70% on overcapacity concerns
387
+ - Geopolitical diversification premium
388
+
389
+ ### Cobalt
390
+
391
+ **DRC Production (70% of Global):**
392
+ - Political instability
393
+ - Child labor controversies
394
+ - Chinese control of mines
395
+
396
+ **Battery Chemistry Shift:**
397
+ - Reducing cobalt content (ethical concerns, cost)
398
+ - Cobalt-free batteries development
399
+
400
+ **Sanctions/Ethical Sourcing:**
401
+ - Supply chain scrutiny
402
+ - Price premium for certified ethical cobalt
403
+
404
+ ## Regional Geopolitical Frameworks
405
+
406
+ ### Middle East
407
+
408
+ **Oil Price Transmission:**
409
+ - Conflicts → Oil ↑ → Inflation ↑ → Rate hikes → Equities ↓
410
+ - Energy stocks benefit
411
+ - Emerging markets pressured (oil importers)
412
+
413
+ **Safe Haven Flows:**
414
+ - Gold, USD, JPY, CHF rally
415
+ - Equities decline (especially European, EM)
416
+
417
+ **Shipping Disruptions:**
418
+ - Suez Canal (10% of global trade)
419
+ - Strait of Hormuz (oil)
420
+ - Red Sea shipping costs
421
+
422
+ ### Russia-Europe Energy
423
+
424
+ **Natural Gas Dependency:**
425
+ - Europe vulnerable
426
+ - Russia leverage
427
+ - Coal, LNG, nuclear substitutes
428
+
429
+ **Sanctions Effectiveness:**
430
+ - Energy payments carve-outs complicated
431
+ - Oil price caps
432
+ - Gray market/smuggling
433
+
434
+ ### Asia-Pacific
435
+
436
+ **Taiwan Strait Tensions:**
437
+ - Semiconductor supply chain choke point
438
+ - Shipping disruptions (South China Sea)
439
+ - Technology stocks highly sensitive
440
+ - Safe-haven flows massive if conflict
441
+
442
+ **South China Sea:**
443
+ - Shipping lanes (1/3 of global trade)
444
+ - Energy deposits disputes
445
+
446
+ ### Latin America
447
+
448
+ **Commodity Exporters:**
449
+ - Political shifts affect mining/energy policy
450
+ - Nationalization risks
451
+ - Currency volatility amplifies commodity moves
452
+
453
+ **Examples:**
454
+ - Peru mining conflicts
455
+ - Chile constitutional changes (mining tax debates)
456
+ - Brazil Amazon policies (agricultural land)
457
+ - Argentina capital controls, export taxes
458
+
459
+ ## Correlation Summary Table
460
+
461
+ | Geopolitical Event Type | Oil | Gold | Copper | Wheat | USD | Equities |
462
+ |------------------------|-----|------|--------|-------|-----|----------|
463
+ | Middle East War | ↑↑ | ↑↑ | ↓ | ↑ | ↑ | ↓↓ |
464
+ | Russia-Ukraine | ↑↑ | ↑↑ | ↓ | ↑↑ | ↑ | ↓↓ |
465
+ | US-China Trade War | ↓ | ↑ | ↓↓ | ↔ | ↑ | ↓ |
466
+ | Taiwan Conflict | ↑ | ↑↑ | ↓↓ | ↑ | ↑↑ | ↓↓↓ |
467
+ | Emerging Market Crisis | ↓ | ↑ | ↓↓ | ↔ | ↑↑ | ↓↓ |
468
+ | Banking Crisis | ↓↓ | ↑↑ | ↓↓ | ↓ | ↑ | ↓↓↓ |
469
+
470
+ **Legend:**
471
+ - ↑↑↑ = Very strong positive
472
+ - ↑↑ = Strong positive
473
+ - ↑ = Moderate positive
474
+ - ↔ = Neutral/mixed
475
+ - ↓ = Moderate negative
476
+ - ↓↓ = Strong negative
477
+ - ↓↓↓ = Very strong negative
478
+
479
+ ## Time Horizon Considerations
480
+
481
+ **Immediate (Days):**
482
+ - Risk-off knee-jerk reactions
483
+ - Safe haven flows
484
+ - Energy spikes if supply threatened
485
+
486
+ **Short-term (Weeks-Months):**
487
+ - Reality check vs initial fears
488
+ - Supply chain actual disruptions materialize
489
+ - Central bank/government responses
490
+
491
+ **Medium-term (Months-Year):**
492
+ - Economic impact transmission
493
+ - Inflation effects through commodity channel
494
+ - Policy adjustments (strategic reserves, alternative suppliers)
495
+
496
+ **Long-term (Years):**
497
+ - Supply chain restructuring
498
+ - Energy transition acceleration
499
+ - Reserve currency implications