npm - @pasko70/pibo - Versions diffs - 1.9.11 → 1.9.13 - Mend

@pasko70/pibo 1.9.11 → 1.9.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (111) hide show

package/README.md +183 -183
package/context/codex-base-prompt.md +148 -148
package/context/compute-worker.md +23 -23
package/context/pibo-compaction-prompt.md +100 -100
package/context/pibo-native-tooling.md +18 -18
package/context/pibo-system-prompt.md +77 -77
package/dist/apps/chat/agent-store.js +248 -248
package/dist/apps/chat/data/project-service.js +168 -168
package/dist/apps/chat/data/read-state-service.js +18 -18
package/dist/apps/chat/data/session-query-service.js +25 -25
package/dist/apps/chat/data/timeline-query-service.js +25 -14
package/dist/apps/chat/static-assets.js +854 -854
package/dist/apps/chat/trace.js +2 -0
package/dist/apps/chat/web-app.js +7 -0
package/dist/apps/chat/workflow-persistence.js +255 -255
package/dist/apps/chat-ui/index.html +16 -16
package/dist/apps/chat-ui/manifest.webmanifest +25 -25
package/dist/apps/chat-ui/sw.js +47 -47
package/dist/apps/chat-vscode-web/index.html +12 -12
package/dist/apps/cli-ui/cliSessionsCommand.js +23 -23
package/dist/apps/context-files-ui/index.html +11 -11
package/dist/apps/vscode-artifacts/latest.vsix +0 -0
package/dist/apps/vscode-artifacts/pibo-vscode-ext-1.9.13.vsix +0 -0
package/dist/cli.js +39 -39
package/dist/compute/cli.js +54 -54
package/dist/cron/cli.js +15 -15
package/dist/cron/store.js +49 -49
package/dist/data/cli.js +23 -23
package/dist/data/event-log.js +23 -23
package/dist/data/ingest-service.js +7 -0
package/dist/data/message-store.js +31 -20
package/dist/data/navigation-store.js +9 -9
package/dist/data/observation-store.js +4 -4
package/dist/data/payload-store.js +17 -17
package/dist/data/schema.js +433 -431
package/dist/data/session-store.js +4 -4
package/dist/data/telemetry-queries.js +54 -54
package/dist/data/telemetry.js +197 -197
package/dist/debug/events.js +12 -12
package/dist/debug/failures.js +6 -6
package/dist/debug/index.js +227 -227
package/dist/debug/messages.js +6 -6
package/dist/debug/pty.js +124 -124
package/dist/debug/session.js +29 -29
package/dist/debug/tools.js +5 -5
package/dist/debug/web-snapshot-browser-scripts.js +294 -294
package/dist/debug/web-streaming-browser-library.js +925 -925
package/dist/debug/web-streaming-browser-scripts.js +232 -232
package/dist/debug/web-streaming-provider-telemetry.js +4 -4
package/dist/debug/web.js +93 -93
package/dist/gateway/cli.js +19 -19
package/dist/mcp/config-command.js +53 -53
package/dist/mcp/index.js +21 -21
package/dist/mcp/registry.js +11 -11
package/dist/pi-packages/cli.js +11 -11
package/dist/plugins/context-files-store.js +110 -110
package/dist/plugins/context-files.js +4 -4
package/dist/ralph/cli.js +18 -18
package/dist/ralph/templates.js +140 -140
package/dist/reliability/store.js +226 -226
package/dist/resources/lifecycle.js +4 -6
package/dist/resources/reaper-state.js +30 -3
package/dist/resources/reaper.js +43 -15
package/dist/sessions/pibo-data-store.js +16 -16
package/dist/sessions/sqlite-store.js +53 -53
package/dist/setup/cli.js +58 -58
package/dist/shared/trace-engine.js +3 -2
package/dist/shared/trace-event-projection.js +26 -0
package/dist/tools/agent-browser-wrapper.js +80 -80
package/dist/tools/browser-use-cdp.js +12 -12
package/dist/tools/browser-use-wrapper.js +762 -762
package/dist/tools/guides.js +538 -538
package/dist/tools/index.js +99 -99
package/dist/tools/runtime/node-worker-source.js +205 -205
package/dist/tools/runtime/python-worker-source.js +177 -177
package/dist/vscode/cli.js +9 -9
package/dist/web-annotations/cdp.js +900 -900
package/dist/web-annotations/store.js +96 -96
package/docs/README.md +23 -23
package/docs/ops/install-developer-host.md +112 -112
package/docs/ops/install-user-host.md +96 -96
package/docs/ops/upgrade-user-to-developer-host.md +69 -69
package/docs/ops/vscode-extension-release.md +160 -160
package/package.json +95 -95
package/skills/builtin/graphify/SKILL.md +52 -52
package/skills/builtin/pi-agent-harness/SKILL.md +319 -319
package/skills/builtin/pi-agent-harness/agents/openai.yaml +4 -4
package/skills/builtin/pibo-docker-system/SKILL.md +170 -170
package/skills/builtin/pibo-spec-writing/SKILL.md +330 -330
package/skills/builtin/prd/SKILL.md +143 -143
package/skills/builtin/ralph-loop/SKILL.md +359 -359
package/skills/builtin/ralph-prd-json/SKILL.md +123 -123
package/skills/builtin/skill-creator/LICENSE.txt +201 -201
package/skills/builtin/skill-creator/SKILL.md +513 -513
package/skills/builtin/skill-creator/agents/analyzer.md +274 -274
package/skills/builtin/skill-creator/agents/comparator.md +202 -202
package/skills/builtin/skill-creator/agents/grader.md +223 -223
package/skills/builtin/skill-creator/assets/eval_review.html +146 -146
package/skills/builtin/skill-creator/eval-viewer/generate_review.py +471 -471
package/skills/builtin/skill-creator/eval-viewer/viewer.html +1325 -1325
package/skills/builtin/skill-creator/references/schemas.md +430 -430
package/skills/builtin/skill-creator/scripts/aggregate_benchmark.py +401 -401
package/skills/builtin/skill-creator/scripts/generate_report.py +326 -326
package/skills/builtin/skill-creator/scripts/improve_description.py +247 -247
package/skills/builtin/skill-creator/scripts/package_skill.py +136 -136
package/skills/builtin/skill-creator/scripts/quick_validate.py +102 -102
package/skills/builtin/skill-creator/scripts/run_eval.py +310 -310
package/skills/builtin/skill-creator/scripts/run_loop.py +328 -328
package/skills/builtin/skill-creator/scripts/utils.py +47 -47
package/skills/builtin/web-annotations/SKILL.md +93 -93
package/src/mcp/LICENSE.mcp-cli +21 -21

package/skills/builtin/skill-creator/scripts/generate_report.py CHANGED Viewed

@@ -1,326 +1,326 @@
-#!/usr/bin/env python3
-"""Generate an HTML report from run_loop.py output.
-Takes the JSON output from run_loop.py and generates a visual HTML report
-showing each description attempt with check/x for each test case.
-Distinguishes between train and test queries.
-"""
-import argparse
-import html
-import json
-import sys
-from pathlib import Path
-def generate_html(data: dict, auto_refresh: bool = False, skill_name: str = "") -> str:
-    """Generate HTML report from loop output data. If auto_refresh is True, adds a meta refresh tag."""
-    history = data.get("history", [])
-    holdout = data.get("holdout", 0)
-    title_prefix = html.escape(skill_name + " \u2014 ") if skill_name else ""
-    # Get all unique queries from train and test sets, with should_trigger info
-    train_queries: list[dict] = []
-    test_queries: list[dict] = []
-    if history:
-        for r in history[0].get("train_results", history[0].get("results", [])):
-            train_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)})
-        if history[0].get("test_results"):
-            for r in history[0].get("test_results", []):
-                test_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)})
-    refresh_tag = '    <meta http-equiv="refresh" content="5">\n' if auto_refresh else ""
-    html_parts = ["""<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="utf-8">
-""" + refresh_tag + """    <title>""" + title_prefix + """Skill Description Optimization</title>
-    <link rel="preconnect" href="https://fonts.googleapis.com">
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=Poppins:wght@500;600&family=Lora:wght@400;500&display=swap" rel="stylesheet">
-    <style>
-        body {
-            font-family: 'Lora', Georgia, serif;
-            max-width: 100%;
-            margin: 0 auto;
-            padding: 20px;
-            background: #faf9f5;
-            color: #141413;
-        }
-        h1 { font-family: 'Poppins', sans-serif; color: #141413; }
-        .explainer {
-            background: white;
-            padding: 15px;
-            border-radius: 6px;
-            margin-bottom: 20px;
-            border: 1px solid #e8e6dc;
-            color: #b0aea5;
-            font-size: 0.875rem;
-            line-height: 1.6;
-        }
-        .summary {
-            background: white;
-            padding: 15px;
-            border-radius: 6px;
-            margin-bottom: 20px;
-            border: 1px solid #e8e6dc;
-        }
-        .summary p { margin: 5px 0; }
-        .best { color: #788c5d; font-weight: bold; }
-        .table-container {
-            overflow-x: auto;
-            width: 100%;
-        }
-        table {
-            border-collapse: collapse;
-            background: white;
-            border: 1px solid #e8e6dc;
-            border-radius: 6px;
-            font-size: 12px;
-            min-width: 100%;
-        }
-        th, td {
-            padding: 8px;
-            text-align: left;
-            border: 1px solid #e8e6dc;
-            white-space: normal;
-            word-wrap: break-word;
-        }
-        th {
-            font-family: 'Poppins', sans-serif;
-            background: #141413;
-            color: #faf9f5;
-            font-weight: 500;
-        }
-        th.test-col {
-            background: #6a9bcc;
-        }
-        th.query-col { min-width: 200px; }
-        td.description {
-            font-family: monospace;
-            font-size: 11px;
-            word-wrap: break-word;
-            max-width: 400px;
-        }
-        td.result {
-            text-align: center;
-            font-size: 16px;
-            min-width: 40px;
-        }
-        td.test-result {
-            background: #f0f6fc;
-        }
-        .pass { color: #788c5d; }
-        .fail { color: #c44; }
-        .rate {
-            font-size: 9px;
-            color: #b0aea5;
-            display: block;
-        }
-        tr:hover { background: #faf9f5; }
-        .score {
-            display: inline-block;
-            padding: 2px 6px;
-            border-radius: 4px;
-            font-weight: bold;
-            font-size: 11px;
-        }
-        .score-good { background: #eef2e8; color: #788c5d; }
-        .score-ok { background: #fef3c7; color: #d97706; }
-        .score-bad { background: #fceaea; color: #c44; }
-        .train-label { color: #b0aea5; font-size: 10px; }
-        .test-label { color: #6a9bcc; font-size: 10px; font-weight: bold; }
-        .best-row { background: #f5f8f2; }
-        th.positive-col { border-bottom: 3px solid #788c5d; }
-        th.negative-col { border-bottom: 3px solid #c44; }
-        th.test-col.positive-col { border-bottom: 3px solid #788c5d; }
-        th.test-col.negative-col { border-bottom: 3px solid #c44; }
-        .legend { font-family: 'Poppins', sans-serif; display: flex; gap: 20px; margin-bottom: 10px; font-size: 13px; align-items: center; }
-        .legend-item { display: flex; align-items: center; gap: 6px; }
-        .legend-swatch { width: 16px; height: 16px; border-radius: 3px; display: inline-block; }
-        .swatch-positive { background: #141413; border-bottom: 3px solid #788c5d; }
-        .swatch-negative { background: #141413; border-bottom: 3px solid #c44; }
-        .swatch-test { background: #6a9bcc; }
-        .swatch-train { background: #141413; }
-    </style>
-</head>
-<body>
-    <h1>""" + title_prefix + """Skill Description Optimization</h1>
-    <div class="explainer">
-        <strong>Optimizing your skill's description.</strong> This page updates automatically as Claude tests different versions of your skill's description. Each row is an iteration — a new description attempt. The columns show test queries: green checkmarks mean the skill triggered correctly (or correctly didn't trigger), red crosses mean it got it wrong. The "Train" score shows performance on queries used to improve the description; the "Test" score shows performance on held-out queries the optimizer hasn't seen. When it's done, Claude will apply the best-performing description to your skill.
-    </div>
-"""]
-    # Summary section
-    best_test_score = data.get('best_test_score')
-    best_train_score = data.get('best_train_score')
-    html_parts.append(f"""
-    <div class="summary">
-        <p><strong>Original:</strong> {html.escape(data.get('original_description', 'N/A'))}</p>
-        <p class="best"><strong>Best:</strong> {html.escape(data.get('best_description', 'N/A'))}</p>
-        <p><strong>Best Score:</strong> {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}</p>
-        <p><strong>Iterations:</strong> {data.get('iterations_run', 0)} | <strong>Train:</strong> {data.get('train_size', '?')} | <strong>Test:</strong> {data.get('test_size', '?')}</p>
-    </div>
-""")
-    # Legend
-    html_parts.append("""
-    <div class="legend">
-        <span style="font-weight:600">Query columns:</span>
-        <span class="legend-item"><span class="legend-swatch swatch-positive"></span> Should trigger</span>
-        <span class="legend-item"><span class="legend-swatch swatch-negative"></span> Should NOT trigger</span>
-        <span class="legend-item"><span class="legend-swatch swatch-train"></span> Train</span>
-        <span class="legend-item"><span class="legend-swatch swatch-test"></span> Test</span>
-    </div>
-""")
-    # Table header
-    html_parts.append("""
-    <div class="table-container">
-    <table>
-        <thead>
-            <tr>
-                <th>Iter</th>
-                <th>Train</th>
-                <th>Test</th>
-                <th class="query-col">Description</th>
-""")
-    # Add column headers for train queries
-    for qinfo in train_queries:
-        polarity = "positive-col" if qinfo["should_trigger"] else "negative-col"
-        html_parts.append(f'                <th class="{polarity}">{html.escape(qinfo["query"])}</th>\n')
-    # Add column headers for test queries (different color)
-    for qinfo in test_queries:
-        polarity = "positive-col" if qinfo["should_trigger"] else "negative-col"
-        html_parts.append(f'                <th class="test-col {polarity}">{html.escape(qinfo["query"])}</th>\n')
-    html_parts.append("""            </tr>
-        </thead>
-        <tbody>
-""")
-    # Find best iteration for highlighting
-    if test_queries:
-        best_iter = max(history, key=lambda h: h.get("test_passed") or 0).get("iteration")
-    else:
-        best_iter = max(history, key=lambda h: h.get("train_passed", h.get("passed", 0))).get("iteration")
-    # Add rows for each iteration
-    for h in history:
-        iteration = h.get("iteration", "?")
-        train_passed = h.get("train_passed", h.get("passed", 0))
-        train_total = h.get("train_total", h.get("total", 0))
-        test_passed = h.get("test_passed")
-        test_total = h.get("test_total")
-        description = h.get("description", "")
-        train_results = h.get("train_results", h.get("results", []))
-        test_results = h.get("test_results", [])
-        # Create lookups for results by query
-        train_by_query = {r["query"]: r for r in train_results}
-        test_by_query = {r["query"]: r for r in test_results} if test_results else {}
-        # Compute aggregate correct/total runs across all retries
-        def aggregate_runs(results: list[dict]) -> tuple[int, int]:
-            correct = 0
-            total = 0
-            for r in results:
-                runs = r.get("runs", 0)
-                triggers = r.get("triggers", 0)
-                total += runs
-                if r.get("should_trigger", True):
-                    correct += triggers
-                else:
-                    correct += runs - triggers
-            return correct, total
-        train_correct, train_runs = aggregate_runs(train_results)
-        test_correct, test_runs = aggregate_runs(test_results)
-        # Determine score classes
-        def score_class(correct: int, total: int) -> str:
-            if total > 0:
-                ratio = correct / total
-                if ratio >= 0.8:
-                    return "score-good"
-                elif ratio >= 0.5:
-                    return "score-ok"
-            return "score-bad"
-        train_class = score_class(train_correct, train_runs)
-        test_class = score_class(test_correct, test_runs)
-        row_class = "best-row" if iteration == best_iter else ""
-        html_parts.append(f"""            <tr class="{row_class}">
-                <td>{iteration}</td>
-                <td><span class="score {train_class}">{train_correct}/{train_runs}</span></td>
-                <td><span class="score {test_class}">{test_correct}/{test_runs}</span></td>
-                <td class="description">{html.escape(description)}</td>
-""")
-        # Add result for each train query
-        for qinfo in train_queries:
-            r = train_by_query.get(qinfo["query"], {})
-            did_pass = r.get("pass", False)
-            triggers = r.get("triggers", 0)
-            runs = r.get("runs", 0)
-            icon = "✓" if did_pass else "✗"
-            css_class = "pass" if did_pass else "fail"
-            html_parts.append(f'                <td class="result {css_class}">{icon}<span class="rate">{triggers}/{runs}</span></td>\n')
-        # Add result for each test query (with different background)
-        for qinfo in test_queries:
-            r = test_by_query.get(qinfo["query"], {})
-            did_pass = r.get("pass", False)
-            triggers = r.get("triggers", 0)
-            runs = r.get("runs", 0)
-            icon = "✓" if did_pass else "✗"
-            css_class = "pass" if did_pass else "fail"
-            html_parts.append(f'                <td class="result test-result {css_class}">{icon}<span class="rate">{triggers}/{runs}</span></td>\n')
-        html_parts.append("            </tr>\n")
-    html_parts.append("""        </tbody>
-    </table>
-    </div>
-""")
-    html_parts.append("""
-</body>
-</html>
-""")
-    return "".join(html_parts)
-def main():
-    parser = argparse.ArgumentParser(description="Generate HTML report from run_loop output")
-    parser.add_argument("input", help="Path to JSON output from run_loop.py (or - for stdin)")
-    parser.add_argument("-o", "--output", default=None, help="Output HTML file (default: stdout)")
-    parser.add_argument("--skill-name", default="", help="Skill name to include in the report title")
-    args = parser.parse_args()
-    if args.input == "-":
-        data = json.load(sys.stdin)
-    else:
-        data = json.loads(Path(args.input).read_text())
-    html_output = generate_html(data, skill_name=args.skill_name)
-    if args.output:
-        Path(args.output).write_text(html_output)
-        print(f"Report written to {args.output}", file=sys.stderr)
-    else:
-        print(html_output)
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""Generate an HTML report from run_loop.py output.
+Takes the JSON output from run_loop.py and generates a visual HTML report
+showing each description attempt with check/x for each test case.
+Distinguishes between train and test queries.
+"""
+import argparse
+import html
+import json
+import sys
+from pathlib import Path
+def generate_html(data: dict, auto_refresh: bool = False, skill_name: str = "") -> str:
+    """Generate HTML report from loop output data. If auto_refresh is True, adds a meta refresh tag."""
+    history = data.get("history", [])
+    holdout = data.get("holdout", 0)
+    title_prefix = html.escape(skill_name + " \u2014 ") if skill_name else ""
+    # Get all unique queries from train and test sets, with should_trigger info
+    train_queries: list[dict] = []
+    test_queries: list[dict] = []
+    if history:
+        for r in history[0].get("train_results", history[0].get("results", [])):
+            train_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)})
+        if history[0].get("test_results"):
+            for r in history[0].get("test_results", []):
+                test_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)})
+    refresh_tag = '    <meta http-equiv="refresh" content="5">\n' if auto_refresh else ""
+    html_parts = ["""<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+""" + refresh_tag + """    <title>""" + title_prefix + """Skill Description Optimization</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Poppins:wght@500;600&family=Lora:wght@400;500&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Lora', Georgia, serif;
+            max-width: 100%;
+            margin: 0 auto;
+            padding: 20px;
+            background: #faf9f5;
+            color: #141413;
+        }
+        h1 { font-family: 'Poppins', sans-serif; color: #141413; }
+        .explainer {
+            background: white;
+            padding: 15px;
+            border-radius: 6px;
+            margin-bottom: 20px;
+            border: 1px solid #e8e6dc;
+            color: #b0aea5;
+            font-size: 0.875rem;
+            line-height: 1.6;
+        }
+        .summary {
+            background: white;
+            padding: 15px;
+            border-radius: 6px;
+            margin-bottom: 20px;
+            border: 1px solid #e8e6dc;
+        }
+        .summary p { margin: 5px 0; }
+        .best { color: #788c5d; font-weight: bold; }
+        .table-container {
+            overflow-x: auto;
+            width: 100%;
+        }
+        table {
+            border-collapse: collapse;
+            background: white;
+            border: 1px solid #e8e6dc;
+            border-radius: 6px;
+            font-size: 12px;
+            min-width: 100%;
+        }
+        th, td {
+            padding: 8px;
+            text-align: left;
+            border: 1px solid #e8e6dc;
+            white-space: normal;
+            word-wrap: break-word;
+        }
+        th {
+            font-family: 'Poppins', sans-serif;
+            background: #141413;
+            color: #faf9f5;
+            font-weight: 500;
+        }
+        th.test-col {
+            background: #6a9bcc;
+        }
+        th.query-col { min-width: 200px; }
+        td.description {
+            font-family: monospace;
+            font-size: 11px;
+            word-wrap: break-word;
+            max-width: 400px;
+        }
+        td.result {
+            text-align: center;
+            font-size: 16px;
+            min-width: 40px;
+        }
+        td.test-result {
+            background: #f0f6fc;
+        }
+        .pass { color: #788c5d; }
+        .fail { color: #c44; }
+        .rate {
+            font-size: 9px;
+            color: #b0aea5;
+            display: block;
+        }
+        tr:hover { background: #faf9f5; }
+        .score {
+            display: inline-block;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-weight: bold;
+            font-size: 11px;
+        }
+        .score-good { background: #eef2e8; color: #788c5d; }
+        .score-ok { background: #fef3c7; color: #d97706; }
+        .score-bad { background: #fceaea; color: #c44; }
+        .train-label { color: #b0aea5; font-size: 10px; }
+        .test-label { color: #6a9bcc; font-size: 10px; font-weight: bold; }
+        .best-row { background: #f5f8f2; }
+        th.positive-col { border-bottom: 3px solid #788c5d; }
+        th.negative-col { border-bottom: 3px solid #c44; }
+        th.test-col.positive-col { border-bottom: 3px solid #788c5d; }
+        th.test-col.negative-col { border-bottom: 3px solid #c44; }
+        .legend { font-family: 'Poppins', sans-serif; display: flex; gap: 20px; margin-bottom: 10px; font-size: 13px; align-items: center; }
+        .legend-item { display: flex; align-items: center; gap: 6px; }
+        .legend-swatch { width: 16px; height: 16px; border-radius: 3px; display: inline-block; }
+        .swatch-positive { background: #141413; border-bottom: 3px solid #788c5d; }
+        .swatch-negative { background: #141413; border-bottom: 3px solid #c44; }
+        .swatch-test { background: #6a9bcc; }
+        .swatch-train { background: #141413; }
+    </style>
+</head>
+<body>
+    <h1>""" + title_prefix + """Skill Description Optimization</h1>
+    <div class="explainer">
+        <strong>Optimizing your skill's description.</strong> This page updates automatically as Claude tests different versions of your skill's description. Each row is an iteration — a new description attempt. The columns show test queries: green checkmarks mean the skill triggered correctly (or correctly didn't trigger), red crosses mean it got it wrong. The "Train" score shows performance on queries used to improve the description; the "Test" score shows performance on held-out queries the optimizer hasn't seen. When it's done, Claude will apply the best-performing description to your skill.
+    </div>
+"""]
+    # Summary section
+    best_test_score = data.get('best_test_score')
+    best_train_score = data.get('best_train_score')
+    html_parts.append(f"""
+    <div class="summary">
+        <p><strong>Original:</strong> {html.escape(data.get('original_description', 'N/A'))}</p>
+        <p class="best"><strong>Best:</strong> {html.escape(data.get('best_description', 'N/A'))}</p>
+        <p><strong>Best Score:</strong> {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}</p>
+        <p><strong>Iterations:</strong> {data.get('iterations_run', 0)} | <strong>Train:</strong> {data.get('train_size', '?')} | <strong>Test:</strong> {data.get('test_size', '?')}</p>
+    </div>
+""")
+    # Legend
+    html_parts.append("""
+    <div class="legend">
+        <span style="font-weight:600">Query columns:</span>
+        <span class="legend-item"><span class="legend-swatch swatch-positive"></span> Should trigger</span>
+        <span class="legend-item"><span class="legend-swatch swatch-negative"></span> Should NOT trigger</span>
+        <span class="legend-item"><span class="legend-swatch swatch-train"></span> Train</span>
+        <span class="legend-item"><span class="legend-swatch swatch-test"></span> Test</span>
+    </div>
+""")
+    # Table header
+    html_parts.append("""
+    <div class="table-container">
+    <table>
+        <thead>
+            <tr>
+                <th>Iter</th>
+                <th>Train</th>
+                <th>Test</th>
+                <th class="query-col">Description</th>
+""")
+    # Add column headers for train queries
+    for qinfo in train_queries:
+        polarity = "positive-col" if qinfo["should_trigger"] else "negative-col"
+        html_parts.append(f'                <th class="{polarity}">{html.escape(qinfo["query"])}</th>\n')
+    # Add column headers for test queries (different color)
+    for qinfo in test_queries:
+        polarity = "positive-col" if qinfo["should_trigger"] else "negative-col"
+        html_parts.append(f'                <th class="test-col {polarity}">{html.escape(qinfo["query"])}</th>\n')
+    html_parts.append("""            </tr>
+        </thead>
+        <tbody>
+""")
+    # Find best iteration for highlighting
+    if test_queries:
+        best_iter = max(history, key=lambda h: h.get("test_passed") or 0).get("iteration")
+    else:
+        best_iter = max(history, key=lambda h: h.get("train_passed", h.get("passed", 0))).get("iteration")
+    # Add rows for each iteration
+    for h in history:
+        iteration = h.get("iteration", "?")
+        train_passed = h.get("train_passed", h.get("passed", 0))
+        train_total = h.get("train_total", h.get("total", 0))
+        test_passed = h.get("test_passed")
+        test_total = h.get("test_total")
+        description = h.get("description", "")
+        train_results = h.get("train_results", h.get("results", []))
+        test_results = h.get("test_results", [])
+        # Create lookups for results by query
+        train_by_query = {r["query"]: r for r in train_results}
+        test_by_query = {r["query"]: r for r in test_results} if test_results else {}
+        # Compute aggregate correct/total runs across all retries
+        def aggregate_runs(results: list[dict]) -> tuple[int, int]:
+            correct = 0
+            total = 0
+            for r in results:
+                runs = r.get("runs", 0)
+                triggers = r.get("triggers", 0)
+                total += runs
+                if r.get("should_trigger", True):
+                    correct += triggers
+                else:
+                    correct += runs - triggers
+            return correct, total
+        train_correct, train_runs = aggregate_runs(train_results)
+        test_correct, test_runs = aggregate_runs(test_results)
+        # Determine score classes
+        def score_class(correct: int, total: int) -> str:
+            if total > 0:
+                ratio = correct / total
+                if ratio >= 0.8:
+                    return "score-good"
+                elif ratio >= 0.5:
+                    return "score-ok"
+            return "score-bad"
+        train_class = score_class(train_correct, train_runs)
+        test_class = score_class(test_correct, test_runs)
+        row_class = "best-row" if iteration == best_iter else ""
+        html_parts.append(f"""            <tr class="{row_class}">
+                <td>{iteration}</td>
+                <td><span class="score {train_class}">{train_correct}/{train_runs}</span></td>
+                <td><span class="score {test_class}">{test_correct}/{test_runs}</span></td>
+                <td class="description">{html.escape(description)}</td>
+""")
+        # Add result for each train query
+        for qinfo in train_queries:
+            r = train_by_query.get(qinfo["query"], {})
+            did_pass = r.get("pass", False)
+            triggers = r.get("triggers", 0)
+            runs = r.get("runs", 0)
+            icon = "✓" if did_pass else "✗"
+            css_class = "pass" if did_pass else "fail"
+            html_parts.append(f'                <td class="result {css_class}">{icon}<span class="rate">{triggers}/{runs}</span></td>\n')
+        # Add result for each test query (with different background)
+        for qinfo in test_queries:
+            r = test_by_query.get(qinfo["query"], {})
+            did_pass = r.get("pass", False)
+            triggers = r.get("triggers", 0)
+            runs = r.get("runs", 0)
+            icon = "✓" if did_pass else "✗"
+            css_class = "pass" if did_pass else "fail"
+            html_parts.append(f'                <td class="result test-result {css_class}">{icon}<span class="rate">{triggers}/{runs}</span></td>\n')
+        html_parts.append("            </tr>\n")
+    html_parts.append("""        </tbody>
+    </table>
+    </div>
+""")
+    html_parts.append("""
+</body>
+</html>
+""")
+    return "".join(html_parts)
+def main():
+    parser = argparse.ArgumentParser(description="Generate HTML report from run_loop output")
+    parser.add_argument("input", help="Path to JSON output from run_loop.py (or - for stdin)")
+    parser.add_argument("-o", "--output", default=None, help="Output HTML file (default: stdout)")
+    parser.add_argument("--skill-name", default="", help="Skill name to include in the report title")
+    args = parser.parse_args()
+    if args.input == "-":
+        data = json.load(sys.stdin)
+    else:
+        data = json.loads(Path(args.input).read_text())
+    html_output = generate_html(data, skill_name=args.skill_name)
+    if args.output:
+        Path(args.output).write_text(html_output)
+        print(f"Report written to {args.output}", file=sys.stderr)
+    else:
+        print(html_output)
+if __name__ == "__main__":
+    main()