Feature/gemini support and cli ux

.gitignore

@@ -107,3 +107,8 @@ credentials.json
 
 # LangGraph API server
 .langgraph_api/
+
+# Reports (generated artifacts only — anchored to repo root)
+/report*.md
+/report*.json
+/report*.sarif

README.md

@@ -205,6 +205,13 @@ export SKILLSPECTOR_PROVIDER=nv_build
 export NVIDIA_INFERENCE_KEY=nvapi-...
 skillspector scan ./my-skill/
 
+# Gemini (via OpenAI compatibility layer)
+export SKILLSPECTOR_PROVIDER=openai
+export OPENAI_API_KEY="YOUR_GEMINI_API_KEY"
+export OPENAI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai/"
+export SKILLSPECTOR_MODEL=gemini-3.5-flash
+skillspector scan ./my-skill/
+
 # Local Ollama or any OpenAI-compatible endpoint
 export SKILLSPECTOR_PROVIDER=openai
 export OPENAI_API_KEY=ollama

model_registry.yaml

@@ -40,3 +40,7 @@ models:
   "openai/openai/gpt-5.3-chat":
     context_length: 128000
     max_output_tokens: 16384
+
+  "gemini-3.5-flash":
+    context_length: 1048576
+    max_output_tokens: 8192

src/skillspector/cli.py

@@ -24,6 +24,7 @@
 import json
 import os
 import shutil
+import warnings
 import sys
 from enum import StrEnum
 from pathlib import Path
@@ -32,11 +33,14 @@
 import typer
 from langchain_core.runnables import RunnableConfig
 from rich.console import Console
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
+from rich.tree import Tree
 
 from skillspector import __version__
 from skillspector.graph import graph
 from skillspector.logging_config import get_logger, set_level
 from skillspector.multi_skill import MultiSkillDetectionResult, detect_skills
+from skillspector.nodes.analyzers import ANALYZER_NODE_IDS
 from skillspector.suppression import build_baseline_dict, dump_baseline, load_baseline
 
 logger = get_logger(__name__)
@@ -316,7 +320,80 @@ def scan(
             not no_llm,
         )
         trace_config = _build_trace_config(input_path, format, no_llm)
-        result = graph.invoke(state, config=trace_config)
+        if verbose:
+            result = graph.invoke(state, config=trace_config)
+        else:
+            total_steps = 4 + len(ANALYZER_NODE_IDS)
+            result = dict(state)
+
+            # Use stderr for progress so stdout remains clean for structured outputs
+            err_console = Console(stderr=True)
+
+            # Suppress noisy Pydantic serialization warnings scoped to the graph run
+            with warnings.catch_warnings(), Progress(
+                SpinnerColumn(),
+                TextColumn("[progress.description]{task.description}"),
+                BarColumn(),
+                TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+                TimeElapsedColumn(),
+                console=err_console,
+                transient=True,
+            ) as progress:
+                warnings.filterwarnings("ignore", category=UserWarning, module="pydantic")
+                task_id = progress.add_task("Resolving input...", total=total_steps)
+
+                num_files = 0
+                analyzers_done = 0
+                total_analyzers = len(ANALYZER_NODE_IDS)
+
+                for update in graph.stream(state, config=trace_config, stream_mode="updates"):
+                    for node_name, node_output in update.items():
+                        progress.advance(task_id)
+
+                        # Accumulate scalar outputs needed by the CLI (report_body, risk_score, temp_dir, sarif_report)
+                        if "temp_dir_for_cleanup" in node_output:
+                            result["temp_dir_for_cleanup"] = node_output["temp_dir_for_cleanup"]
+                        if "report_body" in node_output:
+                            result["report_body"] = node_output["report_body"]
+                        if "sarif_report" in node_output:
+                            result["sarif_report"] = node_output["sarif_report"]
+                        if "risk_score" in node_output:
+                            result["risk_score"] = node_output["risk_score"]
+
+                        # Update UI text based on graph progression
+                        if node_name == "resolve_input":
+                            progress.update(task_id, description="Building context...")
+                        elif node_name == "build_context":
+                            components = node_output.get("components", [])
+                            num_files = len(components)
+                            progress.update(task_id, description=f"Analyzing {num_files} files (0/{total_analyzers} rules applied)...")
+
+                            # Print a proper report of the files and directories being scanned
+                            tree = Tree("[bold blue]Discovered Files to Scan[/bold blue]")
+                            nodes = {"": tree}
+                            for path in sorted(components):
+                                parts = Path(path).parts
+                                current = ""
+                                for part in parts:
+                                    parent = current
+                                    current = f"{current}/{part}" if current else part
+                                    if current not in nodes:
+                                        is_file = current == path
+                                        icon = "📄 " if is_file else "📁 "
+                                        style = "green" if is_file else "cyan"
+                                        nodes[current] = nodes[parent].add(f"[{style}]{icon}{part}[/{style}]")
+
+                            err_console.print(tree)
+                            err_console.print()
+
+                        elif node_name in ANALYZER_NODE_IDS:
+                            analyzers_done += 1
+                            progress.update(task_id, description=f"Analyzing {num_files} files ({analyzers_done}/{total_analyzers} rules applied)...")
+                            # Print which rule just finished above the progress bar
+                            err_console.print(f"[dim]✔ Rule completed: {node_name}[/dim]")
+                        elif node_name == "meta_analyzer":
+                            progress.update(task_id, description="Generating report...")
+                            err_console.print("[dim]✔ Rule completed: meta_analyzer (filtering findings)[/dim]")
 
         _write_result(result, output, format)
 

src/skillspector/providers/openai/model_registry.yaml

@@ -12,3 +12,7 @@ models:
   "gpt-5.4":
     context_length: 1000000
     max_output_tokens: 128000
+
+  "gemini-3.5-flash":
+    context_length: 1048576
+    max_output_tokens: 8192