Merge pull request #100 from rlaope/docs/final-overhaul

docs: final overhaul — 50 commands, Docker, CI/CD

Author: rlaope

README.md

@@ -8,7 +8,7 @@
 
 Two independent tools in one package:
 
-- **`argus` CLI** — 47 diagnostic commands that work on any running JVM via `jcmd`/`jstat`
+- **`argus` CLI** — 50 diagnostic commands that work on any running JVM via `jcmd`/`jstat`
 - **Argus Agent** — Real-time web dashboard with JFR streaming, flame graphs, and metric export
 
 ```bash
@@ -77,9 +77,13 @@ Diagnose any running JVM process directly from the terminal. No agent, no instru
 | `argus gclog <file>` | GC log analysis with pause distribution and tuning (GCEasy alternative) |
 | `argus flame <pid>` | One-shot flame graph — profiles, generates HTML, opens browser |
 | `argus suggest` | JVM flag optimization based on workload analysis |
+| `argus ci` | CI/CD health gate — exit codes + GitHub annotations |
+| `argus compare <pid1> <pid2>` | Side-by-side JVM comparison (live or baseline) |
+| `argus slowlog <pid>` | Real-time slow method detection via JFR streaming |
 | **Monitoring** | |
 | `argus top` | Real-time monitoring (agent required) |
-| `argus watch` | Real-time terminal dashboard (htop for JVM) |
+| `argus watch <pid>` | Real-time terminal dashboard (htop for JVM) |
+| `argus tui [pid]` | Interactive terminal UI — browse all commands (k9s-style) |
 | `argus init` | First-time setup (language selection) |
 
 ### `argus report` — Comprehensive Diagnostic
@@ -232,7 +236,7 @@ $ argus --lang=ko report 39113
 --version, -v             Show version
 ```
 
-> See [CLI Command Reference](docs/cli-commands.md) for all 47 commands with full output examples.
+> See [CLI Command Reference](docs/cli-commands.md) for all 50 commands with full output examples.
 
 ---
 
@@ -373,7 +377,7 @@ Argus adapts its capabilities based on the target JVM version at runtime:
 
 | Feature | Java 11+ | Java 17+ | Java 21+ |
 |---------|:--------:|:--------:|:--------:|
-| CLI (47 commands) | ✅ | ✅ | ✅ |
+| CLI (50 commands) | ✅ | ✅ | ✅ |
 | Dashboard & Web UI | — | ✅ | ✅ |
 | GC Analysis | CLI only | ✅ MXBean | ✅ JFR |
 | CPU Monitoring | CLI only | ✅ MXBean | ✅ JFR |
@@ -431,10 +435,38 @@ rm -rf ~/.argus
 | **argus-agent** | Java agent with JFR streaming engine |
 | **argus-server** | Netty HTTP/WS server, 10 analyzers, Prometheus + OTLP |
 | **argus-frontend** | Static dashboard with Chart.js and d3-flamegraph |
-| **argus-cli** | 47 diagnostic commands, auto source detection, i18n |
+| **argus-cli** | 50 diagnostic commands, auto source detection, i18n |
 | **argus-micrometer** | Micrometer MeterBinder exposing ~25 JVM metrics |
 | **argus-spring-boot-starter** | Spring Boot 3.2+ auto-configuration for Argus agent |
 
+## Docker
+
+```bash
+docker run --pid=host ghcr.io/rlaope/argus ps
+docker run --pid=host ghcr.io/rlaope/argus doctor
+docker run --pid=host ghcr.io/rlaope/argus watch
+```
+
+## CI/CD Integration
+
+Add JVM health checks to your GitHub Actions pipeline:
+
+```yaml
+- name: JVM Health Check
+  uses: rlaope/Argus/action@master
+  with:
+    command: ci
+    fail-on: critical
+    format: github-annotations
+```
+
+Or use `argus ci` directly:
+
+```bash
+argus ci --pid=auto --fail-on=critical --format=summary
+# Exit code: 0=pass, 1=warnings, 2=critical
+```
+
 ## Spring Boot Integration
 
 The `argus-spring-boot-starter` provides zero-configuration auto-setup for Spring Boot 3.2+ applications.

docs/README.md

@@ -6,7 +6,7 @@ Welcome to the Project Argus documentation.
 
 1. [Getting Started](getting-started.md) - Installation and quick start guide
 2. [Usage Guide](usage.md) - CLI and Agent dashboard usage
-3. [CLI Command Reference](cli-commands.md) - All 47 commands with usage and output examples
+3. [CLI Command Reference](cli-commands.md) - All 50 commands with usage and output examples
 4. [Configuration](configuration.md) - Configuration options and tuning
 5. [Architecture](architecture.md) - System architecture and design
 6. [Troubleshooting](troubleshooting.md) - Common issues and solutions

docs/cli-commands.md

@@ -1,6 +1,6 @@
 # Argus CLI Command Reference
 
-Complete reference for all 47 Argus CLI commands with usage examples and actual output.
+Complete reference for all 50 Argus CLI commands with usage examples and actual output.
 
 ## Global Options
 

site/index.html

@@ -629,14 +629,14 @@ <h1>Argus JVM Observability Platform</h1>
                         <span class="badge green">Java 11+ CLI</span>
                         <span class="badge green">Java 17+ Dashboard</span>
                         <span class="badge green">Java 21+ Full Features</span>
-                        <span class="badge">47 Commands</span>
+                        <span class="badge">50 Commands</span>
                         <span class="badge">Zero Dependencies</span>
                     </div>
                 </div>
 
                 <p>Argus gives you two tools for JVM diagnostics:</p>
                 <ul>
-                    <li><strong>Argus CLI</strong> — 47 diagnostic commands that work on any running JVM. No agent, no restart, no configuration. Point at a PID and get answers in seconds.</li>
+                    <li><strong>Argus CLI</strong> — 50 diagnostic commands that work on any running JVM. No agent, no restart, no configuration. Point at a PID and get answers in seconds.</li>
                     <li><strong>Argus Agent</strong> — Attach as a Java agent and get a live web dashboard with GC timelines, CPU graphs, heap usage, flame graphs, and thread analysis, all streaming in real time.</li>
                 </ul>
 
@@ -659,7 +659,7 @@ <h2>Why Argus?</h2>
                 <div class="feature-grid">
                     <div class="feature-card">
                         <h4>Instant CLI Diagnostics</h4>
-                        <p>47 commands that work on any running JVM. No agent, no restart, no configuration. Just point at a PID and get answers in seconds.</p>
+                        <p>50 commands that work on any running JVM. No agent, no restart, no configuration. Just point at a PID and get answers in seconds.</p>
                     </div>
                     <div class="feature-card">
                         <h4>Real-time Dashboard</h4>
@@ -725,7 +725,7 @@ <h3>Your First Diagnosis</h3>
                 <p class="video-caption">Argus CLI in action — diagnosing a running JVM process</p>
 
                 <span class="section-anchor" id="command-reference"></span>
-                <h3>All 47 Commands</h3>
+                <h3>All 50 Commands</h3>
 
                 <p>Every command follows the same pattern: <code>argus &lt;command&gt; &lt;pid&gt;</code>. All commands support <code>--format=json</code> for scripting and <code>--source=auto|agent|jdk</code> to control the data source.</p>
 
@@ -912,7 +912,7 @@ <h2>Java Version Compatibility</h2>
                             <tr><th>Feature</th><th>Java 11+</th><th>Java 17+</th><th>Java 21+</th></tr>
                         </thead>
                         <tbody>
-                            <tr><td>CLI (47 commands)</td><td>Yes</td><td>Yes</td><td>Yes</td></tr>
+                            <tr><td>CLI (50 commands)</td><td>Yes</td><td>Yes</td><td>Yes</td></tr>
                             <tr><td>Dashboard &amp; Web UI</td><td>—</td><td>Yes (MXBean)</td><td>Yes (JFR)</td></tr>
                             <tr><td>GC / CPU / Memory</td><td>CLI only</td><td>Yes</td><td>Yes</td></tr>
                             <tr><td>Allocation Tracking</td><td>—</td><td>—</td><td>Yes</td></tr>
@@ -947,7 +947,7 @@ <h2>Architecture</h2>
                             <tr><td><code>argus-agent</code></td><td>Java agent entry point, JFR streaming engine, MXBean polling engine</td></tr>
                             <tr><td><code>argus-server</code></td><td>Netty HTTP/WebSocket server, 10 analyzers, metrics export</td></tr>
                             <tr><td><code>argus-frontend</code></td><td>Dashboard web UI (vanilla JS, Chart.js, D3 flame graph)</td></tr>
-                            <tr><td><code>argus-cli</code></td><td>47 diagnostic commands using jcmd/jstat</td></tr>
+                            <tr><td><code>argus-cli</code></td><td>50 diagnostic commands using jcmd/jstat</td></tr>
                             <tr><td><code>argus-micrometer</code></td><td>Framework-agnostic Micrometer MeterBinder</td></tr>
                             <tr><td><code>argus-spring-boot-starter</code></td><td>Spring Boot auto-configuration</td></tr>
                         </tbody>