evolution-engine 0.3.1__tar.gz → 0.3.3__tar.gz

{evolution_engine-0.3.1/evolution_engine.egg-info → evolution_engine-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evolution-engine
-Version: 0.3.1
+Version: 0.3.3
 Summary: Git-native codebase evolution indexer
 Author: Slava
 License: BSL-1.1

{evolution_engine-0.3.1 → evolution_engine-0.3.3}/evolution/friendly.py

@@ -106,7 +106,7 @@ _METRIC_INSIGHTS = {
     ("change_locality", "up"): "The changed files frequently change together, suggesting a focused modification.",
     ("change_locality", "down"): "The changed files don't usually change together, suggesting a cross-cutting modification.",
     ("cochange_novelty_ratio", "up"): "Many file pairings in this change haven't been seen together before.",
-    ("cochange_novelty_ratio", "down"): "This change follows well-established patterns of file co-changes.",
+    ("cochange_novelty_ratio", "down"): "Unusually low novelty — changes are more repetitive than normal, touching only well-known file combinations.",
 
     # CI metrics
     ("run_duration", "up"): "Build took longer than usual.",
@@ -336,9 +336,9 @@ _PATTERN_RISK = {
         "Investigate which files are being combined unexpectedly. Prioritize testing these changes.",
     ),
     ("cochange_novelty_ratio", "down"): (
-        "positive",
-        "Changes follow well-established file co-change patterns. The code paths being modified have been tested together before.",
-        "No action needed. This indicates stable, predictable development.",
+        "info",
+        "File co-change novelty is unusually low. While familiar patterns reduce risk, this could indicate repetitive or mechanical changes rather than normal development.",
+        "Review whether recent commits are routine maintenance or a sign of narrow, repetitive modifications that lack expected variety.",
     ),
     # Change locality
     ("change_locality", "up"): (

evolution_engine-0.3.3/evolution/i18n/__init__.py

@@ -0,0 +1,97 @@
+"""
+Report i18n — lightweight translation helper for HTML report generation.
+
+Loads JSON translation files from this package directory and provides
+a _t(key) lookup function used by report_generator.py.
+"""
+
+import json
+import locale
+import os
+from pathlib import Path
+
+SUPPORTED_LANGS = ("en", "de", "es")
+_translations: dict = {}
+_current_lang: str = "en"
+
+
+def _detect_lang() -> str:
+    """Detect language from env, config, or system locale."""
+    # 1. Explicit EVO_LANG env var
+    env_lang = os.environ.get("EVO_LANG", "").lower()
+    if env_lang in SUPPORTED_LANGS:
+        return env_lang
+
+    # 2. User config (~/.evo/config.toml)
+    try:
+        from evolution.config import get_config
+        cfg_lang = get_config("lang", "").lower()
+        if cfg_lang in SUPPORTED_LANGS:
+            return cfg_lang
+    except Exception:
+        pass
+
+    # 3. System locale
+    try:
+        sys_locale = locale.getlocale()[0] or ""
+        prefix = sys_locale.split("_")[0].lower()
+        if prefix in SUPPORTED_LANGS:
+            return prefix
+    except Exception:
+        pass
+
+    return "en"
+
+
+def load_translations(lang: str = None) -> dict:
+    """Load translation dict for the given language (or auto-detect)."""
+    global _translations, _current_lang
+
+    if lang is None:
+        lang = _detect_lang()
+    if lang not in SUPPORTED_LANGS:
+        lang = "en"
+
+    _current_lang = lang
+    json_path = Path(__file__).parent / f"{lang}.json"
+    if not json_path.exists():
+        # Fallback to English
+        json_path = Path(__file__).parent / "en.json"
+        _current_lang = "en"
+
+    _translations = json.loads(json_path.read_text())
+    return _translations
+
+
+def t(key: str, **kwargs) -> str:
+    """Look up a translation key (dot-separated) with optional formatting.
+
+    Example: t("cover.title") → "Evolution Advisory"
+             t("exec.based_on", n=20) → "Based on 20 prior commits"
+    """
+    if not _translations:
+        load_translations()
+
+    parts = key.split(".")
+    val = _translations
+    for p in parts:
+        if isinstance(val, dict):
+            val = val.get(p)
+        else:
+            return key  # key not found, return as-is
+
+    if val is None:
+        return key
+
+    if kwargs and isinstance(val, str):
+        try:
+            return val.format(**kwargs)
+        except (KeyError, IndexError):
+            return val
+
+    return val if isinstance(val, str) else key
+
+
+def get_lang() -> str:
+    """Return the currently active language code."""
+    return _current_lang

evolution_engine-0.3.3/evolution/i18n/de.json

@@ -0,0 +1,250 @@
+{
+  "cover": {
+    "title": "Evolution Advisory",
+    "project": "Projekt:",
+    "period": "Zeitraum:",
+    "period_to": "bis",
+    "advisory_id": "Advisory-ID:",
+    "generated": "Erstellt:"
+  },
+  "exec": {
+    "title": "Zusammenfassung",
+    "significant_changes": "Signifikante Änderungen",
+    "areas_affected": "Betroffene Bereiche",
+    "patterns_matched": "Erkannte Muster",
+    "new_observations": "Neue Beobachtungen",
+    "events_analyzed": "Analysierte Ereignisse",
+    "signals_computed": "Berechnete Signale",
+    "affected_areas": "Betroffene Bereiche:",
+    "based_on": "Basierend auf {n} vorherigen Commit{s}",
+    "commit_plural": "s",
+    "commit_singular": ""
+  },
+  "verify": {
+    "title": "Fix-Verifizierung: {status}",
+    "subtitle": "Vergleich mit vorheriger Analyse",
+    "all_resolved": "Alle Probleme behoben",
+    "progress": "Fortschritt erkannt",
+    "no_change": "Noch keine Änderung",
+    "resolved": "Behoben",
+    "improving": "verbessert sich",
+    "not_improving": "verbessert sich nicht",
+    "returned_normal": "auf Normalwert zurückgekehrt",
+    "stabilized": "auf neuem Niveau stabilisiert",
+    "still_deviating": "weicht noch aktiv ab",
+    "new": "Neu",
+    "chip_resolved": "{n} behoben",
+    "chip_improving": "{n} verbessert",
+    "chip_not_improving": "{n} nicht verbessert",
+    "chip_new": "{n} neu",
+    "th_area": "Bereich",
+    "th_signal": "Signal",
+    "th_before": "Vorher",
+    "th_after_normal": "Nachher / Normal",
+    "th_trend": "Trend",
+    "transient_title": "Vorübergehender Ausreißer:",
+    "transient_text": "Einmaliger Ausreißer eines älteren Commits. Die Metrik ist inzwischen zur Baseline zurückgekehrt. Kann sicher akzeptiert werden.",
+    "stabilized_title": "Stabilisierte Abweichung:",
+    "stabilized_text": "Ein älterer Commit hat diese Metrik auf ein neues Niveau verschoben und sie ist dort geblieben. Das statistische Modell hat die Änderung absorbiert, aber der Wert unterscheidet sich von der ursprünglichen Baseline. Prüfen Sie, ob diese Verschiebung beabsichtigt war.",
+    "active_title": "Aktive Abweichung:",
+    "active_text": "Diese Metrik weicht in den aktuellen Daten noch aktiv ab. Eine Untersuchung wird empfohlen."
+  },
+  "findings": {
+    "title": "Hauptergebnisse",
+    "empty": "Keine ungewöhnlichen Aktivitäten erkannt. Die Entwicklungsmuster Ihres Projekts liegen im Normalbereich.",
+    "significant": "{fam} zeigte signifikante Abweichungen bei {metrics}.",
+    "moderate": "{fam} zeigte moderate Abweichungen bei {metrics}.",
+    "minor": "{fam} zeigte geringfügige Abweichungen bei {metrics}.",
+    "known_patterns": "{n} bekannte{s} Muster erkannt",
+    "new_patterns": "{n} neue{s} Muster entdeckt"
+  },
+  "changes": {
+    "title": "Was hat sich in Ihrem Code geändert",
+    "empty": "Keine ungewöhnlichen Änderungen erkannt.",
+    "detected": "Wir haben {n} Änderung{s} erkannt, die von den normalen Mustern Ihres Projekts abweichen. Jede Änderung zeigt, was typischerweise passiert im Vergleich zu dem, was diesmal beobachtet wurde.",
+    "accepted_not_shown": "{n} akzeptierte Abweichung{s} nicht angezeigt:",
+    "accepted_hint": "Diese wurden zuvor geprüft und als erwartet markiert. Verwalten mit <code>evo accept --list</code>",
+    "filter_all": "Alle",
+    "filter_critical": "Kritisch",
+    "filter_medium": "Mittel",
+    "filter_low": "Niedrig",
+    "resolved_of": "{resolved} von {total} behoben"
+  },
+  "card": {
+    "what_this_means": "Was das bedeutet:",
+    "was_compared": "{metric} war {value}, verglichen mit dem typischen Wert von {median}.",
+    "show_technical": "Technische Details anzeigen",
+    "technical_text": "Der Wert von {metric} für diese Änderung war {value}. Historisch hatten ähnliche Änderungen einen Wert von {median}.",
+    "typical": "Typisch:",
+    "this_time": "Diesmal:",
+    "above_range": "{dev}x über dem typischen Bereich",
+    "below_range": "{dev}x unter dem typischen Bereich",
+    "accept_expected": "Akzeptieren — Erwartet",
+    "accept_permanent": "Dauerhaft akzeptieren",
+    "accept_thisrun": "Nur für diesen Lauf akzeptieren",
+    "hint_permanent": "Dieses Signal nie wieder melden",
+    "hint_thisrun": "Jetzt verwerfen, bei nächster Analyse erneut melden",
+    "accepted": "Akzeptiert ✓",
+    "fix_with_ai": "Mit KI beheben",
+    "drift_prompt_title": "Drift-Untersuchungs-Prompt",
+    "copy": "Kopieren",
+    "use_with": "Verwenden mit:",
+    "cursor_hint": "Cursor — im Chat einfügen",
+    "claude_hint": "Claude Code — im Terminal einfügen",
+    "copilot_hint": "Copilot — im Chat-Panel einfügen",
+    "after_investigation": "Nach der Untersuchung:",
+    "after_step1": "KI schlägt Fixes vor → Änderungen auf Ihren Code anwenden",
+    "after_step2": "<code>evo analyze . --verify</code> ausführen, um erneut zu analysieren und mit diesem Lauf zu vergleichen",
+    "after_step3": "Wenn die Änderung beabsichtigt war, klicken Sie oben auf <strong>Akzeptieren</strong>, um sie zu verwerfen",
+    "trigger": "Auslöser:",
+    "still_elevated": "→ Noch erhöht (aktuelle Abweichung: {dev}σ)",
+    "returned_baseline": "↘ Zur Baseline zurückgekehrt"
+  },
+  "patterns": {
+    "title": "Muster",
+    "what_this_means": "Was das bedeutet:",
+    "recommendation": "Empfehlung:",
+    "similar_severity": "{n} Muster mit ähnlichem Schweregrad",
+    "show_more": "{n} weitere {heading} anzeigen",
+    "known_pattern": "Bekanntes Muster",
+    "new_pattern": "Neues Muster",
+    "emerging_pattern": "Entstehendes Muster",
+    "dedup_note": "{a} und {b} werden als verwandte Metriken behandelt",
+    "dedup_shown": "als einzelnes Muster angezeigt.",
+    "accepted_hidden": "{n} Muster nicht angezeigt (akzeptierte Metrik{ms}: {labels}).",
+    "what_are_patterns": "Was sind Muster?",
+    "what_are_patterns_text": "Muster sind wiederkehrende Korrelationen zwischen verschiedenen Bereichen Ihres Projekts. Wenn eine Änderung in einem Bereich (z. B. ein Deployment) konstant mit ungewöhnlichem Verhalten in einem anderen (z. B. Code-Streuung) zusammenfällt, melden wir es, damit Sie entscheiden können, ob es Aufmerksamkeit erfordert.",
+    "what_should_you_do": "Was sollten Sie tun?",
+    "what_should_you_do_text": "Konzentrieren Sie sich zuerst auf Einträge mit {action_required} oder {needs_attention}. Diese weisen auf Muster hin, die am ehesten Codequalität, Stabilität oder Sicherheit beeinträchtigen. Einträge mit {worth_monitoring} erfordern kein sofortiges Handeln, sollten aber überprüft werden, wenn sie anhalten. {healthy_pattern} und {informational} bestätigen, dass alles wie erwartet funktioniert.",
+    "supporting_evidence": "Unterstützende Nachweise",
+    "additional_insights_title": "Weitere Erkenntnisse"
+  },
+  "risk_banner": {
+    "critical_title": "Sofortige Überprüfung erforderlich",
+    "critical_text": "Ein oder mehrere Muster deuten auf ernsthafte Risiken hin, die Codequalität, Stabilität oder Sicherheit beeinträchtigen könnten. Überprüfen Sie die folgenden Einträge und beheben Sie \u201eHandlungsbedarf\u201c-Befunde vor Ihrem nächsten Release.",
+    "concern_title": "Aufmerksamkeit empfohlen",
+    "concern_text": "Einige Muster deuten auf sich entwickelnde Probleme hin, die sich verschlimmern könnten, wenn sie unbehandelt bleiben. Überprüfen Sie die mit \u201eBeobachtung nötig\u201c markierten Einträge und planen Sie Folgemaßnahmen.",
+    "watch_title": "Beobachtenswerte Trends",
+    "watch_text": "Mehrere Muster bewegen sich außerhalb des Normalbereichs. Keines erfordert sofortiges Handeln, aber die Beobachtung dieser Trends hilft, Probleme frühzeitig zu erkennen.",
+    "info_title": "Alles in Ordnung",
+    "info_text": "Erkannte Muster sind informativ oder gesund. Derzeit sind keine Maßnahmen erforderlich.",
+    "positive_title": "Sieht gut aus",
+    "positive_text": "Alle erkannten Muster sind gesund. Die Entwicklungsmuster Ihres Projekts funktionieren gut."
+  },
+  "severity": {
+    "action_required": "Handlungsbedarf",
+    "needs_attention": "Beobachtung nötig",
+    "worth_monitoring": "Beobachtenswert",
+    "healthy": "Gesundes Muster",
+    "informational": "Informativ"
+  },
+  "investigation": {
+    "title": "Nächste Schritte",
+    "prompt_title": "Untersuchungs-Prompt",
+    "step1_title": "Untersuchen",
+    "step1_text": "Kopieren Sie den Prompt unten und fügen Sie ihn in Ihren KI-Assistenten ein (Claude Code, Cursor, Copilot, ChatGPT). Er identifiziert Ursachen und schlägt Fixes vor.",
+    "step2_title": "Beheben",
+    "step2_text": "Wenden Sie die vorgeschlagenen Änderungen an. Wenn eine Abweichung beabsichtigt war, klicken Sie stattdessen auf <strong>Akzeptieren</strong> auf der zugehörigen Karte oben.",
+    "step3_title": "Verifizieren",
+    "step3_text": "Führen Sie <code>evo analyze . --verify</code> aus, um erneut zu analysieren und zu vergleichen. Ein Verifizierungsbanner zeigt, welche Abweichungen behoben, verbessert oder bestehen geblieben sind.",
+    "copy_prompt": "Prompt in Zwischenablage kopieren",
+    "save_prompt": "Prompt in Datei speichern",
+    "show_full": "Vollständigen Prompt anzeigen",
+    "show_full_hint": "Klicken Sie auf \u201eVollständigen Prompt anzeigen\u201c, um den kompletten Untersuchungs-Prompt mit Belegen zu sehen..."
+  },
+  "sources": {
+    "title": "Was EE sehen kann",
+    "subtitle_connected": "{n} verbunden",
+    "subtitle_available": ", {n} verfügbar",
+    "active": "Aktiv",
+    "not_connected": "Nicht verbunden",
+    "config_detected": "Konfiguration erkannt",
+    "connected": "Verbunden",
+    "connected_no_data": "Verbunden — Keine Daten",
+    "connected_no_deviations": "Verbunden — Keine Abweichungen",
+    "api_error": "API-Fehler",
+    "platform_mismatch": "Plattform-Abweichung",
+    "pro": "Pro",
+    "signals_analyzed": "{n} Signal{s} analysiert — alle im Normalbereich",
+    "pro_available": "Verfügbar mit Evolution Engine Pro.",
+    "see_plans": "Preise ansehen →",
+    "setup_guide": "Einrichtungsanleitung →",
+    "auto_detected": "Automatisch aus Dateien erkannt",
+    "token_set": "Token gesetzt. Diese Daten werden automatisch analysiert, wenn sie über GitHub Action oder GitLab CI ausgeführt werden.",
+    "connected_no_data_default": "Keine Ereignisse im Analysezeitraum gefunden.",
+    "ci_no_runs": "Keine Pipeline-Läufe im Analysezeitraum gefunden.",
+    "deployment_no_releases": "Keine veröffentlichten Releases im Analysezeitraum gefunden.",
+    "security_clean": "Keine Sicherheitswarnungen gefunden — Ihre Abhängigkeiten sind sauber.",
+    "error_no_events": "Keine Fehlerereignisse im Analysezeitraum gefunden.",
+    "testing_no_files": "Keine Testergebnis-Dateien (JUnit XML) gefunden.",
+    "coverage_no_files": "Keine Coverage-Dateien (Cobertura XML) gefunden.",
+    "via": "über"
+  },
+  "adapters": {
+    "title": "Erweitern Sie Ihre Abdeckung",
+    "intro": "Evolution Engine verfügt über <strong>{n} universelle Muster</strong>, die aus über 200 Open-Source-Repositories gelernt wurden. Je mehr Signalfamilien Sie verbinden, desto mehr familienübergreifende Muster können erkannt werden.",
+    "available_title": "Verfügbare Adapter",
+    "available_subtitle": "Aktivieren Sie diese Adapter, um zusätzliche Signalfamilien und familienübergreifende Mustererkennung freizuschalten.",
+    "how_to_title": "So verbinden Sie einen Adapter",
+    "step1": "<strong>Setzen Sie die Umgebungsvariable</strong>, die auf der Adapter-Karte angezeigt wird. Zum Beispiel: <code>export GITHUB_TOKEN=$(gh auth token)</code>",
+    "step2": "<strong>Für dateibasierte Adapter</strong> (Testing, Coverage): Erzeugen Sie zuerst Berichte in Ihrem Projekt. Zum Beispiel: <code>pytest --junitxml=junit.xml</code> oder <code>pytest --cov --cov-report=xml</code>",
+    "step3": "<strong>Analyse ausführen</strong>: <code>evo analyze .</code> — neue Adapter werden automatisch erkannt",
+    "step4": "<strong>Überprüfen</strong>: <code>evo sources</code> um zu bestätigen, welche Adapter aktiv sind",
+    "coming_soon": "Demnächst:"
+  },
+  "footer": {
+    "generated_by": "Erstellt von <strong>CodeQual</strong> Evolution Engine",
+    "advisory_line": "Advisory-ID: {id} • {date}",
+    "ai_disclaimer": "Diese Untersuchung wurde mit Unterstützung von künstlicher Intelligenz (Claude by Anthropic) erstellt. KI-generierte Inhalte sollten von einem Entwickler überprüft werden, bevor Empfehlungen umgesetzt werden."
+  },
+  "families": {
+    "git": "Versionskontrolle",
+    "version_control": "Versionskontrolle",
+    "ci": "CI / Build",
+    "testing": "Testing",
+    "coverage": "Code-Abdeckung",
+    "dependency": "Abhängigkeiten",
+    "schema": "API / Schema",
+    "deployment": "Deployment",
+    "config": "Konfiguration",
+    "security": "Sicherheit",
+    "error_tracking": "Fehlerverfolgung",
+    "monitoring": "Überwachung",
+    "quality_gate": "Quality Gate",
+    "security_scan": "Sicherheitsscan",
+    "incidents": "Vorfälle",
+    "work_items": "Arbeitspakete",
+    "feature_flags": "Feature Flags"
+  },
+  "metrics": {
+    "files_touched": "Geänderte Dateien",
+    "dispersion": "Änderungsstreuung",
+    "change_locality": "Änderungslokalität",
+    "cochange_novelty_ratio": "Co-Change-Neuheit",
+    "run_duration": "Build-Dauer",
+    "run_failed": "Build-Fehler",
+    "total_tests": "Testanzahl",
+    "skip_rate": "Übersprungrate",
+    "suite_duration": "Suite-Dauer",
+    "line_rate": "Zeilenabdeckung",
+    "branch_rate": "Branchabdeckung",
+    "dependency_count": "Abhängigkeiten gesamt",
+    "max_depth": "Abhängigkeitstiefe",
+    "endpoint_count": "API-Endpunkte",
+    "type_count": "API-Typen",
+    "field_count": "API-Felder",
+    "schema_churn": "Schema-Fluktuation",
+    "release_cadence_hours": "Release-Kadenz",
+    "is_prerelease": "Pre-Release",
+    "asset_count": "Release-Artefakte",
+    "resource_count": "Ressourcen",
+    "resource_type_count": "Ressourcentypen",
+    "config_churn": "Konfigurations-Fluktuation",
+    "vulnerability_count": "Schwachstellen",
+    "critical_count": "Kritische Schwachstellen",
+    "fixable_ratio": "Behebbar-Anteil",
+    "event_count": "Fehlerereignisse",
+    "user_count": "Betroffene Nutzer",
+    "is_unhandled": "Unbehandelte Ausnahme"
+  }
+}

evolution_engine-0.3.3/evolution/i18n/en.json

@@ -0,0 +1,250 @@
+{
+  "cover": {
+    "title": "Evolution Advisory",
+    "project": "Project:",
+    "period": "Period:",
+    "period_to": "to",
+    "advisory_id": "Advisory ID:",
+    "generated": "Generated:"
+  },
+  "exec": {
+    "title": "Executive Summary",
+    "significant_changes": "Significant Changes",
+    "areas_affected": "Areas Affected",
+    "patterns_matched": "Patterns Matched",
+    "new_observations": "New Observations",
+    "events_analyzed": "Events Analyzed",
+    "signals_computed": "Signals Computed",
+    "affected_areas": "Affected areas:",
+    "based_on": "Based on {n} prior commit{s}",
+    "commit_plural": "s",
+    "commit_singular": ""
+  },
+  "verify": {
+    "title": "Fix Verification: {status}",
+    "subtitle": "Comparing against previous analysis",
+    "all_resolved": "All issues resolved",
+    "progress": "Progress detected",
+    "no_change": "No change yet",
+    "resolved": "Resolved",
+    "improving": "improving",
+    "not_improving": "not improving",
+    "returned_normal": "returned to normal",
+    "stabilized": "stabilized at new level",
+    "still_deviating": "still actively deviating",
+    "new": "New",
+    "chip_resolved": "{n} resolved",
+    "chip_improving": "{n} improving",
+    "chip_not_improving": "{n} not improving",
+    "chip_new": "{n} new",
+    "th_area": "Area",
+    "th_signal": "Signal",
+    "th_before": "Before",
+    "th_after_normal": "After / Normal",
+    "th_trend": "Trend",
+    "transient_title": "Transient spike:",
+    "transient_text": "One-time spike from an older commit. The metric has since returned to its baseline. Safe to accept.",
+    "stabilized_title": "Stabilized drift:",
+    "stabilized_text": "An older commit shifted this metric to a new level and it stayed there. The statistical model absorbed the change, but the value differs from the original baseline. Consider whether this shift was intentional.",
+    "active_title": "Active deviation:",
+    "active_text": "This metric is still actively deviating in the latest data. Investigation recommended."
+  },
+  "findings": {
+    "title": "Key Findings",
+    "empty": "No unusual activity detected. Your project's development patterns are within normal ranges.",
+    "significant": "{fam} showed significant deviations in {metrics}.",
+    "moderate": "{fam} showed moderate deviations in {metrics}.",
+    "minor": "{fam} showed minor deviations in {metrics}.",
+    "known_patterns": "{n} known pattern{s} detected",
+    "new_patterns": "{n} new pattern{s} discovered"
+  },
+  "changes": {
+    "title": "What Changed in Your Codebase",
+    "empty": "No unusual changes detected.",
+    "detected": "We've detected {n} change{s} that differ from your project's normal patterns. Each change shows what typically happens versus what we observed this time.",
+    "accepted_not_shown": "{n} accepted deviation{s} not shown:",
+    "accepted_hint": "These were previously reviewed and marked as expected. Manage with <code>evo accept --list</code>",
+    "filter_all": "All",
+    "filter_critical": "Critical",
+    "filter_medium": "Medium",
+    "filter_low": "Low",
+    "resolved_of": "{resolved} of {total} resolved"
+  },
+  "card": {
+    "what_this_means": "What this means:",
+    "was_compared": "{metric} was {value}, compared to the typical value of {median}.",
+    "show_technical": "Show technical details",
+    "technical_text": "The {metric} for this change was {value}. Historically, similar changes had a value of {median}.",
+    "typical": "Typical:",
+    "this_time": "This Time:",
+    "above_range": "{dev}x above typical range",
+    "below_range": "{dev}x below typical range",
+    "accept_expected": "Accept — Expected",
+    "accept_permanent": "Accept permanently",
+    "accept_thisrun": "Accept for this run only",
+    "hint_permanent": "Never flag this signal again",
+    "hint_thisrun": "Dismiss now, flag again next analysis",
+    "accepted": "Accepted ✓",
+    "fix_with_ai": "Fix with AI",
+    "drift_prompt_title": "Drift Investigation Prompt",
+    "copy": "Copy",
+    "use_with": "Use with:",
+    "cursor_hint": "Cursor — paste in chat",
+    "claude_hint": "Claude Code — paste in terminal",
+    "copilot_hint": "Copilot — paste in chat panel",
+    "after_investigation": "After investigation:",
+    "after_step1": "AI suggests fixes → apply the changes to your code",
+    "after_step2": "Run <code>evo analyze . --verify</code> to re-analyze and compare against this run",
+    "after_step3": "If the change was intentional, click <strong>Accept</strong> above to dismiss it",
+    "trigger": "Trigger:",
+    "still_elevated": "→ Still elevated (latest deviation: {dev}σ)",
+    "returned_baseline": "↘ Returned to baseline"
+  },
+  "patterns": {
+    "title": "Patterns",
+    "what_this_means": "What this means:",
+    "recommendation": "Recommendation:",
+    "similar_severity": "{n} similar-severity patterns",
+    "show_more": "Show {n} more {heading}",
+    "known_pattern": "Known Pattern",
+    "new_pattern": "New Pattern",
+    "emerging_pattern": "Emerging Pattern",
+    "dedup_note": "{a} and {b} are treated as related metrics",
+    "dedup_shown": "shown as a single pattern.",
+    "accepted_hidden": "{n} pattern{s} not shown (accepted metric{ms}: {labels}).",
+    "what_are_patterns": "What are patterns?",
+    "what_are_patterns_text": "Patterns are recurring correlations between different areas of your project. When a change in one area (e.g. a deployment) consistently coincides with unusual behavior in another (e.g. code dispersion), we flag it so you can decide if it needs attention.",
+    "what_should_you_do": "What should you do?",
+    "what_should_you_do_text": "Focus on items marked {action_required} or {needs_attention} first. These indicate patterns that are most likely to affect code quality, stability, or security. Items marked {worth_monitoring} don't need immediate action but should be reviewed if they persist. {healthy_pattern} and {informational} confirm that things are working as expected.",
+    "supporting_evidence": "Supporting Evidence",
+    "additional_insights_title": "Additional Insights"
+  },
+  "risk_banner": {
+    "critical_title": "Immediate Review Required",
+    "critical_text": "One or more patterns indicate serious risks that could affect code quality, stability, or security. Review the items below and address \"Action Required\" findings before your next release.",
+    "concern_title": "Attention Recommended",
+    "concern_text": "Some patterns suggest developing issues that could grow into problems if left unaddressed. Review the items marked \"Needs Attention\" and plan follow-up actions.",
+    "watch_title": "Trends Worth Watching",
+    "watch_text": "Several patterns are shifting outside normal ranges. None require immediate action, but monitoring these trends will help you catch issues early.",
+    "info_title": "All Clear",
+    "info_text": "Patterns detected are informational or healthy. No issues require attention at this time.",
+    "positive_title": "Looking Good",
+    "positive_text": "All detected patterns are healthy. Your project's development patterns are working well."
+  },
+  "severity": {
+    "action_required": "Action Required",
+    "needs_attention": "Needs Attention",
+    "worth_monitoring": "Worth Monitoring",
+    "healthy": "Healthy Pattern",
+    "informational": "Informational"
+  },
+  "investigation": {
+    "title": "Next Steps",
+    "prompt_title": "Investigation Prompt",
+    "step1_title": "Investigate",
+    "step1_text": "Copy the prompt below and paste it into your AI assistant (Claude Code, Cursor, Copilot, ChatGPT). It will identify root causes and suggest fixes.",
+    "step2_title": "Fix",
+    "step2_text": "Apply the suggested changes. If a deviation was intentional, click <strong>Accept</strong> on its card above instead.",
+    "step3_title": "Verify",
+    "step3_text": "Run <code>evo analyze . --verify</code> to re-analyze and compare. A verification banner will show which deviations resolved, improved, or persist.",
+    "copy_prompt": "Copy Prompt to Clipboard",
+    "save_prompt": "Save Prompt to File",
+    "show_full": "Show Full Prompt",
+    "show_full_hint": "Click \"Show Full Prompt\" to see the complete investigation prompt with evidence..."
+  },
+  "sources": {
+    "title": "What EE Can See",
+    "subtitle_connected": "{n} connected",
+    "subtitle_available": ", {n} available",
+    "active": "Active",
+    "not_connected": "Not Connected",
+    "config_detected": "Config Detected",
+    "connected": "Connected",
+    "connected_no_data": "Connected — No Data",
+    "connected_no_deviations": "Connected — No Deviations",
+    "api_error": "API Error",
+    "platform_mismatch": "Platform Mismatch",
+    "pro": "Pro",
+    "signals_analyzed": "{n} signal{s} analyzed — all within normal range",
+    "pro_available": "Available with Evolution Engine Pro.",
+    "see_plans": "See plans →",
+    "setup_guide": "Setup guide →",
+    "auto_detected": "Auto-detected from files",
+    "token_set": "Token set. This data is analyzed automatically when running via GitHub Action or GitLab CI.",
+    "connected_no_data_default": "No events found in the analysis window.",
+    "ci_no_runs": "No pipeline runs found in the analysis window.",
+    "deployment_no_releases": "No published releases found in the analysis window.",
+    "security_clean": "No security alerts found — your dependencies look clean.",
+    "error_no_events": "No error events found in the analysis window.",
+    "testing_no_files": "No test result files (JUnit XML) found.",
+    "coverage_no_files": "No coverage files (Cobertura XML) found.",
+    "via": "via"
+  },
+  "adapters": {
+    "title": "Expand Your Coverage",
+    "intro": "Evolution Engine has <strong>{n} universal patterns</strong> learned from 200+ open-source repositories. The more signal families you connect, the more cross-family patterns can be detected.",
+    "available_title": "Available Adapters",
+    "available_subtitle": "Enable these adapters to unlock additional signal families and cross-family pattern detection.",
+    "how_to_title": "How to Connect an Adapter",
+    "step1": "<strong>Set the environment variable</strong> shown on the adapter card. For example: <code>export GITHUB_TOKEN=$(gh auth token)</code>",
+    "step2": "<strong>For file-based adapters</strong> (Testing, Coverage): generate reports in your project first. For example, <code>pytest --junitxml=junit.xml</code> or <code>pytest --cov --cov-report=xml</code>",
+    "step3": "<strong>Run analysis</strong>: <code>evo analyze .</code> — new adapters are detected automatically",
+    "step4": "<strong>Verify</strong>: <code>evo sources</code> to confirm which adapters are active",
+    "coming_soon": "Coming soon:"
+  },
+  "footer": {
+    "generated_by": "Generated by <strong>CodeQual</strong> Evolution Engine",
+    "advisory_line": "Advisory ID: {id} • {date}",
+    "ai_disclaimer": "This investigation was generated with the assistance of artificial intelligence (Claude by Anthropic). AI-generated content should be reviewed by a developer before acting upon recommendations."
+  },
+  "families": {
+    "git": "Version Control",
+    "version_control": "Version Control",
+    "ci": "CI / Build",
+    "testing": "Testing",
+    "coverage": "Code Coverage",
+    "dependency": "Dependencies",
+    "schema": "API / Schema",
+    "deployment": "Deployment",
+    "config": "Configuration",
+    "security": "Security",
+    "error_tracking": "Error Tracking",
+    "monitoring": "Monitoring",
+    "quality_gate": "Quality Gate",
+    "security_scan": "Security Scan",
+    "incidents": "Incidents",
+    "work_items": "Work Items",
+    "feature_flags": "Feature Flags"
+  },
+  "metrics": {
+    "files_touched": "Files Changed",
+    "dispersion": "Change Dispersion",
+    "change_locality": "Change Locality",
+    "cochange_novelty_ratio": "Co-change Novelty",
+    "run_duration": "Build Duration",
+    "run_failed": "Build Failure",
+    "total_tests": "Test Count",
+    "skip_rate": "Skip Rate",
+    "suite_duration": "Suite Duration",
+    "line_rate": "Line Coverage",
+    "branch_rate": "Branch Coverage",
+    "dependency_count": "Total Dependencies",
+    "max_depth": "Dependency Depth",
+    "endpoint_count": "API Endpoints",
+    "type_count": "API Types",
+    "field_count": "API Fields",
+    "schema_churn": "Schema Churn",
+    "release_cadence_hours": "Release Cadence",
+    "is_prerelease": "Pre-release",
+    "asset_count": "Release Assets",
+    "resource_count": "Resources",
+    "resource_type_count": "Resource Types",
+    "config_churn": "Config Churn",
+    "vulnerability_count": "Vulnerabilities",
+    "critical_count": "Critical Vulnerabilities",
+    "fixable_ratio": "Fixable Ratio",
+    "event_count": "Error Occurrences",
+    "user_count": "Affected Users",
+    "is_unhandled": "Unhandled Exception"
+  }
+}