Add Explain View run reports and RPG visualizer

CoderMind/.gitignore

@@ -239,3 +239,5 @@ plans/
 .mcp.json
 .github/agents/
 .github/prompts/
+
+.claude/commands/

CoderMind/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cmind-cli"
-version = "0.1.9"
+version = "0.1.10"
 description = "CoderMind CLI - A tool to generate feature trees for repository planning and code generation."
 requires-python = ">=3.12"
 dependencies = [

CoderMind/scripts/check_code_gen.py

@@ -13,9 +13,14 @@
 
 import json
 import argparse
+import sys
 from pathlib import Path
 from typing import Dict, Any, List, Tuple
 
+SCRIPTS_DIR = Path(__file__).resolve().parent
+if str(SCRIPTS_DIR) not in sys.path:
+    sys.path.insert(0, str(SCRIPTS_DIR))
+
 # Import centralized paths and state loader
 from common.paths import (
     TASKS_FILE,
@@ -24,6 +29,8 @@
     cmd_for,
     REPO_DIR,
 )
+from common.run_events import ArtifactEvent, CommandRun, StepEvent, VerificationEvent
+from common.run_report import write_command_report
 from common.execution_state import load_code_gen_state
 from common.execution_state import load_code_gen_state as _load_state, save_code_gen_state as _save_state
 from common.execution_state import complete_batch as _complete_batch
@@ -427,6 +434,46 @@ def determine_state(
     return result
 
 
+def _write_code_gen_report(result: Dict[str, Any]) -> str | None:
+    try:
+        stats = result.get("stats") or {}
+        report_path = write_command_report(CommandRun(
+            command="code_gen",
+            title="CoderMind code_gen Progress View",
+            status=result.get("type"),
+            summary=[
+                {"label": "state", "value": result.get("type", "")},
+                {"label": "total", "value": stats.get("total_tasks", 0)},
+                {"label": "completed", "value": stats.get("completed", 0)},
+                {"label": "failed", "value": stats.get("failed", 0)},
+                {"label": "remaining", "value": stats.get("remaining", 0)},
+                {"label": "current batch", "value": (result.get("current_batch") or {}).get("batch_id", "")},
+                {"label": "next batch", "value": result.get("next_batch", "")},
+            ],
+            steps=[
+                StepEvent(name="determine_state", status=result.get("type"), reason=result.get("message", "")),
+                StepEvent(name="current_batch", status=(result.get("current_batch") or {}).get("phase", "none"), reason=(result.get("current_batch") or {}).get("file_path", "")),
+                StepEvent(name="next_action", status="available" if result.get("next_action") else "missing", reason=result.get("next_action", "")),
+            ],
+            artifacts=[
+                ArtifactEvent(label="tasks", path=TASKS_FILE),
+                ArtifactEvent(label="code_gen_state", path=STATE_FILE),
+            ],
+            verification=[VerificationEvent(name="state", status=result.get("type"), detail=result.get("message", ""))],
+            evidence={
+                "type": result.get("type"),
+                "stats": stats,
+                "current_batch": result.get("current_batch"),
+                "next_batch": result.get("next_batch"),
+                "next_action": result.get("next_action"),
+            },
+        ))
+        return str(report_path)
+    except Exception as exc:
+        result["report_error"] = str(exc)
+        return None
+
+
 def print_status(result: Dict[str, Any], json_output: bool = False) -> None:
     """Print the status in human-readable or JSON format."""
     if json_output:
@@ -474,7 +521,9 @@ def print_status(result: Dict[str, Any], json_output: bool = False) -> None:
     # Next batch info
     if result.get("next_batch"):
         print(f"\n   Next Batch: {result['next_batch']}")
-
+    if result.get("report_path"):
+        print(f"\n   Report: {result['report_path']}")
+
     # Guidance
     print("\n   " + "─" * 60)
 
@@ -516,6 +565,9 @@ def main():
     args = parser.parse_args()
 
     result = determine_state(args.tasks, args.state)
+    report_path = _write_code_gen_report(result)
+    if report_path:
+        result["report_path"] = report_path
     print_status(result, json_output=args.json)
 
     # Return exit code based on state

CoderMind/scripts/common/diff_ranges.py

@@ -0,0 +1,107 @@
+"""Helpers for matching unified diffs to code entity line ranges."""
+
+from __future__ import annotations
+
+import re
+from typing import Any, Mapping, Sequence
+
+_HUNK_RE = re.compile(r"@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@")
+
+
+def _to_int(value: Any) -> int | None:
+    try:
+        return int(value)
+    except (TypeError, ValueError):
+        return None
+
+
+def merge_line_ranges(ranges: Sequence[tuple[int, int]]) -> list[tuple[int, int]]:
+    ordered = sorted((start, end) for start, end in ranges if start > 0 and end >= start)
+    merged: list[tuple[int, int]] = []
+    for start, end in ordered:
+        if not merged or start > merged[-1][1] + 1:
+            merged.append((start, end))
+        else:
+            merged[-1] = (merged[-1][0], max(merged[-1][1], end))
+    return merged
+
+
+def changed_line_ranges_from_diff(diff: Any) -> list[tuple[int, int]]:
+    if not isinstance(diff, str) or "@@" not in diff:
+        return []
+    ranges: list[tuple[int, int]] = []
+    new_line: int | None = None
+    for raw_line in diff.splitlines():
+        match = _HUNK_RE.search(raw_line)
+        if match:
+            new_line = int(match.group(1))
+            continue
+        if new_line is None:
+            continue
+        if raw_line.startswith("\\") or raw_line.startswith("+++") or raw_line.startswith("---"):
+            continue
+        prefix = raw_line[:1]
+        if prefix == "+":
+            ranges.append((new_line, new_line))
+            new_line += 1
+        elif prefix == "-":
+            continue
+        else:
+            new_line += 1
+    return merge_line_ranges(ranges)
+
+
+def changed_line_ranges_by_file(code_deltas: Sequence[Mapping[str, Any]]) -> dict[str, list[tuple[int, int]]]:
+    ranges_by_file: dict[str, list[tuple[int, int]]] = {}
+    for delta in code_deltas:
+        file_path = str(delta.get("file") or delta.get("path") or delta.get("after") or delta.get("before") or "")
+        if not file_path:
+            continue
+        ranges = changed_line_ranges_from_diff(delta.get("diff"))
+        if file_path in ranges_by_file:
+            ranges_by_file[file_path] = merge_line_ranges(ranges_by_file[file_path] + ranges)
+        else:
+            ranges_by_file[file_path] = ranges
+    return ranges_by_file
+
+
+def line_range_from_mapping(row: Mapping[str, Any]) -> tuple[int, int] | None:
+    nested = row.get("line_range") if isinstance(row.get("line_range"), Mapping) else {}
+    start = _to_int(nested.get("start") if nested else None)
+    end = _to_int(nested.get("end") if nested else None)
+    if start is None:
+        start = _to_int(
+            row.get("line_start")
+            or row.get("start_line")
+            or row.get("lineno")
+            or row.get("line")
+            or row.get("start")
+        )
+    if end is None:
+        end = _to_int(row.get("line_end") or row.get("end_line") or row.get("end"))
+    if start is None:
+        return None
+    return (start, end if end is not None else start)
+
+
+def line_range_overlaps_any(line_range: tuple[int, int] | None, ranges: Sequence[tuple[int, int]]) -> bool:
+    if line_range is None or not ranges:
+        return False
+    start, end = line_range
+    return any(start <= range_end and end >= range_start for range_start, range_end in ranges)
+
+
+def row_overlaps_changed_lines(
+    row: Mapping[str, Any],
+    file_path: str,
+    ranges_by_file: Mapping[str, Sequence[tuple[int, int]]],
+) -> bool:
+    return line_range_overlaps_any(line_range_from_mapping(row), ranges_by_file.get(file_path, []))
+
+
+def is_file_level_node(node_id: Any, row: Mapping[str, Any], file_path: str) -> bool:
+    node_id_text = str(node_id or "")
+    node_type = str(row.get("type") or row.get("kind") or "").lower()
+    if node_type in {"file", "module"}:
+        return True
+    return node_id_text == file_path or (":" not in node_id_text and str(row.get("path") or row.get("file") or row.get("module") or "") == file_path)