feat: add /debug command handler with paste service upload (#320)

cli.py

@@ -3134,6 +3134,196 @@ class HermesCLI:
         print(f"  Home:    {display}")
         print()
 
+    def _handle_debug_command(self, command: str):
+        """Generate a debug report with system info and logs, upload to paste service."""
+        import platform
+        import sys
+        import time as _time
+
+        # Parse optional lines argument
+        parts = command.split(maxsplit=1)
+        log_lines = 50
+        if len(parts) > 1:
+            try:
+                log_lines = min(int(parts[1]), 500)
+            except ValueError:
+                pass
+
+        _cprint("  Collecting debug info...")
+
+        # Collect system info
+        lines = []
+        lines.append("=== HERMES DEBUG REPORT ===")
+        lines.append(f"Generated: {_time.strftime('%Y-%m-%d %H:%M:%S %z')}")
+        lines.append("")
+
+        lines.append("--- System ---")
+        lines.append(f"Python: {sys.version}")
+        lines.append(f"Platform: {platform.platform()}")
+        lines.append(f"Architecture: {platform.machine()}")
+        lines.append(f"Hostname: {platform.node()}")
+        lines.append("")
+
+        # Hermes info
+        lines.append("--- Hermes ---")
+        try:
+            from hermes_constants import get_hermes_home, display_hermes_home
+            lines.append(f"Home: {display_hermes_home()}")
+        except Exception:
+            lines.append("Home: unknown")
+
+        try:
+            from hermes_constants import __version__
+            lines.append(f"Version: {__version__}")
+        except Exception:
+            lines.append("Version: unknown")
+
+        lines.append(f"Profile: {getattr(self, '_profile_name', 'default')}")
+        lines.append(f"Session: {self.session_id}")
+        lines.append(f"Model: {self.model}")
+        lines.append(f"Provider: {getattr(self, '_provider_name', 'unknown')}")
+
+        try:
+            lines.append(f"Working dir: {os.getcwd()}")
+        except Exception:
+            pass
+
+        # Config (redacted)
+        lines.append("")
+        lines.append("--- Config (redacted) ---")
+        try:
+            from hermes_constants import get_hermes_home
+            config_path = get_hermes_home() / "config.yaml"
+            if config_path.exists():
+                import yaml
+                with open(config_path) as f:
+                    cfg = yaml.safe_load(f) or {}
+                # Redact secrets
+                for key in ("api_key", "token", "secret", "password"):
+                    if key in cfg:
+                        cfg[key] = "***REDACTED***"
+                lines.append(yaml.dump(cfg, default_flow_style=False)[:2000])
+            else:
+                lines.append("(no config file found)")
+        except Exception as e:
+            lines.append(f"(error reading config: {e})")
+
+        # Recent logs
+        lines.append("")
+        lines.append(f"--- Recent Logs (last {log_lines} lines) ---")
+        try:
+            from hermes_constants import get_hermes_home
+            log_dir = get_hermes_home() / "logs"
+            if log_dir.exists():
+                for log_file in sorted(log_dir.glob("*.log")):
+                    try:
+                        content = log_file.read_text(encoding="utf-8", errors="replace")
+                        tail = content.strip().split("\n")[-log_lines:]
+                        if tail:
+                            lines.append(f"\n[{log_file.name}]")
+                            lines.extend(tail)
+                    except Exception:
+                        pass
+            else:
+                lines.append("(no logs directory)")
+        except Exception:
+            lines.append("(error reading logs)")
+
+        # Tool info
+        lines.append("")
+        lines.append("--- Enabled Toolsets ---")
+        try:
+            lines.append(", ".join(self.enabled_toolsets) if self.enabled_toolsets else "(none)")
+        except Exception:
+            lines.append("(unknown)")
+
+        report = "\n".join(lines)
+        report_size = len(report)
+
+        # Try to upload to paste services
+        paste_url = None
+        services = [
+            ("dpaste", _upload_dpaste),
+            ("0x0.st", _upload_0x0st),
+        ]
+
+        for name, uploader in services:
+            try:
+                url = uploader(report)
+                if url:
+                    paste_url = url
+                    break
+            except Exception:
+                continue
+
+        print()
+        if paste_url:
+            _cprint(f"  Debug report uploaded: {paste_url}")
+            _cprint(f"  Size: {report_size} bytes, {len(lines)} lines")
+        else:
+            # Fallback: save locally
+            try:
+                from hermes_constants import get_hermes_home
+                debug_path = get_hermes_home() / "debug-report.txt"
+                debug_path.write_text(report, encoding="utf-8")
+                _cprint(f"  Paste services unavailable. Report saved to: {debug_path}")
+                _cprint(f"  Size: {report_size} bytes, {len(lines)} lines")
+            except Exception as e:
+                _cprint(f"  Failed to save report: {e}")
+                _cprint(f"  Report ({report_size} bytes):")
+                print(report)
+        print()
+
+
+def _upload_dpaste(content: str) -> str | None:
+    """Upload content to dpaste.org. Returns URL or None."""
+    import urllib.request
+    import urllib.parse
+    data = urllib.parse.urlencode({
+        "content": content,
+        "syntax": "text",
+        "expiry_days": 7,
+    }).encode()
+    req = urllib.request.Request(
+        "https://dpaste.org/api/",
+        data=data,
+        headers={"User-Agent": "hermes-agent/debug"},
+    )
+    with urllib.request.urlopen(req, timeout=10) as resp:
+        url = resp.read().decode().strip()
+        if url.startswith("http"):
+            return url
+    return None
+
+
+def _upload_0x0st(content: str) -> str | None:
+    """Upload content to 0x0.st. Returns URL or None."""
+    import urllib.request
+    import io
+    # 0x0.st expects multipart form with a file field
+    boundary = "----HermesDebugBoundary"
+    body = (
+        f"--{boundary}\r\n"
+        f'Content-Disposition: form-data; name="file"; filename="debug.txt"\r\n'
+        f"Content-Type: text/plain\r\n\r\n"
+        f"{content}\r\n"
+        f"--{boundary}--\r\n"
+    ).encode()
+    req = urllib.request.Request(
+        "https://0x0.st",
+        data=body,
+        headers={
+            "Content-Type": f"multipart/form-data; boundary={boundary}",
+            "User-Agent": "hermes-agent/debug",
+        },
+    )
+    with urllib.request.urlopen(req, timeout=10) as resp:
+        url = resp.read().decode().strip()
+        if url.startswith("http"):
+            return url
+    return None
+
+
     def show_config(self):
         """Display current configuration with kawaii ASCII art."""
         # Get terminal config from environment (which was set from cli-config.yaml)
@@ -4321,6 +4511,8 @@ class HermesCLI:
             self.show_help()
         elif canonical == "profile":
             self._handle_profile_command()
+        elif canonical == "debug":
+            self._handle_debug_command(cmd_original)
         elif canonical == "tools":
             self._handle_tools_command(cmd_original)
         elif canonical == "toolsets":