Imports:
  - Types:
      - run_server
    Usages:
      - running
    From: goga_tool_viewer/server
  - Usages:
      - serving
    From: goga_tool_viewer/frontend

Usages:
  conventions: .goga/usages/conventions.md
  cli_args: |
    argv — список аргументов без имени команды.
    argv[0] — путь к JSON-файлу (необязательный).
    Если argv пуст — JSON читается из stdin.
    Не использовать argparse — argv уже распарсен вызывающей стороной (goga tool).

Annotations: |
  Использовать `conventions` для правил написания кода и тестов.

  Tool для экосистемы goga — визуализация графа зависимостей cells.

  Используй `cli_args` для разбора аргументов argv.
  Используй `run_server` для запуска сервера. См. `running`.
  Используй `serving` для понимания SPA-части.

---

"main(argv: list[str]) -> void:null":
  location: cli.py
  annotations: |
    Фасадная функция tool для goga ecosystem.

    Вызывается goga tool как: goga tool viewer data.json → main(["data.json"])
    Или через pipe: cat data.json | goga tool viewer → main([])

    `argv`: аргументы командной строки без имени команды.
            argv[0] — путь к JSON-файлу или отсутствует.

    Используй `cli_args` для разбора argv.
    Используй `run_server` для запуска сервера. См. `running`.

---

Author: Goga
CreatedAt: 12/05/26
Description: |
  Tool goga-tool-viewer — визуализация графа зависимостей cells для экосистемы goga.
