feat(cli): add --min-level threshold filter

Add --min-level/-m option to filter logs by minimum severity threshold.
This allows users to show logs at or above a given level (e.g., --min-level WARN
shows WARN, ERROR, CRITICAL, ALERT, FATAL).

- Add LEVEL_ORDER mapping for severity comparison
- Add line_passes_min_level() function
- Update line_passes_filters() to include min_level parameter
- Add CLI option with short flag -m
- Add comprehensive tests for min_level filtering

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: vinnytherobot

.claude/settings.local.json

@@ -5,7 +5,10 @@
       "Bash(python:*)",
       "Bash(git add:*)",
       "Bash(git commit:*)",
-      "Bash(git reset:*)"
+      "Bash(git reset:*)",
+      "Bash(pip list:*)",
+      "Bash(pytest -q)",
+      "Bash(ruff check:*)"
     ]
   }
 }

logscope/cli.py

@@ -88,6 +88,7 @@ def main(
     log_file: Annotated[Optional[Path], typer.Argument(help="Path to the log file (leave empty to read from STDIN via pipe)")] = None,
     follow: Annotated[bool, typer.Option("--follow", "-f", help="Follow log output in real-time (like tail -f)")] = False,
     level: Annotated[Optional[str], typer.Option("--level", "-l", help="Filter by level; comma-separated for multiple (e.g. ERROR,WARN,INFO)")] = None,
+    min_level: Annotated[Optional[str], typer.Option("--min-level", "-m", help="Show logs at or above this level threshold (e.g. WARN shows WARN, ERROR, CRITICAL, ALERT, FATAL)")] = None,
     search: Annotated[Optional[str], typer.Option("--search", "-s", help="Search string to filter logs (substring unless --regex)")] = None,
     dashboard: Annotated[bool, typer.Option("--dashboard", "-d", help="Open visual dashboard showing log statistics")] = False,
     export_html: Annotated[Optional[Path], typer.Option("--export-html", help="Export the beautiful log output to an HTML file")] = None,
@@ -158,6 +159,7 @@ def main(
                 invert_match=invert_match,
                 highlight=highlight,
                 highlight_color=highlight_color,
+                min_level=min_level,
             )
         else:
             stream_logs(
@@ -175,6 +177,7 @@ def main(
                 invert_match=invert_match,
                 highlight=highlight,
                 highlight_color=highlight_color,
+                min_level=min_level,
             )
     finally:
         if log_file is not None:

logscope/viewer.py

@@ -16,6 +16,21 @@
 from .parser import parse_line, LogEntry, _normalize_level
 from .themes import DEFAULT_THEMES
 
+# Level severity order (lowest to highest)
+# Used for --min-level threshold filtering
+LEVEL_ORDER = {
+    "TRACE": 0,
+    "DEBUG": 1,
+    "INFO": 2,
+    "NOTICE": 3,
+    "WARN": 4,
+    "ERROR": 5,
+    "CRITICAL": 6,
+    "ALERT": 7,
+    "FATAL": 8,
+    "UNKNOWN": 0,  # Treat as lowest
+}
+
 if sys.platform == "win32" and hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(encoding="utf-8")
 
@@ -116,6 +131,15 @@ def line_passes_level(entry_level: str, allowed: Optional[Set[str]]) -> bool:
     return entry_level in allowed
 
 
+def line_passes_min_level(entry_level: str, min_level: Optional[str]) -> bool:
+    """Check if entry level meets minimum severity threshold."""
+    if not min_level:
+        return True
+    entry_severity = LEVEL_ORDER.get(entry_level, 0)
+    min_severity = LEVEL_ORDER.get(_normalize_level(min_level), 0)
+    return entry_severity >= min_severity
+
+
 def line_passes_search(
     line: str,
     search: Optional[str],
@@ -149,10 +173,13 @@ def line_passes_filters(
     use_regex: bool,
     case_sensitive: bool,
     invert_match: bool,
+    min_level: Optional[str] = None,
 ) -> bool:
-    """Check if an entry passes all filters (level, search, timestamp)."""
+    """Check if an entry passes all filters (level, min_level, search, timestamp)."""
     if not line_passes_level(entry.level, level_set):
         return False
+    if not line_passes_min_level(entry.level, min_level):
+        return False
     if not line_passes_search(
         entry.raw,
         search,
@@ -213,6 +240,7 @@ def stream_logs(
     invert_match: bool = False,
     highlight: Optional[str] = None,
     highlight_color: str = "bold magenta",
+    min_level: Optional[str] = None,
 ):
     """Basic console mode: prints directly to stdout, supporting tails."""
     if export_html:
@@ -236,6 +264,7 @@ def stream_logs(
                 use_regex=use_regex,
                 case_sensitive=case_sensitive,
                 invert_match=invert_match,
+                min_level=min_level,
             ):
                 continue
 
@@ -268,6 +297,7 @@ def run_dashboard(
     invert_match: bool = False,
     highlight: Optional[str] = None,
     highlight_color: str = "bold magenta",
+    min_level: Optional[str] = None,
 ):
     """Dashboard mode: Shows a summary stats panel and recent logs layout."""
 
@@ -347,6 +377,7 @@ def generate_layout() -> Layout:
                     use_regex=use_regex,
                     case_sensitive=case_sensitive,
                     invert_match=invert_match,
+                    min_level=min_level,
                 ):
                     continue
 

tests/test_filters.py

@@ -1,7 +1,7 @@
 import re
 from datetime import datetime, timedelta
 
-from logscope.viewer import line_passes_level, line_passes_search, parse_level_filter, line_passes_filters
+from logscope.viewer import line_passes_level, line_passes_search, parse_level_filter, line_passes_filters, line_passes_min_level
 from logscope.parser import LogEntry
 
 
@@ -121,3 +121,49 @@ def test_line_passes_filters_exact_boundary():
 
     # Exact until should pass (inclusive)
     assert line_passes_filters(entry, None, None, None, entry_time, pattern=None, use_regex=False, case_sensitive=False, invert_match=False) is True
+
+
+def test_line_passes_min_level_threshold():
+    """Test --min-level threshold filtering."""
+    # TRACE is lowest, FATAL is highest
+    assert line_passes_min_level("TRACE", None) is True
+    assert line_passes_min_level("TRACE", "TRACE") is True
+    assert line_passes_min_level("TRACE", "DEBUG") is False
+    assert line_passes_min_level("ERROR", "WARN") is True
+    assert line_passes_min_level("ERROR", "ERROR") is True
+    assert line_passes_min_level("ERROR", "CRITICAL") is False
+    assert line_passes_min_level("FATAL", "ERROR") is True
+    assert line_passes_min_level("FATAL", "FATAL") is True
+    assert line_passes_min_level("INFO", "DEBUG") is True
+
+
+def test_line_passes_min_level_unknown_level():
+    """Test that UNKNOWN level is treated as lowest severity (same as TRACE)."""
+    assert line_passes_min_level("UNKNOWN", None) is True
+    # UNKNOWN has same severity as TRACE (0), so it passes TRACE threshold
+    assert line_passes_min_level("UNKNOWN", "TRACE") is True
+    # But fails higher thresholds
+    assert line_passes_min_level("UNKNOWN", "DEBUG") is False
+    assert line_passes_min_level("UNKNOWN", "INFO") is False
+
+
+def test_line_passes_min_level_case_insensitive():
+    """Test that min_level comparison is case-insensitive."""
+    assert line_passes_min_level("ERROR", "error") is True
+    assert line_passes_min_level("ERROR", "WaRn") is True
+    assert line_passes_min_level("INFO", "DEBUG") is True
+
+
+def test_line_passes_filters_with_min_level():
+    """Test --min-level combined with other filters."""
+    entry = make_entry(datetime(2026, 4, 5, 10, 0, 0), level="ERROR", message="error message")
+
+    # Combined with level filter - ERROR passes both ERROR level set and min_level WARN
+    assert line_passes_filters(entry, {"ERROR"}, None, None, None, pattern=None, use_regex=False, case_sensitive=False, invert_match=False, min_level="WARN") is True
+
+    # ERROR doesn't pass level filter for INFO only
+    assert line_passes_filters(entry, {"INFO"}, None, None, None, pattern=None, use_regex=False, case_sensitive=False, invert_match=False, min_level=None) is False
+
+    # Combined with time filter
+    since = datetime(2026, 4, 5, 9, 0, 0)
+    assert line_passes_filters(entry, None, None, since, None, pattern=None, use_regex=False, case_sensitive=False, invert_match=False, min_level="WARN") is True