opencode-db 0.6.2__py3-none-any.whl → 0.7.2__py3-none-any.whl

cli.py

@@ -7,14 +7,20 @@
   - Единообразный интерфейс
 """
 
+from __future__ import annotations
+
 import argparse
 import os
 import sys
 from typing import Any, Literal
 
-import commands
-from db import get_db
-from i18n import _, set_lang
+from runtime import require_python
+
+require_python()
+
+import commands  # noqa: E402
+from db import get_db  # noqa: E402
+from i18n import _, set_lang  # noqa: E402
 
 
 def build_parser() -> argparse.ArgumentParser:

cmd_view.py

@@ -0,0 +1,363 @@
+"""Command view: просмотр сессии в терминале с прокруткой.
+
+Выводит отформатированный диалог с ANSI-цветами,
+автоматически использует $PAGER (less -R) для прокрутки.
+
+Режимы выбора сессии:
+  - view <session_id>          — по ID (полный или префикс)
+  - view --latest              — самая свежая сессия
+  - view (без аргументов)      — интерактивный выбор из списка
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+
+from db import (
+    SessionError,
+    get_latest_session,
+    get_messages,
+    get_project_name,
+    get_recent_sessions,
+    get_session_info,
+    get_session_title,
+    parse_model,
+)
+from i18n import _
+from markdown_to_ansi import render as md_render
+from utils import build_help_epilog, format_cost, format_tokens, format_ts
+
+_VIEW_EXAMPLES = [
+    ("<session_id>", "help.view.e0"),
+    ("--latest", "help.view.e1"),
+    ("", "help.view.e2"),
+    ("--no-pager", "help.view.e3"),
+    ("--raw", "help.view.e4"),
+]
+
+
+def register(subparsers) -> None:
+    p = subparsers.add_parser(
+        "view",
+        help=_("help.cmd.view"),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=build_help_epilog("view", _VIEW_EXAMPLES),
+    )
+    p.add_argument(
+        "session_id",
+        nargs="?",
+        help="Session ID (optional — interactive mode if omitted)",
+    )
+    p.add_argument("--latest", "-l", action="store_true", help=_("view.flag.latest"))
+    p.add_argument("--no-pager", "-P", action="store_true", help=_("view.flag.no_pager"))
+    p.add_argument("--raw", "-R", action="store_true", help=_("view.flag.raw"))
+
+
+def run(args, db) -> int:
+    if args.session_id:
+        return _view_by_id(db, args.session_id, args.no_pager, args.raw)
+    if args.latest:
+        return _view_latest(db, args.no_pager, args.raw)
+    return _view_interactive(db, args.no_pager, args.raw)
+
+
+# ======================================================================
+# Selection modes
+# ======================================================================
+
+
+def _view_by_id(db, session_id, no_pager, raw) -> int:
+    try:
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    return _do_view(db, info, no_pager, raw)
+
+
+def _view_latest(db, no_pager, raw) -> int:
+    try:
+        session_id = get_latest_session(db)
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    title = get_session_title(info)
+    print(_("session.latest", title=title))
+    return _do_view(db, info, no_pager, raw)
+
+
+def _view_interactive(db, no_pager, raw) -> int:
+    sessions = get_recent_sessions(db)
+    if not sessions:
+        print(_("view.no_sessions"))
+        return 1
+
+    print()
+    print(f"  {'─' * 60}")
+    print(f"  {_('view.interactive_header')}")
+    print(f"  {'─' * 60}")
+
+    for i, s in enumerate(sessions, 1):
+        title = get_session_title(s)
+        created = format_ts(s["time_created"], "%Y-%m-%d %H:%M")
+        cost = format_cost(s["cost"])
+        print(f"  {i:2d}. {s['id'][:24]}  {created}  {title[:40]:40s}  {cost}")
+
+    print(f"  {'─' * 60}")
+
+    while True:
+        try:
+            choice = input("  " + _("view.interactive_prompt")).strip()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return 1
+
+        if not choice:
+            print(_("view.interactive_abort"))
+            return 1
+
+        try:
+            idx = int(choice) - 1
+            if 0 <= idx < len(sessions):
+                break
+        except ValueError:
+            pass
+
+        print(f"  {_('view.interactive_error', n=len(sessions))}")
+
+    session_id = sessions[idx]["id"]
+    title = get_session_title(sessions[idx])
+    print(_("view.interactive_viewing", title=title))
+    try:
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    return _do_view(db, info, no_pager, raw)
+
+
+# ======================================================================
+# Display engine
+# ======================================================================
+
+
+def _init_styles(raw=False):
+    """Return style dict. Empty dict = no ANSI codes."""
+    if raw or not sys.stdout.isatty():
+        return {}
+    return {
+        "R": "\033[0m",
+        "B": "\033[1m",
+        "D": "\033[2m",
+        "G": "\033[32m",
+        "C": "\033[36m",
+        "Y": "\033[33m",
+        "M": "\033[90m",
+    }
+
+
+def _do_view(db, info, no_pager, raw) -> int:
+    sty = _init_styles(raw)
+    messages = get_messages(db, info["id"])
+    text = _format_session(db, info, messages, sty)
+
+    use_pager = not no_pager and sys.stdout.isatty() and len(text) > 1000
+    if use_pager:
+        _page_text(text)
+    else:
+        sys.stdout.write(text)
+        if not text.endswith("\n"):
+            sys.stdout.write("\n")
+        sys.stdout.flush()
+
+    return 0
+
+
+def _format_session(db, info, messages, sty) -> str:
+    """Build the full formatted session view string."""
+    title = get_session_title(info)
+    model = parse_model(info)
+    created = format_ts(info["time_created"])
+    msg_count = len(messages)
+
+    duration = "—"
+    if info["time_updated"] and info["time_created"]:
+        duration_sec = (info["time_updated"] - info["time_created"]) / 1000
+        if duration_sec < 60:
+            duration = _("info.dur_sec", n=int(duration_sec))
+        elif duration_sec < 3600:
+            duration = _("info.dur_min", n=int(duration_sec / 60))
+        else:
+            hours = int(duration_sec / 3600)
+            mins = int((duration_sec % 3600) / 60)
+            duration = _("info.dur_hours", h=hours, m=mins)
+
+    ti = info["tokens_input"]
+    to = info["tokens_output"]
+    tr = info["tokens_reasoning"]
+    tokens_str = f"{format_tokens(ti)} in · {format_tokens(to)} out"
+    if tr:
+        tokens_str += f" · {format_tokens(tr)} reason"
+
+    cost = format_cost(info["cost"])
+
+    project_name = None
+    if info["project_id"]:
+        project_name = get_project_name(db, info["project_id"])
+
+    sep = f"{sty.get('M', '')}{'─' * 60}{sty.get('R', '')}"
+    lr = sty.get("R", "")
+
+    lines = []
+    lines.append("")
+    lines.append(f"{sty.get('B', '')}{sty.get('C', '')}🔍 {_('view.header')}{lr}")
+    lines.append(sep)
+    lines.append(f"  {_('info.id')}:       {info['id']}")
+    lines.append(f"  {_('list.header.title')}: {title}")
+    lines.append(f"  {_('info.model')}:   {model}")
+    lines.append(f"  {_('info.agent')}:    {info['agent'] or '—'}")
+    lines.append(f"  {_('info.created')}:  {created}")
+    lines.append(f"  {_('info.duration')}: {duration}")
+    lines.append(f"  {_('info.tokens_total')}: {tokens_str}")
+    lines.append(f"  {_('info.cost')}:       {cost}")
+    if project_name:
+        lines.append(f"  {_('info.project')}:   {project_name}")
+    lines.append(f"  {_('info.messages')}: {msg_count}")
+    lines.append(sep)
+    lines.append("")
+
+    if not messages:
+        lines.append(f"  {sty.get('M', '')}{_('view.no_messages')}{lr}")
+        lines.append("")
+        lines.append(sep)
+        lines.append("")
+    else:
+        for msg in messages:
+            role = msg.get("role", "unknown")
+            ts = format_ts(msg.get("time"), "%Y-%m-%d %H:%M:%S") if msg.get("time") else ""
+            agent = msg.get("agent", "")
+
+            if role == "user":
+                role_str = f"{sty.get('G', '')}👤 {_('view.role_user')} [{ts}]{lr}"
+            elif role == "assistant":
+                agent_tag = f" ({agent})" if agent else ""
+                role_str = f"{sty.get('C', '')}🤖 {_('view.role_assistant')}{agent_tag} [{ts}]{lr}"
+            else:
+                role_str = f"{sty.get('Y', '')}⚙️ {role} [{ts}]{lr}"
+
+            lines.append(sep)
+            lines.append(role_str)
+            lines.append(sep)
+
+            for i, part in enumerate(msg.get("parts", [])):
+                formatted = _format_part_ansi(part, sty)
+                if formatted:
+                    if i > 0:
+                        lines.append("")
+                    lines.append(formatted)
+
+    lines.append(f"{sty.get('M', '')}─── {_('view.footer')} ───{lr}")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+# ======================================================================
+# Part formatting (ANSI version of format_part_to_md)
+# ======================================================================
+
+
+def _format_part_ansi(part, sty) -> str:
+    """Форматирует часть сообщения с ANSI-цветами."""
+    t = part.get("type", "")
+
+    if t == "text":
+        text = part.get("text", "").strip()
+        if not text:
+            return ""
+        return md_render(text, sty, plain=not sty)
+
+    if t == "reasoning":
+        text = part.get("text", "").strip()
+        if not text:
+            return ""
+        title = f"{sty.get('Y', '')}{sty.get('D', '')}💭 {_('md.reasoning')}:{sty.get('R', '')}"
+        body = f"{sty.get('D', '')}{text}{sty.get('R', '')}"
+        return f"{title}\n{body}"
+
+    if t == "sound":
+        return f"{sty.get('Y', '')}*🔊 {_('md.sound')}*{sty.get('R', '')}"
+
+    if t == "tool":
+        tool_name = part.get("tool", "?")
+        t_input = part.get("input", {})
+        t_output = part.get("output", "")
+        t_status = part.get("status", "")
+
+        icon = {"completed": "✅", "error": "❌", "running": "⏳"}.get(t_status, "🔧")
+        y = sty.get("Y", "")
+        r = sty.get("R", "")
+
+        if tool_name == "read":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} read:{r} `{fp}`"
+        if tool_name == "write":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} write:{r} `{fp}`"
+        if tool_name == "edit":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} edit:{r} `{fp}`"
+        if tool_name == "glob":
+            pat = t_input.get("pattern", "")
+            pth = t_input.get("path", "")
+            if pth:
+                return f"{y}{icon} glob:{r} `{pat}` in `{pth}`"
+            return f"{y}{icon} glob:{r} `{pat}`"
+        if tool_name == "grep":
+            pat = t_input.get("pattern", "")
+            return f"{y}{icon} grep:{r} `{pat}`"
+
+        lines = [f"{y}{icon} {tool_name}{r}"]
+        if t_input:
+            for k, v in t_input.items():
+                s = str(v)
+                if len(s) > 200:
+                    s = s[:200] + "..."
+                lines.append(f"  {k}: {s}")
+        if t_output:
+            out = str(t_output).strip()
+            if out:
+                if len(out) > 300:
+                    out = out[:300] + "..."
+                lines.append(f"  → {out}")
+        return "\n".join(lines)
+
+    return ""
+
+
+# ======================================================================
+# Pager
+# ======================================================================
+
+
+def _page_text(text: str) -> None:
+    """Pipe text through $PAGER or less -R."""
+    pager_cmd = os.environ.get("PAGER", "")
+    try:
+        if pager_cmd:
+            subprocess.run(pager_cmd, input=text, text=True, shell=True)
+        elif shutil.which("less"):
+            subprocess.run(["less", "-R"], input=text, text=True)
+        else:
+            sys.stdout.write(text)
+            if not text.endswith("\n"):
+                sys.stdout.write("\n")
+            sys.stdout.flush()
+    except OSError:
+        sys.stdout.write(text)
+        if not text.endswith("\n"):
+            sys.stdout.write("\n")
+        sys.stdout.flush()

commands/__init__.py

@@ -23,6 +23,7 @@ import cmd_stats
 import cmd_todos
 import cmd_tree
 import cmd_vacuum
+import cmd_view
 
 # Словарь {имя_команды: модуль}
 # Модуль должен иметь register(subparsers) и run(args, db)
@@ -39,6 +40,7 @@ COMMANDS = {
     "stats": cmd_stats,
     "todos": cmd_todos,
     "vacuum": cmd_vacuum,
+    "view": cmd_view,
     "help": cmd_help,
 }
 

formatters.py

@@ -15,28 +15,61 @@ def print_json(data: Any) -> None:
     print(json.dumps(data, ensure_ascii=False, indent=2, default=str))
 
 
-def print_table_simple(headers: list[str], rows: list[list], sep: str = "  ") -> None:
-    """Выводит таблицу с авто-шириной колонок."""
+def print_table_simple(
+    headers: list[str],
+    rows: list[list],
+    sep: str = "  ",
+) -> None:
+    """Выводит таблицу с рамкой и колонками.
+
+    Формат:
+      ┌──────┬───────────┐
+      │ ID   │ Title     │
+      ├──────┼───────────┤
+      │ abc  │ Session 1 │
+      └──────┴───────────┘
+    """
     if not rows:
         print(_("empty"))
         return
 
+    ncols = len(headers)
+    pad = 1  # padding inside each cell
+
+    # compute column widths
     widths = []
-    for ci in range(len(headers)):
+    for ci in range(ncols):
         max_w = len(headers[ci])
         for row in rows:
             max_w = max(max_w, len(str(row[ci])))
-        widths.append(min(max_w + 1, 80))
-
-    line = sep.join(h.ljust(widths[i])[: widths[i]] for i, h in enumerate(headers))
-    sep_line = "─" * len(line)
+        widths.append(min(max_w + pad * 2, 80))
+
+    tl = "┌"  # top-left
+    tm = "┬"  # top-middle
+    tr = "┐"  # top-right
+    ml = "├"  # middle-left
+    mm = "┼"  # middle-middle
+    mr = "┤"  # middle-right
+    bl = "└"  # bottom-left
+    bm = "┴"  # bottom-middle
+    br = "┘"  # bottom-right
+    ve = "│"  # vertical edge
+
+    top = tl + tm.join("─" * w for w in widths) + tr
+    sep = ml + mm.join("─" * w for w in widths) + mr
+    bot = bl + bm.join("─" * w for w in widths) + br
+
+    header_cells = [h.center(widths[ci])[: widths[ci]] for ci, h in enumerate(headers)]
+    header_line = ve + ve.join(header_cells) + ve
 
     print()
-    print(line)
-    print(sep_line)
+    print(top)
+    print(header_line)
+    print(sep)
     for row in rows:
-        line = sep.join(str(row[i]).ljust(widths[i])[: widths[i]] for i in range(len(headers)))
-        print(line)
+        cells = [str(row[ci]).ljust(widths[ci])[: widths[ci]] for ci in range(ncols)]
+        print(ve + ve.join(cells) + ve)
+    print(bot)
     print(_("fmt.rows_count", n=len(rows)))
 
 

i18n.py

@@ -349,6 +349,65 @@ L: dict[str, dict[str, str]] = {
     "vacuum.done": {"ru": "✅", "en": "✅"},
     "vacuum.canceled": {"ru": "  Отменено.", "en": "  Canceled."},
     # ==================================================================
+    # VIEW
+    # ==================================================================
+    "view.header": {
+        "ru": "Просмотр сессии",
+        "en": "Session View",
+    },
+    "view.role_user": {
+        "ru": "Вы",
+        "en": "You",
+    },
+    "view.role_assistant": {
+        "ru": "Ассистент",
+        "en": "Assistant",
+    },
+    "view.no_messages": {
+        "ru": "⏳ Нет сообщений в этой сессии.",
+        "en": "⏳ No messages in this session.",
+    },
+    "view.no_sessions": {
+        "ru": "❌ Нет сессий для просмотра.",
+        "en": "❌ No sessions to view.",
+    },
+    "view.interactive_header": {
+        "ru": "Последние сессии:",
+        "en": "Recent sessions:",
+    },
+    "view.interactive_prompt": {
+        "ru": "Выбери номер (или Enter для отмены): ",
+        "en": "Pick a number (or Enter to cancel): ",
+    },
+    "view.interactive_error": {
+        "ru": "Введи число от 1 до {n}",
+        "en": "Enter a number from 1 to {n}",
+    },
+    "view.interactive_viewing": {
+        "ru": "  Просмотр: {title}",
+        "en": "  Viewing: {title}",
+    },
+    "view.interactive_abort": {
+        "ru": "  Отменено.",
+        "en": "  Canceled.",
+    },
+    "view.footer": {
+        "ru": "конец сессии",
+        "en": "end of session",
+    },
+    "view.flag.latest": {
+        "ru": "Просмотр самой свежей сессии",
+        "en": "View the most recent session",
+    },
+    "view.flag.no_pager": {
+        "ru": "Вывод без пейджера (просто печатать)",
+        "en": "Print without pager",
+    },
+    "view.flag.raw": {
+        "ru": "Без ANSI-цветов (обычный текст)",
+        "en": "Plain text, no ANSI colors",
+    },
+    # ==================================================================
     # HELP
     # ==================================================================
     "help.header_box_top": {
@@ -412,6 +471,7 @@ L: dict[str, dict[str, str]] = {
     "help.cmd.stats": {"ru": "Статистика БД", "en": "Database statistics"},
     "help.cmd.todos": {"ru": "Задачи из сессий", "en": "Tasks from sessions"},
     "help.cmd.vacuum": {"ru": "Оптимизация БД", "en": "Database optimization"},
+    "help.cmd.view": {"ru": "Просмотр сессии с прокруткой", "en": "View session with scrolling"},
     "help.cmd.help": {"ru": "Подробная справка", "en": "Detailed help"},
     # ==================================================================
     # HELP — примеры (epilog для argparse --help)
@@ -489,6 +549,26 @@ L: dict[str, dict[str, str]] = {
         "en": "VACUUM + REINDEX + ANALYZE with confirmation",
     },
     "help.vacuum.e1": {"ru": "Без подтверждения", "en": "Skip confirmation"},
+    "help.view.e0": {
+        "ru": "Просмотр по ID",
+        "en": "View by ID",
+    },
+    "help.view.e1": {
+        "ru": "Самая свежая сессия",
+        "en": "Most recent session",
+    },
+    "help.view.e2": {
+        "ru": "Интерактивный выбор из списка",
+        "en": "Interactive picker",
+    },
+    "help.view.e3": {
+        "ru": "Без пейджера (простой вывод)",
+        "en": "Without pager (plain output)",
+    },
+    "help.view.e4": {
+        "ru": "Без ANSI-цветов",
+        "en": "Without ANSI colors",
+    },
     "help.help.e0": {
         "ru": "Общая справка по всем командам",
         "en": "General help for all commands",

markdown_to_ansi.py

@@ -0,0 +1,221 @@
+"""Конвертация Markdown в ANSI-форматированный текст для терминала.
+
+Режимы:
+  - rich (опционально): через `pip install opencode-db[rich]`
+  - fallback: stdlib (re) + ANSI escape codes, zero external deps
+"""
+
+from __future__ import annotations
+
+import re
+
+HAS_RICH: bool = False
+_RICH_CONSOLE = None
+try:
+    from rich.console import Console
+
+    _RICH_CONSOLE = Console(force_terminal=True, color_system="truecolor")
+    HAS_RICH = True
+except ImportError:
+    pass
+
+
+def render(text: str, styles: dict[str, str] | None = None, *, plain: bool = False) -> str:
+    """Конвертирует Markdown-текст в ANSI-форматированный вывод.
+
+    При наличии rich использует его Markdown-рендерер (полное качество),
+    иначе — встроенный конвертер (базовые конструкции).
+
+    Args:
+      text: исходный Markdown-текст
+      styles: dict с ANSI-кодами (только для fallback)
+      plain: True — вернуть как есть (без форматирования)
+
+    Returns:
+      str с ANSI-escape последовательностями
+    """
+    if not text:
+        return ""
+
+    if plain:
+        return text
+
+    if HAS_RICH and _RICH_CONSOLE is not None:
+        return _render_rich(text)
+
+    return _render_fallback(text, styles or {})
+
+
+# ======================================================================
+# RENDERER: rich
+# ======================================================================
+
+
+def _render_rich(text: str) -> str:
+    from rich.markdown import Markdown
+
+    with _RICH_CONSOLE.capture() as capture:
+        _RICH_CONSOLE.print(Markdown(text))
+    result = capture.get()
+    return result.rstrip("\n")
+
+
+# ======================================================================
+# RENDERER: fallback (stdlib)
+# ======================================================================
+
+
+def _render_fallback(text: str, sty: dict[str, str]) -> str:
+    r = sty.get("R", "")
+    bold = sty.get("B", "")
+    dim = sty.get("D", "")
+    cyan = sty.get("C", "")
+    yellow = sty.get("Y", "")
+    gray = sty.get("M", "")
+    green = sty.get("G", "")
+
+    result = text
+
+    # fenced code blocks
+    result = re.sub(
+        r"```(\w*)\n(.*?)```",
+        lambda m: _fb_code_block(m.group(1), m.group(2), sty),
+        result,
+        flags=re.DOTALL,
+    )
+
+    # inline code
+    result = re.sub(r"`([^`]+)`", rf"{yellow}\1{r}", result)
+
+    # bold **...**
+    result = re.sub(r"\*\*(.+?)\*\*", rf"{bold}\1{r}", result)
+
+    # italic *...*
+    result = re.sub(r"(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)", rf"{dim}\1{r}", result)
+
+    # headings
+    result = re.sub(
+        r"^#{1,3} (.+)$",
+        rf"{bold}{cyan}\1{r}",
+        result,
+        flags=re.MULTILINE,
+    )
+
+    # blockquotes
+    result = re.sub(
+        r"^> (.+)$",
+        lambda m: _fb_blockquote(m.group(1), sty),
+        result,
+        flags=re.MULTILINE,
+    )
+
+    # horizontal rules
+    result = re.sub(
+        r"^---+$",
+        f"{gray}{'─' * 60}{r}",
+        result,
+        flags=re.MULTILINE,
+    )
+
+    # unordered lists
+    result = re.sub(r"^(\s*)[-*] ", r"\1• ", result, flags=re.MULTILINE)
+
+    # ordered lists
+    result = re.sub(
+        r"^(\s*)(\d+)\. ",
+        lambda m: f"{m.group(1)}{green}{m.group(2)}.{r} ",
+        result,
+        flags=re.MULTILINE,
+    )
+
+    # links [text](url)
+    result = re.sub(
+        r"\[([^\]]+)\]\(([^)]+)\)",
+        lambda m: f"{m.group(1)} ({gray}{m.group(2)}{r})",
+        result,
+    )
+
+    # tables: convert to box-drawing
+    result = re.sub(
+        r"^(\|.+)$(?:\n\|.+)+\n\|.+(?:\n\|.+)*",
+        lambda m: _fb_table(m.group(0), sty),
+        result,
+        flags=re.MULTILINE,
+    )
+
+    return result
+
+
+def _fb_code_block(lang: str, body: str, sty: dict[str, str]) -> str:
+    r = sty.get("R", "")
+    gray = sty.get("M", "")
+    yellow = sty.get("Y", "")
+    lang_tag = f" {lang}" if lang else ""
+    header = f"{gray}┌─{lang_tag}{r}"
+    footer = f"{gray}└──{r}"
+    lines = body.strip().split("\n")
+    indented = "\n".join(f"{yellow}{line}{r}" for line in lines)
+    return f"{header}\n{indented}\n{footer}"
+
+
+def _fb_blockquote(line: str, sty: dict[str, str]) -> str:
+    gray = sty.get("M", "")
+    r = sty.get("R", "")
+    return f"{gray}│ {line}{r}"
+
+
+def _fb_table(text: str, sty: dict[str, str]) -> str:
+    """Converts a Markdown table to box-drawing format."""
+    lines = [ln.strip() for ln in text.strip().split("\n") if ln.strip()]
+    if len(lines) < 3:
+        return text
+
+    # skip separator row (|--|--|)
+    data_rows = []
+    for line in lines:
+        if not line.strip().startswith("|"):
+            continue
+        if re.match(r"^\|[-| ]+\|$", line):
+            continue
+        cells = [c.strip() for c in line.strip().strip("|").split("|")]
+        data_rows.append(cells)
+
+    if len(data_rows) < 2:
+        return text
+
+    ncols = max(len(r) for r in data_rows)
+    pad = 1
+
+    widths: list[int] = []
+    for ci in range(ncols):
+        max_w = max(len(r[ci]) if ci < len(r) else 0 for r in data_rows)
+        widths.append(max_w + pad * 2)
+
+    tl, tm, tr = "┌", "┬", "┐"
+    ml, mm, mr = "├", "┼", "┤"
+    bl, bm, br = "└", "┴", "┘"
+    ve = "│"
+    r = sty.get("R", "")
+    gray = sty.get("M", "")
+
+    top = tl + tm.join("─" * w for w in widths) + tr
+    sep = ml + mm.join("─" * w for w in widths) + mr
+    bot = bl + bm.join("─" * w for w in widths) + br
+
+    header_cells = [
+        (data_rows[0][ci] if ci < len(data_rows[0]) else "").center(widths[ci])[: widths[ci]]
+        for ci in range(ncols)
+    ]
+    header_line = f"{gray}{ve}{ve.join(header_cells)}{ve}{r}"
+
+    result = [f"{gray}{top}{r}", header_line, f"{gray}{sep}{r}"]
+
+    for row in data_rows[1:]:
+        cells = [
+            (row[ci] if ci < len(row) else "").ljust(widths[ci])[: widths[ci]]
+            for ci in range(ncols)
+        ]
+        result.append(f"{ve}{ve.join(cells)}{ve}")
+
+    result.append(f"{gray}{bot}{r}")
+    return "\n".join(result)

opencode_db-0.7.2.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: opencode-db
+Version: 0.7.2
+Summary: OpenCode database CLI manager — browse, export, analyze, clean up sessions
+Project-URL: Homepage, https://github.com/VasilevNStas/opencode-db
+Project-URL: Source, https://github.com/VasilevNStas/opencode-db
+Project-URL: Tracker, https://github.com/VasilevNStas/opencode-db/issues
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == "rich"
+Provides-Extra: all
+Requires-Dist: opencode-db[rich]; extra == "all"
+Dynamic: license-file
+
+# opencode-db
+
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+**CLI for OpenCode's local database.** OpenCode saves every agent session, conversation, token usage, and cost in a local SQLite file. This tool lets you inspect, export, analyze, and clean up that data.
+
+```bash
+pip install opencode-db
+
+# recommended if your system python3 is older than 3.12:
+uv tool install opencode-db
+```
+
+## Quick start
+
+```bash
+opencode-db list         # recent sessions
+opencode-db view         # interactive session viewer (colored, scrollable)
+opencode-db stats        # database summary
+opencode-db costs --total  # total token costs
+opencode-db export       # export dialog to .md (interactive)
+opencode-db help         # full reference
+```
+
+## Features
+
+- **`view`** — просмотр сессии в терминале с ANSI-цветами, Markdown-рендерингом и прокруткой через `less`
+- **`list`** / **`info`** / **`search`** / **`tree`** — навигация и поиск по сессиям
+- **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
+- **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
+- **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
+
+## Optional extras
+
+```bash
+pip install opencode-db[rich]   # enhanced Markdown rendering (recommended)
+pip install opencode-db         # zero external dependencies
+```
+
+## Requirements
+
+- Python 3.12+ — the CLI checks the interpreter at startup and exits with a clear message instead of an `ImportError` on older versions
+- [OpenCode](https://opencode.ai) (must have been run at least once)
+- macOS / Linux

{opencode_db-0.6.2.dist-info → opencode_db-0.7.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-cli.py,sha256=NFOmI4lcoiDmJTC2c1YqmZ02IRbNdhrmIYUd6Y25aOY,2296
+cli.py,sha256=H-7TFu17dqAQv_bUvQsw0Tuly57Je53WzKs6yQOjajk,2428
 cmd_costs.py,sha256=LstYavRJp-ZwwianBjRGtB8XiEKByGwMf6XwOHDHZvU,6395
 cmd_delete.py,sha256=VJyaWcxr3UVIGqkZrlXs4IOkHzySbc9dt0W6sAL5IIo,11282
 cmd_export.py,sha256=OfnNE1J9z7qbGbPqp1TXYIUBZZCEcUefkJcL1qlMdRw,6627
@@ -12,15 +12,18 @@ cmd_stats.py,sha256=IE_cLoxUTPLG_UaDvjZfgCNDmRW1cNqH9mw6f1X9GXQ,4818
 cmd_todos.py,sha256=P47_HDIHm6ikHW9XsFEvPsl4jqm79X690oqXnD616d4,3182
 cmd_tree.py,sha256=OaP1xQ3cxxWkHTbST2GHVmg-re9FXINWR_FgL_X1HiU,3274
 cmd_vacuum.py,sha256=7Y6kdoKDMqIW_-Tvablge7v169tFGv3W65LB5GKgifI,2180
+cmd_view.py,sha256=fy7YJB-GcfEMl8LVXE8ogN17kt95T5KSLiMmxqRkf2o,11781
 config.py,sha256=Og_iwTlmqzpuHj5rmzkhFz33Ag915RhOE8SGsCbSr0w,694
 db.py,sha256=5NlNM9m_g2frj0oNVgJ9IIEf5oK2n6rbJqDycoVC_Mo,11914
-formatters.py,sha256=kYzSw29UOZ90fN5jxC4DQOkT8BA5kM46sFXFbM6QKk0,6841
-i18n.py,sha256=DX3wKnF5At7qovrrYFdoiyvWc9tVLprYXNElXVeAiKI,33987
-utils.py,sha256=W5BrLO3s-ck0UFVJLAERlXHF6ck6iXQrf-wRmLxUe6c,4849
-commands/__init__.py,sha256=YETQJBFAkefRCNHqXTa67blS0g8766ApVcg6OhG81oE,1252
-opencode_db-0.6.2.dist-info/licenses/LICENSE,sha256=NhUr8ufTYb5u9F08J5bmDQ0xTVmCOexoq1ki_RdCqys,1210
-opencode_db-0.6.2.dist-info/METADATA,sha256=Ghcq12mCfmHMO5H482PPrCbyiYJpNSUuPG1SIUCa2_M,1264
-opencode_db-0.6.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-opencode_db-0.6.2.dist-info/entry_points.txt,sha256=dMHc-RWkGEu0mTNvHHThSEKQdGbCdwdKUCO-cLF7TCw,41
-opencode_db-0.6.2.dist-info/top_level.txt,sha256=lKPHa0NndvZjjoZ5mIatAdvtFlPA3i-Fm_tEl3JvgTg,178
-opencode_db-0.6.2.dist-info/RECORD,,
+formatters.py,sha256=ovgtaB-gZFTCtrYl5dPWLKDUL8zG-Zl5nVHxFj2nJY4,7768
+i18n.py,sha256=7QHCc7-KcGfzA7odkesFpqfbi9XKuZ5fXZ2OTFazF68,36667
+markdown_to_ansi.py,sha256=HSr_yOZ1t1tYz5Z0Bx3yRqKzKSWxJIcuS02EKMO1WtE,6181
+runtime.py,sha256=BbKIOdGkrcgckMvOqJgfiEpp6vDAfwO0aI-uaC4-F_M,2155
+utils.py,sha256=c7RqEuxbx340RzJ1kzG14ucuf88aUzuc2gbKYb4919E,4849
+commands/__init__.py,sha256=0VZs89RtmsPYGkmgedKxPKaNtIgkMdx6HYHWHsuKCtE,1290
+opencode_db-0.7.2.dist-info/licenses/LICENSE,sha256=NhUr8ufTYb5u9F08J5bmDQ0xTVmCOexoq1ki_RdCqys,1210
+opencode_db-0.7.2.dist-info/METADATA,sha256=xB704HtWzrLTwEOtBrgPt_9BvP5Pzie1pXYpf1L5azk,2511
+opencode_db-0.7.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+opencode_db-0.7.2.dist-info/entry_points.txt,sha256=dMHc-RWkGEu0mTNvHHThSEKQdGbCdwdKUCO-cLF7TCw,41
+opencode_db-0.7.2.dist-info/top_level.txt,sha256=CnAP9fA7TDBA6mjuh2AWR2bo4ceTfTpxwLn-pe0Kcj4,212
+opencode_db-0.7.2.dist-info/RECORD,,

{opencode_db-0.6.2.dist-info → opencode_db-0.7.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{opencode_db-0.6.2.dist-info → opencode_db-0.7.2.dist-info}/top_level.txt

@@ -12,9 +12,12 @@ cmd_stats
 cmd_todos
 cmd_tree
 cmd_vacuum
+cmd_view
 commands
 config
 db
 formatters
 i18n
+markdown_to_ansi
+runtime
 utils

runtime.py

@@ -0,0 +1,55 @@
+"""Проверка минимальной версии Python.
+
+Модуль намеренно написан без синтаксиса новее Python 3.8, чтобы его можно
+было импортировать до проверки версии и показать понятную ошибку вместо
+ImportError/SyntaxError.
+"""
+
+import sys
+
+MIN_PYTHON = (3, 12)
+REQUIRED_VERSION = "3.12"
+
+
+def format_version_error(version_info=None, executable=None) -> str:
+    """Возвращает текст ошибки для неподдерживаемой версии Python."""
+    info = version_info or sys.version_info
+    exe = executable or sys.executable
+    current = f"{info[0]}.{info[1]}.{info[2]}"
+
+    return (
+        f"opencode-db requires Python {REQUIRED_VERSION}+.\n"
+        f"opencode-db требует Python {REQUIRED_VERSION}+.\n"
+        "\n"
+        f"Current interpreter: Python {current} ({exe})\n"
+        f"Текущий интерпретатор: Python {current} ({exe})\n"
+        "\n"
+        "How to fix / Как исправить:\n"
+        "  uv python install 3.13\n"
+        "  uv venv --python 3.13\n"
+        "  source .venv/bin/activate\n"
+        "  pip install -e .\n"
+        "\n"
+        "Or run with uv / Или запуск через uv:\n"
+        "  uv run --python 3.13 opencode-db --help\n"
+        "  uv tool install --editable . && opencode-db --help\n"
+        "\n"
+        "After changing the interpreter, rerun install.sh to regenerate\n"
+        "the ~/.local/bin/opencode-db launcher."
+    )
+
+
+def check_python_version(version_info=None):
+    """Возвращает None, если версия подходит, иначе текст ошибки."""
+    info = version_info or sys.version_info
+    if tuple(info[:2]) >= MIN_PYTHON:
+        return None
+    return format_version_error(info)
+
+
+def require_python() -> None:
+    """Завершает процесс с понятной ошибкой, если Python слишком старый."""
+    message = check_python_version()
+    if message:
+        print(message, file=sys.stderr)
+        raise SystemExit(1)

utils.py

@@ -50,7 +50,7 @@ def parse_date(date_str: str) -> datetime | None:
         return None
 
 
-def parse_time_spec(spec) -> None | datetime:
+def parse_time_spec(spec) -> datetime | None:
     """Парсит спецификацию времени ('30d', '6m', '1y') в timedelta."""
     if not spec or not isinstance(spec, str):
         return None

opencode_db-0.6.2.dist-info/METADATA

@@ -1,38 +0,0 @@
-Metadata-Version: 2.4
-Name: opencode-db
-Version: 0.6.2
-Summary: OpenCode database CLI manager — browse, export, analyze, clean up sessions
-Project-URL: Homepage, https://github.com/VasilevNStas/opencode-db
-Project-URL: Source, https://github.com/VasilevNStas/opencode-db
-Project-URL: Tracker, https://github.com/VasilevNStas/opencode-db/issues
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# opencode-db
-
-[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
-
-**CLI for OpenCode's local database.** OpenCode saves every agent session, conversation, token usage, and cost in a local SQLite file. This tool lets you inspect, export, analyze, and clean up that data.
-
-```bash
-pip install opencode-db
-```
-
-## Quick start
-
-```bash
-opencode-db list         # recent sessions
-opencode-db stats        # database summary
-opencode-db costs --total  # total token costs
-opencode-db export       # export dialog to .md (interactive)
-opencode-db help         # full reference
-```
-
-## Requirements
-
-- Python 3.12+
-- [OpenCode](https://opencode.ai) (must have been run at least once)
-- macOS / Linux