@drico2008/fincli 0.1.2 → 0.1.9

package/README.md

@@ -2,7 +2,7 @@
 
 FinCLI adalah financial CLI/TUI terminal modern untuk memantau market, mengelola watchlist, portfolio, journal, konfigurasi provider, dan menyiapkan integrasi AI market analysis secara modular.
 
-Status saat ini: Phase 23 MVP sudah aktif di atas fondasi Phase 1 sampai Phase 22.
+Status saat ini: FinCLI MVP aktif dengan TUI, provider chain, AI assistance, web research, portfolio, journal, watchlist, export, dan session history lokal.
 
 - Textual TUI satu kolom dengan command palette inline yang bisa discroll; sidebar lama sudah dihapus agar output market lebih lega.
 - Slash command router dengan command wajib FinCLI v0.1.
@@ -90,6 +90,24 @@ copy .env.example .env
 
 Isi API key hanya untuk provider yang ingin digunakan. yfinance fallback tidak butuh API key. Config membaca status key tanpa menampilkan secret.
 
+Untuk install global lewat npm, user tidak perlu membuka folder package atau mengedit `.env`. Simpan API key lewat command FinCLI:
+
+```text
+/ai_model key groq <api_key>
+/ai_model key openrouter <api_key>
+/news_model key finnhub <api_key>
+/news_model key twelvedata <api_key>
+/news_model key custom <api_key> https://your-market-api.example.com
+```
+
+Key disimpan lokal di:
+
+```text
+~/.fincli/secrets.env
+```
+
+File ini tidak dicetak penuh di output terminal. `/config` dan `/provider key status` hanya menampilkan status/masked key.
+
 ## Run
 
 ```bash
@@ -130,12 +148,17 @@ python -m fincli.app.main
 /journal add BTC-USD bullish "Breakout gagal, tunggu konfirmasi"
 /journal stats
 /journal review
-/price AAPL
+/history
+/history sessions
+/history save "Riset market pagi"
+/quote AAPL
 /technical BTC-USD 1d
 /technical XAUUSD 1d
 /technical EURUSD 1d
 /structure BTC-USD 1d
 /news AAPL
+/web penyebab rupiah melemah hari ini
+/web sources penyebab rupiah melemah hari ini
 /funda MSFT
 /yahoo BBRI history 6mo 1d
 /yahoo BBRI statistics
@@ -159,7 +182,7 @@ python -m fincli.app.main
 /exit
 ```
 
-Command `/market`, `/price`, `/quote`, `/technical`, `/structure`, `/news`, dan `/funda` sudah memakai provider chain aktif. Command `/ai` dan `/analyze` sudah memakai AI provider aktif dari `/ai_model` dan `.env`. `/analyze` membawa konteks indikator, struktur pasar, news, dan fundamental ringkas ke prompt AI. `/ai` juga mengambil quote, OHLCV/technical, structure, news, dan fundamental saat user menyebut symbol seperti `AAPL`, `EURUSD`, atau `XAUUSD`.
+Command `/market`, `/quote`, `/technical`, `/structure`, `/news`, dan `/funda` sudah memakai provider chain aktif. Command `/ai` dan `/analyze` sudah memakai AI provider aktif dari `/ai_model` dan `.env`. `/analyze` membawa konteks indikator, struktur pasar, news, dan fundamental ringkas ke prompt AI. `/ai` juga mengambil quote, OHLCV/technical, structure, news, dan fundamental saat user menyebut symbol seperti `AAPL`, `EURUSD`, atau `XAUUSD`.
 
 ## AI Chat UX
 
@@ -189,8 +212,31 @@ AI assistant di dalam FinCLI dipersonalisasi untuk market workflow:
 - Boleh free chat untuk pertanyaan umum, market, portfolio, journal, provider, dan risk workflow.
 - Menolak coding/debugging/refactor/pembuatan software di dalam assistant FinCLI agar fokus app tetap jelas.
 - Jika prompt berisi symbol eksplisit, FinCLI menyisipkan market context dari provider chain aktif sebelum memanggil AI provider.
+- Jika prompt membutuhkan info terkini, FinCLI dapat mengambil konteks web publik dan memasukkannya ke AI prompt.
 - Tidak membocorkan API key dan tidak mengklaim realtime jika provider aktif hanya delayed/fallback.
 
+Contoh web-aware freechat:
+
+```text
+apa yang menyebabkan penurunan rupiah terhadap semua mata uang hari ini
+berita terbaru BI rate dan dampaknya ke IHSG
+```
+
+Untuk web search yang dirangkum oleh AI:
+
+```text
+/web penyebab rupiah melemah hari ini
+/web update harga emas dan dollar index
+```
+
+Untuk melihat sumber mentah tanpa ringkasan AI:
+
+```text
+/web sources penyebab rupiah melemah hari ini
+```
+
+FinCLI memakai lightweight HTTP web research, bukan Chrome automation. Ini lebih stabil untuk npm global install dan tidak membuka browser di background. Output tetap harus diverifikasi karena kualitas sumber web bisa berbeda-beda.
+
 ## Interactive AI Model Selector
 
 ```text
@@ -202,6 +248,7 @@ Di TUI, command ini membuka selector seperti modern CLI:
 - Select Provider
 - Status provider current/configured
 - Use existing configuration / configure again
+- Configure API key jika provider belum punya key
 - Select Model
 - Search model/provider
 - Navigasi `up/down`, `Enter`, `Tab`, dan `Esc`
@@ -222,6 +269,7 @@ Di TUI, command ini membuka selector untuk provider market/news dan fallback pri
 
 - Select Market/News Provider
 - Pilih `Twelve Data`, `Finnhub`, `Custom API`, atau `Yahoo Finance`
+- Masukkan API key langsung dari popup jika provider belum dikonfigurasi
 - Pilih preset fallback: recommended, primary + yfinance, data API priority, atau yfinance only
 - Search provider/preset
 - Navigasi `up/down`, `Enter`, `Tab`, dan `Esc`
@@ -436,6 +484,7 @@ Contoh:
 
 ```bash
 /ai_model openrouter openai/gpt-4o-mini
+/ai_model key openrouter <api_key>
 /ai jelaskan risiko market NVDA secara singkat
 /analyze AAPL 1d
 ```
@@ -453,7 +502,7 @@ FinCLI memakai yfinance untuk akses saham global yang tersedia di Yahoo Finance.
 Command:
 
 ```text
-/price BBRI
+/quote BBRI
 /technical BBRI 1d
 /analyze BBRI 1d
 /yahoo BBRI history 6mo 1d
@@ -496,6 +545,12 @@ Environment variable:
 FINNHUB_API_KEY=your-finnhub-key
 ```
 
+Atau simpan dari FinCLI:
+
+```text
+/news_model key finnhub <api_key>
+```
+
 Endpoint Finnhub yang dipakai:
 
 ```text
@@ -524,6 +579,12 @@ Environment variable:
 TWELVE_DATA_API_KEY=your-twelve-data-key
 ```
 
+Atau simpan dari FinCLI:
+
+```text
+/news_model key twelvedata <api_key>
+```
+
 Endpoint Twelve Data yang dipakai:
 
 ```text
@@ -571,6 +632,12 @@ MARKET_DATA_API_KEY=your-key
 MARKET_DATA_BASE_URL=https://your-market-api.example.com
 ```
 
+Atau simpan dari FinCLI:
+
+```text
+/news_model key custom <api_key> https://your-market-api.example.com
+```
+
 FinCLI akan memanggil endpoint:
 
 ```text
@@ -604,7 +671,14 @@ FinCLI menyimpan data lokal di:
 ~/.fincli/fincli.log
 ```
 
-API key tidak disimpan di output terminal dan sebaiknya tetap berada di `.env` atau environment variable.
+API key tidak disimpan di output terminal. Untuk install global via npm, jalur utama adalah command FinCLI:
+
+```text
+/ai_model key groq <api_key>
+/news_model key twelvedata <api_key>
+```
+
+Key disimpan lokal di `~/.fincli/secrets.env`, dipakai otomatis untuk semua session FinCLI berikutnya, dan tidak perlu dikonfigurasi ulang. Jika `.env` lokal berisi nilai kosong, FinCLI tetap memakai secret lokal yang sudah tersimpan.
 
 ## Test
 
@@ -622,8 +696,8 @@ Hasil terakhir di environment ini:
 
 - `fincli` tidak dikenali: jalankan `pip install -e .` dari root project.
 - TUI tidak tampil rapi: perbesar terminal desktop.
-- API key tidak terbaca: pastikan file `.env` ada di root project atau export environment variable.
-- `/price` gagal karena yfinance belum ada: jalankan `pip install -e ".[dev]"` atau `pip install -r requirements.txt`.
+- API key tidak terbaca: gunakan `/ai_model key <provider> <api_key>` atau `/news_model key <provider> <api_key>`, lalu cek `/config` atau `/provider key status`.
+- `/quote` gagal karena yfinance belum ada: jalankan `pip install -e ".[dev]"` atau `pip install -r requirements.txt`.
 - Config rusak: hapus `~/.fincli/config.json` untuk kembali ke default.
 
 ## Roadmap Lanjutan

package/fincli/__init__.py

@@ -1,3 +1,3 @@
 """FinCLI package."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.9"

package/fincli/app/analysis/assistant_context.py

@@ -15,6 +15,7 @@ Identity and scope:
 
 Financial analysis rules:
 - Analyze from provided market context first. Do not invent prices, news, fundamentals, provider status, or certainty.
+- If Web Research Context is provided, use it as current public context, mention source URLs, and separate sourced facts from interpretation.
 - Use probabilistic language: scenario, bias, confirmation, invalidation, risk, caution.
 - Do not promise profit and do not present aggressive entries as guaranteed signals.
 - For technical analysis, weigh trend, momentum, volatility, support/resistance, market structure, and data quality.
@@ -155,7 +156,32 @@ def build_fincli_assistant_prompt(user_prompt: str, market_context: str = "") ->
         f"{user_prompt.strip()}\n\n"
         "Instruction:\n"
         "- Answer the user's prompt directly.\n"
-        "- If market context is present, cite provider/data-quality limitations.\n"
+        "- If market or web context is present, cite provider/data-quality limitations and source URLs when available.\n"
         "- If market context is missing and the user asks about an instrument, say what data is missing.\n"
         "- Keep the coding boundary enforced.\n"
     )
+
+
+def build_web_research_answer_prompt(user_prompt: str, web_context: str) -> str:
+    """Build a prompt that turns gathered web context into an answer, not a source dump."""
+    context = web_context.strip() or "Web Research: no public web context returned."
+    return (
+        f"{FINCLI_ASSISTANT_SYSTEM_PROMPT}\n\n"
+        "Web Search Skill Result:\n"
+        f"{context}\n\n"
+        "User Prompt:\n"
+        f"{user_prompt.strip()}\n\n"
+        "Instruction:\n"
+        "- You already have web search context above. Do not answer by only listing articles or links.\n"
+        "- Synthesize the sources into a useful explanation/summary for the user.\n"
+        "- Prioritize facts found in the web context, then clearly label interpretation.\n"
+        "- If sources disagree or are thin, say that the evidence is limited.\n"
+        "- Use this output structure when relevant:\n"
+        "  1. Ringkasan singkat\n"
+        "  2. Poin utama/penyebab\n"
+        "  3. Dampak atau implikasi\n"
+        "  4. Risiko dan hal yang perlu diverifikasi\n"
+        "  5. Sumber singkat\n"
+        "- Keep source citations compact: source title or URL only where useful.\n"
+        "- Do not provide financial advice or certainty about market direction.\n"
+    )

package/fincli/app/analysis/indicators.py

@@ -26,7 +26,7 @@ class TechnicalSummary:
 
 
 def phase_one_indicator_status() -> str:
-    return "Indicator engine scaffold ready. pandas/numpy/yfinance integration planned for Phase 2."
+    return "Indicator engine active: SMA, EMA, RSI, MACD, Bollinger Bands, ATR, volume, support, and resistance."
 
 
 def summarize_technical_indicators(candles: list[Candle]) -> TechnicalSummary:

package/fincli/app/analysis/market_structure.py

@@ -20,7 +20,7 @@ class MarketStructureSummary:
 
 
 def phase_one_structure_status() -> str:
-    return "Market structure scaffold ready. HH/HL/LH/LL detection planned for Phase 2."
+    return "Market structure engine active: HH/HL/LH/LL, BOS, CHoCH, liquidity area, and risk zone."
 
 
 def analyze_market_structure(candles: list[Candle], lookback: int = 20) -> MarketStructureSummary:

package/fincli/app/cli/commands.py

@@ -17,9 +17,13 @@ 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("/market", "Ringkasan market profesional untuk instrumen.", "/market AAPL 1d", "Market"),
     CommandSpec("/news", "Tampilkan news/fundamental terbaru untuk instrumen.", "/news AAPL", "Market"),
+    CommandSpec("/web", "Web search lalu AI merangkum jawaban.", "/web penyebab rupiah melemah hari ini", "Research"),
+    CommandSpec("/web sources", "Tampilkan sumber mentah hasil web search.", "/web sources penyebab rupiah melemah hari ini", "Research"),
     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"),
@@ -39,9 +43,13 @@ COMMANDS: tuple[CommandSpec, ...] = (
     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("/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("/price", "Tampilkan harga instrumen.", "/price NVDA", "Market"),
-    CommandSpec("/quote", "Alias harga/quote instrumen.", "/quote NVDA", "Market"),
+    CommandSpec("/quote", "Tampilkan harga/quote instrumen.", "/quote NVDA", "Market"),
     CommandSpec("/scan", "Scanner watchlist dengan filter indikator.", "/scan watchlist rsi<30", "Market"),
     CommandSpec("/calendar", "Economic calendar provider/fallback.", "/calendar week US high", "Market"),
     CommandSpec("/provider status", "Tampilkan status provider aktif.", "/provider status", "Provider"),
@@ -50,8 +58,8 @@ COMMANDS: tuple[CommandSpec, ...] = (
     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("/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"),
 )