feat(jira): add summarize_issue.py and enrich gathered data with author names

Add a summarize_issue.py script that extracts structured, human-readable
summaries from pre-gathered JSON files, avoiding context window overflow
when processing large issue data. Update update-weekly-status to use it.

Enrich gather_status_data.py to capture author_name (display names) for
PR reviews, commits, and review comments alongside login handles, and
collect issue labels.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: celebdor

plugins/jira/commands/update-weekly-status.md

@@ -156,32 +156,24 @@ For each issue listed in the manifest:
 
 ##### a. Read Pre-Gathered Data
 
-Read the issue's JSON file from `.work/weekly-status/{date}/issues/{ISSUE-KEY}.json`
+Use the `summarize_issue.py` script to extract a structured, human-readable summary from the pre-gathered JSON. This avoids reading large JSON files directly (which can exceed context limits) and produces output optimized for LLM analysis.
 
-The file contains:
-
-```json
-{
-  "issue": {
-    "key": "OCPSTRAT-1234",
-    "summary": "...",
-    "status": "In Progress",
-    "assignee": {"email": "...", "name": "..."},
-    "current_status_summary": "...",
-    "last_status_summary_update": "..."
-  },
-  "descendants": {
-    "total": 15,
-    "by_status": {"Closed": 5, "In Progress": 8, "To Do": 2},
-    "updated_in_range": [...],
-    "completion_pct": 33.3
-  },
-  "changelog_in_range": [...],
-  "comments_in_range": [...],
-  "prs": [...]
-}
+```bash
+python3 {plugins-dir}/jira/skills/status-analysis/scripts/summarize_issue.py \
+  {ISSUE-KEY} --date-dir .work/weekly-status/{date}
 ```
 
+The script outputs a structured summary with sections for:
+- Issue header (key, summary, status, assignee, current status summary)
+- Descendants (total, completion %, by-status breakdown, updated in range)
+- Changelog entries (formatted as `date by author: field: old -> new`)
+- Comments (non-bot only, with body truncated to 300 chars)
+- PRs (active in range, merged this week, open)
+
+**Script location**: `plugins/jira/skills/status-analysis/scripts/summarize_issue.py`
+
+The underlying JSON file is at `.work/weekly-status/{date}/issues/{ISSUE-KEY}.json` if you need to read additional details not shown in the summary.
+
 ##### b. Analyze Activity (using Status Analysis Engine)
 
 Using the pre-gathered data, apply the activity analysis rules from `activity-analysis.md`:
@@ -546,4 +538,5 @@ See the Jira plugin's skills directory for examples of project-specific customiz
 
 - **Shared skill**: `plugins/jira/skills/status-analysis/SKILL.md`
 - **Data gatherer script**: `plugins/jira/skills/status-analysis/scripts/gather_status_data.py`
+- **Issue summarizer script**: `plugins/jira/skills/status-analysis/scripts/summarize_issue.py`
 - **Single-issue rollup**: `/jira:status-rollup` - Generate comprehensive status comment for one issue

plugins/jira/skills/status-analysis/scripts/gather_status_data.py

@@ -551,7 +551,7 @@ def _build_pr_query(self, pr_refs: List[PRRef]) -> str:
                         reviewDecision
                         reviews(last: 30) {{
                             nodes {{
-                                author {{ login }}
+                                author {{ login ... on User {{ name }} }}
                                 state
                                 body
                                 submittedAt
@@ -562,7 +562,7 @@ def _build_pr_query(self, pr_refs: List[PRRef]) -> str:
                                 isResolved
                                 comments(first: 5) {{
                                     nodes {{
-                                        author {{ login }}
+                                        author {{ login ... on User {{ name }} }}
                                         body
                                         createdAt
                                         path
@@ -577,7 +577,7 @@ def _build_pr_query(self, pr_refs: List[PRRef]) -> str:
                                     oid
                                     messageHeadline
                                     committedDate
-                                    author {{ email }}
+                                    author {{ email name }}
                                 }}
                             }}
                         }}
@@ -833,8 +833,10 @@ def _filter_pr_to_range(
         for review in (pr_data.get("reviews", {}).get("nodes") or []):
             submitted = self._parse_datetime(review.get("submittedAt"))
             if submitted and date_range.contains(submitted):
+                author_obj = review.get("author") or {}
                 reviews_in_range.append({
-                    "author": (review.get("author") or {}).get("login", "Unknown"),
+                    "author": author_obj.get("login", "Unknown"),
+                    "author_name": author_obj.get("name") or author_obj.get("login", "Unknown"),
                     "state": review.get("state"),
                     "body": (review.get("body") or "")[:500],
                     "submitted_at": review.get("submittedAt"),
@@ -846,11 +848,13 @@ def _filter_pr_to_range(
             commit = node.get("commit", {})
             committed = self._parse_datetime(commit.get("committedDate"))
             if committed and date_range.contains(committed):
+                commit_author = commit.get("author") or {}
                 commits_in_range.append({
                     "sha": (commit.get("oid") or "")[:7],
                     "message": commit.get("messageHeadline", ""),
                     "date": commit.get("committedDate"),
-                    "author": (commit.get("author") or {}).get("email", "Unknown"),
+                    "author": commit_author.get("email", "Unknown"),
+                    "author_name": commit_author.get("name") or commit_author.get("email", "Unknown"),
                 })
 
         # Filter review comments
@@ -859,8 +863,10 @@ def _filter_pr_to_range(
             for comment in (thread.get("comments", {}).get("nodes") or []):
                 created = self._parse_datetime(comment.get("createdAt"))
                 if created and date_range.contains(created):
+                    comment_author = comment.get("author") or {}
                     review_comments_in_range.append({
-                        "author": (comment.get("author") or {}).get("login", "Unknown"),
+                        "author": comment_author.get("login", "Unknown"),
+                        "author_name": comment_author.get("name") or comment_author.get("login", "Unknown"),
                         "path": comment.get("path"),
                         "line": comment.get("line"),
                         "body": (comment.get("body") or "")[:300],
@@ -1216,6 +1222,7 @@ def _build_manifest(
 
             # Build issue data
             assignee = fields.get("assignee") or {}
+            labels = [l for l in fields.get("labels", []) if isinstance(l, str)]
             issue_data = {
                 "issue": {
                     "key": issue_key,
@@ -1225,6 +1232,7 @@ def _build_manifest(
                         "email": assignee.get("emailAddress"),
                         "name": assignee.get("displayName"),
                     },
+                    "labels": labels,
                     "current_status_summary": fields.get(self.config.status_summary_field),
                     "last_status_summary_update": last_status_update,
                 },