@drico2008/fincli 0.3.1 → 0.4.0

package/fincli/app/diagnostics/__init__.py

@@ -0,0 +1,2 @@
+"""Runtime diagnostics for FinCLI."""
+

package/fincli/app/diagnostics/capabilities.py

@@ -0,0 +1,44 @@
+"""Command capability matrix for provider/data reliability diagnostics."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class CommandCapability:
+    command: str
+    needs: tuple[str, ...]
+    provider_dependent: bool
+    note: str
+
+
+COMMAND_CAPABILITIES: tuple[CommandCapability, ...] = (
+    CommandCapability("/research", ("quote", "history", "news", "fundamentals", "ai_optional"), True, "Research center combines all available data."),
+    CommandCapability("/market", ("quote", "history", "news", "fundamentals"), True, "Market overview requires quote and OHLCV; news/fundamentals may be partial."),
+    CommandCapability("/news", ("news",), True, "Uses news connector priority and RSS/API fallbacks."),
+    CommandCapability("/technical", ("history",), True, "Needs OHLCV candles for indicators and signal scoring."),
+    CommandCapability("/structure", ("history",), True, "Needs OHLCV candles for market structure."),
+    CommandCapability("/mtf", ("history",), True, "Needs history across requested intervals."),
+    CommandCapability("/analyze", ("quote", "history", "news", "fundamentals", "ai"), True, "AI analysis is grounded on provider data quality."),
+    CommandCapability("/calendar", ("calendar",), True, "Finnhub/public calendar may degrade to schedule-only fallback."),
+    CommandCapability("/quote", ("quote",), True, "Fast quote check."),
+    CommandCapability("/funda", ("fundamentals",), True, "Fundamental snapshot coverage varies by symbol/provider."),
+    CommandCapability("/yahoo", ("yahoo_table",), True, "Yahoo table sections are provider-specific."),
+    CommandCapability("/scan", ("watchlist", "history"), True, "Scanner needs watchlist symbols and candles."),
+    CommandCapability("/provider test", ("quote",), True, "Live provider smoke check for one symbol."),
+    CommandCapability("/web", ("public_web",), True, "Public web search depends on connectivity/search availability."),
+    CommandCapability("/ai", ("ai", "market_context_optional", "web_context_optional"), True, "Free chat can use market/web context when detected."),
+    CommandCapability("/portfolio risk", ("portfolio", "quote_optional"), True, "Local positions plus quote when available."),
+    CommandCapability("/journal review", ("journal", "ai"), True, "Journal analytics plus AI provider."),
+)
+
+
+def capability_rows() -> list[CommandCapability]:
+    return list(COMMAND_CAPABILITIES)
+
+
+def capability_summary() -> str:
+    provider_commands = sum(1 for item in COMMAND_CAPABILITIES if item.provider_dependent)
+    unique_needs = sorted({need for item in COMMAND_CAPABILITIES for need in item.needs})
+    return f"{len(COMMAND_CAPABILITIES)} command profile(s); provider-dependent={provider_commands}; needs={', '.join(unique_needs)}"

package/fincli/app/diagnostics/runtime.py

@@ -0,0 +1,106 @@
+"""Runtime environment checks used by /doctor and startup guards."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from importlib import metadata, util
+from pathlib import Path
+import platform
+import sys
+
+from fincli import __version__
+
+
+@dataclass(frozen=True, slots=True)
+class RuntimeCheck:
+    """Single display-safe runtime diagnostic result."""
+
+    name: str
+    status: str
+    detail: str
+
+
+REQUIRED_MODULES: tuple[tuple[str, str], ...] = (
+    ("textual", "Textual TUI runtime"),
+    ("rich", "terminal rendering"),
+    ("httpx", "HTTP client"),
+    ("pydantic", "data validation"),
+    ("yfinance", "Yahoo Finance fallback"),
+    ("pandas", "tabular market data"),
+    ("numpy", "technical calculations"),
+)
+
+
+def check_runtime_environment() -> list[RuntimeCheck]:
+    """Return launch-critical checks without exposing local secrets."""
+
+    checks = [
+        _python_version_check(),
+        _package_version_check(),
+        _npm_runtime_check(),
+    ]
+    checks.extend(_dependency_checks())
+    checks.append(_user_config_dir_check())
+    return checks
+
+
+def startup_dependency_error(exc: ImportError) -> str:
+    """Build a friendly startup message when a runtime dependency is missing."""
+
+    missing = getattr(exc, "name", None) or "unknown"
+    return (
+        f"FinCLI gagal memuat dependency Python: {missing}\n\n"
+        "Fix cepat:\n"
+        "- npm global: npm install -g @drico2008/fincli@latest --registry=https://registry.npmjs.org/\n"
+        "- local dev : pip install -e \".[dev]\"\n\n"
+        "Jika memakai npm global dan error tetap muncul, hapus install lama lalu install ulang:\n"
+        "npm uninstall -g @drico2008/fincli && npm install -g @drico2008/fincli@latest"
+    )
+
+
+def _python_version_check() -> RuntimeCheck:
+    version = platform.python_version()
+    if sys.version_info >= (3, 11):
+        return RuntimeCheck("Python", "ok", f"{version} ({sys.executable})")
+    return RuntimeCheck("Python", "error", f"{version}; FinCLI requires Python 3.11+")
+
+
+def _package_version_check() -> RuntimeCheck:
+    try:
+        installed = metadata.version("fincli")
+    except metadata.PackageNotFoundError:
+        return RuntimeCheck("Package Metadata", "warning", f"source import version={__version__}; package metadata not installed")
+    if installed == __version__:
+        return RuntimeCheck("Package Metadata", "ok", f"fincli {installed}")
+    return RuntimeCheck("Package Metadata", "warning", f"package={installed}; import={__version__}")
+
+
+def _dependency_checks() -> list[RuntimeCheck]:
+    checks: list[RuntimeCheck] = []
+    for module_name, purpose in REQUIRED_MODULES:
+        if util.find_spec(module_name) is None:
+            checks.append(RuntimeCheck(f"Dependency:{module_name}", "error", f"missing; required for {purpose}"))
+        else:
+            checks.append(RuntimeCheck(f"Dependency:{module_name}", "ok", purpose))
+    return checks
+
+
+def _npm_runtime_check() -> RuntimeCheck:
+    executable = Path(sys.executable)
+    if ".npm-python" not in {part.lower() for part in executable.parts}:
+        return RuntimeCheck("npm Runtime", "info", "not running inside npm wrapper venv")
+    if executable.exists():
+        return RuntimeCheck("npm Runtime", "ok", str(executable))
+    return RuntimeCheck("npm Runtime", "error", f"missing python executable: {executable}")
+
+
+def _user_config_dir_check() -> RuntimeCheck:
+    config_dir = Path.home() / ".fincli"
+    try:
+        config_dir.mkdir(parents=True, exist_ok=True)
+        probe = config_dir / ".doctor-write-test"
+        probe.write_text("ok", encoding="utf-8")
+        probe.unlink(missing_ok=True)
+    except OSError as exc:
+        return RuntimeCheck("User Config Dir", "error", f"{config_dir}: {exc}")
+    return RuntimeCheck("User Config Dir", "ok", str(config_dir))

package/fincli/app/main.py

@@ -2,13 +2,18 @@
 
 from __future__ import annotations
 
-from fincli.app.tui.layout import FinCLIApp
 from fincli.app.utils.logger import configure_logging
+from fincli.app.diagnostics.runtime import startup_dependency_error
 
 
 def main() -> None:
     """Run the FinCLI TUI application."""
     configure_logging()
+    try:
+        from fincli.app.tui.layout import FinCLIApp
+    except ImportError as exc:
+        print(startup_dependency_error(exc))
+        raise SystemExit(1) from exc
     FinCLIApp().run()