market-data-analyzer 2.1.0 → 2.1.1

package/src/tools/analyze_portfolio.ts

@@ -1,207 +0,0 @@
-/**
- * analyze_portfolio -- Portfolio analytics with live prices.
- *
- * Takes an array of { symbol, shares, avg_cost } holdings, fetches
- * current prices from Yahoo Finance, and returns P&L, allocation,
- * diversification score, and risk metrics.
- */
-
-import { yahooQuote, SYMBOL_SECTORS } from "../utils/api.js";
-import { formatCurrency } from "../utils/math.js";
-
-export interface PortfolioHolding {
-  symbol: string;
-  shares: number;
-  avg_cost: number;
-}
-
-interface PositionResult {
-  symbol: string;
-  name: string;
-  shares: number;
-  avgCost: number;
-  currentPrice: number;
-  marketValue: number;
-  costBasis: number;
-  pnl: number;
-  pnlPercent: number;
-  allocationPercent: number;
-  sector: string;
-}
-
-export async function handleAnalyzePortfolio(
-  holdings: PortfolioHolding[],
-): Promise<string> {
-  if (holdings.length === 0) {
-    throw new Error("At least one holding is required.");
-  }
-
-  // Fetch live quotes for all symbols
-  const symbols = holdings.map((h) => h.symbol);
-  const quotes = await yahooQuote(symbols);
-  const quoteMap = new Map(quotes.map((q) => [q.symbol, q]));
-
-  // Build position analysis
-  let totalValue = 0;
-  let totalCost = 0;
-
-  const positions: PositionResult[] = holdings.map((h) => {
-    const q = quoteMap.get(h.symbol);
-    const currentPrice = q?.regularMarketPrice ?? 0;
-    const marketValue = h.shares * currentPrice;
-    const costBasis = h.shares * h.avg_cost;
-    totalValue += marketValue;
-    totalCost += costBasis;
-
-    return {
-      symbol: h.symbol,
-      name: q?.shortName ?? q?.longName ?? h.symbol,
-      shares: h.shares,
-      avgCost: h.avg_cost,
-      currentPrice,
-      marketValue,
-      costBasis,
-      pnl: marketValue - costBasis,
-      pnlPercent: costBasis > 0 ? ((marketValue - costBasis) / costBasis) * 100 : 0,
-      allocationPercent: 0, // calculated below
-      sector: q?.sector ?? SYMBOL_SECTORS[h.symbol]?.sector ?? "Unknown",
-    };
-  });
-
-  // Calculate allocation percentages
-  for (const p of positions) {
-    p.allocationPercent = totalValue > 0 ? (p.marketValue / totalValue) * 100 : 0;
-  }
-
-  // Sort by market value descending
-  positions.sort((a, b) => b.marketValue - a.marketValue);
-
-  // Sector breakdown
-  const sectorAlloc: Record<string, number> = {};
-  for (const p of positions) {
-    sectorAlloc[p.sector] = (sectorAlloc[p.sector] ?? 0) + p.allocationPercent;
-  }
-
-  // Diversification score (HHI-based, 0-100 where 100 = perfectly diversified)
-  const weights = positions.map((p) => p.allocationPercent / 100);
-  const hhi = weights.reduce((s, w) => s + w * w, 0);
-  const n = weights.length;
-  const minHHI = n > 0 ? 1 / n : 1;
-  const denom = 1 - minHHI;
-  const divScore = n <= 1 || denom === 0 || totalValue === 0
-    ? 0
-    : Math.max(0, Math.min(100, Math.round((1 - (hhi - minHHI) / denom) * 100)));
-
-  // Risk warnings
-  const warnings: string[] = [];
-
-  for (const p of positions) {
-    if (p.allocationPercent > 30) {
-      warnings.push(`HIGH CONCENTRATION: ${p.symbol} is ${p.allocationPercent.toFixed(1)}% of portfolio.`);
-    }
-  }
-
-  for (const [sector, pct] of Object.entries(sectorAlloc)) {
-    if (pct > 50) {
-      warnings.push(`SECTOR RISK: ${sector} represents ${pct.toFixed(1)}% of portfolio.`);
-    }
-  }
-
-  for (const p of positions) {
-    if (p.pnlPercent < -20) {
-      warnings.push(`SIGNIFICANT LOSS: ${p.symbol} is down ${Math.abs(p.pnlPercent).toFixed(1)}%.`);
-    }
-  }
-
-  if (n < 5) {
-    warnings.push(`LOW DIVERSIFICATION: Only ${n} position(s). Consider adding more holdings.`);
-  }
-
-  if (Object.keys(sectorAlloc).length < 3 && n >= 3) {
-    warnings.push("LIMITED SECTOR EXPOSURE: Portfolio spans fewer than 3 sectors.");
-  }
-
-  // Any positions where we couldn't fetch a price?
-  const missingPrices = positions.filter((p) => p.currentPrice === 0);
-  for (const p of missingPrices) {
-    warnings.push(`MISSING DATA: Could not fetch price for ${p.symbol}. Values may be inaccurate.`);
-  }
-
-  // Format output
-  const lines: string[] = [];
-
-  lines.push("# Portfolio Analysis");
-  lines.push("");
-
-  // Summary
-  lines.push("## Summary");
-  lines.push("");
-  lines.push("| Metric | Value |");
-  lines.push("|--------|-------|");
-  lines.push(`| Total Value | ${formatCurrency(totalValue)} |`);
-  lines.push(`| Total Cost Basis | ${formatCurrency(totalCost)} |`);
-  const totalPnl = totalValue - totalCost;
-  const totalPnlPct = totalCost > 0 ? ((totalPnl) / totalCost) * 100 : 0;
-  lines.push(`| Total P&L | ${totalPnl >= 0 ? "+" : ""}${formatCurrency(totalPnl)} (${totalPnlPct >= 0 ? "+" : ""}${totalPnlPct.toFixed(2)}%) |`);
-  lines.push(`| Positions | ${n} |`);
-  lines.push(`| Sectors | ${Object.keys(sectorAlloc).length} |`);
-  lines.push(`| Diversification Score | ${divScore}/100 |`);
-  lines.push("");
-
-  // Positions
-  lines.push("## Positions");
-  lines.push("");
-  lines.push("| Symbol | Name | Shares | Avg Cost | Price | Value | P&L | P&L% | Alloc% |");
-  lines.push("|--------|------|--------|----------|-------|-------|-----|------|--------|");
-
-  for (const p of positions) {
-    const pnlSign = p.pnl >= 0 ? "+" : "";
-    lines.push(
-      `| ${p.symbol} | ${p.name.slice(0, 20)} | ${p.shares} | $${p.avgCost.toFixed(2)} | $${p.currentPrice.toFixed(2)} | ${formatCurrency(p.marketValue)} | ${pnlSign}${formatCurrency(p.pnl)} | ${pnlSign}${p.pnlPercent.toFixed(2)}% | ${p.allocationPercent.toFixed(1)}% |`,
-    );
-  }
-  lines.push("");
-
-  // Sector allocation
-  lines.push("## Sector Allocation");
-  lines.push("");
-  lines.push("| Sector | Allocation |");
-  lines.push("|--------|------------|");
-  const sortedSectors = Object.entries(sectorAlloc).sort((a, b) => b[1] - a[1]);
-  for (const [sector, pct] of sortedSectors) {
-    const bar = "=".repeat(Math.round(pct / 2));
-    lines.push(`| ${sector} | ${pct.toFixed(1)}% ${bar} |`);
-  }
-  lines.push("");
-
-  // Winners and losers
-  const winners = [...positions].sort((a, b) => b.pnlPercent - a.pnlPercent);
-  if (winners.length > 0) {
-    lines.push("## Top Performers");
-    lines.push("");
-    const top3 = winners.slice(0, Math.min(3, winners.length));
-    for (const p of top3) {
-      lines.push(`- **${p.symbol}**: ${p.pnlPercent >= 0 ? "+" : ""}${p.pnlPercent.toFixed(2)}% (${p.pnl >= 0 ? "+" : ""}${formatCurrency(p.pnl)})`);
-    }
-    lines.push("");
-    const bottom3 = winners.slice(-Math.min(3, winners.length)).reverse();
-    lines.push("## Underperformers");
-    lines.push("");
-    for (const p of bottom3) {
-      lines.push(`- **${p.symbol}**: ${p.pnlPercent >= 0 ? "+" : ""}${p.pnlPercent.toFixed(2)}% (${p.pnl >= 0 ? "+" : ""}${formatCurrency(p.pnl)})`);
-    }
-    lines.push("");
-  }
-
-  // Risk warnings
-  if (warnings.length > 0) {
-    lines.push("## Risk Warnings");
-    lines.push("");
-    for (const w of warnings) {
-      lines.push(`- ${w}`);
-    }
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}

package/src/tools/analyze_stock.ts

@@ -1,204 +0,0 @@
-/**
- * analyze_stock -- Deep analysis of a stock symbol.
- *
- * Fetches live data from Yahoo Finance, computes SMA 20/50/200, RSI,
- * MACD, and support/resistance levels.
- */
-
-import { yahooQuote, yahooChart } from "../utils/api.js";
-import {
-  sma,
-  rsi,
-  macd,
-  lastValue,
-  findSupportResistance,
-  formatCurrency,
-  formatVolume,
-} from "../utils/math.js";
-
-export async function handleAnalyzeStock(symbol: string): Promise<string> {
-  // Fetch quote and 6-month daily chart in parallel
-  const [quotes, chart] = await Promise.all([
-    yahooQuote([symbol]),
-    yahooChart(symbol, "6mo", "1d"),
-  ]);
-
-  const quote = quotes[0];
-  if (!quote || !quote.regularMarketPrice) {
-    throw new Error(`No quote data found for symbol "${symbol}". Verify the ticker is correct.`);
-  }
-
-  if (chart.length < 5) {
-    throw new Error(`Insufficient price history for "${symbol}" (got ${chart.length} data points).`);
-  }
-
-  const closes = chart.map((p) => p.close);
-  const highs = chart.map((p) => p.high);
-  const lows = chart.map((p) => p.low);
-  const currentPrice = quote.regularMarketPrice;
-
-  // Compute indicators
-  const sma20 = closes.length >= 20 ? lastValue(sma(closes, 20)) : null;
-  const sma50 = closes.length >= 50 ? lastValue(sma(closes, 50)) : null;
-  const sma200 = closes.length >= 200 ? lastValue(sma(closes, 200)) : null;
-  const rsi14 = closes.length >= 15 ? lastValue(rsi(closes, 14)) : null;
-
-  let macdResult: { line: number; signal: number; histogram: number } | null = null;
-  if (closes.length >= 35) {
-    const m = macd(closes);
-    const mLine = lastValue(m.line);
-    const mSignal = lastValue(m.signal);
-    const mHist = lastValue(m.histogram);
-    if (mLine !== null && mSignal !== null && mHist !== null) {
-      macdResult = { line: mLine, signal: mSignal, histogram: mHist };
-    }
-  }
-
-  // Support & resistance
-  const sr = findSupportResistance(highs, lows, closes);
-
-  // Build output
-  const lines: string[] = [];
-  const name = quote.longName ?? quote.shortName ?? symbol;
-  const change = quote.regularMarketChange ?? 0;
-  const changePct = quote.regularMarketChangePercent ?? 0;
-
-  lines.push(`# Stock Analysis: ${name} (${symbol})`);
-  lines.push("");
-
-  // Price overview
-  lines.push("## Price Overview");
-  lines.push("");
-  lines.push("| Metric | Value |");
-  lines.push("|--------|-------|");
-  lines.push(`| Current Price | $${currentPrice.toFixed(2)} |`);
-  lines.push(`| Change | ${change >= 0 ? "+" : ""}$${change.toFixed(2)} (${changePct >= 0 ? "+" : ""}${changePct.toFixed(2)}%) |`);
-  lines.push(`| Day Range | $${(quote.regularMarketDayLow ?? 0).toFixed(2)} - $${(quote.regularMarketDayHigh ?? 0).toFixed(2)} |`);
-  lines.push(`| 52-Week Range | $${(quote.fiftyTwoWeekLow ?? 0).toFixed(2)} - $${(quote.fiftyTwoWeekHigh ?? 0).toFixed(2)} |`);
-  lines.push(`| Volume | ${formatVolume(quote.regularMarketVolume ?? 0)} |`);
-  lines.push(`| Market Cap | ${formatCurrency(quote.marketCap ?? 0)} |`);
-  if (quote.trailingPE) lines.push(`| P/E (Trailing) | ${quote.trailingPE.toFixed(2)} |`);
-  if (quote.forwardPE) lines.push(`| P/E (Forward) | ${quote.forwardPE.toFixed(2)} |`);
-  if (quote.trailingAnnualDividendYield) {
-    lines.push(`| Dividend Yield | ${(quote.trailingAnnualDividendYield * 100).toFixed(2)}% |`);
-  }
-  lines.push("");
-
-  // Moving averages
-  lines.push("## Moving Averages");
-  lines.push("");
-  lines.push("| Indicator | Value | Signal |");
-  lines.push("|-----------|-------|--------|");
-
-  if (sma20 !== null) {
-    const sig = currentPrice > sma20 ? "BULLISH (price above)" : currentPrice < sma20 ? "BEARISH (price below)" : "NEUTRAL";
-    lines.push(`| SMA(20) | $${sma20.toFixed(2)} | ${sig} |`);
-  }
-  if (sma50 !== null) {
-    const sig = currentPrice > sma50 ? "BULLISH (price above)" : currentPrice < sma50 ? "BEARISH (price below)" : "NEUTRAL";
-    lines.push(`| SMA(50) | $${sma50.toFixed(2)} | ${sig} |`);
-  }
-  if (sma200 !== null) {
-    const sig = currentPrice > sma200 ? "BULLISH (price above)" : currentPrice < sma200 ? "BEARISH (price below)" : "NEUTRAL";
-    lines.push(`| SMA(200) | $${sma200.toFixed(2)} | ${sig} |`);
-  }
-  if (quote.fiftyDayAverage) {
-    lines.push(`| Yahoo 50-Day Avg | $${quote.fiftyDayAverage.toFixed(2)} | -- |`);
-  }
-  if (quote.twoHundredDayAverage) {
-    lines.push(`| Yahoo 200-Day Avg | $${quote.twoHundredDayAverage.toFixed(2)} | -- |`);
-  }
-
-  // Golden/Death cross
-  if (sma50 !== null && sma200 !== null) {
-    if (sma50 > sma200) {
-      lines.push("");
-      lines.push("**Golden Cross**: 50-day SMA is above 200-day SMA -- historically bullish signal.");
-    } else if (sma50 < sma200) {
-      lines.push("");
-      lines.push("**Death Cross**: 50-day SMA is below 200-day SMA -- historically bearish signal.");
-    }
-  }
-  lines.push("");
-
-  // RSI
-  if (rsi14 !== null) {
-    lines.push("## RSI (14-period)");
-    lines.push("");
-    lines.push(`**RSI: ${rsi14.toFixed(1)}**`);
-    lines.push("");
-    if (rsi14 >= 70) {
-      lines.push("Interpretation: **OVERBOUGHT** (RSI >= 70). The stock may be overvalued and due for a pullback.");
-    } else if (rsi14 <= 30) {
-      lines.push("Interpretation: **OVERSOLD** (RSI <= 30). The stock may be undervalued and due for a bounce.");
-    } else if (rsi14 >= 60) {
-      lines.push("Interpretation: Bullish momentum (RSI in 60-70 range).");
-    } else if (rsi14 <= 40) {
-      lines.push("Interpretation: Bearish momentum (RSI in 30-40 range).");
-    } else {
-      lines.push("Interpretation: Neutral momentum (RSI in 40-60 range).");
-    }
-    lines.push("");
-  }
-
-  // MACD
-  if (macdResult) {
-    lines.push("## MACD (12, 26, 9)");
-    lines.push("");
-    lines.push("| Component | Value |");
-    lines.push("|-----------|-------|");
-    lines.push(`| MACD Line | ${macdResult.line.toFixed(4)} |`);
-    lines.push(`| Signal Line | ${macdResult.signal.toFixed(4)} |`);
-    lines.push(`| Histogram | ${macdResult.histogram.toFixed(4)} |`);
-    lines.push("");
-    if (macdResult.histogram > 0) {
-      lines.push("Interpretation: **BULLISH** -- MACD is above signal line, positive momentum.");
-    } else {
-      lines.push("Interpretation: **BEARISH** -- MACD is below signal line, negative momentum.");
-    }
-    lines.push("");
-  }
-
-  // Support & Resistance
-  lines.push("## Support & Resistance Levels");
-  lines.push("");
-  if (sr.resistance.length > 0) {
-    lines.push("**Resistance:**");
-    for (const r of sr.resistance) {
-      const distPct = ((r - currentPrice) / currentPrice * 100).toFixed(1);
-      lines.push(`- $${r.toFixed(2)} (+${distPct}% from current)`);
-    }
-  } else {
-    lines.push("**Resistance:** No clear resistance levels identified in recent data.");
-  }
-  lines.push("");
-  if (sr.support.length > 0) {
-    lines.push("**Support:**");
-    for (const s of sr.support) {
-      const distPct = ((currentPrice - s) / currentPrice * 100).toFixed(1);
-      lines.push(`- $${s.toFixed(2)} (-${distPct}% from current)`);
-    }
-  } else {
-    lines.push("**Support:** No clear support levels identified in recent data.");
-  }
-  lines.push("");
-
-  // Signal summary
-  lines.push("## Signal Summary");
-  lines.push("");
-  let bullishCount = 0;
-  let bearishCount = 0;
-
-  if (sma20 !== null) { if (currentPrice > sma20) bullishCount++; else bearishCount++; }
-  if (sma50 !== null) { if (currentPrice > sma50) bullishCount++; else bearishCount++; }
-  if (sma200 !== null) { if (currentPrice > sma200) bullishCount++; else bearishCount++; }
-  if (rsi14 !== null) { if (rsi14 < 30) bullishCount++; else if (rsi14 > 70) bearishCount++; }
-  if (macdResult) { if (macdResult.histogram > 0) bullishCount++; else bearishCount++; }
-
-  const total = bullishCount + bearishCount;
-  const consensus = bullishCount > bearishCount ? "BULLISH" : bearishCount > bullishCount ? "BEARISH" : "NEUTRAL";
-  lines.push(`Bullish signals: ${bullishCount}/${total} | Bearish signals: ${bearishCount}/${total}`);
-  lines.push(`**Overall technical consensus: ${consensus}**`);
-
-  return lines.join("\n");
-}

package/src/tools/compare_assets.ts

@@ -1,183 +0,0 @@
-/**
- * compare_assets -- Compare 2-5 assets side by side.
- *
- * Fetches price history from Yahoo Finance, computes returns, volatility,
- * correlation, and Sharpe ratio approximation.
- */
-
-import { yahooChart, yahooQuote } from "../utils/api.js";
-import {
-  pricesToReturns,
-  mean,
-  stdDev,
-  correlation,
-  maxDrawdown,
-  sharpeRatio,
-  formatPct,
-} from "../utils/math.js";
-
-export async function handleCompareAssets(
-  symbols: string[],
-  period: string = "6mo",
-): Promise<string> {
-  if (symbols.length < 2 || symbols.length > 5) {
-    throw new Error("Compare requires 2-5 symbols.");
-  }
-
-  // Fetch chart data and quotes in parallel
-  const [charts, quotes] = await Promise.all([
-    Promise.all(symbols.map((s) => yahooChart(s, period, "1d"))),
-    yahooQuote(symbols),
-  ]);
-
-  const quoteMap = new Map(quotes.map((q) => [q.symbol, q]));
-
-  // Build per-asset metrics
-  const TRADING_DAYS = 252;
-  const assetMetrics: Array<{
-    symbol: string;
-    name: string;
-    currentPrice: number;
-    totalReturn: number;
-    annualizedReturn: number;
-    volatility: number;
-    sharpe: number;
-    mdd: number;
-    returns: number[];
-  }> = [];
-
-  for (let i = 0; i < symbols.length; i++) {
-    const sym = symbols[i]!;
-    const chart = charts[i]!;
-    const quote = quoteMap.get(sym);
-
-    if (chart.length < 5) {
-      throw new Error(`Insufficient data for ${sym} (got ${chart.length} points). Try a longer period.`);
-    }
-
-    const closes = chart.map((p) => p.close);
-    const returns = pricesToReturns(closes);
-    const avgDailyReturn = mean(returns);
-    const dailyVol = stdDev(returns);
-    const firstClose = closes[0]!;
-    const lastClose = closes[closes.length - 1]!;
-    const totalReturn = firstClose > 0 ? (lastClose - firstClose) / firstClose : 0;
-
-    assetMetrics.push({
-      symbol: sym,
-      name: quote?.shortName ?? quote?.longName ?? sym,
-      currentPrice: quote?.regularMarketPrice ?? lastClose,
-      totalReturn,
-      annualizedReturn: avgDailyReturn * TRADING_DAYS,
-      volatility: dailyVol * Math.sqrt(TRADING_DAYS),
-      sharpe: sharpeRatio(returns),
-      mdd: maxDrawdown(closes),
-      returns,
-    });
-  }
-
-  // Correlation matrix
-  const correlations: Array<{ a: string; b: string; corr: number }> = [];
-  for (let i = 0; i < assetMetrics.length; i++) {
-    for (let j = i + 1; j < assetMetrics.length; j++) {
-      correlations.push({
-        a: assetMetrics[i].symbol,
-        b: assetMetrics[j].symbol,
-        corr: correlation(assetMetrics[i].returns, assetMetrics[j].returns),
-      });
-    }
-  }
-
-  // Format output
-  const lines: string[] = [];
-
-  lines.push("# Asset Comparison");
-  lines.push("");
-  lines.push(`**Assets:** ${symbols.join(", ")}`);
-  lines.push(`**Period:** ${period}`);
-  lines.push("");
-
-  // Performance table (transposed)
-  lines.push("## Performance Comparison");
-  lines.push("");
-  lines.push("| Metric | " + assetMetrics.map((a) => a.symbol).join(" | ") + " |");
-  lines.push("| --- | " + assetMetrics.map(() => "---").join(" | ") + " |");
-  lines.push("| Name | " + assetMetrics.map((a) => a.name.slice(0, 20)).join(" | ") + " |");
-  lines.push("| Current Price | " + assetMetrics.map((a) => `$${a.currentPrice.toFixed(2)}`).join(" | ") + " |");
-  lines.push("| Total Return | " + assetMetrics.map((a) => formatPct(a.totalReturn)).join(" | ") + " |");
-  lines.push("| Annualized Return | " + assetMetrics.map((a) => formatPct(a.annualizedReturn)).join(" | ") + " |");
-  lines.push("| Volatility (Ann.) | " + assetMetrics.map((a) => formatPct(a.volatility)).join(" | ") + " |");
-  lines.push("| Sharpe Ratio | " + assetMetrics.map((a) => a.sharpe.toFixed(3)).join(" | ") + " |");
-  lines.push("| Max Drawdown | " + assetMetrics.map((a) => formatPct(-a.mdd)).join(" | ") + " |");
-  lines.push("");
-
-  // Rankings
-  lines.push("## Rankings");
-  lines.push("");
-
-  const byReturn = [...assetMetrics].sort((a, b) => b.totalReturn - a.totalReturn);
-  const bySharpe = [...assetMetrics].sort((a, b) => b.sharpe - a.sharpe);
-  const byVol = [...assetMetrics].sort((a, b) => a.volatility - b.volatility);
-  const byDD = [...assetMetrics].sort((a, b) => a.mdd - b.mdd);
-
-  lines.push("| Rank | Best Return | Best Sharpe | Lowest Vol | Smallest DD |");
-  lines.push("|------|-------------|-------------|------------|-------------|");
-  for (let i = 0; i < assetMetrics.length; i++) {
-    lines.push(
-      `| ${i + 1} | ${byReturn[i]!.symbol} (${formatPct(byReturn[i]!.totalReturn)}) | ${bySharpe[i]!.symbol} (${bySharpe[i]!.sharpe.toFixed(3)}) | ${byVol[i]!.symbol} (${formatPct(byVol[i]!.volatility)}) | ${byDD[i]!.symbol} (${formatPct(-byDD[i]!.mdd)}) |`,
-    );
-  }
-  lines.push("");
-
-  // Correlation matrix
-  lines.push("## Correlation Matrix");
-  lines.push("");
-
-  const syms = assetMetrics.map((a) => a.symbol);
-  lines.push("| | " + syms.join(" | ") + " |");
-  lines.push("| --- | " + syms.map(() => "---").join(" | ") + " |");
-
-  for (let i = 0; i < syms.length; i++) {
-    const row = [syms[i]];
-    for (let j = 0; j < syms.length; j++) {
-      if (i === j) {
-        row.push("1.000");
-      } else {
-        const pair = correlations.find(
-          (c) =>
-            (c.a === syms[i] && c.b === syms[j]) ||
-            (c.a === syms[j] && c.b === syms[i]),
-        );
-        row.push(pair ? pair.corr.toFixed(3) : "N/A");
-      }
-    }
-    lines.push("| " + row.join(" | ") + " |");
-  }
-  lines.push("");
-
-  // Correlation insight
-  const avgCorr = correlations.length > 0
-    ? mean(correlations.map((c) => c.corr))
-    : 0;
-  lines.push(`**Average correlation:** ${avgCorr.toFixed(3)}`);
-  if (avgCorr > 0.7) {
-    lines.push("These assets are highly correlated -- limited diversification benefit.");
-  } else if (avgCorr > 0.3) {
-    lines.push("Moderate correlation -- some diversification benefit.");
-  } else if (avgCorr > -0.1) {
-    lines.push("Low correlation -- good diversification potential.");
-  } else {
-    lines.push("Negative correlation -- excellent diversification. These assets tend to move in opposite directions.");
-  }
-  lines.push("");
-
-  // Summary
-  lines.push("## Summary");
-  lines.push("");
-  lines.push(`- **Highest return:** ${byReturn[0]!.symbol} (${formatPct(byReturn[0]!.totalReturn)})`);
-  lines.push(`- **Best risk-adjusted:** ${bySharpe[0]!.symbol} (Sharpe: ${bySharpe[0]!.sharpe.toFixed(3)})`);
-  lines.push(`- **Lowest volatility:** ${byVol[0]!.symbol} (${formatPct(byVol[0]!.volatility)})`);
-  lines.push(`- **Smallest drawdown:** ${byDD[0]!.symbol} (${formatPct(-byDD[0]!.mdd)})`);
-
-  return lines.join("\n");
-}