elemctl 0.1.0__tar.gz → 0.2.0__tar.gz

elemctl-0.2.0/.env.example

@@ -0,0 +1,9 @@
+# Подключение к Console API (обязательные)
+ELEMENT_BASE_URL=https://1cmycloud.com
+ELEMENT_CLIENT_ID=
+ELEMENT_CLIENT_SECRET=
+
+# Значения по умолчанию (необязательные)
+ELEMENT_APP_ID=
+ELEMENT_PROJECT_ID=
+ELEMENT_SPACE_ID=

elemctl-0.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include NOTICE
+include ORIGIN.md
+include .env.example
+recursive-include docs *.md

elemctl-0.2.0/NOTICE

@@ -0,0 +1,19 @@
+elemctl
+Copyright 2026 KeyFire
+
+Licensed under the MIT License (see LICENSE).
+
+This software is a command-line tool, MCP server and Python library for the
+1C:Enterprise.Element (1cmycloud) Console API v2.
+
+"1C", "1C:Enterprise", "1C:Enterprise.Element" and "1cmycloud" are trademarks and/or
+product names of their respective owners (1C Company and its affiliates). They are used
+in this project for descriptive purposes only, to indicate the platform the tool is
+compatible with.
+
+This project is an independent development. It is NOT affiliated with, endorsed by,
+sponsored by or supported by 1C Company.
+
+The library depends only on the Python standard library. The optional MCP server extra
+(elemctl[mcp]) uses the "mcp" package (MIT). Platform credentials are issued by the
+platform to its own users and are not redistributed by this project.

elemctl-0.2.0/ORIGIN.md

@@ -0,0 +1,52 @@
+# Origin
+
+elemctl is an independent, **clean-room** implementation, written from scratch.
+
+## What it is built from
+
+- a written specification of the platform's external interface (`docs/SPEC.md`), which
+  records **facts about the 1C:Enterprise.Element (1cmycloud) Console API v2 contract**,
+  the build-file formats (`.xasm` / `.xlib`) and the product requirements — and nothing
+  else, and
+- the **Python standard library**.
+
+The API facts in the specification come from three first-hand sources:
+
+1. **The platform's own Console API reference** — the Element help shipped by the
+   platform itself, with a page per endpoint (e.g. `POST /console/api/v2/applications`),
+   under <https://1cmycloud.com/console/help/element/9.2/docs/console/>. The help is
+   provided to platform users; at the time of writing it opens after signing in with a
+   platform account.
+2. **The management console UI**, which every platform user has access to.
+3. **Observation of the author's own requests and responses** while using the platform
+   under the author's own account. This covers behavioral details the reference does not
+   describe (e.g. the silent rollback on a failed project update).
+
+No documentation beyond what the platform provides to its users was used. The tool talks
+only to the documented Console API v2; internal (undocumented) console APIs are neither
+called nor described anywhere in this repository.
+
+No other tool's source code was read or copied. The implementation was designed from the
+specification alone.
+
+## What is definitely NOT in it
+
+- **No third-party source code.** Nothing was ported or copied from any other
+  repository — public, private or corporate.
+- **No platform code.** No decompilation, disassembly or other reverse engineering of
+  1C:Enterprise.Element components was performed; the platform's own client or server
+  code was never used or examined.
+- **No reproduced proprietary materials.** The platform vendor's documentation and other
+  materials are not quoted or reproduced.
+- **No secrets and no ties to anyone's infrastructure.** The code and the git history
+  contain no tokens, passwords, internal addresses, or identifiers of specific
+  applications, projects or stands.
+
+## Credentials and runtime
+
+Access to the platform uses `Client-Id` / `Client-Secret` credentials that the platform
+issues to its own users in its management console. elemctl ships no credentials and
+redistributes nothing belonging to the platform.
+
+At runtime the library depends only on the Python standard library. The MCP server is an
+optional extra (`elemctl[mcp]`) and uses the `mcp` package (FastMCP).

{elemctl-0.1.0/src/elemctl.egg-info → elemctl-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.1.0
+Version: 0.2.0
 Summary: CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)
 Author: KeyFire
 License-Expression: MIT
@@ -55,8 +55,7 @@ platform's audience - but the CLI output is plain JSON.*
   в архив сборки с манифестом и git-метаданными, автоинкремент версии.
 - **Деплой одной командой**: сборка -> загрузка -> применение -> перезапуск ->
   **проверка фактического применения**.
-- **Ветки среды разработки**: список, создание, привязка к приложению, merge,
-  загрузка изменений из git-ветки.
+- **Ветки среды разработки**: список, создание, привязка к приложению, merge.
 - **Дампы**: создание и контроль готовности.
 - **MCP-сервер**: те же операции как инструменты для AI-агентов
   (Claude Code и другие MCP-клиенты).
@@ -100,7 +99,6 @@ pip install "elemctl[mcp]"      # с MCP-сервером
 | `ELEMENT_APP_ID` | приложение по умолчанию (необязательно) |
 | `ELEMENT_PROJECT_ID` | проект по умолчанию (необязательно) |
 | `ELEMENT_SPACE_ID` | пространство по умолчанию (необязательно) |
-| `ELEMENT_BRANCH_ID` | ветка платформы по умолчанию (необязательно) |
 
 Client-Id/Client-Secret выпускаются в панели управления 1cmycloud
 (раздел интеграций Console API). Шаблон файла - [.env.example](.env.example).
@@ -179,9 +177,8 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
 
 - Инструмент **неофициальный** и не аффилирован с фирмой "1С"; Console API
   может меняться без предупреждения.
-- Операция `branches sync` (загрузка изменений из git-ветки в приложение)
-  использует внутренний UI API платформы, а не Console API v2 - контракт
-  наименее стабильный.
+- Используется только документированный Console API v2 - внутренние API
+  консоли платформы инструмент не вызывает и не описывает.
 - Создание приложения только по `--project-id` на части конфигураций платформы
   даёт пустой каркас без данных проекта. Надёжный путь - источник-сборка:
   `elemctl apps create <имя> --project-id <id> --latest-build` (MCP-инструмент
@@ -196,6 +193,12 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
   "Мягкой" очистки данных приложения в Console API нет, она выполняется в
   консоли управления.
 
+## Происхождение и правовые заметки
+
+Код написан с нуля по спецификации внешнего интерфейса платформы - процесс и
+гарантии описаны в [ORIGIN.md](ORIGIN.md). Товарные знаки и отсутствие
+аффилиации с фирмой "1С" - в файле [NOTICE](NOTICE).
+
 ## Лицензия
 
 [MIT](LICENSE)

{elemctl-0.1.0 → elemctl-0.2.0}/README.md

@@ -27,8 +27,7 @@ platform's audience - but the CLI output is plain JSON.*
   в архив сборки с манифестом и git-метаданными, автоинкремент версии.
 - **Деплой одной командой**: сборка -> загрузка -> применение -> перезапуск ->
   **проверка фактического применения**.
-- **Ветки среды разработки**: список, создание, привязка к приложению, merge,
-  загрузка изменений из git-ветки.
+- **Ветки среды разработки**: список, создание, привязка к приложению, merge.
 - **Дампы**: создание и контроль готовности.
 - **MCP-сервер**: те же операции как инструменты для AI-агентов
   (Claude Code и другие MCP-клиенты).
@@ -72,7 +71,6 @@ pip install "elemctl[mcp]"      # с MCP-сервером
 | `ELEMENT_APP_ID` | приложение по умолчанию (необязательно) |
 | `ELEMENT_PROJECT_ID` | проект по умолчанию (необязательно) |
 | `ELEMENT_SPACE_ID` | пространство по умолчанию (необязательно) |
-| `ELEMENT_BRANCH_ID` | ветка платформы по умолчанию (необязательно) |
 
 Client-Id/Client-Secret выпускаются в панели управления 1cmycloud
 (раздел интеграций Console API). Шаблон файла - [.env.example](.env.example).
@@ -151,9 +149,8 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
 
 - Инструмент **неофициальный** и не аффилирован с фирмой "1С"; Console API
   может меняться без предупреждения.
-- Операция `branches sync` (загрузка изменений из git-ветки в приложение)
-  использует внутренний UI API платформы, а не Console API v2 - контракт
-  наименее стабильный.
+- Используется только документированный Console API v2 - внутренние API
+  консоли платформы инструмент не вызывает и не описывает.
 - Создание приложения только по `--project-id` на части конфигураций платформы
   даёт пустой каркас без данных проекта. Надёжный путь - источник-сборка:
   `elemctl apps create <имя> --project-id <id> --latest-build` (MCP-инструмент
@@ -168,6 +165,12 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
   "Мягкой" очистки данных приложения в Console API нет, она выполняется в
   консоли управления.
 
+## Происхождение и правовые заметки
+
+Код написан с нуля по спецификации внешнего интерфейса платформы - процесс и
+гарантии описаны в [ORIGIN.md](ORIGIN.md). Товарные знаки и отсутствие
+аффилиации с фирмой "1С" - в файле [NOTICE](NOTICE).
+
 ## Лицензия
 
 [MIT](LICENSE)

elemctl-0.2.0/docs/SPEC.md

@@ -0,0 +1,332 @@
+# Спецификация elemctl
+
+Документ описывает контракт Console API v2 платформы 1С:Предприятие.Элемент
+(1cmycloud.com), формат файлов сборки и требования к инструменту elemctl.
+Спецификация содержит только факты об интерфейсе платформы и требования к
+продукту - реализация проектируется с нуля.
+
+## 1. Назначение и состав пакета
+
+Python-пакет `elemctl` из трёх слоёв поверх общего ядра:
+
+1. **Библиотека** - программный клиент Console API v2 и операции высокого
+   уровня (сборка, деплой). Только стандартная библиотека Python.
+2. **CLI** - консольная команда `elemctl` (entry point `elemctl` в
+   `[project.scripts]`).
+3. **MCP-сервер** - те же операции как инструменты для AI-агентов; транспорт
+   stdio; зависимость `mcp>=1.2` подключается как optional extra
+   `elemctl[mcp]` (используется FastMCP из пакета `mcp`).
+
+Требования пакета: имя `elemctl`, версия 0.1.0, Python >= 3.10, лицензия MIT,
+автор KeyFire, layout `src/elemctl/`, extra `dev` с pytest. Файлы LICENSE,
+README.md, .env.example и .gitignore предоставлены заказчиком и не меняются.
+
+## 2. Конфигурация подключения
+
+Параметры берутся из трёх источников, по убыванию приоритета:
+
+1. явные аргументы (флаги CLI `--base-url`, `--client-id`, `--client-secret`);
+2. переменные окружения;
+3. .env-файл: путь из флага `--env-file`, а без него - файл `.env` в текущем
+   каталоге, если существует.
+
+Переменные окружения:
+
+| Переменная | Смысл | Обязательна |
+|---|---|---|
+| `ELEMENT_BASE_URL` | базовый URL платформы, например `https://1cmycloud.com` | да |
+| `ELEMENT_CLIENT_ID` | Client-Id для получения токена | да |
+| `ELEMENT_CLIENT_SECRET` | Client-Secret | да |
+| `ELEMENT_APP_ID` | приложение по умолчанию | нет |
+| `ELEMENT_PROJECT_ID` | проект по умолчанию | нет |
+| `ELEMENT_SPACE_ID` | пространство по умолчанию | нет |
+
+Формат .env: строки `KEY=VALUE`; пустые строки и строки с `#` в начале
+пропускаются; допускается префикс `export ` и одинарные/двойные кавычки
+вокруг значения; кодировка UTF-8, возможен BOM (читать как `utf-8-sig`).
+Хвостовой слэш у `ELEMENT_BASE_URL` обрезается.
+
+## 3. Аутентификация
+
+Получение токена: `POST {base}/console/sys/token`
+
+- заголовок `Authorization: Basic base64(client_id:client_secret)`;
+- тело `grant_type=client_credentials`, Content-Type
+  `application/x-www-form-urlencoded`.
+
+Ответ - JSON-объект; токен лежит в первом непустом из полей `id_token`,
+`token`, `value`, `access_token`. Особый случай: значение `access_token`
+может быть строкой `"Not implemented"` - это не токен, поле игнорировать.
+
+Все прочие запросы - с заголовком `Authorization: Bearer {токен}`.
+
+Токен живёт около часа: кешировать его в файле в системном каталоге временных
+файлов (`tempfile.gettempdir()`, НЕ жёсткий `/tmp` - инструмент работает и на
+Windows) с TTL 1 час; ключ кеша должен различать пары base_url + client_id.
+При ответе 401 обновить токен принудительно и повторить запрос один раз.
+
+## 4. Контракт Console API v2
+
+Общий префикс: `{base}/console/api/v2`. Тела запросов и ответов - JSON
+(кроме загрузки сборки). Имена полей - в kebab-case.
+
+### 4.1. Приложения
+
+- `GET /applications` - список; необязательный query `name` (фильтр).
+- `GET /applications/{id}` - карточка. Значимые поля ответа: `id`, `status`,
+  `uri` (адрес работающего приложения), `error` (текст ошибки, если есть),
+  `technology-version`, `date-updated`, `display-name`,
+  `publication-context`, `source` (объект с информацией об источнике,
+  содержит в т.ч. `project-version` - версию применённой сборки).
+- `POST /applications` - создать. Тело:
+  - `source` - объект `{"type": "repository"}` плюс ровно один из ключей:
+    `project-version-id` (id сборки-источника) либо `image-id` (id проекта);
+  - `display-name`, `publication-context` - имя и путь публикации;
+  - `development-mode` - булево, создавать ли среду разработки;
+  - необязательные `space-id`, `technology-version`.
+- `DELETE /applications/{id}` - удалить.
+- `PUT /applications/{id}/status/start` - запустить.
+- `PUT /applications/{id}/status/stop` - остановить.
+- `POST /applications/{id}/project/update` - применить сборку к приложению.
+  Тело: `{"source": {"type": "repository", "image-id": "<id сборки>"}}`
+  либо `{"source": {"type": "repository", "project-id": "<id>",
+  "assembly-version": "<версия>"}}` (assembly-version необязательна).
+- `POST /applications/{id}/dumps` - создать дамп. Тело: `include-users`,
+  `include-binary-data` (булевы), `description` (строка).
+- `GET /applications/{id}/dumps/{dumpId}` - статус дампа.
+
+Статусы приложения: стабильные `Running`, `Stopped`, `Error`; переходные
+`Starting`, `Stopping`, `Initializing`, `Updating`, `Frozen`, `Creating`.
+Во время переходов поле `status` может быть и пустым.
+
+### 4.2. Версия технологии
+
+- Чтение - из поля `technology-version` карточки приложения (отдельный
+  endpoint чтения есть не во всех версиях платформы - не использовать).
+- Обновление: `POST /tasks/group-tasks/update-applications-technology`,
+  тело `{"technology-version": "<версия>", "applications": ["<app-id>"]}`.
+  Возвращает групповую задачу; её статус - `GET /tasks/group-tasks/{taskId}`.
+
+### 4.3. Пространства и проекты
+
+- `GET /spaces` - список пространств.
+- `GET /projects` - список проектов; `GET /projects/{id}` - карточка;
+  `DELETE /projects/{id}` - удаление.
+
+### 4.4. Сборки проекта (assemblies)
+
+- Загрузка файла сборки - бинарный POST (Content-Type
+  `application/octet-stream`, тело - байты файла):
+  - `POST /projects/{id}/assemblies` - добавить сборку в существующий проект;
+  - `POST /projects` - создать новый проект из сборки.
+  Query-параметры (все необязательные): `SpaceId`, `BranchName`, `CommitId`,
+  `CommitMessage`. Внимание: имена этих query-параметров - в PascalCase.
+  Ответ содержит id созданной сборки в одном из полей: `image-id`,
+  `assembly-id` или `id` (проверять в этом порядке).
+- `GET /projects/{id}/assemblies` - список сборок. Элемент содержит
+  `assembly-version` (строка вида `1.0-42`) и id (`id` либо `image-id`).
+  Ответ может быть как массивом, так и объектом со списком в поле `items`
+  или `assemblies`.
+- `GET /projects/{id}/assemblies/{version}` - карточка сборки по версии;
+  `DELETE .../{version}` - удаление.
+
+Сравнение версий сборок: по числовому суффиксу после последнего дефиса
+(`1.0-10` новее `1.0-9`; лексикографическое сравнение даёт неверный порядок).
+
+### 4.5. Ветки среды разработки
+
+- `GET /branches` - список; необязательные query `project-id`, `name`.
+- `GET /branches/{id}` - карточка. Поля: `name`, `kind`, `project`,
+  `application`, `source-branch`, `deletion-mark`, `version-stamp`.
+- `POST /branches` - создать. Тело: `name`, `kind: "development"`,
+  `project: {"id": "<id>"}`, необязательно `application: {"id": "<id>"}`.
+- `PUT /branches/{id}` - изменить. Платформа использует оптимистическую
+  блокировку: сначала прочитать карточку, затем отправить тело, собранное из
+  текущих значений - `name`, `kind`, `deletion-mark`, `version-stamp`
+  (обязательно вернуть как есть), `source-branch` и `application` - свернуть
+  до `{"id": ...}` (или `{"name": ...}`, если id нет). Для перепривязки к
+  приложению заменить `application` на `{"id": "<новый app-id>"}`.
+- Принятие изменений ветки (merge) - тот же `PUT /branches/{id}` с
+  дополнительным ключом тела `write-parameters: {"merge": true}`.
+- `DELETE /branches/{id}` - удалить ветку.
+
+Инструмент работает ТОЛЬКО с документированным Console API v2. Внутренние
+(недокументированные) API консоли платформы не используются и не описываются.
+
+### 4.6. Задачи приложений
+
+`GET /tasks/application-tasks` - список задач всех приложений (серверного
+фильтра нет - фильтровать на клиенте). Поля задачи: `id`, `application-id`,
+`status` (в т.ч. `Error`, `Failed`), `operation-type`, `error-message`,
+`start-date` (ISO 8601, может оканчиваться на `Z`).
+
+## 5. Формат файла сборки (.xasm / .xlib)
+
+Файл сборки - ZIP-архив (deflate):
+
+- в корне `Assembly.yaml` - манифест, плоские пары ключ-значение:
+
+  ```
+  ManifestVersion: 1.0
+  ProjectKind: Application | Library
+  Vendor: <поставщик>
+  Name: <имя проекта>
+  Version: <версия, например 1.0-42>
+  Created: <UTC, формат YYYY.MM.DD HH:MM:SS>
+  BranchName: <имя git-ветки>
+  CommitId: <хэш коммита>
+  ```
+
+  Для библиотеки (`ProjectKind: Library`) в конце добавляется строка
+  `Release:` (пустое значение); расширение файла `.xlib`, для приложения -
+  `.xasm`.
+
+- далее файлы проекта путями `{vendor}/{name}/...` - относительно корня
+  репозитория. Каталог проекта обязан лежать по схеме
+  `{repo}/{vendor}/{name}/Проект.yaml`. Разделители путей в архиве - прямые
+  слэши (и на Windows).
+
+Имя файла сборки: `{Имя} {Version}.xasm` (через пробел).
+
+Метаданные проекта - из `Проект.yaml` (YAML, достаточно разбора плоских пар
+`ключ: значение` верхнего уровня, вложенные строки с отступом пропускать):
+`Имя`, `Поставщик`, `Версия` (базовая, например `1.0`), `ВидПроекта`
+(значение `Библиотека` означает библиотеку, иначе приложение).
+
+Версия сборки, если не задана явно: `{базовая версия}-{N+1}`, где N - счётчик
+из версии последней сборки проекта; если сборок нет - `{базовая версия}-1`.
+
+Git-метаданные (хэш коммита, имя ветки) - из git-репозитория, содержащего
+каталог проекта; при недоступности git оставить пустыми.
+
+Отбор файлов в архив:
+
+- включаются только расширения: `.yaml .xbsl .xbql .md .txt .json`
+  (исходники), `.png .svg .jpg .jpeg .gif .webp .ico` (изображения),
+  `.css .html .js .woff .woff2 .ttf .eot` (веб-ресурсы);
+- исключаются каталоги `.git`, `.claude`, `.github`, `__pycache__`,
+  `node_modules`, `.venv` и все скрытые (начинающиеся с точки);
+- исключаются файлы `.gitignore`, `.env`, `.DS_Store` и файлы `*.xasm`,
+  `*.xlib`.
+
+## 6. Поведенческие особенности платформы (обязательны к учёту)
+
+1. **Тихий откат применения.** Если применение сборки к приложению падает
+   (например, ошибка компиляции), платформа молча откатывает приложение на
+   предыдущую сборку и запускает его - статус `Running` НЕ означает успех.
+   Достоверная проверка результата деплоя:
+   - задачи приложения (п. 4.6) со статусом `Error`/`Failed`, у которых
+     `start-date` не раньше момента начала деплоя (старые ошибки из истории
+     не учитывать!);
+   - сверка фактически применённой версии (`source.project-version` карточки
+     приложения) с версией загруженной сборки;
+   - информационно - контрольный GET по `uri` приложения (коды 401/403
+     нормальны для закрытых приложений и успеху не противоречат).
+2. **Пустой каркас при создании.** Создание приложения с источником "проект"
+   (`image-id` = id проекта) на части конфигураций платформы даёт пустое
+   приложение без данных проекта. Надёжный источник - конкретная сборка
+   (`project-version-id`), например последняя сборка проекта.
+3. **Удаление с черновиками.** Если в среде разработки приложения есть
+   неопубликованные правки, `DELETE /applications/{id}` возвращает 400 с
+   `FAILED_PRECONDITION` в теле. Принудительного удаления в API нет - только
+   панель управления; инструмент обязан дать понятную подсказку.
+4. **Готовность нового приложения.** После создания приложение какое-то время
+   в переходных статусах и без `uri` - предусмотреть ожидание готовности
+   (появился `uri` и стабильный статус). Статус `Error` при ожидании -
+   немедленная ошибка.
+5. **Перезапуск после применения.** `project/update` может сам перезапустить
+   приложение. После вызова дождаться выхода из переходных статусов; если
+   итог не `Running` - остановить (если не `Stopped`), дождаться `Stopped`,
+   запустить, дождаться `Running`. Разумные таймауты: ожидание остановки
+   ~3 мин, запуска/стабилизации ~5 мин, опрос каждые ~10 с.
+6. **Windows.** Временные файлы и кеши - только через `tempfile`; вывод
+   консоли перевести в UTF-8 (`reconfigure` для stdout/stderr), иначе
+   кириллица ломается.
+
+## 7. Требования к CLI
+
+Общие флаги (до подкоманды): `--base-url`, `--client-id`, `--client-secret`,
+`--env-file`, `--timeout` (сек, по умолчанию 60), `--version`.
+
+Вывод: результат - JSON в stdout (`ensure_ascii=False`, отступ 2); прогресс
+длительных операций - строки в stderr; ошибки - JSON с полем `error` в
+stderr и код возврата 1.
+
+Команды (в скобках - существенные флаги):
+
+- `token` - получить и напечатать токен.
+- `apps list [--name]`, `apps get [APP_ID]`, `apps find NAME`,
+  `apps create NAME [--project-id --version-id --latest-build --space-id
+  --tech-version --no-dev-mode --wait]`, `apps delete APP_ID`,
+  `apps start [APP_ID]`, `apps stop [APP_ID]`.
+  - `apps find` ищет по точному совпадению (без учёта регистра) имени среди
+    полей `name`, `display-name`, `publication-context`; вывод
+    `{"id": ..., "found": true|false}`, код возврата 1 если не найдено.
+  - `--latest-build` - взять источником последнюю сборку проекта (защита от
+    пустого каркаса, п. 6.2); `--wait` - дождаться готовности (п. 6.4) и
+    вывести финальную карточку.
+- `spaces list`.
+- `projects list`, `projects get [PROJECT_ID]`, `projects delete PROJECT_ID`.
+- `builds list [--project-id]`, `builds get VERSION [--project-id]`,
+  `builds upload FILE [--project-id --space-id --branch --commit
+  --commit-message]`, `builds delete VERSION [--project-id]`.
+- `build [--project-dir --output --build-version --last-build --commit
+  --branch --kind {application,library}]` - локально собрать архив, вывести
+  `{"file": путь}`. Без `--project-dir` каталог проекта ищется автоматически
+  (первый каталог с `Проект.yaml` вглубь от текущего). `--kind` по умолчанию
+  определяется по `ВидПроекта`.
+- `deploy [--app-id --project-id --project-dir --output --build-version
+  --branch --commit --commit-message --dry-run]` -
+  полный цикл: сборка -> загрузка -> применение -> перезапуск -> проверка
+  фактического применения (п. 6.1). Вывод - JSON-отчёт с полями: `app-id`,
+  `uri`, `status`, `version`, `assembly-id`, `applied-version`, `applied`
+  (true/false/null - null когда фактическую версию определить не удалось),
+  `uri-status`, `problems` (список строк), `ok` (булево). Код возврата 0
+  только при `ok`. `--dry-run` - только сборка.
+- `branches list [--project-id --name]`, `branches get ID`,
+  `branches create NAME [--project-id --app-id]`,
+  `branches update ID [--app-id]`, `branches delete ID`,
+  `branches merge ID`.
+- `dumps create [APP_ID] [--description]`, `dumps get APP_ID DUMP_ID`.
+- `tasks list [--app-id]`, `tasks get-group TASK_ID`.
+- `tech get [APP_ID]`, `tech set APP_ID VERSION`.
+- `mcp` - запустить MCP-сервер; без установленного extra - понятная ошибка
+  с подсказкой `pip install "elemctl[mcp]"`.
+
+Позиционные APP_ID/PROJECT_ID, помеченные выше как необязательные, при
+отсутствии берутся из конфигурации (`ELEMENT_APP_ID`/`ELEMENT_PROJECT_ID`);
+если и там пусто - ошибка.
+
+## 8. Требования к MCP-серверу
+
+Имя сервера `elemctl`, транспорт stdio, реквизиты - из тех же переменных
+окружения/.env. В instructions сервера предупредить о тихом откате применения
+(п. 6.1). Инструменты (докстринги - краткие, по-русски):
+
+`list_apps(name="")`, `get_app(app_id)`, `find_app(name)`,
+`create_app(name, project_id="", version_id="", space_id="",
+development_mode=True)` - при задании только project_id источником
+автоматически берётся последняя сборка проекта (п. 6.2);
+`start_app(app_id)`, `stop_app(app_id)`, `delete_app(app_id)` (в докстринге -
+предупреждение о необратимости и смене URL), `list_spaces()`,
+`list_projects()`, `list_builds(project_id)`,
+`build_assembly(project_dir="", output_dir="", version="")`,
+`deploy(app_id, project_id, project_dir="", version="", branch="",
+commit_message="")` - возвращает отчёт деплоя плюс поле `log` со строками
+прогресса; `apply_build(app_id, version_id)`, `verify_deploy(app_id,
+expected_version="", since_minutes=30)` - проверка применения по п. 6.1;
+`list_app_tasks(app_id="")`, `list_branches(project_id="", name="")`,
+`merge_branch(branch_id)`.
+
+## 9. Требования к качеству
+
+- Тесты pytest без обращений к сети: разбор .env и приоритеты конфигурации,
+  отбор файлов и содержимое архива сборки (включая манифест), автоинкремент
+  и числовое сравнение версий, логика итога деплоя (`ok`/`applied`),
+  подсказка при `FAILED_PRECONDITION`, поиск приложения по имени.
+- Докстринги и комментарии - литературный русский; кавычки в тексте прямые
+  `"`, тире - среднее `–` (не длинное), многоточие - три точки `...`.
+- Библиотека не печатает в stdout/stderr сама - прогресс отдаётся через
+  передаваемый вызывающей стороной callback.
+- Ошибки API - собственное исключение с деталями ответа сервера
+  (сериализуемыми в JSON).

{elemctl-0.1.0 → elemctl-0.2.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "elemctl"
-version = "0.1.0"
+version = "0.2.0"
 description = "CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)"
 readme = "README.md"
 requires-python = ">=3.10"

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/__init__.py

@@ -11,7 +11,7 @@ from .client import ElementClient
 from .config import Config
 from .errors import ApiError, BuildError, ConfigError, ElemctlError, TransportError
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 __all__ = [
     "ApiError",

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/cli.py

@@ -16,7 +16,7 @@ from . import __version__
 from .build import build_assembly
 from .client import ElementClient, extract_assembly_id
 from .config import Config
-from .deploy import deploy_from_platform_branch, deploy_from_sources
+from .deploy import deploy_from_sources
 from .errors import ApiError, ConfigError, ElemctlError
 
 
@@ -279,26 +279,21 @@ def cmd_deploy(args):
     config = _config(args)
     client = make_client(config)
     app_id = _require(args.app_id, config.app_id, "--app-id (или ELEMENT_APP_ID)")
-
-    if args.from_branch:
-        branch_id = _require(args.branch_id, config.branch_id, "--branch-id (или ELEMENT_BRANCH_ID)")
-        report = deploy_from_platform_branch(client, app_id, branch_id, log=_progress)
-    else:
-        project_id = _require(
-            args.project_id, config.project_id, "--project-id (или ELEMENT_PROJECT_ID)"
-        )
-        report = deploy_from_sources(
-            client,
-            app_id,
-            project_id,
-            project_dir=args.project_dir,
-            output_dir=args.output,
-            version=args.build_version or "",
-            branch=args.branch,
-            commit=args.commit,
-            commit_message=args.commit_message or "",
-            log=_progress,
-        )
+    project_id = _require(
+        args.project_id, config.project_id, "--project-id (или ELEMENT_PROJECT_ID)"
+    )
+    report = deploy_from_sources(
+        client,
+        app_id,
+        project_id,
+        project_dir=args.project_dir,
+        output_dir=args.output,
+        version=args.build_version or "",
+        branch=args.branch,
+        commit=args.commit,
+        commit_message=args.commit_message or "",
+        log=_progress,
+    )
     _emit(report.to_dict())
     return 0 if report.ok else 1
 
@@ -345,16 +340,6 @@ def cmd_branches_merge(args):
     return 0
 
 
-def cmd_branches_sync(args):
-    config = _config(args)
-    client = make_client(config)
-    branch_id = _require(args.branch_id, config.branch_id, "branch-id (аргумент ID или ELEMENT_BRANCH_ID)")
-    app_id = _require(args.app_id, config.app_id, "--app-id (или ELEMENT_APP_ID)")
-    response = client.sync_branch(app_id, branch_id)
-    _emit(response if response is not None else {"ok": True, "app-id": app_id, "branch-id": branch_id})
-    return 0
-
-
 def cmd_dumps_create(args):
     config = _config(args)
     client = make_client(config)
@@ -537,8 +522,6 @@ def build_parser():
     p.add_argument("--branch", help="имя ветки в метаданные (по умолчанию из git)")
     p.add_argument("--commit", help="хэш коммита в метаданные (по умолчанию из git)")
     p.add_argument("--commit-message", help="сообщение коммита (метаданные загрузки)")
-    p.add_argument("--from-branch", action="store_true", help="вместо сборки исходников – загрузка из git-ветки платформы")
-    p.add_argument("--branch-id", help="ветка платформы для --from-branch (или ELEMENT_BRANCH_ID)")
     p.add_argument("--dry-run", action="store_true", help="только сборка, без загрузки")
     p.set_defaults(handler=cmd_deploy)
 
@@ -574,13 +557,6 @@ def build_parser():
     p.add_argument("branch_id", metavar="ID")
     p.set_defaults(handler=cmd_branches_merge)
 
-    p = branches_sub.add_parser(
-        "sync", help="загрузить изменения из git-ветки платформы в приложение (внутренний UI API)"
-    )
-    p.add_argument("branch_id", nargs="?", metavar="ID")
-    p.add_argument("--app-id")
-    p.set_defaults(handler=cmd_branches_sync)
-
     # dumps ----------------------------------------------------------------
     dumps = sub.add_parser("dumps", help="дампы приложений")
     dumps_sub = dumps.add_subparsers(dest="subcommand", metavar="действие", required=True)

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/client.py

@@ -423,32 +423,6 @@ class ElementClient:
         """Удалить ветку."""
         return self._api("DELETE", f"/branches/{branch_id}")
 
-    def sync_branch(self, app_id, branch_id):
-        """Загрузить изменения из git-ветки платформы в приложение.
-
-        Внимание: это внутренний UI API консоли (не Console API v2),
-        его контракт наименее стабильный.
-        """
-        body = {
-            "module": "e1c::console::Applications::ApplicationConfigurationUpdateForm",
-            "method": "UpdateAppConfiguration",
-            "params": [
-                {
-                    "type": "e1c::console::Applications::Applications.Reference",
-                    "value": app_id,
-                },
-                {
-                    "type": "e1c::console::Team::Branches.Reference",
-                    "value": branch_id,
-                },
-                {"type": "Std::Boolean", "value": False},
-                {"type": "Std::Boolean", "value": False},
-            ],
-        }
-        return self._request(
-            "POST", "/console/ui/module/call", query={"locale": "ru"}, json_body=body
-        )
-
     # -- задачи приложений ----------------------------------------------------
 
     def list_app_tasks(self, app_id=""):

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/config.py

@@ -20,7 +20,6 @@ ENV_KEYS = {
     "app_id": "ELEMENT_APP_ID",
     "project_id": "ELEMENT_PROJECT_ID",
     "space_id": "ELEMENT_SPACE_ID",
-    "branch_id": "ELEMENT_BRANCH_ID",
 }
 
 DEFAULT_TIMEOUT = 60.0
@@ -63,7 +62,6 @@ class Config:
     app_id: str = ""
     project_id: str = ""
     space_id: str = ""
-    branch_id: str = ""
     timeout: float = field(default=DEFAULT_TIMEOUT)
 
     def __post_init__(self):

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/deploy.py

@@ -126,27 +126,6 @@ def deploy_from_sources(
     return report
 
 
-def deploy_from_platform_branch(client, app_id, branch_id, *, log=None):
-    """Деплой загрузкой изменений из git-ветки платформы (внутренний UI API).
-
-    Проверка применения та же, но без сверки версии (её у загрузки из
-    ветки нет), поэтому applied остаётся None.
-    """
-    log = log or (lambda message: None)
-    started_at = datetime.now(timezone.utc)
-
-    log(f"загружаем изменения из ветки {branch_id} в приложение {app_id}...")
-    client.sync_branch(app_id, branch_id)
-    log("загрузка запущена, ждём стабилизации приложения...")
-
-    card = client.ensure_running(app_id, log=log)
-    log("приложение в статусе Running, проверяем задачи приложения...")
-
-    report = _verify(client, app_id, card=card, expected_version="", since=started_at)
-    _log_outcome(report, log)
-    return report
-
-
 def verify_deploy(client, app_id, *, expected_version="", since=None, log=None):
     """Самостоятельная проверка применения (без деплоя).
 

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl/mcp_server.py

@@ -20,7 +20,6 @@ from .build import build_assembly
 from .client import ElementClient, extract_assembly_id
 from .config import Config
 from .deploy import (
-    deploy_from_platform_branch,
     deploy_from_sources,
     verify_deploy as _verify_deploy,
 )
@@ -159,15 +158,6 @@ def create_server(config=None):
         payload["log"] = lines
         return payload
 
-    @server.tool(name="deploy_from_platform_branch")
-    def deploy_from_platform_branch_tool(app_id: str, branch_id: str) -> dict:
-        """Загрузить изменения из git-ветки платформы в приложение и проверить итог (без сверки версии)."""
-        lines: list[str] = []
-        report = deploy_from_platform_branch(client(), app_id, branch_id, log=lines.append)
-        payload = report.to_dict()
-        payload["log"] = lines
-        return payload
-
     @server.tool()
     def apply_build(app_id: str, version_id: str) -> dict:
         """Применить загруженную сборку (по id) к приложению; после применения проверьте итог инструментом verify_deploy."""

{elemctl-0.1.0 → elemctl-0.2.0/src/elemctl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.1.0
+Version: 0.2.0
 Summary: CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)
 Author: KeyFire
 License-Expression: MIT
@@ -55,8 +55,7 @@ platform's audience - but the CLI output is plain JSON.*
   в архив сборки с манифестом и git-метаданными, автоинкремент версии.
 - **Деплой одной командой**: сборка -> загрузка -> применение -> перезапуск ->
   **проверка фактического применения**.
-- **Ветки среды разработки**: список, создание, привязка к приложению, merge,
-  загрузка изменений из git-ветки.
+- **Ветки среды разработки**: список, создание, привязка к приложению, merge.
 - **Дампы**: создание и контроль готовности.
 - **MCP-сервер**: те же операции как инструменты для AI-агентов
   (Claude Code и другие MCP-клиенты).
@@ -100,7 +99,6 @@ pip install "elemctl[mcp]"      # с MCP-сервером
 | `ELEMENT_APP_ID` | приложение по умолчанию (необязательно) |
 | `ELEMENT_PROJECT_ID` | проект по умолчанию (необязательно) |
 | `ELEMENT_SPACE_ID` | пространство по умолчанию (необязательно) |
-| `ELEMENT_BRANCH_ID` | ветка платформы по умолчанию (необязательно) |
 
 Client-Id/Client-Secret выпускаются в панели управления 1cmycloud
 (раздел интеграций Console API). Шаблон файла - [.env.example](.env.example).
@@ -179,9 +177,8 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
 
 - Инструмент **неофициальный** и не аффилирован с фирмой "1С"; Console API
   может меняться без предупреждения.
-- Операция `branches sync` (загрузка изменений из git-ветки в приложение)
-  использует внутренний UI API платформы, а не Console API v2 - контракт
-  наименее стабильный.
+- Используется только документированный Console API v2 - внутренние API
+  консоли платформы инструмент не вызывает и не описывает.
 - Создание приложения только по `--project-id` на части конфигураций платформы
   даёт пустой каркас без данных проекта. Надёжный путь - источник-сборка:
   `elemctl apps create <имя> --project-id <id> --latest-build` (MCP-инструмент
@@ -196,6 +193,12 @@ Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version,
   "Мягкой" очистки данных приложения в Console API нет, она выполняется в
   консоли управления.
 
+## Происхождение и правовые заметки
+
+Код написан с нуля по спецификации внешнего интерфейса платформы - процесс и
+гарантии описаны в [ORIGIN.md](ORIGIN.md). Товарные знаки и отсутствие
+аффилиации с фирмой "1С" - в файле [NOTICE](NOTICE).
+
 ## Лицензия
 
 [MIT](LICENSE)

{elemctl-0.1.0 → elemctl-0.2.0}/src/elemctl.egg-info/SOURCES.txt

@@ -1,6 +1,11 @@
+.env.example
 LICENSE
+MANIFEST.in
+NOTICE
+ORIGIN.md
 README.md
 pyproject.toml
+docs/SPEC.md
 src/elemctl/__init__.py
 src/elemctl/auth.py
 src/elemctl/build.py

{elemctl-0.1.0 → elemctl-0.2.0}/tests/test_cli.py

@@ -20,7 +20,6 @@ def clean_environment(monkeypatch, tmp_path):
         "ELEMENT_APP_ID",
         "ELEMENT_PROJECT_ID",
         "ELEMENT_SPACE_ID",
-        "ELEMENT_BRANCH_ID",
     ):
         monkeypatch.delenv(key, raising=False)
     monkeypatch.chdir(tmp_path)
@@ -30,7 +29,7 @@ def test_version_flag(capsys):
     with pytest.raises(SystemExit) as excinfo:
         cli.main(["--version"])
     assert excinfo.value.code == 0
-    assert "elemctl 0.1.0" in capsys.readouterr().out
+    assert "elemctl 0.2.0" in capsys.readouterr().out
 
 
 def test_build_command(project_factory, tmp_path, capsys):

{elemctl-0.1.0 → elemctl-0.2.0}/tests/test_client.py

@@ -175,21 +175,6 @@ def test_update_branch_optimistic_locking_and_merge(api):
     assert "project" not in body
 
 
-def test_sync_branch_ui_api_contract(api):
-    client, transport = api
-    transport.add("POST", "/console/ui/module/call", {"ok": True})
-
-    client.sync_branch("app-1", "br-1")
-
-    call = transport.calls_to("POST", "/console/ui/module/call")[0]
-    assert call["query"] == "locale=ru"
-    body = json.loads(call["data"].decode("utf-8"))
-    assert body["module"].endswith("ApplicationConfigurationUpdateForm")
-    assert body["method"] == "UpdateAppConfiguration"
-    assert body["params"][0]["value"] == "app-1"
-    assert body["params"][1]["value"] == "br-1"
-
-
 def test_list_app_tasks_client_side_filter(api):
     client, transport = api
     transport.add(

{elemctl-0.1.0 → elemctl-0.2.0}/tests/test_deploy.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from datetime import datetime, timedelta, timezone
 
-from elemctl.deploy import deploy_from_platform_branch, deploy_from_sources, verify_deploy
+from elemctl.deploy import deploy_from_sources, verify_deploy
 
 
 class FakeDeployClient:
@@ -42,9 +42,6 @@ class FakeDeployClient:
     def apply_build(self, app_id, **kwargs):
         self.apply_calls.append((app_id, kwargs))
 
-    def sync_branch(self, app_id, branch_id):
-        self.synced = (app_id, branch_id)
-
     def ensure_running(self, app_id, log=None):
         return self._card()
 
@@ -216,15 +213,6 @@ def test_report_to_dict_kebab_case(project_factory, tmp_path):
     assert payload["ok"] is True
 
 
-def test_deploy_from_platform_branch_no_version_check():
-    client = FakeDeployClient(applied_version="1.0-3")
-    report = deploy_from_platform_branch(client, "app-1", "br-1")
-    assert client.synced == ("app-1", "br-1")
-    # Сверки версии нет: applied остаётся None, итог по задачам.
-    assert report.applied is None
-    assert report.ok is True
-
-
 def test_verify_deploy_standalone():
     client = FakeDeployClient(applied_version="1.0-7")
     since = datetime.now(timezone.utc) - timedelta(minutes=30)

{elemctl-0.1.0 → elemctl-0.2.0}/tests/test_mcp.py

@@ -23,7 +23,6 @@ EXPECTED_TOOLS = {
     "list_builds",
     "build_assembly",
     "deploy",
-    "deploy_from_platform_branch",
     "apply_build",
     "verify_deploy",
     "list_app_tasks",