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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-db
-Version: 0.7.2
+Version: 0.8.0
 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.
 
@@ -34,6 +34,7 @@ uv tool install opencode-db
 opencode-db list         # recent sessions
 opencode-db view         # interactive session viewer (colored, scrollable)
 opencode-db stats        # database summary
+opencode-db schema       # detect v1/v2 schema
 opencode-db costs --total  # total token costs
 opencode-db export       # export dialog to .md (interactive)
 opencode-db help         # full reference
@@ -46,6 +47,7 @@ opencode-db help         # full reference
 - **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
 - **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
 - **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`schema`** — определяет v1/v2-схему OpenCode, миграции и доступные операции
 - **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
 
 ## Optional extras
@@ -60,3 +62,5 @@ pip install opencode-db         # zero external dependencies
 - 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
+
+**Schema support:** OpenCode 1.19.x (v1) — read and write; OpenCode 2.x preview (v2) — read-only. Run `opencode-db schema` to check the detected schema. On v2, `delete`, `prune`, and `vacuum` are refused until write support is implemented.

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

@@ -8,10 +8,15 @@
 
 **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)
+
+> **Published on PyPI:** [opencode-db](https://pypi.org/project/opencode-db/) — install the ready-made package with `uv tool install opencode-db` or `pip install opencode-db`.
+
 ```
 opencode-db help        # full reference with examples
 opencode-db list        # list recent sessions
 opencode-db stats       # database summary
+opencode-db schema      # detect v1/v2 schema
 opencode-db export      # save a dialog to .md (interactive)
 opencode-db costs --total  # total token costs
 ```
@@ -81,7 +86,7 @@ pipx install opencode-db
 pip install opencode-db
 ```
 
-[Zero external dependencies](https://treyhunner.com/2015/12/python-imports-and-path-manipulation/) — pure Python standard library only (`rich` is optional).
+**Zero external dependencies** — runs on the Python standard library alone. Only Python 3.12+ is required; `rich` is optional for enhanced Markdown rendering.
 
 ### Manual install
 
@@ -110,8 +115,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
 ```
@@ -410,6 +415,26 @@ opencode-db stats --json                  # JSON output
 
 ---
 
+### `schema` — detect database schema
+
+Shows which OpenCode schema family the database uses, the applied migration, and which operations are supported.
+
+```bash
+opencode-db schema                        # human-readable summary
+opencode-db schema --json                 # JSON output
+```
+
+Supported families:
+
+| OpenCode | Schema | Support |
+|---|---|---|
+| 1.19.x | v1 | read + write |
+| 2.x preview | v2 | read-only |
+
+On a v2 database, `delete`, `prune`, and `vacuum` are refused until write support is implemented. Detection is based on tables and the migration journal, not on the OpenCode version string.
+
+---
+
 ### `todos` — view tasks from sessions
 
 Displays todo items created during OpenCode sessions.
@@ -507,56 +532,62 @@ 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
+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, 296 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
 │
-├── 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
-│
-├── 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)`.
-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`).
+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`, with `opencode-next.db` fallback) and detects the schema family.
+6. `store/` selects `V1Store` or `V2Store`; commands read through the same interface regardless of the underlying schema.
+7. Destructive operations (`delete`, `prune`) always require confirmation (or `--force`); on v2 they are refused until write support lands.
 
 ### Database schema (key tables)
 
+Stable OpenCode 1.19.x (v1):
+
 ```
 session        — sessions: id, title, model (JSON), agent, cost, tokens_*, parent_id, summary_*
 message        — messages: id, session_id, time_created, data (JSON: role, agent)
@@ -565,6 +596,19 @@ todo           — tasks: session_id, content, status, priority
 project        — projects: id, worktree, name
 ```
 
+Preview OpenCode 2.x (v2):
+
+```
+session_v2      — renamed session table with the same usage fields
+session_message — typed JSON messages: user, assistant, synthetic, system, shell, compaction, ...
+project         — projects: id, worktree, name, time_active, ...
+```
+
+v2 has no `message`, `part`, or `todo` tables. Assistant content is nested in
+`session_message.data.content`, and todos are derived from the latest completed
+`todowrite` tool call. Use `opencode-db schema` to inspect the detected family
+before running write commands.
+
 ---
 
 ## Using inside OpenCode TUI
@@ -586,7 +630,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 +658,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
 ```
 
 ---
@@ -645,7 +689,7 @@ opencode-db --lang en help        # English help text
 opencode-db --lang en stats       # English statistics
 ```
 
-The `--lang` flag applies to any command. All 280 UI strings are translated. Data content (session titles, project names, etc.) remains in its original language.
+The `--lang` flag applies to any command. All 296 UI strings are translated. Data content (session titles, project names, etc.) remains in its original language.
 
 The language can also be set via environment variable `OPENCODE_DB_LANG=en`.
 
@@ -728,16 +772,16 @@ 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
+make check          # check-python + ruff + 205 tests
 ```
 
 `make check` fails fast with a clear message if the active interpreter is older than 3.12.
 
 ### Adding a new command
 
-1. Create `cmd_xxx.py`:
+1. Create `opencode_db/commands/cmd_xxx.py`:
 
 ```python
 def register(subparsers):
@@ -749,7 +793,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 +811,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.8.0/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.
 
@@ -18,6 +18,7 @@ uv tool install opencode-db
 opencode-db list         # recent sessions
 opencode-db view         # interactive session viewer (colored, scrollable)
 opencode-db stats        # database summary
+opencode-db schema       # detect v1/v2 schema
 opencode-db costs --total  # total token costs
 opencode-db export       # export dialog to .md (interactive)
 opencode-db help         # full reference
@@ -30,6 +31,7 @@ opencode-db help         # full reference
 - **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
 - **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
 - **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`schema`** — определяет v1/v2-схему OpenCode, миграции и доступные операции
 - **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
 
 ## Optional extras
@@ -44,3 +46,5 @@ pip install opencode-db         # zero external dependencies
 - 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
+
+**Schema support:** OpenCode 1.19.x (v1) — read and write; OpenCode 2.x preview (v2) — read-only. Run `opencode-db schema` to check the detected schema. On v2, `delete`, `prune`, and `vacuum` are refused until write support is implemented.

opencode_db-0.8.0/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.8.0/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.8.0/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:
@@ -74,7 +74,7 @@ def main(argv=None) -> Any | Literal[0] | Literal[1]:
     if args.db_path:
         os.environ["OPENCODE_DB"] = args.db_path
 
-    db = get_db()
+    db = get_db(allow_unknown=args.command in {"schema", "help"})
 
     try:
         handler = commands.get_handler(args.command)

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

@@ -5,25 +5,28 @@
   - 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_schema,
+    cmd_search,
+    cmd_stats,
+    cmd_todos,
+    cmd_tree,
+    cmd_vacuum,
+    cmd_view,
+)
 
 # Словарь {имя_команды: модуль}
 # Модуль должен иметь register(subparsers) и run(args, db)
@@ -38,6 +41,7 @@ COMMANDS = {
     "tree": cmd_tree,
     "projects": cmd_projects,
     "stats": cmd_stats,
+    "schema": cmd_schema,
     "todos": cmd_todos,
     "vacuum": cmd_vacuum,
     "view": cmd_view,

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

@@ -5,9 +5,10 @@
 
 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
+from ..i18n import _
+from ..store import open_store
+from ..utils import build_help_epilog, format_cost, format_tokens
 
 _COSTS_EXAMPLES = [
     ("", "help.costs.e0"),
@@ -33,23 +34,24 @@ def register(subparsers) -> None:
 
 
 def run(args, db) -> int:
+    store = open_store(db)
     if args.session_id:
-        return _show_session(db, args.session_id, args.json)
+        return _show_session(store, args.session_id, args.json)
 
     if args.total:
-        return _show_total(db, args.project, args.json)
+        return _show_total(store, args.project, args.json)
 
-    return _show_list(db, args.project, args.limit, args.json)
+    return _show_list(store, args.project, args.limit, args.json)
 
 
-def _show_session(db, session_id, as_json) -> int:
+def _show_session(store, session_id, as_json) -> int:
     try:
-        info = get_session_info(db, session_id)
+        info = store.get_session_info(session_id)
     except SessionError as e:
         print(e.message)
         return 1
-    title = get_session_title(info)
-    model = parse_model(info)
+    title = store.get_session_title(info)
+    model = store.parse_model(info)
 
     ti = info["tokens_input"] or 0
     to = info["tokens_output"] or 0
@@ -57,7 +59,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(
             {
@@ -90,23 +92,8 @@ def _show_session(db, session_id, as_json) -> int:
     return 0
 
 
-def _show_total(db, project_id, as_json) -> int:
-    where = "1=1"
-    params = []
-
-    if project_id:
-        where = "s.project_id = ?"
-        params.append(project_id)
-
-    row = db.execute(
-        f"""
-        SELECT COUNT(*) as cnt,
-               SUM(tokens_input) as ti, SUM(tokens_output) as tok_out,
-               SUM(tokens_reasoning) as tr, SUM(cost) as c
-        FROM session WHERE {where}
-    """,
-        params,
-    ).fetchone()
+def _show_total(store, project_id, as_json) -> int:
+    row = store.get_cost_total(project_id)
 
     cnt = row["cnt"] or 0
     total_cost = row["c"] or 0
@@ -115,7 +102,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(
             {
@@ -143,37 +130,19 @@ def _show_total(db, project_id, as_json) -> int:
     return 0
 
 
-def _show_list(db, project_id, limit, as_json) -> int:
-    where = "1=1"
-    params = []
-
-    if project_id:
-        where = "s.project_id = ?"
-        params.append(project_id)
-
-    rows = db.execute(
-        f"""
-        SELECT s.id, s.title, s.model,
-               s.tokens_input, s.tokens_output, s.tokens_reasoning,
-               s.cost
-        FROM session s
-        WHERE {where}
-        ORDER BY (s.tokens_input + s.tokens_output) DESC
-        LIMIT ?
-    """,
-        (*params, limit),
-    ).fetchall()
+def _show_list(store, project_id, limit, as_json) -> int:
+    rows = store.get_cost_list(project_id, limit)
 
     if as_json:
-        from formatters import print_json
+        from ..formatters import print_json
 
         data = []
         for r in rows:
             data.append(
                 {
                     "id": r["id"],
-                    "title": get_session_title(r),
-                    "model": parse_model(r),
+                    "title": store.get_session_title(r),
+                    "model": store.parse_model(r),
                     "tokens_total": (r["tokens_input"] or 0)
                     + (r["tokens_output"] or 0)
                     + (r["tokens_reasoning"] or 0),
@@ -183,7 +152,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:
@@ -193,8 +162,8 @@ def _show_list(db, project_id, limit, as_json) -> int:
         table.append(
             [
                 r["id"][:24],
-                get_session_title(r)[:28],
-                parse_model(r)[:20],
+                store.get_session_title(r)[:28],
+                store.parse_model(r)[:20],
                 format_tokens(total_tokens),
                 format_cost(r["cost"] or 0),
             ]

{opencode_db-0.7.2 → opencode_db-0.8.0/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,9 @@ 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 ..store import open_store
+from ..utils import build_help_epilog, confirm, format_cost, format_ts, parse_date, parse_time_spec
 
 _DELETE_EXAMPLES = [
     ("<session_id>", "help.delete.e0"),
@@ -322,6 +323,10 @@ def _a(args, name: str, default=None):
 
 
 def run(args, db) -> int:
+    store = open_store(db)
+    if store.schema.read_only:
+        print(_("schema.unsupported_write"))
+        return 1
     if _a(args, "interactive", False):
         return _delete_interactive(db, args)