feat(v0.3.0): major update with custom rules, CI/CD action, AI remediation, and trend reporting

Author: codex

action.yml

@@ -0,0 +1,35 @@
+name: 'Roast My Code'
+description: 'Brutally honest, AI-powered code quality governance.'
+author: 'Rohan'
+inputs:
+  path:
+    description: 'Path to the directory to roast'
+    required: false
+    default: '.'
+  fail_under:
+    description: 'Exit with error if the roast score is below this value'
+    required: false
+    default: '0'
+  github_token:
+    description: 'GitHub token for private repository access'
+    required: false
+    default: ${{ github.token }}
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    - name: Install roast-my-code
+      shell: bash
+      run: pip install .
+    - name: Run Roast
+      shell: bash
+      env:
+        GITHUB_TOKEN: ${{ inputs.github_token }}
+      run: |
+        roast ${{ inputs.path }} --no-llm --fail-under ${{ inputs.fail_under }} --json-output roast-report.json
+branding:
+  icon: 'zap'
+  color: 'red'

pyproject.toml

@@ -13,6 +13,7 @@ dependencies = [
   "rich",
   "openai",
   "jinja2",
+  "pyyaml",
 ]
 
 [project.scripts]

roast/analyzer.py

@@ -8,6 +8,7 @@
 from typing import Literal
 
 from roast.scanner import FileResult
+from roast.custom_rules import load_custom_rules, CustomRule
 
 Severity = Literal["low", "medium", "high"]
 
@@ -279,8 +280,13 @@ def _detect_python_medium_severity(file: FileResult, issues: list[Issue], tree:
         )
 
     lines = file.content.splitlines()
+    custom_rules = load_custom_rules()
     if not _is_test_file(file.path):
         for idx, line in enumerate(lines, start=1):
+            for rule in custom_rules:
+                if re.search(rule.pattern, line):
+                    _add_issue(issues, file.path, idx, rule.category, rule.severity, rule.message)
+
             if re.search(r"\bprint\s*\(", line):
                 _add_issue(
                     issues,

roast/cli.py

@@ -11,6 +11,7 @@
 from urllib.error import HTTPError, URLError
 from urllib.parse import urlparse
 from urllib.request import Request, urlopen
+from datetime import datetime
 import zipfile
 
 import typer
@@ -22,6 +23,7 @@
 from roast.reporter import export_html_report, export_json_report, render_terminal_report
 from roast.roaster import DEFAULT_GROQ_MODEL, DEFAULT_NIM_MODEL, generate_roast
 from roast.scanner import scan_repo
+from roast.history import save_history
 
 app = typer.Typer(
     help="Brutally honest AI-powered code quality roaster.",
@@ -293,6 +295,15 @@ def roast(
         if json_output:
             export_json_report(report, roast_result, output_path=json_output)
         render_terminal_report(report, roast_result, output_path=output, console=console)
+        
+        # Save to history for trend tracking
+        save_history({
+            "timestamp": datetime.now().isoformat(),
+            "scores": report.scores,
+            "overall_score": report.scores.get("Overall", 0),
+            "verdict": roast_result.verdict,
+        })
+
         if json_output:
             console.print(f"[bold cyan]JSON report saved to: {Path(json_output).expanduser()}[/]")
 

roast/custom_rules.py

@@ -0,0 +1,36 @@
+import yaml
+import re
+import os
+from dataclasses import dataclass
+from typing import List, Optional
+
+@dataclass
+class CustomRule:
+    name: str
+    pattern: str
+    severity: str
+    message: str
+    category: str = "Code Quality"
+
+def load_custom_rules(config_path: str = ".roast.yaml") -> List[CustomRule]:
+    try:
+        if not os.path.exists(config_path):
+            return []
+        with open(config_path, "r") as f:
+            config = yaml.safe_load(f)
+            if not config or "rules" not in config:
+                return []
+            
+            rules = []
+            for r in config["rules"]:
+                rules.append(CustomRule(
+                    name=r["name"],
+                    pattern=r["pattern"],
+                    severity=r.get("severity", "medium"),
+                    message=r["message"],
+                    category=r.get("category", "Code Quality")
+                ))
+            return rules
+    except Exception as e:
+        print(f"Error loading custom rules: {e}")
+        return []

roast/history.py

@@ -0,0 +1,27 @@
+import json
+import os
+from datetime import datetime
+from pathlib import Path
+from typing import Dict, List
+
+HISTORY_DIR = Path(".roast/history")
+
+def save_history(report_data: Dict):
+    HISTORY_DIR.mkdir(parents=True, exist_ok=True)
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    filepath = HISTORY_DIR / f"scan_{timestamp}.json"
+    with open(filepath, "w") as f:
+        json.dump(report_data, f)
+
+def get_history() -> List[Dict]:
+    if not HISTORY_DIR.exists():
+        return []
+    
+    history = []
+    for filepath in sorted(HISTORY_DIR.glob("scan_*.json")):
+        with open(filepath, "r") as f:
+            try:
+                history.append(json.load(f))
+            except json.JSONDecodeError:
+                continue
+    return history

roast/reporter.py

@@ -16,6 +16,7 @@
 
 from roast.analyzer import AnalysisReport, Issue
 from roast.roaster import RoastResult
+from roast.history import get_history
 
 HEADER_ART = r"""
 ██████╗  ██████╗  █████╗ ███████╗████████╗
@@ -77,6 +78,8 @@ def build_report_payload(report: AnalysisReport, roast: RoastResult) -> dict[str
     category_counts = _issue_counts_by_category(report.issues)
     hotspots = _hotspot_files(report.issues)
     badge_color = _badge_markdown_color(overall_score)
+    history = get_history()
+    trend = [h["overall_score"] for h in history]
 
     return {
         "summary": {
@@ -85,6 +88,7 @@ def build_report_payload(report: AnalysisReport, roast: RoastResult) -> dict[str
             "total_issues": len(report.issues),
             "scores": report.scores,
         },
+        "trend": trend,
         "counts": {
             "by_severity": severity_counts,
             "by_category": category_counts,
@@ -214,31 +218,30 @@ def export_html_report(
     radius = 90
     circumference = 2 * pi * radius
     dash_offset = circumference * (1 - (overall_score / 100))
-    issue_rows = payload["issues"]
-    score_items = [
-        {
-            "name": "AI Slop",
-            "value": report.scores.get("AI Slop", 0),
-            "color": _badge_color(report.scores.get("AI Slop", 0)),
-        },
-        {
-            "name": "Code Quality",
-            "value": report.scores.get("Code Quality", 0),
-            "color": _badge_color(report.scores.get("Code Quality", 0)),
-        },
-        {
-            "name": "Style",
-            "value": report.scores.get("Style", 0),
-            "color": _badge_color(report.scores.get("Style", 0)),
-        },
-    ]
-
+    
     rendered = template.render(
+        payload=payload,
         report=report,
         roast=roast,
         overall_score=overall_score,
-        score_items=score_items,
-        issues=issue_rows,
+        score_items=[
+            {
+                "name": "AI Slop",
+                "value": report.scores.get("AI Slop", 0),
+                "color": _badge_color(report.scores.get("AI Slop", 0)),
+            },
+            {
+                "name": "Code Quality",
+                "value": report.scores.get("Code Quality", 0),
+                "color": _badge_color(report.scores.get("Code Quality", 0)),
+            },
+            {
+                "name": "Style",
+                "value": report.scores.get("Style", 0),
+                "color": _badge_color(report.scores.get("Style", 0)),
+            },
+        ],
+        issues=payload["issues"],
         severity_counts=payload["counts"]["by_severity"],
         category_counts=payload["counts"]["by_category"],
         hotspots=payload["hotspots"],

roast/roaster.py

@@ -28,6 +28,7 @@
 class RoastResult:
     headline: str
     roast_lines: list[str]
+    remediations: list[str]
     verdict: str
     verdict_emoji: str
 
@@ -85,8 +86,9 @@ def _build_user_prompt(report: AnalysisReport, files: list[FileResult]) -> str:
         "Generate:\n"
         "1. A one-liner headline roast\n"
         "2. 5-8 specific roast bullets\n"
-        "3. A verdict: SHIP IT (score >= 75), NEEDS WORK (40-74), BURN IT DOWN (<40)\n\n"
-        "Respond strictly as JSON with keys: headline, roast_lines, verdict, verdict_emoji."
+        "3. 3-5 specific refactoring/fix suggestions for the issues found\n"
+        "4. A verdict: SHIP IT (score >= 75), NEEDS WORK (40-74), BURN IT DOWN (<40)\n\n"
+        "Respond strictly as JSON with keys: headline, roast_lines, remediations, verdict, verdict_emoji."
     )
 
 
@@ -104,9 +106,16 @@ def _normalize_roast_payload(payload: dict[str, Any], overall_score: int) -> Roa
     if len(roast_lines) < 5:
         roast_lines.extend(_fallback_roast_lines(overall_score, needed=5 - len(roast_lines)))
 
+    remediations_raw = payload.get("remediations", [])
+    if not isinstance(remediations_raw, list):
+        remediations_raw = []
+    remediations = [str(r).strip() for r in remediations_raw if str(r).strip()]
+    remediations = remediations[:5]
+
     return RoastResult(
         headline=headline,
         roast_lines=roast_lines,
+        remediations=remediations,
         verdict=verdict,
         verdict_emoji=emoji,
     )
@@ -142,6 +151,7 @@ def _generate_fallback_roast(report: AnalysisReport) -> RoastResult:
     return RoastResult(
         headline=headline,
         roast_lines=_fallback_roast_lines(overall_score, needed=6),
+        remediations=["Refactor to remove AI slop", "Standardize naming conventions"],
         verdict=verdict,
         verdict_emoji=emoji,
     )

roast/templates/report.html

@@ -344,6 +344,16 @@ <h1>🔥 Roast My Code</h1>
 
     <section class="card">
       <h2>Scan Summary</h2>
+      {% if payload.trend|length > 1 %}
+      <div class="summary-card" style="margin-bottom: 20px;">
+        <h3>Score Trend</h3>
+        <div style="height: 100px; display: flex; align-items: flex-end; gap: 4px;">
+          {% for score in payload.trend %}
+          <div style="flex: 1; background: #6366f1; height: {{ score }}%;" title="Score: {{ score }}"></div>
+          {% endfor %}
+        </div>
+      </div>
+      {% endif %}
       <div class="summary-grid">
         <div class="summary-card">
           <h3>Severity Breakdown</h3>