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

mlspace_plugin-0.2.2/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.env
+.env.*
+!.env.example
+*.secret
+.DS_Store

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

@@ -20,8 +20,11 @@ mlspace-plugin setup
 ```
 
 Если пакет уже установлен: `uv tool install --force .`.
-При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.2.1-py3-none-any.whl`.
+При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.2.2-py3-none-any.whl`.
 Не используйте editable-установку из `/tmp` для постоянной работы.
+Далее команды показаны для PyPI. После установки исходников или wheel через
+`uv tool install` заменяйте `uvx mlspace-plugin@latest` на `mlspace-plugin`,
+чтобы использовать именно установленную сборку.
 
 Мастер:
 
@@ -41,7 +44,7 @@ mlspace-plugin setup
 ## Stage и корпоративные сертификаты
 
 ```bash
-mlspace-plugin setup --base-url https://mlspace-stage.example.com
+uvx mlspace-plugin@latest setup --base-url https://mlspace-stage.example.com
 ```
 
 Настройка и работа сервера используют системные доверенные сертификаты: Keychain
@@ -49,7 +52,7 @@ mlspace-plugin setup --base-url https://mlspace-stage.example.com
 попросит путь к PEM, полученному у администратора. Можно указать заранее:
 
 ```bash
-mlspace-plugin setup --ca-file /путь/к/corporate-ca.pem
+uvx mlspace-plugin@latest setup --ca-file /путь/к/corporate-ca.pem
 ```
 
 Мастер сохранит копию CA рядом с настройками. Переменные текущего терминала и
@@ -63,10 +66,10 @@ mlspace-plugin setup --ca-file /путь/к/corporate-ca.pem
 ## Повторная настройка
 
 ```bash
-mlspace-plugin setup --force
-mlspace-plugin setup --force --replace-credentials
-mlspace-plugin setup --client opencode
-mlspace-plugin setup --client-path opencode=/полный/путь/opencode
+uvx mlspace-plugin@latest setup --force
+uvx mlspace-plugin@latest setup --force --replace-credentials
+uvx mlspace-plugin@latest setup --force --client opencode
+uvx mlspace-plugin@latest setup --force --client-path opencode=/полный/путь/opencode
 ```
 
 `--force` повторяет настройку с сохранёнными ключами на прежнем endpoint.
@@ -88,7 +91,7 @@ mlspace-plugin setup --client-path opencode=/полный/путь/opencode
 
 ## Linux по SSH / установка агентом
 
-Запустите `mlspace-plugin setup` в своей SSH-сессии. Браузер и графическая среда не нужны.
+Запустите `uvx mlspace-plugin@latest setup` в своей SSH-сессии. Браузер и графическая среда не нужны.
 Если установкой занимается агент, он готовит пакет, а ключи вы вводите сами в своём
 терминале. После завершения сообщите агенту «готово», без ключей и содержимого `.env`.
 
@@ -101,7 +104,10 @@ mlspace-plugin setup --client-path opencode=/полный/путь/opencode
 
 Для установки через PyPI повторите `uvx mlspace-plugin@latest setup --force`.
 Мастер сохранит ключи, предложит выбор workspace и обновит скиллы без локальных
-изменений. Изменённые вручную скиллы вызовут конфликт с указанием файла.
+изменений. MCP обновляется во всех клиентах, ранее подключённых мастером,
+чтобы версия сервера совпадала с общими скиллами. `--client` выбирает новые
+подключения, а существующие управляемые подключения обновляются вместе.
+Изменённые вручную регистрации и скиллы вызовут конфликт с указанием файла.
 Регистрация MCP, созданная мастером и не изменённая вручную, обновляется
 автоматически. Посторонние и изменённые регистрации требуют разбора конфликта.
 Для постоянной установки: `uv tool upgrade mlspace-plugin`, затем

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

@@ -9,10 +9,12 @@
    При установке из исходников установите пакет в постоянное окружение: `uv tool install .` из checkout или `uv tool install /path/package.whl`.
    Для уже установленного пакета добавьте `--force` только в рамках запрошенного обновления.
    Не оставляйте постоянный запуск на editable-исходниках в `/tmp`.
+   Далее команды показаны для PyPI. Если установили исходники/wheel через `uv tool install`,
+   заменяйте префикс `uvx mlspace-plugin@latest` на `mlspace-plugin`, чтобы использовать именно эту сборку.
 2. Не просите Key ID/Secret в чате, не читайте `.env`, не печатайте окружение и
    не вставляйте ключи в аргументы shell/CLI. Не запускайте интерактивный ввод
    ключей в терминале, который видите только вы.
-3. Дайте человеку одну команду `mlspace-plugin setup` для его собственного терминала
+3. Дайте человеку одну команду `uvx mlspace-plugin@latest setup` для его собственного терминала
    (по SSH — на целевой машине). Для stage добавьте согласованный `--base-url`.
    Объясните: два ключа под звёздочками → поиск и выбор workspace → подключение.
    Дождитесь сообщения о завершении. Человек не должен присылать секреты или файл.
@@ -21,7 +23,7 @@
    клиента можно заранее дать `--client claude-code`, `--client codex` или `--client opencode`.
    Сбой TLS исправляется системным CA или PEM от администратора через `--ca-file`.
    Никогда не отключайте TLS и не подставляйте сертификат с недоверенного сервера.
-5. Проверьте `mlspace-plugin --list-tools`. Эта команда проверяет только состав
+5. Проверьте `uvx mlspace-plugin@latest --list-tools`. Эта команда проверяет только состав
    инструментов, а не авторизацию и не загрузку выбранным клиентом.
    Попросите открыть новую сессию клиента (при необходимости перезапустить).
    После появления MCP выполните read-only запрос списка выбранных workspace.
@@ -36,7 +38,7 @@
 файл, передавайте **путь**, не читайте содержимое. Для поиска нужных workspace:
 
 ```bash
-mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env \
+uvx mlspace-plugin@latest setup --non-interactive --credentials-file /path/credentials.env \
   --base-url https://api.ai.cloud.ru --list-workspaces --search project --limit 20
 ```
 
@@ -45,7 +47,7 @@ mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env
 Установка с точными ID, без интерактивных вопросов:
 
 ```bash
-mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env \
+uvx mlspace-plugin@latest setup --non-interactive --credentials-file /path/credentials.env \
   --client opencode --workspace WORKSPACE_UUID
 ```
 

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: mlspace-plugin
-Version: 0.2.1
+Version: 0.2.2
 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
@@ -114,7 +114,7 @@ TLS использует системные доверенные CA. Для ко
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
 настройку без перезаписи прежнего файла и без запроса ручного x-api-key.
 
-Повторная настройка — `mlspace-plugin setup --force`: сохранённые ключи на прежнем
+Повторная настройка — `uvx mlspace-plugin@latest setup --force`: сохранённые ключи на прежнем
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
@@ -274,11 +274,11 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Внутренний релиз `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
+Архив релиза `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
 общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
 не зависит от публикации `mlspace-plugin` в публичном PyPI.
 
-После распаковки и однократного `mlspace-plugin setup` добавьте каталог релиза как
+После распаковки и однократного `setup --config-only` через wheel из архива добавьте каталог релиза как
 marketplace клиента. [Команды установки и сборки](plugin/README.md).
 Ключи остаются в пользовательском конфиге вне плагина.
 
@@ -318,40 +318,6 @@ MCP-подключение; поддержку конкретного загру
 
 ---
 
-## Защиты от дефектов API
-
-Обёртка гасит несколько особенностей MLSpace API, на которых агент иначе спотыкается.
-API-ловушки ниже проверялись на живом API: основная часть — 03.08.2026,
-региональность `/home/jovyan` — 12.08.2026. Допустимость binary-команд подтверждена
-[официальной CLI-документацией](https://cloud.ru/docs/aicloud/mlspace-cli/topics/references__job-submit)
-и локальной схемой; проверка доступности команды в образе остаётся отдельным шагом.
-
-- **Тип entrypoint и регион проверяются до отправки.** Явный `region` обязателен для
-  каждого типа задачи. Для `type=binary` поле `script` — непустая команда или путь к
-  исполняемому файлу (`ls -lah`, `python /home/jovyan/launch.py -f script.py`); MCP
-  передаёт строку без изменений и не заявляет, что команда существует в выбранном
-  образе. Для остальных типов сохраняется проверка абсолютного пути под
-  `/home/jovyan`. Это NFS конкретного региона: одинаковый путь в notebook `SR006` и
-  job `A100-MT` может указывать на разные данные. Public API не умеет сделать `stat`
-  на целевом NFS, поэтому наличие файла подтверждается same-region notebook'ом или
-  transfer'ом. Локальная проверка формы пути или dry-run не проверяет наличие файла.
-- **Порядок лога восстанавливается.** `logs?tail=N` возвращает строки в обратном
-  порядке — трейсбэк переворачивается, и причина оказывается ниже следствия. MCP
-  сортирует обратно и помечает это в ответе, чтобы модель знала, что порядку можно
-  доверять. Без `tail` порядок правильный и не трогается.
-- **Состояния вместо прозы.** Строки `"No such job"` (логи протухли по retention) и
-  `Job … in queue. Try later` (задача в очереди) приходят внутри `HTTP 200`. MCP
-  распознаёт их и выдаёт понятную типизированную пометку, чтобы «логи устарели» не
-  читалось как «задачи не существует».
-- **Ретрай не уходит в бесконечность.** Часть ручек отдаёт `500` детерминированно
-  (например, assignments на 6 из 7 аллокаций). Совет при `5xx` — повторить один раз,
-  дальше считать отказ постоянным.
-- **Каталог образов сжимается.** `configs` отдаёт ~200 КБ (≈51k токенов), дублируя
-  образы под каждым `instance_type`; MCP дедуплицирует их без потери данных и умеет
-  отфильтровать один регион.
-
----
-
 ## Разработка
 
 ```bash

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

@@ -63,7 +63,7 @@ TLS использует системные доверенные CA. Для ко
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
 настройку без перезаписи прежнего файла и без запроса ручного x-api-key.
 
-Повторная настройка — `mlspace-plugin setup --force`: сохранённые ключи на прежнем
+Повторная настройка — `uvx mlspace-plugin@latest setup --force`: сохранённые ключи на прежнем
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
@@ -223,11 +223,11 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Внутренний релиз `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
+Архив релиза `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
 общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
 не зависит от публикации `mlspace-plugin` в публичном PyPI.
 
-После распаковки и однократного `mlspace-plugin setup` добавьте каталог релиза как
+После распаковки и однократного `setup --config-only` через wheel из архива добавьте каталог релиза как
 marketplace клиента. [Команды установки и сборки](plugin/README.md).
 Ключи остаются в пользовательском конфиге вне плагина.
 
@@ -267,40 +267,6 @@ MCP-подключение; поддержку конкретного загру
 
 ---
 
-## Защиты от дефектов API
-
-Обёртка гасит несколько особенностей MLSpace API, на которых агент иначе спотыкается.
-API-ловушки ниже проверялись на живом API: основная часть — 03.08.2026,
-региональность `/home/jovyan` — 12.08.2026. Допустимость binary-команд подтверждена
-[официальной CLI-документацией](https://cloud.ru/docs/aicloud/mlspace-cli/topics/references__job-submit)
-и локальной схемой; проверка доступности команды в образе остаётся отдельным шагом.
-
-- **Тип entrypoint и регион проверяются до отправки.** Явный `region` обязателен для
-  каждого типа задачи. Для `type=binary` поле `script` — непустая команда или путь к
-  исполняемому файлу (`ls -lah`, `python /home/jovyan/launch.py -f script.py`); MCP
-  передаёт строку без изменений и не заявляет, что команда существует в выбранном
-  образе. Для остальных типов сохраняется проверка абсолютного пути под
-  `/home/jovyan`. Это NFS конкретного региона: одинаковый путь в notebook `SR006` и
-  job `A100-MT` может указывать на разные данные. Public API не умеет сделать `stat`
-  на целевом NFS, поэтому наличие файла подтверждается same-region notebook'ом или
-  transfer'ом. Локальная проверка формы пути или dry-run не проверяет наличие файла.
-- **Порядок лога восстанавливается.** `logs?tail=N` возвращает строки в обратном
-  порядке — трейсбэк переворачивается, и причина оказывается ниже следствия. MCP
-  сортирует обратно и помечает это в ответе, чтобы модель знала, что порядку можно
-  доверять. Без `tail` порядок правильный и не трогается.
-- **Состояния вместо прозы.** Строки `"No such job"` (логи протухли по retention) и
-  `Job … in queue. Try later` (задача в очереди) приходят внутри `HTTP 200`. MCP
-  распознаёт их и выдаёт понятную типизированную пометку, чтобы «логи устарели» не
-  читалось как «задачи не существует».
-- **Ретрай не уходит в бесконечность.** Часть ручек отдаёт `500` детерминированно
-  (например, assignments на 6 из 7 аллокаций). Совет при `5xx` — повторить один раз,
-  дальше считать отказ постоянным.
-- **Каталог образов сжимается.** `configs` отдаёт ~200 КБ (≈51k токенов), дублируя
-  образы под каждым `instance_type`; MCP дедуплицирует их без потери данных и умеет
-  отфильтровать один регион.
-
----
-
 ## Разработка
 
 ```bash

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/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.1 на выпускаемую версию):
+3. Соберите пакет (в командах ниже замените 0.2.2 на выпускаемую версию):
 
 ```sh
-uv build --out-dir dist/release-0.2.1
-uv run python scripts/build_plugin.py --wheel dist/release-0.2.1/mlspace_plugin-0.2.1-py3-none-any.whl --output dist/plugin-release-0.2.1
+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
 ```
 
 4. Просмотрите содержимое wheel, sdist и ZIP. В них не должно быть credentials,
@@ -23,11 +23,11 @@ uv run python scripts/build_plugin.py --wheel dist/release-0.2.1/mlspace_plugin-
    `UV_PUBLISH_TOKEN` средствами вашего хранилища секретов, не аргументом команды:
 
 ```sh
-uv publish --trusted-publishing never dist/release-0.2.1/mlspace_plugin-0.2.1-py3-none-any.whl dist/release-0.2.1/mlspace_plugin-0.2.1.tar.gz
+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
 ```
 
 6. Проверьте версию и SHA256 обоих файлов через PyPI JSON API; проверьте установку
-   `uvx --from mlspace-plugin==0.2.1 mlspace-plugin --version` из нового кеша.
+   `uvx --from mlspace-plugin==0.2.2 mlspace-plugin --version` из нового кеша.
    ZIP и SHA256SUMS приложите к тому же релизу публичного Git-репозитория.
 
 Пакет не проверяет обновления в фоне. Для PyPI пользователь повторяет

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

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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.1 → mlspace_plugin-0.2.2}/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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.1 → mlspace_plugin-0.2.2}/plugin/.mcp.json

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

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/plugin/README.md

@@ -7,9 +7,9 @@
 
 ## Установка из архива релиза
 
-Скачайте `mlspace-plugin-0.2.1.zip` из опубликованного релиза проекта.
+Скачайте `mlspace-plugin-0.2.2.zip` из опубликованного релиза проекта.
 Распакуйте его в постоянный каталог, например `~/plugins`, и перейдите в
-`mlspace-plugin-0.2.1`. Сохраняйте каталог: локальный marketplace нужен для обновлений.
+`mlspace-plugin-0.2.2`. Сохраняйте каталог: локальный marketplace нужен для обновлений.
 
 Требования: `uv` (`uvx`) в PATH, Python 3.10+ и установленный клиент агента.
 При первом запуске `uv` устанавливает зависимости из настроенного Python index;
@@ -19,7 +19,7 @@
 Настройте ключи сервисной учётной записи и выберите доступные workspace:
 
 ```sh
-uvx --from ./plugins/mlspace/server/mlspace_plugin-0.2.1-py3-none-any.whl mlspace-plugin setup --config-only
+uvx --from ./plugins/mlspace/server/mlspace_plugin-0.2.2-py3-none-any.whl mlspace-plugin setup --config-only
 ```
 
 Ключи вводятся в терминале. `setup` сохраняет их вне плагина в пользовательском
@@ -62,7 +62,7 @@ claude plugin install mlspace@mlspace
 Для MCP-only клиента задайте команду `uvx` и аргументы:
 
 ```json
-["--from", "/absolute/path/plugins/mlspace/server/mlspace_plugin-0.2.1-py3-none-any.whl", "mlspace-plugin", "--transport", "stdio"]
+["--from", "/absolute/path/plugins/mlspace/server/mlspace_plugin-0.2.2-py3-none-any.whl", "mlspace-plugin", "--transport", "stdio"]
 ```
 
 `SKILL.md` можно подключать отдельно в клиентах с поддержкой Agent Skills.
@@ -71,7 +71,7 @@ claude plugin install mlspace@mlspace
 ## Состав архива
 
 ```text
-mlspace-plugin-0.2.1/
+mlspace-plugin-0.2.2/
 ├── .agents/plugins/marketplace.json
 ├── .claude-plugin/marketplace.json
 ├── README.md
@@ -82,7 +82,7 @@ mlspace-plugin-0.2.1/
     ├── .codex-plugin/plugin.json
     ├── .claude-plugin/plugin.json
     ├── .mcp.json
-    ├── server/mlspace_plugin-0.2.1-py3-none-any.whl
+    ├── server/mlspace_plugin-0.2.2-py3-none-any.whl
     └── skills/<12 скиллов>/SKILL.md
 ```
 
@@ -103,8 +103,8 @@ Portable MCP допускает отдельный `MLSPACE_ENV_FILE=${PLUGIN_DA
 
 ```sh
 python scripts/gen_plugin.py --check
-uv build --out-dir dist/release-0.2.1
-python scripts/build_plugin.py --wheel dist/release-0.2.1/mlspace_plugin-0.2.1-py3-none-any.whl
+uv build --out-dir dist/release-0.2.2
+python scripts/build_plugin.py --wheel dist/release-0.2.2/mlspace_plugin-0.2.2-py3-none-any.whl
 ```
 
 Готовая поставка и ZIP появятся в `dist/plugins/`.

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

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

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "mlspace",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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.1 → mlspace_plugin-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mlspace-plugin"
-version = "0.2.1"
+version = "0.2.2"
 description = "Cloud.ru MLSpace plugin: MCP server, agent skills and setup"
 keywords = ["mlspace", "mcp", "agent-skills", "cloudru"]
 classifiers = [

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/src/mlspace_mcp/__init__.py

@@ -1,3 +1,3 @@
 """mlspace_mcp — MCP server for the Cloud.ru MLSpace public API v2."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/src/mlspace_mcp/client_setup.py

@@ -106,10 +106,41 @@ def _read_config(path: Path) -> dict[str, Any]:
     return load_jsonc(path.read_text())
 
 
+def managed_clients(overrides: dict[str, str] | None = None) -> dict[str, str]:
+    """Find surviving managed registrations so one product updates together."""
+    state_path = user_config_file().parent / 'install-state.json'
+    state = json.loads(state_path.read_text()) if state_path.exists() else {}
+    detected = detect_clients()
+    result = {}
+    for client in state.get('clients', {}):
+        if client not in CLIENTS:
+            continue
+        config = _config(client)
+        previous_path = Path(state.get('configs', {}).get(client, str(config)))
+        key = {'claude-code': 'mcpServers', 'codex': 'mcp_servers', 'opencode': 'mcp'}[client]
+        if 'mlspace' not in _read_config(previous_path).get(key, {}):
+            continue  # The user removed this connection; never recreate it.
+        if previous_path.absolute() != config.absolute():
+            variable = {'claude-code': 'CLAUDE_CONFIG_DIR', 'codex': 'CODEX_HOME',
+                        'opencode': 'OPENCODE_CONFIG'}[client]
+            raise ValueError(f'Previously connected {client} uses {previous_path}. '
+                             f'Restore its {variable} setting before updating all MLSpace clients.')
+        candidates = [(overrides or {}).get(client), state.get('executables', {}).get(client),
+                      detected.get(client)]
+        executable = next((path for path in candidates if path and Path(path).is_file()
+                           and os.access(path, os.X_OK)), None)
+        if not executable and client != 'opencode':
+            raise ValueError(f'Previously connected {client} executable is unavailable. Restore it or use '
+                             f'--client-path {client}=/absolute/path before updating MLSpace.')
+        result[client] = executable or CLIENTS[client]  # OpenCode config is written directly.
+    return result
+
+
 def prepare_clients(clients: dict[str, str], env_file: Path, command: list[str]) -> dict[str, Any]:
     """Plan all writes and reject conflicts before setup saves credentials."""
     state_path = user_config_file().parent / 'install-state.json'
     state = json.loads(state_path.read_text()) if state_path.exists() else {}
+    clients = managed_clients(clients) | clients
     sources = _skill_sources()
     writes: dict[Path, str] = {}
     registrations = []
@@ -201,6 +232,7 @@ def install_clients(clients: dict[str, str], env_file: Path, command: list[str])
                     subprocess.run(remove, env=clean_env, check=True,
                                    capture_output=True, timeout=30)
                 if comparable != entry:
+                    config.parent.mkdir(parents=True, exist_ok=True, mode=0o700)
                     arguments = ([executable, 'mcp', 'add', 'mlspace', '--scope', 'user', '--transport', 'stdio',
                                   '--env', 'MLSPACE_ENV_FILE=' + str(env_file.absolute())]
                                  if client == 'claude-code' else
@@ -216,6 +248,8 @@ def install_clients(clients: dict[str, str], env_file: Path, command: list[str])
             if comparable_saved != entry:
                 raise ValueError(f'Client registration could not be confirmed for {client}; retry setup.')
             state.setdefault('clients', {})[client] = _hash(json.dumps(saved, sort_keys=True))
+            state.setdefault('configs', {})[client] = str(config.absolute())
+            state.setdefault('executables', {})[client] = executable
             atomic_write(state_path, json.dumps(state, indent=2))
             installed.append(client)
         except (subprocess.SubprocessError, OSError) as exc:

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/src/mlspace_mcp/init_cli.py

@@ -20,6 +20,7 @@ from .client_setup import (
     atomic_write,
     detect_clients,
     install_clients,
+    managed_clients,
     prepare_clients,
     server_command,
 )
@@ -166,16 +167,26 @@ def _verify(values: dict[str, str], *, base_url: str) -> str | None:
 
 def _clients(requested: list[str], paths: list[str], non_interactive: bool) -> dict[str, str]:
     detected = detect_clients()
+    explicit = {}
     for item in paths:
         name, separator, path = item.partition('=')
         executable = Path(path).expanduser().absolute()
         if not separator or name not in CLIENTS or not executable.is_file() or not os.access(executable, os.X_OK):
             raise ValueError('Use --client-path CLIENT=/absolute/path/to/executable.')
         detected[name] = str(executable)
+        explicit[name] = str(executable)
+    managed = managed_clients(explicit)
+    detected = managed | detected
     if requested:
         if any(name not in detected for name in requested):
             raise ValueError('Requested client not found. Install it or use --client-path CLIENT=/path.')
         return {name: detected[name] for name in requested}
+    if managed:
+        print('Updating all previously connected MLSpace clients: ' + ', '.join(managed), file=sys.stderr)
+        return managed | explicit
+    if not explicit and (user_config_file().parent / 'install-state.json').exists():
+        raise ValueError('No previous MLSpace connections remain. Select a new connection explicitly '
+                         'with --client or --client-path.')
     if len(detected) == 1:
         print('Client detected: ' + next(iter(detected)), file=sys.stderr)
         return detected
@@ -216,7 +227,7 @@ def run_init(path: Path | None = None, *, force: bool = False, verify: bool = Tr
         print('\nSetup cancelled; previous credentials preserved unless saving already completed.', file=sys.stderr)
         return 130
     except EOFError:
-        print('\nNo interactive input. Run `mlspace-plugin setup` yourself in a terminal (SSH works). '
+        print('\nNo interactive input. Run `uvx mlspace-plugin@latest setup` yourself in a terminal (SSH works). '
               'Agents: use INSTALL_AGENT.md; never ask for keys in chat.', file=sys.stderr)
         return 1
     except (ValueError, OSError, httpx.HTTPError) as exc:
@@ -234,6 +245,10 @@ def _run_init(path: Path | None, **options: Any) -> int:
         raise EOFError
     if options['from_env'] and options['credentials_file']:
         raise ValueError('Choose either --from-env or --credentials-file.')
+    if target.is_symlink():
+        raise ValueError('Credentials target must not be a symlink.')
+    if target.exists() and not target.is_file():
+        raise ValueError('Credentials target must be a regular file.')
     if target.exists() and not options['force'] and not listing:
         raise ValueError('Configuration already exists. Use --force to reconfigure; saved keys will be reused.')
     if not options['verify'] and (not options['config_only'] or not options['workspace_ids']):
@@ -252,7 +267,9 @@ def _run_init(path: Path | None, **options: Any) -> int:
         options['clients'], options['client_paths'], non_interactive)
     command = server_command() if selected_clients else []
     if selected_clients:
-        prepare_clients(selected_clients, target, command)
+        plan = prepare_clients(selected_clients, target, command)
+        print('MCP and skills will be kept together for: ' +
+              ', '.join(row[0] for row in plan['registrations']), file=sys.stderr)
     if not listing:
         print('[1/4] Access keys. Paste values only; asterisks hide both fields. '
               'Keys stay in your user config, not in chat.', file=sys.stderr)
@@ -340,7 +357,14 @@ def _run_init(path: Path | None, **options: Any) -> int:
     if selected_clients:
         print('[4/4] Connecting MCP and installing skills…', file=sys.stderr)
         installed = install_clients(selected_clients, target, command)
-    _write(target, values)
+    try:
+        _write(target, values)
+    except (OSError, ValueError) as exc:
+        if installed:
+            raise ValueError(f'MCP and skills installed: {", ".join(installed)}, but credentials could not be saved '
+                             f'to {target}. Previous credentials were not replaced. Check this path and its '
+                             'permissions, then rerun setup --force before using the MCP.') from exc
+        raise
     print(f'Credentials saved: {target} (0600).', file=sys.stderr)
     if not options['verify']:
         print('UNVERIFIED configuration saved by explicit request. No client was connected.', file=sys.stderr)

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/tests/test_client_setup.py

@@ -103,7 +103,6 @@ def test_installed_native_cli_registration_in_isolated_home(tmp_path, monkeypatc
     monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
     monkeypatch.setenv('CLAUDE_CONFIG_DIR', str(tmp_path / '.claude'))
     monkeypatch.setenv('CODEX_HOME', str(tmp_path / '.codex'))
-    (tmp_path / '.codex').mkdir()
     args = ({client: executable}, tmp_path / 'fake.env', ['/bin/echo', '--transport', 'stdio'])
     install_clients(*args)
     data = _read_config(_config(client))
@@ -231,3 +230,67 @@ def test_local_wheel_in_uvx_cache_is_not_substituted_with_pypi(tmp_path, monkeyp
     monkeypatch.setattr('shutil.which', lambda name: '/opt/bin/uvx' if name == 'uvx' else None)
     with pytest.raises(ValueError, match='local wheel'):
         client_setup.server_command()
+
+
+def test_shared_skill_update_includes_previously_connected_clients(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    monkeypatch.setenv('HOME', str(tmp_path))
+    monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
+    monkeypatch.setenv('CODEX_HOME', str(tmp_path / '.codex'))
+    monkeypatch.setattr(client_setup, '_skill_sources', lambda: {'mlspace-example': 'version one'})
+    client_setup.install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v1'])
+    monkeypatch.setattr(client_setup, '_skill_sources', lambda: {'mlspace-example': 'version two'})
+    plan = client_setup.prepare_clients({'codex': '/bin/true'}, tmp_path / '.env', ['runtime-v2'])
+    registrations = {row[0]: row[3] for row in plan['registrations']}
+    assert registrations['opencode']['command'] == ['runtime-v2']
+    assert registrations['codex']['command'] == 'runtime-v2'
+    assert plan['writes'][tmp_path / '.agents/skills/mlspace-example/SKILL.md'] == 'version two'
+
+
+def test_update_does_not_recreate_removed_client_registration(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    monkeypatch.setenv('HOME', str(tmp_path))
+    monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
+    monkeypatch.setenv('CODEX_HOME', str(tmp_path / '.codex'))
+    client_setup.install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v1'])
+    (tmp_path / '.config/opencode/opencode.json').write_text('{}')
+    plan = client_setup.prepare_clients({'codex': '/bin/true'}, tmp_path / '.env', ['runtime-v2'])
+    assert [row[0] for row in plan['registrations']] == ['codex']
+
+
+def test_modified_previously_connected_client_blocks_shared_update(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    monkeypatch.setenv('HOME', str(tmp_path))
+    monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
+    monkeypatch.setenv('CODEX_HOME', str(tmp_path / '.codex'))
+    client_setup.install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v1'])
+    config = tmp_path / '.config/opencode/opencode.json'
+    config.write_text(config.read_text().replace('runtime-v1', 'user-edited'))
+    with pytest.raises(ValueError, match='was not overwritten'):
+        client_setup.prepare_clients({'codex': '/bin/true'}, tmp_path / '.env', ['runtime-v2'])
+
+
+def test_custom_client_config_cannot_be_silently_forgotten(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    monkeypatch.setenv('HOME', str(tmp_path))
+    monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
+    monkeypatch.setenv('OPENCODE_CONFIG', str(tmp_path / 'custom.json'))
+    client_setup.install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v1'])
+    monkeypatch.delenv('OPENCODE_CONFIG')
+    with pytest.raises(ValueError, match='OPENCODE_CONFIG'):
+        client_setup.prepare_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v2'])
+    assert not (tmp_path / '.config/opencode/opencode.json').exists()
+
+
+def test_missing_managed_native_cli_blocks_before_new_registration(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    monkeypatch.setenv('HOME', str(tmp_path))
+    monkeypatch.setenv('XDG_CONFIG_HOME', str(tmp_path / '.config'))
+    monkeypatch.setenv('CODEX_HOME', str(tmp_path / '.codex'))
+    monkeypatch.setattr(client_setup, 'detect_clients', lambda: {})
+    client_setup.atomic_write(tmp_path / '.codex/config.toml', '[mcp_servers.mlspace]\ncommand="old"\n')
+    client_setup.atomic_write(tmp_path / '.config/mlspace-plugin/install-state.json',
+                              json.dumps({'clients': {'codex': 'old'}}))
+    with pytest.raises(ValueError, match='codex executable is unavailable'):
+        client_setup.install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v2'])
+    assert not (tmp_path / '.config/opencode/opencode.json').exists()

{mlspace_plugin-0.2.1 → mlspace_plugin-0.2.2}/tests/test_onboarding_init.py

@@ -163,7 +163,7 @@ def test_client_install_failure_preserves_previous_credentials(tmp_path, monkeyp
     target.write_text(original)
     monkeypatch.setattr('mlspace_mcp.init_cli._clients', lambda *a: {'opencode': '/bin/true'})
     monkeypatch.setattr('mlspace_mcp.init_cli.server_command', lambda: ['/bin/echo'])
-    monkeypatch.setattr('mlspace_mcp.init_cli.prepare_clients', lambda *a: {})
+    monkeypatch.setattr('mlspace_mcp.init_cli.prepare_clients', lambda *a: {'registrations': [('opencode',)]})
     def fail(*a, **kw):
         raise ValueError('Client installation failed')
     monkeypatch.setattr('mlspace_mcp.init_cli.install_clients', fail)
@@ -208,3 +208,66 @@ def test_human_init_connects_detected_client_and_skills_after_two_masked_prompts
     output = capsys.readouterr()
     assert 'human-secret' not in output.err + output.out
     assert 'human-id' not in output.err + output.out
+
+
+@pytest.mark.parametrize('kind', ['symlink', 'directory'])
+@respx.mock
+def test_invalid_credentials_target_fails_before_client_setup(tmp_path, monkeypatch, capsys, kind):
+    target = tmp_path / 'invalid.env'
+    if kind == 'symlink':
+        target.symlink_to(tmp_path / 'missing.env')
+    else:
+        target.mkdir()
+    calls = []
+    monkeypatch.setattr('mlspace_mcp.init_cli._clients', lambda *a: calls.append('clients') or {})
+    assert run_init(target, force=True, non_interactive=True, from_env=True) == 1
+    assert calls == []
+    assert 'Credentials target' in capsys.readouterr().err
+
+
+@respx.mock
+def test_final_save_failure_reports_connected_clients(tmp_path, monkeypatch, capsys):
+    routes()
+    target = tmp_path / '.env'
+    original = 'MLSPACE_READONLY=true\n'
+    target.write_text(original)
+    monkeypatch.setattr('mlspace_mcp.init_cli._clients', lambda *a: {'opencode': '/bin/true'})
+    monkeypatch.setattr('mlspace_mcp.init_cli.server_command', lambda: ['/bin/echo'])
+    def fail_save(*a):
+        raise PermissionError('sensitive detail should not be printed')
+    monkeypatch.setattr('mlspace_mcp.init_cli._write', fail_save)
+    assert run_init(target, force=True, base_url=BASE, non_interactive=True,
+                    from_env=True, workspace_ids=['ws2']) == 1
+    assert target.read_text() == original
+    assert (tmp_path / '.config/opencode/opencode.json').exists()
+    error = capsys.readouterr().err
+    assert 'MCP and skills installed: opencode' in error
+    assert 'credentials could not be saved' in error
+    assert str(target) in error and '--force' in error
+    assert 'sensitive detail' not in error
+
+
+@respx.mock
+def test_existing_opencode_can_update_without_cli_or_client_selection(tmp_path, monkeypatch):
+    from mlspace_mcp import client_setup
+    routes()
+    target = tmp_path / '.env'
+    client_setup.install_clients({'opencode': '/missing/opencode'}, target, ['runtime-v1'])
+    monkeypatch.setattr(client_setup, 'detect_clients', lambda: {})
+    monkeypatch.setattr('mlspace_mcp.init_cli.detect_clients', lambda: {})
+    monkeypatch.setattr('mlspace_mcp.init_cli.server_command', lambda: ['runtime-v2'])
+    assert run_init(target, force=True, base_url=BASE, non_interactive=True,
+                    from_env=True, workspace_ids=['ws2']) == 0
+    config = json.loads((tmp_path / '.config/opencode/opencode.json').read_text())
+    assert config['mcp']['mlspace']['command'] == ['runtime-v2']
+
+
+def test_deleted_connections_are_not_automatically_recreated(tmp_path, monkeypatch):
+    from mlspace_mcp.client_setup import install_clients
+    from mlspace_mcp.init_cli import _clients
+    install_clients({'opencode': '/bin/true'}, tmp_path / '.env', ['runtime-v1'])
+    (tmp_path / '.config/opencode/opencode.json').write_text('{}')
+    monkeypatch.setattr('mlspace_mcp.init_cli.detect_clients', lambda: {'opencode': '/bin/true'})
+    with pytest.raises(ValueError, match='Select a new connection explicitly'):
+        _clients([], [], True)
+    assert _clients(['opencode'], [], True) == {'opencode': '/bin/true'}

mlspace_plugin-0.2.1/.gitignore

@@ -1,53 +0,0 @@
-# Python
-__pycache__/
-*.py[cod]
-*.egg-info/
-.eggs/
-build/
-dist/
-.venv/
-venv/
-
-# Tooling
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
-
-# Env / secrets
-.env
-.env.*
-!.env.example
-*.secret
-
-# OS
-.DS_Store
-
-# Local audit harnesses & artifacts (not part of the shipped product)
-scripts/write_audit.py
-scripts/api_audit.py
-scripts/coverage_probe.py
-docs/_*.json
-docs/_*.png
-_planning/api_evidence.txt
-_planning/api_critique_and_prompts.json
-
-# Agent worktrees (local scratch, never part of the product)
-.claude/
-.superpowers/
-
-# Internal audit & planning artefacts (not part of the published server)
-audit/
-after_audit/
-_planning/
-docs/proposals/
-docs/superpowers/
-docs/DESIGN.md
-docs/MLSPACE_API_*.md
-docs/LLM_FRIENDLINESS_AUDIT.md
-docs/E2E_TEST_REPORT.md
-docs/EXEC_SUMMARY.md
-docs/article_*.md
-docs/slides*.md
-docs/_*.json