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

{opencode_db-0.7.3/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.3
+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
@@ -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.3 → opencode_db-0.8.0}/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
 
@@ -412,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.
@@ -517,7 +540,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, 296 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 +580,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 +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
@@ -650,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`.
 
@@ -735,7 +774,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 + 205 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.0}/docs/README_PYPI.md

@@ -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.7.3 → opencode_db-0.8.0}/opencode_db/cli.py

@@ -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.3 → opencode_db-0.8.0}/opencode_db/commands/__init__.py

@@ -19,6 +19,7 @@ from . import (
     cmd_list,
     cmd_projects,
     cmd_prune,
+    cmd_schema,
     cmd_search,
     cmd_stats,
     cmd_todos,
@@ -40,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.3 → opencode_db-0.8.0}/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.0}/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.7.3 → opencode_db-0.8.0}/opencode_db/commands/cmd_export.py

@@ -9,17 +9,10 @@
 import argparse
 import os
 
-from ..db import (
-    SessionError,
-    get_latest_session,
-    get_messages,
-    get_recent_sessions,
-    get_session_info,
-    get_session_title,
-    parse_model,
-)
+from ..db import SessionError
 from ..formatters import collect_snapshot, format_part_to_md, update_log
 from ..i18n import _
+from ..store import open_store
 from ..utils import build_help_epilog, format_cost, format_ts, format_ts_short
 
 _EXPORT_EXAMPLES = [
@@ -62,29 +55,29 @@ def register(subparsers) -> None:
     )
 
 
-def _export_by_id(db, session_id, output_dir, force, note, full) -> int:
+def _export_by_id(store, session_id, output_dir, force, note, full) -> int:
     try:
-        session_info = get_session_info(db, session_id)
+        session_info = store.get_session_info(session_id)
     except SessionError as e:
         print(e.message)
         return 1
-    return _do_export(db, session_info, output_dir, force, note, full)
+    return _do_export(store, session_info, output_dir, force, note, full)
 
 
-def _export_latest(db, output_dir, force, note, full) -> int:
+def _export_latest(store, output_dir, force, note, full) -> int:
     try:
-        session_id = get_latest_session(db)
-        session_info = get_session_info(db, session_id)
+        session_id = store.get_latest_session()
+        session_info = store.get_session_info(session_id)
     except SessionError as e:
         print(e.message)
         return 1
-    title = get_session_title(session_info)
+    title = store.get_session_title(session_info)
     print(_("session.latest", title=title))
-    return _do_export(db, session_info, output_dir, force, note, full)
+    return _do_export(store, session_info, output_dir, force, note, full)
 
 
-def _export_interactive(db, output_dir, force, note, full) -> int:
-    sessions = get_recent_sessions(db)
+def _export_interactive(store, output_dir, force, note, full) -> int:
+    sessions = store.get_recent_sessions()
 
     if not sessions:
         print(_("export.no_sessions"))
@@ -95,7 +88,7 @@ def _export_interactive(db, output_dir, force, note, full) -> int:
     print(f"  {'─' * 60}")
 
     for i, s in enumerate(sessions, 1):
-        title = get_session_title(s)
+        title = store.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}")
@@ -123,22 +116,22 @@ def _export_interactive(db, output_dir, force, note, full) -> int:
         print(f"  {_('export.interactive_error', n=len(sessions))}")
 
     session_id = sessions[idx]["id"]
-    title = get_session_title(sessions[idx])
+    title = store.get_session_title(sessions[idx])
     print(_("export.interactive_exporting", title=title))
     try:
-        session_info = get_session_info(db, session_id)
+        session_info = store.get_session_info(session_id)
     except SessionError as e:
         print(e.message)
         return 1
-    return _do_export(db, session_info, output_dir, force, note, full)
+    return _do_export(store, session_info, output_dir, force, note, full)
 
 
-def _do_export(db, session_info, output_dir, force, note, full=False) -> int:
+def _do_export(store, session_info, output_dir, force, note, full=False) -> int:
     """Внутренняя функция: экспорт диалога."""
-    title = get_session_title(session_info)
-    model = parse_model(session_info)
+    title = store.get_session_title(session_info)
+    model = store.parse_model(session_info)
 
-    messages = get_messages(db, session_info["id"])
+    messages = store.get_messages(session_info["id"])
 
     date_str = format_ts_short(session_info["time_created"])
     filename = os.path.join(output_dir, f"opencode-{date_str}.md")
@@ -207,10 +200,11 @@ def run(args, db) -> int:
     output_dir = args.output or os.getcwd()
     full = args.full
 
+    store = open_store(db)
     if args.session_id:
-        return _export_by_id(db, args.session_id, output_dir, args.force, args.note, full)
+        return _export_by_id(store, args.session_id, output_dir, args.force, args.note, full)
 
     if args.latest:
-        return _export_latest(db, output_dir, args.force, args.note, full)
+        return _export_latest(store, output_dir, args.force, args.note, full)
 
-    return _export_interactive(db, output_dir, args.force, args.note, full)
+    return _export_interactive(store, output_dir, args.force, args.note, full)

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

@@ -119,6 +119,14 @@ _COMMANDS = [
             ("--json", "help.projects.e1"),
         ],
     ),
+    (
+        "schema",
+        "help.cmd.schema",
+        [
+            ("", "help.schema.e0"),
+            ("--json", "help.schema.e1"),
+        ],
+    ),
     (
         "stats",
         "help.cmd.stats",

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

@@ -2,19 +2,9 @@
 
 import argparse
 
-from ..db import (
-    SessionError,
-    get_children_sessions,
-    get_message_count,
-    get_parent_session,
-    get_part_count,
-    get_project_name,
-    get_session_info,
-    get_session_title,
-    get_session_todos,
-    parse_model,
-)
+from ..db import SessionError
 from ..i18n import _
+from ..store import open_store
 from ..utils import build_help_epilog, format_cost, format_tokens, format_ts
 
 _INFO_EXAMPLES = [
@@ -35,21 +25,22 @@ def register(subparsers) -> None:
 
 
 def run(args, db) -> int:
+    store = open_store(db)
     try:
-        info = get_session_info(db, args.session_id)
+        info = store.get_session_info(args.session_id)
     except SessionError as e:
         print(e.message)
         return 1
     session_id = info["id"]
-    msg_count = get_message_count(db, session_id)
-    part_count = get_part_count(db, session_id)
-    children = get_children_sessions(db, session_id)
-    parent = get_parent_session(db, session_id)
-    todos = get_session_todos(db, session_id)
-    project_name = get_project_name(db, info["project_id"]) if info["project_id"] else "—"
-
-    model = parse_model(info)
-    title = get_session_title(info)
+    msg_count = store.get_message_count(session_id)
+    part_count = store.get_part_count(session_id)
+    children = store.get_children_sessions(session_id)
+    parent = store.get_parent_session(session_id)
+    todos = store.get_session_todos(session_id)
+    project_name = store.get_project_name(info["project_id"]) if info["project_id"] else "—"
+
+    model = store.parse_model(info)
+    title = store.get_session_title(info)
     created = format_ts(info["time_created"])
     updated = format_ts(info["time_updated"])
 

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

@@ -3,10 +3,10 @@
 import argparse
 from typing import Literal
 
-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 ..store import open_store
 from ..utils import build_help_epilog, format_ts
 
 _LIST_EXAMPLES = [
@@ -41,48 +41,16 @@ def register(subparsers) -> None:
 
 
 def run(args, db) -> Literal[0]:
-    conditions = []
-    params = []
-
-    if args.project:
-        conditions.append("s.project_id = ?")
-        params.append(args.project)
-
-    if args.agent:
-        conditions.append("s.agent = ?")
-        params.append(args.agent)
-
-    if args.model:
-        conditions.append("s.model LIKE ?")
-        params.append(f"%{args.model}%")
-
-    where = " AND ".join(conditions) if conditions else "1=1"
-
-    sort_map = {
-        "date": "COALESCE(MAX(m.time_created), s.time_created) DESC",
-        "cost": "s.cost DESC",
-        "tokens": "(s.tokens_input + s.tokens_output) DESC",
-        "messages": "msg_count DESC",
-    }
-    order = sort_map.get(args.sort, "COALESCE(MAX(m.time_created), s.time_created) DESC")
-
+    store = open_store(db)
     limit = 999999 if args.all else args.limit
-
-    rows = db.execute(
-        f"""
-        SELECT s.id, s.title, s.model, s.project_id, s.agent,
-               s.cost, s.tokens_input, s.tokens_output,
-               MAX(m.time_created) as last_time,
-               COUNT(DISTINCT m.id) as msg_count
-        FROM session s
-        LEFT JOIN message m ON m.session_id = s.id
-        WHERE {where}
-        GROUP BY s.id
-        ORDER BY {order}
-        LIMIT ? OFFSET ?
-    """,
-        (*params, limit, args.offset),
-    ).fetchall()
+    rows = store.list_sessions(
+        project_id=args.project,
+        agent=args.agent,
+        model=args.model,
+        sort=args.sort,
+        limit=limit,
+        offset=args.offset,
+    )
 
     if args.json:
         data = []
@@ -106,7 +74,7 @@ def run(args, db) -> Literal[0]:
 
     table_rows = []
     for r in rows:
-        project_name = db_module.get_project_name(db, r["project_id"]) if r["project_id"] else "—"
+        project_name = store.get_project_name(r["project_id"]) if r["project_id"] else "—"
         model_name = parse_model(r)
         last_act = format_ts(r["last_time"], "%Y-%m-%d %H:%M") if r["last_time"] else "—"
 

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

@@ -4,6 +4,7 @@ import argparse
 from typing import Literal
 
 from ..i18n import _
+from ..store import open_store
 from ..utils import build_help_epilog, format_cost, format_tokens, format_ts
 
 _PROJECTS_EXAMPLES = [
@@ -23,18 +24,7 @@ def register(subparsers) -> None:
 
 
 def run(args, db) -> Literal[0]:
-    rows = db.execute("""
-        SELECT p.id, p.name, p.worktree, p.time_created, p.time_updated,
-               COUNT(DISTINCT s.id) as session_count,
-               COALESCE(SUM(s.cost), 0) as total_cost,
-               COALESCE(SUM(s.tokens_input), 0) as total_ti,
-               COALESCE(SUM(s.tokens_output), 0) as total_to,
-               COALESCE(SUM(s.tokens_reasoning), 0) as total_tr
-        FROM project p
-        LEFT JOIN session s ON s.project_id = p.id
-        GROUP BY p.id
-        ORDER BY p.time_updated DESC
-    """).fetchall()
+    rows = open_store(db).get_projects()
 
     if args.json:
         from ..formatters import print_json

opencode_db-0.8.0/opencode_db/commands/cmd_schema.py

@@ -0,0 +1,56 @@
+"""Команда schema: семейство схемы, миграции и возможности."""
+
+import argparse
+from typing import Literal
+
+from ..config import resolve_db_path
+from ..formatters import print_json
+from ..i18n import _
+from ..schema import describe_schema, detect_schema
+from ..utils import build_help_epilog
+
+_SCHEMA_EXAMPLES = [
+    ("", "help.schema.e0"),
+    ("--json", "help.schema.e1"),
+]
+
+
+def register(subparsers) -> None:
+    p = subparsers.add_parser(
+        "schema",
+        help=_("help.cmd.schema"),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=build_help_epilog("schema", _SCHEMA_EXAMPLES),
+    )
+    p.add_argument("--json", action="store_true", help="JSON output")
+
+
+def run(args, db) -> Literal[0]:
+    info = detect_schema(db)
+    data = describe_schema(info)
+    data["db_path"] = resolve_db_path()[0]
+
+    if args.json:
+        print_json(data)
+        return 0
+
+    print()
+    print(f"  {_('schema.title')}")
+    print(f"  {'─' * 50}")
+    print(f"  {_('schema.db_path'):16s}: {data['db_path']}")
+    print(f"  {_('schema.family'):16s}: {info.label}")
+    print(f"  {_('schema.tables'):16s}: {data['table_count']}")
+    print(f"  {_('schema.migrations'):16s}: {data['migration_count']}")
+    print(f"  {_('schema.max_migration'):16s}: {info.max_migration or '—'}")
+    capabilities = ", ".join(data["capabilities"]) or "—"
+    print(f"  {_('schema.capabilities'):16s}: {capabilities}")
+
+    manifest = data["manifest"]
+    if manifest.get("ref"):
+        commit = (manifest.get("commit") or "")[:10]
+        print(f"  {_('schema.manifest'):16s}: {manifest['ref']} @ {commit}")
+
+    for warning in data["warnings"]:
+        print(_("schema.warning", message=warning))
+    print()
+    return 0