Coverage for little_loops / cli / issues / list_cmd.py: 0%
151 statements
« prev ^ index » next coverage.py v7.12.0, created at 2026-06-16 13:08 -0500
1"""ll-issues list: List active issues with optional type/priority/status filters."""
3from __future__ import annotations
5import argparse
6from typing import TYPE_CHECKING
8from little_loops.cli.output import PRIORITY_COLOR, TYPE_COLOR, colorize, print_json
10if TYPE_CHECKING:
11 from little_loops.config import BRConfig
14def cmd_list(config: BRConfig, args: argparse.Namespace) -> int:
15 """List issues with optional filters.
17 Args:
18 config: Project configuration
19 args: Parsed arguments with optional .type, .priority, .status, .flat, and .json attributes
21 Returns:
22 Exit code (0 = success)
23 """
24 from datetime import date, datetime
26 from little_loops.cli.issues.search import (
27 _load_issues_with_status,
28 _parse_discovered_date,
29 _parse_labels_from_content,
30 _sort_issues,
31 )
33 status = getattr(args, "status", "open") or "open"
34 include_open = status in ("open", "in_progress", "blocked", "all")
35 include_done = status in ("done", "cancelled", "all")
36 include_deferred = status in ("deferred", "all")
38 raw = _load_issues_with_status(config, include_open, include_done, include_deferred)
40 from little_loops.cli_args import parse_priorities
42 type_filter = getattr(args, "type", None)
43 priority_filter: set[str] | None = parse_priorities(getattr(args, "priority", None))
44 label_filters: list[str] = getattr(args, "label", None) or []
45 milestone_filter: str | None = getattr(args, "milestone", None) or None
46 parent_filter: str | None = getattr(args, "parent", None) or None
48 filtered = [
49 (issue, stat)
50 for issue, stat in raw
51 if (not type_filter or issue.issue_id.split("-", 1)[0] == type_filter)
52 and (not priority_filter or issue.priority in priority_filter)
53 and (
54 not label_filters
55 or any(lf.lower() in [lb.lower() for lb in issue.labels] for lf in label_filters)
56 )
57 and (not milestone_filter or issue.milestone == milestone_filter)
58 and (not parent_filter or issue.parent == parent_filter)
59 ]
61 # Sort
62 sort_field = getattr(args, "sort", "priority") or "priority"
63 need_content = sort_field in {"created", "completed"}
64 want_json = getattr(args, "json", False)
65 enriched: list[tuple] = []
66 for issue, stat in filtered:
67 disc_date: datetime | None = None
68 comp_date: date | None = None
69 labels: list[str] = []
70 content = ""
71 if need_content or want_json:
72 try:
73 content = issue.path.read_text(encoding="utf-8")
74 except Exception:
75 content = ""
76 if need_content:
77 if sort_field == "created":
78 disc_date = _parse_discovered_date(content, issue.path)
79 elif sort_field == "completed":
80 from little_loops.issue_history.parsing import _parse_completion_date
82 comp_date = _parse_completion_date(content, issue.path)
83 if want_json:
84 labels = _parse_labels_from_content(content)
85 enriched.append((issue, stat, disc_date, comp_date, labels))
87 if getattr(args, "desc", False):
88 descending = True
89 elif getattr(args, "asc", False):
90 descending = False
91 else:
92 descending = sort_field in {"created", "completed"}
94 enriched = _sort_issues(enriched, sort_field, descending)
96 limit = getattr(args, "limit", None)
97 if limit is not None and limit < 1:
98 import sys
100 print(f"Error: --limit must be a positive integer, got {limit}", file=sys.stderr)
101 return 1
103 if limit is not None:
104 enriched = enriched[:limit]
106 issues_with_status = [(item[0], item[1]) for item in enriched]
108 if not issues_with_status:
109 print("No active issues")
110 return 0
112 if getattr(args, "json", False):
113 print_json(
114 [
115 {
116 "id": issue.issue_id,
117 "priority": issue.priority,
118 "type": issue.issue_id.split("-", 1)[0],
119 "title": issue.title,
120 "path": str(issue.path),
121 "status": stat,
122 "discovered_date": disc_date.date().isoformat() if disc_date else None,
123 "parent": issue.parent,
124 "labels": lbls,
125 "milestone": issue.milestone,
126 }
127 for issue, stat, disc_date, _comp_date, lbls in enriched
128 ]
129 )
130 return 0
132 if getattr(args, "flat", False):
133 for issue, _stat in issues_with_status:
134 print(f"{issue.path.name} {issue.title}")
135 return 0
137 group_by = getattr(args, "group_by", "type")
138 if group_by == "epic":
139 # Build parent title lookup from raw (before type filter) so headers
140 # resolve correctly when --type BUG is combined with --group-by epic
141 parent_titles: dict[str, str] = {i.issue_id: i.title for i, _ in raw if i.title}
143 # Build parent map for walking up multi-level chains (e.g. FEAT → FEAT → EPIC)
144 _parent_map: dict[str, str] = {i.issue_id: i.parent for i, _ in raw if i.parent}
146 def _find_epic_ancestor(issue_id: str) -> str | None:
147 seen: set[str] = set()
148 current = _parent_map.get(issue_id)
149 while current and current not in seen:
150 if current.split("-", 1)[0] == "EPIC":
151 return current
152 seen.add(current)
153 current = _parent_map.get(current)
154 return None
156 parent_buckets: dict[str | None, list] = {}
157 for issue, stat in issues_with_status:
158 if issue.issue_id.split("-", 1)[0] == "EPIC":
159 continue
160 key = _find_epic_ancestor(issue.issue_id)
161 if key not in parent_buckets:
162 parent_buckets[key] = []
163 parent_buckets[key].append((issue, stat))
165 named_keys = sorted(k for k in parent_buckets if k is not None)
166 ordered_keys = named_keys + ([None] if None in parent_buckets else [])
168 # Pre-compute progress badges for named EPIC buckets
169 epic_progress_cache: dict[str, tuple[int, int, int]] = {}
170 if named_keys:
171 from little_loops.issue_parser import find_issues as _find_issues_all
172 from little_loops.issue_progress import compute_epic_progress
174 _all_statuses: set[str] = {
175 "open",
176 "in_progress",
177 "blocked",
178 "done",
179 "cancelled",
180 "deferred",
181 }
182 all_issues_for_progress = _find_issues_all(config, status_filter=_all_statuses)
183 for epic_key in named_keys:
184 prog = compute_epic_progress(epic_key, all_issues_for_progress)
185 if prog is not None:
186 done = prog.by_status.get("done", 0) + prog.by_status.get("cancelled", 0)
187 blocked = prog.by_status.get("blocked", 0)
188 epic_progress_cache[epic_key] = (done, len(prog.children), blocked)
190 lines: list[str] = []
191 for key in ordered_keys:
192 group = parent_buckets[key]
193 if key is None:
194 header = colorize(f"Unparented ({len(group)})", "1")
195 else:
196 title = parent_titles.get(key, "")
197 badge = ""
198 if key in epic_progress_cache:
199 done, total, blocked = epic_progress_cache[key]
200 badge = f" ({done}/{total} done"
201 if blocked > 0:
202 badge += f" · {blocked} blocked"
203 badge += ")"
204 base_label = f"{key}: {title}" if title else key
205 label = f"{base_label} ({len(group)}){badge}"
206 parent_prefix = key.split("-", 1)[0]
207 header = colorize(label, f"{TYPE_COLOR.get(parent_prefix, '0')};1")
208 lines.append(header)
209 for issue, stat in group:
210 issue_type = issue.issue_id.split("-", 1)[0]
211 colored_id = colorize(issue.issue_id, TYPE_COLOR.get(issue_type, "0"))
212 colored_priority = colorize(issue.priority, PRIORITY_COLOR.get(issue.priority, "0"))
213 status_tag = f" [{stat}]" if stat not in ("open", "in_progress") else ""
214 lines.append(f" {colored_priority} {colored_id} {issue.title}{status_tag}")
215 lines.append("")
216 displayed = sum(len(g) for g in parent_buckets.values())
217 lines.append(f"Total: {displayed} active issues (excluding EPICs)")
218 print("\n".join(lines))
219 return 0
221 # Group by type prefix
222 buckets: dict[str, list] = {"BUG": [], "FEAT": [], "ENH": [], "EPIC": []}
223 for issue, stat in issues_with_status:
224 prefix = issue.issue_id.split("-", 1)[0]
225 if prefix in buckets:
226 buckets[prefix].append((issue, stat))
228 type_labels = {"BUG": "Bugs", "FEAT": "Features", "ENH": "Enhancements", "EPIC": "Epics"}
229 lines = []
230 for prefix, label in type_labels.items():
231 group = buckets[prefix]
232 header = colorize(f"{label} ({len(group)})", f"{TYPE_COLOR.get(prefix, '0')};1")
233 lines.append(header)
234 for issue, stat in group:
235 issue_type = issue.issue_id.split("-", 1)[0]
236 colored_id = colorize(issue.issue_id, TYPE_COLOR.get(issue_type, "0"))
237 colored_priority = colorize(issue.priority, PRIORITY_COLOR.get(issue.priority, "0"))
238 status_tag = f" [{stat}]" if stat not in ("open", "in_progress") else ""
239 lines.append(f" {colored_priority} {colored_id} {issue.title}{status_tag}")
240 lines.append("")
241 lines.append(f"Total: {len(issues_with_status)} active issues")
242 print("\n".join(lines))
243 return 0