homeconsole-cli 0.0.1__tar.gz

homeconsole_cli-0.0.1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: homeconsole-cli
+Version: 0.0.1
+Summary: HomeConsole CLI (hc) — управление платформой через HTTP API
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Requires-Dist: httpx>=0.27
+Requires-Dist: anyio>=4
+Requires-Dist: prompt_toolkit>=3
+Requires-Dist: tomlkit>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+
+# HomeConsole CLI (`hc`)
+
+CLI-утилита для управления платформой HomeConsole **исключительно через HTTP API** CoreRuntime.
+
+## Установка (локально)
+
+```bash
+cd home-console-cli
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e .
+```
+
+Проверка:
+
+```bash
+hc --help
+```
+
+## Конфигурация
+
+Файл: `~/.config/hc/config.toml`
+
+```toml
+[core]
+host = "localhost"
+port = 8080
+token = "jwt-token-here"
+verify_ssl = true
+
+[display]
+color = true
+emoji = true
+```
+
+Токен берётся по приоритету:
+
+- `--token` (если у команды есть такой флаг)
+- переменная окружения `HC_TOKEN`
+- `config.toml`
+
+## Быстрый старт
+
+Подключиться и сохранить конфиг:
+
+```bash
+hc connect localhost --port 8080
+```
+
+Статус:
+
+```bash
+hc status
+```
+
+Список плагинов:
+
+```bash
+hc plugin list
+```
+
+## Команды
+
+- `hc connect <host> [--port 8080] [--token TOKEN]`
+- `hc status`
+- `hc install <name> [--version X.Y.Z]`
+- `hc remove <name> [--force]`
+- `hc plugin list|start|stop|info`
+- `hc module list|status`
+- `hc logs [--follow] [--module <name>] [--level debug|info|warning|error]`
+- `hc search <query>`
+- `hc setup`
+- `hc deploy` (по умолчанию: build+push+rollout+wait) и `hc deploy ...` (тонкие подкоманды)
+- `hc deploy platform` (локальный dev flow)
+- `hc deploy platform --mode image --image ghcr.io/home-console/platform-home-console --tag latest` (image-only deploy)
+- `hc update core ...` (обновление core-runtime до нового image:tag)
+- `hc shell`
+
+### Deploy “одной командой”
+
+По умолчанию `hc deploy` делает полный жизненный цикл:
+
+- **build**: `docker build -t <image>:<tag>`
+- **push**: `docker push <image>:<tag>`
+- **rollout**: `docker compose pull core-runtime && docker compose up -d`
+- **wait**: ждёт **healthy** (проверка `curl` внутри контейнера)
+
+Полезные флаги:
+
+- `--no-build`, `--no-push`, `--no-rollout`
+- `--wait/--no-wait` (по умолчанию `--wait`)
+- `--timeout 180` (сек), `--interval 1.0` (сек)
+- `--health-url http://localhost:8000/api/v1/monitor/health` (внутри контейнера)
+- `--quiet` (минимальный вывод)
+- `--json` (машинный вывод; удобно для CI/скриптов)
+
+Логи core-runtime (для диагностики таймаута):
+
+- `hc deploy core logs -f`
+
+### Deploy платформы
+
+Локальный dev flow:
+
+```bash
+hc deploy platform
+```
+
+Только подготовить статику, без запуска стека:
+
+```bash
+hc deploy platform --no-start
+```
+
+Image-only deploy через GHCR:
+
+```bash
+hc deploy platform --mode image --image ghcr.io/home-console/platform-home-console --tag latest
+```
+
+Этот вариант использует `platform-home-console/docker-compose.image.yml` и `PLATFORM_IMAGE`.
+
+## Если “нет команды `hc deploy`”
+
+Почти всегда это означает, что в окружении стоит **не тот пакет**, который предоставляет команду `hc`.
+
+Проверка (в активированном venv):
+
+```bash
+python -c "import hc, inspect; print(hc.__file__)"
+```
+
+Должно указывать на `.../home-console-cli/hc/__init__.py` (или site-packages `homeconsole-cli`).
+
+## Ошибки и UX
+
+- Traceback пользователю не показывается.
+- Все ошибки печатаются через Rich: `[red]Ошибка: ...[/red]`.
+- При ошибке утилита завершает выполнение с кодом `1`.

homeconsole_cli-0.0.1/README.md

@@ -0,0 +1,140 @@
+# HomeConsole CLI (`hc`)
+
+CLI-утилита для управления платформой HomeConsole **исключительно через HTTP API** CoreRuntime.
+
+## Установка (локально)
+
+```bash
+cd home-console-cli
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e .
+```
+
+Проверка:
+
+```bash
+hc --help
+```
+
+## Конфигурация
+
+Файл: `~/.config/hc/config.toml`
+
+```toml
+[core]
+host = "localhost"
+port = 8080
+token = "jwt-token-here"
+verify_ssl = true
+
+[display]
+color = true
+emoji = true
+```
+
+Токен берётся по приоритету:
+
+- `--token` (если у команды есть такой флаг)
+- переменная окружения `HC_TOKEN`
+- `config.toml`
+
+## Быстрый старт
+
+Подключиться и сохранить конфиг:
+
+```bash
+hc connect localhost --port 8080
+```
+
+Статус:
+
+```bash
+hc status
+```
+
+Список плагинов:
+
+```bash
+hc plugin list
+```
+
+## Команды
+
+- `hc connect <host> [--port 8080] [--token TOKEN]`
+- `hc status`
+- `hc install <name> [--version X.Y.Z]`
+- `hc remove <name> [--force]`
+- `hc plugin list|start|stop|info`
+- `hc module list|status`
+- `hc logs [--follow] [--module <name>] [--level debug|info|warning|error]`
+- `hc search <query>`
+- `hc setup`
+- `hc deploy` (по умолчанию: build+push+rollout+wait) и `hc deploy ...` (тонкие подкоманды)
+- `hc deploy platform` (локальный dev flow)
+- `hc deploy platform --mode image --image ghcr.io/home-console/platform-home-console --tag latest` (image-only deploy)
+- `hc update core ...` (обновление core-runtime до нового image:tag)
+- `hc shell`
+
+### Deploy “одной командой”
+
+По умолчанию `hc deploy` делает полный жизненный цикл:
+
+- **build**: `docker build -t <image>:<tag>`
+- **push**: `docker push <image>:<tag>`
+- **rollout**: `docker compose pull core-runtime && docker compose up -d`
+- **wait**: ждёт **healthy** (проверка `curl` внутри контейнера)
+
+Полезные флаги:
+
+- `--no-build`, `--no-push`, `--no-rollout`
+- `--wait/--no-wait` (по умолчанию `--wait`)
+- `--timeout 180` (сек), `--interval 1.0` (сек)
+- `--health-url http://localhost:8000/api/v1/monitor/health` (внутри контейнера)
+- `--quiet` (минимальный вывод)
+- `--json` (машинный вывод; удобно для CI/скриптов)
+
+Логи core-runtime (для диагностики таймаута):
+
+- `hc deploy core logs -f`
+
+### Deploy платформы
+
+Локальный dev flow:
+
+```bash
+hc deploy platform
+```
+
+Только подготовить статику, без запуска стека:
+
+```bash
+hc deploy platform --no-start
+```
+
+Image-only deploy через GHCR:
+
+```bash
+hc deploy platform --mode image --image ghcr.io/home-console/platform-home-console --tag latest
+```
+
+Этот вариант использует `platform-home-console/docker-compose.image.yml` и `PLATFORM_IMAGE`.
+
+## Если “нет команды `hc deploy`”
+
+Почти всегда это означает, что в окружении стоит **не тот пакет**, который предоставляет команду `hc`.
+
+Проверка (в активированном venv):
+
+```bash
+python -c "import hc, inspect; print(hc.__file__)"
+```
+
+Должно указывать на `.../home-console-cli/hc/__init__.py` (или site-packages `homeconsole-cli`).
+
+## Ошибки и UX
+
+- Traceback пользователю не показывается.
+- Все ошибки печатаются через Rich: `[red]Ошибка: ...[/red]`.
+- При ошибке утилита завершает выполнение с кодом `1`.

homeconsole_cli-0.0.1/hc/__init__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+__version__ = "0.0.1"
+

homeconsole_cli-0.0.1/hc/api.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+# Здесь живут все “контрактные” пути, чтобы не размазывать строки по коду.
+# Если Core переедет на /api/v1 — клиент должен пережить это без правок команд.
+
+API_PREFIX_CANDIDATES: tuple[str, ...] = ("/api", "/api/v1")
+
+# Core
+HEALTH = "/health"
+# Current health endpoint in core-runtime-service (mounted under /api/v1/monitor).
+MONITOR_HEALTH = "/api/v1/monitor/health"
+# Legacy/compat (older builds).
+MONITOR_HEALTH_LEGACY = "/monitor/health"
+
+# Admin (core API contract)
+ADMIN_STATUS = "/api/v1/admin/inspector/runtime"
+ADMIN_INSPECTOR_PLUGINS = "/api/v1/admin/inspector/plugins"
+ADMIN_AUTH_API_KEYS = "/api/v1/admin/auth/api-keys"
+ADMIN_AUTH_API_KEYS_REVOKE = "/api/v1/admin/auth/api-keys/revoke"
+ADMIN_AUTH_API_KEYS_ROTATE = "/api/v1/admin/auth/api-keys/rotate"
+ADMIN_AUTH_USERS = "/api/v1/admin/auth/users"
+ADMIN_AUTH_SESSIONS = "/api/v1/admin/auth/sessions"
+ADMIN_AUTH_SESSIONS_REVOKE = "/api/v1/admin/auth/sessions/revoke"
+ADMIN_AUTH_SESSIONS_REVOKE_ALL = "/api/v1/admin/auth/sessions/revoke-all"
+
+# Marketplace admin — archive_path должен быть доступен процессу Core на сервере
+ADMIN_MARKETPLACE_INSTALL = "/api/v1/admin/marketplace/install"
+ADMIN_MARKETPLACE_INSTALL_UPLOAD = "/api/v1/admin/marketplace/install-upload"
+
+# Auth v1
+AUTH_BOOTSTRAP = "/api/v1/auth/bootstrap"
+AUTH_INITIALIZE = "/api/v1/auth/initialize"
+AUTH_LOGIN = "/api/v1/auth/login"
+AUTH_LOGOUT = "/api/v1/auth/logout"
+AUTH_REFRESH = "/api/v1/auth/refresh"
+AUTH_ME = "/api/v1/auth/me"
+
+# Plugins (пути относительно префикса из API_PREFIX_CANDIDATES: /api или /api/v1)
+PLUGINS = "/plugins"
+PLUGIN = "/plugins/{name}"
+PLUGIN_INSTALL = "/plugins/{name}/install"
+PLUGIN_START = "/plugins/{name}/start"
+PLUGIN_STOP = "/plugins/{name}/stop"
+PLUGIN_RELOAD = "/api/v1/admin/plugins/{name}/reload"
+PLUGIN_RESTART_CONTAINER = "/api/v1/admin/plugins/{name}/restart-container"
+
+# Modules (так же относительно префикса)
+MODULES = "/modules"
+MODULE_START = "/modules/{name}/start"
+MODULE_STOP = "/modules/{name}/stop"
+MODULE_RESTART = "/modules/{name}/restart"
+
+# Logs
+LOGS = "/logs"
+
+# Marketplace
+MARKETPLACE_INDEX = "/marketplace/index"
+MARKETPLACE_SEARCH = "/marketplace/search"
+

homeconsole_cli-0.0.1/hc/capabilities.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+import anyio
+
+from hc.config import Config
+from hc.commands._client_helpers import client_from_config
+
+
+@dataclass(slots=True)
+class Capabilities:
+    monitor_health: bool
+    auth_bootstrap: bool
+    auth_me: bool
+    admin_status: bool
+    inspector_plugins: bool
+    api_keys: bool
+
+
+def probe(cfg: Config) -> Capabilities:
+    silent = client_from_config(cfg, silent=True)
+
+    async def _run() -> Capabilities:
+        mh = await silent.health()
+        ab = await silent.auth_bootstrap()
+        am = await silent.auth_me()
+        st = await silent.admin_status()
+        ip = await silent.inspector_plugins()
+        ak = await silent.api_keys_list()
+        return Capabilities(
+            monitor_health=bool(mh),
+            auth_bootstrap=bool(ab),
+            auth_me=bool(am),
+            admin_status=bool(st),
+            inspector_plugins=bool(ip),
+            api_keys=bool(ak),
+        )
+
+    return anyio.run(_run)
+