mlspace-plugin 0.2.2__tar.gz → 0.3.1__tar.gz

mlspace_plugin-0.3.1/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "mlspace",
+  "interface": {
+    "displayName": "MLSpace"
+  },
+  "plugins": [
+    {
+      "name": "mlspace",
+      "source": {
+        "source": "local",
+        "path": "./plugin"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

mlspace_plugin-0.3.1/.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "mlspace",
+  "owner": {
+    "name": "Cloud.ru"
+  },
+  "plugins": [
+    {
+      "name": "mlspace",
+      "source": "./plugin"
+    }
+  ]
+}

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/INSTALL.md

@@ -1,6 +1,7 @@
 # Установка MLSpace MCP: macOS и Linux
 
-Нужны Python 3.10+, `uv`, установленный Claude Code, Codex или OpenCode,
+Нужны Python 3.10+, `uv` (команда `uvx`), Git для нативных плагинов,
+актуальный Claude Code, Codex или OpenCode,
 Cloud.ru Key ID и Key Secret. Windows пока не поддерживаем.
 
 Первая установка из PyPI выполняется одной командой:
@@ -20,7 +21,7 @@ mlspace-plugin setup
 ```
 
 Если пакет уже установлен: `uv tool install --force .`.
-При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.2.2-py3-none-any.whl`.
+При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.3.1-py3-none-any.whl`.
 Не используйте editable-установку из `/tmp` для постоянной работы.
 Далее команды показаны для PyPI. После установки исходников или wheel через
 `uv tool install` заменяйте `uvx mlspace-plugin@latest` на `mlspace-plugin`,
@@ -34,7 +35,15 @@ mlspace-plugin setup
    звёздочки показывают ввод. Ключи создаются в консоли Cloud.ru в профиле, «Ключи доступа».
 3. Загрузит воркспейсы. Печатайте имя, проект или ID для поиска. Стрелки перемещают
    курсор, пробел отмечает, Enter завершает выбор. Ctrl-U очищает поиск; выбор сохраняется.
-4. Проверит выбранные воркспейсы, сохранит настройки и подключит MCP вместе со скиллами.
+4. Проверит выбранные воркспейсы и сохранит настройки.
+5. Для Claude Code и Codex добавит marketplace этого GitHub-репозитория и установит
+   `mlspace@mlspace`. Для OpenCode запишет MCP-подключение и скиллы в
+   `~/.config/opencode/skills` (учитывается `XDG_CONFIG_HOME`).
+6. Сверит скиллы, запустит MCP и проверит инструменты и выбранные воркспейсы.
+
+Если настройка клиента не завершилась, проверенные ключи остаются сохранёнными.
+Мастер перечислит установленные клиенты; устраните причину и выполните напечатанную
+команду `Retry`. Она сохраняет выбор клиентов, включая незавершённые подключения.
 
 Откройте новую сессию выбранного клиента; если MCP не появился, перезапустите клиент.
 Сервер запускается клиентом автоматически. Первый запрос:
@@ -75,15 +84,39 @@ uvx mlspace-plugin@latest setup --force --client-path opencode=/полный/п
 `--force` повторяет настройку с сохранёнными ключами на прежнем endpoint.
 `--replace-credentials` запрашивает новые. При смене endpoint ключи запрашиваются
 заново, если источник явно не выбран. `--client` можно повторять.
-Существующие посторонние MCP, комментарии JSONC и изменённые пользователем скиллы
-не перезаписываются молча; конфликт показывает путь для разбора.
-Если уже установлен MLSpace native plugin, используйте его и `--config-only`
-либо сначала удалите старую интеграцию, чтобы не создавать второй MCP.
+Посторонние MCP, комментарии JSONC и дополнительные пользовательские скиллы сохраняются.
+Если в OpenCode уже есть другое подключение `mcp.mlspace` или отличающиеся скиллы
+с именами из пакета, мастер **до ввода ключей** покажет все эти конфликты вместе.
+Для подключения выберите `r`, чтобы сохранить резервную копию конфига и заменить
+только `mcp.mlspace`. Для каждого конфликтующего скилла доступны:
+
+- `k` — оставить свою версию активной и исключить её из обновлений плагина.
+  Этот выбор сохраняется для последующих запусков setup. Проверка сообщит,
+  что пользовательская версия не проверялась на совпадение с релизом.
+- `r` — сохранить весь каталог скилла, включая вспомогательные файлы, в резервной
+  копии и установить пакетный `SKILL.md`.
+- Enter — отменить настройку без замены конфликтующих файлов.
+
+Резервные копии находятся в `backups/setup-*` рядом с `install-state.json`
+в каталоге настроек MLSpace, **вне каталогов скиллов**; мастер печатает точный путь.
+Они создаются перед заменой после проверки credentials. Если резервное копирование
+не удалось, конфликтующие файлы не заменяются. Отличие от пакета само по себе
+не означает ручное редактирование: это может быть файл от старой установки.
+`--force` не разрешает замену конфликтов. В `--non-interactive` мастер перечисляет
+их и останавливается; для выбора запустите ту же команду в своём терминале без этого флага.
+
+Уже установленный `mlspace@mlspace` из этого репозитория переиспользуется.
+Если имя marketplace занято другим источником или есть отдельная прямая регистрация
+MLSpace в Claude/Codex, мастер остановится до ввода ключей. Разберите указанное
+подключение; мастер не удаляет его автоматически.
 
 ## Где ключи
 
 `~/.config/mlspace-plugin/.env` (или каталог из `XDG_CONFIG_HOME`): права файла `0600`,
 каталога MLSpace `0700`. В конфиге клиента — только путь и команда запуска.
+Несекретный указатель `~/.config/mlspace-plugin/credentials-path.json` хранит путь
+к выбранному файлу. Поэтому `--path` и нестандартный `XDG_CONFIG_HOME` не требуют
+wrapper или экспорта переменных перед каждым запуском клиента.
 Это не шифрование: процессы того же пользователя и администратор могут прочитать
 файл. Не отправляйте его в чат и не добавляйте в Git. x-api-key получается автоматически
 и не сохраняется. Доступ к каждому выбранному workspace проверяется, но это не
@@ -102,15 +135,27 @@ uvx mlspace-plugin@latest setup --force --client-path opencode=/полный/п
 
 ## Обновление пакета и скиллов
 
-Для установки через PyPI повторите `uvx mlspace-plugin@latest setup --force`.
-Мастер сохранит ключи, предложит выбор workspace и обновит скиллы без локальных
-изменений. MCP обновляется во всех клиентах, ранее подключённых мастером,
-чтобы версия сервера совпадала с общими скиллами. `--client` выбирает новые
-подключения, а существующие управляемые подключения обновляются вместе.
-Изменённые вручную регистрации и скиллы вызовут конфликт с указанием файла.
-Регистрация MCP, созданная мастером и не изменённая вручную, обновляется
-автоматически. Посторонние и изменённые регистрации требуют разбора конфликта.
-Для постоянной установки: `uv tool upgrade mlspace-plugin`, затем
-`mlspace-plugin setup --force`. Для установки из checkout: `uv tool install --force .`.
-Автоматического обновления в фоне нет. Native plugin из архива обновляйте
-через менеджер плагинов клиента; инструкции находятся в `plugin/README.md`.
+```bash
+uvx mlspace-plugin@latest setup --force
+```
+
+Мастер переиспользует ключи, предложит выбор workspace и обновит все сохранившиеся
+подключения, созданные им ранее. `--client` добавляет новые подключения.
+Удалённые подключения не восстанавливаются автоматически.
+
+Claude Code и Codex обновляют нативный плагин через свой менеджер; MCP и скиллы
+приходят из одного релиза. OpenCode обновляет команду MCP и свои скиллы.
+Для отличающихся конфигов и скиллов OpenCode мастер предлагает выбор, описанный выше.
+Дополнительные скиллы с отдельными именами, в том числе `mlspace-*`, не мешают
+установке и проверке. Скиллы, оставленные через `k`, не обновляются плагином.
+Кеш нативного плагина принадлежит менеджеру клиента: свои правки храните отдельно.
+
+Для постоянной установки сначала `uv tool upgrade mlspace-plugin`, затем
+`mlspace-plugin setup --force`. Сборка из исходников должна соответствовать
+версии публичного marketplace; для разработки используйте `--config-only`
+или изолированную тестовую установку.
+
+Собственного фонового обновления нет. Настройки автообновления Claude/Codex
+мастер не меняет. Установка и проверка конкретной версии требуют доступа к GitHub
+и PyPI. Если публикация релиза ещё не завершена, setup сообщает об ошибке;
+повторите его после завершения публикации.

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/INSTALL_AGENT.md

@@ -18,19 +18,32 @@
    (по SSH — на целевой машине). Для stage добавьте согласованный `--base-url`.
    Объясните: два ключа под звёздочками → поиск и выбор workspace → подключение.
    Дождитесь сообщения о завершении. Человек не должен присылать секреты или файл.
-4. Мастер сам обнаруживает клиентов, проверяет TLS и API, устанавливает MCP и
-   скиллы. Если клиентов несколько, человек выбирает нужные. Для известного
+4. Мастер сам обнаруживает клиентов, проверяет TLS и API. В Claude Code/Codex
+   он добавляет GitHub marketplace и устанавливает нативный плагин; в OpenCode
+   записывает MCP и скиллы в собственный каталог клиента. Если клиентов несколько, человек выбирает нужные. Для известного
    клиента можно заранее дать `--client claude-code`, `--client codex` или `--client opencode`.
    Сбой TLS исправляется системным CA или PEM от администратора через `--ca-file`.
    Никогда не отключайте TLS и не подставляйте сертификат с недоверенного сервера.
-5. Проверьте `uvx mlspace-plugin@latest --list-tools`. Эта команда проверяет только состав
-   инструментов, а не авторизацию и не загрузку выбранным клиентом.
+5. Успешный setup уже проверяет установленные скиллы, MCP initialize, список
+   инструментов и выбранные workspace. Это проверка процесса MCP, а не открытой
+   сессии агента. `--list-tools` само по себе не подтверждает подключение.
    Попросите открыть новую сессию клиента (при необходимости перезапустить).
    После появления MCP выполните read-only запрос списка выбранных workspace.
    До этого не заявляйте, что клиент уже загрузил MCP и скиллы.
-6. Если возник конфликт с существующим плагином или изменённым скиллом,
-   разберите названный несекретный путь. Не удаляйте чужую интеграцию автоматически.
-   При частичном успехе сообщите, какие этапы завершены, затем повторите setup с `--force`.
+6. При существующей настройке объясните выбор до отправки человека в терминал:
+   мастер покажет конфликты OpenCode одним списком перед вводом ключей.
+   `k` оставляет пользовательский скилл активным и исключает из обновлений;
+   `r` сохраняет резервную копию и заменяет конфликтующий файл; Enter отменяет.
+   Новые скиллы пользователя с отдельными именами сохраняются автоматически.
+   Не удаляйте каталоги `mlspace-*` и не считайте отличие от пакета доказательством
+   ручного изменения. Не заменяйте выбор человека флагом `--force` — он этого не делает.
+   В неинтерактивном режиме конфликты перечисляются без изменений: предложите человеку
+   запустить ту же команду без `--non-interactive`, сохранив endpoint, путь и выбор клиентов.
+   Для конфликта нативного плагина Claude/Codex разберите указанный несекретный путь;
+   не удаляйте чужую интеграцию автоматически.
+   При частичном успехе сообщите, какие этапы завершены, и используйте команду `Retry`
+   из ошибки: она сохраняет выбор незавершённых подключений. Для автоматизации
+   добавьте прежние `--non-interactive` и `--workspace`.
 
 ## Автоматизация с уже подготовленными credentials
 

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mlspace-plugin
-Version: 0.2.2
+Version: 0.3.1
 Summary: Cloud.ru MLSpace plugin: MCP server, agent skills and setup
 Project-URL: Repository, https://github.com/noesskeetit/mlspace-plugin
 Project-URL: Issues, https://github.com/noesskeetit/mlspace-plugin/issues
@@ -107,8 +107,10 @@ mlspace-plugin setup
 Мастер обнаруживает Claude Code, Codex и OpenCode, просит только Key ID и Key Secret
 с маской `*****`, предлагает поиск воркспейсов по имени/проекту/ID и множественный
 выбор. Проверяет API, сохраняет credentials в пользовательский `.env` с правами
-`0600`, подключает MCP и устанавливает все скиллы из пакета. Откройте новую сессию
-клиента; сервер запускается автоматически.
+`0600`. Для Claude Code и Codex мастер добавляет marketplace этого репозитория
+и устанавливает нативный плагин с MCP и скиллами. OpenCode получает MCP и скиллы
+в собственном каталоге. Мастер проверяет запуск MCP; затем откройте новую сессию
+клиента — сервер запускается автоматически.
 
 TLS использует системные доверенные CA. Для корпоративного PEM есть `--ca-file`:
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
@@ -118,14 +120,14 @@ TLS использует системные доверенные CA. Для ко
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
-Если уже используете native plugin, выбирайте этот режим, чтобы не дублировать MCP.
+Уже установленный нативный плагин из этого репозитория переиспользуется.
 
 Подробнее: [установка, SSH, сертификаты и повторная настройка](https://github.com/noesskeetit/mlspace-plugin/blob/main/INSTALL.md).
 Для разработки: `uv sync --extra dev` и `uv run pytest`.
 
 **Порядок поиска кредов** — от общего к частному, побеждает более конкретное:
 
-1. `~/.config/mlspace-plugin/.env` — пользовательский конфиг, сюда пишет `setup`
+1. Файл, сохранённый `setup` (по умолчанию `~/.config/mlspace-plugin/.env`)
 2. файл из `MLSPACE_ENV_FILE` — выбран явно
 3. настоящие переменные окружения — бьют любой файл
 
@@ -133,8 +135,10 @@ endpoint переиспользуются. Для замены ключей до
 укажите его явно через `MLSPACE_ENV_FILE`, чтобы чужой репозиторий не мог
 подменить адрес API при использовании сохранённых ключей.
 
-Отсутствующие файлы просто пропускаются, а значения из нижних уровней дополняют
-верхние. Если кредов нет вообще, сервер печатает, где искал, и что запустить.
+`~/.config/mlspace-plugin/credentials-path.json` хранит только путь к выбранному
+файлу: настройка через `--path` или `XDG_CONFIG_HOME` работает и после перезапуска
+клиента с другим окружением. Повреждённый указатель или отсутствующий целевой файл
+дают ошибку; другой аккаунт молча не подставляется.
 
 | Переменная | Обяз. | По умолчанию | Назначение |
 |---|:---:|---|---|
@@ -274,13 +278,14 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Архив релиза `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
-общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
-не зависит от публикации `mlspace-plugin` в публичном PyPI.
-
-После распаковки и однократного `setup --config-only` через wheel из архива добавьте каталог релиза как
-marketplace клиента. [Команды установки и сборки](plugin/README.md).
-Ключи остаются в пользовательском конфиге вне плагина.
+Обычная установка — `uvx mlspace-plugin@latest setup`: marketplace подключается
+автоматически. Нативные клиенты управляют плагином `mlspace@mlspace` сами.
+Манифест фиксирует точную версию runtime из PyPI вместе со скиллами.
+Ключи и CA остаются в пользовательском конфиге вне кеша плагина.
+
+Повторный `setup --force` обновляет сохранившиеся подключения мастера.
+Собственного фонового обновления нет; политики автообновления клиентов мастер
+не меняет. ZIP релиза содержит те же манифесты и скиллы, без вложенного wheel.
 
 Для других агентов предусмотрены Agent Plugins 1.0, Agent Skills и обычное
 MCP-подключение; поддержку конкретного загрузчика нужно проверять отдельно.

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/README.md

@@ -56,8 +56,10 @@ mlspace-plugin setup
 Мастер обнаруживает Claude Code, Codex и OpenCode, просит только Key ID и Key Secret
 с маской `*****`, предлагает поиск воркспейсов по имени/проекту/ID и множественный
 выбор. Проверяет API, сохраняет credentials в пользовательский `.env` с правами
-`0600`, подключает MCP и устанавливает все скиллы из пакета. Откройте новую сессию
-клиента; сервер запускается автоматически.
+`0600`. Для Claude Code и Codex мастер добавляет marketplace этого репозитория
+и устанавливает нативный плагин с MCP и скиллами. OpenCode получает MCP и скиллы
+в собственном каталоге. Мастер проверяет запуск MCP; затем откройте новую сессию
+клиента — сервер запускается автоматически.
 
 TLS использует системные доверенные CA. Для корпоративного PEM есть `--ca-file`:
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
@@ -67,14 +69,14 @@ TLS использует системные доверенные CA. Для ко
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
-Если уже используете native plugin, выбирайте этот режим, чтобы не дублировать MCP.
+Уже установленный нативный плагин из этого репозитория переиспользуется.
 
 Подробнее: [установка, SSH, сертификаты и повторная настройка](https://github.com/noesskeetit/mlspace-plugin/blob/main/INSTALL.md).
 Для разработки: `uv sync --extra dev` и `uv run pytest`.
 
 **Порядок поиска кредов** — от общего к частному, побеждает более конкретное:
 
-1. `~/.config/mlspace-plugin/.env` — пользовательский конфиг, сюда пишет `setup`
+1. Файл, сохранённый `setup` (по умолчанию `~/.config/mlspace-plugin/.env`)
 2. файл из `MLSPACE_ENV_FILE` — выбран явно
 3. настоящие переменные окружения — бьют любой файл
 
@@ -82,8 +84,10 @@ endpoint переиспользуются. Для замены ключей до
 укажите его явно через `MLSPACE_ENV_FILE`, чтобы чужой репозиторий не мог
 подменить адрес API при использовании сохранённых ключей.
 
-Отсутствующие файлы просто пропускаются, а значения из нижних уровней дополняют
-верхние. Если кредов нет вообще, сервер печатает, где искал, и что запустить.
+`~/.config/mlspace-plugin/credentials-path.json` хранит только путь к выбранному
+файлу: настройка через `--path` или `XDG_CONFIG_HOME` работает и после перезапуска
+клиента с другим окружением. Повреждённый указатель или отсутствующий целевой файл
+дают ошибку; другой аккаунт молча не подставляется.
 
 | Переменная | Обяз. | По умолчанию | Назначение |
 |---|:---:|---|---|
@@ -223,13 +227,14 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Архив релиза `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
-общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
-не зависит от публикации `mlspace-plugin` в публичном PyPI.
-
-После распаковки и однократного `setup --config-only` через wheel из архива добавьте каталог релиза как
-marketplace клиента. [Команды установки и сборки](plugin/README.md).
-Ключи остаются в пользовательском конфиге вне плагина.
+Обычная установка — `uvx mlspace-plugin@latest setup`: marketplace подключается
+автоматически. Нативные клиенты управляют плагином `mlspace@mlspace` сами.
+Манифест фиксирует точную версию runtime из PyPI вместе со скиллами.
+Ключи и CA остаются в пользовательском конфиге вне кеша плагина.
+
+Повторный `setup --force` обновляет сохранившиеся подключения мастера.
+Собственного фонового обновления нет; политики автообновления клиентов мастер
+не меняет. ZIP релиза содержит те же манифесты и скиллы, без вложенного wheel.
 
 Для других агентов предусмотрены Agent Plugins 1.0, Agent Skills и обычное
 MCP-подключение; поддержку конкретного загрузчика нужно проверять отдельно.

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/RELEASE.md

@@ -7,11 +7,11 @@
    `uv lock` и `uv run python scripts/gen_plugin.py`. Обновите примеры имён wheel/ZIP
    в инструкциях, если версия присутствует в имени файла.
 2. Выполните проверки из `CONTRIBUTING.md` на Linux и macOS.
-3. Соберите пакет (в командах ниже замените 0.2.2 на выпускаемую версию):
+3. Соберите пакет (в командах ниже замените 0.3.1 на выпускаемую версию):
 
 ```sh
-uv build --out-dir dist/release-0.2.2
-uv run python scripts/build_plugin.py --wheel dist/release-0.2.2/mlspace_plugin-0.2.2-py3-none-any.whl --output dist/plugin-release-0.2.2
+uv build --out-dir dist/release-0.3.1
+uv run python scripts/build_plugin.py --output dist/plugin-release-0.3.1
 ```
 
 4. Просмотрите содержимое wheel, sdist и ZIP. В них не должно быть credentials,
@@ -23,18 +23,24 @@ uv run python scripts/build_plugin.py --wheel dist/release-0.2.2/mlspace_plugin-
    `UV_PUBLISH_TOKEN` средствами вашего хранилища секретов, не аргументом команды:
 
 ```sh
-uv publish --trusted-publishing never dist/release-0.2.2/mlspace_plugin-0.2.2-py3-none-any.whl dist/release-0.2.2/mlspace_plugin-0.2.2.tar.gz
+uv publish --trusted-publishing never dist/release-0.3.1/mlspace_plugin-0.3.1-py3-none-any.whl dist/release-0.3.1/mlspace_plugin-0.3.1.tar.gz
 ```
 
 6. Проверьте версию и SHA256 обоих файлов через PyPI JSON API; проверьте установку
-   `uvx --from mlspace-plugin==0.2.2 mlspace-plugin --version` из нового кеша.
-   ZIP и SHA256SUMS приложите к тому же релизу публичного Git-репозитория.
+   `uvx --from mlspace-plugin==0.3.1 mlspace-plugin --version` из нового кеша.
+7. Только после проверки точной версии в PyPI обновите рабочую ветку GitHub
+   marketplace и создайте тег релиза. До этого проверяйте изменения на отдельной
+   release-ветке или локальном Git marketplace: main не должен ссылаться на
+   отсутствующий пакет. ZIP и SHA256SUMS приложите к тому же релизу.
+8. В чистом HOME выполните публичный setup, проверьте source/version нативных
+   плагинов, MCP handshake и загрузку скиллов клиентами. Используйте тестовые
+   credentials и локальный HTTPS-стенд; не выполняйте записи в реальном tenant.
 
 Пакет не проверяет обновления в фоне. Для PyPI пользователь повторяет
 `uvx mlspace-plugin@latest setup --force`: обновляются сервер и неизменённые скиллы.
-Native plugin из ZIP устанавливается отдельно через менеджер плагинов клиента;
-текущий `setup` регистрирует MCP напрямую и копирует скиллы. Не обещайте ему
-автоматическое подключение marketplace или одинаковое автообновление во всех клиентах.
+Claude Code и Codex получают нативный плагин через marketplace этого репозитория;
+OpenCode — MCP и скиллы в собственном каталоге. Политики автообновления клиентов
+не меняются. Не обещайте одинаковое фоновое обновление во всех клиентах.
 
 Перед открытием существующего приватного Git-репозитория проверьте также его
 историю. Проверка wheel и sdist не является проверкой старых Git-коммитов.

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Cloud.ru MLSpace: training jobs, inference, notebooks, data transfer, registry and compute catalog — an MCP server plus skills.",
   "author": {
     "name": "Cloud.ru"

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Cloud.ru MLSpace: training jobs, inference, notebooks, data transfer, registry and compute catalog — an MCP server plus skills.",
   "author": {
     "name": "Cloud.ru"

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/plugin/.mcp.json

@@ -5,7 +5,7 @@
       "command": "uvx",
       "args": [
         "--from",
-        "${CLAUDE_PLUGIN_ROOT}/server/mlspace_plugin-0.2.2-py3-none-any.whl",
+        "mlspace-plugin==0.3.1",
         "mlspace-plugin",
         "--transport",
         "stdio"

mlspace_plugin-0.3.1/plugin/README.md

@@ -0,0 +1,67 @@
+# MLSpace: MCP и скиллы одним плагином
+
+Для macOS и Linux, включая SSH:
+
+```bash
+uvx mlspace-plugin@latest setup
+```
+
+Мастер принимает два ключа, предлагает поиск и выбор workspace, добавляет
+marketplace этого репозитория и устанавливает `mlspace@mlspace` в Claude Code
+или Codex. В OpenCode подключает MCP напрямую и устанавливает скиллы в его
+собственный каталог. Затем проверяет скиллы и запуск MCP.
+
+Откройте новую сессию клиента. Самостоятельно запускать сервер не требуется.
+Подробнее: [установка](../INSTALL.md), [инструкция агенту](../INSTALL_AGENT.md).
+
+## Состав
+
+- 12 скиллов в `skills/`;
+- манифесты Agent Plugins, Claude Code и Codex;
+- команда MCP `uvx --from mlspace-plugin==<версия> mlspace-plugin --transport stdio`.
+
+Версия сервера из PyPI совпадает с версией плагина. ZIP релиза содержит каталог
+`plugin/`, marketplace-манифесты, README, LICENSE и SHA256SUMS. Вложенного wheel
+нет: для запуска нужен доступ к PyPI. Исходники скиллов находятся в одном месте —
+`plugin/skills`; их копиями в кеше управляют нативные клиенты.
+
+Ключи, CA и указатель на credentials находятся вне кеша плагина. Изменение
+`XDG_CONFIG_HOME` при запуске клиента не теряет выбранный файл настроек.
+
+## Повторная установка и обновление
+
+```bash
+uvx mlspace-plugin@latest setup --force
+```
+
+Обновляются сохранившиеся подключения мастера. Уже установленная целевая версия
+не переустанавливается. Собственного фонового обновления нет; политики клиентов
+мастер не меняет. Не редактируйте нативный кеш плагина: обновление заменяет его.
+
+## Ручная диагностика нативных клиентов
+
+Обычно эти команды не нужны — их выполняет setup. Для проверки состояния:
+
+```bash
+claude plugin marketplace list --json
+claude plugin list --json
+codex plugin marketplace list --json
+codex plugin list --json
+```
+
+Marketplace `mlspace` должен ссылаться на
+`https://github.com/noesskeetit/mlspace-plugin.git`, а плагин `mlspace@mlspace`
+должен быть включён. Если CLI не поддерживает команды plugin, обновите клиент.
+Прямая MCP-регистрация с тем же именем может конфликтовать с нативным плагином;
+мастер сообщает об этом до ввода ключей и не удаляет пользовательский конфиг.
+
+## Сборка
+
+```bash
+uv run python scripts/gen_plugin.py --check
+uv build
+uv run python scripts/build_plugin.py
+```
+
+ZIP появится в `dist/plugins/`. Генератор проверяет манифесты плагина и оба
+marketplace-манифеста в корне репозитория. Порядок публикации — в [RELEASE.md](../RELEASE.md).

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/plugin/mcp.json

@@ -6,14 +6,11 @@
       "command": "uvx",
       "args": [
         "--from",
-        "${PLUGIN_ROOT}/server/mlspace_plugin-0.2.2-py3-none-any.whl",
+        "mlspace-plugin==0.3.1",
         "mlspace-plugin",
         "--transport",
         "stdio"
-      ],
-      "env": {
-        "MLSPACE_ENV_FILE": "${PLUGIN_DATA}/.env"
-      }
+      ]
     }
   }
 }

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "mlspace",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Cloud.ru MLSpace: training jobs, inference, notebooks, data transfer, registry and compute catalog — an MCP server plus skills.",
   "author": {
     "name": "Cloud.ru"

{mlspace_plugin-0.2.2 → mlspace_plugin-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mlspace-plugin"
-version = "0.2.2"
+version = "0.3.1"
 description = "Cloud.ru MLSpace plugin: MCP server, agent skills and setup"
 keywords = ["mlspace", "mcp", "agent-skills", "cloudru"]
 classifiers = [
@@ -50,6 +50,7 @@ packages = ["src/mlspace_mcp"]
 
 [tool.hatch.build.targets.sdist]
 include = [
+    "/.agents/plugins/marketplace.json", "/.claude-plugin/marketplace.json",
     "/src", "/tests", "/plugin", "/scripts/gen_plugin.py", "/scripts/build_plugin.py",
     "/scripts/gen_body_schemas.py", "/scripts/demo_multi_workspace.py",
     "/scripts/mcp_call.py", "/scripts/serve_stdio.sh", "/scripts/serve_stdio_dryrun.sh",