Add LLM export feature for AI-powered connection analysis

New export button in sidebar opens a modal with a structured markdown report
that users can paste into ChatGPT, Claude, Gemini etc. for DOCSIS insights.

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

Author: itsDNNS

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 Versioning: `YYYY-MM-DD.N` (date + sequential build number per day)
 
+## [2026-02-09.6]
+
+### Added
+- **LLM Export**: Generate structured markdown report for AI analysis (ChatGPT, Claude, Gemini, etc.)
+- **Export modal**: Copy-to-clipboard dialog accessible from sidebar menu
+- **API endpoint**: `/api/export` returns full DOCSIS status report with context and reference values
+
 ## [2026-02-09.5]
 
 ### Added

app/i18n.py

@@ -118,6 +118,15 @@
 
     # Language
     "language": "Language",
+
+    # Export
+    "export_llm": "Export for LLM",
+    "export_title": "LLM Analysis Export",
+    "export_hint": "Copy this text and paste it into your favorite LLM (ChatGPT, Claude, Gemini, ...) for connection insights.",
+    "copy_clipboard": "Copy to Clipboard",
+    "copied": "Copied!",
+    "close": "Close",
+    "export_no_data": "No data available yet. Wait for the first poll.",
 }
 
 DE = {
@@ -224,6 +233,14 @@
     "saved_ph": "Gespeichert",
 
     "language": "Sprache",
+
+    "export_llm": "Export fuer LLM",
+    "export_title": "LLM-Analyse Export",
+    "export_hint": "Kopiere diesen Text und fuege ihn in dein bevorzugtes LLM (ChatGPT, Claude, Gemini, ...) ein, um Insights zu deiner Verbindung zu erhalten.",
+    "copy_clipboard": "In Zwischenablage kopieren",
+    "copied": "Kopiert!",
+    "close": "Schliessen",
+    "export_no_data": "Noch keine Daten vorhanden. Warte auf die erste Abfrage.",
 }
 
 _TRANSLATIONS = {"en": EN, "de": DE}

app/templates/index.html

@@ -261,6 +261,53 @@
             color: var(--muted); font-size: 0.95em;
         }
 
+        /* ── Export Modal ── */
+        .modal-overlay {
+            position: fixed; inset: 0; background: var(--overlay);
+            z-index: 200; display: none; justify-content: center; align-items: center;
+        }
+        .modal-overlay.open { display: flex; }
+        .modal {
+            background: var(--surface); border-radius: 10px;
+            padding: 20px; max-width: 720px; width: 90%; max-height: 85vh;
+            display: flex; flex-direction: column;
+            border: 1px solid var(--input-border);
+            box-shadow: 0 12px 40px rgba(0,0,0,0.4);
+        }
+        .modal-header {
+            display: flex; justify-content: space-between; align-items: center;
+            margin-bottom: 8px;
+        }
+        .modal-header h2 { font-size: 1.1em; color: var(--accent); margin: 0; }
+        .modal-close {
+            background: none; border: none; color: var(--muted);
+            font-size: 1.4em; cursor: pointer; line-height: 1;
+        }
+        .modal-close:hover { color: var(--text); }
+        .modal-hint { font-size: 0.85em; color: var(--muted); margin-bottom: 12px; }
+        .modal-body {
+            flex: 1; overflow-y: auto; margin-bottom: 12px;
+        }
+        .modal-body textarea {
+            width: 100%; min-height: 300px; background: var(--bg);
+            color: var(--text); border: 1px solid var(--input-border);
+            border-radius: 6px; padding: 12px; font-size: 0.82em;
+            font-family: 'Consolas', 'Monaco', monospace; resize: vertical;
+        }
+        .modal-footer { display: flex; gap: 10px; justify-content: flex-end; }
+        .modal-footer .btn {
+            display: inline-block; padding: 8px 20px; border: none;
+            border-radius: 4px; cursor: pointer; font-size: 0.9em;
+            font-family: inherit; font-weight: bold;
+        }
+        .btn-accent { background: var(--accent); color: #000; }
+        .btn-accent:hover { filter: brightness(1.15); }
+        .btn-muted {
+            background: var(--card); color: var(--text);
+            border: 1px solid var(--input-border);
+        }
+        .btn-muted:hover { background: var(--accent); color: #000; }
+
         /* ── Responsive ── */
         @media (max-width: 900px) { .charts-grid { grid-template-columns: 1fr; } }
         @media (max-width: 600px) {
@@ -302,6 +349,9 @@
         <a class="sidebar-link" href="/settings">
             <span class="icon">&#9881;</span> {{ t.settings }}
         </a>
+        <a class="sidebar-link" id="export-link" onclick="exportForLLM()">
+            <span class="icon">&#128196;</span> {{ t.export_llm }}
+        </a>
         <div class="sidebar-divider"></div>
         <details class="sidebar-ref">
             <summary>{{ t.reference_values }}</summary>
@@ -504,6 +554,24 @@ <h2 class="section-title">{{ t.upstream }} ({{ us|length }} {{ t.channels }})</h
 </div>
 </div><!-- /main-content -->
 
+<!-- Export Modal -->
+<div class="modal-overlay" id="export-modal">
+    <div class="modal">
+        <div class="modal-header">
+            <h2>{{ t.export_title }}</h2>
+            <button class="modal-close" onclick="closeExportModal()">&times;</button>
+        </div>
+        <p class="modal-hint">{{ t.export_hint }}</p>
+        <div class="modal-body">
+            <textarea id="export-text" readonly></textarea>
+        </div>
+        <div class="modal-footer">
+            <button class="btn btn-muted" onclick="closeExportModal()">{{ t.close }}</button>
+            <button class="btn btn-accent" id="export-copy-btn" onclick="copyExport()">{{ t.copy_clipboard }}</button>
+        </div>
+    </div>
+</div>
+
 <script src="https://cdn.jsdelivr.net/npm/chart.js@4/dist/chart.umd.min.js"></script>
 <script>
 (function() {
@@ -829,6 +897,44 @@ <h2 class="section-title">{{ t.upstream }} ({{ us|length }} {{ t.channels }})</h
     /* ── Init ── */
     updateDateLabel();
 })();
+
+/* ── Export for LLM ── */
+function exportForLLM() {
+    var T = {{ t|tojson }};
+    var modal = document.getElementById('export-modal');
+    var textarea = document.getElementById('export-text');
+    var sidebar = document.getElementById('sidebar');
+    var overlay = document.getElementById('sidebar-overlay');
+    sidebar.classList.remove('open');
+    overlay.classList.remove('open');
+    textarea.value = T.export_no_data;
+    modal.classList.add('open');
+    fetch('/api/export')
+        .then(function(r) { return r.json(); })
+        .then(function(data) {
+            if (data.text) {
+                textarea.value = data.text;
+            } else if (data.error) {
+                textarea.value = data.error;
+            }
+        })
+        .catch(function() {
+            textarea.value = 'Error loading export data.';
+        });
+}
+function closeExportModal() {
+    document.getElementById('export-modal').classList.remove('open');
+}
+function copyExport() {
+    var T = {{ t|tojson }};
+    var textarea = document.getElementById('export-text');
+    var btn = document.getElementById('export-copy-btn');
+    textarea.select();
+    navigator.clipboard.writeText(textarea.value).then(function() {
+        btn.textContent = T.copied;
+        setTimeout(function() { btn.textContent = T.copy_clipboard; }, 2000);
+    });
+}
 </script>
 
 </body>

app/web.py

@@ -254,6 +254,85 @@ def api_trends():
         return jsonify({"error": "Invalid range (use day, week, month)"}), 400
 
 
+@app.route("/api/export")
+def api_export():
+    """Generate a structured markdown report for LLM analysis."""
+    analysis = _state.get("analysis")
+    if not analysis:
+        return jsonify({"error": "No data available"}), 404
+
+    s = analysis["summary"]
+    ds = analysis["ds_channels"]
+    us = analysis["us_channels"]
+    ts = _state.get("last_update", "unknown")
+
+    lines = [
+        "# DOCSIS Cable Connection – Status Report",
+        "",
+        "## Context",
+        "This is a status report from a DOCSIS cable modem (FritzBox Cable).",
+        "DOCSIS (Data Over Cable Service Interface Specification) is the standard for internet over coaxial cable.",
+        "Analyze this data and provide insights about connection health, problematic channels, and recommendations.",
+        "",
+        "## Overview",
+        f"- **Health**: {s.get('health', 'Unknown')}",
+        f"- **Details**: {s.get('health_details', '')}",
+        f"- **Timestamp**: {ts}",
+        "",
+        "## Summary",
+        "| Metric | Value |",
+        "|--------|-------|",
+        f"| Downstream Channels | {s.get('ds_total', 0)} |",
+        f"| DS Power (Min/Avg/Max) | {s.get('ds_power_min')} / {s.get('ds_power_avg')} / {s.get('ds_power_max')} dBmV |",
+        f"| DS SNR (Min/Avg) | {s.get('ds_snr_min')} / {s.get('ds_snr_avg')} dB |",
+        f"| DS Correctable Errors | {s.get('ds_correctable_errors', 0):,} |",
+        f"| DS Uncorrectable Errors | {s.get('ds_uncorrectable_errors', 0):,} |",
+        f"| Upstream Channels | {s.get('us_total', 0)} |",
+        f"| US Power (Min/Avg/Max) | {s.get('us_power_min')} / {s.get('us_power_avg')} / {s.get('us_power_max')} dBmV |",
+        "",
+        "## Downstream Channels",
+        "| Ch | Frequency | Power (dBmV) | SNR (dB) | Modulation | Corr. Errors | Uncorr. Errors | DOCSIS | Health |",
+        "|----|-----------|-------------|----------|------------|-------------|---------------|--------|--------|",
+    ]
+    for ch in ds:
+        lines.append(
+            f"| {ch.get('channel_id','')} | {ch.get('frequency','')} | {ch.get('power','')} "
+            f"| {ch.get('snr', '-')} | {ch.get('modulation','')} "
+            f"| {ch.get('correctable_errors', 0):,} | {ch.get('uncorrectable_errors', 0):,} "
+            f"| {ch.get('docsis_version','')} | {ch.get('health','')} |"
+        )
+    lines += [
+        "",
+        "## Upstream Channels",
+        "| Ch | Frequency | Power (dBmV) | Modulation | Multiplex | DOCSIS | Health |",
+        "|----|-----------|-------------|------------|-----------|--------|--------|",
+    ]
+    for ch in us:
+        lines.append(
+            f"| {ch.get('channel_id','')} | {ch.get('frequency','')} | {ch.get('power','')} "
+            f"| {ch.get('modulation','')} | {ch.get('multiplex','')} "
+            f"| {ch.get('docsis_version','')} | {ch.get('health','')} |"
+        )
+    lines += [
+        "",
+        "## Reference Values",
+        "| Metric | Good | Marginal | Poor |",
+        "|--------|------|----------|------|",
+        "| DS Power | -7 to +7 dBmV | +/-7 to +/-10 | > +/-10 dBmV |",
+        "| US Power | 35 to 49 dBmV | 50 to 54 | > 54 dBmV |",
+        "| SNR/MER | > 30 dB | 25 to 30 | < 25 dB |",
+        "| Uncorr. Errors | low | - | > 10,000 |",
+        "",
+        "## Questions",
+        "Please analyze this data and provide:",
+        "1. Overall connection health assessment",
+        "2. Channels that need attention (with reasons)",
+        "3. Error rate analysis and whether it indicates a problem",
+        "4. Specific recommendations to improve connection quality",
+    ]
+    return jsonify({"text": "\n".join(lines)})
+
+
 @app.route("/api/snapshots")
 def api_snapshots():
     """Return list of available snapshot timestamps."""