answer42 0.2.0__tar.gz → 0.2.1__tar.gz

{answer42-0.2.0 → answer42-0.2.1}/.gitignore

@@ -22,4 +22,4 @@ dist/
 
 # BSL Language Server report (created at repo root)
 bsl-json.json
-
+public/

{answer42-0.2.0 → answer42-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: answer42
-Version: 0.2.0
+Version: 0.2.1
 Summary: Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API
 Author: Marvin (AI Assistant), 42Clouds, and contributors
 Author-email: "Kosolapov Stanislav (proDOOMman)" <prodoomman@gmail.com>
@@ -35,7 +35,7 @@ Description-Content-Type: text/markdown
 # Answer42
 
 <p align="center">
-  <img src="docs/assets/answer42-logo.png" alt="Answer42 logo" width="220">
+  <img src="https://gitlab.com/platform42/answer42-mcp/-/raw/beta/docs/assets/answer42-logo.png" alt="Answer42 logo" width="220">
 </p>
 
 **Answer42** — MCP-инструмент для интерактивного управления UI **1С:Предприятия** через клиент тестирования. Он позволяет AI-агенту открывать формы 1С, нажимать кнопки, заполнять поля, выбирать ссылки из форм выбора, работать с таблицами, динамическими списками и табличными документами.
@@ -86,6 +86,48 @@ start_session(
 
 Логин/пароль рекомендуется **не передавать явно**: `start_session` умеет брать их из локального credentials-файла по `base_url`. Параметры `username`/`password` остаются в API для разовых сценариев и обратной совместимости, но при передаче в MCP-вызове они видны вызывающему агенту в аргументах tool-call.
 
+## Установка skills
+
+PyPI-пакет не записывает agent skills в пользовательские каталоги автоматически. После установки Answer42 поставьте bundled skills отдельной командой:
+
+```bash
+answer42 install-skills
+```
+
+По умолчанию команда устанавливает `answer42` и `answer42-rag` в OpenClaw:
+
+```text
+~/.openclaw/workspace/skills
+```
+
+Другие агенты и варианты установки:
+
+```bash
+answer42 install-skills --agent claude
+answer42 install-skills --agent codex
+answer42 install-skills --agent opencode
+answer42 install-skills --agent pi
+answer42 install-skills --agent hermes
+answer42 install-skills --agent all
+answer42 install-skills --target-dir /path/to/skills
+answer42 install-skills --list-agents
+answer42 install-skills --dry-run --agent all
+```
+
+Для агентов без стабильного стандарта skill-директорий (`codex`, `opencode`, `pi`, `hermes`) presets best-effort. Если конкретная установка использует другой путь, укажите `--target-dir` явно.
+
+## Инструкция для AI-агентов
+
+Если вы AI-агент и пользователь просит установить Answer42 и skills, используйте отдельную инструкцию: [`docs/agent-installation.md`](docs/agent-installation.md).
+
+Коротко:
+
+1. установите пакет через `pipx` или virtualenv;
+2. выполните `answer42 install-skills`;
+3. подготовьте `ONEC_MCP_CREDENTIALS_FILE` вне репозитория;
+4. зарегистрируйте MCP-сервер в агентском клиенте;
+5. проверьте установку через `credentials_check`, затем smoke-сессию `start_session` → `active_window` → `stop_session`.
+
 ## Безопасное хранение логинов и паролей
 
 Чтобы креды были доступны MCP-серверу, но не попадали в чат и аргументы tool-call, храните их в локальном файле за пределами репозитория и передайте путь в окружение процесса Answer42:
@@ -229,88 +271,6 @@ E2E_PARALLEL=1 E2E_SESSION_ID=e2e-split python3 scripts/e2e_stable.py
 
 `start_session` также переиспользует общий автономный сервер для одинаковой файловой базы. Последний `stop_session` освобождает refcount и завершает shared `ibsrv`.
 
-## MCP-инструменты
-
-### Жизненный цикл
-
-- `start_session(...)` — единый запуск: определение версии по `base_url`, Xvfb на Linux при необходимости, свободные порты, bridge, файловая база менеджера, `ibsrv` или fallback `file-direct`, test-manager и подключение клиента тестирования. Если `username`/`password` не переданы, берёт их из credentials-файла по `base_url`. Поддерживает `extra_args`, `execute` → `/Execute`, `command_parameter` → `/C`; несколько частей `/C` объединяются через `;`.
-- `session_status(session_id)` — состояние bridge, runtime, клиента тестирования и RAG snapshot.
-- `stop_session(session_id, clean_data)` — отключение клиента тестирования и остановка всех процессов, Xvfb и bridge.
-
-### Автоматизация UI
-
-- `active_window()` — активное окно тестируемого приложения через `ТестируемоеПриложение.ПолучитьАктивноеОкно()`.
-- `windows_list(max_depth)` — список окон тестируемого приложения; если открыто два окна клиента, возвращает оба, потому что читает подчинённые объекты `ТестируемоеПриложение`, а не окна менеджера тестирования.
-- `activate_window(index, title, name)` — переключить активное окно по индексу, заголовку или имени.
-- `goto_start_page()`, `goto_previous_window()`, `goto_next_window()` — навигация основного окна: `ПерейтиКНачальнойСтранице`, `ПерейтиКПредыдущемуОкну`, `ПерейтиКСледующемуОкну`.
-- `ui_tree(max_depth, include_rag_types, include_hidden, rag_snapshot)` — дерево UI с `visible`, `available`, `enabled`, `read_only`; скрытые элементы и неактивные страницы page-group по умолчанию опускаются, `include_hidden=true` возвращает полное дерево. RAG-типы добавляются, когда доступен индекс метаданных.
-- `command_bar()` — диагностическая информация по командной панели, когда она доступна API тест-клиента.
-- `current_element()` — диагностическая информация по текущему элементу, когда она доступна API тест-клиента.
-- `find_object(name, title, type)` — найти объект в дереве UI.
-- `activate_object(name, title, type)` — активировать объект.
-- `open_navigation_link(navigation_link)` — открыть навигационную ссылку `e1cib/...`.
-- `click_button(name, search_by_title)` — нажать кнопку.
-- `set_field_value(field_name, value, search_by_title)` — установить значение поля.
-- `create_new_item()` — создать новый элемент.
-- `save_form()` — сохранить форму.
-- `close_form()` — закрыть форму.
-- `screenshot(path)` — скриншот экрана.
-
-### Таблицы и табличные части
-
-- `table_rows(...)` — строки таблицы.
-- `table_find_row(...)` — найти строку по подстроке.
-- `table_goto_row(...)` — перейти к строке.
-- `table_current_row(...)` — текущая строка.
-- `table_selected_rows(...)` — выделенные строки.
-- `table_set_field(...)` — установить значение в ячейке.
-- `table_choose_field_from_list(...)` — открыть форму выбора для ссылочного поля в строке табличной части.
-- `table_edit_info(...)` — информация о редактировании таблицы.
-- `table_move_row(...)` — перейти к первой/следующей/предыдущей/последней строке.
-
-### Динамические списки
-
-- `dynamic_list_available_fields(object, rag_snapshot)` — поля, доступные для отбора/сортировки по RAG-индексу.
-- `dynamic_list_apply_settings(filters, orders, clear_first)` — применить сортировки через API тест-клиента и best-effort отборы через стандартную форму **Настроить список**.
-- `dynamic_list_set_order(column_title, name="Список")` — сортировка по видимому заголовку колонки.
-- `dynamic_list_output()` — команда **Вывести список** с возвратом текста табличного документа, когда он доступен.
-- `dynamic_list_open_settings()` — открыть **Настроить список**.
-- `dynamic_list_clear_settings()` — сбросить настройки динамического списка.
-- `dynamic_list_open_form_settings()` — открыть **Изменить форму**.
-
-### Табличные документы
-
-- `tabular_documents(include_text)` — список табличных документов в активном окне.
-- `tabular_document_text(...)` — текст табличного документа.
-- `tabular_document_save(path, format)` — сохранить табличный документ в выбранном формате.
-
-
-### Доказательная запись
-
-- `recording_start(output_dir, display, window)` — включить доказательную запись.
-- `recording_capture(action, note)` — вручную добавить доказательный слайд.
-- `recording_stop()` — собрать `manifest.json`, `recording.pdf` (если доступен backend PDF).
-
-### RAG / индекс метаданных
-
-- `rag_source_add(name, path, kind, format="auto")` — зарегистрировать источник; формат определяется автоматически при `format="auto"`.
-- `rag_sources_list()` — список источников.
-- `rag_snapshot_create(name, base, extensions, sources)` — создать effective snapshot.
-- `rag_snapshots_list()` — список snapshot-ов.
-- `rag_index_build(snapshot, source)` — построить индекс.
-- `rag_lookup_object(object, snapshot)` — найти объект метаданных.
-- `rag_query(query, snapshot, limit)` — полнотекстовый поиск.
-
-CLI-пример:
-
-```bash
-python3 scripts/rag_cli.py add-source Configuration /path/to/configuration/src --kind base
-python3 scripts/rag_cli.py add-source Extension1 /path/to/extension/src --kind extension
-python3 scripts/rag_cli.py snapshot Configuration+Extension1 --base Configuration --extension Extension1
-python3 scripts/rag_cli.py build --snapshot Configuration+Extension1
-python3 scripts/rag_cli.py lookup РегистрСведений.Регистр1 --snapshot Configuration+Extension1
-```
-
 ## Ограничения
 
 - Форма пользовательской настройки **«Изменить форму»** частично недоступна для надёжной автоматизации через API клиента тестирования. В частности, команда **«Добавить поля»** в верхней панели формы настройки может быть видна на скриншоте и в диагностическом тексте, но не нажиматься как обычная `ТестируемаяКнопкаФормы`: `click_button` может не находить её, а `activate_object` может вернуть `activated=true` без открытия диалога добавления полей.
@@ -324,65 +284,3 @@ MIT
 Copyright (c) 2026 Kosolapov Stanislav aka proDOOMman <prodoomman@gmail.com>, Marvin (AI Assistant), 42Clouds, and contributors.
 
 Licensed under the MIT License.
-
-## Публикация пакета
-
-Рекомендуемый канал установки для пользователей — PyPI:
-
-```bash
-pipx install 'answer42[screenshot,linux-window-control]'
-# Windows:
-# pipx install "answer42[screenshot,windows-window-control]"
-```
-
-Публикация автоматизирована в `.gitlab-ci.yml` и оставлена только для PyPI:
-
-1. tag `vX.Y.Z` запускает unit/ruff/package checks;
-2. `package` собирает wheel/sdist и проверяет их через `twine check`;
-3. `publish_pypi` публикует wheel/sdist в PyPI через `PYPI_API_TOKEN`;
-4. `create_gitlab_release` создаёт GitLab Release для tag.
-
-
-One-command релиз:
-
-```bash
-answer42 release 0.2.1
-```
-
-Команда меняет `pyproject.toml`, создаёт commit `Release v0.2.1`, annotated tag `v0.2.1`, пушит branch и tag. Tag запускает CI: публикацию в PyPI и создание GitLab Release.
-
-Секрет GitLab CI:
-
-- `PYPI_API_TOKEN` — PyPI token для проекта `answer42`.
-
-Перед релизом проверьте, что `src/mcp_1c/assets/MCPTestManager.cf` и `src/mcp_1c/assets/MCPTestClient.cf` пересобраны из актуальных XML-исходников. Runtime использует XML+`scripts/build_cf.py` в git checkout, а в установленном PyPI wheel при отсутствии исходников копирует packaged `.cf` из `mcp_1c.assets`.
-
-### Установка packaged skills
-
-PyPI сам по себе не устанавливает agent skills в пользовательские каталоги, поэтому в CLI добавлена команда:
-
-```bash
-answer42 install-skills
-```
-
-По умолчанию она устанавливает `answer42` и `answer42-rag` в OpenClaw:
-
-```text
-~/.openclaw/workspace/skills
-```
-
-Другие агенты/варианты:
-
-```bash
-answer42 install-skills --agent claude
-answer42 install-skills --agent codex
-answer42 install-skills --agent opencode
-answer42 install-skills --agent pi
-answer42 install-skills --agent hermes
-answer42 install-skills --agent all
-answer42 install-skills --target-dir /path/to/skills
-answer42 install-skills --list-agents
-answer42 install-skills --dry-run --agent all
-```
-
-Для агентов без стабильного стандарта skill-директорий (`codex`, `opencode`, `pi`, `hermes`) presets best-effort; если у конкретной установки другой путь, используйте `--target-dir`.

{answer42-0.2.0 → answer42-0.2.1}/README.md

@@ -1,7 +1,7 @@
 # Answer42
 
 <p align="center">
-  <img src="docs/assets/answer42-logo.png" alt="Answer42 logo" width="220">
+  <img src="https://gitlab.com/platform42/answer42-mcp/-/raw/beta/docs/assets/answer42-logo.png" alt="Answer42 logo" width="220">
 </p>
 
 **Answer42** — MCP-инструмент для интерактивного управления UI **1С:Предприятия** через клиент тестирования. Он позволяет AI-агенту открывать формы 1С, нажимать кнопки, заполнять поля, выбирать ссылки из форм выбора, работать с таблицами, динамическими списками и табличными документами.
@@ -52,6 +52,48 @@ start_session(
 
 Логин/пароль рекомендуется **не передавать явно**: `start_session` умеет брать их из локального credentials-файла по `base_url`. Параметры `username`/`password` остаются в API для разовых сценариев и обратной совместимости, но при передаче в MCP-вызове они видны вызывающему агенту в аргументах tool-call.
 
+## Установка skills
+
+PyPI-пакет не записывает agent skills в пользовательские каталоги автоматически. После установки Answer42 поставьте bundled skills отдельной командой:
+
+```bash
+answer42 install-skills
+```
+
+По умолчанию команда устанавливает `answer42` и `answer42-rag` в OpenClaw:
+
+```text
+~/.openclaw/workspace/skills
+```
+
+Другие агенты и варианты установки:
+
+```bash
+answer42 install-skills --agent claude
+answer42 install-skills --agent codex
+answer42 install-skills --agent opencode
+answer42 install-skills --agent pi
+answer42 install-skills --agent hermes
+answer42 install-skills --agent all
+answer42 install-skills --target-dir /path/to/skills
+answer42 install-skills --list-agents
+answer42 install-skills --dry-run --agent all
+```
+
+Для агентов без стабильного стандарта skill-директорий (`codex`, `opencode`, `pi`, `hermes`) presets best-effort. Если конкретная установка использует другой путь, укажите `--target-dir` явно.
+
+## Инструкция для AI-агентов
+
+Если вы AI-агент и пользователь просит установить Answer42 и skills, используйте отдельную инструкцию: [`docs/agent-installation.md`](docs/agent-installation.md).
+
+Коротко:
+
+1. установите пакет через `pipx` или virtualenv;
+2. выполните `answer42 install-skills`;
+3. подготовьте `ONEC_MCP_CREDENTIALS_FILE` вне репозитория;
+4. зарегистрируйте MCP-сервер в агентском клиенте;
+5. проверьте установку через `credentials_check`, затем smoke-сессию `start_session` → `active_window` → `stop_session`.
+
 ## Безопасное хранение логинов и паролей
 
 Чтобы креды были доступны MCP-серверу, но не попадали в чат и аргументы tool-call, храните их в локальном файле за пределами репозитория и передайте путь в окружение процесса Answer42:
@@ -195,88 +237,6 @@ E2E_PARALLEL=1 E2E_SESSION_ID=e2e-split python3 scripts/e2e_stable.py
 
 `start_session` также переиспользует общий автономный сервер для одинаковой файловой базы. Последний `stop_session` освобождает refcount и завершает shared `ibsrv`.
 
-## MCP-инструменты
-
-### Жизненный цикл
-
-- `start_session(...)` — единый запуск: определение версии по `base_url`, Xvfb на Linux при необходимости, свободные порты, bridge, файловая база менеджера, `ibsrv` или fallback `file-direct`, test-manager и подключение клиента тестирования. Если `username`/`password` не переданы, берёт их из credentials-файла по `base_url`. Поддерживает `extra_args`, `execute` → `/Execute`, `command_parameter` → `/C`; несколько частей `/C` объединяются через `;`.
-- `session_status(session_id)` — состояние bridge, runtime, клиента тестирования и RAG snapshot.
-- `stop_session(session_id, clean_data)` — отключение клиента тестирования и остановка всех процессов, Xvfb и bridge.
-
-### Автоматизация UI
-
-- `active_window()` — активное окно тестируемого приложения через `ТестируемоеПриложение.ПолучитьАктивноеОкно()`.
-- `windows_list(max_depth)` — список окон тестируемого приложения; если открыто два окна клиента, возвращает оба, потому что читает подчинённые объекты `ТестируемоеПриложение`, а не окна менеджера тестирования.
-- `activate_window(index, title, name)` — переключить активное окно по индексу, заголовку или имени.
-- `goto_start_page()`, `goto_previous_window()`, `goto_next_window()` — навигация основного окна: `ПерейтиКНачальнойСтранице`, `ПерейтиКПредыдущемуОкну`, `ПерейтиКСледующемуОкну`.
-- `ui_tree(max_depth, include_rag_types, include_hidden, rag_snapshot)` — дерево UI с `visible`, `available`, `enabled`, `read_only`; скрытые элементы и неактивные страницы page-group по умолчанию опускаются, `include_hidden=true` возвращает полное дерево. RAG-типы добавляются, когда доступен индекс метаданных.
-- `command_bar()` — диагностическая информация по командной панели, когда она доступна API тест-клиента.
-- `current_element()` — диагностическая информация по текущему элементу, когда она доступна API тест-клиента.
-- `find_object(name, title, type)` — найти объект в дереве UI.
-- `activate_object(name, title, type)` — активировать объект.
-- `open_navigation_link(navigation_link)` — открыть навигационную ссылку `e1cib/...`.
-- `click_button(name, search_by_title)` — нажать кнопку.
-- `set_field_value(field_name, value, search_by_title)` — установить значение поля.
-- `create_new_item()` — создать новый элемент.
-- `save_form()` — сохранить форму.
-- `close_form()` — закрыть форму.
-- `screenshot(path)` — скриншот экрана.
-
-### Таблицы и табличные части
-
-- `table_rows(...)` — строки таблицы.
-- `table_find_row(...)` — найти строку по подстроке.
-- `table_goto_row(...)` — перейти к строке.
-- `table_current_row(...)` — текущая строка.
-- `table_selected_rows(...)` — выделенные строки.
-- `table_set_field(...)` — установить значение в ячейке.
-- `table_choose_field_from_list(...)` — открыть форму выбора для ссылочного поля в строке табличной части.
-- `table_edit_info(...)` — информация о редактировании таблицы.
-- `table_move_row(...)` — перейти к первой/следующей/предыдущей/последней строке.
-
-### Динамические списки
-
-- `dynamic_list_available_fields(object, rag_snapshot)` — поля, доступные для отбора/сортировки по RAG-индексу.
-- `dynamic_list_apply_settings(filters, orders, clear_first)` — применить сортировки через API тест-клиента и best-effort отборы через стандартную форму **Настроить список**.
-- `dynamic_list_set_order(column_title, name="Список")` — сортировка по видимому заголовку колонки.
-- `dynamic_list_output()` — команда **Вывести список** с возвратом текста табличного документа, когда он доступен.
-- `dynamic_list_open_settings()` — открыть **Настроить список**.
-- `dynamic_list_clear_settings()` — сбросить настройки динамического списка.
-- `dynamic_list_open_form_settings()` — открыть **Изменить форму**.
-
-### Табличные документы
-
-- `tabular_documents(include_text)` — список табличных документов в активном окне.
-- `tabular_document_text(...)` — текст табличного документа.
-- `tabular_document_save(path, format)` — сохранить табличный документ в выбранном формате.
-
-
-### Доказательная запись
-
-- `recording_start(output_dir, display, window)` — включить доказательную запись.
-- `recording_capture(action, note)` — вручную добавить доказательный слайд.
-- `recording_stop()` — собрать `manifest.json`, `recording.pdf` (если доступен backend PDF).
-
-### RAG / индекс метаданных
-
-- `rag_source_add(name, path, kind, format="auto")` — зарегистрировать источник; формат определяется автоматически при `format="auto"`.
-- `rag_sources_list()` — список источников.
-- `rag_snapshot_create(name, base, extensions, sources)` — создать effective snapshot.
-- `rag_snapshots_list()` — список snapshot-ов.
-- `rag_index_build(snapshot, source)` — построить индекс.
-- `rag_lookup_object(object, snapshot)` — найти объект метаданных.
-- `rag_query(query, snapshot, limit)` — полнотекстовый поиск.
-
-CLI-пример:
-
-```bash
-python3 scripts/rag_cli.py add-source Configuration /path/to/configuration/src --kind base
-python3 scripts/rag_cli.py add-source Extension1 /path/to/extension/src --kind extension
-python3 scripts/rag_cli.py snapshot Configuration+Extension1 --base Configuration --extension Extension1
-python3 scripts/rag_cli.py build --snapshot Configuration+Extension1
-python3 scripts/rag_cli.py lookup РегистрСведений.Регистр1 --snapshot Configuration+Extension1
-```
-
 ## Ограничения
 
 - Форма пользовательской настройки **«Изменить форму»** частично недоступна для надёжной автоматизации через API клиента тестирования. В частности, команда **«Добавить поля»** в верхней панели формы настройки может быть видна на скриншоте и в диагностическом тексте, но не нажиматься как обычная `ТестируемаяКнопкаФормы`: `click_button` может не находить её, а `activate_object` может вернуть `activated=true` без открытия диалога добавления полей.
@@ -290,65 +250,3 @@ MIT
 Copyright (c) 2026 Kosolapov Stanislav aka proDOOMman <prodoomman@gmail.com>, Marvin (AI Assistant), 42Clouds, and contributors.
 
 Licensed under the MIT License.
-
-## Публикация пакета
-
-Рекомендуемый канал установки для пользователей — PyPI:
-
-```bash
-pipx install 'answer42[screenshot,linux-window-control]'
-# Windows:
-# pipx install "answer42[screenshot,windows-window-control]"
-```
-
-Публикация автоматизирована в `.gitlab-ci.yml` и оставлена только для PyPI:
-
-1. tag `vX.Y.Z` запускает unit/ruff/package checks;
-2. `package` собирает wheel/sdist и проверяет их через `twine check`;
-3. `publish_pypi` публикует wheel/sdist в PyPI через `PYPI_API_TOKEN`;
-4. `create_gitlab_release` создаёт GitLab Release для tag.
-
-
-One-command релиз:
-
-```bash
-answer42 release 0.2.1
-```
-
-Команда меняет `pyproject.toml`, создаёт commit `Release v0.2.1`, annotated tag `v0.2.1`, пушит branch и tag. Tag запускает CI: публикацию в PyPI и создание GitLab Release.
-
-Секрет GitLab CI:
-
-- `PYPI_API_TOKEN` — PyPI token для проекта `answer42`.
-
-Перед релизом проверьте, что `src/mcp_1c/assets/MCPTestManager.cf` и `src/mcp_1c/assets/MCPTestClient.cf` пересобраны из актуальных XML-исходников. Runtime использует XML+`scripts/build_cf.py` в git checkout, а в установленном PyPI wheel при отсутствии исходников копирует packaged `.cf` из `mcp_1c.assets`.
-
-### Установка packaged skills
-
-PyPI сам по себе не устанавливает agent skills в пользовательские каталоги, поэтому в CLI добавлена команда:
-
-```bash
-answer42 install-skills
-```
-
-По умолчанию она устанавливает `answer42` и `answer42-rag` в OpenClaw:
-
-```text
-~/.openclaw/workspace/skills
-```
-
-Другие агенты/варианты:
-
-```bash
-answer42 install-skills --agent claude
-answer42 install-skills --agent codex
-answer42 install-skills --agent opencode
-answer42 install-skills --agent pi
-answer42 install-skills --agent hermes
-answer42 install-skills --agent all
-answer42 install-skills --target-dir /path/to/skills
-answer42 install-skills --list-agents
-answer42 install-skills --dry-run --agent all
-```
-
-Для агентов без стабильного стандарта skill-директорий (`codex`, `opencode`, `pi`, `hermes`) presets best-effort; если у конкретной установки другой путь, используйте `--target-dir`.

answer42-0.2.1/docs/agent-installation.md

@@ -0,0 +1,195 @@
+# Инструкция для AI-агентов: установка Answer42 и skills
+
+Эта инструкция предназначена для AI-агентов, которые устанавливают Answer42 в пользовательское окружение и подключают MCP-сервер к агентскому клиенту.
+
+## 1. Проверьте окружение
+
+1. Определите ОС и способ запуска агента.
+2. Убедитесь, что доступна Python 3.11+.
+3. Убедитесь, что установлена платформа 1С:Предприятие 8.3.27+.
+4. Для Linux нужен GUI/X11 или Xvfb. Headless-сервер без X11 не подходит для скриншотов и запуска GUI-клиента 1С.
+5. Для Windows запускайте Answer42 только из интерактивной desktop-сессии пользователя. Не используйте Windows service, заблокированный RDP-сеанс или неинтерактивный background-runner для UI automation.
+
+## 2. Установите пакет
+
+Linux:
+
+```bash
+pipx install 'answer42[screenshot,linux-window-control]'
+```
+
+Если `pipx` недоступен:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+pip install 'answer42[screenshot,linux-window-control]'
+```
+
+Windows:
+
+```powershell
+pipx install "answer42[screenshot,windows-window-control]"
+```
+
+Если `pipx` недоступен:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\Activate.ps1
+pip install "answer42[screenshot,windows-window-control]"
+```
+
+Проверьте CLI:
+
+```bash
+answer42 --help
+```
+
+## 3. Установите bundled skills
+
+PyPI-пакет не должен сам записывать skills в профили агентов. После установки пакета выполните:
+
+```bash
+answer42 install-skills
+```
+
+По умолчанию устанавливаются `answer42` и `answer42-rag` в OpenClaw:
+
+```text
+~/.openclaw/workspace/skills
+```
+
+Другие варианты:
+
+```bash
+answer42 install-skills --agent openclaw
+answer42 install-skills --agent claude
+answer42 install-skills --agent codex
+answer42 install-skills --agent opencode
+answer42 install-skills --agent pi
+answer42 install-skills --agent hermes
+answer42 install-skills --agent all
+answer42 install-skills --target-dir /path/to/skills
+answer42 install-skills --list-agents
+answer42 install-skills --dry-run --agent all
+```
+
+Для агентов без стабильного стандарта skill-директорий presets best-effort. Если конкретная установка использует другой путь, укажите `--target-dir` явно.
+
+## 4. Подготовьте credentials
+
+Не передавайте логин и пароль в каждом `start_session`, если можно сохранить их в локальном credentials-файле.
+
+Рекомендуемый вариант — файл вне репозитория, доступный процессу MCP-сервера через `ONEC_MCP_CREDENTIALS_FILE`:
+
+```bash
+export ONEC_MCP_CREDENTIALS_FILE=/secure/path/credentials.json
+```
+
+Минимальный формат:
+
+```json
+{
+  "entries": [
+    {
+      "url": "https://example.invalid/infobase",
+      "username": "<USERNAME>",
+      "password": "<PASSWORD>"
+    }
+  ]
+}
+```
+
+Рекомендуемые права на Linux:
+
+```bash
+chmod 600 /secure/path/credentials.json
+```
+
+Если MCP уже подключён, можно сохранить запись через tool:
+
+```text
+credentials_save(
+  url="<TARGET_INFOBASE_URL>",
+  username="<USERNAME>",
+  password="<PASSWORD>"
+)
+```
+
+Для проверки используйте:
+
+```text
+credentials_check(base_url="<TARGET_INFOBASE_URL>")
+```
+
+`credentials_check`, `credentials_save` и `credentials_remove` не возвращают пароль наружу. `credentials_list` рекомендуется скрывать в агентском клиенте, чтобы агент не видел список URL-шаблонов.
+
+## 5. Зарегистрируйте MCP-сервер
+
+### OpenClaw
+
+Минимальный пример:
+
+```bash
+/mcp set Answer42={"command":"answer42","args":[],"env":{"ONEC_MCP_CREDENTIALS_FILE":"/secure/path/credentials.json"},"enabled":true,"requestTimeoutMs":120000,"connectionTimeoutMs":30000,"toolFilter":{"exclude":["credentials_list"]}}
+```
+
+Если `answer42` установлен в virtualenv и не находится в `PATH`, укажите полный путь к executable, например:
+
+```json
+{
+  "command": "/path/to/.venv/bin/answer42",
+  "args": [],
+  "env": {
+    "ONEC_MCP_CREDENTIALS_FILE": "/secure/path/credentials.json"
+  },
+  "enabled": true,
+  "requestTimeoutMs": 120000,
+  "connectionTimeoutMs": 30000,
+  "toolFilter": {
+    "exclude": ["credentials_list"]
+  }
+}
+```
+
+После изменения MCP config перезапустите или перезагрузите агентский runtime/gateway, если клиент не подхватил конфигурацию автоматически.
+
+## 6. Проверьте установку
+
+Безопасные проверки:
+
+```bash
+answer42 --help
+answer42 install-skills --dry-run
+```
+
+Через MCP tools:
+
+```text
+credentials_check(base_url="<TARGET_INFOBASE_URL>")
+session_status()
+```
+
+Smoke-проверка живой базы:
+
+```text
+start_session(
+  session_id="smoke",
+  base_url="<TARGET_INFOBASE_URL>",
+  idle_timeout_minutes=15
+)
+active_window(session_id="smoke")
+stop_session(session_id="smoke")
+```
+
+Если `start_session` сообщает, что передан пароль из звёздочек (`***`, `********`), значит агент получил плейсхолдер вместо реального пароля. Попросите пользователя сохранить корректные credentials или передать настоящий пароль безопасным способом.
+
+## 7. Правила работы после установки
+
+- Работайте через first-class MCP tools Answer42, а не через X11/WinAPI-клики.
+- Не запускайте обычный клиент 1С вместо `/TESTMANAGER`, если пользователь явно не просил диагностику вне Answer42.
+- Для ссылочных полей предпочитайте стандартные формы выбора 1С.
+- После действий проверяйте user messages, error info и фактическое состояние формы.
+- Не заявляйте выполнение UI-задачи без реального состояния, скриншота или PDF evidence.
+- Завершайте сессии через `stop_session`.

{answer42-0.2.0 → answer42-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "answer42"
-version = "0.2.0"
+version = "0.2.1"
 description = "Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API"
 readme = "README.md"
 requires-python = ">=3.11"

answer42-0.2.1/scripts/build_pages.py

@@ -0,0 +1,274 @@
+#!/usr/bin/env python3
+"""Build a small static GitLab Pages site from project Markdown docs."""
+
+from __future__ import annotations
+
+import html
+import re
+import shutil
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+PUBLIC = ROOT / "public"
+DOCS = ROOT / "docs"
+
+PAGES = [
+    ("index.html", ROOT / "README.md", "README"),
+    ("installation.html", DOCS / "installation.md", "Установка"),
+    ("agent-installation.html", DOCS / "agent-installation.md", "Инструкция для AI-агентов"),
+    ("architecture.html", DOCS / "architecture.md", "Архитектура"),
+]
+
+NAV = [
+    ("index.html", "README"),
+    ("installation.html", "Установка"),
+    ("agent-installation.html", "AI-агентам"),
+    ("architecture.html", "Архитектура"),
+]
+
+CSS = """
+:root { color-scheme: light dark; --bg:#0b1020; --panel:#111936; --text:#eef3ff; --muted:#aebbe2; --link:#67e8f9; --line:#2b365f; --code:#080d1c; }
+@media (prefers-color-scheme: light) { :root { --bg:#f7f9ff; --panel:#ffffff; --text:#111827; --muted:#526078; --link:#0369a1; --line:#dbe3f5; --code:#f1f5f9; } }
+* { box-sizing: border-box; }
+body { margin:0; font:16px/1.62 Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; color:var(--text); background:radial-gradient(circle at 20% 0%, rgba(103,232,249,.18), transparent 28rem), var(--bg); }
+.wrapper { max-width: 1120px; margin: 0 auto; padding: 28px 20px 56px; }
+.header { display:flex; align-items:center; gap:18px; padding:22px 0 18px; }
+.logo { width:72px; height:72px; object-fit:contain; filter: drop-shadow(0 12px 24px rgba(0,0,0,.28)); }
+.kicker { color:var(--muted); margin:0; }
+h1,h2,h3,h4 { line-height:1.22; margin:1.6em 0 .55em; }
+h1 { font-size: clamp(2rem, 5vw, 3.8rem); margin-top:.2em; letter-spacing:-.04em; }
+h2 { font-size:1.8rem; border-top:1px solid var(--line); padding-top:1.1em; }
+a { color:var(--link); text-decoration:none; } a:hover { text-decoration:underline; }
+.nav { display:flex; flex-wrap:wrap; gap:10px; margin: 12px 0 28px; }
+.nav a { padding:8px 12px; border:1px solid var(--line); border-radius:999px; background:rgba(255,255,255,.04); }
+main { background: color-mix(in srgb, var(--panel) 92%, transparent); border:1px solid var(--line); border-radius:28px; padding: clamp(20px, 4vw, 44px); box-shadow:0 24px 80px rgba(0,0,0,.22); }
+pre { overflow:auto; padding:16px 18px; background:var(--code); border:1px solid var(--line); border-radius:16px; }
+code { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size:.92em; background:var(--code); border-radius:6px; padding:.12em .32em; }
+pre code { background:transparent; padding:0; }
+blockquote { margin:1.2em 0; padding:.5em 1.2em; border-left:4px solid var(--link); color:var(--muted); }
+table { width:100%; border-collapse:collapse; margin:1.2em 0; display:block; overflow:auto; }
+th,td { border:1px solid var(--line); padding:9px 11px; vertical-align:top; }
+th { background:rgba(255,255,255,.07); }
+img { max-width:100%; height:auto; }
+.footer { color:var(--muted); margin-top:22px; font-size:.92rem; }
+""".strip()
+
+
+def slugify(text: str) -> str:
+    text = text.strip().lower()
+    text = re.sub(r"[^0-9a-zа-яё_-]+", "-", text, flags=re.I)
+    return text.strip("-") or "section"
+
+
+def convert_inline(text: str) -> str:
+    placeholders: list[str] = []
+
+    def stash(value: str) -> str:
+        placeholders.append(value)
+        return f"\u0000{len(placeholders) - 1}\u0000"
+
+    text = html.escape(text)
+    text = re.sub(r"`([^`]+)`", lambda m: stash(f"<code>{m.group(1)}</code>"), text)
+    text = re.sub(r"!\[([^\]]*)\]\(([^)]+)\)", lambda m: stash(f'<img src="{html.escape(m.group(2), quote=True)}" alt="{html.escape(m.group(1), quote=True)}">'), text)
+    text = re.sub(r"\[([^\]]+)\]\(([^)]+)\)", lambda m: stash(f'<a href="{html.escape(m.group(2), quote=True)}">{m.group(1)}</a>'), text)
+    text = re.sub(r"\*\*([^*]+)\*\*", r"<strong>\1</strong>", text)
+    text = re.sub(r"(?<!\*)\*([^*]+)\*(?!\*)", r"<em>\1</em>", text)
+    # Some placeholders can be nested, for example Markdown links with code-formatted text:
+    # [`file.md`](file.md). Resolve repeatedly until no marker remains.
+    for _ in range(3):
+        changed = False
+        for i, value in enumerate(placeholders):
+            marker = f"\u0000{i}\u0000"
+            if marker in text:
+                text = text.replace(marker, value)
+                changed = True
+        if not changed:
+            break
+    return text
+
+
+def markdown_to_html(markdown: str) -> str:
+    lines = markdown.splitlines()
+    out: list[str] = []
+    in_code = False
+    code_lang = ""
+    para: list[str] = []
+    in_ul = False
+    in_ol = False
+    in_quote = False
+    table: list[str] = []
+
+    def flush_para() -> None:
+        nonlocal para
+        if para:
+            out.append(f"<p>{convert_inline(' '.join(para))}</p>")
+            para = []
+
+    def flush_lists() -> None:
+        nonlocal in_ul, in_ol
+        if in_ul:
+            out.append("</ul>")
+            in_ul = False
+        if in_ol:
+            out.append("</ol>")
+            in_ol = False
+
+    def flush_quote() -> None:
+        nonlocal in_quote
+        if in_quote:
+            out.append("</blockquote>")
+            in_quote = False
+
+    def flush_table() -> None:
+        nonlocal table
+        if not table:
+            return
+        rows = []
+        for row in table:
+            cells = [c.strip() for c in row.strip().strip("|").split("|")]
+            rows.append(cells)
+        if len(rows) >= 2 and all(re.fullmatch(r":?-{3,}:?", c) for c in rows[1]):
+            header = rows[0]
+            body = rows[2:]
+            html_rows = ["<table><thead><tr>" + "".join(f"<th>{convert_inline(c)}</th>" for c in header) + "</tr></thead><tbody>"]
+            for r in body:
+                html_rows.append("<tr>" + "".join(f"<td>{convert_inline(c)}</td>" for c in r) + "</tr>")
+            html_rows.append("</tbody></table>")
+            out.append("".join(html_rows))
+        else:
+            for row in table:
+                out.append(f"<p>{convert_inline(row)}</p>")
+        table = []
+
+    for line in lines:
+        if line.startswith("```"):
+            flush_para()
+            flush_lists()
+            flush_quote()
+            flush_table()
+            if not in_code:
+                in_code = True
+                code_lang = line[3:].strip()
+                cls = f' class="language-{html.escape(code_lang, quote=True)}"' if code_lang else ""
+                out.append(f"<pre><code{cls}>")
+            else:
+                out.append("</code></pre>")
+                in_code = False
+            continue
+        if in_code:
+            out.append(html.escape(line) + "\n")
+            continue
+        if line.strip().startswith("|") and line.strip().endswith("|"):
+            flush_para()
+            flush_lists()
+            flush_quote()
+            table.append(line)
+            continue
+        else:
+            flush_table()
+        if not line.strip():
+            flush_para()
+            flush_lists()
+            flush_quote()
+            continue
+        m = re.match(r"^(#{1,6})\s+(.+)$", line)
+        if m:
+            flush_para()
+            flush_lists()
+            flush_quote()
+            level = len(m.group(1))
+            title = m.group(2).strip()
+            out.append(f'<h{level} id="{slugify(title)}">{convert_inline(title)}</h{level}>' )
+            continue
+        if line.startswith(">"):
+            flush_para()
+            flush_lists()
+            if not in_quote:
+                out.append("<blockquote>")
+                in_quote = True
+            out.append(f"<p>{convert_inline(line.lstrip('> ').strip())}</p>")
+            continue
+        m = re.match(r"^\s*[-*]\s+(.+)$", line)
+        if m:
+            flush_para()
+            flush_quote()
+            if not in_ul:
+                flush_lists()
+                out.append("<ul>")
+                in_ul = True
+            out.append(f"<li>{convert_inline(m.group(1))}</li>")
+            continue
+        m = re.match(r"^\s*\d+\.\s+(.+)$", line)
+        if m:
+            flush_para()
+            flush_quote()
+            if not in_ol:
+                flush_lists()
+                out.append("<ol>")
+                in_ol = True
+            out.append(f"<li>{convert_inline(m.group(1))}</li>")
+            continue
+        flush_lists()
+        flush_quote()
+        para.append(line.strip())
+
+    flush_para()
+    flush_lists()
+    flush_quote()
+    flush_table()
+    if in_code:
+        out.append("</code></pre>")
+    return "\n".join(out)
+
+
+def page_html(title: str, body: str) -> str:
+    nav = "".join(f'<a href="{href}">{label}</a>' for href, label in NAV)
+    return f"""<!doctype html>
+<html lang="ru">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{html.escape(title)} — Answer42</title>
+  <link rel="icon" href="assets/answer42-logo.png">
+  <style>{CSS}</style>
+</head>
+<body>
+  <div class="wrapper">
+    <header class="header">
+      <img class="logo" src="assets/answer42-logo.png" alt="Answer42 logo">
+      <div>
+        <p class="kicker">The Answer to Life, Universe, and 1C — UI Driver</p>
+        <h1>Answer42</h1>
+      </div>
+    </header>
+    <nav class="nav">{nav}</nav>
+    <main>{body}</main>
+    <div class="footer">Generated from repository Markdown by <code>scripts/build_pages.py</code>.</div>
+  </div>
+</body>
+</html>
+"""
+
+
+def main() -> None:
+    if PUBLIC.exists():
+        shutil.rmtree(PUBLIC)
+    (PUBLIC / "assets").mkdir(parents=True)
+    shutil.copy2(DOCS / "assets" / "answer42-logo.png", PUBLIC / "assets" / "answer42-logo.png")
+    for out_name, src, title in PAGES:
+        if not src.exists():
+            continue
+        markdown = src.read_text(encoding="utf-8")
+        markdown = re.sub(
+            r'<p\s+align="center">\s*<img\s+src="([^"]+)"\s+alt="([^"]*)"\s+width="([^"]+)"\s*>\s*</p>',
+            r'![\2](\1)',
+            markdown,
+            flags=re.S,
+        )
+        body = markdown_to_html(markdown)
+        (PUBLIC / out_name).write_text(page_html(title, body), encoding="utf-8")
+    print(f"Built {len(list(PUBLIC.glob('*.html')))} pages into {PUBLIC}")
+
+
+if __name__ == "__main__":
+    main()

answer42-0.2.0/docs/publishing.md

@@ -1,103 +0,0 @@
-# Публикация Answer42 в PyPI
-
-MCP Registry удалён из workflow. Единственный автоматизированный канал публикации — PyPI.
-
-## GitLab CI
-
-`.gitlab-ci.yml` содержит pipeline:
-
-- `unit_tests` — `py_compile`, targeted `pytest`, `ruff`.
-- `package` — проверяет наличие packaged CF artifacts и packaged skills, собирает wheel/sdist и запускает `twine check`.
-- `publish_pypi` — на tag `vX.Y.Z` публикует `dist/*` в PyPI через `PYPI_API_TOKEN`.
-
-## Required CI variables
-
-- `PYPI_API_TOKEN` — project-scoped PyPI token.
-
-## Release checklist
-
-```bash
-# 1. rebuild packaged CF artifacts from XML sources
-ONEC_PLATFORM_DIR=/opt/1cv8/x86_64/8.5.1.1150 python scripts/build_cf.py src/cf build/MCPTestManager.cf
-ONEC_PLATFORM_DIR=/opt/1cv8/x86_64/8.5.1.1150 python scripts/build_cf.py src/client_cf build/MCPTestClient.cf
-cp build/MCPTestManager.cf src/mcp_1c/assets/MCPTestManager.cf
-cp build/MCPTestClient.cf src/mcp_1c/assets/MCPTestClient.cf
-
-# 2. refresh packaged skills if skill sources changed
-rm -rf src/mcp_1c/assets/skills
-mkdir -p src/mcp_1c/assets/skills
-cp -R skills/answer42 src/mcp_1c/assets/skills/
-cp -R skills/answer42-rag src/mcp_1c/assets/skills/
-
-# 3. test/package locally
-python -m py_compile src/mcp_1c/*.py src/mcp_1c/rag/*.py
-PYTHONPATH=src python -m pytest -q -c /dev/null tests/test_credentials.py tests/test_protocol.py tests/test_server_tools.py
-python -m ruff check src/mcp_1c tests
-python -m build
-python -m twine check dist/*
-
-# 4. update version in pyproject.toml, commit, tag
-git tag v0.2.0
-git push origin beta v0.2.0
-```
-
-## Installing packaged skills
-
-PyPI packages do not automatically install agent skills into user profile directories. After installing Answer42, run:
-
-```bash
-answer42 install-skills
-```
-
-Default target is OpenClaw:
-
-```text
-~/.openclaw/workspace/skills
-```
-
-Supported presets:
-
-```bash
-answer42 install-skills --list-agents
-answer42 install-skills --agent openclaw
-answer42 install-skills --agent claude
-answer42 install-skills --agent codex
-answer42 install-skills --agent opencode
-answer42 install-skills --agent pi
-answer42 install-skills --agent hermes
-answer42 install-skills --agent all
-answer42 install-skills --target-dir /custom/skills/dir
-```
-
-For agents without a stable public skill directory standard, presets are best-effort; use `--target-dir` for exact local setups.
-
-## One-command release helper
-
-To bump `pyproject.toml`, create a release commit, create an annotated git tag and push both branch + tag:
-
-```bash
-answer42 release 0.2.1
-```
-
-This runs the equivalent of:
-
-```bash
-# edit pyproject.toml: version = "0.2.1"
-git add pyproject.toml
-git commit -m "Release v0.2.1"
-git tag -a v0.2.1 -m "Release v0.2.1"
-git push origin HEAD
-git push origin v0.2.1
-```
-
-The pushed tag triggers GitLab CI. CI publishes the PyPI package and creates a GitLab Release.
-
-Useful options:
-
-```bash
-answer42 release 0.2.1 --dry-run
-answer42 release 0.2.1 --no-push
-answer42 release 0.2.1 --remote origin --branch beta
-```
-
-The helper requires a clean working tree by default. Commit/stash other work first; `--allow-dirty` exists for exceptional cases.