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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-db
-Version: 0.7.3
+Version: 0.8.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
@@ -32,8 +32,10 @@ uv tool install opencode-db
 
 ```bash
 opencode-db list         # recent sessions
+opencode-db directories  # launch directories, including missing ones
 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
@@ -43,9 +45,11 @@ opencode-db help         # full reference
 
 - **`view`** — просмотр сессии в терминале с ANSI-цветами, Markdown-рендерингом и прокруткой через `less`
 - **`list`** / **`info`** / **`search`** / **`tree`** — навигация и поиск по сессиям
+- **`directories`** (`dirs`) — все директории запусков, включая отсутствующие; `list --directory` добавляет путь к сессии
 - **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
 - **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
 - **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`schema`** — определяет v1/v2-схему OpenCode, миграции и доступные операции
 - **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
 
 ## Optional extras
@@ -60,3 +64,7 @@ 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
+
+**Directory support:** `global` is a synthetic project for non-Git directories; `directories` shows the real `session.directory` and marks it as `Global (no project root)`. Missing paths are detected with `os.path.isdir()` at command runtime and can be filtered with `--missing`.
+
+**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.3 → opencode_db-0.8.2}/README.md

@@ -10,10 +10,13 @@
 
 [Русская версия](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
 ```
@@ -83,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
 
@@ -169,6 +172,7 @@ opencode-db list --project proj_xxx      # filter by project
 opencode-db list --agent build           # filter by agent type
 opencode-db list --model deepseek        # filter by model name
 opencode-db list --json                  # JSON output
+opencode-db list --all --directory       # include directory paths
 ```
 
 | Flag | Description | Default |
@@ -181,6 +185,37 @@ opencode-db list --json                  # JSON output
 | `--sort {date,cost,tokens,messages}` | Sort order | date |
 | `--json` | Output as JSON | — |
 | `--all` | Show all (overrides --limit) | — |
+| `--directory` | Add a session directory column | — |
+
+---
+
+### `directories` — launch directories
+
+Lists every directory where OpenCode has run, including paths that no longer exist. Combines session directories with project roots and project-directory mappings.
+
+```bash
+opencode-db directories                  # grouped by path
+opencode-db directories --missing        # only missing/inaccessible paths
+opencode-db directories --existing       # only existing paths
+opencode-db directories --project global # Global sessions by real directory
+opencode-db directories --json           # full paths, counts, tokens, cost
+```
+
+`global` is a synthetic project for non-Git directories. The command never shows
+`/` as a real directory; it shows the actual `session.directory` and marks the
+project as `Global (no project root)`.
+
+| Flag | Description | Default |
+|---|---|---|
+| `--missing` | Only paths not found on disk | — |
+| `--existing` | Only paths that exist | — |
+| `--project ID` | Filter by project | — |
+| `--sort {date,sessions,cost,path}` | Sort order | date |
+| `--limit N` | Max entries | 50 |
+| `--no-check` | Skip filesystem check (`exists: null`) | — |
+| `--json` | Output as JSON | — |
+
+> `os.path.isdir()` is a point-in-time check. An offline volume or permission error can look like a missing directory.
 
 ---
 
@@ -387,13 +422,17 @@ Example output:
 Shows all projects in the database with session counts, tokens, and costs.
 
 ```bash
-opencode-db projects                      # project table
+opencode-db projects                      # project table with paths
 opencode-db projects --json               # JSON output
+opencode-db projects --missing            # projects whose path is gone
+opencode-db projects --no-global          # hide the synthetic Global project
 ```
 
 | Flag | Description |
 |---|---|
 | `--json` | JSON output |
+| `--missing` | Only projects with a missing path |
+| `--no-global` | Hide the synthetic Global project |
 
 ---
 
@@ -412,6 +451,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.
@@ -517,7 +576,7 @@ opencode-db/
 │   ├── config.py                         ← constants and paths
 │   ├── db.py                             ← SQLite queries
 │   ├── formatters.py                     ← tables, JSON, Markdown, snapshots
-│   ├── i18n.py                           ← localization (EN/RU, 280 keys)
+│   ├── i18n.py                           ← localization (EN/RU, 324 keys)
 │   ├── markdown_to_ansi.py               ← Markdown → ANSI renderer for `view`
 │   ├── runtime.py                        ← Python 3.12+ version guard
 │   ├── utils.py                          ← date/token formatting, validation
@@ -557,11 +616,14 @@ opencode-db/
 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 `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`).
+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)
@@ -570,6 +632,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
@@ -650,7 +725,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 324 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`.
 
@@ -735,7 +810,7 @@ source .venv/bin/activate
 uv pip install -e ".[rich]"
 uv pip install pytest ruff==0.17.1
 
-make check          # check-python + ruff + 191 tests
+make check          # check-python + ruff + 214 tests
 ```
 
 `make check` fails fast with a clear message if the active interpreter is older than 3.12.

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

@@ -16,8 +16,10 @@ uv tool install opencode-db
 
 ```bash
 opencode-db list         # recent sessions
+opencode-db directories  # launch directories, including missing ones
 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
@@ -27,9 +29,11 @@ opencode-db help         # full reference
 
 - **`view`** — просмотр сессии в терминале с ANSI-цветами, Markdown-рендерингом и прокруткой через `less`
 - **`list`** / **`info`** / **`search`** / **`tree`** — навигация и поиск по сессиям
+- **`directories`** (`dirs`) — все директории запусков, включая отсутствующие; `list --directory` добавляет путь к сессии
 - **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
 - **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
 - **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`schema`** — определяет v1/v2-схему OpenCode, миграции и доступные операции
 - **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
 
 ## Optional extras
@@ -44,3 +48,7 @@ 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
+
+**Directory support:** `global` is a synthetic project for non-Git directories; `directories` shows the real `session.directory` and marks it as `Global (no project root)`. Missing paths are detected with `os.path.isdir()` at command runtime and can be filtered with `--missing`.
+
+**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.3 → opencode_db-0.8.2}/opencode_db/cli.py

@@ -43,7 +43,11 @@ def build_parser() -> argparse.ArgumentParser:
     )
 
     subparsers = parser.add_subparsers(dest="command", required=True)
-    for _name, mod in commands.get_all().items():
+    seen: set[str] = set()
+    for mod in commands.get_all().values():
+        if mod.__name__ in seen:
+            continue
+        seen.add(mod.__name__)
         mod.register(subparsers)
     return parser
 
@@ -74,7 +78,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.3 → opencode_db-0.8.2}/opencode_db/commands/__init__.py

@@ -13,12 +13,14 @@
 from . import (
     cmd_costs,
     cmd_delete,
+    cmd_directories,
     cmd_export,
     cmd_help,
     cmd_info,
     cmd_list,
     cmd_projects,
     cmd_prune,
+    cmd_schema,
     cmd_search,
     cmd_stats,
     cmd_todos,
@@ -34,12 +36,15 @@ COMMANDS = {
     "info": cmd_info,
     "export": cmd_export,
     "delete": cmd_delete,
+    "directories": cmd_directories,
+    "dirs": cmd_directories,
     "costs": cmd_costs,
     "prune": cmd_prune,
     "search": cmd_search,
     "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.3 → opencode_db-0.8.2}/opencode_db/commands/cmd_costs.py

@@ -5,8 +5,9 @@
 
 import argparse
 
-from ..db import SessionError, get_session_info, get_session_title, parse_model
+from ..db import SessionError
 from ..i18n import _
+from ..store import open_store
 from ..utils import build_help_epilog, format_cost, format_tokens
 
 _COSTS_EXAMPLES = [
@@ -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
@@ -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
@@ -143,26 +130,8 @@ 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
@@ -172,8 +141,8 @@ def _show_list(db, project_id, limit, as_json) -> int:
             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),
@@ -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.3 → opencode_db-0.8.2}/opencode_db/commands/cmd_delete.py

@@ -12,6 +12,7 @@ from ..db import (
     parse_model,
 )
 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 = [
@@ -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)
 

opencode_db-0.8.2/opencode_db/commands/cmd_directories.py

@@ -0,0 +1,135 @@
+"""Команда directories: все директории запусков OpenCode."""
+
+import argparse
+from typing import Literal
+
+from ..formatters import print_json, print_table_simple
+from ..i18n import _
+from ..store import open_store
+from ..utils import build_help_epilog, format_cost, format_ts, shorten_path
+
+_DIRECTORIES_EXAMPLES = [
+    ("", "help.directories.e0"),
+    ("--missing", "help.directories.e1"),
+    ("--json", "help.directories.e2"),
+    ("--no-check", "help.directories.e3"),
+]
+
+
+def register(subparsers) -> None:
+    p = subparsers.add_parser(
+        "directories",
+        aliases=["dirs"],
+        help=_("help.cmd.directories"),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=build_help_epilog("directories", _DIRECTORIES_EXAMPLES),
+    )
+    p.add_argument("--missing", action="store_true", help="Only missing directories")
+    p.add_argument("--existing", action="store_true", help="Only existing directories")
+    p.add_argument("--project", type=str, help="Filter by project ID")
+    p.add_argument(
+        "--sort",
+        choices=["date", "sessions", "cost", "path"],
+        default="date",
+        help="Sort order (default: date)",
+    )
+    p.add_argument("--limit", type=int, default=50, help="Max results (default 50)")
+    p.add_argument("--no-check", action="store_true", help="Skip filesystem check")
+    p.add_argument("--json", action="store_true", help="JSON output")
+
+
+def run(args, db) -> Literal[1] | Literal[0]:
+    if getattr(args, "missing", False) and getattr(args, "existing", False):
+        print(_("directories.conflict"))
+        return 1
+
+    entries = open_store(db).get_directories(check_exists=not getattr(args, "no_check", False))
+
+    if getattr(args, "project", None):
+        entries = [
+            entry
+            for entry in entries
+            if args.project == entry["project_id"] or args.project in entry["project_ids"]
+        ]
+    if getattr(args, "missing", False):
+        entries = [entry for entry in entries if entry["exists"] is False]
+    elif getattr(args, "existing", False):
+        entries = [entry for entry in entries if entry["exists"] is True]
+
+    sorters = {
+        "date": lambda entry: entry["last_ts"] or 0,
+        "sessions": lambda entry: entry["sessions"],
+        "cost": lambda entry: entry["cost"],
+        "path": lambda entry: entry["path"],
+    }
+    reverse = getattr(args, "sort", "date") != "path"
+    entries.sort(key=sorters[getattr(args, "sort", "date")], reverse=reverse)
+    if getattr(args, "limit", 50):
+        entries = entries[: getattr(args, "limit", 50)]
+
+    if getattr(args, "json", False):
+        data = [
+            {
+                "path": entry["path"],
+                "exists": entry["exists"],
+                "project_id": entry["project_id"],
+                "project_ids": entry["project_ids"],
+                "project": entry["project_label"],
+                "is_global": entry["is_global"],
+                "sessions": entry["sessions"],
+                "first_activity": format_ts(entry["first_ts"]) if entry["first_ts"] else None,
+                "last_activity": format_ts(entry["last_ts"]) if entry["last_ts"] else None,
+                "tokens_input": entry["tokens_input"],
+                "tokens_output": entry["tokens_output"],
+                "tokens_reasoning": entry["tokens_reasoning"],
+                "tokens_cache_read": entry["tokens_cache_read"],
+                "tokens_cache_write": entry["tokens_cache_write"],
+                "cost": entry["cost"],
+                "sources": entry["sources"],
+            }
+            for entry in entries
+        ]
+        print_json(data)
+        return 0
+
+    if not entries:
+        print(_("directories.none"))
+        return 0
+
+    status_icon = {True: "✓", False: "✗", None: "?"}
+    table = []
+    for entry in entries:
+        status = {
+            True: _("directories.exists"),
+            False: _("directories.missing"),
+            None: _("directories.unknown"),
+        }[entry["exists"]]
+        last = format_ts(entry["last_ts"], "%Y-%m-%d") if entry["last_ts"] else "—"
+        table.append(
+            [
+                shorten_path(entry["path"], 52),
+                f"{status_icon[entry['exists']]} {status}",
+                entry["project_label"][:22],
+                str(entry["sessions"]),
+                last,
+                format_cost(entry["cost"]),
+            ]
+        )
+
+    print(f"\n  {_('directories.title')}")
+    print_table_simple(
+        [
+            _("directories.header.path"),
+            _("directories.header.status"),
+            _("directories.header.project"),
+            _("directories.header.sessions"),
+            _("directories.header.last"),
+            _("directories.header.cost"),
+        ],
+        table,
+    )
+
+    missing = sum(1 for entry in entries if entry["exists"] is False)
+    sessions = sum(entry["sessions"] for entry in entries)
+    print(_("directories.summary", total=len(entries), sessions=sessions, missing=missing))
+    return 0