logler 1.1.0__tar.gz → 1.1.3__tar.gz

{logler-1.1.0 → logler-1.1.3}/Cargo.lock

@@ -253,9 +253,9 @@ checksum = "37b2a672a2cb129a2e41c10b1224bb368f9f37a2b16b612598138befd7b37eb5"
 
 [[package]]
 name = "cc"
-version = "1.2.53"
+version = "1.2.54"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "755d2fce177175ffca841e9a06afdb2c4ab0f593d53b4dee48147dfaade85932"
+checksum = "6354c81bbfd62d9cfa9cb3c773c2b7b2a3a482d569de977fd0e961f6e7c00583"
 dependencies = [
  "find-msvc-tools",
  "shlex",
@@ -520,14 +520,13 @@ checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be"
 
 [[package]]
 name = "filetime"
-version = "0.2.26"
+version = "0.2.27"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc0505cd1b6fa6580283f6bdf70a73fcf4aba1184038c90902b92b3dd0df63ed"
+checksum = "f98844151eee8917efc50bd9e8318cb963ae8b297431495d3f758616ea5c57db"
 dependencies = [
  "cfg-if",
  "libc",
  "libredox",
- "windows-sys 0.60.2",
 ]
 
 [[package]]
@@ -954,7 +953,7 @@ checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897"
 
 [[package]]
 name = "logler-cli"
-version = "1.1.0"
+version = "1.1.3"
 dependencies = [
  "anyhow",
  "clap",
@@ -969,7 +968,7 @@ dependencies = [
 
 [[package]]
 name = "logler-core"
-version = "1.1.0"
+version = "1.1.3"
 dependencies = [
  "anyhow",
  "async-stream",
@@ -984,7 +983,7 @@ dependencies = [
  "serde",
  "serde_json",
  "tempfile",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
  "tokio",
  "tokio-stream",
  "tracing",
@@ -993,7 +992,7 @@ dependencies = [
 
 [[package]]
 name = "logler-py"
-version = "1.1.0"
+version = "1.1.3"
 dependencies = [
  "anyhow",
  "logler-core",
@@ -1005,7 +1004,7 @@ dependencies = [
 
 [[package]]
 name = "logler-server"
-version = "1.1.0"
+version = "1.1.3"
 dependencies = [
  "anyhow",
  "axum",
@@ -1016,7 +1015,7 @@ dependencies = [
  "notify",
  "serde",
  "serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
  "tokio",
  "tower-http",
  "tracing",
@@ -1233,9 +1232,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.105"
+version = "1.0.106"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "535d180e0ecab6268a3e718bb9fd44db66bbbc256257165fc699dadf70d16fe7"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
 dependencies = [
  "unicode-ident",
 ]
@@ -1307,9 +1306,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.43"
+version = "1.0.44"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc74d9a594b72ae6656596548f56f667211f8a97b3d4c3d467150794690dc40a"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
 dependencies = [
  "proc-macro2",
 ]
@@ -1573,9 +1572,9 @@ checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
 
 [[package]]
 name = "socket2"
-version = "0.6.1"
+version = "0.6.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17129e116933cf371d018bb80ae557e889637989d8638274fb25622827b03881"
+checksum = "86f4aa3ad99f2088c990dfa82d367e19cb29268ed67c574d10d0a4bfe71f07e0"
 dependencies = [
  "libc",
  "windows-sys 0.60.2",
@@ -1634,11 +1633,11 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "2.0.17"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f63587ca0f12b72a0600bcba1d40081f830876000bb46dd2337a3051618f4fc8"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
 dependencies = [
- "thiserror-impl 2.0.17",
+ "thiserror-impl 2.0.18",
 ]
 
 [[package]]
@@ -1654,9 +1653,9 @@ dependencies = [
 
 [[package]]
 name = "thiserror-impl"
-version = "2.0.17"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ff15c8ecd7de3849db632e14d18d2571fa09dfc5ed93479bc4485c7a517c913"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1889,9 +1888,9 @@ checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
 
 [[package]]
 name = "uuid"
-version = "1.19.0"
+version = "1.20.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e2e054861b4bd027cd373e18e8d8d8e6548085000e41290d95ce0c373a654b4a"
+checksum = "ee48d38b119b0cd71fe4141b30f5ba9c7c5d9f4e7a3a8b4a674e4b6ef789976f"
 dependencies = [
  "getrandom 0.3.4",
  "js-sys",
@@ -2236,6 +2235,6 @@ dependencies = [
 
 [[package]]
 name = "zmij"
-version = "1.0.14"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd8f3f50b848df28f887acb68e41201b5aea6bc8a8dacc00fb40635ff9a72fea"
+checksum = "dfcd145825aace48cff44a8844de64bf75feec3080e0aa5cdbde72961ae51a65"

{logler-1.1.0 → logler-1.1.3}/Cargo.toml

@@ -3,7 +3,7 @@ members = ["crates/logler-py"]
 resolver = "2"
 
 [workspace.package]
-version = "1.1.0"
+version = "1.1.3"
 edition = "2021"
 authors = ["Logler Contributors"]
 license = "MIT"

{logler-1.1.0 → logler-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logler
-Version: 1.1.0
+Version: 1.1.3
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -15,9 +15,10 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: watchdog>=4.0.0
 Requires-Dist: click>=8.1.0
 Requires-Dist: duckdb>=1.0
+Requires-Dist: pydantic>=2.0
 Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0 ; extra == 'dev'
-Requires-Dist: black>=24.0.0 ; extra == 'dev'
+Requires-Dist: black>=25.0.0 ; extra == 'dev'
 Requires-Dist: ruff>=0.3.0 ; extra == 'dev'
 Requires-Dist: httpx>=0.28.0 ; extra == 'dev'
 Requires-Dist: maturin>=1.10.0 ; extra == 'dev'
@@ -50,20 +51,18 @@ Project-URL: Repository, https://github.com/gabu-quest/logler
 [![Platform](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey)](https://pypi.org/project/logler/)
 [![GitHub stars](https://img.shields.io/github/stars/gabu-quest/logler?style=social)](https://github.com/gabu-quest/logler)
 
-A modern, feature-rich log viewer that makes debugging a pleasure. View logs in your terminal with beautiful colors or start a web interface with WebSocket support for real-time updates.
+A modern, feature-rich log viewer that makes debugging a pleasure. View logs in your terminal with beautiful colors, or use [logler-web](https://github.com/gabu-quest/logler-web) for a modern web interface.
 
 ## ✨ Features
 
 - 🎨 **Beautiful Terminal Output** - Rich colors and formatting with thread visualization
-- 🌐 **Gorgeous Web UI** - Modern interface with file picker and live updates
 - 🧵 **Thread Tracking** - Follow execution flow across log entries
 - 🔗 **Correlation IDs** - Track requests across microservices
 - 📊 **Distributed Tracing** - OpenTelemetry span/trace support
-- ⚡ **Real-time Streaming** - WebSocket support for live log following
 - 🔍 **Smart Filtering** - By level, thread, pattern, or correlation ID
 - 📝 **Multi-Format Support** - JSON, plain text, syslog, and more
-- 📂 **File Picker** - Browse and select log files from the UI
 - 🎯 **Zero Config** - Works out of the box
+- 🌐 **Web UI Available** - See [logler-web](https://github.com/gabu-quest/logler-web) for Vue3 + Naive-UI interface
 
 ## 🤖 NEW: LLM Investigation Engine
 
@@ -93,75 +92,116 @@ A modern, feature-rich log viewer that makes debugging a pleasure. View logs in
 - 🤔 **Explain Feature** - Plain English explanations of cryptic errors with next steps
 - 💬 **Contextual Suggestions** - AI suggests what to investigate next based on findings
 
+### Public API Contract
+
+Each code block carries a **Contract ID** (e.g., `[C01]`). The test suite in `tests/test_readme.py` executes these snippets against the documented public APIs. When this section changes, the tests must change with it — CI proves the README.
+
+#### [C01] Auto-insights analysis
 ```python
 import logler.investigate as investigate
 
-# 🎯 One-line auto investigation with insights
 result = investigate.analyze_with_insights(files=["app.log"])
 print(result['insights'])  # Automatic pattern detection, error analysis, suggestions
+```
+
+#### [C02] Token-efficient search
+```python
+import logler.investigate as investigate
 
-# 📉 Token-efficient search (44x smaller output)
 errors = investigate.search(files=["app.log"], level="ERROR", output_format="summary")
 # Returns aggregated stats instead of all entries - perfect for limited context windows
+```
+
+#### [C03] Compare threads
+```python
+import logler.investigate as investigate
 
-# 🔀 Compare successful vs failed requests
 diff = investigate.compare_threads(
     files=["app.log"],
     correlation_a="req-success-123",
     correlation_b="req-failed-456"
 )
-print(diff['summary'])  # "Thread B took 2341ms longer and had 5 errors (cache miss, timeout)"
+print(diff['summary'])  # Comparison of two request flows
+```
+
+#### [C04] Cross-service timeline
+```python
+import logler.investigate as investigate
 
-# 🌐 Cross-service distributed tracing
 timeline = investigate.cross_service_timeline(
     files={"api": ["api.log"], "db": ["db.log"], "cache": ["cache.log"]},
     correlation_id="req-12345"
 )
 # See request flow: API → DB → Cache with latency breakdown
+```
+
+#### [C05] Investigation sessions
+```python
+import logler.investigate as investigate
 
-# 📝 Track investigation with sessions
 session = investigate.InvestigationSession(files=["app.log"], name="incident_2024")
 session.search(level="ERROR")
 session.find_patterns()
 session.add_note("Database connection pool exhausted")
 report = session.generate_report(format="markdown")  # Auto-generate report
+```
+
+#### [C06] Smart sampling
+```python
+import logler.investigate as investigate
 
-# 🎯 Smart sampling (representative sample of huge logs)
 sample = investigate.smart_sample(
     files=["huge.log"],
     strategy="errors_focused",  # or "diverse", "representative", "chronological"
     sample_size=50
 )
+```
+
+#### [C07] Error explanation
+```python
+import logler.investigate as investigate
 
-# 🤔 Explain cryptic errors in plain English
 explanation = investigate.explain(error_message="Connection pool exhausted", context="production")
 print(explanation)  # Common causes, next steps, production-specific advice
+```
+
+#### [C08] Thread hierarchy
+```python
+import logler.investigate as investigate
 
-# 🌳 Hierarchical thread visualization (NEW!)
 hierarchy = investigate.follow_thread_hierarchy(
     files=["app.log"],
     root_identifier="req-123",
     min_confidence=0.8  # Only show high-confidence relationships
 )
-
 # Automatic bottleneck detection
-if hierarchy['bottleneck']:
+if hierarchy.get('bottleneck'):
     print(f"Bottleneck: {hierarchy['bottleneck']['node_id']} took {hierarchy['bottleneck']['duration_ms']}ms")
+```
 
-# Get summary
+#### [C09] Hierarchy summary
+```python
+import logler.investigate as investigate
+
+# Using hierarchy from [C08]
 summary = investigate.get_hierarchy_summary(hierarchy)
 print(summary)  # Shows tree structure, errors, bottlenecks
+```
 
-# Visualize in CLI
+#### [C10] Tree visualization
+```python
 from logler.tree_formatter import print_tree, print_waterfall
+
+# Using hierarchy from [C08]
 print_tree(hierarchy, mode="detailed", show_duration=True)
-print_waterfall(hierarchy, width=100)  # Waterfall timeline showing parallel operations
+print_waterfall(hierarchy, width=100)  # Waterfall timeline
 ```
 
 **📚 Complete LLM documentation:**
-- [English Guide](docs/LLM_README.md) - Complete API and examples
+- [LLM CLI Reference](docs/LLM_CLI_REFERENCE.md) - All 16 CLI commands for AI agents
+- [Python API Guide](docs/LLM_README.md) - Library API and examples
+- [API Reference](docs/LLM_INVESTIGATION_API.md) - All investigation functions
 - [日本語ガイド](README.ja.md) - 完全なドキュメント
-- [API Reference](docs/LLM_INVESTIGATION_API.md) - All investigation tools
 - [Examples](examples/) - Production incident investigations
 
 ## 🚀 Quick Start
@@ -178,21 +218,6 @@ uv pip install logler
 
 ### Usage
 
-**Start the web interface:**
-```bash
-logler serve                    # Start with file picker
-logler serve app.log            # Open specific file
-logler serve *.log              # Open multiple files
-logler serve --open             # Auto-open browser
-```
-
-### Security and path restrictions
-
-- The legacy Python web UI now enforces a **log root** to avoid accidental exposure of arbitrary files. Set `LOGLER_ROOT` to
-  the directory you want to browse (defaults to the current working directory). Requests outside that root are rejected.
-- For production or remote access, place the service behind authentication/reverse proxies; the built-in UI is intended for
-  local or trusted environments only.
-
 **View logs in terminal:**
 ```bash
 logler view app.log                      # View entire file
@@ -216,16 +241,48 @@ logler investigate app.log --errors               # Analyze errors
 logler investigate app.log --patterns             # Find repeated patterns
 logler investigate app.log --thread worker-1      # Follow specific thread
 logler investigate app.log --correlation req-123  # Follow correlation ID
+logler investigate app.log --trace trace-abc123   # Follow distributed trace
 logler investigate app.log --output summary       # Token-efficient output
 
 # 🌳 NEW: Hierarchical Thread Visualization
 logler investigate app.log --correlation req-123 --hierarchy         # Show thread hierarchy tree
-logler investigate app.log --correlation trace-abc123 --hierarchy --waterfall  # Show waterfall timeline
+logler investigate app.log --trace trace-abc123 --hierarchy --waterfall        # Show waterfall timeline
 logler investigate app.log --correlation req-123 --hierarchy --flamegraph # Show flamegraph view
 logler investigate app.log --hierarchy --show-error-flow             # Analyze error propagation
 logler investigate app.log --thread worker-1 --hierarchy --max-depth 3   # Limit hierarchy depth
 ```
 
+**LLM-first CLI (JSON output by default):**
+
+Designed for AI agents - 16 commands with structured JSON output, no truncation.
+
+```bash
+# Assessment & Overview
+logler llm triage app.log --last 1h      # Quick severity assessment
+logler llm summarize app.log             # Concise summary with stats
+logler llm schema app.log                # Infer log structure
+
+# Search & Analysis
+logler llm search app.log --level ERROR  # Find entries (full results)
+logler llm sql "SELECT level, COUNT(*) FROM logs GROUP BY level" -f app.log
+
+# Request Tracing
+logler llm correlate req-123 --files "*.log"   # Follow correlation ID
+logler llm hierarchy trace-xyz --files "*.log"  # Build hierarchy tree
+logler llm bottleneck trace-xyz --files "*.log" # Find slow operations
+
+# Comparison
+logler llm compare req-fail req-success --files "*.log"  # Compare requests
+logler llm diff app.log --baseline 1h                    # Before/after analysis
+
+# Utilities
+logler llm sample app.log --strategy errors_focused --size 50
+logler llm context app.log 1523 --before 10 --after 10
+logler llm export trace-xyz --format jaeger
+```
+
+See **[LLM CLI Reference](docs/LLM_CLI_REFERENCE.md)** for complete documentation of all 16 commands.
+
 ### Visualization Modes
 
 **Tree View** - Shows parent-child relationships:
@@ -287,14 +344,6 @@ logler watch "app-*.log" -d /var/log    # Specific directory
 
 ## 📸 Screenshots
 
-### Web Interface
-Beautiful, modern web UI with file picker and real-time updates:
-- 📁 Browse and select log files
-- 🎨 Syntax-highlighted logs
-- 🧵 Thread visualization
-- 📊 Live statistics
-- 🔄 Real-time following with WebSocket
-
 ### Terminal
 Rich, colorful terminal output:
 - 🌈 Color-coded log levels
@@ -302,26 +351,10 @@ Rich, colorful terminal output:
 - 🔗 Correlation ID tracking
 - 📈 Thread timelines
 
-## 🎯 Examples
-
 ### Web Interface
+For a modern web UI, see [logler-web](https://github.com/gabu-quest/logler-web) - Vue3 + Naive-UI with real-time updates.
 
-```bash
-# Start server and auto-open browser
-logler serve --open
-
-# Start with specific files
-logler serve /var/log/app.log /var/log/error.log
-
-# Custom host/port
-logler serve --host 0.0.0.0 --port 9000
-```
-
-Then open your browser to `http://localhost:8000` and:
-1. Click "📁 Open File" to browse log files
-2. Filter by level, search, or thread
-3. Click "🔄 Follow" for real-time streaming
-4. View thread timelines and statistics
+## 🎯 Examples
 
 ### Terminal Viewing
 
@@ -367,6 +400,7 @@ logler investigate app.log --patterns --min-occurrences 5
 # Follow a specific thread or request
 logler investigate app.log --thread worker-1
 logler investigate app.log --correlation req-abc123
+logler investigate app.log --trace trace-xyz789
 
 # Token-efficient output for LLMs
 logler investigate app.log --auto-insights --output summary
@@ -464,41 +498,34 @@ Logler automatically tracks threads and shows:
 
 **Example:**
 ```bash
-logler view app.log
+logler view app.log --thread worker-1
 ```
-Shows threads in sidebar with:
-- Thread ID badge
-- Number of logs
-- Error count (if any)
 
-Click any thread to filter logs!
+Filter logs by thread to trace execution flow.
 
 ## 🔗 Correlation & Tracing
 
 Track requests across services:
 
 ```bash
-# Logs with correlation IDs are automatically linked
-logler view app.log
-```
+# Follow a specific correlation ID
+logler investigate app.log --correlation req-12345
+
+# Follow a distributed trace ID
+logler investigate app.log --trace trace-xyz789
 
-In the web UI:
-- See correlation IDs in log entries
-- Filter by correlation ID
-- View complete request flow
-- Track distributed traces
+# View across multiple service logs
+logler view app.log service.log --grep "req-12345"
+```
 
 ## ⚙️ Configuration
 
 Logler works with zero configuration, but you can customize:
 
 ```bash
-# Server options
-logler serve --host 0.0.0.0 --port 8000
-
 # View options
 logler view app.log --no-color    # Disable colors
-logler view app.log -n 1000        # Show more lines
+logler view app.log -n 1000       # Show more lines
 ```
 
 ## 🛠️ Development
@@ -523,11 +550,12 @@ ruff check logler
 
 - **logler** - Main CLI command
 - **Rich Terminal UI** - Beautiful colored output
-- **FastAPI Web Server** - Modern web interface
-- **WebSocket Support** - Real-time log streaming
 - **Thread Tracker** - Correlation and grouping
 - **Smart Parser** - Multi-format support
 - **File Watcher** - Monitor for new files
+- **LLM Investigation Engine** - Rust-powered analysis for AI agents
+
+For web UI, see [logler-web](https://github.com/gabu-quest/logler-web).
 
 ## 🤝 Contributing
 
@@ -541,16 +569,15 @@ MIT License - see LICENSE file for details.
 
 Built with:
 - [Rich](https://github.com/Textualize/rich) - Beautiful terminal output
-- [FastAPI](https://fastapi.tiangolo.com/) - Modern web framework
-- [HTMX](https://htmx.org/) - Dynamic web UI
-- [TailwindCSS](https://tailwindcss.com/) - Styling
-- [Alpine.js](https://alpinejs.dev/) - Reactive components
+- [Click](https://click.palletsprojects.com/) - CLI framework
+- [DuckDB](https://duckdb.org/) - SQL analytics
+- [PyO3](https://pyo3.rs/) - Rust/Python bindings
 
 ## 💡 Pro Tips
 
 1. **Use `--follow` mode** for real-time debugging
 2. **Filter by thread** to trace execution flow
-3. **Use the web UI** for complex log analysis
+3. **Use `--auto-insights`** for automatic issue detection
 4. **Export stats as JSON** for automation
 5. **Watch directories** for new log files
 
@@ -575,13 +602,15 @@ logler view app.log -f --level ERROR
 logler view app.log --thread worker-1
 ```
 
-### Beautiful web dashboard
+### Investigate with insights
 ```bash
-logler serve app.log --open
-# Then explore threads, traces, and statistics!
+logler investigate app.log --auto-insights
+# Automatic pattern detection and issue analysis
 ```
 
 ---
 
 **Made with ❤️ for developers who love beautiful tools**
 
+*For a web interface, check out [logler-web](https://github.com/gabu-quest/logler-web)*
+