Initial commit

docs/diagnostics.md

@@ -0,0 +1,103 @@
+# 🔍 Diagnostics
+
+**Auto-capture errors with screenshots and HTML**
+
+---
+
+## 💡 What Is It?
+
+When errors occur, the script automatically saves:
+- 📸 **Screenshots** — Visual error capture
+- 📄 **HTML snapshots** — Page source
+
+Helps you debug issues without re-running the script.
+
+---
+
+## ⚡ Quick Start
+
+**Already enabled by default!**
+
+```jsonc
+{
+  "diagnostics": {
+    "enabled": true,
+    "saveScreenshot": true,
+    "saveHtml": true,
+    "maxPerRun": 2,
+    "retentionDays": 7
+  }
+}
+```
+
+---
+
+## 📁 Where Are Files Saved?
+
+```
+reports/
+├── 2025-10-16/
+│   ├── error_abc123_001.png
+│   ├── error_abc123_001.html
+│   └── error_def456_002.png
+└── 2025-10-17/
+    └── ...
+```
+
+**Auto-cleanup:** Files older than 7 days are deleted automatically.
+
+---
+
+## 🎯 When It Captures
+
+- ⏱️ **Timeouts** — Page navigation failures
+- 🎯 **Element not found** — Selector errors
+- 🔐 **Login failures** — Authentication issues
+- 🌐 **Network errors** — Request failures
+
+---
+
+## 🔧 Configuration Options
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `enabled` | `true` | Enable diagnostics |
+| `saveScreenshot` | `true` | Capture PNG screenshots |
+| `saveHtml` | `true` | Save page HTML |
+| `maxPerRun` | `2` | Max captures per run |
+| `retentionDays` | `7` | Auto-delete after N days |
+
+---
+
+## 🛠️ Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| **No captures despite errors** | Check `enabled: true` |
+| **Too many files** | Reduce `retentionDays` |
+| **Permission denied** | Check `reports/` write access |
+
+### Manual Cleanup
+
+```powershell
+# Delete all diagnostic reports
+Remove-Item -Recurse -Force reports/
+
+# Keep last 3 days only
+Get-ChildItem reports/ | Where-Object {$_.LastWriteTime -lt (Get-Date).AddDays(-3)} | Remove-Item -Recurse
+```
+
+---
+
+## 📚 Next Steps
+
+**Need live notifications?**  
+→ **[Discord Webhooks](./conclusionwebhook.md)**  
+→ **[NTFY Push](./ntfy.md)**
+
+**Security issues?**  
+→ **[Security Guide](./security.md)**
+
+---
+
+**[← Back to Hub](./index.md)** | **[Config Guide](./config.md)**