@seanyao/roll 0.5.0 → 2.602.1

package/lib/roll-backlog.py

@@ -0,0 +1,225 @@
+#!/usr/bin/env python3
+"""
+roll-backlog — v2 terminal view for `roll backlog`.
+
+Parses .roll/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:]
+    no_color = "--no-color" in args or not sys.stdout.isatty() or os.getenv("NO_COLOR")
+    rr.USE_COLOR = not no_color
+
+    backlog = ".roll/backlog.md"
+    if not os.path.isfile(backlog):
+        print(f"Error: {backlog} not found — run 'roll init' first", file=sys.stderr)
+        sys.exit(1)
+    render(backlog)
+
+
+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 .roll/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 = ".roll/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()

package/lib/roll-help.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""
+roll-help — render the `roll --help` page.
+
+Compact wordmark + grouped commands (AUTONOMY / PROJECT / MACHINE) + examples.
+
+Usage:
+  python3 lib/roll-help.py              # live
+  python3 lib/roll-help.py --no-color
+  python3 lib/roll-help.py              # static layout, no fixture needed
+"""
+
+from __future__ import annotations
+import argparse, os, re, sys
+from pathlib import Path
+
+_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
+from roll_render import COLS, c, row, section_head, strw, pad
+
+# ════════════════════════════════════════════════════════════════════════════
+# Version
+# ════════════════════════════════════════════════════════════════════════════
+def _roll_version() -> str:
+    roll_bin = Path(_LIB_DIR).parent / "bin" / "roll"
+    if roll_bin.exists():
+        for line in roll_bin.open(errors="ignore"):
+            m = re.match(r'^VERSION="([^"]+)"', line)
+            if m:
+                return m.group(1)
+    return "—"
+
+# ════════════════════════════════════════════════════════════════════════════
+# Command table
+# ════════════════════════════════════════════════════════════════════════════
+# (name, args_hint, en_desc, zh_desc, star)
+AUTONOMY = [
+    ("loop",     "<on|off|now|status|…>", "manage the autonomous BACKLOG executor",       "管理自主执行循环",          True),
+    ("brief",    "",                       "show latest owner brief",                     "查看最新简报",              True),
+    ("backlog",  "[block|defer|…]",        "view and manage pending tasks",               "查看和管理待处理任务",        True),
+    ("peer",     "",                       "cross-agent negotiation & review",            "跨 Agent 协商对审",         False),
+    ("alert",    "",                       "view and clear loop alerts",                  "查看 / 清除 loop 告警",     False),
+    ("feedback", "--type bug|idea|ux …",   "open a GitHub issue for this project",        "为本项目提交反馈",            False),
+]
+
+PROJECT = [
+    ("init",      "",              "create AGENTS.md + .roll/backlog.md + .roll/features/",    "初始化项目工作流文件",         False),
+    ("status",    "",              "show current state and drift",                        "显示当前状态和漂移项",         False),
+    ("agent",     "[use <name>]",  "per-project agent selection",                        "切换项目 agent",             False),
+    ("ci",        "[--wait]",      "show or wait for current commit's CI status",         "查看 / 等待 CI 状态",        False),
+    ("release",   "",              "run the release script (human-only)",                 "执行发版脚本（仅人工）",        False),
+    ("review-pr", "<number>",      "AI-powered code review for a PR",                    "AI 代码评审",               False),
+    ("slides",    "build <slug>",  "render a deck.md to HTML and open in browser",       "渲染 deck.md 为 HTML 并打开",  False),
+]
+
+MACHINE = [
+    ("setup",   "[-f]",   "first-time install or re-sync",   "首次安装或重新同步",   False),
+    ("update",  "",       "upgrade to latest + re-sync",     "升级到最新版并重新同步", False),
+    ("version", "",       "print installed roll version",    "显示已安装版本",        False),
+]
+
+EXAMPLES = [
+    ("roll loop on",                             "启用自主执行循环"),
+    ("roll brief",                               "查看最新简报"),
+    ("roll backlog defer US-DOC '过早引入'",      "推迟一类任务"),
+    ("roll agent use kimi",                      "切换当前项目到 kimi"),
+]
+
+# ════════════════════════════════════════════════════════════════════════════
+# Render
+# ════════════════════════════════════════════════════════════════════════════
+def _hr() -> None:
+    print(c("faint", "─" * COLS))
+
+def _cmd_block(entries: list) -> None:
+    """Render a command group — two lines per command (EN + ZH)."""
+    for name, args, en_desc, zh_desc, star in entries:
+        star_mark = c("amber", " ★") if star else "  "
+        en_line = (
+            "  " +
+            c("blue", name, bold=True) +
+            star_mark +
+            "  " +
+            (c("dim", args + "  ") if args else "    ") +
+            c("fg", en_desc)
+        )
+        zh_line = "  " + " " * (strw(name) + 2 + 2) + c("dim", zh_desc)
+        print(en_line)
+        print(zh_line)
+
+def render(version: str) -> None:
+    # ── Wordmark ──────────────────────────────────────────────────────────────
+    print()
+    left = ("  " + c("fg", "roll", bold=True) + c("muted", " · ") +
+            c("dim", "autonomous delivery for software teams"))
+    right = c("yellow", f"v{version}") + "  "
+    print(row(left, right))
+    print("  " + c("dim", "自主交付，人只做三件事：提需求、审核、发版"))
+    print()
+    print("  " + c("dim", "usage  ") + c("fg", "roll") + c("dim", " <command> [options]"))
+    print()
+    _hr()
+    print()
+
+    # ── AUTONOMY ──────────────────────────────────────────────────────────────
+    section_head("AUTONOMY", "日常使用", "★ = most used")
+    print()
+    _cmd_block(AUTONOMY)
+    print()
+    _hr()
+    print()
+
+    # ── PROJECT ───────────────────────────────────────────────────────────────
+    section_head("PROJECT", "项目内", "per-repo setup and CI")
+    print()
+    _cmd_block(PROJECT)
+    print()
+    _hr()
+    print()
+
+    # ── MACHINE ───────────────────────────────────────────────────────────────
+    section_head("MACHINE", "全局", "install, upgrade, version")
+    print()
+    _cmd_block(MACHINE)
+    print()
+    _hr()
+    print()
+
+    # ── Examples ──────────────────────────────────────────────────────────────
+    print("  " + c("muted", "examples"))
+    print()
+    for cmd, zh in EXAMPLES:
+        print("  " + c("blue", cmd) + "  " + c("dim", zh))
+    print()
+    print("  " + c("dim", "docs: ") + c("blue", "github.com/seanyao/roll") +
+          c("muted", "  ·  ") +
+          c("dim", "issues: ") + c("blue", "github.com/seanyao/roll/issues"))
+    print()
+
+# ════════════════════════════════════════════════════════════════════════════
+# Entry
+# ════════════════════════════════════════════════════════════════════════════
+def main() -> None:
+    ap = argparse.ArgumentParser(add_help=False)
+    ap.add_argument("--no-color", dest="no_color", action="store_true")
+    ap.add_argument("--en",       action="store_true")
+    ap.add_argument("--zh",       action="store_true")
+    args, _ = ap.parse_known_args()
+
+    if args.no_color or os.environ.get("NO_COLOR") or not sys.stdout.isatty():
+        roll_render.USE_COLOR = False
+
+    render(_roll_version())
+
+if __name__ == "__main__":
+    main()