@drico2008/fincli 0.1.3 → 0.2.2

package/fincli/app/analysis/multi_timeframe.py

@@ -0,0 +1,180 @@
+"""Multi-timeframe technical alignment analysis."""
+
+from __future__ import annotations
+
+import asyncio
+from dataclasses import dataclass
+from typing import Protocol
+
+from fincli.app.analysis.indicators import TechnicalSummary, summarize_technical_indicators
+from fincli.app.analysis.market_structure import MarketStructureSummary, analyze_market_structure
+from fincli.app.providers.market.base import Candle
+
+
+class HistoryProvider(Protocol):
+    async def history(self, symbol: str, period: str = "6mo", interval: str = "1d") -> list[Candle]:
+        """Fetch candles for a symbol/timeframe."""
+
+
+@dataclass(frozen=True, slots=True)
+class TimeframeAnalysis:
+    timeframe: str
+    status: str
+    candles: int
+    latest_close: float | None
+    trend_bias: str
+    structure_trend: str
+    rsi: float | None
+    macd: float | None
+    support: float | None
+    resistance: float | None
+    note: str = ""
+
+
+@dataclass(frozen=True, slots=True)
+class MultiTimeframeAnalysis:
+    symbol: str
+    frames: list[TimeframeAnalysis]
+    alignment: str
+    score: int
+    bias: str
+    risk_note: str
+
+
+async def analyze_multi_timeframe(
+    symbol: str,
+    provider: HistoryProvider,
+    timeframes: tuple[str, ...] = ("1d", "1h", "15m"),
+) -> MultiTimeframeAnalysis:
+    tasks = [_analyze_frame(symbol, provider, timeframe) for timeframe in timeframes]
+    frames = list(await asyncio.gather(*tasks))
+    score = sum(_frame_score(frame) for frame in frames if frame.status == "ready")
+    ready_count = sum(1 for frame in frames if frame.status == "ready")
+
+    if ready_count == 0:
+        return MultiTimeframeAnalysis(
+            symbol=symbol.upper(),
+            frames=frames,
+            alignment="unavailable",
+            score=0,
+            bias="caution",
+            risk_note="No timeframe returned enough data. Check provider, symbol format, and interval support.",
+        )
+
+    if score >= max(2, ready_count):
+        bias = "bullish"
+    elif score <= -max(2, ready_count):
+        bias = "bearish"
+    else:
+        bias = "mixed/caution"
+
+    alignment = _alignment_label(frames)
+    risk_note = _risk_note(frames, bias)
+    return MultiTimeframeAnalysis(symbol=symbol.upper(), frames=frames, alignment=alignment, score=score, bias=bias, risk_note=risk_note)
+
+
+async def _analyze_frame(symbol: str, provider: HistoryProvider, timeframe: str) -> TimeframeAnalysis:
+    try:
+        candles = await provider.history(symbol, period=_period_for_timeframe(timeframe), interval=timeframe)
+        if len(candles) < 20:
+            return TimeframeAnalysis(
+                timeframe=timeframe,
+                status="insufficient",
+                candles=len(candles),
+                latest_close=candles[-1].close if candles else None,
+                trend_bias="neutral",
+                structure_trend="neutral",
+                rsi=None,
+                macd=None,
+                support=None,
+                resistance=None,
+                note="Need at least 20 candles for stable multi-timeframe summary.",
+            )
+        technical = summarize_technical_indicators(candles)
+        structure = analyze_market_structure(candles)
+        return _frame_from_summary(timeframe, candles, technical, structure)
+    except Exception as exc:  # noqa: BLE001
+        return TimeframeAnalysis(
+            timeframe=timeframe,
+            status="unavailable",
+            candles=0,
+            latest_close=None,
+            trend_bias="neutral",
+            structure_trend="neutral",
+            rsi=None,
+            macd=None,
+            support=None,
+            resistance=None,
+            note=str(exc),
+        )
+
+
+def _frame_from_summary(
+    timeframe: str,
+    candles: list[Candle],
+    technical: TechnicalSummary,
+    structure: MarketStructureSummary,
+) -> TimeframeAnalysis:
+    return TimeframeAnalysis(
+        timeframe=timeframe,
+        status="ready",
+        candles=len(candles),
+        latest_close=technical.latest_close,
+        trend_bias=technical.trend_bias,
+        structure_trend=structure.trend,
+        rsi=technical.rsi,
+        macd=technical.macd,
+        support=technical.support,
+        resistance=technical.resistance,
+    )
+
+
+def _period_for_timeframe(timeframe: str) -> str:
+    normalized = timeframe.lower()
+    if normalized in {"1m", "5m", "15m", "30m", "1h", "4h"}:
+        return "60d"
+    if normalized in {"1w", "w"}:
+        return "2y"
+    return "1y"
+
+
+def _frame_score(frame: TimeframeAnalysis) -> int:
+    score = 0
+    if frame.trend_bias == "bullish":
+        score += 1
+    elif frame.trend_bias == "bearish":
+        score -= 1
+    if frame.structure_trend == "bullish":
+        score += 1
+    elif frame.structure_trend == "bearish":
+        score -= 1
+    if frame.rsi is not None:
+        if frame.rsi > 70:
+            score -= 1
+        elif frame.rsi < 30:
+            score += 1
+    return score
+
+
+def _alignment_label(frames: list[TimeframeAnalysis]) -> str:
+    ready = [frame for frame in frames if frame.status == "ready"]
+    if not ready:
+        return "unavailable"
+    trends = {frame.trend_bias for frame in ready}
+    structures = {frame.structure_trend for frame in ready}
+    if len(trends) == 1 and len(structures) == 1 and next(iter(trends)) == next(iter(structures)):
+        return f"aligned {next(iter(trends))}"
+    if all(frame.trend_bias in {"bullish", "neutral"} and frame.structure_trend in {"bullish", "neutral"} for frame in ready):
+        return "mostly bullish"
+    if all(frame.trend_bias in {"bearish", "neutral"} and frame.structure_trend in {"bearish", "neutral"} for frame in ready):
+        return "mostly bearish"
+    return "mixed"
+
+
+def _risk_note(frames: list[TimeframeAnalysis], bias: str) -> str:
+    unavailable = [frame.timeframe for frame in frames if frame.status != "ready"]
+    if unavailable:
+        return f"{bias}; verify unavailable/insufficient timeframe(s): {', '.join(unavailable)}."
+    if bias == "mixed/caution":
+        return "Timeframes disagree. Prefer confirmation over directional conviction."
+    return f"{bias}; still validate support/resistance and news/fundamental context before acting."

package/fincli/app/analysis/trading_methods.py

@@ -0,0 +1,144 @@
+"""Trading-method context inspired by common SNR, volume, pivot, and gap workflows."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from fincli.app.providers.market.base import Candle
+
+
+@dataclass(frozen=True, slots=True)
+class TradingMethodContext:
+    nearest_support: float | None
+    nearest_resistance: float | None
+    support_break: bool
+    resistance_break: bool
+    bull_wick: bool
+    bear_wick: bool
+    volume_oscillator_percent: float | None
+    volume_confirmation: str
+    pivot_highs: list[float]
+    pivot_lows: list[float]
+    latest_gap: str
+    method_notes: list[str]
+
+
+def analyze_trading_methods(candles: list[Candle], left: int = 3, right: int = 3) -> TradingMethodContext:
+    if not candles:
+        raise ValueError("Data candle kosong.")
+
+    pivot_highs, pivot_lows = _pivots(candles, left, right)
+    recent = candles[-20:]
+    latest = candles[-1]
+    previous = candles[-2] if len(candles) >= 2 else candles[-1]
+    support = _nearest_below(pivot_lows, latest.close) or min(float(candle.low) for candle in recent)
+    resistance = _nearest_above(pivot_highs, latest.close) or max(float(candle.high) for candle in recent)
+    volume_osc = _volume_oscillator(candles)
+    volume_ok = volume_osc is not None and volume_osc > 20
+
+    support_break = latest.close < support and volume_ok
+    resistance_break = latest.close > resistance and volume_ok
+    body = abs(latest.close - latest.open)
+    upper_wick = latest.high - max(latest.open, latest.close)
+    lower_wick = min(latest.open, latest.close) - latest.low
+    bull_wick = latest.close > resistance and lower_wick > body
+    bear_wick = latest.close < support and upper_wick > body
+    latest_gap = _latest_gap(previous, latest)
+
+    notes = [
+        "SNR uses pivot highs/lows and recent range when pivots are sparse.",
+        "Break confirmation requires close beyond level plus volume oscillator above 20%.",
+        "Wick labels flag rejection risk around levels.",
+        "Gap context is descriptive; confirm with liquidity and follow-through.",
+    ]
+    return TradingMethodContext(
+        nearest_support=support,
+        nearest_resistance=resistance,
+        support_break=support_break,
+        resistance_break=resistance_break,
+        bull_wick=bull_wick,
+        bear_wick=bear_wick,
+        volume_oscillator_percent=volume_osc,
+        volume_confirmation="confirmed" if volume_ok else "not confirmed",
+        pivot_highs=pivot_highs[-5:],
+        pivot_lows=pivot_lows[-5:],
+        latest_gap=latest_gap,
+        method_notes=notes,
+    )
+
+
+def format_trading_methods_context(context: TradingMethodContext) -> str:
+    return (
+        "Trading Method Context:\n"
+        f"- SNR/Pivot: support={_fmt(context.nearest_support)}, resistance={_fmt(context.nearest_resistance)}, "
+        f"pivot_highs={_fmt_list(context.pivot_highs)}, pivot_lows={_fmt_list(context.pivot_lows)}\n"
+        f"- Break Logic: resistance_break={context.resistance_break}, support_break={context.support_break}, "
+        f"bull_wick={context.bull_wick}, bear_wick={context.bear_wick}\n"
+        f"- Volume: oscillator={_fmt(context.volume_oscillator_percent)}%, confirmation={context.volume_confirmation}\n"
+        f"- Gap: {context.latest_gap}\n"
+        f"- Method Notes: {'; '.join(context.method_notes)}"
+    )
+
+
+def _pivots(candles: list[Candle], left: int, right: int) -> tuple[list[float], list[float]]:
+    highs: list[float] = []
+    lows: list[float] = []
+    if len(candles) < left + right + 1:
+        return highs, lows
+    for index in range(left, len(candles) - right):
+        window = candles[index - left : index + right + 1]
+        current = candles[index]
+        if current.high == max(candle.high for candle in window):
+            highs.append(float(current.high))
+        if current.low == min(candle.low for candle in window):
+            lows.append(float(current.low))
+    return highs, lows
+
+
+def _nearest_below(levels: list[float], price: float) -> float | None:
+    candidates = [level for level in levels if level <= price]
+    return max(candidates) if candidates else None
+
+
+def _nearest_above(levels: list[float], price: float) -> float | None:
+    candidates = [level for level in levels if level >= price]
+    return min(candidates) if candidates else None
+
+
+def _volume_oscillator(candles: list[Candle]) -> float | None:
+    volumes = [float(candle.volume) for candle in candles]
+    if len(volumes) < 10:
+        return None
+    short = _ema(volumes, 5)[-1]
+    long = _ema(volumes, 10)[-1]
+    if long == 0:
+        return None
+    return 100 * (short - long) / long
+
+
+def _ema(values: list[float], span: int) -> list[float]:
+    alpha = 2 / (span + 1)
+    result = [values[0]]
+    for value in values[1:]:
+        result.append((value * alpha) + result[-1] * (1 - alpha))
+    return result
+
+
+def _latest_gap(previous: Candle, latest: Candle) -> str:
+    if latest.low > previous.high:
+        return f"gap up above previous high {_fmt(previous.high)}"
+    if latest.high < previous.low:
+        return f"gap down below previous low {_fmt(previous.low)}"
+    return "no open gap against previous candle"
+
+
+def _fmt(value: float | None) -> str:
+    if value is None:
+        return "N/A"
+    return f"{value:.4f}"
+
+
+def _fmt_list(values: list[float]) -> str:
+    if not values:
+        return "[]"
+    return "[" + ", ".join(_fmt(value) for value in values) + "]"

package/fincli/app/cli/commands.py

@@ -1,84 +1,112 @@
-"""Slash command registry."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-
-
-@dataclass(frozen=True, slots=True)
-class CommandSpec:
-    name: str
-    description: str
-    example: str
-    group: str = "General"
-
-
-COMMANDS: tuple[CommandSpec, ...] = (
-    CommandSpec("/help", "Tampilkan bantuan, command list, dan contoh.", "/help"),
-    CommandSpec("/dashboard", "Tampilkan dashboard compact FinCLI.", "/dashboard", "General"),
-    CommandSpec("/ai_model", "Lihat atau ganti AI provider/model.", "/ai_model openrouter openai/gpt-4o-mini", "AI"),
-    CommandSpec("/ai_model key", "Simpan API key AI lokal.", "/ai_model key groq <api_key>", "AI"),
+"""Slash command registry."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class CommandSpec:
+    name: str
+    description: str
+    example: str
+    group: str = "General"
+
+
+COMMANDS: tuple[CommandSpec, ...] = (
+    CommandSpec("/help", "Tampilkan bantuan, command list, dan contoh.", "/help"),
+    CommandSpec("/dashboard", "Tampilkan dashboard compact FinCLI.", "/dashboard", "General"),
+    CommandSpec("/ai_model", "Lihat atau ganti AI provider/model.", "/ai_model openrouter openai/gpt-4o-mini", "AI"),
+    CommandSpec("/ai_model key", "Simpan API key AI lokal.", "/ai_model key groq <api_key>", "AI"),
     CommandSpec("/news_model", "Buka selector provider market/news dan fallback.", "/news_model", "Provider"),
-    CommandSpec("/news_model key", "Simpan API key market/news lokal.", "/news_model key finnhub <api_key>", "Provider"),
+    CommandSpec("/news_model list", "Tampilkan 100+ news connector dan status akses.", "/news_model list", "Provider"),
+    CommandSpec("/news_model search", "Cari connector news.", "/news_model search rss", "Provider"),
+    CommandSpec("/news_model use", "Pilih primary news provider.", "/news_model use google_news_rss", "Provider"),
+    CommandSpec("/news_model priority", "Atur fallback news provider.", "/news_model priority google_news_rss,yfinance,marketaux", "Provider"),
+    CommandSpec("/news_model key", "Simpan API key news connector lokal.", "/news_model key marketaux <api_key>", "Provider"),
+    CommandSpec("/symbol", "Search symbol dan tampilkan normalisasi per provider.", "/symbol XAUUSD", "Market"),
+    CommandSpec("/research", "Pusat riset ringkas: market, technical, news, fundamental, dan AI deep mode.", "/research AAPL --quick", "Research"),
+    CommandSpec("/macro", "Dashboard macro fallback dan connector-ready context.", "/macro Indonesia", "Research"),
+    CommandSpec("/profile", "Tampilkan profil dan gameplay risk lokal.", "/profile", "Profile"),
+    CommandSpec("/profile set", "Simpan profil gameplay lokal.", '/profile set "Budi" 350 USD 1:100 1.5', "Profile"),
+    CommandSpec("/doctor", "Cek kesehatan konfigurasi, provider, database, dan command inti.", "/doctor", "System"),
+    CommandSpec("/setup", "Panduan setup lokal untuk API key, provider, dan profile.", "/setup", "System"),
+    CommandSpec("/agent", "Lihat agent framework FinCLI.", "/agent list", "AI"),
+    CommandSpec("/agent show", "Tampilkan detail agent framework.", "/agent show buffett", "AI"),
+    CommandSpec("/connector", "Lihat catalog data connector.", "/connector list macro", "Provider"),
+    CommandSpec("/connector search", "Cari connector data.", "/connector search yahoo", "Provider"),
+    CommandSpec("/plugin", "Tampilkan plugin lokal FinCLI.", "/plugin list", "System"),
+    CommandSpec("/plugin status", "Cek status manifest plugin lokal.", "/plugin status", "System"),
     CommandSpec("/market", "Ringkasan market profesional untuk instrumen.", "/market AAPL 1d", "Market"),
     CommandSpec("/news", "Tampilkan news/fundamental terbaru untuk instrumen.", "/news AAPL", "Market"),
     CommandSpec("/technical", "Analisis teknikal instrumen.", "/technical BTC-USD 1d", "Analysis"),
-    CommandSpec("/structure", "Analisis struktur pasar instrumen.", "/structure BTC-USD 1d", "Analysis"),
-    CommandSpec("/funda", "Fundamental ringkas instrumen.", "/funda MSFT", "Market"),
+    CommandSpec("/mtf", "Multi-timeframe technical alignment.", "/mtf AAPL 1d,1h,15m", "Analysis"),
+    CommandSpec("/backtest", "Lightweight rule-based strategy backtest.", "/backtest AAPL sma_cross 1d", "Analysis"),
     CommandSpec("/yahoo", "Tampilkan tabel Yahoo Finance untuk history/statistics/profile/financials/analysis/holders.", "/yahoo BBRI statistics", "Market"),
-    CommandSpec("/ai", "Free chat dengan AI assistant.", "/ai ringkas risiko AAPL", "AI"),
-    CommandSpec("/analyze", "AI menganalisis struktur pasar instrumen.", "/analyze ETH-USD 4h", "Analysis"),
-    CommandSpec("/watchlist", "Tampilkan watchlist.", "/watchlist", "Watchlist"),
-    CommandSpec("/watchlist add", "Tambahkan instrumen ke watchlist.", "/watchlist add AAPL", "Watchlist"),
-    CommandSpec("/watchlist remove", "Hapus instrumen dari watchlist.", "/watchlist remove AAPL", "Watchlist"),
-    CommandSpec("/portfolio", "Tampilkan portfolio lokal.", "/portfolio", "Portfolio"),
-    CommandSpec("/portfolio add", "Tambahkan posisi/aset.", "/portfolio add BTC-USD 0.05 65000", "Portfolio"),
-    CommandSpec("/portfolio remove", "Hapus posisi/aset.", "/portfolio remove BTC-USD", "Portfolio"),
-    CommandSpec("/portfolio performance", "Tampilkan performa portfolio.", "/portfolio performance", "Portfolio"),
-    CommandSpec("/tx", "Tampilkan transaction ledger.", "/tx list", "Portfolio"),
-    CommandSpec("/tx add", "Tambahkan transaksi buy/sell.", "/tx add buy AAPL 10 185", "Portfolio"),
-    CommandSpec("/journal", "Tampilkan journal trading/investasi.", "/journal", "Journal"),
-    CommandSpec("/journal add", "Tambahkan catatan journal singkat.", '/journal add BTC-USD bullish "Breakout gagal, tunggu konfirmasi"', "Journal"),
-    CommandSpec("/journal stats", "Tampilkan statistik journal.", "/journal stats", "Journal"),
-    CommandSpec("/journal review", "AI review kebiasaan journal.", "/journal review", "Journal"),
-    CommandSpec("/config", "Tampilkan konfigurasi aktif tanpa membocorkan API key.", "/config"),
-    CommandSpec("/price", "Tampilkan harga instrumen.", "/price NVDA", "Market"),
-    CommandSpec("/quote", "Alias harga/quote instrumen.", "/quote NVDA", "Market"),
+    CommandSpec("/ai", "Free chat dengan AI assistant.", "/ai ringkas risiko AAPL", "AI"),
+    CommandSpec("/analyze", "AI menganalisis struktur pasar instrumen.", "/analyze ETH-USD 4h", "Analysis"),
+    CommandSpec("/watchlist", "Tampilkan watchlist.", "/watchlist", "Watchlist"),
+    CommandSpec("/watchlist add", "Tambahkan instrumen ke watchlist.", "/watchlist add AAPL", "Watchlist"),
+    CommandSpec("/watchlist remove", "Hapus instrumen dari watchlist.", "/watchlist remove AAPL", "Watchlist"),
+    CommandSpec("/portfolio", "Tampilkan portfolio lokal.", "/portfolio", "Portfolio"),
+    CommandSpec("/portfolio add", "Tambahkan posisi/aset.", "/portfolio add BTC-USD 0.05 65000", "Portfolio"),
+    CommandSpec("/portfolio remove", "Hapus posisi/aset.", "/portfolio remove BTC-USD", "Portfolio"),
+    CommandSpec("/portfolio performance", "Tampilkan performa portfolio.", "/portfolio performance", "Portfolio"),
+    CommandSpec("/tx", "Tampilkan transaction ledger.", "/tx list", "Portfolio"),
+    CommandSpec("/tx add", "Tambahkan transaksi buy/sell.", "/tx add buy AAPL 10 185", "Portfolio"),
+    CommandSpec("/journal", "Tampilkan journal trading/investasi.", "/journal", "Journal"),
+    CommandSpec("/journal add", "Tambahkan catatan journal singkat.", '/journal add BTC-USD bullish "Breakout gagal, tunggu konfirmasi"', "Journal"),
+    CommandSpec("/journal stats", "Tampilkan statistik journal.", "/journal stats", "Journal"),
+    CommandSpec("/journal review", "AI review kebiasaan journal.", "/journal review", "Journal"),
+    CommandSpec("/alert", "Tampilkan alert harga lokal.", "/alert", "Alert"),
+    CommandSpec("/alert add", "Tambahkan alert harga.", "/alert add AAPL above 200", "Alert"),
+    CommandSpec("/alert check", "Cek alert aktif memakai quote provider.", "/alert check", "Alert"),
+    CommandSpec("/history", "Tampilkan command history current session.", "/history", "History"),
+    CommandSpec("/history sessions", "Tampilkan daftar session tersimpan.", "/history sessions", "History"),
+    CommandSpec("/history show", "Tampilkan detail session tertentu.", "/history show <session_id>", "History"),
+    CommandSpec("/history save", "Beri nama current session.", '/history save "Riset IHSG pagi"', "History"),
+    CommandSpec("/history delete", "Hapus session tertentu.", "/history delete <session_id>", "History"),
+    CommandSpec("/config", "Tampilkan konfigurasi aktif tanpa membocorkan API key.", "/config"),
     CommandSpec("/scan", "Scanner watchlist dengan filter indikator.", "/scan watchlist rsi<30", "Market"),
-    CommandSpec("/calendar", "Economic calendar provider/fallback.", "/calendar week US high", "Market"),
+    CommandSpec("/scan export", "Export hasil scanner watchlist ke CSV/JSON.", "/scan export csv scan.csv rsi<30 1d", "Market"),
+    CommandSpec("/report market", "Export market report ke Markdown/JSON.", "/report market AAPL md report.md", "Export"),
+    CommandSpec("/calendar", "Economic calendar provider/fallback.", "/calendar week US high", "Market"),
+    CommandSpec("/calendar export", "Export economic calendar ke CSV/JSON.", "/calendar export csv calendar.csv week US high", "Market"),
     CommandSpec("/provider status", "Tampilkan status provider aktif.", "/provider status", "Provider"),
-    CommandSpec("/provider list", "Tampilkan semua provider market yang tersedia.", "/provider list", "Provider"),
-    CommandSpec("/provider test", "Test quote provider aktif untuk symbol.", "/provider test AAPL", "Provider"),
-    CommandSpec("/provider key status", "Tampilkan status API key market provider.", "/provider key status", "Provider"),
-    CommandSpec("/cache stats", "Tampilkan statistik cache market persistent.", "/cache stats", "System"),
-    CommandSpec("/cache clear", "Bersihkan runtime dan persistent market cache.", "/cache clear", "System"),
-    CommandSpec("/export journal", "Export journal. Phase 1 menyiapkan command.", "/export journal", "Export"),
-    CommandSpec("/export portfolio", "Export portfolio. Phase 1 menyiapkan command.", "/export portfolio", "Export"),
-    CommandSpec("/clear", "Bersihkan output terminal.", "/clear"),
-    CommandSpec("/exit", "Keluar dari aplikasi.", "/exit"),
-)
-
-
-class CommandRegistry:
-    """Lookup and autocomplete slash commands."""
-
-    def __init__(self, commands: tuple[CommandSpec, ...] = COMMANDS) -> None:
-        self.commands = commands
-
-    def suggest(self, query: str, limit: int = 8) -> list[CommandSpec]:
-        normalized = query.strip().lower()
-        if not normalized:
-            return list(self.commands[:limit])
-        if not normalized.startswith("/"):
-            normalized = f"/{normalized}"
-
-        exact = [cmd for cmd in self.commands if cmd.name.lower().startswith(normalized)]
-        fuzzy = [cmd for cmd in self.commands if normalized.replace("/", "") in cmd.name.lower().replace("/", "")]
-        merged: list[CommandSpec] = []
-        for cmd in [*exact, *fuzzy]:
-            if cmd not in merged:
-                merged.append(cmd)
-        return merged[:limit]
-
-    def all(self) -> tuple[CommandSpec, ...]:
-        return self.commands
+    CommandSpec("/provider metrics", "Tampilkan metric runtime provider aktif.", "/provider metrics", "Provider"),
+    CommandSpec("/provider list", "Tampilkan semua provider market yang tersedia.", "/provider list", "Provider"),
+    CommandSpec("/provider entitlement", "Tampilkan capability dan realtime/delayed label provider.", "/provider entitlement", "Provider"),
+    CommandSpec("/provider test", "Test quote provider aktif untuk symbol.", "/provider test AAPL", "Provider"),
+    CommandSpec("/provider key status", "Tampilkan status API key market provider.", "/provider key status", "Provider"),
+    CommandSpec("/cache stats", "Tampilkan statistik cache market persistent.", "/cache stats", "System"),
+    CommandSpec("/cache clear", "Bersihkan runtime dan persistent market cache.", "/cache clear", "System"),
+    CommandSpec("/export journal", "Export journal ke CSV/JSON.", "/export journal csv journal.csv", "Export"),
+    CommandSpec("/export portfolio", "Export portfolio ke CSV/JSON.", "/export portfolio json portfolio.json", "Export"),
+    CommandSpec("/clear", "Bersihkan output terminal.", "/clear"),
+    CommandSpec("/exit", "Keluar dari aplikasi.", "/exit"),
+)
+
+
+class CommandRegistry:
+    """Lookup and autocomplete slash commands."""
+
+    def __init__(self, commands: tuple[CommandSpec, ...] = COMMANDS) -> None:
+        self.commands = commands
+
+    def suggest(self, query: str, limit: int = 8) -> list[CommandSpec]:
+        normalized = query.strip().lower()
+        if not normalized:
+            return list(self.commands[:limit])
+        if not normalized.startswith("/"):
+            normalized = f"/{normalized}"
+
+        exact = [cmd for cmd in self.commands if cmd.name.lower().startswith(normalized)]
+        fuzzy = [cmd for cmd in self.commands if normalized.replace("/", "") in cmd.name.lower().replace("/", "")]
+        merged: list[CommandSpec] = []
+        for cmd in [*exact, *fuzzy]:
+            if cmd not in merged:
+                merged.append(cmd)
+        return merged[:limit]
+
+    def all(self) -> tuple[CommandSpec, ...]:
+        return self.commands