fix: added ambigous rule count on PR comment

Author: harris-ranque

src/event_processors/pull_request/processor.py

@@ -85,6 +85,8 @@ async def process(self, task: Task) -> ProcessingResult:
             # Agentic: scan repo only when relevant (PR targets default branch)
             # Use the PR head ref so we scan the branch being proposed, not main.
             suggested_rules_yaml: str | None = None
+            suggested_rules_translated = 0
+            suggested_rules_ambiguous: list[Any] = []
             if is_relevant_pr(task.payload):
                 scan_start = time.time()
                 try:
@@ -108,6 +110,8 @@ async def process(self, task: Task) -> ProcessingResult:
                             "from_agent": from_agent,
                         },
                     )
+                    suggested_rules_translated = rules_count
+                    suggested_rules_ambiguous = list(ambiguous) if ambiguous else []
                     if rules_count > 0:
                         suggested_rules_yaml = rules_yaml
                 except Exception:
@@ -196,6 +200,20 @@ async def process(self, task: Task) -> ProcessingResult:
                 except yaml.YAMLError as e:
                     logger.warning("Failed to parse suggested rules YAML: %s", e)
 
+            # Surface translation summary to the user (parity with push-event PR body)
+            # Post when we have any scan result: translated and/or ambiguous, so users see X enforced and Y not translated
+            if pr_number and (suggested_rules_translated > 0 or suggested_rules_ambiguous):
+                try:
+                    comment_body = github_formatter.format_suggested_rules_ambiguous_comment(
+                        rules_translated=suggested_rules_translated,
+                        ambiguous=suggested_rules_ambiguous,
+                    )
+                    await self.github_client.create_pull_request_comment(
+                        repo_full_name, pr_number, comment_body, installation_id
+                    )
+                except Exception as comment_err:
+                    logger.warning("Could not post suggested-rules translation summary comment: %s", comment_err)
+
             # 3. Check for existing acknowledgments
             previous_acknowledgments = {}
             if pr_number:

src/presentation/github_formatter.py

@@ -190,6 +190,45 @@ def format_rules_not_configured_comment(
     )
 
 
+def format_suggested_rules_ambiguous_comment(
+    rules_translated: int,
+    ambiguous: list[dict[str, Any]],
+    max_statement_len: int = 200,
+    max_reason_len: int = 150,
+) -> str:
+    """Format a PR comment when some AI rule statements could not be translated (parity with push PR body)."""
+    count = len(ambiguous)
+    lines = [
+        "## Watchflow: Translation summary (AI rule files)",
+        "",
+        "**Translation summary:**",
+        f"- {rules_translated} rule(s) successfully translated and enforced as pre-merge checks.",
+        f"- {count} rule statement(s) could not be translated (low confidence or infeasible).",
+        "",
+    ]
+    if ambiguous:
+        lines.append("**Could not be translated:**")
+        lines.append("")
+        for i, item in enumerate(ambiguous[:20], 1):  # cap at 20 for comment length
+            st = (item.get("statement") or "") if isinstance(item, dict) else ""
+            path = (item.get("path") or "") if isinstance(item, dict) else ""
+            reason = (item.get("reason") or "") if isinstance(item, dict) else ""
+            if len(st) > max_statement_len:
+                st = st[:max_statement_len].rstrip() + "…"
+            if len(reason) > max_reason_len:
+                reason = reason[:max_reason_len].rstrip() + "…"
+            lines.append(f"{i}. `{path}`: {st}")
+            if reason:
+                lines.append(f"   - *Reason:* {reason}")
+            lines.append("")
+        if len(ambiguous) > 20:
+            lines.append(f"*…and {len(ambiguous) - 20} more.*")
+            lines.append("")
+    lines.append("---")
+    lines.append("*This comment was automatically posted by [Watchflow](https://watchflow.dev).*")
+    return "\n".join(lines)
+
+
 def format_violations_comment(violations: list[Violation], content_hash: str | None = None) -> str:
     """Format violations as a GitHub comment.