opencode-db 0.7.2__tar.gz → 0.7.3__tar.gz

{opencode_db-0.7.2/opencode_db.egg-info → opencode_db-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-db
-Version: 0.7.2
+Version: 0.7.3
 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
@@ -17,7 +17,7 @@ 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)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/VasilevNStas/opencode-db/blob/master/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.
 

{opencode_db-0.7.2 → opencode_db-0.7.3}/README.md

@@ -8,6 +8,8 @@
 
 **OpenCode stores everything in a local SQLite database.** Every agent session, conversation, token usage, and cost is saved automatically. `opencode-db` is the CLI tool to work with that database — list sessions, export conversations to Markdown, track token costs, prune old data, and more.
 
+[Русская версия](docs/README.ru.md)
+
 ```
 opencode-db help        # full reference with examples
 opencode-db list        # list recent sessions
@@ -110,8 +112,8 @@ if sys.version_info < (3, 12):
 PKG_DIR = os.path.expanduser("~/.local/share/opencode-db")
 if PKG_DIR not in sys.path:
     sys.path.insert(0, PKG_DIR)
-import cli
-sys.exit(cli.main())
+from opencode_db.cli import main
+sys.exit(main())
 SCRIPT
 chmod +x ~/.local/bin/opencode-db
 ```
@@ -507,51 +509,54 @@ Example output:
 ## Project architecture
 
 ```
-~/.local/bin/opencode-db                  ← entry point (in $PATH)
-│
-~/.local/share/opencode-db/               ← all source code
-│
-├── __init__.py                           ← executable entry point
-├── __main__.py                           ← python3 . (directory entry point)
-├── cli.py                                ← argparse + command dispatcher
-│
-├── config.py                             ← constants and paths
-├── runtime.py                            ← Python 3.12+ version guard
-├── db.py                                 ← SQLite queries
-├── utils.py                              ← date/token formatting, validation
-├── formatters.py                         ← tables, JSON, Markdown, snapshots
-├── i18n.py                               ← localization (EN/RU, 280 keys)
-├── markdown_to_ansi.py                   ← Markdown → ANSI renderer for `view`
-│
-├── commands/
-│   └── __init__.py                       ← command registry
+opencode-db/
+├── opencode_db/                          ← Python package (installed as opencode_db)
+│   ├── __init__.py                       ← package init + Python version guard
+│   ├── __main__.py                       ← python3 -m opencode_db
+│   ├── cli.py                            ← argparse + command dispatcher
+│   ├── config.py                         ← constants and paths
+│   ├── db.py                             ← SQLite queries
+│   ├── formatters.py                     ← tables, JSON, Markdown, snapshots
+│   ├── i18n.py                           ← localization (EN/RU, 280 keys)
+│   ├── markdown_to_ansi.py               ← Markdown → ANSI renderer for `view`
+│   ├── runtime.py                        ← Python 3.12+ version guard
+│   ├── utils.py                          ← date/token formatting, validation
+│   └── commands/
+│       ├── __init__.py                   ← command registry
+│       ├── cmd_list.py                   ← opencode-db list
+│       ├── cmd_info.py                   ← opencode-db info
+│       ├── cmd_export.py                 ← opencode-db export
+│       ├── cmd_delete.py                 ← opencode-db delete
+│       ├── cmd_costs.py                  ← opencode-db costs
+│       ├── cmd_prune.py                  ← opencode-db prune
+│       ├── cmd_search.py                 ← opencode-db search
+│       ├── cmd_tree.py                   ← opencode-db tree
+│       ├── cmd_projects.py               ← opencode-db projects
+│       ├── cmd_stats.py                  ← opencode-db stats
+│       ├── cmd_todos.py                  ← opencode-db todos
+│       ├── cmd_vacuum.py                 ← opencode-db vacuum
+│       ├── cmd_view.py                   ← opencode-db view
+│       └── cmd_help.py                   ← opencode-db help
 │
-├── cmd_list.py                           ← opencode-db list
-├── cmd_info.py                           ← opencode-db info
-├── cmd_export.py                         ← opencode-db export
-├── cmd_delete.py                         ← opencode-db delete
-├── cmd_costs.py                          ← opencode-db costs
-├── cmd_prune.py                          ← opencode-db prune
-├── cmd_search.py                         ← opencode-db search
-├── cmd_tree.py                           ← opencode-db tree
-├── cmd_projects.py                       ← opencode-db projects
-├── cmd_stats.py                          ← opencode-db stats
-├── cmd_todos.py                          ← opencode-db todos
-├── cmd_vacuum.py                         ← opencode-db vacuum
-├── cmd_view.py                           ← opencode-db view
-└── cmd_help.py                           ← opencode-db help
-
-README.md                                 ← this file (English)
-README.ru.md                              ← documentation in Russian
-opencode-db-commands.json                 ← OpenCode TUI custom commands config
+├── docs/
+│   ├── README.ru.md                      ← documentation in Russian
+│   └── README_PYPI.md                    ← PyPI page
+├── contrib/
+│   └── opencode-db-commands.json         ← OpenCode TUI custom commands config
+├── tests/
+├── README.md                             ← this file (English)
+├── LICENSE
+├── Makefile
+├── pyproject.toml
+└── install.sh
 ```
 
 ### How it works
 
-1. The launcher script at `~/.local/bin/opencode-db` (a shebang Python script) adds `~/.local/share/opencode-db/` to `sys.path` and calls `cli.main()`.
+1. The console script `opencode-db` (or `python3 -m opencode_db`) imports `opencode_db.cli` and calls `main()`.
 2. `runtime.require_python()` checks the interpreter before importing `cli`/`db`; on Python < 3.12 it prints a clear message with remediation steps instead of failing with `ImportError`.
 3. `cli.py` builds an `argparse` parser with subparsers from every command module and dispatches the call.
-4. Each command is a separate `cmd_*.py` module exporting two functions: `register(subparsers)` and `run(args, db)`.
+4. Each command is a separate `opencode_db/commands/cmd_*.py` module exporting two functions: `register(subparsers)` and `run(args, db)`.
 5. `db.py` opens a connection to OpenCode's SQLite database (`~/.local/share/opencode/opencode.db`).
 6. Destructive operations (`delete`, `prune`) always require confirmation (or `--force`).
 
@@ -586,7 +591,7 @@ This runs the command directly and shows the output — **no tokens are consumed
 
 ### Custom `/db` command (uses AI, consumes tokens)
 
-Add the commands from `opencode-db-commands.json` to your project's `opencode.json`:
+Add the commands from `contrib/opencode-db-commands.json` to your project's `opencode.json`:
 
 ```json
 {
@@ -614,7 +619,7 @@ Then in the TUI:
 
 A ready-to-use config file is provided at:
 ```
-~/.local/share/opencode-db/opencode-db-commands.json
+~/.local/share/opencode-db/contrib/opencode-db-commands.json
 ```
 
 ---
@@ -728,7 +733,7 @@ cd opencode-db
 uv venv --python 3.13
 source .venv/bin/activate
 uv pip install -e ".[rich]"
-uv pip install pytest ruff
+uv pip install pytest ruff==0.17.1
 
 make check          # check-python + ruff + 191 tests
 ```
@@ -737,7 +742,7 @@ make check          # check-python + ruff + 191 tests
 
 ### Adding a new command
 
-1. Create `cmd_xxx.py`:
+1. Create `opencode_db/commands/cmd_xxx.py`:
 
 ```python
 def register(subparsers):
@@ -749,7 +754,7 @@ def run(args, db):
     return 0
 ```
 
-2. Register it in `commands/__init__.py`:
+2. Register it in `opencode_db/commands/__init__.py`:
 
 ```python
 import cmd_xxx
@@ -767,7 +772,7 @@ python3 ~/.local/share/opencode-db list
 Or from the repository root (Python 3.12+):
 
 ```bash
-python3 . list
+python3 -m opencode_db list
 uvx --from . opencode-db list
 ```
 

{opencode_db-0.7.2 → opencode_db-0.7.3/docs}/README_PYPI.md

@@ -1,7 +1,7 @@
 # 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)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/VasilevNStas/opencode-db/blob/master/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.
 

opencode_db-0.7.3/opencode_db/__init__.py

@@ -0,0 +1,5 @@
+"""opencode-db: CLI for OpenCode's local SQLite database."""
+
+from .runtime import require_python
+
+require_python()

opencode_db-0.7.3/opencode_db/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python3 -m opencode_db`."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/cli.py

@@ -14,13 +14,13 @@ import os
 import sys
 from typing import Any, Literal
 
-from runtime import require_python
+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
+from . import commands  # noqa: E402
+from .db import get_db  # noqa: E402
+from .i18n import _, set_lang  # noqa: E402
 
 
 def build_parser() -> argparse.ArgumentParser:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/commands/__init__.py

@@ -5,25 +5,27 @@
   - run(args, db) — выполняет команду
 
 Добавление новой команды:
-  1. Создать cmd_xxx.py
-  2. Добавить import cmd_xxx
+  1. Создать opencode_db/commands/cmd_xxx.py
+  2. Добавить `from . import cmd_xxx`
   3. Добавить "xxx": cmd_xxx в COMMANDS
 """
 
-import cmd_costs
-import cmd_delete
-import cmd_export
-import cmd_help
-import cmd_info
-import cmd_list
-import cmd_projects
-import cmd_prune
-import cmd_search
-import cmd_stats
-import cmd_todos
-import cmd_tree
-import cmd_vacuum
-import cmd_view
+from . import (
+    cmd_costs,
+    cmd_delete,
+    cmd_export,
+    cmd_help,
+    cmd_info,
+    cmd_list,
+    cmd_projects,
+    cmd_prune,
+    cmd_search,
+    cmd_stats,
+    cmd_todos,
+    cmd_tree,
+    cmd_vacuum,
+    cmd_view,
+)
 
 # Словарь {имя_команды: модуль}
 # Модуль должен иметь register(subparsers) и run(args, db)

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_costs.py

@@ -5,9 +5,9 @@
 
 import argparse
 
-from db import SessionError, get_session_info, get_session_title, parse_model
-from i18n import _
-from utils import build_help_epilog, format_cost, format_tokens
+from ..db import SessionError, get_session_info, get_session_title, parse_model
+from ..i18n import _
+from ..utils import build_help_epilog, format_cost, format_tokens
 
 _COSTS_EXAMPLES = [
     ("", "help.costs.e0"),
@@ -57,7 +57,7 @@ def _show_session(db, session_id, as_json) -> int:
     cost = info["cost"] or 0
 
     if as_json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         print_json(
             {
@@ -115,7 +115,7 @@ def _show_total(db, project_id, as_json) -> int:
     total_tr = row["tr"] or 0
 
     if as_json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         print_json(
             {
@@ -165,7 +165,7 @@ def _show_list(db, project_id, limit, as_json) -> int:
     ).fetchall()
 
     if as_json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         data = []
         for r in rows:
@@ -183,7 +183,7 @@ def _show_list(db, project_id, limit, as_json) -> int:
         print_json(data)
         return 0
 
-    from formatters import print_table_simple
+    from ..formatters import print_table_simple
 
     table = []
     for r in rows:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_delete.py

@@ -2,7 +2,7 @@
 
 import argparse
 
-from db import (
+from ..db import (
     SessionError,
     get_message_count,
     get_part_count,
@@ -11,8 +11,8 @@ from db import (
     get_session_title,
     parse_model,
 )
-from i18n import _
-from utils import build_help_epilog, confirm, format_cost, format_ts, parse_date, parse_time_spec
+from ..i18n import _
+from ..utils import build_help_epilog, confirm, format_cost, format_ts, parse_date, parse_time_spec
 
 _DELETE_EXAMPLES = [
     ("<session_id>", "help.delete.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_export.py

@@ -9,7 +9,7 @@
 import argparse
 import os
 
-from db import (
+from ..db import (
     SessionError,
     get_latest_session,
     get_messages,
@@ -18,9 +18,9 @@ from db import (
     get_session_title,
     parse_model,
 )
-from formatters import collect_snapshot, format_part_to_md, update_log
-from i18n import _
-from utils import build_help_epilog, format_cost, format_ts, format_ts_short
+from ..formatters import collect_snapshot, format_part_to_md, update_log
+from ..i18n import _
+from ..utils import build_help_epilog, format_cost, format_ts, format_ts_short
 
 _EXPORT_EXAMPLES = [
     ("<session_id>", "help.export.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_help.py

@@ -3,8 +3,8 @@
 import argparse
 from typing import Literal
 
-from i18n import _
-from utils import build_help_epilog
+from ..i18n import _
+from ..utils import build_help_epilog
 
 _HELP_EXAMPLES = [
     ("", "help.help.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_info.py

@@ -2,7 +2,7 @@
 
 import argparse
 
-from db import (
+from ..db import (
     SessionError,
     get_children_sessions,
     get_message_count,
@@ -14,8 +14,8 @@ from db import (
     get_session_todos,
     parse_model,
 )
-from i18n import _
-from utils import build_help_epilog, format_cost, format_tokens, format_ts
+from ..i18n import _
+from ..utils import build_help_epilog, format_cost, format_tokens, format_ts
 
 _INFO_EXAMPLES = [
     ("<session_id>", "help.info.e0"),
@@ -104,7 +104,7 @@ def run(args, db) -> int:
         if parent:
             data["parent"] = {"id": parent["id"], "title": parent["title"]}
 
-        from formatters import print_json
+        from ..formatters import print_json
 
         print_json(data)
         return 0

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_list.py

@@ -3,11 +3,11 @@
 import argparse
 from typing import Literal
 
-import db as db_module
-from db import get_session_title, parse_model
-from formatters import print_json, print_table_simple
-from i18n import _
-from utils import build_help_epilog, format_ts
+from .. import db as db_module
+from ..db import get_session_title, parse_model
+from ..formatters import print_json, print_table_simple
+from ..i18n import _
+from ..utils import build_help_epilog, format_ts
 
 _LIST_EXAMPLES = [
     ("", "help.list.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_projects.py

@@ -3,8 +3,8 @@
 import argparse
 from typing import Literal
 
-from i18n import _
-from utils import build_help_epilog, format_cost, format_tokens, format_ts
+from ..i18n import _
+from ..utils import build_help_epilog, format_cost, format_tokens, format_ts
 
 _PROJECTS_EXAMPLES = [
     ("", "help.projects.e0"),
@@ -37,7 +37,7 @@ def run(args, db) -> Literal[0]:
     """).fetchall()
 
     if args.json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         data = []
         for r in rows:
@@ -59,7 +59,7 @@ def run(args, db) -> Literal[0]:
         print_json(data)
         return 0
 
-    from formatters import print_table_simple
+    from ..formatters import print_table_simple
 
     table = []
     for r in rows:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_prune.py

@@ -2,9 +2,9 @@
 
 import argparse
 
-from cmd_delete import run as delete_run
-from i18n import _
-from utils import build_help_epilog
+from ..i18n import _
+from ..utils import build_help_epilog
+from .cmd_delete import run as delete_run
 
 _PRUNE_EXAMPLES = [
     ("--older-than 90d", "help.prune.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_search.py

@@ -3,9 +3,9 @@
 import argparse
 import json
 
-from db import SessionError, resolve_session_id
-from i18n import _
-from utils import build_help_epilog, format_ts
+from ..db import SessionError, resolve_session_id
+from ..i18n import _
+from ..utils import build_help_epilog, format_ts
 
 _SEARCH_EXAMPLES = [
     ('"text"', "help.search.e0"),
@@ -103,7 +103,7 @@ def run(args, db) -> int:
             break
 
     if args.json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         print_json(results)
         return 0

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_stats.py

@@ -3,9 +3,9 @@
 import argparse
 from typing import Literal
 
-from db import parse_model
-from i18n import _
-from utils import build_help_epilog, format_cost, format_tokens, format_ts
+from ..db import parse_model
+from ..i18n import _
+from ..utils import build_help_epilog, format_cost, format_tokens, format_ts
 
 _STATS_EXAMPLES = [
     ("", "help.stats.e0"),
@@ -64,7 +64,7 @@ def run(args, db) -> Literal[0]:
     """).fetchall()
 
     if args.json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         data = {
             "sessions": session_count,

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_todos.py

@@ -2,9 +2,9 @@
 
 import argparse
 
-from db import SessionError, resolve_session_id
-from i18n import _
-from utils import build_help_epilog, format_ts
+from ..db import SessionError, resolve_session_id
+from ..i18n import _
+from ..utils import build_help_epilog, format_ts
 
 _TODOS_EXAMPLES = [
     ("", "help.todos.e0"),
@@ -65,7 +65,7 @@ def run(args, db) -> int:
     ).fetchall()
 
     if args.json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         data = []
         for r in rows:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_tree.py

@@ -2,9 +2,9 @@
 
 import argparse
 
-from db import SessionError, get_session_title, resolve_session_id
-from i18n import _
-from utils import build_help_epilog, format_ts
+from ..db import SessionError, get_session_title, resolve_session_id
+from ..i18n import _
+from ..utils import build_help_epilog, format_ts
 
 _TREE_EXAMPLES = [
     ("", "help.tree.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_vacuum.py

@@ -4,9 +4,9 @@ import argparse
 import os
 from typing import Literal
 
-from config import OPENCODE_DB
-from i18n import _
-from utils import build_help_epilog, confirm
+from ..config import OPENCODE_DB
+from ..i18n import _
+from ..utils import build_help_epilog, confirm
 
 _VACUUM_EXAMPLES = [
     ("", "help.vacuum.e0"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db/commands}/cmd_view.py

@@ -15,7 +15,7 @@ import shutil
 import subprocess
 import sys
 
-from db import (
+from ..db import (
     SessionError,
     get_latest_session,
     get_messages,
@@ -25,9 +25,9 @@ from db import (
     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
+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"),

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/db.py

@@ -12,8 +12,8 @@ import os
 import sqlite3
 import sys
 
-from config import OPENCODE_DB
-from i18n import _
+from .config import OPENCODE_DB
+from .i18n import _
 
 
 class SessionError(Exception):

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/formatters.py

@@ -6,8 +6,8 @@ import json
 import os
 from typing import Any
 
-from config import IGNORE_DIRS
-from i18n import _
+from .config import IGNORE_DIRS
+from .i18n import _
 
 
 def print_json(data: Any) -> None:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/i18n.py

@@ -1,7 +1,7 @@
 """Интернационализация: поддержка русского и английского языка.
 
 Использование:
-  from i18n import _, set_lang
+  from opencode_db.i18n import _, set_lang
 
   set_lang("en")
   print(_("list.header.id"))          # → "ID"

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db}/utils.py

@@ -11,7 +11,7 @@ import re
 from datetime import UTC, datetime, timedelta
 from typing import Literal, LiteralString
 
-from i18n import _
+from .i18n import _
 
 
 def parse_ts(ts_ms) -> datetime:

{opencode_db-0.7.2 → opencode_db-0.7.3/opencode_db.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-db
-Version: 0.7.2
+Version: 0.7.3
 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
@@ -17,7 +17,7 @@ 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)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/VasilevNStas/opencode-db/blob/master/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.