@seanyao/roll 2026.518.2 → 2026.518.4

package/lib/roll-backlog.py

@@ -0,0 +1,262 @@
+#!/usr/bin/env python3
+"""
+roll-backlog — v2 terminal view for `roll backlog`.
+
+Parses BACKLOG.md and renders items grouped by type:
+  Bug Fixes (red) · User Stories (blue) · Refactors (amber) · Ideas (dim)
+
+In-progress items get a ⏵ purple marker.
+Blocked and Deferred items appear in their own sections below.
+"""
+from __future__ import annotations
+
+import os
+import re
+import sys
+from typing import List, NamedTuple, Optional
+
+_LIB_DIR = os.path.dirname(os.path.realpath(__file__))
+if _LIB_DIR not in sys.path:
+    sys.path.insert(0, _LIB_DIR)
+import roll_render as rr
+from roll_render import c, pad, row, trunc, strw, COLS
+
+# ════════════════════════════════════════════════════════════════════════════
+# BACKLOG parsing
+# ════════════════════════════════════════════════════════════════════════════
+
+class Item(NamedTuple):
+    id: str
+    desc: str
+    status: str        # raw status cell content
+    reason: str        # extracted reason from Blocked/Deferred status
+
+
+_ID_RE = re.compile(r"\[([^\]]+)\]\([^)]+\)")       # [US-XXX](link)
+_REASON_RE = re.compile(r"\[([^\]]+)\]")            # [reason text]
+
+
+def _parse_id(cell: str) -> str:
+    m = _ID_RE.search(cell)
+    if m:
+        return m.group(1)
+    return cell.strip()
+
+
+def _parse_reason(status_cell: str) -> str:
+    # Skip the leading emoji word, extract first [...] block
+    m = _REASON_RE.search(status_cell)
+    return m.group(1) if m else ""
+
+
+def parse_backlog(path: str) -> List[Item]:
+    items: List[Item] = []
+    with open(path, encoding="utf-8") as f:
+        for line in f:
+            line = line.rstrip("\n")
+            if not line.startswith("|"):
+                continue
+            parts = [p.strip() for p in line.split("|")]
+            if len(parts) < 4:
+                continue
+            id_cell = parts[1]
+            desc_cell = parts[2]
+            status_cell = parts[3] if len(parts) > 3 else ""
+            item_id = _parse_id(id_cell)
+            if not re.match(r"(US|FIX|REFACTOR|IDEA)-", item_id):
+                continue
+            reason = _parse_reason(status_cell) if ("Blocked" in status_cell or "Deferred" in status_cell) else ""
+            items.append(Item(item_id, desc_cell, status_cell, reason))
+    return items
+
+
+def classify(items: List[Item]):
+    todo_fix: List[Item] = []
+    todo_us: List[Item] = []
+    todo_ref: List[Item] = []
+    todo_idea: List[Item] = []
+    in_progress: List[Item] = []
+    blocked: List[Item] = []
+    deferred: List[Item] = []
+
+    for it in items:
+        st = it.status
+        if "In Progress" in st:
+            in_progress.append(it)
+        elif "Blocked" in st:
+            blocked.append(it)
+        elif "Deferred" in st:
+            deferred.append(it)
+        elif "Todo" in st:
+            if it.id.startswith("FIX-"):
+                todo_fix.append(it)
+            elif it.id.startswith("US-"):
+                todo_us.append(it)
+            elif it.id.startswith("REFACTOR-"):
+                todo_ref.append(it)
+            elif it.id.startswith("IDEA-"):
+                todo_idea.append(it)
+
+    return todo_fix, todo_us, todo_ref, todo_idea, in_progress, blocked, deferred
+
+
+# ════════════════════════════════════════════════════════════════════════════
+# Rendering
+# ════════════════════════════════════════════════════════════════════════════
+
+_MAX_DESC = 62
+
+BG_RUN = "\033[48;2;40;20;70m"    # faint purple bg for in-progress row
+
+
+def _render_item_row(it: Item, color: str, *, glyph: str = " ", bg: str = "") -> None:
+    """Print one item line: glyph · ID · description."""
+    id_str = c(color, pad(it.id, 16))
+    desc = trunc(it.desc, _MAX_DESC)
+    desc_str = c(color, desc) if color != "dim" else c("dim", desc)
+    line = f"  {glyph} {id_str}  {desc_str}"
+    if bg and rr.USE_COLOR:
+        print(bg + line + rr.RESET)
+    else:
+        print(line)
+
+
+def _render_group(title_en: str, title_zh: str, color: str, items: List[Item]) -> None:
+    if not items:
+        return
+    n = len(items)
+    header = c(color, f"  {title_en}", bold=True) + c("muted", "  ·  ") + c("dim", title_zh) + c("muted", f"  ({n})")
+    print(header)
+    for it in items:
+        _render_item_row(it, color)
+    print()
+
+
+def _render_in_progress(items: List[Item]) -> None:
+    for it in items:
+        glyph = c("purple", "⏵")
+        id_str = c("purple", pad(it.id, 16), bold=True)
+        desc = trunc(it.desc, _MAX_DESC)
+        desc_str = c("purple", desc)
+        line = f"  {glyph} {id_str}  {desc_str}"
+        if rr.USE_COLOR:
+            print(BG_RUN + line + rr.RESET)
+        else:
+            print(f"  ⏵ {it.id}  {it.desc}")
+
+
+def render(path: str) -> None:
+    items = parse_backlog(path)
+    todo_fix, todo_us, todo_ref, todo_idea, in_progress, blocked, deferred = classify(items)
+
+    todo_total = len(todo_fix) + len(todo_us) + len(todo_ref) + len(todo_idea)
+    blocked_count = len(blocked)
+    deferred_count = len(deferred)
+
+    # ── Header ──────────────────────────────────────────────────────────────
+    print()
+    pending_total = todo_total + len(in_progress)
+    tags = c("fg", f"{pending_total} Pending", bold=True)
+    if blocked_count:
+        tags += c("muted", " · ") + c("amber", f"{blocked_count} Blocked")
+    if deferred_count:
+        tags += c("muted", " · ") + c("dim", f"{deferred_count} Deferred")
+    header_left = "  " + c("pink", "BACKLOG", bold=True) + c("muted", "  ·  ") + c("dim", "待处理任务")
+    print(row(header_left, "  " + tags))
+    print()
+
+    # ── In-progress (shown first, above groups) ──────────────────────────────
+    if in_progress:
+        _render_in_progress(in_progress)
+        print()
+
+    # ── Todo groups in priority order ────────────────────────────────────────
+    _render_group("Bug Fixes", "缺陷修复", "red", todo_fix)
+    _render_group("User Stories", "用户故事", "blue", todo_us)
+    _render_group("Refactors", "重构", "amber", todo_ref)
+    _render_group("Ideas", "创意", "dim", todo_idea)
+
+    if todo_total == 0 and len(in_progress) == 0:
+        print(c("green", "  ✓ Nothing pending — backlog is clear  暂无待处理任务"))
+        print()
+
+    # ── Blocked ──────────────────────────────────────────────────────────────
+    if blocked:
+        print(c("amber", "  Blocked", bold=True) + c("muted", "  ·  ") + c("dim", "已阻塞") + c("muted", f"  ({blocked_count})"))
+        for it in blocked:
+            id_str = c("amber", pad(it.id, 16))
+            desc = trunc(it.desc, 50)
+            reason_str = c("muted", f"  ({it.reason})") if it.reason else ""
+            print(f"  🔒 {id_str}  {c('dim', desc)}{reason_str}")
+        print()
+
+    # ── Deferred ─────────────────────────────────────────────────────────────
+    if deferred:
+        print(c("dim", f"  Deferred  ·  已推迟  ({deferred_count})"))
+        for it in deferred:
+            id_str = c("dim", pad(it.id, 16))
+            desc = trunc(it.desc, 50)
+            reason_str = c("muted", f"  ({it.reason})") if it.reason else ""
+            print(f"  ⏸ {id_str}  {c('dim', desc)}{reason_str}")
+        print()
+
+    # ── Footer ───────────────────────────────────────────────────────────────
+    print(c("muted", "  ") + c("dim", "triage: ") + c("blue", "roll backlog block/defer/unblock <pattern> [reason]"))
+    print()
+
+
+# ════════════════════════════════════════════════════════════════════════════
+# Entry
+# ════════════════════════════════════════════════════════════════════════════
+
+def main() -> None:
+    args = sys.argv[1:]
+    demo = "--demo" in args
+    no_color = "--no-color" in args or not sys.stdout.isatty() or os.getenv("NO_COLOR")
+    rr.USE_COLOR = not no_color
+
+    backlog = "BACKLOG.md"
+    if not demo and not os.path.isfile(backlog):
+        print(f"Error: {backlog} not found — run 'roll init' first", file=sys.stderr)
+        sys.exit(1)
+
+    if demo:
+        _write_demo(backlog)
+        try:
+            render(backlog)
+        finally:
+            os.unlink(backlog)
+    else:
+        render(backlog)
+
+
+def _write_demo(path: str) -> None:
+    with open(path, "w") as f:
+        f.write("""# Project Backlog
+
+## 🐛 Bug Fixes
+| ID | Description | Status |
+|----|-------------|--------|
+| FIX-042 | Fix outer runner tmux kill matching wrong session | 🔨 In Progress |
+| FIX-043 | Handle stale state in loop now command | 📋 Todo |
+
+## Epic: Autonomous Evolution
+### Feature: autonomous-evolution
+| Story | Description | Status |
+|-------|-------------|--------|
+| [US-AUTO-042](docs/features/autonomous-evolution.md) | Loop cost telemetry — write model and token data per cycle | 📋 Todo |
+
+## ♻️ Refactor
+| ID | Description | Status |
+|----|-------------|--------|
+| REFACTOR-010 | Simplify CI test parallelism strategy | 🔒 Blocked [waiting on CI infra] |
+
+## 💡 Ideas
+| ID | Description | Status |
+|----|-------------|--------|
+| IDEA-025 | Dashboard cost from list-price tokens | ⏸ Deferred [design pending] |
+""")
+
+
+if __name__ == "__main__":
+    main()

package/lib/roll-brief.py

@@ -0,0 +1,286 @@
+#!/usr/bin/env python3
+"""
+roll-brief — v2 terminal view for `roll brief`.
+
+Parses the latest docs/briefs/<date>.md and renders it as three sections:
+  SUMMARY    — eyebrow + shipped/watch/decide counts
+  HIGHLIGHTS — completed story list
+  DECIDE     — action-required items with D1/D2/... numbering
+"""
+from __future__ import annotations
+
+import os
+import re
+import sys
+import time
+from typing import Dict, List, Tuple
+
+_LIB_DIR = os.path.dirname(os.path.realpath(__file__))
+if _LIB_DIR not in sys.path:
+    sys.path.insert(0, _LIB_DIR)
+import roll_render as rr
+from roll_render import c, pad, row, trunc, strw, COLS
+
+# ════════════════════════════════════════════════════════════════════════════
+# Brief parsing — section-based
+# ════════════════════════════════════════════════════════════════════════════
+
+def _age_str(mtime: float) -> str:
+    age_s = int(time.time() - mtime)
+    if age_s < 3600:
+        return f"{age_s // 60}m ago"
+    if age_s < 86400:
+        return f"{age_s // 3600}h ago"
+    return f"{age_s // 86400}d ago"
+
+
+def _split_sections(lines: List[str]) -> Dict[str, List[str]]:
+    """Split markdown into {section_heading: [body_lines], ...}.
+    Key '' holds lines before the first section header.
+    Key '@title' holds the # title line.
+    """
+    sections: Dict[str, List[str]] = {"": []}
+    current = ""
+    for line in lines:
+        if line.startswith("# "):
+            sections["@title"] = [line]
+        elif line.startswith("## "):
+            current = line[3:].strip()
+            sections[current] = []
+        else:
+            sections[current].append(line)
+    return sections
+
+
+def _parse_table(body: List[str]) -> List[Tuple[str, str]]:
+    """Extract (id, desc) pairs from a markdown table body."""
+    rows = []
+    for line in body:
+        if not line.strip().startswith("|"):
+            continue
+        parts = [p.strip() for p in line.strip().split("|")]
+        if len(parts) < 3:
+            continue
+        cell0 = parts[1]
+        cell1 = parts[2] if len(parts) > 2 else ""
+        # skip separator rows like |---|---| and header rows
+        if re.match(r"[-:]+$", cell0.replace(" ", "")):
+            continue
+        if cell0.lower() in ("编号", "story", "id", ""):
+            continue
+        rows.append((cell0, cell1))
+    return rows
+
+
+def _parse_numbered_list(body: List[str]) -> List[str]:
+    """Extract items from a numbered markdown list."""
+    items = []
+    for line in body:
+        m = re.match(r"^\d+\.\s+(.*)", line.rstrip())
+        if m:
+            text = m.group(1)
+            text = re.sub(r"\*\*(.*?)\*\*", r"\1", text)
+            items.append(text.strip())
+    return items
+
+
+class Brief:
+    def __init__(self) -> None:
+        self.path: str = ""
+        self.mtime: float = 0.0
+        self.title_date: str = ""
+        self.coverage: str = ""
+        self.shipped: List[Tuple[str, str]] = []
+        self.in_progress: List[Tuple[str, str]] = []
+        self.pending_count: int = 0
+        self.decide: List[str] = []
+        self.alert_count: int = 0
+
+
+def parse_brief(path: str) -> Brief:
+    b = Brief()
+    b.path = path
+    b.mtime = os.path.getmtime(path)
+
+    with open(path, encoding="utf-8") as f:
+        raw = f.read()
+
+    lines = raw.splitlines()
+    sections = _split_sections(lines)
+
+    # Title date
+    title_lines = sections.get("@title", [])
+    if title_lines:
+        m = re.search(r"(\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2})", title_lines[0])
+        if m:
+            b.title_date = m.group(1)
+
+    # Coverage from preamble blockquote
+    for line in sections.get("", []):
+        if line.startswith("> ") and "覆盖" in line:
+            b.coverage = line[2:].strip()
+
+    # 已完成
+    for key, body in sections.items():
+        if key.startswith("已完成"):
+            b.shipped = _parse_table(body)
+            break
+
+    # 进行中
+    for key, body in sections.items():
+        if key.startswith("进行中"):
+            b.in_progress = _parse_table(body)
+            break
+
+    # Pending count from section header
+    for key in sections:
+        m = re.search(r"待处理.*?(\d+)", key)
+        if m:
+            b.pending_count = int(m.group(1))
+
+    # 需人工介入
+    for key, body in sections.items():
+        if key.startswith("需人工介入"):
+            b.decide = _parse_numbered_list(body)
+            break
+
+    # Footer alert count
+    for line in lines:
+        if line.startswith("*状态") or ("告警" in line and line.startswith("*")):
+            m = re.search(r"告警\s*(\d+)", line)
+            if m:
+                b.alert_count = int(m.group(1))
+            break
+
+    return b
+
+
+# ════════════════════════════════════════════════════════════════════════════
+# Rendering
+# ════════════════════════════════════════════════════════════════════════════
+
+_MAX_DESC = 60
+
+
+def _render_eyebrow(b: Brief) -> None:
+    brief_file = os.path.basename(b.path)
+    age = _age_str(b.mtime)
+    left = "  " + c("pink", "BRIEF", bold=True) + c("muted", "  ·  ") + c("dim", "简报")
+    right = c("dim", brief_file) + c("muted", "  ·  ") + c("amber", age)
+    print(row(left, "  " + right))
+    if b.title_date:
+        cov = (c("muted", "  ·  ") + c("dim", b.coverage)) if b.coverage else ""
+        print("  " + c("dim", b.title_date) + cov)
+    print()
+
+
+def _render_summary(b: Brief) -> None:
+    n_shipped = len(b.shipped)
+    n_watch = len(b.in_progress)
+    n_decide = len(b.decide)
+
+    tags = c("green", f"✓ {n_shipped} Shipped") + c("muted", "  ·  ")
+    tags += (c("amber", f"! {n_watch} Watch") if n_watch else c("dim", f"! {n_watch} Watch"))
+    tags += c("muted", "  ·  ")
+    tags += (c("amber", f"⚠ {n_decide} Decide") if n_decide else c("dim", f"⚠ {n_decide} Decide"))
+
+    left = "  " + c("fg", "SUMMARY", bold=True) + c("muted", "  ·  ") + c("dim", "摘要")
+    print(row(left, "  " + tags))
+    print()
+
+    print("    " + c("green", "✓") + c("muted", "  ") +
+          c("fg", f"{n_shipped} Shipped", bold=True) +
+          c("dim", f"  ·  已完成 {n_shipped} 项"))
+
+    if n_watch:
+        print("    " + c("amber", "!") + c("muted", "  ") +
+              c("amber", f"{n_watch} Watch", bold=True) +
+              c("dim", f"  ·  进行中 {n_watch} 项"))
+    else:
+        print("    " + c("dim", "!") + c("muted", "  ") + c("dim", f"{n_watch} Watch"))
+
+    if n_decide:
+        print("    " + c("amber", "⚠") + c("muted", "  ") +
+              c("amber", f"{n_decide} Decide", bold=True) +
+              c("dim", f"  ·  需人工介入 {n_decide} 项"))
+    else:
+        print("    " + c("dim", "⚠") + c("muted", "  ") + c("dim", f"{n_decide} Decide"))
+
+    if b.pending_count:
+        print("    " + c("dim", f"·  {b.pending_count} 项待处理"))
+
+    print()
+
+
+def _render_highlights(b: Brief) -> None:
+    if not b.shipped:
+        return
+    n = len(b.shipped)
+    header = (c("blue", "  HIGHLIGHTS", bold=True) +
+               c("muted", "  ·  ") + c("dim", "已完成") + c("muted", f"  ({n})"))
+    print(header)
+    for (id_cell, desc) in b.shipped:
+        desc_t = trunc(desc, _MAX_DESC)
+        print("    " + c("muted", "— ") + c("blue", pad(id_cell, 18)) + "  " + c("dim", desc_t))
+    print()
+
+
+def _render_decide(b: Brief) -> None:
+    if not b.decide:
+        return
+    n = len(b.decide)
+    header = (c("amber", "  DECIDE", bold=True) +
+               c("muted", "  ·  ") + c("dim", "需人工介入") + c("muted", f"  ({n})"))
+    print(header)
+    print()
+    for idx, item in enumerate(b.decide, start=1):
+        label = c("amber", f"  D{idx}", bold=True)
+        body = trunc(item, COLS - 8)
+        print(f"{label}  {c('fg', body)}")
+    print()
+
+
+def _render_footer() -> None:
+    parts = [
+        c("dim", "next: ") + c("blue", "roll loop now"),
+        c("dim", "regen: ") + c("blue", "roll brief --regen"),
+        c("dim", "alerts: ") + c("blue", "roll alert"),
+    ]
+    print("  " + c("muted", "  ·  ").join(parts))
+    print()
+
+
+def render(path: str) -> None:
+    b = parse_brief(path)
+    print()
+    _render_eyebrow(b)
+    _render_summary(b)
+    _render_highlights(b)
+    _render_decide(b)
+    _render_footer()
+
+
+# ════════════════════════════════════════════════════════════════════════════
+# Entry
+# ════════════════════════════════════════════════════════════════════════════
+
+def main() -> None:
+    args = sys.argv[1:]
+    no_color = "--no-color" in args or not sys.stdout.isatty() or os.getenv("NO_COLOR")
+    rr.USE_COLOR = not no_color
+
+    briefs_dir = "docs/briefs"
+    briefs = sorted(
+        f for f in os.listdir(briefs_dir) if f.endswith(".md")
+    ) if os.path.isdir(briefs_dir) else []
+
+    if not briefs:
+        print("No brief yet — run 'roll brief --regen'  暂无简报", file=sys.stderr)
+        sys.exit(1)
+
+    latest = os.path.join(briefs_dir, briefs[-1])
+    render(latest)
+
+
+if __name__ == "__main__":
+    main()