feat(cfe-init): Caption и ShortCaption в корне расширения на формате 2.21

Свойства корня, добавленные форматом 2.21, между Version и DefaultLanguage.
В cf-init они уже были, в cfe-init — нет. Нашёл раундтрип расширения через базу
8.5 по сценарию из issue #57: загрузка расширения и обратная выгрузка давали
диff ровно на этих двух элементах.

После правки выгрузка расширения из базы 8.5 совпадает с исходниками полностью —
и по составу файлов, и побайтово.

663/663 ps1, 660/663 py; 1С-сертификация cfe-init и cfe-borrow на 8.5 — 2/2.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.claude/skills/.gitignore

@@ -1 +1 @@
-__pycache__/
+__pycache__/

.claude/skills/cf-edit/SKILL.md

@@ -1,60 +1,60 @@
----
+---
-name: cf-edit
+name: cf-edit
-description: Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из состава, настроить роли по умолчанию, поменять раскладку панелей, настроить начальную страницу
+description: Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из состава, настроить роли по умолчанию, поменять раскладку панелей, настроить начальную страницу
-argument-hint: -ConfigPath <path> -Operation <op> -Value <value>
+argument-hint: -ConfigPath <path> -Operation <op> -Value <value>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Write
+  - Write
-  - Glob
+  - Glob
----
+---
-
+
-# /cf-edit — редактирование конфигурации 1С
+# /cf-edit — редактирование конфигурации 1С
-
+
-Точечное редактирование Configuration.xml: свойства, состав ChildObjects, роли по умолчанию.
+Точечное редактирование Configuration.xml: свойства, состав ChildObjects, роли по умолчанию.
-
+
-## Параметры и команда
+## Параметры и команда
-
+
-| Параметр | Описание |
+| Параметр | Описание |
-|----------|----------|
+|----------|----------|
-| `ConfigPath` | Путь к Configuration.xml или каталогу выгрузки |
+| `ConfigPath` | Путь к Configuration.xml или каталогу выгрузки |
-| `Operation` | Операция (см. таблицу) |
+| `Operation` | Операция (см. таблицу) |
-| `Value` | Значение для операции (batch через `;;`) |
+| `Value` | Значение для операции (batch через `;;`) |
-| `DefinitionFile` | JSON-файл с массивом операций |
+| `DefinitionFile` | JSON-файл с массивом операций |
-| `NoValidate` | Пропустить авто-валидацию |
+| `NoValidate` | Пропустить авто-валидацию |
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-edit.ps1" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-edit.ps1" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
-```
+```
-
+
-## Операции
+## Операции
-
+
-| Операция | Формат Value | Описание |
+| Операция | Формат Value | Описание |
-|----------|-------------|----------|
+|----------|-------------|----------|
-| `modify-property` | `Ключ=Значение` (batch `;;`) | Изменить свойство |
+| `modify-property` | `Ключ=Значение` (batch `;;`) | Изменить свойство |
-| `add-childObject` | `Type.Name` (batch `;;`) | Зарегистрировать уже существующий файл объекта в ChildObjects. Для создания нового объекта используй `/meta-compile`, `/role-compile`, `/subsystem-compile` — они регистрируют автоматически |
+| `add-childObject` | `Type.Name` (batch `;;`) | Зарегистрировать уже существующий файл объекта в ChildObjects. Для создания нового объекта используй `/meta-compile`, `/role-compile`, `/subsystem-compile` — они регистрируют автоматически |
-| `remove-childObject` | `Type.Name` (batch `;;`) | Удалить объект из ChildObjects |
+| `remove-childObject` | `Type.Name` (batch `;;`) | Удалить объект из ChildObjects |
-| `add-defaultRole` | `Role.Name` или `Name` | Добавить роль по умолчанию |
+| `add-defaultRole` | `Role.Name` или `Name` | Добавить роль по умолчанию |
-| `remove-defaultRole` | `Role.Name` или `Name` | Удалить роль по умолчанию |
+| `remove-defaultRole` | `Role.Name` или `Name` | Удалить роль по умолчанию |
-| `set-defaultRoles` | Имена через `;;` | Заменить список ролей по умолчанию |
+| `set-defaultRoles` | Имена через `;;` | Заменить список ролей по умолчанию |
-| `set-panels` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/ClientApplicationInterface.xml` (раскладка панелей) |
+| `set-panels` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/ClientApplicationInterface.xml` (раскладка панелей) |
-| `set-home-page` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/HomePageWorkArea.xml` (начальная страница) |
+| `set-home-page` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/HomePageWorkArea.xml` (начальная страница) |
-
+
-Допустимые значения свойств, формат DefinitionFile (JSON), каноничный порядок: [reference.md](reference.md)
+Допустимые значения свойств, формат DefinitionFile (JSON), каноничный порядок: [reference.md](reference.md)
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Изменить версию и поставщика
+# Изменить версию и поставщика
-... -ConfigPath src -Operation modify-property -Value "Version=1.0.0.1 ;; Vendor=Фирма 1С"
+... -ConfigPath src -Operation modify-property -Value "Version=1.0.0.1 ;; Vendor=Фирма 1С"
-
+
-# Добавить объекты
+# Добавить объекты
-... -ConfigPath src -Operation add-childObject -Value "Catalog.Товары ;; Document.Заказ"
+... -ConfigPath src -Operation add-childObject -Value "Catalog.Товары ;; Document.Заказ"
-
+
-# Удалить объект
+# Удалить объект
-... -ConfigPath src -Operation remove-childObject -Value "Catalog.Устаревший"
+... -ConfigPath src -Operation remove-childObject -Value "Catalog.Устаревший"
-
+
-# Роли по умолчанию
+# Роли по умолчанию
-... -ConfigPath src -Operation add-defaultRole -Value "ПолныеПрава"
+... -ConfigPath src -Operation add-defaultRole -Value "ПолныеПрава"
-... -ConfigPath src -Operation set-defaultRoles -Value "ПолныеПрава ;; Администратор"
+... -ConfigPath src -Operation set-defaultRoles -Value "ПолныеПрава ;; Администратор"
-```
+```

.claude/skills/cf-edit/reference.md

@@ -1,150 +1,150 @@
-# cf-edit — справочник операций
+# cf-edit — справочник операций
-
+
-## modify-property
+## modify-property
-
+
-Свойства для редактирования:
+Свойства для редактирования:
-
+
-### Скалярные
+### Скалярные
-`Name`, `Version`, `Vendor`, `Comment`, `NamePrefix`, `UpdateCatalogAddress`
+`Name`, `Version`, `Vendor`, `Comment`, `NamePrefix`, `UpdateCatalogAddress`
-
+
-### LocalString (многоязычные)
+### LocalString (многоязычные)
-`Synonym`, `BriefInformation`, `DetailedInformation`, `Copyright`, `VendorInformationAddress`, `ConfigurationInformationAddress`
+`Synonym`, `BriefInformation`, `DetailedInformation`, `Copyright`, `VendorInformationAddress`, `ConfigurationInformationAddress`
-
+
-### Enum
+### Enum
-| Свойство | Допустимые значения |
+| Свойство | Допустимые значения |
-|----------|---------------------|
+|----------|---------------------|
-| `CompatibilityMode` | `Version8_3_20` ... `Version8_3_28`, `Version8_5_1`, `DontUse` |
+| `CompatibilityMode` | `Version8_3_20` ... `Version8_3_28`, `Version8_5_1`, `DontUse` |
-| `ConfigurationExtensionCompatibilityMode` | то же |
+| `ConfigurationExtensionCompatibilityMode` | то же |
-| `DefaultRunMode` | `ManagedApplication`, `OrdinaryApplication`, `Auto` |
+| `DefaultRunMode` | `ManagedApplication`, `OrdinaryApplication`, `Auto` |
-| `ScriptVariant` | `Russian`, `English` |
+| `ScriptVariant` | `Russian`, `English` |
-| `DataLockControlMode` | `Managed`, `Automatic`, `AutomaticAndManaged` |
+| `DataLockControlMode` | `Managed`, `Automatic`, `AutomaticAndManaged` |
-| `ObjectAutonumerationMode` | `NotAutoFree`, `AutoFree` |
+| `ObjectAutonumerationMode` | `NotAutoFree`, `AutoFree` |
-| `ModalityUseMode` | `DontUse`, `Use`, `UseWithWarnings` |
+| `ModalityUseMode` | `DontUse`, `Use`, `UseWithWarnings` |
-| `SynchronousPlatformExtensionAndAddInCallUseMode` | `DontUse`, `Use`, `UseWithWarnings` |
+| `SynchronousPlatformExtensionAndAddInCallUseMode` | `DontUse`, `Use`, `UseWithWarnings` |
-| `InterfaceCompatibilityMode` | `Version8_2`, `Version8_2EnableTaxi`, `Taxi`, `TaxiEnableVersion8_2`, `TaxiEnableVersion8_5`, `Version8_5EnableTaxi`, `Version8_5` |
+| `InterfaceCompatibilityMode` | `Version8_2`, `Version8_2EnableTaxi`, `Taxi`, `TaxiEnableVersion8_2`, `TaxiEnableVersion8_5`, `Version8_5EnableTaxi`, `Version8_5` |
-| `DatabaseTablespacesUseMode` | `DontUse`, `Use` |
+| `DatabaseTablespacesUseMode` | `DontUse`, `Use` |
-| `MainClientApplicationWindowMode` | `Normal`, `Fullscreen`, `Kiosk` |
+| `MainClientApplicationWindowMode` | `Normal`, `Fullscreen`, `Kiosk` |
-
+
-### Ref
+### Ref
-`DefaultLanguage` — значение вида `Language.Русский`
+`DefaultLanguage` — значение вида `Language.Русский`
-
+
-### Формат batch
+### Формат batch
-`"Version=1.0.0.1 ;; Vendor=Фирма 1С ;; Synonym=Тестовая конфигурация"`
+`"Version=1.0.0.1 ;; Vendor=Фирма 1С ;; Synonym=Тестовая конфигурация"`
-
+
-## add-childObject / remove-childObject
+## add-childObject / remove-childObject
-
+
-Формат: `Type.Name` — XML-тип и имя объекта через точку.
+Формат: `Type.Name` — XML-тип и имя объекта через точку.
-
+
-**Важно про `add-childObject`**: регистрирует в `<ChildObjects>` объект, **файл которого уже существует на диске**. Если файла нет — exit 1. Для создания нового объекта используй профильный навык — `/meta-compile` (Catalog, Document, Enum, Report, регистры и т.д.), `/role-compile` (Role), `/subsystem-compile` (Subsystem). Они создают файл И регистрируют его за один вызов.
+**Важно про `add-childObject`**: регистрирует в `<ChildObjects>` объект, **файл которого уже существует на диске**. Если файла нет — exit 1. Для создания нового объекта используй профильный навык — `/meta-compile` (Catalog, Document, Enum, Report, регистры и т.д.), `/role-compile` (Role), `/subsystem-compile` (Subsystem). Они создают файл И регистрируют его за один вызов.
-
+
-Batch: `"Catalog.Товары ;; Document.Заказ ;; Enum.ВидыОплат"`
+Batch: `"Catalog.Товары ;; Document.Заказ ;; Enum.ВидыОплат"`
-
+
-## add-defaultRole / remove-defaultRole / set-defaultRoles
+## add-defaultRole / remove-defaultRole / set-defaultRoles
-
+
-Имя роли: `ПолныеПрава` или `Role.ПолныеПрава` (префикс `Role.` добавляется автоматически).
+Имя роли: `ПолныеПрава` или `Role.ПолныеПрава` (префикс `Role.` добавляется автоматически).
-
+
-`set-defaultRoles` полностью заменяет список ролей.
+`set-defaultRoles` полностью заменяет список ролей.
-
+
-## set-panels
+## set-panels
-
+
-Перезаписывает `Ext/ClientApplicationInterface.xml` — раскладку панелей рабочего пространства Taxi. Файл создаётся с нуля; то, что не упомянуто в `value`, отсутствует на экране.
+Перезаписывает `Ext/ClientApplicationInterface.xml` — раскладку панелей рабочего пространства Taxi. Файл создаётся с нуля; то, что не упомянуто в `value`, отсутствует на экране.
-
+
-`value` — объект с ключами `top`, `left`, `right`, `bottom`. Каждый ключ — массив записей. Ключ можно опустить (= пустая сторона).
+`value` — объект с ключами `top`, `left`, `right`, `bottom`. Каждый ключ — массив записей. Ключ можно опустить (= пустая сторона).
-
+
-**Запись** — одна из:
+**Запись** — одна из:
-- Строка-алиас (одна панель в этом слоте)
+- Строка-алиас (одна панель в этом слоте)
-- Объект `{"group": [...]}` (стек: панели/подгруппы внутри располагаются друг под другом)
+- Объект `{"group": [...]}` (стек: панели/подгруппы внутри располагаются друг под другом)
-
+
-**Алиасы панелей:**
+**Алиасы панелей:**
-
+
-| Алиас | Панель |
+| Алиас | Панель |
-|-------|--------|
+|-------|--------|
-| `sections` | Панель разделов |
+| `sections` | Панель разделов |
-| `open` | Панель открытых |
+| `open` | Панель открытых |
-| `favorites` | Панель избранного |
+| `favorites` | Панель избранного |
-| `history` | Панель истории |
+| `history` | Панель истории |
-| `functions` | Панель функций текущего раздела |
+| `functions` | Панель функций текущего раздела |
-
+
-**Семантика:**
+**Семантика:**
-- Несколько записей в одной стороне → отдельные слоты «рядом» (несколько тегов `<top>`/...)
+- Несколько записей в одной стороне → отдельные слоты «рядом» (несколько тегов `<top>`/...)
-- `{"group":[...]}` → один тег с `<group>`-обёрткой, элементы внутри идут стеком
+- `{"group":[...]}` → один тег с `<group>`-обёрткой, элементы внутри идут стеком
-
+
-**Пример** (DefinitionFile):
+**Пример** (DefinitionFile):
-```json
+```json
-[
+[
-  {
+  {
-    "operation": "set-panels",
+    "operation": "set-panels",
-    "value": {
+    "value": {
-      "top":    ["open"],
+      "top":    ["open"],
-      "left":   ["sections"],
+      "left":   ["sections"],
-      "right":  [{ "group": ["favorites", "history"] }],
+      "right":  [{ "group": ["favorites", "history"] }],
-      "bottom": ["functions"]
+      "bottom": ["functions"]
-    }
+    }
-  }
+  }
-]
+]
-```
+```
-
+
-Через `-Value` (CLI): передай объект как JSON-строку — `... -Operation set-panels -Value '{"top":["open"]}'`.
+Через `-Value` (CLI): передай объект как JSON-строку — `... -Operation set-panels -Value '{"top":["open"]}'`.
-
+
-## set-home-page
+## set-home-page
-
+
-Перезаписывает `Ext/HomePageWorkArea.xml` — раскладка форм на начальной странице (рабочая область). Файл создаётся с нуля; то, что не упомянуто в `value`, отсутствует.
+Перезаписывает `Ext/HomePageWorkArea.xml` — раскладка форм на начальной странице (рабочая область). Файл создаётся с нуля; то, что не упомянуто в `value`, отсутствует.
-
+
-`value` — объект:
+`value` — объект:
-
+
-| Ключ | Канонич. (XML) | Описание |
+| Ключ | Канонич. (XML) | Описание |
-|------|----------------|----------|
+|------|----------------|----------|
-| `template` | `WorkingAreaTemplate` | `OneColumn` / `TwoColumnsEqualWidth` (дефолт) / `TwoColumnsVariableWidth` |
+| `template` | `WorkingAreaTemplate` | `OneColumn` / `TwoColumnsEqualWidth` (дефолт) / `TwoColumnsVariableWidth` |
-| `left` | `LeftColumn` | массив записей форм |
+| `left` | `LeftColumn` | массив записей форм |
-| `right` | `RightColumn` | массив записей форм (запрещён при `OneColumn`) |
+| `right` | `RightColumn` | массив записей форм (запрещён при `OneColumn`) |
-
+
-Принимаются и короткие и канонич. ключи (XML-имена) — оба работают.
+Принимаются и короткие и канонич. ключи (XML-имена) — оба работают.
-
+
-**Запись формы** — одна из:
+**Запись формы** — одна из:
-- Строка `"<form>"` — только имя формы, дефолты `height=10`, `visibility=true`
+- Строка `"<form>"` — только имя формы, дефолты `height=10`, `visibility=true`
-- Объект `{form, height?, visibility?, roles?}`
+- Объект `{form, height?, visibility?, roles?}`
-
+
-| Поле | Канонич. | Дефолт | Описание |
+| Поле | Канонич. | Дефолт | Описание |
-|------|----------|--------|----------|
+|------|----------|--------|----------|
-| `form` | `Form` | — | `CommonForm.X` или `Type.Object.Form.Name` (или UUID) |
+| `form` | `Form` | — | `CommonForm.X` или `Type.Object.Form.Name` (или UUID) |
-| `height` | `Height` | `10` | Высота |
+| `height` | `Height` | `10` | Высота |
-| `visibility` | `Visibility` | `true` | Общая видимость (`<xr:Common>`) |
+| `visibility` | `Visibility` | `true` | Общая видимость (`<xr:Common>`) |
-| `roles` | — | — | `{"Role.Имя": true|false, ...}` — переопределения по ролям |
+| `roles` | — | — | `{"Role.Имя": true|false, ...}` — переопределения по ролям |
-
+
-**Семантика visibility:** `visibility` = общее правило, `roles` — точечные исключения. Скрыть для всех кроме одной роли: `{"visibility": false, "roles": {"Role.Опер": true}}`.
+**Семантика visibility:** `visibility` = общее правило, `roles` — точечные исключения. Скрыть для всех кроме одной роли: `{"visibility": false, "roles": {"Role.Опер": true}}`.
-
+
-**Пример:**
+**Пример:**
-```json
+```json
-[
+[
-  {
+  {
-    "operation": "set-home-page",
+    "operation": "set-home-page",
-    "value": {
+    "value": {
-      "template": "TwoColumnsVariableWidth",
+      "template": "TwoColumnsVariableWidth",
-      "left": [
+      "left": [
-        "CommonForm.НачалоРаботы",
+        "CommonForm.НачалоРаботы",
-        { "form": "CommonForm.СписокЗадач", "height": 100, "visibility": false },
+        { "form": "CommonForm.СписокЗадач", "height": 100, "visibility": false },
-        { "form": "Catalog.Контрагенты.Form.ФормаСписка", "height": 50 },
+        { "form": "Catalog.Контрагенты.Form.ФормаСписка", "height": 50 },
-        {
+        {
-          "form": "CommonForm.РабочийСтолОператора",
+          "form": "CommonForm.РабочийСтолОператора",
-          "visibility": false,
+          "visibility": false,
-          "roles": { "Role.Оператор": true, "Role.ПолныеПрава": false }
+          "roles": { "Role.Оператор": true, "Role.ПолныеПрава": false }
-        }
+        }
-      ],
+      ],
-      "right": [
+      "right": [
-        { "form": "DataProcessor.Поиск.Form.ФормаПоиска", "height": 30 }
+        { "form": "DataProcessor.Поиск.Form.ФормаПоиска", "height": 30 }
-      ]
+      ]
-    }
+    }
-  }
+  }
-]
+]
-```
+```
-
+
-## DefinitionFile (JSON)
+## DefinitionFile (JSON)
-
+
-```json
+```json
-[
+[
-  { "operation": "modify-property", "value": "Version=2.0.0.1 ;; Vendor=Test" },
+  { "operation": "modify-property", "value": "Version=2.0.0.1 ;; Vendor=Test" },
-  { "operation": "add-childObject", "value": "Catalog.Товары ;; Document.Заказ" },
+  { "operation": "add-childObject", "value": "Catalog.Товары ;; Document.Заказ" },
-  { "operation": "add-defaultRole", "value": "ПолныеПрава" }
+  { "operation": "add-defaultRole", "value": "ПолныеПрава" }
-]
+]
-```
+```
-
+

.claude/skills/cf-edit/scripts/cf-edit.py

@@ -1,16 +1,194 @@
 #!/usr/bin/env python3
-# cf-edit v1.4 — Edit 1C configuration root (Configuration.xml)
+# cf-edit v1.16 — Edit 1C configuration root (Configuration.xml)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
 import json
 import os
+import re
 import subprocess
 import sys
 import uuid as _uuid
 from html import escape as html_escape
 from lxml import etree
 
+
+# ============================================================
+# Support guard (Ext/ParentConfigurations.bin) — see docs/1c-support-state-spec.md
+# Blocks edits of vendor objects "на замке" / read-only configs. Trigger = bin
+# present; reaction from .v8-project.json editingAllowedCheck (deny|warn|off,
+# default deny). Never throws (except sys.exit on deny) — errors degrade to allow.
+# ============================================================
+
+def _sg_root_uuid(xml_path):
+    if not os.path.isfile(xml_path):
+        return None
+    try:
+        mx = etree.parse(xml_path).getroot()
+        for child in mx:
+            if isinstance(child.tag, str) and child.get("uuid"):
+                return child.get("uuid")
+    except Exception:
+        return None
+    return None
+
+
+def _sg_is_external_root(xml_path):
+    if not os.path.isfile(xml_path):
+        return False
+    try:
+        mx = etree.parse(xml_path).getroot()
+        for child in mx:
+            if isinstance(child.tag, str):
+                return child.tag.split("}")[-1] in ("ExternalDataProcessor", "ExternalReport")
+    except Exception:
+        return False
+    return False
+
+def _sg_find_v8project(start_dir):
+    d = start_dir
+    for _ in range(20):
+        if not d:
+            break
+        pj = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pj):
+            return pj
+        parent = os.path.dirname(d)
+        if parent == d:
+            break
+        d = parent
+    return None
+
+
+def _sg_get_edit_mode(cfg_dir):
+    try:
+        pj = _sg_find_v8project(os.getcwd()) or _sg_find_v8project(cfg_dir)
+        if not pj:
+            return "deny"
+        proj = json.loads(open(pj, encoding="utf-8-sig").read())
+        cfg_full = os.path.normcase(os.path.abspath(cfg_dir)).rstrip("\\/")
+        for db in proj.get("databases", []):
+            src = db.get("configSrc")
+            if src:
+                src_full = os.path.normcase(os.path.abspath(src)).rstrip("\\/")
+                if cfg_full == src_full or cfg_full.startswith(src_full + os.sep):
+                    if db.get("editingAllowedCheck"):
+                        return db["editingAllowedCheck"]
+        if proj.get("editingAllowedCheck"):
+            return proj["editingAllowedCheck"]
+        return "deny"
+    except Exception:
+        return "deny"
+
+
+def assert_edit_allowed(target_path, require):
+    try:
+        rp = os.path.abspath(target_path)
+        # Autonomous external object (EPF/ERF): never part of a config on support (issue #39).
+        if _sg_is_external_root(rp):
+            return
+        elem_uuid = _sg_root_uuid(rp)
+        cfg_dir = None
+        bin_path = None
+        d = rp if os.path.isdir(rp) else os.path.dirname(rp)
+        for _ in range(12):
+            if not d:
+                break
+            if _sg_is_external_root(d + ".xml"):
+                return
+            if not elem_uuid:
+                elem_uuid = _sg_root_uuid(d + ".xml")
+            if not cfg_dir:
+                cand = os.path.join(d, "Ext", "ParentConfigurations.bin")
+                if os.path.exists(cand) or os.path.exists(os.path.join(d, "Configuration.xml")):
+                    cfg_dir = d
+                    bin_path = cand
+            if elem_uuid and cfg_dir:
+                break
+            parent = os.path.dirname(d)
+            if parent == d:
+                break
+            d = parent
+        if not elem_uuid and cfg_dir:
+            elem_uuid = _sg_root_uuid(os.path.join(cfg_dir, "Configuration.xml"))
+        if not bin_path or not os.path.exists(bin_path):
+            return
+        data = open(bin_path, "rb").read()
+        if len(data) <= 32:
+            return
+        if data[:3] == b"\xef\xbb\xbf":
+            data = data[3:]
+        text = data.decode("utf-8", "replace")
+        h = re.match(r"\{6,(\d+),(\d+),", text)
+        if not h:
+            return
+        g = int(h.group(1))
+        k = int(h.group(2))
+        if k == 0:
+            return
+        best = None
+        if elem_uuid:
+            for m in re.finditer(r"([0-2]),0," + re.escape(elem_uuid.lower()), text):
+                f1 = int(m.group(1))
+                if best is None or f1 < best:
+                    best = f1
+        blocked = False
+        code = ""
+        reason = ""
+        if g == 1:
+            blocked = True
+            code = "capability-off"
+            reason = "возможность изменения конфигурации выключена (вся конфигурация read-only)"
+        elif require == "removed":
+            if best is not None and best != 2:
+                blocked = True
+                code = "not-removed"
+                reason = "объект не снят с поддержки — удаление сломает обновления"
+        else:
+            if best is not None and best == 0:
+                blocked = True
+                code = "locked"
+                reason = "объект на замке — редактирование сломает обновления"
+        if not blocked:
+            return
+        mode = _sg_get_edit_mode(cfg_dir)
+        if mode == "off":
+            return
+        if mode == "warn":
+            sys.stderr.write(f"[support-guard] ПРЕДУПРЕЖДЕНИЕ: {reason}. Цель: {rp}\n")
+            return
+        head = "[support-guard] Редактирование отклонено: это объект типовой конфигурации на поддержке поставщика, прямое редактирование молча сломает будущие обновления."
+        cfe = "Рекомендуемый путь: внести доработку в расширение (навыки cfe-borrow / cfe-patch-method) — состояние поддержки менять не нужно, обновления вендора сохраняются."
+        off_note = "Снять проверку для этой базы: editingAllowedCheck = warn|off в .v8-project.json."
+        if code == "capability-off":
+            state = f"Состояние: у всей конфигурации выключена возможность изменения (режим read-only «из коробки») — поэтому объект «{rp}» редактировать нельзя."
+            fix = (
+                "Либо снять защиту явно (навык support-edit, два шага):\n"
+                f'  1. support-edit -Path "{cfg_dir}" -Capability on — включить возможность изменения (объекты пока остаются на замке);\n'
+                f'  2. support-edit -Path "{rp}" -Set editable — открыть этот объект для редактирования.\n'
+                "  Изменение применяется в базу полной загрузкой выгрузки и обходит механизм обновлений вендора."
+            )
+        elif code == "not-removed":
+            state = f"Состояние: объект «{rp}» на поддержке (не снят с поддержки) — его удаление разорвёт обновления вендора."
+            fix = (
+                "Либо сначала снять объект с поддержки, затем удалять:\n"
+                f'  support-edit -Path "{rp}" -Set off-support — объект уходит из-под обновлений, после этого удаление безопасно.'
+            )
+        else:
+            state = f"Состояние: объект «{rp}» на замке (возможность изменения конфигурации включена, но сам объект не редактируется)."
+            fix = (
+                "Либо разрешить редактирование этого объекта (навык support-edit, выбрать одно):\n"
+                f'  support-edit -Path "{rp}" -Set editable — редактировать и дальше получать обновления вендора (возможны конфликты слияния);\n'
+                f'  support-edit -Path "{rp}" -Set off-support — снять с поддержки: обновления по объекту больше не приходят.'
+            )
+        sys.stderr.write(head + "\n" + state + "\n" + cfe + "\n" + fix + "\n" + off_note + "\n")
+        sys.exit(1)
+    except SystemExit:
+        raise
+    except Exception:
+        return
+
+
 MD_NS = "http://v8.1c.ru/8.3/MDClasses"
 XR_NS = "http://v8.1c.ru/8.3/xcf/readable"
 XSI_NS = "http://www.w3.org/2001/XMLSchema-instance"
@@ -21,7 +199,7 @@ XS_NS = "http://www.w3.org/2001/XMLSchema"
 TYPE_ORDER = [
     "Language", "Subsystem", "StyleItem", "Style",
     "CommonPicture", "SessionParameter", "Role", "CommonTemplate",
-    "FilterCriterion", "CommonModule", "CommonAttribute", "ExchangePlan",
+    "FilterCriterion", "CommonModule", "Bot", "CommonAttribute", "ExchangePlan",
     "XDTOPackage", "WebService", "HTTPService", "WSReference",
     "EventSubscription", "ScheduledJob", "SettingsStorage", "FunctionalOption",
     "FunctionalOptionsParameter", "DefinedType", "CommonCommand", "CommandGroup",
@@ -37,7 +215,7 @@ TYPE_ORDER = [
 TYPE_TO_DIR = {
     "Language": "Languages", "Subsystem": "Subsystems", "StyleItem": "StyleItems", "Style": "Styles",
     "CommonPicture": "CommonPictures", "SessionParameter": "SessionParameters", "Role": "Roles", "CommonTemplate": "CommonTemplates",
-    "FilterCriterion": "FilterCriteria", "CommonModule": "CommonModules", "CommonAttribute": "CommonAttributes", "ExchangePlan": "ExchangePlans",
+    "FilterCriterion": "FilterCriteria", "CommonModule": "CommonModules", "Bot": "Bots", "CommonAttribute": "CommonAttributes", "ExchangePlan": "ExchangePlans",
     "XDTOPackage": "XDTOPackages", "WebService": "WebServices", "HTTPService": "HTTPServices", "WSReference": "WSReferences",
     "EventSubscription": "EventSubscriptions", "ScheduledJob": "ScheduledJobs", "SettingsStorage": "SettingsStorages", "FunctionalOption": "FunctionalOptions",
     "FunctionalOptionsParameter": "FunctionalOptionsParameters", "DefinedType": "DefinedTypes", "CommonCommand": "CommonCommands", "CommandGroup": "CommandGroups",
@@ -146,13 +324,50 @@ def parse_batch_value(val):
     return items
 
 
-def save_xml_bom(tree, path):
+def _detect_xml_style(path):
-    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    """Стиль существующего файла для round-trip-сохранения: BOM / EOL / регистр encoding /
-    xml_bytes = xml_bytes.replace(b"<?xml version='1.0' encoding='UTF-8'?>", b'<?xml version="1.0" encoding="utf-8"?>')
+    финальный перенос. None → файл новый (сохранить текущее поведение)."""
-    if not xml_bytes.endswith(b"\n"):
+    try:
+        raw = open(path, "rb").read()
+    except OSError:
+        return None
+    bom = raw.startswith(b"\xef\xbb\xbf")
+    body = raw[3:] if bom else raw
+    crlf = b"\r\n" in body
+    m = re.search(rb'encoding="([^"]+)"', body[:200])
+    enc = m.group(1).decode("ascii") if m else "utf-8"
+    final_nl = body.endswith(b"\n")
+    return {"bom": bom, "crlf": crlf, "enc": enc, "final_nl": final_nl}
+
+
+def _finalize_xml_bytes(xml_bytes, style):
+    """Привести байты к стилю оригинала; для НОВОГО файла (style is None) — к канону
+    выгрузки Конфигуратора: encoding="UTF-8", CRLF в разделителях, без перевода в конце."""
+    enc_decl = style["enc"] if style else "UTF-8"
+    xml_bytes = xml_bytes.replace(
+        b"<?xml version='1.0' encoding='UTF-8'?>",
+        b'<?xml version="1.0" encoding="' + enc_decl.encode("ascii") + b'"?>')
+    # Канонизировать переносы к LF (убирает &#13; от \r в tail'ах)
+    xml_bytes = (xml_bytes.replace(b"&#13;\n", b"\n").replace(b"&#13;", b"")
+                 .replace(b"\r\n", b"\n").replace(b"\r", b"\n"))
+    # Финальный перенос — как в оригинале (новый файл → нет, канон #57)
+    want_final_nl = style["final_nl"] if style else False
+    xml_bytes = xml_bytes.rstrip(b"\n")
+    if want_final_nl:
         xml_bytes += b"\n"
+    # EOL — как в оригинале (новый файл → CRLF, канон #57)
+    if (style["crlf"] if style else True):
+        xml_bytes = xml_bytes.replace(b"\n", b"\r\n")
+    return xml_bytes
+
+
+def save_xml_bom(tree, path):
+    style = _detect_xml_style(path)
+    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    xml_bytes = _finalize_xml_bytes(xml_bytes, style)
     with open(path, "wb") as f:
-        f.write(b"\xef\xbb\xbf")
+        if style is None or style["bom"]:
+            f.write(b"\xef\xbb\xbf")
         f.write(xml_bytes)
 
 
@@ -190,10 +405,16 @@ def main():
     resolved_path = os.path.abspath(config_path)
     config_dir = os.path.dirname(resolved_path)
 
+    assert_edit_allowed(resolved_path, "editable")
+
     xml_parser = etree.XMLParser(remove_blank_text=False)
     tree = etree.parse(resolved_path, xml_parser)
     xml_root = tree.getroot()
 
+    # Версия формата редактируемой конфигурации — создаваемые рядом файлы (Ext/HomePageWorkArea.xml)
+    # должны нести ту же версию, иначе в проекте окажутся файлы разных версий формата.
+    format_version = xml_root.get('version') or '2.17'
+
     add_count = 0
     remove_count = 0
     modify_count = 0
@@ -608,6 +829,7 @@ def main():
         "регистррасчета": "CalculationRegister",
         "регистррасчёта": "CalculationRegister",
         "бизнеспроцесс": "BusinessProcess",
+        "бот": "Bot",
         "задача": "Task", "планобмена": "ExchangePlan",
         "хранилищенастроек": "SettingsStorage",
     }
@@ -742,7 +964,7 @@ def main():
             '<HomePageWorkArea xmlns="http://v8.1c.ru/8.3/xcf/extrnprops" '
             'xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" '
             'xmlns:xs="http://www.w3.org/2001/XMLSchema" '
-            'xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">\r\n'
+            f'xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="{format_version}">\r\n'
             f'\t<WorkingAreaTemplate>{tmpl}</WorkingAreaTemplate>\r\n'
             f'{left_xml}\r\n'
             f'{right_xml}\r\n'
@@ -806,7 +1028,7 @@ def main():
         if os.path.isfile(validate_script):
             print()
             print("--- Running cf-validate ---")
-            subprocess.run([sys.executable, validate_script, "-ConfigPath", "-Path", resolved_path])
+            subprocess.run([sys.executable, validate_script, "-ConfigPath", resolved_path])
 
     # --- Summary ---
     print()

.claude/skills/cf-info/SKILL.md

@@ -1,54 +1,54 @@
----
+---
-name: cf-info
+name: cf-info
-description: Анализ структуры конфигурации 1С — свойства, состав, счётчики объектов. Используй для обзора конфигурации — какие объекты есть, сколько их, какие настройки
+description: Анализ структуры конфигурации 1С — свойства, состав, счётчики объектов. Используй для обзора конфигурации — какие объекты есть, сколько их, какие настройки
-argument-hint: <ConfigPath> [-Mode overview|brief|full] [-Section home-page]
+argument-hint: <ConfigPath> [-Mode overview|brief|full] [-Section home-page]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cf-info — Структура конфигурации 1С
+# /cf-info — Структура конфигурации 1С
-
+
-Читает Configuration.xml из выгрузки конфигурации и выводит компактное описание структуры.
+Читает Configuration.xml из выгрузки конфигурации и выводит компактное описание структуры.
-
+
-## Параметры и команда
+## Параметры и команда
-
+
-| Параметр | Описание |
+| Параметр | Описание |
-|----------|----------|
+|----------|----------|
-| `ConfigPath` | Путь к Configuration.xml или каталогу выгрузки |
+| `ConfigPath` | Путь к Configuration.xml или каталогу выгрузки |
-| `Mode` | Режим: `overview` (default), `brief`, `full` |
+| `Mode` | Режим: `overview` (default), `brief`, `full` |
-| `Section` | Drill-down по разделу (alias: `Name`). Сейчас: `home-page` |
+| `Section` | Drill-down по разделу (alias: `Name`). Сейчас: `home-page` |
-| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк) |
+| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк) |
-| `OutFile` | Записать результат в файл (UTF-8 BOM) |
+| `OutFile` | Записать результат в файл (UTF-8 BOM) |
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-info.ps1" -ConfigPath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-info.ps1" -ConfigPath "<путь>"
-```
+```
-
+
-## Три режима
+## Три режима
-
+
-| Режим | Что показывает |
+| Режим | Что показывает |
-|---|---|
+|---|---|
-| `overview` *(default)* | Заголовок + ключевые свойства + таблица счётчиков объектов по типам |
+| `overview` *(default)* | Заголовок + ключевые свойства + таблица счётчиков объектов по типам |
-| `brief` | Одна строка: Имя — "Синоним" vВерсия \| N объектов \| совместимость |
+| `brief` | Одна строка: Имя — "Синоним" vВерсия \| N объектов \| совместимость |
-| `full` | Все свойства по категориям + полный список ChildObjects + DefaultRoles + мобильные функциональности |
+| `full` | Все свойства по категориям + полный список ChildObjects + DefaultRoles + мобильные функциональности |
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Обзор пустой конфигурации
+# Обзор пустой конфигурации
-... -ConfigPath src
+... -ConfigPath src
-
+
-# Краткая сводка реальной конфигурации
+# Краткая сводка реальной конфигурации
-... -ConfigPath src -Mode brief
+... -ConfigPath src -Mode brief
-
+
-# Полная информация
+# Полная информация
-... -ConfigPath src -Mode full
+... -ConfigPath src -Mode full
-
+
-# С пагинацией
+# С пагинацией
-... -ConfigPath src -Mode full -Limit 50 -Offset 100
+... -ConfigPath src -Mode full -Limit 50 -Offset 100
-
+
-# Drill-down: только начальная страница (раскладка форм с ролями)
+# Drill-down: только начальная страница (раскладка форм с ролями)
-... -ConfigPath src -Section home-page
+... -ConfigPath src -Section home-page
-```
+```

.claude/skills/cf-info/scripts/cf-info.py

@@ -1,9 +1,10 @@
 #!/usr/bin/env python3
-# cf-info v1.2 — Compact summary of 1C configuration root
+# cf-info v1.4 — Compact summary of 1C configuration root
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
 import os
+import re
 import sys
 from collections import OrderedDict
 from lxml import etree
@@ -94,7 +95,7 @@ def get_prop_ml(prop_name):
 type_order = [
     "Language", "Subsystem", "StyleItem", "Style",
     "CommonPicture", "SessionParameter", "Role", "CommonTemplate",
-    "FilterCriterion", "CommonModule", "CommonAttribute", "ExchangePlan",
+    "FilterCriterion", "CommonModule", "Bot", "CommonAttribute", "ExchangePlan",
     "XDTOPackage", "WebService", "HTTPService", "WSReference",
     "EventSubscription", "ScheduledJob", "SettingsStorage", "FunctionalOption",
     "FunctionalOptionsParameter", "DefinedType", "CommonCommand", "CommandGroup",
@@ -110,6 +111,7 @@ type_ru_names = {
     "Language": "Языки", "Subsystem": "Подсистемы", "StyleItem": "Элементы стиля", "Style": "Стили",
     "CommonPicture": "Общие картинки", "SessionParameter": "Параметры сеанса", "Role": "Роли",
     "CommonTemplate": "Общие макеты", "FilterCriterion": "Критерии отбора", "CommonModule": "Общие модули",
+    "Bot": "Боты",
     "CommonAttribute": "Общие реквизиты", "ExchangePlan": "Планы обмена", "XDTOPackage": "XDTO-пакеты",
     "WebService": "Веб-сервисы", "HTTPService": "HTTP-сервисы", "WSReference": "WS-ссылки",
     "EventSubscription": "Подписки на события", "ScheduledJob": "Регламентные задания",
@@ -219,6 +221,71 @@ def get_home_page_layout():
 
 home_page = get_home_page_layout()
 
+# --- Support state (Ext/ParentConfigurations.bin) ---
+# Decodes the 1C support-state file. See docs/1c-support-state-spec.md.
+# Returns None on absent/error; else dict: state='absent'|'removed'|'parsed',
+#   g (0=editing on, 1=off), k (vendor configs), vendors [{vendor,name,version}],
+#   counts [locked, editable, removed] by f1 — record tally (k>1 counts each
+#   vendor block separately); only computed when g==0.
+def read_support_state(bin_path):
+    try:
+        if not os.path.isfile(bin_path):
+            return {"state": "absent"}
+        data = open(bin_path, "rb").read()
+        if len(data) <= 32:
+            return {"state": "removed"}
+        if data[:3] == b"\xef\xbb\xbf":
+            data = data[3:]
+        text = data.decode("utf-8", "replace")
+        h = re.match(r"\{6,(\d+),(\d+),", text)
+        if not h:
+            return None
+        g = int(h.group(1))
+        k = int(h.group(2))
+        if k == 0:
+            return {"state": "removed"}
+        vendors = []
+        for m in re.finditer(r'"((?:[^"]|"")*)","((?:[^"]|"")*)","((?:[^"]|"")*)",\d+,', text):
+            vendors.append({
+                "version": m.group(1).replace('""', '"'),
+                "vendor": m.group(2).replace('""', '"'),
+                "name": m.group(3).replace('""', '"'),
+            })
+        counts = None
+        if g == 0:
+            counts = [0, 0, 0]
+            for m in re.finditer(r"([0-2]),0,[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}", text):
+                counts[int(m.group(1))] += 1
+        return {"state": "parsed", "g": g, "k": k, "vendors": vendors, "counts": counts}
+    except Exception:
+        return None
+
+def get_support_lines():
+    config_dir = os.path.dirname(config_path)
+    bin_path = os.path.join(config_dir, "Ext", "ParentConfigurations.bin")
+    st = read_support_state(bin_path)
+    res = []
+    if not st or st["state"] == "absent":
+        if cfg_ext_purpose:
+            res.append("Поддержка:      расширение (CFE), правки свободны")
+        else:
+            res.append("Поддержка:      не на поддержке (своя конфигурация)")
+        return res
+    if st["state"] == "removed":
+        res.append("Поддержка:      снята с поддержки полностью")
+        return res
+    res.append("Поддержка:      на поддержке")
+    if st["g"] == 0:
+        res.append("  Возможность изменения: включена")
+        res.append(f"  Объектов: на замке {st['counts'][0]} / редактируется {st['counts'][1]} / снято {st['counts'][2]}")
+    else:
+        res.append("  Возможность изменения: выключена — вся конфигурация read-only (правки заблокированы)")
+    res.append(f"  Конфигураций поставщика: {st['k']}")
+    if st["k"] > 1:
+        for v in st["vendors"]:
+            res.append(f"  Поставщик: {v['vendor']} — {v['name']} {v['version']}")
+    return res
+
 def format_home_page_item(it, detailed):
     badges = [f"h={it['height']}"]
     if not it["common"]:
@@ -249,6 +316,7 @@ cfg_version = get_prop_text("Version")
 cfg_vendor = get_prop_text("Vendor")
 cfg_compat = get_prop_text("CompatibilityMode")
 cfg_ext_compat = get_prop_text("ConfigurationExtensionCompatibilityMode")
+cfg_ext_purpose = get_prop_text("ConfigurationExtensionPurpose")
 cfg_default_run = get_prop_text("DefaultRunMode")
 cfg_script = get_prop_text("ScriptVariant")
 cfg_default_lang = get_prop_text("DefaultLanguage")
@@ -281,6 +349,8 @@ if args.Mode == "overview" and not args.Section:
         out(f"Поставщик:      {cfg_vendor}")
     if cfg_version:
         out(f"Версия:         {cfg_version}")
+    for ln in get_support_lines():
+        out(ln)
     out(f"Совместимость:  {cfg_compat}")
     out(f"Режим запуска:  {cfg_default_run}")
     out(f"Язык скриптов:  {cfg_script}")
@@ -369,6 +439,8 @@ if args.Mode == "full" and not args.Section:
         out(f"Поставщик:      {cfg_vendor}")
     if cfg_version:
         out(f"Версия:         {cfg_version}")
+    for ln in get_support_lines():
+        out(ln)
     cfg_update_addr = get_prop_text("UpdateCatalogAddress")
     if cfg_update_addr:
         out(f"Каталог обн.:   {cfg_update_addr}")

.claude/skills/cf-init/SKILL.md

@@ -1,49 +1,49 @@
----
+---
-name: cf-init
+name: cf-init
-description: Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля
+description: Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля
-argument-hint: <Name> [-Synonym <name>] [-OutputDir src]
+argument-hint: <Name> [-Synonym <name>] [-OutputDir src]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cf-init — Создание пустой конфигурации 1С
+# /cf-init — Создание пустой конфигурации 1С
-
+
-Создаёт scaffold исходников пустой конфигурации 1С: `Configuration.xml`, `Languages/Русский.xml`.
+Создаёт scaffold исходников пустой конфигурации 1С: `Configuration.xml`, `Languages/Русский.xml`.
-
+
-## Параметры и команда
+## Параметры и команда
-
+
-| Параметр | Описание |
+| Параметр | Описание |
-|----------|----------|
+|----------|----------|
-| `Name` | Имя конфигурации (обязат.) |
+| `Name` | Имя конфигурации (обязат.) |
-| `Synonym` | Синоним (= Name если не указан) |
+| `Synonym` | Синоним (= Name если не указан) |
-| `OutputDir` | Каталог для создания (default: `src`) |
+| `OutputDir` | Каталог для создания (default: `src`) |
-| `Version` | Версия конфигурации |
+| `Version` | Версия конфигурации |
-| `Vendor` | Поставщик |
+| `Vendor` | Поставщик |
-| `CompatibilityMode` | Режим совместимости (default: `Version8_3_24`) |
+| `CompatibilityMode` | Режим совместимости (default: `Version8_3_24`) |
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-init.ps1" -Name "МояКонфигурация"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-init.ps1" -Name "МояКонфигурация"
-```
+```
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Базовая конфигурация
+# Базовая конфигурация
-... -Name МояКонфигурация -Synonym "Моя конфигурация" -OutputDir test-tmp/cf
+... -Name МояКонфигурация -Synonym "Моя конфигурация" -OutputDir test-tmp/cf
-
+
-# С версией и поставщиком
+# С версией и поставщиком
-... -Name TestCfg -Synonym "Тестовая" -Version "1.0.0.1" -Vendor "Фирма 1С" -OutputDir test-tmp/cf2
+... -Name TestCfg -Synonym "Тестовая" -Version "1.0.0.1" -Vendor "Фирма 1С" -OutputDir test-tmp/cf2
-
+
-# Другой режим совместимости
+# Другой режим совместимости
-... -Name TestCfg -CompatibilityMode Version8_3_27 -OutputDir test-tmp/cf3
+... -Name TestCfg -CompatibilityMode Version8_3_27 -OutputDir test-tmp/cf3
-```
+```
-
+
-## Верификация
+## Верификация
-
+
-```
+```
-/cf-init TestConfig -OutputDir test-tmp/cf
+/cf-init TestConfig -OutputDir test-tmp/cf
-/cf-info test-tmp/cf          — проверить созданное
+/cf-info test-tmp/cf          — проверить созданное
-/cf-validate test-tmp/cf      — валидировать
+/cf-validate test-tmp/cf      — валидировать
-```
+```

.claude/skills/cf-init/scripts/cf-init.ps1

@@ -1,249 +1,295 @@
-# cf-init v1.2 — Create empty 1C configuration scaffold
+# cf-init v1.8 — Create empty 1C configuration scaffold
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-param(
+param(
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$Name,
+	[string]$Name,
-	[string]$Synonym = $Name,
+	[string]$Synonym = $Name,
-	[string]$OutputDir = "src",
+	[string]$OutputDir = "src",
-	[string]$Version,
+	[string]$Version,
-	[string]$Vendor,
+	[string]$Vendor,
-	[string]$CompatibilityMode = "Version8_3_24"
+	[string]$CompatibilityMode = "Version8_3_24",
-)
+	# Версия формата выгрузки (MDClasses). Её задаёт ПЛАТФОРМА, которой выгружают, и от режима
-
+	# совместимости она не зависит: 8.3.20-8.3.24 пишут 2.17, 8.3.25 — 2.18, 8.3.26 — 2.19,
-$ErrorActionPreference = "Stop"
+	# 8.3.27 — 2.20. Дефолт консервативный: 2.17 читается всеми поддерживаемыми платформами.
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+	[ValidateSet("2.17", "2.18", "2.19", "2.20", "2.21")]
-
+	[string]$FormatVersion = "2.17"
-# --- Resolve output dir ---
+)
-if (-not [System.IO.Path]::IsPathRooted($OutputDir)) {
+
-	$OutputDir = Join-Path (Get-Location).Path $OutputDir
+$ErrorActionPreference = "Stop"
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-# --- Check existing ---
+# --- Resolve output dir ---
-$cfgFile = Join-Path $OutputDir "Configuration.xml"
+if (-not [System.IO.Path]::IsPathRooted($OutputDir)) {
-if (Test-Path $cfgFile) {
+	$OutputDir = Join-Path (Get-Location).Path $OutputDir
-	Write-Error "Configuration.xml already exists: $cfgFile"
+}
-	exit 1
+
-}
+# --- Check existing ---
-
+$cfgFile = Join-Path $OutputDir "Configuration.xml"
-# --- Generate UUIDs ---
+if (Test-Path $cfgFile) {
-$uuidCfg  = [guid]::NewGuid().ToString()
+	Write-Error "Configuration.xml already exists: $cfgFile"
-$uuidLang = [guid]::NewGuid().ToString()
+	exit 1
-# 7 ContainedObject ObjectIds
+}
-$co1 = [guid]::NewGuid().ToString()
+
-$co2 = [guid]::NewGuid().ToString()
+# --- Generate UUIDs ---
-$co3 = [guid]::NewGuid().ToString()
+$uuidCfg  = [guid]::NewGuid().ToString()
-$co4 = [guid]::NewGuid().ToString()
+$uuidLang = [guid]::NewGuid().ToString()
-$co5 = [guid]::NewGuid().ToString()
+# 7 ContainedObject ObjectIds
-$co6 = [guid]::NewGuid().ToString()
+$co1 = [guid]::NewGuid().ToString()
-$co7 = [guid]::NewGuid().ToString()
+$co2 = [guid]::NewGuid().ToString()
-
+$co3 = [guid]::NewGuid().ToString()
-# --- Mobile functionalities ---
+$co4 = [guid]::NewGuid().ToString()
-$mobileFuncs = @(
+$co5 = [guid]::NewGuid().ToString()
-	@("Biometrics","true"), @("Location","false"), @("BackgroundLocation","false"),
+$co6 = [guid]::NewGuid().ToString()
-	@("BluetoothPrinters","false"), @("WiFiPrinters","false"), @("Contacts","false"),
+$co7 = [guid]::NewGuid().ToString()
-	@("Calendars","false"), @("PushNotifications","false"), @("LocalNotifications","false"),
+
-	@("InAppPurchases","false"), @("PersonalComputerFileExchange","false"), @("Ads","false"),
+# --- Mobile functionalities ---
-	@("NumberDialing","false"), @("CallProcessing","false"), @("CallLog","false"),
+# Версия формата как число — по ней ниже включаются вставки 2.21.
-	@("AutoSendSMS","false"), @("ReceiveSMS","false"), @("SMSLog","false"),
+$is221 = (($FormatVersion -match '^(\d+)\.(\d+)$') -and ([int]$Matches[1] * 100 + [int]$Matches[2]) -ge 221)
-	@("Camera","false"), @("Microphone","false"), @("MusicLibrary","false"),
+
-	@("PictureAndVideoLibraries","false"), @("AudioPlaybackAndVibration","false"),
+$mobileFuncs = @(
-	@("BackgroundAudioPlaybackAndVibration","false"), @("InstallPackages","false"),
+	@("Biometrics","true"), @("Location","false"), @("BackgroundLocation","false"),
-	@("OSBackup","true"), @("ApplicationUsageStatistics","false"),
+	@("BluetoothPrinters","false"), @("WiFiPrinters","false"), @("Contacts","false"),
-	@("BarcodeScanning","false"), @("BackgroundAudioRecording","false"),
+	@("Calendars","false"), @("PushNotifications","false"), @("LocalNotifications","false"),
-	@("AllFilesAccess","false"), @("Videoconferences","false"), @("NFC","false"),
+	@("InAppPurchases","false"), @("PersonalComputerFileExchange","false"), @("Ads","false"),
-	@("DocumentScanning","false"), @("SpeechToText","false"), @("Geofences","false"),
+	@("NumberDialing","false"), @("CallProcessing","false"), @("CallLog","false"),
-	@("IncomingShareRequests","false"), @("AllIncomingShareRequestsTypesProcessing","false")
+	@("AutoSendSMS","false"), @("ReceiveSMS","false"), @("SMSLog","false"),
-)
+	@("Camera","false"), @("Microphone","false"), @("MusicLibrary","false"),
-
+	@("PictureAndVideoLibraries","false"), @("AudioPlaybackAndVibration","false"),
-$mobileXml = ""
+	@("BackgroundAudioPlaybackAndVibration","false"), @("InstallPackages","false"),
-foreach ($mf in $mobileFuncs) {
+	@("OSBackup","true"), @("ApplicationUsageStatistics","false"),
-	$mobileXml += "`r`n`t`t`t`t<app:functionality>`r`n`t`t`t`t`t<app:functionality>$($mf[0])</app:functionality>`r`n`t`t`t`t`t<app:use>$($mf[1])</app:use>`r`n`t`t`t`t</app:functionality>"
+	@("BarcodeScanning","false"), @("BackgroundAudioRecording","false"),
-}
+	@("AllFilesAccess","false"), @("Videoconferences","false"), @("NFC","false"),
-
+	@("DocumentScanning","false"), @("SpeechToText","false"), @("Geofences","false"),
-# --- Synonym XML ---
+	@("IncomingShareRequests","false"), @("AllIncomingShareRequestsTypesProcessing","false")
-$synonymXml = ""
+)
-if ($Synonym) {
+# TextToSpeech — возможность мобильного приложения, добавленная форматом 2.21 (8.5),
-	$synonymXml = "`r`n`t`t`t`t<v8:item>`r`n`t`t`t`t`t<v8:lang>ru</v8:lang>`r`n`t`t`t`t`t<v8:content>$([System.Security.SecurityElement]::Escape($Synonym))</v8:content>`r`n`t`t`t`t</v8:item>`r`n`t`t`t"
+# последней в списке. На младших форматах платформа её не пишет.
-}
+if ($is221) { $mobileFuncs += ,@("TextToSpeech","false") }
-
+
-# --- Optional properties ---
+$mobileXml = ""
-$vendorXml = if ($Vendor) { [System.Security.SecurityElement]::Escape($Vendor) } else { "" }
+foreach ($mf in $mobileFuncs) {
-$versionXml = if ($Version) { [System.Security.SecurityElement]::Escape($Version) } else { "" }
+	$mobileXml += "`r`n`t`t`t`t<app:functionality>`r`n`t`t`t`t`t<app:functionality>$($mf[0])</app:functionality>`r`n`t`t`t`t`t<app:use>$($mf[1])</app:use>`r`n`t`t`t`t</app:functionality>"
-
+}
-# --- Configuration.xml ---
+
-$cfgXml = @"
+# --- Synonym XML ---
-<?xml version="1.0" encoding="UTF-8"?>
+$synonymXml = ""
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+if ($Synonym) {
-	<Configuration uuid="$uuidCfg">
+	$synonymXml = "`r`n`t`t`t`t<v8:item>`r`n`t`t`t`t`t<v8:lang>ru</v8:lang>`r`n`t`t`t`t`t<v8:content>$([System.Security.SecurityElement]::Escape($Synonym))</v8:content>`r`n`t`t`t`t</v8:item>`r`n`t`t`t"
-		<InternalInfo>
+}
-			<xr:ContainedObject>
+
-				<xr:ClassId>9cd510cd-abfc-11d4-9434-004095e12fc7</xr:ClassId>
+# --- Optional properties ---
-				<xr:ObjectId>$co1</xr:ObjectId>
+# Элемент целиком, а не значение внутри пары: при пустом значении Конфигуратор
-			</xr:ContainedObject>
+# пишет <Vendor/>, а не <Vendor></Vendor>.
-			<xr:ContainedObject>
+$vendorEl = if ($Vendor) { "<Vendor>$([System.Security.SecurityElement]::Escape($Vendor))</Vendor>" } else { "<Vendor/>" }
-				<xr:ClassId>9fcd25a0-4822-11d4-9414-008048da11f9</xr:ClassId>
+$versionEl = if ($Version) { "<Version>$([System.Security.SecurityElement]::Escape($Version))</Version>" } else { "<Version/>" }
-				<xr:ObjectId>$co2</xr:ObjectId>
+
-			</xr:ContainedObject>
+# --- Свойства и пространство имён формата 2.21 (платформа 8.5) ---
-			<xr:ContainedObject>
+# Значения и ПОЗИЦИИ сняты с выгрузки 8.5.1 (debug/fmt221/dump_v851): те же исходники,
-				<xr:ClassId>e3687481-0a87-462c-a166-9f34594f9bba</xr:ClassId>
+# выгруженные с 8.3.27 и с 8.5.1, различаются ровно этим. Порядок важен — вставки идут
-				<xr:ObjectId>$co3</xr:ObjectId>
+# на своё место, а не в конец.
-			</xr:ContainedObject>
+$nl = "`r`n"
-			<xr:ContainedObject>
+$f221AuxForms = ""; $f221WindowVariant = ""; $f221OpenVariant = ""; $f221Captions = ""; $f221Migration = ""
-				<xr:ClassId>9de14907-ec23-4a07-96f0-85521cb6b53b</xr:ClassId>
+$palNs = ""
-				<xr:ObjectId>$co4</xr:ObjectId>
+if ($is221) {
-			</xr:ContainedObject>
+	$palNs = ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette"'
-			<xr:ContainedObject>
+	# Скобки вокруг -join обязательны: без них `$nl + (массив) -join $nl` разбирается как
-				<xr:ClassId>51f2d5d8-ea4d-4064-8892-82951750031e</xr:ClassId>
+	# `($nl + массив) -join $nl`, массив склеивается пробелами и все теги уезжают в одну строку.
-				<xr:ObjectId>$co5</xr:ObjectId>
+	$f221AuxForms = $nl + ((@(
-			</xr:ContainedObject>
+		"<AuxiliaryReportForm/>", "<AuxiliaryReportVariantForm/>", "<AuxiliaryReportSettingsForm/>",
-			<xr:ContainedObject>
+		"<AuxiliaryDynamicListSettingsForm/>", "<AuxiliaryDataHistoryChangeHistoryForm/>",
-				<xr:ClassId>e68182ea-4237-4383-967f-90c1e3370bc7</xr:ClassId>
+		"<AuxiliaryDataHistoryVersionDataForm/>", "<AuxiliaryDataHistoryVersionDifferencesForm/>",
-				<xr:ObjectId>$co6</xr:ObjectId>
+		"<AuxiliaryCollaborationSystemUsersChoiceForm/>"
-			</xr:ContainedObject>
+	) | ForEach-Object { "`t`t`t$_" }) -join $nl)
-			<xr:ContainedObject>
+	$f221WindowVariant = $nl + "`t`t`t<MainClientApplicationWindowInterfaceVariant>NavigationLeft</MainClientApplicationWindowInterfaceVariant>" +
-				<xr:ClassId>fb282519-d103-4dd3-bc12-cb271d631dfc</xr:ClassId>
+		$nl + "`t`t`t<ClientApplicationTheme>Auto</ClientApplicationTheme>"
-				<xr:ObjectId>$co7</xr:ObjectId>
+	$f221OpenVariant = $nl + "`t`t`t<ClientApplicationWindowsOpenVariant>OpenDataInDialogs</ClientApplicationWindowsOpenVariant>"
-			</xr:ContainedObject>
+	$f221Captions = $nl + "`t`t`t<Caption/>" + $nl + "`t`t`t<ShortCaption/>"
-		</InternalInfo>
+	$f221Migration = $nl + "`t`t`t<Version85InterfaceMigrationMode>DontUse</Version85InterfaceMigrationMode>"
-		<Properties>
+}
-			<Name>$([System.Security.SecurityElement]::Escape($Name))</Name>
+
-			<Synonym>$synonymXml</Synonym>
+# --- Configuration.xml ---
-			<Comment/>
+$cfgXml = @"
-			<NamePrefix/>
+<?xml version="1.0" encoding="UTF-8"?>
-			<ConfigurationExtensionCompatibilityMode>$CompatibilityMode</ConfigurationExtensionCompatibilityMode>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"$palNs xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="$FormatVersion">
-			<DefaultRunMode>ManagedApplication</DefaultRunMode>
+	<Configuration uuid="$uuidCfg">
-			<UsePurposes>
+		<InternalInfo>
-				<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
+			<xr:ContainedObject>
-			</UsePurposes>
+				<xr:ClassId>9cd510cd-abfc-11d4-9434-004095e12fc7</xr:ClassId>
-			<ScriptVariant>Russian</ScriptVariant>
+				<xr:ObjectId>$co1</xr:ObjectId>
-			<DefaultRoles/>
+			</xr:ContainedObject>
-			<Vendor>$vendorXml</Vendor>
+			<xr:ContainedObject>
-			<Version>$versionXml</Version>
+				<xr:ClassId>9fcd25a0-4822-11d4-9414-008048da11f9</xr:ClassId>
-			<UpdateCatalogAddress/>
+				<xr:ObjectId>$co2</xr:ObjectId>
-			<IncludeHelpInContents>false</IncludeHelpInContents>
+			</xr:ContainedObject>
-			<UseManagedFormInOrdinaryApplication>false</UseManagedFormInOrdinaryApplication>
+			<xr:ContainedObject>
-			<UseOrdinaryFormInManagedApplication>false</UseOrdinaryFormInManagedApplication>
+				<xr:ClassId>e3687481-0a87-462c-a166-9f34594f9bba</xr:ClassId>
-			<AdditionalFullTextSearchDictionaries/>
+				<xr:ObjectId>$co3</xr:ObjectId>
-			<CommonSettingsStorage/>
+			</xr:ContainedObject>
-			<ReportsUserSettingsStorage/>
+			<xr:ContainedObject>
-			<ReportsVariantsStorage/>
+				<xr:ClassId>9de14907-ec23-4a07-96f0-85521cb6b53b</xr:ClassId>
-			<FormDataSettingsStorage/>
+				<xr:ObjectId>$co4</xr:ObjectId>
-			<DynamicListsUserSettingsStorage/>
+			</xr:ContainedObject>
-			<URLExternalDataStorage/>
+			<xr:ContainedObject>
-			<Content/>
+				<xr:ClassId>51f2d5d8-ea4d-4064-8892-82951750031e</xr:ClassId>
-			<DefaultReportForm/>
+				<xr:ObjectId>$co5</xr:ObjectId>
-			<DefaultReportVariantForm/>
+			</xr:ContainedObject>
-			<DefaultReportSettingsForm/>
+			<xr:ContainedObject>
-			<DefaultReportAppearanceTemplate/>
+				<xr:ClassId>e68182ea-4237-4383-967f-90c1e3370bc7</xr:ClassId>
-			<DefaultDynamicListSettingsForm/>
+				<xr:ObjectId>$co6</xr:ObjectId>
-			<DefaultSearchForm/>
+			</xr:ContainedObject>
-			<DefaultDataHistoryChangeHistoryForm/>
+			<xr:ContainedObject>
-			<DefaultDataHistoryVersionDataForm/>
+				<xr:ClassId>fb282519-d103-4dd3-bc12-cb271d631dfc</xr:ClassId>
-			<DefaultDataHistoryVersionDifferencesForm/>
+				<xr:ObjectId>$co7</xr:ObjectId>
-			<DefaultCollaborationSystemUsersChoiceForm/>
+			</xr:ContainedObject>
-			<RequiredMobileApplicationPermissions/>
+		</InternalInfo>
-			<UsedMobileApplicationFunctionalities>$mobileXml
+		<Properties>
-			</UsedMobileApplicationFunctionalities>
+			<Name>$([System.Security.SecurityElement]::Escape($Name))</Name>
-			<StandaloneConfigurationRestrictionRoles/>
+			<Synonym>$synonymXml</Synonym>
-			<MobileApplicationURLs/>
+			<Comment/>
-			<AllowedIncomingShareRequestTypes/>
+			<NamePrefix/>
-			<MainClientApplicationWindowMode>Normal</MainClientApplicationWindowMode>
+			<ConfigurationExtensionCompatibilityMode>$CompatibilityMode</ConfigurationExtensionCompatibilityMode>
-			<DefaultInterface/>
+			<DefaultRunMode>ManagedApplication</DefaultRunMode>
-			<DefaultStyle/>
+			<UsePurposes>
-			<DefaultLanguage>Language.Русский</DefaultLanguage>
+				<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
-			<BriefInformation/>
+			</UsePurposes>
-			<DetailedInformation/>
+			<ScriptVariant>Russian</ScriptVariant>
-			<Copyright/>
+			<DefaultRoles/>
-			<VendorInformationAddress/>
+			$vendorEl
-			<ConfigurationInformationAddress/>
+			$versionEl
-			<DataLockControlMode>Managed</DataLockControlMode>
+			<UpdateCatalogAddress/>
-			<ObjectAutonumerationMode>NotAutoFree</ObjectAutonumerationMode>
+			<IncludeHelpInContents>false</IncludeHelpInContents>
-			<ModalityUseMode>DontUse</ModalityUseMode>
+			<UseManagedFormInOrdinaryApplication>false</UseManagedFormInOrdinaryApplication>
-			<SynchronousPlatformExtensionAndAddInCallUseMode>DontUse</SynchronousPlatformExtensionAndAddInCallUseMode>
+			<UseOrdinaryFormInManagedApplication>false</UseOrdinaryFormInManagedApplication>
-			<InterfaceCompatibilityMode>TaxiEnableVersion8_2</InterfaceCompatibilityMode>
+			<AdditionalFullTextSearchDictionaries/>
-			<DatabaseTablespacesUseMode>DontUse</DatabaseTablespacesUseMode>
+			<CommonSettingsStorage/>
-			<CompatibilityMode>$CompatibilityMode</CompatibilityMode>
+			<ReportsUserSettingsStorage/>
-			<DefaultConstantsForm/>
+			<ReportsVariantsStorage/>
-		</Properties>
+			<FormDataSettingsStorage/>
-		<ChildObjects>
+			<DynamicListsUserSettingsStorage/>
-			<Language>Русский</Language>
+			<URLExternalDataStorage/>
-		</ChildObjects>
+			<Content/>
-	</Configuration>
+			<DefaultReportForm/>
-</MetaDataObject>
+			<DefaultReportVariantForm/>
-"@
+			<DefaultReportSettingsForm/>
-
+			<DefaultReportAppearanceTemplate/>
-# --- Languages/Русский.xml ---
+			<DefaultDynamicListSettingsForm/>
-$langXml = @"
+			<DefaultSearchForm/>
-<?xml version="1.0" encoding="UTF-8"?>
+			<DefaultDataHistoryChangeHistoryForm/>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+			<DefaultDataHistoryVersionDataForm/>
-	<Language uuid="$uuidLang">
+			<DefaultDataHistoryVersionDifferencesForm/>
-		<Properties>
+			<DefaultCollaborationSystemUsersChoiceForm/>$f221AuxForms
-			<Name>Русский</Name>
+			<RequiredMobileApplicationPermissions/>
-			<Synonym>
+			<UsedMobileApplicationFunctionalities>$mobileXml
-				<v8:item>
+			</UsedMobileApplicationFunctionalities>
-					<v8:lang>ru</v8:lang>
+			<StandaloneConfigurationRestrictionRoles/>
-					<v8:content>Русский</v8:content>
+			<MobileApplicationURLs/>
-				</v8:item>
+			<AllowedIncomingShareRequestTypes/>$f221WindowVariant
-			</Synonym>
+			<MainClientApplicationWindowMode>Normal</MainClientApplicationWindowMode>$f221OpenVariant
-			<Comment/>
+			<DefaultInterface/>$f221Captions
-			<LanguageCode>ru</LanguageCode>
+			<DefaultStyle/>
-		</Properties>
+			<DefaultLanguage>Language.Русский</DefaultLanguage>
-	</Language>
+			<BriefInformation/>
-</MetaDataObject>
+			<DetailedInformation/>
-"@
+			<Copyright/>
-
+			<VendorInformationAddress/>
-# --- Ext/ClientApplicationInterface.xml (default ERP-style panel layout) ---
+			<ConfigurationInformationAddress/>
-# Open panel on top, Sections panel on left; Functions/Favorites/History declared
+			<DataLockControlMode>Managed</DataLockControlMode>
-# via panelDef but not placed by default. Without this file the web client renders
+			<ObjectAutonumerationMode>NotAutoFree</ObjectAutonumerationMode>
-# section icons without labels (icon-only mode).
+			<ModalityUseMode>DontUse</ModalityUseMode>
-$openPanelInst = [guid]::NewGuid().ToString()
+			<SynchronousPlatformExtensionAndAddInCallUseMode>DontUse</SynchronousPlatformExtensionAndAddInCallUseMode>
-$sectionsPanelInst = [guid]::NewGuid().ToString()
+			<InterfaceCompatibilityMode>TaxiEnableVersion8_2</InterfaceCompatibilityMode>$f221Migration
-$caiXml = @"
+			<DatabaseTablespacesUseMode>DontUse</DatabaseTablespacesUseMode>
-<?xml version="1.0" encoding="UTF-8"?>
+			<CompatibilityMode>$CompatibilityMode</CompatibilityMode>
-<ClientApplicationInterface xmlns="http://v8.1c.ru/8.2/managed-application/core" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="InterfaceLayouter">
+			<DefaultConstantsForm/>
-	<top>
+		</Properties>
-		<panel id="$openPanelInst">
+		<ChildObjects>
-			<uuid>cbab57f2-a0f3-4f0a-89ea-4cb19570ab75</uuid>
+			<Language>Русский</Language>
-		</panel>
+		</ChildObjects>
-	</top>
+	</Configuration>
-	<left>
+</MetaDataObject>
-		<panel id="$sectionsPanelInst">
+"@
-			<uuid>b553047f-c9aa-4157-978d-448ecad24248</uuid>
+
-		</panel>
+# --- Languages/Русский.xml ---
-	</left>
+$langXml = @"
-	<panelDef id="b553047f-c9aa-4157-978d-448ecad24248"/>
+<?xml version="1.0" encoding="UTF-8"?>
-	<panelDef id="13322b22-3960-4d68-93a6-fe2dd7f28ca3"/>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"$palNs xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="$FormatVersion">
-	<panelDef id="c933ac92-92cd-459d-81cc-e0c8a83ced99"/>
+	<Language uuid="$uuidLang">
-	<panelDef id="cbab57f2-a0f3-4f0a-89ea-4cb19570ab75"/>
+		<Properties>
-	<panelDef id="b2735bd3-d822-4430-ba59-c9e869693b24"/>
+			<Name>Русский</Name>
-</ClientApplicationInterface>
+			<Synonym>
-"@
+				<v8:item>
-
+					<v8:lang>ru</v8:lang>
-# --- Create directories ---
+					<v8:content>Русский</v8:content>
-if (-not (Test-Path $OutputDir)) {
+				</v8:item>
-	New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+			</Synonym>
-}
+			<Comment/>
-$langDir = Join-Path $OutputDir "Languages"
+			<LanguageCode>ru</LanguageCode>
-if (-not (Test-Path $langDir)) {
+		</Properties>
-	New-Item -ItemType Directory -Path $langDir -Force | Out-Null
+	</Language>
-}
+</MetaDataObject>
-$extDir = Join-Path $OutputDir "Ext"
+"@
-if (-not (Test-Path $extDir)) {
+
-	New-Item -ItemType Directory -Path $extDir -Force | Out-Null
+# --- Ext/ClientApplicationInterface.xml (default ERP-style panel layout) ---
-}
+# Open panel on top, Sections panel on left; Functions/Favorites/History declared
-
+# via panelDef but not placed by default. Without this file the web client renders
-# --- Write files with UTF-8 BOM ---
+# section icons without labels (icon-only mode).
-$enc = New-Object System.Text.UTF8Encoding($true)
+$openPanelInst = [guid]::NewGuid().ToString()
-
+$sectionsPanelInst = [guid]::NewGuid().ToString()
-[System.IO.File]::WriteAllText($cfgFile, $cfgXml, $enc)
+$caiXml = @"
-$langFile = Join-Path $langDir "Русский.xml"
+<?xml version="1.0" encoding="UTF-8"?>
-[System.IO.File]::WriteAllText($langFile, $langXml, $enc)
+<ClientApplicationInterface xmlns="http://v8.1c.ru/8.2/managed-application/core" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="InterfaceLayouter">
-$caiFile = Join-Path $extDir "ClientApplicationInterface.xml"
+	<top>
-[System.IO.File]::WriteAllText($caiFile, $caiXml, $enc)
+		<panel id="$openPanelInst">
-
+			<uuid>cbab57f2-a0f3-4f0a-89ea-4cb19570ab75</uuid>
-# --- Output ---
+		</panel>
-Write-Host "[OK] Создана конфигурация: $Name"
+	</top>
-Write-Host "     Каталог:            $OutputDir"
+	<left>
-Write-Host "     Configuration.xml:  $cfgFile"
+		<panel id="$sectionsPanelInst">
-Write-Host "     Languages:          $langFile"
+			<uuid>b553047f-c9aa-4157-978d-448ecad24248</uuid>
-Write-Host "     Ext/CAI:            $caiFile"
+		</panel>
+	</left>
+	<panelDef id="b553047f-c9aa-4157-978d-448ecad24248"/>
+	<panelDef id="13322b22-3960-4d68-93a6-fe2dd7f28ca3"/>
+	<panelDef id="c933ac92-92cd-459d-81cc-e0c8a83ced99"/>
+	<panelDef id="cbab57f2-a0f3-4f0a-89ea-4cb19570ab75"/>
+	<panelDef id="b2735bd3-d822-4430-ba59-c9e869693b24"/>
+</ClientApplicationInterface>
+"@
+
+# --- Create directories ---
+if (-not (Test-Path $OutputDir)) {
+	New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+}
+$langDir = Join-Path $OutputDir "Languages"
+if (-not (Test-Path $langDir)) {
+	New-Item -ItemType Directory -Path $langDir -Force | Out-Null
+}
+$extDir = Join-Path $OutputDir "Ext"
+if (-not (Test-Path $extDir)) {
+	New-Item -ItemType Directory -Path $extDir -Force | Out-Null
+}
+
+# --- Write files with UTF-8 BOM ---
+$enc = New-Object System.Text.UTF8Encoding($true)
+
+# XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+#
+# Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+# копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+function Write-XmlFile([string]$path, [string]$text, $encoding) {
+	$t = ($text -replace "`r`n", "`n") -replace "`n", "`r`n"
+	[System.IO.File]::WriteAllText($path, $t.TrimEnd("`r", "`n"), $encoding)
+}
+
+Write-XmlFile $cfgFile $cfgXml $enc
+$langFile = Join-Path $langDir "Русский.xml"
+Write-XmlFile $langFile $langXml $enc
+$caiFile = Join-Path $extDir "ClientApplicationInterface.xml"
+Write-XmlFile $caiFile $caiXml $enc
+
+# --- Output ---
+Write-Host "[OK] Создана конфигурация: $Name"
+Write-Host "     Каталог:            $OutputDir"
+Write-Host "     Configuration.xml:  $cfgFile"
+Write-Host "     Languages:          $langFile"
+Write-Host "     Ext/CAI:            $caiFile"

.claude/skills/cf-init/scripts/cf-init.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python3
-# cf-init v1.2 — Create empty 1C configuration scaffold
+# cf-init v1.8 — Create empty 1C configuration scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C configuration."""
-import sys, os, argparse, uuid
+import sys, os, argparse, re, uuid
 
 def esc_xml(s):
     return s.replace('&','&amp;').replace('<','&lt;').replace('>','&gt;').replace('"','&quot;')
@@ -14,6 +14,16 @@ def write_utf8_bom(path, content):
     with open(path, 'w', encoding='utf-8-sig', newline='') as f:
         f.write(content)
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    write_utf8_bom(path, text)
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -24,6 +34,11 @@ def main():
     parser.add_argument('-Version', dest='Version', default='')
     parser.add_argument('-Vendor', dest='Vendor', default='')
     parser.add_argument('-CompatibilityMode', dest='CompatibilityMode', default='Version8_3_24')
+    # Версия формата выгрузки (MDClasses) — её задаёт ПЛАТФОРМА, а не режим совместимости:
+    # 8.3.20-8.3.24 пишут 2.17, 8.3.25 — 2.18, 8.3.26 — 2.19, 8.3.27 — 2.20.
+    # Дефолт консервативный: 2.17 читается всеми платформами.
+    parser.add_argument('-FormatVersion', dest='FormatVersion', default='2.17',
+                        choices=['2.17', '2.18', '2.19', '2.20', '2.21'])
     args = parser.parse_args()
 
     name = args.Name
@@ -49,6 +64,10 @@ def main():
     co = [new_uuid() for _ in range(7)]
 
     # --- Mobile functionalities ---
+    # Версия формата как число — по ней ниже включаются вставки 2.21.
+    _fm = re.match(r'^(\d+)\.(\d+)$', args.FormatVersion)
+    is_221 = bool(_fm) and int(_fm.group(1)) * 100 + int(_fm.group(2)) >= 221
+
     mobile_funcs = [
         ("Biometrics","true"), ("Location","false"), ("BackgroundLocation","false"),
         ("BluetoothPrinters","false"), ("WiFiPrinters","false"), ("Contacts","false"),
@@ -65,6 +84,10 @@ def main():
         ("DocumentScanning","false"), ("SpeechToText","false"), ("Geofences","false"),
         ("IncomingShareRequests","false"), ("AllIncomingShareRequestsTypesProcessing","false"),
     ]
+    # TextToSpeech — возможность мобильного приложения, добавленная форматом 2.21 (8.5),
+    # последней в списке. На младших форматах платформа её не пишет.
+    if is_221:
+        mobile_funcs.append(("TextToSpeech", "false"))
 
     mobile_xml = ""
     for func_name, func_use in mobile_funcs:
@@ -75,8 +98,10 @@ def main():
     if synonym:
         synonym_xml = f"\r\n\t\t\t\t<v8:item>\r\n\t\t\t\t\t<v8:lang>ru</v8:lang>\r\n\t\t\t\t\t<v8:content>{esc_xml(synonym)}</v8:content>\r\n\t\t\t\t</v8:item>\r\n\t\t\t"
 
-    vendor_xml = esc_xml(vendor) if vendor else ""
+    # Элемент целиком, а не значение внутри пары: при пустом значении Конфигуратор
-    version_xml = esc_xml(version) if version else ""
+    # пишет <Vendor/>, а не <Vendor></Vendor>.
+    vendor_el = f"<Vendor>{esc_xml(vendor)}</Vendor>" if vendor else "<Vendor/>"
+    version_el = f"<Version>{esc_xml(version)}</Version>" if version else "<Version/>"
 
     class_ids = [
         "9cd510cd-abfc-11d4-9434-004095e12fc7",
@@ -88,6 +113,28 @@ def main():
         "fb282519-d103-4dd3-bc12-cb271d631dfc",
     ]
 
+    # Свойства и пространство имён формата 2.21 (платформа 8.5). Значения и ПОЗИЦИИ сняты
+    # с выгрузки 8.5.1 (debug/fmt221/dump_v851): те же исходники, выгруженные с 8.3.27 и
+    # с 8.5.1, различаются ровно этим. Порядок важен — вставки идут на своё место.
+    pal_ns = ""
+    f221_aux_forms = f221_window_variant = f221_open_variant = f221_captions = f221_migration = ""
+    if is_221:
+        pal_ns = ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette"'
+        f221_aux_forms = "\r\n" + "\r\n".join(
+            f"\t\t\t{t}" for t in (
+                "<AuxiliaryReportForm/>", "<AuxiliaryReportVariantForm/>", "<AuxiliaryReportSettingsForm/>",
+                "<AuxiliaryDynamicListSettingsForm/>", "<AuxiliaryDataHistoryChangeHistoryForm/>",
+                "<AuxiliaryDataHistoryVersionDataForm/>", "<AuxiliaryDataHistoryVersionDifferencesForm/>",
+                "<AuxiliaryCollaborationSystemUsersChoiceForm/>"))
+        f221_window_variant = ("\r\n\t\t\t<MainClientApplicationWindowInterfaceVariant>NavigationLeft"
+                               "</MainClientApplicationWindowInterfaceVariant>"
+                               "\r\n\t\t\t<ClientApplicationTheme>Auto</ClientApplicationTheme>")
+        f221_open_variant = ("\r\n\t\t\t<ClientApplicationWindowsOpenVariant>OpenDataInDialogs"
+                             "</ClientApplicationWindowsOpenVariant>")
+        f221_captions = "\r\n\t\t\t<Caption/>\r\n\t\t\t<ShortCaption/>"
+        f221_migration = ("\r\n\t\t\t<Version85InterfaceMigrationMode>DontUse"
+                          "</Version85InterfaceMigrationMode>")
+
     contained_objects = ""
     for i in range(7):
         contained_objects += f"""\t\t\t<xr:ContainedObject>
@@ -96,7 +143,7 @@ def main():
 \t\t\t</xr:ContainedObject>\n"""
 
     cfg_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"{pal_ns} xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="{args.FormatVersion}">
 \t<Configuration uuid="{uuid_cfg}">
 \t\t<InternalInfo>
 {contained_objects}\t\t</InternalInfo>
@@ -112,8 +159,8 @@ def main():
 \t\t\t</UsePurposes>
 \t\t\t<ScriptVariant>Russian</ScriptVariant>
 \t\t\t<DefaultRoles/>
-\t\t\t<Vendor>{vendor_xml}</Vendor>
+\t\t\t{vendor_el}
-\t\t\t<Version>{version_xml}</Version>
+\t\t\t{version_el}
 \t\t\t<UpdateCatalogAddress/>
 \t\t\t<IncludeHelpInContents>false</IncludeHelpInContents>
 \t\t\t<UseManagedFormInOrdinaryApplication>false</UseManagedFormInOrdinaryApplication>
@@ -135,15 +182,15 @@ def main():
 \t\t\t<DefaultDataHistoryChangeHistoryForm/>
 \t\t\t<DefaultDataHistoryVersionDataForm/>
 \t\t\t<DefaultDataHistoryVersionDifferencesForm/>
-\t\t\t<DefaultCollaborationSystemUsersChoiceForm/>
+\t\t\t<DefaultCollaborationSystemUsersChoiceForm/>{f221_aux_forms}
 \t\t\t<RequiredMobileApplicationPermissions/>
 \t\t\t<UsedMobileApplicationFunctionalities>{mobile_xml}
 \t\t\t</UsedMobileApplicationFunctionalities>
 \t\t\t<StandaloneConfigurationRestrictionRoles/>
 \t\t\t<MobileApplicationURLs/>
-\t\t\t<AllowedIncomingShareRequestTypes/>
+\t\t\t<AllowedIncomingShareRequestTypes/>{f221_window_variant}
-\t\t\t<MainClientApplicationWindowMode>Normal</MainClientApplicationWindowMode>
+\t\t\t<MainClientApplicationWindowMode>Normal</MainClientApplicationWindowMode>{f221_open_variant}
-\t\t\t<DefaultInterface/>
+\t\t\t<DefaultInterface/>{f221_captions}
 \t\t\t<DefaultStyle/>
 \t\t\t<DefaultLanguage>Language.Русский</DefaultLanguage>
 \t\t\t<BriefInformation/>
@@ -155,7 +202,7 @@ def main():
 \t\t\t<ObjectAutonumerationMode>NotAutoFree</ObjectAutonumerationMode>
 \t\t\t<ModalityUseMode>DontUse</ModalityUseMode>
 \t\t\t<SynchronousPlatformExtensionAndAddInCallUseMode>DontUse</SynchronousPlatformExtensionAndAddInCallUseMode>
-\t\t\t<InterfaceCompatibilityMode>TaxiEnableVersion8_2</InterfaceCompatibilityMode>
+\t\t\t<InterfaceCompatibilityMode>TaxiEnableVersion8_2</InterfaceCompatibilityMode>{f221_migration}
 \t\t\t<DatabaseTablespacesUseMode>DontUse</DatabaseTablespacesUseMode>
 \t\t\t<CompatibilityMode>{compat}</CompatibilityMode>
 \t\t\t<DefaultConstantsForm/>
@@ -168,7 +215,7 @@ def main():
 
     # --- Languages/Русский.xml ---
     lang_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"{pal_ns} xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="{args.FormatVersion}">
 \t<Language uuid="{uuid_lang}">
 \t\t<Properties>
 \t\t\t<Name>Русский</Name>
@@ -217,11 +264,11 @@ def main():
     os.makedirs(ext_dir, exist_ok=True)
 
     # --- Write files ---
-    write_utf8_bom(cfg_file, cfg_xml)
+    write_xml_file(cfg_file, cfg_xml)
     lang_file = os.path.join(lang_dir, "Русский.xml")
-    write_utf8_bom(lang_file, lang_xml)
+    write_xml_file(lang_file, lang_xml)
     cai_file = os.path.join(ext_dir, "ClientApplicationInterface.xml")
-    write_utf8_bom(cai_file, cai_xml)
+    write_xml_file(cai_file, cai_xml)
 
     print(f"[OK] Создана конфигурация: {name}")
     print(f"     Каталог:            {output_dir}")

.claude/skills/cf-validate/SKILL.md

@@ -1,29 +1,29 @@
----
+---
-name: cf-validate
+name: cf-validate
-description: Валидация конфигурации 1С. Используй после создания или модификации конфигурации для проверки корректности
+description: Валидация конфигурации 1С. Используй после создания или модификации конфигурации для проверки корректности
-argument-hint: <ConfigPath> [-Detailed] [-MaxErrors 30]
+argument-hint: <ConfigPath> [-Detailed] [-MaxErrors 30]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cf-validate — валидация конфигурации 1С
+# /cf-validate — валидация конфигурации 1С
-
+
-Проверяет Configuration.xml на структурные ошибки: XML well-formedness, InternalInfo, свойства, enum-значения, ChildObjects, DefaultLanguage, файлы языков, каталоги объектов.
+Проверяет Configuration.xml на структурные ошибки: XML well-formedness, InternalInfo, свойства, enum-значения, ChildObjects, DefaultLanguage, файлы языков, каталоги объектов.
-
+
-## Параметры
+## Параметры
-
+
-| Параметр   | Обяз. | Умолч. | Описание                                      |
+| Параметр   | Обяз. | Умолч. | Описание                                      |
-|------------|:-----:|---------|-------------------------------------------------|
+|------------|:-----:|---------|-------------------------------------------------|
-| ConfigPath | да    | —       | Путь к Configuration.xml или каталогу выгрузки  |
+| ConfigPath | да    | —       | Путь к Configuration.xml или каталогу выгрузки  |
-| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
+| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
-| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
+| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
-| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
+| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty/Configuration.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty/Configuration.xml"
-```
+```

.claude/skills/cf-validate/scripts/cf-validate.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# cf-validate v1.3 — Validate 1C configuration XML structure
+# cf-validate v1.5 — Validate 1C configuration XML structure
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Validates Configuration.xml: root structure, InternalInfo, properties, ChildObjects, languages."""
 import sys, os, argparse, re
@@ -33,11 +33,11 @@ VALID_CLASS_IDS = [
     'fb282519-d103-4dd3-bc12-cb271d631dfc',   # home page / client app interface
 ]
 
-# 44 types in canonical order
+# 45 types in canonical order
 CHILD_OBJECT_TYPES = [
     'Language', 'Subsystem', 'StyleItem', 'Style',
     'CommonPicture', 'SessionParameter', 'Role', 'CommonTemplate',
-    'FilterCriterion', 'CommonModule', 'CommonAttribute', 'ExchangePlan',
+    'FilterCriterion', 'CommonModule', 'Bot', 'CommonAttribute', 'ExchangePlan',
     'XDTOPackage', 'WebService', 'HTTPService', 'WSReference',
     'EventSubscription', 'ScheduledJob', 'SettingsStorage', 'FunctionalOption',
     'FunctionalOptionsParameter', 'DefinedType', 'CommonCommand', 'CommandGroup',
@@ -54,6 +54,7 @@ CHILD_TYPE_DIR_MAP = {
     'Language': 'Languages', 'Subsystem': 'Subsystems', 'StyleItem': 'StyleItems', 'Style': 'Styles',
     'CommonPicture': 'CommonPictures', 'SessionParameter': 'SessionParameters', 'Role': 'Roles',
     'CommonTemplate': 'CommonTemplates', 'FilterCriterion': 'FilterCriteria', 'CommonModule': 'CommonModules',
+    'Bot': 'Bots',
     'CommonAttribute': 'CommonAttributes', 'ExchangePlan': 'ExchangePlans', 'XDTOPackage': 'XDTOPackages',
     'WebService': 'WebServices', 'HTTPService': 'HTTPServices', 'WSReference': 'WSReferences',
     'EventSubscription': 'EventSubscriptions', 'ScheduledJob': 'ScheduledJobs',
@@ -231,8 +232,9 @@ def main():
     version = root.get('version', '')
     if not version:
         r.warn('1. Missing version attribute on MetaDataObject')
-    elif version not in ('2.17', '2.20', '2.21'):
+    elif version not in ('2.17', '2.18', '2.19', '2.20', '2.21'):
-        r.warn(f"1. Unusual version '{version}' (expected 2.17, 2.20 or 2.21)")
+        # Лестница версий формата: 2.17 (8.3.20-8.3.24), 2.18 (8.3.25), 2.19 (8.3.26), 2.20 (8.3.27).
+        r.warn(f"1. Unusual version '{version}' (expected 2.17-2.20 or 2.21)")
 
     # Must have Configuration child
     cfg_node = None

.claude/skills/cfe-borrow/SKILL.md

@@ -1,101 +1,101 @@
----
+---
-name: cfe-borrow
+name: cfe-borrow
-description: Заимствование объектов из конфигурации 1С в расширение (CFE). Используй когда нужно перехватить метод, изменить форму или добавить реквизит к существующему объекту конфигурации
+description: Заимствование объектов из конфигурации 1С в расширение (CFE). Используй когда нужно перехватить метод, изменить форму или добавить реквизит к существующему объекту конфигурации
-argument-hint: -ExtensionPath <path> -ConfigPath <path> -Object "Catalog.Контрагенты.Form.ФормаЭлемента" -BorrowMainAttribute
+argument-hint: -ExtensionPath <path> -ConfigPath <path> -Object "Catalog.Контрагенты.Form.ФормаЭлемента" -BorrowMainAttribute
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cfe-borrow — Заимствование объектов из конфигурации
+# /cfe-borrow — Заимствование объектов из конфигурации
-
+
-Заимствует объекты из основной конфигурации в расширение. Создаёт XML-файлы с `ObjectBelonging=Adopted` и `ExtendedConfigurationObject`, добавляет запись в ChildObjects расширения.
+Заимствует объекты из основной конфигурации в расширение. Создаёт XML-файлы с `ObjectBelonging=Adopted` и `ExtendedConfigurationObject`, добавляет запись в ChildObjects расширения.
-
+
-## Предусловие
+## Предусловие
-
+
-Расширение должно быть создано (`/cfe-init`) и содержать валидный `Configuration.xml`.
+Расширение должно быть создано (`/cfe-init`) и содержать валидный `Configuration.xml`.
-
+
-### Авто-определение ConfigPath
+### Авто-определение ConfigPath
-
+
-Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
+Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
-1. Прочитай `.v8-project.json` из корня проекта
+1. Прочитай `.v8-project.json` из корня проекта
-2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
+2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
-3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
+3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
-4. Если `configSrc` нет — спроси у пользователя
+4. Если `configSrc` нет — спроси у пользователя
-
+
-## Параметры
+## Параметры
-
+
-| Параметр | Описание |
+| Параметр | Описание |
-|----------|----------|
+|----------|----------|
-| `ExtensionPath` | Путь к каталогу расширения (обязат.) |
+| `ExtensionPath` | Путь к каталогу расширения (обязат.) |
-| `ConfigPath` | Путь к конфигурации-источнику (обязат.) |
+| `ConfigPath` | Путь к конфигурации-источнику (обязат.) |
-| `Object` | Что заимствовать (обязат.), batch через `;;` |
+| `Object` | Что заимствовать (обязат.), batch через `;;` |
-| `BorrowMainAttribute` | Заимствовать основной реквизит формы. Без параметра — не заимствует. `Form` — реквизиты, используемые на форме. `All` — все реквизиты объекта. Требует форму в -Object |
+| `BorrowMainAttribute` | Заимствовать основной реквизит формы. Без параметра — не заимствует. `Form` — реквизиты, используемые на форме. `All` — все реквизиты объекта. Требует форму в -Object |
-
+
-## Формат -Object
+## Формат -Object
-
+
-- `Catalog.Контрагенты` — справочник
+- `Catalog.Контрагенты` — справочник
-- `CommonModule.РаботаСФайлами` — общий модуль
+- `CommonModule.РаботаСФайлами` — общий модуль
-- `Document.РеализацияТоваров` — документ
+- `Document.РеализацияТоваров` — документ
-- `Enum.ВидыОплат` — перечисление
+- `Enum.ВидыОплат` — перечисление
-- `Catalog.Контрагенты.Form.ФормаЭлемента` — форма объекта (заимствование формы)
+- `Catalog.Контрагенты.Form.ФормаЭлемента` — форма объекта (заимствование формы)
-- `Catalog.X ;; CommonModule.Y ;; Enum.Z` — несколько объектов
+- `Catalog.X ;; CommonModule.Y ;; Enum.Z` — несколько объектов
-Поддерживаются все 44 типа объектов конфигурации.
+Поддерживаются все 44 типа объектов конфигурации.
-
+
-### Заимствование форм
+### Заимствование форм
-
+
-Формат `Тип.Имя.Form.ИмяФормы` заимствует форму конкретного объекта. Если родительский объект ещё не заимствован — он будет заимствован автоматически.
+Формат `Тип.Имя.Form.ИмяФормы` заимствует форму конкретного объекта. Если родительский объект ещё не заимствован — он будет заимствован автоматически.
-
+
-Создаётся:
+Создаётся:
-1. **Метаданные формы** — `Forms/ИмяФормы.xml` с `ObjectBelonging=Adopted`, `FormType=Managed`
+1. **Метаданные формы** — `Forms/ИмяФормы.xml` с `ObjectBelonging=Adopted`, `FormType=Managed`
-2. **Form.xml** — `Forms/ИмяФормы/Ext/Form.xml` с копией исходной формы + `<BaseForm>` (начальное состояние)
+2. **Form.xml** — `Forms/ИмяФормы/Ext/Form.xml` с копией исходной формы + `<BaseForm>` (начальное состояние)
-3. **Module.bsl** — пустой файл `Forms/ИмяФормы/Ext/Form/Module.bsl`
+3. **Module.bsl** — пустой файл `Forms/ИмяФормы/Ext/Form/Module.bsl`
-4. **Регистрация** — `<Form>` в ChildObjects родительского объекта
+4. **Регистрация** — `<Form>` в ChildObjects родительского объекта
-
+
-### Заимствование основного реквизита формы (-BorrowMainAttribute)
+### Заимствование основного реквизита формы (-BorrowMainAttribute)
-
+
-**Когда нужно**: пользователь хочет добавить новый реквизит в существующий объект конфигурации и вывести его на заимствованную форму. Без `-BorrowMainAttribute` форма заимствуется "пустой" — только визуальные элементы, без привязки к данным объекта. С `-BorrowMainAttribute` форма сохраняет привязки к реквизитам объекта (DataPath), что позволяет затем добавить на неё новые элементы через `/form-edit`.
+**Когда нужно**: пользователь хочет добавить новый реквизит в существующий объект конфигурации и вывести его на заимствованную форму. Без `-BorrowMainAttribute` форма заимствуется "пустой" — только визуальные элементы, без привязки к данным объекта. С `-BorrowMainAttribute` форма сохраняет привязки к реквизитам объекта (DataPath), что позволяет затем добавить на неё новые элементы через `/form-edit`.
-
+
-**Два режима**:
+**Два режима**:
-- `Form` (по умолчанию) — заимствует только те реквизиты объекта, которые уже выведены на форму. Оптимальный выбор для большинства случаев
+- `Form` (по умолчанию) — заимствует только те реквизиты объекта, которые уже выведены на форму. Оптимальный выбор для большинства случаев
-- `All` — заимствует все реквизиты и табличные части объекта. Используй если планируешь выводить на форму реквизиты, которых на ней ещё нет
+- `All` — заимствует все реквизиты и табличные части объекта. Используй если планируешь выводить на форму реквизиты, которых на ней ещё нет
-
+
-**Типовой сценарий** (добавление реквизита + вывод на форму):
+**Типовой сценарий** (добавление реквизита + вывод на форму):
-1. `/cfe-borrow` с `-BorrowMainAttribute` — заимствовать форму с реквизитами
+1. `/cfe-borrow` с `-BorrowMainAttribute` — заимствовать форму с реквизитами
-2. `/meta-edit` — добавить новый реквизит в объект расширения
+2. `/meta-edit` — добавить новый реквизит в объект расширения
-3. `/form-edit` — вывести реквизит на заимствованную форму
+3. `/form-edit` — вывести реквизит на заимствованную форму
-
+
-**Защита существующих данных**: если зависимый объект уже заимствован с содержимым (реквизитами, формами) — скрипт не перезаписывает его, а добавляет только недостающее.
+**Защита существующих данных**: если зависимый объект уже заимствован с содержимым (реквизитами, формами) — скрипт не перезаписывает его, а добавляет только недостающее.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
-```
+```
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Заимствовать один объект
+# Заимствовать один объект
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
-
+
-# Заимствовать форму (автоматически заимствует родительский объект)
+# Заимствовать форму (автоматически заимствует родительский объект)
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты.Form.ФормаЭлемента"
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты.Form.ФормаЭлемента"
-
+
-# Несколько объектов за раз
+# Несколько объектов за раз
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты ;; CommonModule.ОбщийМодуль ;; Enum.ВидыОплат"
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты ;; CommonModule.ОбщийМодуль ;; Enum.ВидыОплат"
-
+
-# Заимствовать форму с основным реквизитом (реквизиты по DataPath формы)
+# Заимствовать форму с основным реквизитом (реквизиты по DataPath формы)
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute
-
+
-# Заимствовать форму с ВСЕМИ реквизитами объекта
+# Заимствовать форму с ВСЕМИ реквизитами объекта
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute All
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute All
-```
+```
-
+
-## Верификация
+## Верификация
-
+
-```
+```
-/cfe-validate <ExtensionPath>
+/cfe-validate <ExtensionPath>
-```
+```
-
+

.claude/skills/cfe-borrow/scripts/cfe-borrow.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# cfe-borrow v1.3 — Borrow objects from configuration into extension (CFE)
+# cfe-borrow v1.16 — Borrow objects from configuration into extension (CFE)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
@@ -14,6 +14,36 @@ XR_NS = "http://v8.1c.ru/8.3/xcf/readable"
 XSI_NS = "http://www.w3.org/2001/XMLSchema-instance"
 V8_NS = "http://v8.1c.ru/8.1/data/core"
 
+# Form data-binding tags (value = attribute path). A binding survives only if its root
+# attribute is borrowed into the form's <Attributes>; otherwise it must be stripped or the
+# platform rejects the form with "Неверный путь к данным" on load.
+FORM_BINDING_DATA_TAGS = ["DataPath", "TitleDataPath", "FooterDataPath", "HeaderDataPath", "MultipleValueDataPath", "MultipleValuePresentDataPath"]
+# Picture-path binding tags (value = picture index path, never a data attribute) — always stripped in the skeleton.
+FORM_BINDING_PICTURE_TAGS = ["RowPictureDataPath", "MultipleValuePictureDataPath"]
+
+
+def strip_form_bindings(xml, keep_objekt):
+    """Strip data-binding tags whose root attribute isn't borrowed.
+    keep_objekt=True (BorrowMainAttribute): keep Объект.* data bindings, strip the rest.
+    keep_objekt=False (default skeleton): strip all bindings. Picture-path tags are always stripped."""
+    for tag in FORM_BINDING_DATA_TAGS:
+        if keep_objekt:
+            xml = re.sub(rf'\s*<{tag}>(?!Объект\.)[^<]*</{tag}>', '', xml)
+        else:
+            xml = re.sub(rf'\s*<{tag}>[^<]*</{tag}>', '', xml)
+    for tag in FORM_BINDING_PICTURE_TAGS:
+        xml = re.sub(rf'\s*<{tag}>[^<]*</{tag}>', '', xml)
+    return xml
+
+
+def decode_numeric_entities(s):
+    """lxml emits numeric character refs (&#xNNNN;) for non-ASCII in some self-closed
+    elements where the PowerShell port writes literal characters. Normalize numeric refs
+    back to literal so PS↔PY output matches. Named entities (&amp; &lt; ...) are left intact."""
+    s = re.sub(r'&#x([0-9A-Fa-f]+);', lambda m: chr(int(m.group(1), 16)), s)
+    s = re.sub(r'&#(\d+);', lambda m: chr(int(m.group(1))), s)
+    return s
+
 
 def localname(el):
     return etree.QName(el.tag).localname
@@ -224,13 +254,36 @@ GENERATED_TYPES = {
     "DefinedType": [
         {"prefix": "DefinedType", "category": "DefinedType"},
     ],
+    "Sequence": [
+        {"prefix": "SequenceRecord", "category": "Record"},
+        {"prefix": "SequenceManager", "category": "Manager"},
+        {"prefix": "SequenceRecordSet", "category": "RecordSet"},
+    ],
+    "FilterCriterion": [
+        {"prefix": "FilterCriterionManager", "category": "Manager"},
+        {"prefix": "FilterCriterionList", "category": "List"},
+    ],
+    "SettingsStorage": [
+        {"prefix": "SettingsStorageManager", "category": "Manager"},
+    ],
+    "IntegrationService": [
+        {"prefix": "IntegrationServiceManager", "category": "Manager"},
+    ],
+    "WSReference": [
+        {"prefix": "WSReferenceManager", "category": "Manager"},
+    ],
 }
 
+# Types that need ChildObjects element — fallback when the source object cannot be probed.
+# The platform emits <ChildObjects> for every container type even when empty, and rejects
+# the file without it ("expected ChildObjects"); primary signal is the source object itself.
 TYPES_WITH_CHILD_OBJECTS = [
     "Catalog", "Document", "ExchangePlan", "ChartOfAccounts",
     "ChartOfCharacteristicTypes", "ChartOfCalculationTypes",
     "BusinessProcess", "Task", "Enum",
     "InformationRegister", "AccumulationRegister", "AccountingRegister", "CalculationRegister",
+    "DataProcessor", "Report", "DocumentJournal", "FilterCriterion", "SettingsStorage",
+    "Sequence", "HTTPService", "WebService", "IntegrationService", "Subsystem",
 ]
 
 COMMON_MODULE_PROPS = ["Global", "ClientManagedApplication", "Server", "ExternalConnection", "ClientOrdinaryApplication", "ServerCall"]
@@ -270,6 +323,23 @@ def detect_format_version(d):
     return "2.17"
 
 
+def format_rank(ver):
+    """"2.20" → 220, "2.9" → 209. Строковое сравнение неверно ("2.9" > "2.17")."""
+    m = re.match(r'^(\d+)\.(\d+)$', ver or '')
+    return int(m.group(1)) * 100 + int(m.group(2)) if m else 0
+
+
+def apply_pal_ns(format_version):
+    """2.21 (8.5) добавила в шапку пространство палитры — ради <Color> у значений перечисления.
+    Вставляем НА МЕСТО (после lf, перед style): платформа держит объявления по алфавиту,
+    дописать в конец нельзя."""
+    global XMLNS_DECL
+    if format_rank(format_version) >= 221:
+        XMLNS_DECL = XMLNS_DECL.replace(
+            ' xmlns:style=',
+            ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style=')
+
+
 def get_child_indent(container):
     if container.text and "\n" in container.text:
         after_nl = container.text.rsplit("\n", 1)[-1]
@@ -319,21 +389,77 @@ def expand_self_closing(container, parent_indent):
         container.text = "\r\n" + parent_indent
 
 
-def save_xml_bom(tree, path):
+def _detect_xml_style(path):
-    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    """Стиль существующего файла для round-trip-сохранения: BOM / EOL / регистр encoding /
-    xml_bytes = xml_bytes.replace(b"<?xml version='1.0' encoding='UTF-8'?>", b'<?xml version="1.0" encoding="utf-8"?>')
+    финальный перенос. None → файл новый (сохранить текущее поведение)."""
-    if not xml_bytes.endswith(b"\n"):
+    try:
+        raw = open(path, "rb").read()
+    except OSError:
+        return None
+    bom = raw.startswith(b"\xef\xbb\xbf")
+    body = raw[3:] if bom else raw
+    crlf = b"\r\n" in body
+    m = re.search(rb'encoding="([^"]+)"', body[:200])
+    enc = m.group(1).decode("ascii") if m else "utf-8"
+    final_nl = body.endswith(b"\n")
+    return {"bom": bom, "crlf": crlf, "enc": enc, "final_nl": final_nl}
+
+
+def _finalize_xml_bytes(xml_bytes, style):
+    """Привести байты к стилю оригинала; для НОВОГО файла (style is None) — к канону
+    выгрузки Конфигуратора: encoding="UTF-8", CRLF в разделителях, без перевода в конце."""
+    enc_decl = style["enc"] if style else "UTF-8"
+    xml_bytes = xml_bytes.replace(
+        b"<?xml version='1.0' encoding='UTF-8'?>",
+        b'<?xml version="1.0" encoding="' + enc_decl.encode("ascii") + b'"?>')
+    # Канонизировать переносы к LF (убирает &#13; от \r в tail'ах)
+    xml_bytes = (xml_bytes.replace(b"&#13;\n", b"\n").replace(b"&#13;", b"")
+                 .replace(b"\r\n", b"\n").replace(b"\r", b"\n"))
+    # Финальный перенос — как в оригинале (новый файл → нет, канон #57)
+    want_final_nl = style["final_nl"] if style else False
+    xml_bytes = xml_bytes.rstrip(b"\n")
+    if want_final_nl:
         xml_bytes += b"\n"
+    # EOL — как в оригинале (новый файл → CRLF, канон #57)
+    if (style["crlf"] if style else True):
+        xml_bytes = xml_bytes.replace(b"\n", b"\r\n")
+    return xml_bytes
+
+
+def save_xml_bom(tree, path):
+    style = _detect_xml_style(path)
+    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    xml_bytes = _finalize_xml_bytes(xml_bytes, style)
     with open(path, "wb") as f:
-        f.write(b"\xef\xbb\xbf")
+        if style is None or style["bom"]:
+            f.write(b"\xef\xbb\xbf")
         f.write(xml_bytes)
 
 
 def save_text_bom(path, text):
-    with open(path, "w", encoding="utf-8-sig") as fh:
+    """Записать текст как есть, ничего не нормализуя.
+
+    Для файлов, которые мы ПРАВИМ: переводы строк уже пришли из самого файла, и
+    менять их нельзя (контракт #44/#46/#47). newline="" обязателен — без него
+    текстовый режим Python дал бы CRLF на Windows и LF на macOS, то есть вывод
+    навыка зависел бы от ОС.
+    """
+    with open(path, "w", encoding="utf-8-sig", newline="") as fh:
         fh.write(text)
 
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+
+    Только для файлов, которые СОЗДАЁМ: правка существующего наследует его стиль.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    save_text_bom(path, text)
+
+
 def new_guid():
     return str(uuid.uuid4())
 
@@ -382,6 +508,7 @@ def main():
     cfg_dir = os.path.dirname(cfg_resolved)
 
     format_version = detect_format_version(ext_dir)
+    apply_pal_ns(format_version)
 
     # --- 2. Load extension Configuration.xml ---
     xml_parser = etree.XMLParser(remove_blank_text=False)
@@ -462,6 +589,16 @@ def main():
                 prop_node = props_node.find(f"{{{MD_NS}}}{prop_name}")
                 if prop_node is not None:
                     src_props[prop_name] = (prop_node.text or "").strip()
+            # DefinedType: carry the <Type> definition. A type alias is meaningless as a bare shell —
+            # the platform needs its underlying type (e.g. to know a column is a summable Number for totals).
+            if type_name == "DefinedType":
+                type_node = props_node.find(f"{{{MD_NS}}}Type")
+                if type_node is not None:
+                    type_xml = etree.tostring(type_node, encoding="unicode")
+                    src_props["__TypeXml"] = re.sub(r'\s+xmlns(?::\w+)?="[^"]*"', '', type_xml)
+
+        # Whether the platform emits <ChildObjects> for this type — the source object is the ground truth
+        src_props["__HasChildObjects"] = src_el.find(f"{{{MD_NS}}}ChildObjects") is not None
 
         return {"Uuid": src_uuid, "Properties": src_props, "Element": src_el}
 
@@ -533,9 +670,13 @@ def main():
                 prop_val = source_props.get(prop_name, "false")
                 lines.append(f"\t\t\t<{prop_name}>{prop_val}</{prop_name}>")
 
+        # DefinedType: emit the carried <Type> definition (needed for the alias to resolve, e.g. totals)
+        if type_name == "DefinedType" and "__TypeXml" in source_props:
+            lines.append(f"\t\t\t{source_props['__TypeXml']}")
+
         lines.append("\t\t</Properties>")
 
-        if type_name in TYPES_WITH_CHILD_OBJECTS:
+        if source_props.get("__HasChildObjects") or type_name in TYPES_WITH_CHILD_OBJECTS:
             lines.append("\t\t<ChildObjects/>")
 
         lines.append(f"\t</{type_name}>")
@@ -644,7 +785,26 @@ def main():
         first_level = {}
         deep_paths = []
 
-        for m in re.finditer(r'<DataPath>[^<]*\b\u041e\u0431\u044a\u0435\u043a\u0442\.(\w+(?:\.\w+)*)</DataPath>', content):
+        # Scan every data-binding tag (DataPath/TitleDataPath/FooterDataPath/HeaderDataPath/MultipleValue*)
+        # for Объект.* references — picture-path tags carry picture indices, not data attributes.
+        for tag in FORM_BINDING_DATA_TAGS:
+            for m in re.finditer(r'<' + tag + r'>[^<]*\bОбъект\.(\w+(?:\.\w+)*)</' + tag + r'>', content):
+                path = m.group(1)
+                segments = path.split(".")
+                seg0 = segments[0]
+                if seg0 in STANDARD_FIELDS:
+                    continue
+                first_level[seg0] = True
+                if len(segments) >= 2:
+                    seg1 = segments[1]
+                    if seg1 in STANDARD_FIELDS:
+                        continue
+                    seg2 = segments[2] if len(segments) >= 3 else None
+                    deep_paths.append({"ObjectAttr": seg0, "SubAttr": seg1, "SubSubAttr": seg2})
+
+        # Also scan <Field>Объект.X</Field> — object attributes referenced by filter/conditional-appearance
+        # fields (and dynamic lists), not via a *DataPath binding (e.g. УдалитьЮрФизЛицо). Designer borrows these too.
+        for m in re.finditer(r'<Field>[^<]*\bОбъект\.(\w+(?:\.\w+)*)</Field>', content):
             path = m.group(1)
             segments = path.split(".")
             seg0 = segments[0]
@@ -655,22 +815,14 @@ def main():
                 seg1 = segments[1]
                 if seg1 in STANDARD_FIELDS:
                     continue
-                deep_paths.append({"ObjectAttr": seg0, "SubAttr": seg1})
+                seg2 = segments[2] if len(segments) >= 3 else None
-
+                deep_paths.append({"ObjectAttr": seg0, "SubAttr": seg1, "SubSubAttr": seg2})
-        # Also collect from TitleDataPath
-        for m in re.finditer(r'<TitleDataPath>[^<]*\b\u041e\u0431\u044a\u0435\u043a\u0442\.(\w+(?:\.\w+)*)</TitleDataPath>', content):
-            path = m.group(1)
-            segments = path.split(".")
-            seg0 = segments[0]
-            if seg0 in STANDARD_FIELDS:
-                continue
-            first_level[seg0] = True
 
         # Deduplicate deep paths
         seen = set()
         unique_deep = []
         for dp in deep_paths:
-            key = f"{dp['ObjectAttr']}.{dp['SubAttr']}"
+            key = f"{dp['ObjectAttr']}.{dp['SubAttr']}.{dp.get('SubSubAttr')}"
             if key not in seen:
                 seen.add(key)
                 unique_deep.append(dp)
@@ -883,7 +1035,9 @@ def main():
             warn(f"Cannot merge attributes: {obj_file} not found")
             return
 
-        with open(obj_file, "r", encoding="utf-8-sig") as fh:
+        # newline="" => без трансляции: иначе CRLF молча схлопнется в LF при чтении
+        # и файл будет переписан в LF.
+        with open(obj_file, "r", encoding="utf-8-sig", newline="") as fh:
             obj_content = fh.read()
 
         # Collect existing attribute names for dedup (text-based)
@@ -941,26 +1095,42 @@ def main():
         # Step 3: Build the adopted content and insert into main object XML
         obj_file = os.path.join(ext_dir, dir_name, f"{obj_name}.xml")
 
-        # Generate full object XML with attributes and TS
+        # Read existing object XML (needed for dedup + enrichment)
-        content_parts = []
+        # newline="" => без трансляции: иначе CRLF молча схлопнется в LF при чтении
-        for attr in src_attrs:
+        # и файл будет переписан в LF.
-            attr_xml = build_adopted_attribute_xml(attr["Name"], attr["Uuid"], attr["TypeXml"], "\t\t\t")
+        with open(obj_file, "r", encoding="utf-8-sig", newline="") as fh:
-            content_parts.append(attr_xml)
-        for ts in src_ts:
-            ts_xml = build_adopted_tabular_section_xml(ts["Name"], ts["Uuid"], ts["GeneratedTypes"], ts["Attributes"], "\t\t\t")
-            content_parts.append(ts_xml)
-        adopted_content = "\n".join(content_parts).rstrip()
-
-        # Read existing object XML and inject
-        with open(obj_file, "r", encoding="utf-8-sig") as fh:
             obj_content = fh.read()
 
-        # Inject extra properties after ExtendedConfigurationObject
+        # Dedup: skip attributes/TS already present in object's ChildObjects (idempotent re-borrow)
+        existing_child_names = set()
+        m_co = re.search(r'(?s)<ChildObjects>(.*?)</ChildObjects>', obj_content)
+        if m_co:
+            for nm in re.findall(r'<Name>(\w+)</Name>', m_co.group(1)):
+                existing_child_names.add(nm)
+        insert_attrs = [a for a in src_attrs if a["Name"] not in existing_child_names]
+        insert_ts = [t for t in src_ts if t["Name"] not in existing_child_names]
+
+        # Generate full object XML with attributes and TS
+        content_parts = []
+        for attr in insert_attrs:
+            content_parts.append(build_adopted_attribute_xml(attr["Name"], attr["Uuid"], attr["TypeXml"], "\t\t\t"))
+        for ts in insert_ts:
+            content_parts.append(build_adopted_tabular_section_xml(ts["Name"], ts["Uuid"], ts["GeneratedTypes"], ts["Attributes"], "\t\t\t"))
+        adopted_content = "\n".join(content_parts).rstrip()
+
+        # Inject extra properties into the object's OWN Properties only — idempotent and anchored to the
+        # first ExtendedConfigurationObject (the object's). On re-borrow, adopted attributes each have their
+        # own ExtendedConfigurationObject; a global replace would push object props inside every <Attribute>.
         if extra_props:
+            m_props = re.search(r'(?s)<Properties>(.*?)</Properties>', obj_content)
+            obj_props_block = m_props.group(1) if m_props else ""
             props_xml = ""
             for p_name, p_val in extra_props.items():
+                if f"<{p_name}>" in obj_props_block:
+                    continue
                 props_xml += f"\r\n\t\t\t<{p_name}>{p_val}</{p_name}>"
-            obj_content = obj_content.replace("</ExtendedConfigurationObject>", f"</ExtendedConfigurationObject>{props_xml}")
+            if props_xml:
+                obj_content = obj_content.replace("</ExtendedConfigurationObject>", f"</ExtendedConfigurationObject>{props_xml}", 1)
 
         # Replace empty ChildObjects with adopted content
         if adopted_content:
@@ -1005,86 +1175,100 @@ def main():
             target_dir = os.path.join(ext_dir, CHILD_TYPE_DIR_MAP[rt["TypeName"]])
             os.makedirs(target_dir, exist_ok=True)
             target_file = os.path.join(target_dir, f"{rt['ObjName']}.xml")
-            save_text_bom(target_file, borrowed_xml)
+            write_xml_file(target_file, borrowed_xml)
             add_to_child_objects(rt["TypeName"], rt["ObjName"])
             borrowed_files.append(target_file)
             info(f"  Auto-borrowed: {rt['TypeName']}.{rt['ObjName']}")
 
         # Step 5: Handle deep paths (Form mode only)
         if mode == "Form" and deep_paths:
-            # Filter out deep paths where ObjectAttr is a TabularSection
+            # Top-level ref deep paths: Объект.<Ref>.<Sub> — borrow the ref attribute's catalog with the sub-attribute
-            real_deep = [dp for dp in deep_paths if dp["ObjectAttr"] not in ts_names]
+            deep_by_attr = {}
-
+            for dp in deep_paths:
-            if real_deep:
+                if dp["ObjectAttr"] in ts_names:
-                info(f"  Processing {len(real_deep)} deep path(s)...")
+                    continue
-
+                deep_by_attr.setdefault(dp["ObjectAttr"], [])
-                # Group by ObjectAttr -> target catalog
+                if dp["SubAttr"] not in deep_by_attr[dp["ObjectAttr"]]:
-                deep_by_attr = {}
-                for dp in real_deep:
-                    if dp["ObjectAttr"] not in deep_by_attr:
-                        deep_by_attr[dp["ObjectAttr"]] = []
                     deep_by_attr[dp["ObjectAttr"]].append(dp["SubAttr"])
-
+            if deep_by_attr:
+                info(f"  Processing {len(deep_by_attr)} deep path attribute(s)...")
                 for attr_name, sub_attr_names in deep_by_attr.items():
-                    # Find the attribute's type to determine target catalog
+                    attr_info = next((a for a in src_attrs if a["Name"] == attr_name), None)
-                    attr_info = None
-                    for a in src_attrs:
-                        if a["Name"] == attr_name:
-                            attr_info = a
-                            break
                     if not attr_info:
                         continue
-
-                    # Extract catalog name from type: cfg:CatalogRef.XXX
                     cat_match = re.search(r'cfg:(\w+)Ref\.(\w+)', attr_info["TypeXml"])
                     if not cat_match:
                         continue
+                    borrow_deep_target_attrs(cat_match.group(1), cat_match.group(2), sub_attr_names)
 
-                    target_type_name = cat_match.group(1)
+            # Tabular-section deep paths: Объект.<ТЧ>.<Колонка>.<Sub> — borrow the column's catalog with the sub-attribute
-                    target_obj_name = cat_match.group(2)
+            ts_deep_by_col = {}
-
+            for dp in deep_paths:
-                    # Ensure target is borrowed
+                if dp["ObjectAttr"] not in ts_names:
-                    if not test_object_borrowed(target_type_name, target_obj_name):
+                    continue
-                        t_src = read_source_object(target_type_name, target_obj_name)
+                if not dp.get("SubSubAttr"):
-                        t_borrowed_xml = build_borrowed_object_xml(target_type_name, target_obj_name, t_src["Uuid"], t_src["Properties"])
+                    continue
-                        t_target_dir = os.path.join(ext_dir, CHILD_TYPE_DIR_MAP[target_type_name])
+                if dp["SubSubAttr"] in STANDARD_FIELDS:
-                        os.makedirs(t_target_dir, exist_ok=True)
+                    continue
-                        t_target_file = os.path.join(t_target_dir, f"{target_obj_name}.xml")
+                k = (dp["ObjectAttr"], dp["SubAttr"])
-                        save_text_bom(t_target_file, t_borrowed_xml)
+                ts_deep_by_col.setdefault(k, [])
-                        add_to_child_objects(target_type_name, target_obj_name)
+                if dp["SubSubAttr"] not in ts_deep_by_col[k]:
-                        borrowed_files.append(t_target_file)
+                    ts_deep_by_col[k].append(dp["SubSubAttr"])
-                        info(f"  Auto-borrowed for deep path: {target_type_name}.{target_obj_name}")
+            if ts_deep_by_col:
-
+                info(f"  Processing {len(ts_deep_by_col)} tabular-section deep path(s)...")
-                    # Resolve sub-attributes in target catalog
+                for (ts_name, col_name), sub_attr_names in ts_deep_by_col.items():
-                    sub_names = {sn: True for sn in sub_attr_names}
+                    ts_info = next((t for t in src_ts if t["Name"] == ts_name), None)
-                    sub_resolved = resolve_source_attributes(target_type_name, target_obj_name, sub_names)
+                    if not ts_info:
-
+                        continue
-                    if sub_resolved["Attributes"]:
+                    col_info = next((c for c in ts_info["Attributes"] if c["Name"] == col_name), None)
-                        merge_attributes_into_object(target_type_name, target_obj_name, sub_resolved["Attributes"])
+                    if not col_info:
-
+                        continue
-                        # Collect and borrow ref types from deep attributes
+                    cat_match = re.search(r'cfg:(\w+)Ref\.(\w+)', col_info["TypeXml"])
-                        sub_type_xmls = [sa["TypeXml"] for sa in sub_resolved["Attributes"]]
+                    if not cat_match:
-                        sub_ref_types = collect_reference_types(sub_type_xmls)
+                        continue
-                        for srt in sub_ref_types:
+                    borrow_deep_target_attrs(cat_match.group(1), cat_match.group(2), sub_attr_names)
-                            if srt["TypeName"] not in CHILD_TYPE_DIR_MAP:
-                                continue
-                            if test_object_borrowed(srt["TypeName"], srt["ObjName"]):
-                                continue
-                            s_src_file = os.path.join(cfg_dir, CHILD_TYPE_DIR_MAP[srt["TypeName"]], f"{srt['ObjName']}.xml")
-                            if not os.path.isfile(s_src_file):
-                                continue
-                            s_src = read_source_object(srt["TypeName"], srt["ObjName"])
-                            s_borrowed_xml = build_borrowed_object_xml(srt["TypeName"], srt["ObjName"], s_src["Uuid"], s_src["Properties"])
-                            s_target_dir = os.path.join(ext_dir, CHILD_TYPE_DIR_MAP[srt["TypeName"]])
-                            os.makedirs(s_target_dir, exist_ok=True)
-                            s_target_file = os.path.join(s_target_dir, f"{srt['ObjName']}.xml")
-                            save_text_bom(s_target_file, s_borrowed_xml)
-                            add_to_child_objects(srt["TypeName"], srt["ObjName"])
-                            borrowed_files.append(s_target_file)
-                            info(f"  Auto-borrowed (deep): {srt['TypeName']}.{srt['ObjName']}")
 
         info("  Main attribute borrowing complete")
 
+    def borrow_deep_target_attrs(target_type_name, target_obj_name, sub_attr_names):
+        # Borrow a deep-path target catalog together with the referenced sub-attributes, for both
+        # Объект.<Ref>.<Sub> and Объект.<ТЧ>.<Колонка>.<Sub>. Mirrors Designer: the referenced catalog
+        # is adopted WITH the sub-attributes the form shows, else the platform rejects the deep DataPath.
+        if not test_object_borrowed(target_type_name, target_obj_name):
+            t_src = read_source_object(target_type_name, target_obj_name)
+            t_borrowed_xml = build_borrowed_object_xml(target_type_name, target_obj_name, t_src["Uuid"], t_src["Properties"])
+            t_target_dir = os.path.join(ext_dir, CHILD_TYPE_DIR_MAP[target_type_name])
+            os.makedirs(t_target_dir, exist_ok=True)
+            t_target_file = os.path.join(t_target_dir, f"{target_obj_name}.xml")
+            write_xml_file(t_target_file, t_borrowed_xml)
+            add_to_child_objects(target_type_name, target_obj_name)
+            borrowed_files.append(t_target_file)
+            info(f"  Auto-borrowed for deep path: {target_type_name}.{target_obj_name}")
+
+        sub_names = {sn: True for sn in sub_attr_names}
+        sub_resolved = resolve_source_attributes(target_type_name, target_obj_name, sub_names)
+        if sub_resolved["Attributes"]:
+            merge_attributes_into_object(target_type_name, target_obj_name, sub_resolved["Attributes"])
+            sub_type_xmls = [sa["TypeXml"] for sa in sub_resolved["Attributes"]]
+            sub_ref_types = collect_reference_types(sub_type_xmls)
+            for srt in sub_ref_types:
+                if srt["TypeName"] not in CHILD_TYPE_DIR_MAP:
+                    continue
+                if test_object_borrowed(srt["TypeName"], srt["ObjName"]):
+                    continue
+                s_src_file = os.path.join(cfg_dir, CHILD_TYPE_DIR_MAP[srt["TypeName"]], f"{srt['ObjName']}.xml")
+                if not os.path.isfile(s_src_file):
+                    continue
+                s_src = read_source_object(srt["TypeName"], srt["ObjName"])
+                s_borrowed_xml = build_borrowed_object_xml(srt["TypeName"], srt["ObjName"], s_src["Uuid"], s_src["Properties"])
+                s_target_dir = os.path.join(ext_dir, CHILD_TYPE_DIR_MAP[srt["TypeName"]])
+                os.makedirs(s_target_dir, exist_ok=True)
+                s_target_file = os.path.join(s_target_dir, f"{srt['ObjName']}.xml")
+                write_xml_file(s_target_file, s_borrowed_xml)
+                add_to_child_objects(srt["TypeName"], srt["ObjName"])
+                borrowed_files.append(s_target_file)
+                info(f"  Auto-borrowed (deep): {srt['TypeName']}.{srt['ObjName']}")
+
     def borrow_form(type_name, obj_name, form_name, borrow_main_attr=False):
         dir_name = CHILD_TYPE_DIR_MAP[type_name]
 
@@ -1100,8 +1284,22 @@ def main():
         with open(src_form_xml_path, "r", encoding="utf-8-sig") as fh:
             src_form_content = fh.read()
 
-        # 3. Generate form metadata XML
+        # 3. Generate form metadata XML.
-        new_form_uuid = new_guid()
+        # If the wrapper was already borrowed, reuse its uuid so re-borrow is idempotent
+        # (regenerating it would churn the form's identity on every rerun).
+        existing_wrapper = os.path.join(ext_dir, dir_name, obj_name, "Forms", f"{form_name}.xml")
+        new_form_uuid = ""
+        if os.path.isfile(existing_wrapper):
+            try:
+                existing_root = etree.parse(existing_wrapper).getroot()
+                for c in existing_root:
+                    if isinstance(c.tag, str) and localname(c) == "Form":
+                        new_form_uuid = c.get("uuid", "") or ""
+                        break
+            except Exception:
+                new_form_uuid = ""
+        if not new_form_uuid:
+            new_form_uuid = new_guid()
         form_meta_lines = [
             '<?xml version="1.0" encoding="UTF-8"?>',
             f'<MetaDataObject {XMLNS_DECL} version="{format_version}">',
@@ -1123,7 +1321,7 @@ def main():
         os.makedirs(form_meta_dir, exist_ok=True)
 
         form_meta_file = os.path.join(form_meta_dir, f"{form_name}.xml")
-        save_text_bom(form_meta_file, "\n".join(form_meta_lines))
+        write_xml_file(form_meta_file, "\n".join(form_meta_lines))
         info(f"  Created: {form_meta_file}")
 
         # 5. Generate Form.xml with BaseForm
@@ -1131,7 +1329,10 @@ def main():
         src_form_tree = etree.parse(src_form_xml_path, src_form_parser)
         src_form_el = src_form_tree.getroot()
 
-        form_version = src_form_el.get("version", format_version)
+        # Borrowed form uses the extension's format version (not the source form's) — keeps the
+        # extension uniform; otherwise the platform rejects the import on a version mismatch
+        # (e.g. a 2.13 form inside a 2.17 extension). The platform upgrades the form to the root version.
+        form_version = format_version
 
         src_auto_cmd = None
         form_props = []
@@ -1149,25 +1350,21 @@ def main():
                 continue
             if not reached_visual:
                 # Form-level properties before AutoCommandBar (WindowOpeningMode, AutoFillCheck, etc.)
-                form_props.append(etree.tostring(fc, encoding="unicode"))
+                form_props.append(decode_numeric_entities(etree.tostring(fc, encoding="unicode")))
 
         ns_strip_pattern = re.compile(r'\s+xmlns(?::\w+)?="[^"]*"')
 
         # AutoCommandBar: keep ChildItems (buttons with CommandName->0), Autofill->false
         auto_cmd_xml = ""
         if src_auto_cmd is not None:
-            auto_cmd_xml = etree.tostring(src_auto_cmd, encoding="unicode")
+            auto_cmd_xml = decode_numeric_entities(etree.tostring(src_auto_cmd, encoding="unicode"))
             auto_cmd_xml = ns_strip_pattern.sub("", auto_cmd_xml)
             auto_cmd_xml = re.sub(r'<CommandName>[^<]*</CommandName>', '<CommandName>0</CommandName>', auto_cmd_xml)
             auto_cmd_xml = auto_cmd_xml.replace('<Autofill>true</Autofill>', '<Autofill>false</Autofill>')
             # Strip ExcludedCommand (references to standard commands invalid in extension)
             auto_cmd_xml = re.sub(r'\s*<ExcludedCommand>[^<]*</ExcludedCommand>', '', auto_cmd_xml)
-            # Strip DataPath in AutoCommandBar buttons
+            # Strip data-binding tags whose root attribute isn't borrowed
-            if borrow_main_attr:
+            auto_cmd_xml = strip_form_bindings(auto_cmd_xml, borrow_main_attr)
-                # Keep only Объект.* DataPaths
-                auto_cmd_xml = re.sub(r'\s*<DataPath>(?!\u041e\u0431\u044a\u0435\u043a\u0442\.)[^<]*</DataPath>', '', auto_cmd_xml)
-            else:
-                auto_cmd_xml = re.sub(r'\s*<DataPath>[^<]*</DataPath>', '', auto_cmd_xml)
 
         # ChildItems: copy full tree, clean up base-config references
         child_items_xml = ""
@@ -1178,20 +1375,12 @@ def main():
                 break
 
         if src_child_items is not None:
-            child_items_xml = etree.tostring(src_child_items, encoding="unicode")
+            child_items_xml = decode_numeric_entities(etree.tostring(src_child_items, encoding="unicode"))
             child_items_xml = ns_strip_pattern.sub("", child_items_xml)
             # Replace all CommandName values with 0
             child_items_xml = re.sub(r'<CommandName>[^<]*</CommandName>', '<CommandName>0</CommandName>', child_items_xml)
-            # Strip DataPath / TitleDataPath / RowPictureDataPath
+            # Strip data-binding tags whose root attribute isn't borrowed
-            if borrow_main_attr:
+            child_items_xml = strip_form_bindings(child_items_xml, borrow_main_attr)
-                # Keep only Объект.* DataPaths — strip form-attribute DataPaths (not borrowed)
-                child_items_xml = re.sub(r'\s*<DataPath>(?!\u041e\u0431\u044a\u0435\u043a\u0442\.)[^<]*</DataPath>', '', child_items_xml)
-                child_items_xml = re.sub(r'\s*<TitleDataPath>(?!\u041e\u0431\u044a\u0435\u043a\u0442\.)[^<]*</TitleDataPath>', '', child_items_xml)
-                child_items_xml = re.sub(r'\s*<RowPictureDataPath>[^<]*</RowPictureDataPath>', '', child_items_xml)
-            else:
-                child_items_xml = re.sub(r'\s*<DataPath>[^<]*</DataPath>', '', child_items_xml)
-                child_items_xml = re.sub(r'\s*<TitleDataPath>[^<]*</TitleDataPath>', '', child_items_xml)
-                child_items_xml = re.sub(r'\s*<RowPictureDataPath>[^<]*</RowPictureDataPath>', '', child_items_xml)
             # Strip ExcludedCommand in nested AutoCommandBars (references to standard commands invalid in extension)
             child_items_xml = re.sub(r'\s*<ExcludedCommand>[^<]*</ExcludedCommand>', '', child_items_xml)
             # Strip TypeLink blocks with human-readable DataPath (Items.XXX)
@@ -1218,7 +1407,7 @@ def main():
                         target_dir = os.path.join(ext_dir, "CommonPictures")
                         os.makedirs(target_dir, exist_ok=True)
                         target_file = os.path.join(target_dir, f"{pic_name}.xml")
-                        save_text_bom(target_file, borrowed_xml)
+                        write_xml_file(target_file, borrowed_xml)
                         add_to_child_objects("CommonPicture", pic_name)
                         auto_borrowed_pics.append(pic_name)
                         borrowed_files.append(target_file)
@@ -1267,7 +1456,7 @@ def main():
                         target_dir = os.path.join(ext_dir, "StyleItems")
                         os.makedirs(target_dir, exist_ok=True)
                         target_file = os.path.join(target_dir, f"{style_name}.xml")
-                        save_text_bom(target_file, borrowed_xml)
+                        write_xml_file(target_file, borrowed_xml)
                         add_to_child_objects("StyleItem", style_name)
                         borrowed_files.append(target_file)
                         info(f"  Auto-borrowed: StyleItem.{style_name}")
@@ -1331,14 +1520,17 @@ def main():
                         target_dir = os.path.join(ext_dir, "Enums")
                         os.makedirs(target_dir, exist_ok=True)
                         target_file = os.path.join(target_dir, f"{enum_name}.xml")
-                        save_text_bom(target_file, borrowed_xml)
+                        write_xml_file(target_file, borrowed_xml)
                         add_to_child_objects("Enum", enum_name)
                         borrowed_files.append(target_file)
                         info(f"  Auto-borrowed: Enum.{enum_name} (with {len(ev_xmls)} EnumValue(s))")
                     else:
                         warn(f"  Enum.{enum_name} not found in source config")
 
-        # Extract the <Form ...> opening tag from source text
+        # Открывающий тег <Form ...> берём из исходной формы — ради её объявлений пространств
+        # имён, но version подставляем СВОЮ: форма обязана нести версию расширения, иначе
+        # платформа отвергает импорт (форма 2.13 внутри расширения 2.17). Раньше тег
+        # копировался целиком, и версия источника молча побеждала.
         xml_decl = '<?xml version="1.0" encoding="UTF-8"?>'
         form_tag = f'<Form version="{form_version}">'
         m_decl = re.search(r'^(<\?xml[^?]*\?>)', src_form_content)
@@ -1346,7 +1538,15 @@ def main():
             xml_decl = m_decl.group(1)
         m_tag = re.search(r'(<Form[^>]*>)', src_form_content)
         if m_tag:
-            form_tag = m_tag.group(1)
+            src_ns = re.sub(r'^<Form\s*', '', m_tag.group(1))
+            src_ns = re.sub(r'\s*/?>$', '', src_ns)
+            src_ns = re.sub(r'\s*version="[^"]*"', '', src_ns)
+            # 2.21 (8.5): пространство палитры. Место строгое — после lf, перед style.
+            if format_rank(form_version) >= 221 and 'xmlns:pal=' not in src_ns:
+                src_ns = src_ns.replace(
+                    ' xmlns:style=',
+                    ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style=')
+            form_tag = f'<Form {src_ns} version="{form_version}">' if src_ns else f'<Form version="{form_version}">'
 
         # Build output
         parts = []
@@ -1425,15 +1625,19 @@ def main():
         form_xml_dir = os.path.join(form_meta_dir, form_name, "Ext")
         os.makedirs(form_xml_dir, exist_ok=True)
         form_xml_file = os.path.join(form_xml_dir, "Form.xml")
-        save_text_bom(form_xml_file, "".join(parts))
+        write_xml_file(form_xml_file, "".join(parts))
         info(f"  Created: {form_xml_file}")
 
-        # 6. Create empty Module.bsl
+        # 6. Create empty Module.bsl — but NEVER overwrite an existing one (re-borrow must
+        # not clobber user code added to the form module).
         module_dir = os.path.join(form_xml_dir, "Form")
         os.makedirs(module_dir, exist_ok=True)
         module_bsl_file = os.path.join(module_dir, "Module.bsl")
-        save_text_bom(module_bsl_file, "")
+        if os.path.isfile(module_bsl_file):
-        info(f"  Created: {module_bsl_file}")
+            info("  Preserved existing Module.bsl")
+        else:
+            save_text_bom(module_bsl_file, "")
+            info(f"  Created: {module_bsl_file}")
 
         # 7. Register form in parent object ChildObjects
         register_form_in_object(type_name, obj_name, form_name)
@@ -1505,7 +1709,7 @@ def main():
                 target_dir = os.path.join(ext_dir, dir_name)
                 os.makedirs(target_dir, exist_ok=True)
                 target_file = os.path.join(target_dir, f"{obj_name}.xml")
-                save_text_bom(target_file, borrowed_xml)
+                write_xml_file(target_file, borrowed_xml)
                 info(f"  Created: {target_file}")
 
                 add_to_child_objects(type_name, obj_name)
@@ -1532,7 +1736,7 @@ def main():
             os.makedirs(target_dir, exist_ok=True)
 
             target_file = os.path.join(target_dir, f"{obj_name}.xml")
-            save_text_bom(target_file, borrowed_xml)
+            write_xml_file(target_file, borrowed_xml)
             info(f"  Created: {target_file}")
 
             add_to_child_objects(type_name, obj_name)

.claude/skills/cfe-diff/SKILL.md

@@ -1,57 +1,57 @@
----
+---
-name: cfe-diff
+name: cfe-diff
-description: Анализ расширения конфигурации 1С (CFE) — состав, заимствованные объекты, перехватчики, проверка переноса. Используй когда нужно понять что содержит расширение или проверить перенесены ли вставки в конфигурацию
+description: Анализ расширения конфигурации 1С (CFE) — состав, заимствованные объекты, перехватчики, проверка переноса. Используй когда нужно понять что содержит расширение или проверить перенесены ли вставки в конфигурацию
-argument-hint: -ExtensionPath <path> -ConfigPath <path> [-Mode A|B]
+argument-hint: -ExtensionPath <path> -ConfigPath <path> [-Mode A|B]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cfe-diff — Анализ расширения конфигурации
+# /cfe-diff — Анализ расширения конфигурации
-
+
-Анализирует расширение в двух режимах: обзор изменений (Mode A) или проверка переноса (Mode B).
+Анализирует расширение в двух режимах: обзор изменений (Mode A) или проверка переноса (Mode B).
-
+
-## Параметры
+## Параметры
-
+
-| Параметр | Описание | По умолчанию |
+| Параметр | Описание | По умолчанию |
-|----------|----------|--------------|
+|----------|----------|--------------|
-| `ExtensionPath` | Путь к расширению (обязат.) | — |
+| `ExtensionPath` | Путь к расширению (обязат.) | — |
-| `ConfigPath` | Путь к конфигурации (обязат.) | — |
+| `ConfigPath` | Путь к конфигурации (обязат.) | — |
-| `Mode` | `A` (обзор) / `B` (проверка переноса) | `A` |
+| `Mode` | `A` (обзор) / `B` (проверка переноса) | `A` |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-diff.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-diff.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
-```
+```
-
+
-## Mode A — обзор расширения
+## Mode A — обзор расширения
-
+
-Для каждого объекта показывает:
+Для каждого объекта показывает:
-- `[BORROWED]` — заимствованный: перехватчики (`&Перед`, `&После`, `&ИзменениеИКонтроль`, `&Вместо`), собственные реквизиты/ТЧ/формы
+- `[BORROWED]` — заимствованный: перехватчики (`&Перед`, `&После`, `&ИзменениеИКонтроль`, `&Вместо`), собственные реквизиты/ТЧ/формы
-- `[OWN]` — собственный: количество реквизитов, ТЧ, форм
+- `[OWN]` — собственный: количество реквизитов, ТЧ, форм
-
+
-Для каждой формы заимствованного объекта показывается:
+Для каждой формы заимствованного объекта показывается:
-- `(borrowed)` / `(own)` — заимствованная или собственная форма
+- `(borrowed)` / `(own)` — заимствованная или собственная форма
-- callType-события формы и элементов
+- callType-события формы и элементов
-- callType на командах
+- callType на командах
-
+
-## Mode B — проверка переноса
+## Mode B — проверка переноса
-
+
-Для каждого `&ИзменениеИКонтроль` извлекает блоки `#Вставка`/`#КонецВставки` из расширения и ищет их в соответствующем модуле конфигурации.
+Для каждого `&ИзменениеИКонтроль` извлекает блоки `#Вставка`/`#КонецВставки` из расширения и ищет их в соответствующем модуле конфигурации.
-
+
-Статусы:
+Статусы:
-- `[TRANSFERRED]` — код найден в конфигурации
+- `[TRANSFERRED]` — код найден в конфигурации
-- `[NOT_TRANSFERRED]` — код не найден
+- `[NOT_TRANSFERRED]` — код не найден
-- `[NEEDS_REVIEW]` — нет блоков `#Вставка` или модуль конфигурации не найден
+- `[NEEDS_REVIEW]` — нет блоков `#Вставка` или модуль конфигурации не найден
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Обзор — что изменено в расширении
+# Обзор — что изменено в расширении
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
-
+
-# Проверка переноса — все ли #Вставка перенесены
+# Проверка переноса — все ли #Вставка перенесены
-... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode B
+... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode B
-```
+```

.claude/skills/cfe-diff/scripts/cfe-diff.ps1

@@ -1,471 +1,471 @@
-# cfe-diff v1.0 — Analyze and compare 1C configuration extension (CFE)
+# cfe-diff v1.0 — Analyze and compare 1C configuration extension (CFE)
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-param(
+param(
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$ExtensionPath,
+	[string]$ExtensionPath,
-
+
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$ConfigPath,
+	[string]$ConfigPath,
-
+
-	[ValidateSet("A","B")]
+	[ValidateSet("A","B")]
-	[string]$Mode = "A"
+	[string]$Mode = "A"
-)
+)
-
+
-$ErrorActionPreference = "Stop"
+$ErrorActionPreference = "Stop"
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-# --- Resolve paths ---
+# --- Resolve paths ---
-if (-not [System.IO.Path]::IsPathRooted($ExtensionPath)) {
+if (-not [System.IO.Path]::IsPathRooted($ExtensionPath)) {
-	$ExtensionPath = Join-Path (Get-Location).Path $ExtensionPath
+	$ExtensionPath = Join-Path (Get-Location).Path $ExtensionPath
-}
+}
-if (-not [System.IO.Path]::IsPathRooted($ConfigPath)) {
+if (-not [System.IO.Path]::IsPathRooted($ConfigPath)) {
-	$ConfigPath = Join-Path (Get-Location).Path $ConfigPath
+	$ConfigPath = Join-Path (Get-Location).Path $ConfigPath
-}
+}
-if (Test-Path $ExtensionPath -PathType Leaf) { $ExtensionPath = Split-Path $ExtensionPath -Parent }
+if (Test-Path $ExtensionPath -PathType Leaf) { $ExtensionPath = Split-Path $ExtensionPath -Parent }
-if (Test-Path $ConfigPath -PathType Leaf) { $ConfigPath = Split-Path $ConfigPath -Parent }
+if (Test-Path $ConfigPath -PathType Leaf) { $ConfigPath = Split-Path $ConfigPath -Parent }
-
+
-$extCfg = Join-Path $ExtensionPath "Configuration.xml"
+$extCfg = Join-Path $ExtensionPath "Configuration.xml"
-$srcCfg = Join-Path $ConfigPath "Configuration.xml"
+$srcCfg = Join-Path $ConfigPath "Configuration.xml"
-if (-not (Test-Path $extCfg)) { Write-Error "Extension Configuration.xml not found: $extCfg"; exit 1 }
+if (-not (Test-Path $extCfg)) { Write-Error "Extension Configuration.xml not found: $extCfg"; exit 1 }
-if (-not (Test-Path $srcCfg)) { Write-Error "Config Configuration.xml not found: $srcCfg"; exit 1 }
+if (-not (Test-Path $srcCfg)) { Write-Error "Config Configuration.xml not found: $srcCfg"; exit 1 }
-
+
-# --- Type -> directory mapping ---
+# --- Type -> directory mapping ---
-$childTypeDirMap = @{
+$childTypeDirMap = @{
-	"Catalog"="Catalogs"; "Document"="Documents"; "Enum"="Enums"
+	"Catalog"="Catalogs"; "Document"="Documents"; "Enum"="Enums"
-	"CommonModule"="CommonModules"; "CommonPicture"="CommonPictures"
+	"CommonModule"="CommonModules"; "CommonPicture"="CommonPictures"
-	"CommonCommand"="CommonCommands"; "CommonTemplate"="CommonTemplates"
+	"CommonCommand"="CommonCommands"; "CommonTemplate"="CommonTemplates"
-	"ExchangePlan"="ExchangePlans"; "Report"="Reports"; "DataProcessor"="DataProcessors"
+	"ExchangePlan"="ExchangePlans"; "Report"="Reports"; "DataProcessor"="DataProcessors"
-	"InformationRegister"="InformationRegisters"; "AccumulationRegister"="AccumulationRegisters"
+	"InformationRegister"="InformationRegisters"; "AccumulationRegister"="AccumulationRegisters"
-	"ChartOfCharacteristicTypes"="ChartsOfCharacteristicTypes"
+	"ChartOfCharacteristicTypes"="ChartsOfCharacteristicTypes"
-	"ChartOfAccounts"="ChartsOfAccounts"; "AccountingRegister"="AccountingRegisters"
+	"ChartOfAccounts"="ChartsOfAccounts"; "AccountingRegister"="AccountingRegisters"
-	"ChartOfCalculationTypes"="ChartsOfCalculationTypes"; "CalculationRegister"="CalculationRegisters"
+	"ChartOfCalculationTypes"="ChartsOfCalculationTypes"; "CalculationRegister"="CalculationRegisters"
-	"BusinessProcess"="BusinessProcesses"; "Task"="Tasks"
+	"BusinessProcess"="BusinessProcesses"; "Task"="Tasks"
-	"Subsystem"="Subsystems"; "Role"="Roles"; "Constant"="Constants"
+	"Subsystem"="Subsystems"; "Role"="Roles"; "Constant"="Constants"
-	"FunctionalOption"="FunctionalOptions"; "DefinedType"="DefinedTypes"
+	"FunctionalOption"="FunctionalOptions"; "DefinedType"="DefinedTypes"
-	"FunctionalOptionsParameter"="FunctionalOptionsParameters"
+	"FunctionalOptionsParameter"="FunctionalOptionsParameters"
-	"CommonForm"="CommonForms"; "DocumentJournal"="DocumentJournals"
+	"CommonForm"="CommonForms"; "DocumentJournal"="DocumentJournals"
-	"SessionParameter"="SessionParameters"; "StyleItem"="StyleItems"
+	"SessionParameter"="SessionParameters"; "StyleItem"="StyleItems"
-	"EventSubscription"="EventSubscriptions"; "ScheduledJob"="ScheduledJobs"
+	"EventSubscription"="EventSubscriptions"; "ScheduledJob"="ScheduledJobs"
-	"SettingsStorage"="SettingsStorages"; "FilterCriterion"="FilterCriteria"
+	"SettingsStorage"="SettingsStorages"; "FilterCriterion"="FilterCriteria"
-	"CommandGroup"="CommandGroups"; "DocumentNumerator"="DocumentNumerators"
+	"CommandGroup"="CommandGroups"; "DocumentNumerator"="DocumentNumerators"
-	"Sequence"="Sequences"; "IntegrationService"="IntegrationServices"
+	"Sequence"="Sequences"; "IntegrationService"="IntegrationServices"
-	"CommonAttribute"="CommonAttributes"
+	"CommonAttribute"="CommonAttributes"
-}
+}
-
+
-# --- Parse extension Configuration.xml ---
+# --- Parse extension Configuration.xml ---
-$extDoc = New-Object System.Xml.XmlDocument
+$extDoc = New-Object System.Xml.XmlDocument
-$extDoc.PreserveWhitespace = $false
+$extDoc.PreserveWhitespace = $false
-$extDoc.Load($extCfg)
+$extDoc.Load($extCfg)
-
+
-$ns = New-Object System.Xml.XmlNamespaceManager($extDoc.NameTable)
+$ns = New-Object System.Xml.XmlNamespaceManager($extDoc.NameTable)
-$ns.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
+$ns.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
-$ns.AddNamespace("xr", "http://v8.1c.ru/8.3/xcf/readable")
+$ns.AddNamespace("xr", "http://v8.1c.ru/8.3/xcf/readable")
-
+
-$extProps = $extDoc.SelectSingleNode("//md:Configuration/md:Properties", $ns)
+$extProps = $extDoc.SelectSingleNode("//md:Configuration/md:Properties", $ns)
-$extNameNode = $extProps.SelectSingleNode("md:Name", $ns)
+$extNameNode = $extProps.SelectSingleNode("md:Name", $ns)
-$extName = if ($extNameNode) { $extNameNode.InnerText } else { "?" }
+$extName = if ($extNameNode) { $extNameNode.InnerText } else { "?" }
-$prefixNode = $extProps.SelectSingleNode("md:NamePrefix", $ns)
+$prefixNode = $extProps.SelectSingleNode("md:NamePrefix", $ns)
-$namePrefix = if ($prefixNode -and $prefixNode.InnerText) { $prefixNode.InnerText } else { "" }
+$namePrefix = if ($prefixNode -and $prefixNode.InnerText) { $prefixNode.InnerText } else { "" }
-$purposeNode = $extProps.SelectSingleNode("md:ConfigurationExtensionPurpose", $ns)
+$purposeNode = $extProps.SelectSingleNode("md:ConfigurationExtensionPurpose", $ns)
-$purpose = if ($purposeNode) { $purposeNode.InnerText } else { "?" }
+$purpose = if ($purposeNode) { $purposeNode.InnerText } else { "?" }
-
+
-Write-Host "=== cfe-diff Mode ${Mode}: $extName (${purpose}) ==="
+Write-Host "=== cfe-diff Mode ${Mode}: $extName (${purpose}) ==="
-Write-Host "    NamePrefix: $namePrefix"
+Write-Host "    NamePrefix: $namePrefix"
-Write-Host ""
+Write-Host ""
-
+
-# --- Collect ChildObjects ---
+# --- Collect ChildObjects ---
-$childObjNode = $extDoc.SelectSingleNode("//md:Configuration/md:ChildObjects", $ns)
+$childObjNode = $extDoc.SelectSingleNode("//md:Configuration/md:ChildObjects", $ns)
-if (-not $childObjNode) {
+if (-not $childObjNode) {
-	Write-Host "[WARN] No ChildObjects in extension"
+	Write-Host "[WARN] No ChildObjects in extension"
-	exit 0
+	exit 0
-}
+}
-
+
-$objects = @()
+$objects = @()
-foreach ($child in $childObjNode.ChildNodes) {
+foreach ($child in $childObjNode.ChildNodes) {
-	if ($child.NodeType -ne 'Element') { continue }
+	if ($child.NodeType -ne 'Element') { continue }
-	if ($child.LocalName -eq "Language") { continue }
+	if ($child.LocalName -eq "Language") { continue }
-	$objects += @{ Type = $child.LocalName; Name = $child.InnerText }
+	$objects += @{ Type = $child.LocalName; Name = $child.InnerText }
-}
+}
-
+
-if ($objects.Count -eq 0) {
+if ($objects.Count -eq 0) {
-	Write-Host "No objects (besides Language) in extension."
+	Write-Host "No objects (besides Language) in extension."
-	exit 0
+	exit 0
-}
+}
-
+
-# --- Helper: check if object is borrowed ---
+# --- Helper: check if object is borrowed ---
-function Get-ObjectInfo {
+function Get-ObjectInfo {
-	param([string]$objType, [string]$objName)
+	param([string]$objType, [string]$objName)
-
+
-	if (-not $childTypeDirMap.ContainsKey($objType)) { return $null }
+	if (-not $childTypeDirMap.ContainsKey($objType)) { return $null }
-	$dirName = $childTypeDirMap[$objType]
+	$dirName = $childTypeDirMap[$objType]
-	$objFile = Join-Path (Join-Path $ExtensionPath $dirName) "${objName}.xml"
+	$objFile = Join-Path (Join-Path $ExtensionPath $dirName) "${objName}.xml"
-
+
-	if (-not (Test-Path $objFile)) { return @{ Borrowed = $false; File = $objFile; Exists = $false } }
+	if (-not (Test-Path $objFile)) { return @{ Borrowed = $false; File = $objFile; Exists = $false } }
-
+
-	$doc = New-Object System.Xml.XmlDocument
+	$doc = New-Object System.Xml.XmlDocument
-	$doc.PreserveWhitespace = $false
+	$doc.PreserveWhitespace = $false
-	$doc.Load($objFile)
+	$doc.Load($objFile)
-
+
-	$objNs = New-Object System.Xml.XmlNamespaceManager($doc.NameTable)
+	$objNs = New-Object System.Xml.XmlNamespaceManager($doc.NameTable)
-	$objNs.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
+	$objNs.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
-
+
-	$objEl = $null
+	$objEl = $null
-	foreach ($c in $doc.DocumentElement.ChildNodes) {
+	foreach ($c in $doc.DocumentElement.ChildNodes) {
-		if ($c.NodeType -eq 'Element') { $objEl = $c; break }
+		if ($c.NodeType -eq 'Element') { $objEl = $c; break }
-	}
+	}
-	if (-not $objEl) { return @{ Borrowed = $false; File = $objFile; Exists = $true } }
+	if (-not $objEl) { return @{ Borrowed = $false; File = $objFile; Exists = $true } }
-
+
-	$propsEl = $objEl.SelectSingleNode("md:Properties", $objNs)
+	$propsEl = $objEl.SelectSingleNode("md:Properties", $objNs)
-	$obNode = if ($propsEl) { $propsEl.SelectSingleNode("md:ObjectBelonging", $objNs) } else { $null }
+	$obNode = if ($propsEl) { $propsEl.SelectSingleNode("md:ObjectBelonging", $objNs) } else { $null }
-
+
-	$info = @{
+	$info = @{
-		Borrowed = ($obNode -and $obNode.InnerText -eq "Adopted")
+		Borrowed = ($obNode -and $obNode.InnerText -eq "Adopted")
-		File = $objFile
+		File = $objFile
-		Exists = $true
+		Exists = $true
-		Type = $objType
+		Type = $objType
-		Name = $objName
+		Name = $objName
-		DirName = $dirName
+		DirName = $dirName
-		ObjElement = $objEl
+		ObjElement = $objEl
-		ObjNs = $objNs
+		ObjNs = $objNs
-	}
+	}
-	return $info
+	return $info
-}
+}
-
+
-# --- Helper: find .bsl files for object ---
+# --- Helper: find .bsl files for object ---
-function Get-BslFiles {
+function Get-BslFiles {
-	param([string]$objType, [string]$objName)
+	param([string]$objType, [string]$objName)
-
+
-	if (-not $childTypeDirMap.ContainsKey($objType)) { return @() }
+	if (-not $childTypeDirMap.ContainsKey($objType)) { return @() }
-	$dirName = $childTypeDirMap[$objType]
+	$dirName = $childTypeDirMap[$objType]
-	$objDir = Join-Path (Join-Path $ExtensionPath $dirName) $objName
+	$objDir = Join-Path (Join-Path $ExtensionPath $dirName) $objName
-
+
-	if (-not (Test-Path $objDir -PathType Container)) { return @() }
+	if (-not (Test-Path $objDir -PathType Container)) { return @() }
-
+
-	$bslFiles = @()
+	$bslFiles = @()
-	$extDir = Join-Path $objDir "Ext"
+	$extDir = Join-Path $objDir "Ext"
-	if (Test-Path $extDir) {
+	if (Test-Path $extDir) {
-		$items = Get-ChildItem -Path $extDir -Filter "*.bsl" -ErrorAction SilentlyContinue
+		$items = Get-ChildItem -Path $extDir -Filter "*.bsl" -ErrorAction SilentlyContinue
-		foreach ($item in $items) { $bslFiles += $item.FullName }
+		foreach ($item in $items) { $bslFiles += $item.FullName }
-	}
+	}
-
+
-	# Forms
+	# Forms
-	$formsDir = Join-Path $objDir "Forms"
+	$formsDir = Join-Path $objDir "Forms"
-	if (Test-Path $formsDir) {
+	if (Test-Path $formsDir) {
-		$formModules = Get-ChildItem -Path $formsDir -Recurse -Filter "Module.bsl" -ErrorAction SilentlyContinue
+		$formModules = Get-ChildItem -Path $formsDir -Recurse -Filter "Module.bsl" -ErrorAction SilentlyContinue
-		foreach ($fm in $formModules) { $bslFiles += $fm.FullName }
+		foreach ($fm in $formModules) { $bslFiles += $fm.FullName }
-	}
+	}
-
+
-	return $bslFiles
+	return $bslFiles
-}
+}
-
+
-# --- Helper: parse interceptors from .bsl ---
+# --- Helper: parse interceptors from .bsl ---
-function Get-Interceptors {
+function Get-Interceptors {
-	param([string]$bslPath)
+	param([string]$bslPath)
-
+
-	if (-not (Test-Path $bslPath)) { return @() }
+	if (-not (Test-Path $bslPath)) { return @() }
-	$lines = [System.IO.File]::ReadAllLines($bslPath, [System.Text.Encoding]::UTF8)
+	$lines = [System.IO.File]::ReadAllLines($bslPath, [System.Text.Encoding]::UTF8)
-	$interceptors = @()
+	$interceptors = @()
-	$i = 0
+	$i = 0
-	while ($i -lt $lines.Count) {
+	while ($i -lt $lines.Count) {
-		$line = $lines[$i].Trim()
+		$line = $lines[$i].Trim()
-		if ($line -match '^&(Перед|После|ИзменениеИКонтроль|Вместо)\("([^"]+)"\)') {
+		if ($line -match '^&(Перед|После|ИзменениеИКонтроль|Вместо)\("([^"]+)"\)') {
-			$type = $Matches[1]
+			$type = $Matches[1]
-			$method = $Matches[2]
+			$method = $Matches[2]
-			$interceptors += @{ Type = $type; Method = $method; Line = $i + 1; File = $bslPath }
+			$interceptors += @{ Type = $type; Method = $method; Line = $i + 1; File = $bslPath }
-		}
+		}
-		$i++
+		$i++
-	}
+	}
-	return $interceptors
+	return $interceptors
-}
+}
-
+
-# --- Helper: extract #Вставка blocks from .bsl ---
+# --- Helper: extract #Вставка blocks from .bsl ---
-function Get-InsertionBlocks {
+function Get-InsertionBlocks {
-	param([string]$bslPath)
+	param([string]$bslPath)
-
+
-	if (-not (Test-Path $bslPath)) { return @() }
+	if (-not (Test-Path $bslPath)) { return @() }
-	$lines = [System.IO.File]::ReadAllLines($bslPath, [System.Text.Encoding]::UTF8)
+	$lines = [System.IO.File]::ReadAllLines($bslPath, [System.Text.Encoding]::UTF8)
-	$blocks = @()
+	$blocks = @()
-	$inBlock = $false
+	$inBlock = $false
-	$blockLines = @()
+	$blockLines = @()
-	$startLine = 0
+	$startLine = 0
-
+
-	for ($i = 0; $i -lt $lines.Count; $i++) {
+	for ($i = 0; $i -lt $lines.Count; $i++) {
-		$line = $lines[$i].Trim()
+		$line = $lines[$i].Trim()
-		if ($line -eq "#Вставка") {
+		if ($line -eq "#Вставка") {
-			$inBlock = $true
+			$inBlock = $true
-			$blockLines = @()
+			$blockLines = @()
-			$startLine = $i + 1
+			$startLine = $i + 1
-		} elseif ($line -eq "#КонецВставки" -and $inBlock) {
+		} elseif ($line -eq "#КонецВставки" -and $inBlock) {
-			$inBlock = $false
+			$inBlock = $false
-			$blocks += @{
+			$blocks += @{
-				StartLine = $startLine
+				StartLine = $startLine
-				EndLine = $i + 1
+				EndLine = $i + 1
-				Code = ($blockLines -join "`n").Trim()
+				Code = ($blockLines -join "`n").Trim()
-				File = $bslPath
+				File = $bslPath
-			}
+			}
-		} elseif ($inBlock) {
+		} elseif ($inBlock) {
-			$blockLines += $lines[$i]
+			$blockLines += $lines[$i]
-		}
+		}
-	}
+	}
-	return $blocks
+	return $blocks
-}
+}
-
+
-# --- Helper: analyze form for callType events and commands ---
+# --- Helper: analyze form for callType events and commands ---
-function Get-FormInterceptors {
+function Get-FormInterceptors {
-	param([string]$formXmlPath)
+	param([string]$formXmlPath)
-
+
-	if (-not (Test-Path $formXmlPath)) { return $null }
+	if (-not (Test-Path $formXmlPath)) { return $null }
-
+
-	$formDoc = New-Object System.Xml.XmlDocument
+	$formDoc = New-Object System.Xml.XmlDocument
-	$formDoc.PreserveWhitespace = $false
+	$formDoc.PreserveWhitespace = $false
-	try { $formDoc.Load($formXmlPath) } catch { return $null }
+	try { $formDoc.Load($formXmlPath) } catch { return $null }
-
+
-	$fNs = New-Object System.Xml.XmlNamespaceManager($formDoc.NameTable)
+	$fNs = New-Object System.Xml.XmlNamespaceManager($formDoc.NameTable)
-	$fNs.AddNamespace("f", "http://v8.1c.ru/8.3/xcf/logform")
+	$fNs.AddNamespace("f", "http://v8.1c.ru/8.3/xcf/logform")
-
+
-	$fRoot = $formDoc.DocumentElement
+	$fRoot = $formDoc.DocumentElement
-	$baseForm = $fRoot.SelectSingleNode("f:BaseForm", $fNs)
+	$baseForm = $fRoot.SelectSingleNode("f:BaseForm", $fNs)
-	$isBorrowed = ($baseForm -ne $null)
+	$isBorrowed = ($baseForm -ne $null)
-
+
-	$interceptors = @()
+	$interceptors = @()
-
+
-	# Form-level events with callType
+	# Form-level events with callType
-	$eventsNode = $fRoot.SelectSingleNode("f:Events", $fNs)
+	$eventsNode = $fRoot.SelectSingleNode("f:Events", $fNs)
-	if ($eventsNode) {
+	if ($eventsNode) {
-		foreach ($evt in $eventsNode.SelectNodes("f:Event", $fNs)) {
+		foreach ($evt in $eventsNode.SelectNodes("f:Event", $fNs)) {
-			$ct = $evt.GetAttribute("callType")
+			$ct = $evt.GetAttribute("callType")
-			if ($ct) {
+			if ($ct) {
-				$interceptors += "Event:$($evt.GetAttribute('name')) [$ct] -> $($evt.InnerText)"
+				$interceptors += "Event:$($evt.GetAttribute('name')) [$ct] -> $($evt.InnerText)"
-			}
+			}
-		}
+		}
-	}
+	}
-
+
-	# Element-level events with callType (scan all elements recursively)
+	# Element-level events with callType (scan all elements recursively)
-	$childItems = $fRoot.SelectSingleNode("f:ChildItems", $fNs)
+	$childItems = $fRoot.SelectSingleNode("f:ChildItems", $fNs)
-	if ($childItems) {
+	if ($childItems) {
-		foreach ($evtNode in $childItems.SelectNodes(".//*[f:Events/f:Event[@callType]]", $fNs)) {
+		foreach ($evtNode in $childItems.SelectNodes(".//*[f:Events/f:Event[@callType]]", $fNs)) {
-			$elName = $evtNode.GetAttribute("name")
+			$elName = $evtNode.GetAttribute("name")
-			foreach ($evt in $evtNode.SelectNodes("f:Events/f:Event[@callType]", $fNs)) {
+			foreach ($evt in $evtNode.SelectNodes("f:Events/f:Event[@callType]", $fNs)) {
-				$ct = $evt.GetAttribute("callType")
+				$ct = $evt.GetAttribute("callType")
-				$interceptors += "Element:${elName}.$($evt.GetAttribute('name')) [$ct] -> $($evt.InnerText)"
+				$interceptors += "Element:${elName}.$($evt.GetAttribute('name')) [$ct] -> $($evt.InnerText)"
-			}
+			}
-		}
+		}
-	}
+	}
-
+
-	# Commands with callType on Action
+	# Commands with callType on Action
-	foreach ($cmd in $fRoot.SelectNodes("f:Commands/f:Command", $fNs)) {
+	foreach ($cmd in $fRoot.SelectNodes("f:Commands/f:Command", $fNs)) {
-		$cmdName = $cmd.GetAttribute("name")
+		$cmdName = $cmd.GetAttribute("name")
-		foreach ($action in $cmd.SelectNodes("f:Action[@callType]", $fNs)) {
+		foreach ($action in $cmd.SelectNodes("f:Action[@callType]", $fNs)) {
-			$ct = $action.GetAttribute("callType")
+			$ct = $action.GetAttribute("callType")
-			$interceptors += "Command:$cmdName [$ct] -> $($action.InnerText)"
+			$interceptors += "Command:$cmdName [$ct] -> $($action.InnerText)"
-		}
+		}
-	}
+	}
-
+
-	return @{
+	return @{
-		IsBorrowed = $isBorrowed
+		IsBorrowed = $isBorrowed
-		Interceptors = $interceptors
+		Interceptors = $interceptors
-	}
+	}
-}
+}
-
+
-# ============================================================
+# ============================================================
-# MODE A: Extension overview
+# MODE A: Extension overview
-# ============================================================
+# ============================================================
-if ($Mode -eq "A") {
+if ($Mode -eq "A") {
-	$borrowedList = @()
+	$borrowedList = @()
-	$ownList = @()
+	$ownList = @()
-
+
-	foreach ($obj in $objects) {
+	foreach ($obj in $objects) {
-		$info = Get-ObjectInfo $obj.Type $obj.Name
+		$info = Get-ObjectInfo $obj.Type $obj.Name
-		if (-not $info) {
+		if (-not $info) {
-			Write-Host "  [?] $($obj.Type).$($obj.Name) — unknown type"
+			Write-Host "  [?] $($obj.Type).$($obj.Name) — unknown type"
-			continue
+			continue
-		}
+		}
-		if (-not $info.Exists) {
+		if (-not $info.Exists) {
-			Write-Host "  [?] $($obj.Type).$($obj.Name) — file not found"
+			Write-Host "  [?] $($obj.Type).$($obj.Name) — file not found"
-			continue
+			continue
-		}
+		}
-
+
-		if ($info.Borrowed) {
+		if ($info.Borrowed) {
-			$borrowedList += $obj
+			$borrowedList += $obj
-
+
-			Write-Host "  [BORROWED] $($obj.Type).$($obj.Name)"
+			Write-Host "  [BORROWED] $($obj.Type).$($obj.Name)"
-
+
-			# Find .bsl files and interceptors
+			# Find .bsl files and interceptors
-			$bslFiles = Get-BslFiles $obj.Type $obj.Name
+			$bslFiles = Get-BslFiles $obj.Type $obj.Name
-			foreach ($bsl in $bslFiles) {
+			foreach ($bsl in $bslFiles) {
-				$relPath = $bsl.Replace($ExtensionPath, "").TrimStart("\", "/")
+				$relPath = $bsl.Replace($ExtensionPath, "").TrimStart("\", "/")
-				$interceptors = Get-Interceptors $bsl
+				$interceptors = Get-Interceptors $bsl
-				if ($interceptors.Count -gt 0) {
+				if ($interceptors.Count -gt 0) {
-					foreach ($ic in $interceptors) {
+					foreach ($ic in $interceptors) {
-						Write-Host "             &$($ic.Type)(`"$($ic.Method)`") — line $($ic.Line) in $relPath"
+						Write-Host "             &$($ic.Type)(`"$($ic.Method)`") — line $($ic.Line) in $relPath"
-					}
+					}
-				} else {
+				} else {
-					Write-Host "             $relPath (no interceptors)"
+					Write-Host "             $relPath (no interceptors)"
-				}
+				}
-			}
+			}
-
+
-			# Check for own attributes/forms in ChildObjects
+			# Check for own attributes/forms in ChildObjects
-			if ($info.ObjElement) {
+			if ($info.ObjElement) {
-				$childObj = $info.ObjElement.SelectSingleNode("md:ChildObjects", $info.ObjNs)
+				$childObj = $info.ObjElement.SelectSingleNode("md:ChildObjects", $info.ObjNs)
-				if ($childObj) {
+				if ($childObj) {
-					$ownAttrs = 0
+					$ownAttrs = 0
-					$ownForms = 0
+					$ownForms = 0
-					$ownTS = 0
+					$ownTS = 0
-					$borrowedItems = 0
+					$borrowedItems = 0
-					$formNames = @()
+					$formNames = @()
-					foreach ($c in $childObj.ChildNodes) {
+					foreach ($c in $childObj.ChildNodes) {
-						if ($c.NodeType -ne 'Element') { continue }
+						if ($c.NodeType -ne 'Element') { continue }
-						$cProps = $c.SelectSingleNode("md:Properties", $info.ObjNs)
+						$cProps = $c.SelectSingleNode("md:Properties", $info.ObjNs)
-						if ($cProps) {
+						if ($cProps) {
-							$cOb = $cProps.SelectSingleNode("md:ObjectBelonging", $info.ObjNs)
+							$cOb = $cProps.SelectSingleNode("md:ObjectBelonging", $info.ObjNs)
-							if ($cOb -and $cOb.InnerText -eq "Adopted") {
+							if ($cOb -and $cOb.InnerText -eq "Adopted") {
-								$borrowedItems++
+								$borrowedItems++
-								continue
+								continue
-							}
+							}
-						}
+						}
-						switch ($c.LocalName) {
+						switch ($c.LocalName) {
-							"Attribute" { $ownAttrs++ }
+							"Attribute" { $ownAttrs++ }
-							"TabularSection" { $ownTS++ }
+							"TabularSection" { $ownTS++ }
-							"Form" { $formNames += $c.InnerText; $ownForms++ }
+							"Form" { $formNames += $c.InnerText; $ownForms++ }
-						}
+						}
-					}
+					}
-					$parts = @()
+					$parts = @()
-					if ($ownAttrs -gt 0) { $parts += "$ownAttrs own attrs" }
+					if ($ownAttrs -gt 0) { $parts += "$ownAttrs own attrs" }
-					if ($ownTS -gt 0) { $parts += "$ownTS own TS" }
+					if ($ownTS -gt 0) { $parts += "$ownTS own TS" }
-					if ($ownForms -gt 0) { $parts += "$ownForms own forms" }
+					if ($ownForms -gt 0) { $parts += "$ownForms own forms" }
-					if ($borrowedItems -gt 0) { $parts += "$borrowedItems borrowed items" }
+					if ($borrowedItems -gt 0) { $parts += "$borrowedItems borrowed items" }
-					if ($parts.Count -gt 0) {
+					if ($parts.Count -gt 0) {
-						Write-Host "             ChildObjects: $($parts -join ', ')"
+						Write-Host "             ChildObjects: $($parts -join ', ')"
-					}
+					}
-
+
-					# Analyze forms
+					# Analyze forms
-					$borrowedFormCount = 0
+					$borrowedFormCount = 0
-					$ownFormCount = 0
+					$ownFormCount = 0
-					foreach ($fn in $formNames) {
+					foreach ($fn in $formNames) {
-						$formXmlPath = Join-Path (Join-Path (Join-Path (Join-Path (Join-Path $ExtensionPath $info.DirName) $info.Name) "Forms") $fn) "Ext/Form.xml"
+						$formXmlPath = Join-Path (Join-Path (Join-Path (Join-Path (Join-Path $ExtensionPath $info.DirName) $info.Name) "Forms") $fn) "Ext/Form.xml"
-						$fi = Get-FormInterceptors $formXmlPath
+						$fi = Get-FormInterceptors $formXmlPath
-						if (-not $fi) {
+						if (-not $fi) {
-							Write-Host "             Form.$fn (?)"
+							Write-Host "             Form.$fn (?)"
-							continue
+							continue
-						}
+						}
-						$formTag = if ($fi.IsBorrowed) { "borrowed"; $borrowedFormCount++ } else { "own"; $ownFormCount++ }
+						$formTag = if ($fi.IsBorrowed) { "borrowed"; $borrowedFormCount++ } else { "own"; $ownFormCount++ }
-						if ($fi.Interceptors.Count -gt 0) {
+						if ($fi.Interceptors.Count -gt 0) {
-							Write-Host "             Form.$fn ($formTag):"
+							Write-Host "             Form.$fn ($formTag):"
-							foreach ($ic in $fi.Interceptors) {
+							foreach ($ic in $fi.Interceptors) {
-								Write-Host "               $ic"
+								Write-Host "               $ic"
-							}
+							}
-						} else {
+						} else {
-							Write-Host "             Form.$fn ($formTag)"
+							Write-Host "             Form.$fn ($formTag)"
-						}
+						}
-					}
+					}
-				}
+				}
-			}
+			}
-		} else {
+		} else {
-			$ownList += $obj
+			$ownList += $obj
-			Write-Host "  [OWN]      $($obj.Type).$($obj.Name)"
+			Write-Host "  [OWN]      $($obj.Type).$($obj.Name)"
-
+
-			# Brief info for own objects
+			# Brief info for own objects
-			if ($info.ObjElement) {
+			if ($info.ObjElement) {
-				$childObj = $info.ObjElement.SelectSingleNode("md:ChildObjects", $info.ObjNs)
+				$childObj = $info.ObjElement.SelectSingleNode("md:ChildObjects", $info.ObjNs)
-				if ($childObj) {
+				if ($childObj) {
-					$attrs = 0; $forms = 0; $ts = 0
+					$attrs = 0; $forms = 0; $ts = 0
-					foreach ($c in $childObj.ChildNodes) {
+					foreach ($c in $childObj.ChildNodes) {
-						if ($c.NodeType -ne 'Element') { continue }
+						if ($c.NodeType -ne 'Element') { continue }
-						switch ($c.LocalName) {
+						switch ($c.LocalName) {
-							"Attribute" { $attrs++ }
+							"Attribute" { $attrs++ }
-							"TabularSection" { $ts++ }
+							"TabularSection" { $ts++ }
-							"Form" { $forms++ }
+							"Form" { $forms++ }
-						}
+						}
-					}
+					}
-					$parts = @()
+					$parts = @()
-					if ($attrs -gt 0) { $parts += "$attrs attrs" }
+					if ($attrs -gt 0) { $parts += "$attrs attrs" }
-					if ($ts -gt 0) { $parts += "$ts TS" }
+					if ($ts -gt 0) { $parts += "$ts TS" }
-					if ($forms -gt 0) { $parts += "$forms forms" }
+					if ($forms -gt 0) { $parts += "$forms forms" }
-					if ($parts.Count -gt 0) {
+					if ($parts.Count -gt 0) {
-						Write-Host "             $($parts -join ', ')"
+						Write-Host "             $($parts -join ', ')"
-					}
+					}
-				}
+				}
-			}
+			}
-		}
+		}
-	}
+	}
-
+
-	Write-Host ""
+	Write-Host ""
-	Write-Host "=== Summary: $($borrowedList.Count) borrowed, $($ownList.Count) own objects ==="
+	Write-Host "=== Summary: $($borrowedList.Count) borrowed, $($ownList.Count) own objects ==="
-}
+}
-
+
-# ============================================================
+# ============================================================
-# MODE B: Transfer check
+# MODE B: Transfer check
-# ============================================================
+# ============================================================
-if ($Mode -eq "B") {
+if ($Mode -eq "B") {
-	$transferred = 0
+	$transferred = 0
-	$notTransferred = 0
+	$notTransferred = 0
-	$needsReview = 0
+	$needsReview = 0
-
+
-	foreach ($obj in $objects) {
+	foreach ($obj in $objects) {
-		$info = Get-ObjectInfo $obj.Type $obj.Name
+		$info = Get-ObjectInfo $obj.Type $obj.Name
-		if (-not $info -or -not $info.Exists -or -not $info.Borrowed) { continue }
+		if (-not $info -or -not $info.Exists -or -not $info.Borrowed) { continue }
-
+
-		# Find .bsl files with &ИзменениеИКонтроль
+		# Find .bsl files with &ИзменениеИКонтроль
-		$bslFiles = Get-BslFiles $obj.Type $obj.Name
+		$bslFiles = Get-BslFiles $obj.Type $obj.Name
-		foreach ($bsl in $bslFiles) {
+		foreach ($bsl in $bslFiles) {
-			$interceptors = Get-Interceptors $bsl
+			$interceptors = Get-Interceptors $bsl
-			$macInterceptors = @($interceptors | Where-Object { $_.Type -eq "ИзменениеИКонтроль" })
+			$macInterceptors = @($interceptors | Where-Object { $_.Type -eq "ИзменениеИКонтроль" })
-
+
-			if ($macInterceptors.Count -eq 0) { continue }
+			if ($macInterceptors.Count -eq 0) { continue }
-
+
-			foreach ($ic in $macInterceptors) {
+			foreach ($ic in $macInterceptors) {
-				$methodName = $ic.Method
+				$methodName = $ic.Method
-				$relBsl = $bsl.Replace($ExtensionPath, "").TrimStart("\", "/")
+				$relBsl = $bsl.Replace($ExtensionPath, "").TrimStart("\", "/")
-
+
-				# Find #Вставка blocks in this file
+				# Find #Вставка blocks in this file
-				$insertBlocks = Get-InsertionBlocks $bsl
+				$insertBlocks = Get-InsertionBlocks $bsl
-
+
-				if ($insertBlocks.Count -eq 0) {
+				if ($insertBlocks.Count -eq 0) {
-					Write-Host "  [NEEDS_REVIEW] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — no #Вставка blocks"
+					Write-Host "  [NEEDS_REVIEW] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — no #Вставка blocks"
-					$needsReview++
+					$needsReview++
-					continue
+					continue
-				}
+				}
-
+
-				# Find corresponding module in config
+				# Find corresponding module in config
-				if (-not $childTypeDirMap.ContainsKey($obj.Type)) { continue }
+				if (-not $childTypeDirMap.ContainsKey($obj.Type)) { continue }
-				$dirName = $childTypeDirMap[$obj.Type]
+				$dirName = $childTypeDirMap[$obj.Type]
-				$configBsl = $bsl.Replace($ExtensionPath, $ConfigPath)
+				$configBsl = $bsl.Replace($ExtensionPath, $ConfigPath)
-
+
-				if (-not (Test-Path $configBsl)) {
+				if (-not (Test-Path $configBsl)) {
-					Write-Host "  [NEEDS_REVIEW] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — config module not found"
+					Write-Host "  [NEEDS_REVIEW] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — config module not found"
-					$needsReview++
+					$needsReview++
-					continue
+					continue
-				}
+				}
-
+
-				$configContent = [System.IO.File]::ReadAllText($configBsl, [System.Text.Encoding]::UTF8)
+				$configContent = [System.IO.File]::ReadAllText($configBsl, [System.Text.Encoding]::UTF8)
-
+
-				$allTransferred = $true
+				$allTransferred = $true
-				foreach ($block in $insertBlocks) {
+				foreach ($block in $insertBlocks) {
-					$code = $block.Code
+					$code = $block.Code
-					if (-not $code) { continue }
+					if (-not $code) { continue }
-
+
-					# Normalize whitespace for comparison
+					# Normalize whitespace for comparison
-					$codeNorm = $code -replace '\s+', ' '
+					$codeNorm = $code -replace '\s+', ' '
-					$configNorm = $configContent -replace '\s+', ' '
+					$configNorm = $configContent -replace '\s+', ' '
-
+
-					if ($configNorm.Contains($codeNorm)) {
+					if ($configNorm.Contains($codeNorm)) {
-						# Found in config
+						# Found in config
-					} else {
+					} else {
-						$allTransferred = $false
+						$allTransferred = $false
-					}
+					}
-				}
+				}
-
+
-				if ($allTransferred) {
+				if ($allTransferred) {
-					Write-Host "  [TRANSFERRED]     $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — $($insertBlocks.Count) block(s)"
+					Write-Host "  [TRANSFERRED]     $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — $($insertBlocks.Count) block(s)"
-					$transferred++
+					$transferred++
-				} else {
+				} else {
-					Write-Host "  [NOT_TRANSFERRED] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — some blocks not found in config"
+					Write-Host "  [NOT_TRANSFERRED] $($obj.Type).$($obj.Name) — &ИзменениеИКонтроль(`"$methodName`") — some blocks not found in config"
-					$notTransferred++
+					$notTransferred++
-				}
+				}
-			}
+			}
-		}
+		}
-	}
+	}
-
+
-	Write-Host ""
+	Write-Host ""
-	Write-Host "=== Transfer check: $transferred transferred, $notTransferred not transferred, $needsReview needs review ==="
+	Write-Host "=== Transfer check: $transferred transferred, $notTransferred not transferred, $needsReview needs review ==="
-}
+}

.claude/skills/cfe-init/SKILL.md

@@ -1,71 +1,71 @@
----
+---
-name: cfe-init
+name: cfe-init
-description: Создать расширение конфигурации 1С (CFE) — scaffold XML-исходников. Используй когда нужно создать новое расширение для исправления, доработки или дополнения конфигурации
+description: Создать расширение конфигурации 1С (CFE) — scaffold XML-исходников. Используй когда нужно создать новое расширение для исправления, доработки или дополнения конфигурации
-argument-hint: <Name> [-ConfigPath <path>] [-Purpose Patch|Customization|AddOn] [-CompatibilityMode Version8_3_24]
+argument-hint: <Name> [-ConfigPath <path>] [-Purpose Patch|Customization|AddOn] [-CompatibilityMode Version8_3_24]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cfe-init — Создание расширения конфигурации 1С
+# /cfe-init — Создание расширения конфигурации 1С
-
+
-Создаёт scaffold расширения: `Configuration.xml`, `Languages/Русский.xml`, опционально `Roles/`.
+Создаёт scaffold расширения: `Configuration.xml`, `Languages/Русский.xml`, опционально `Roles/`.
-
+
-## Подготовка
+## Подготовка
-
+
-Если есть выгрузка базовой конфигурации, передай `-ConfigPath` — скрипт автоматически определит `CompatibilityMode` и UUID языка из базовой конфигурации.
+Если есть выгрузка базовой конфигурации, передай `-ConfigPath` — скрипт автоматически определит `CompatibilityMode` и UUID языка из базовой конфигурации.
-
+
-### Авто-определение ConfigPath
+### Авто-определение ConfigPath
-
+
-Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
+Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
-1. Прочитай `.v8-project.json` из корня проекта
+1. Прочитай `.v8-project.json` из корня проекта
-2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
+2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
-3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
+3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
-4. Если `configSrc` нет — спроси у пользователя
+4. Если `configSrc` нет — спроси у пользователя
-
+
-Если `.v8-project.json` не найден и `-ConfigPath` не задан — расширение создастся с предупреждением (UUID языка = нули, CompatibilityMode по умолчанию).
+Если `.v8-project.json` не найден и `-ConfigPath` не задан — расширение создастся с предупреждением (UUID языка = нули, CompatibilityMode по умолчанию).
-
+
-## Параметры
+## Параметры
-
+
-| Параметр | Описание | По умолчанию |
+| Параметр | Описание | По умолчанию |
-|----------|----------|--------------|
+|----------|----------|--------------|
-| `Name` | Имя расширения (обязат.) | — |
+| `Name` | Имя расширения (обязат.) | — |
-| `Synonym` | Синоним | = Name |
+| `Synonym` | Синоним | = Name |
-| `NamePrefix` | Префикс собственных объектов | = Name + "_" |
+| `NamePrefix` | Префикс собственных объектов | = Name + "_" |
-| `OutputDir` | Каталог для создания | `src` |
+| `OutputDir` | Каталог для создания | `src` |
-| `Purpose` | `Patch` (исправление) / `Customization` (доработка) / `AddOn` (дополнение) | `Customization` |
+| `Purpose` | `Patch` (исправление) / `Customization` (доработка) / `AddOn` (дополнение) | `Customization` |
-| `Version` | Версия расширения | — |
+| `Version` | Версия расширения | — |
-| `Vendor` | Поставщик | — |
+| `Vendor` | Поставщик | — |
-| `CompatibilityMode` | Режим совместимости | `Version8_3_24` |
+| `CompatibilityMode` | Режим совместимости | `Version8_3_24` |
-| `ConfigPath` | Путь к выгрузке базовой конфигурации (авто-определяет CompatibilityMode и Language UUID) | — |
+| `ConfigPath` | Путь к выгрузке базовой конфигурации (авто-определяет CompatibilityMode и Language UUID) | — |
-| `NoRole` | Без основной роли | false |
+| `NoRole` | Без основной роли | false |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-init.ps1" -Name "МоёРасширение"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-init.ps1" -Name "МоёРасширение"
-```
+```
-
+
-## Примеры
+## Примеры
-
+
-```powershell
+```powershell
-# Расширение для ERP с авто-определением совместимости из базовой конфигурации
+# Расширение для ERP с авто-определением совместимости из базовой конфигурации
-... -Name Расш1 -ConfigPath C:\WS\tasks\cfsrc\erp_8.3.24 -OutputDir src
+... -Name Расш1 -ConfigPath C:\WS\tasks\cfsrc\erp_8.3.24 -OutputDir src
-
+
-# Расширение-исправление с явным режимом совместимости
+# Расширение-исправление с явным режимом совместимости
-... -Name Расш1 -Purpose Patch -CompatibilityMode Version8_3_17 -OutputDir src
+... -Name Расш1 -Purpose Patch -CompatibilityMode Version8_3_17 -OutputDir src
-
+
-# Расширение-доработка с версией
+# Расширение-доработка с версией
-... -Name МоёРасширение -Version "1.0.0.1" -Vendor "Компания" -OutputDir src
+... -Name МоёРасширение -Version "1.0.0.1" -Vendor "Компания" -OutputDir src
-
+
-# Без роли, с явным префиксом
+# Без роли, с явным префиксом
-... -Name ИсправлениеБага -NamePrefix "ИБ_" -Purpose Patch -NoRole -OutputDir src
+... -Name ИсправлениеБага -NamePrefix "ИБ_" -Purpose Patch -NoRole -OutputDir src
-```
+```
-
+
-## Верификация
+## Верификация
-
+
-```
+```
-/cfe-validate <OutputDir>
+/cfe-validate <OutputDir>
-```
+```
-
+

.claude/skills/cfe-init/scripts/cfe-init.ps1

@@ -1,270 +1,313 @@
-# cfe-init v1.1 — Create 1C configuration extension scaffold (CFE)
+# cfe-init v1.7 — Create 1C configuration extension scaffold (CFE)
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-param(
+param(
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$Name,
+	[string]$Name,
-	[string]$Synonym = $Name,
+	[string]$Synonym = $Name,
-	[string]$NamePrefix,
+	[string]$NamePrefix,
-	[string]$OutputDir = "src",
+	[string]$OutputDir = "src",
-	[ValidateSet("Patch","Customization","AddOn")]
+	[ValidateSet("Patch","Customization","AddOn")]
-	[string]$Purpose = "Customization",
+	[string]$Purpose = "Customization",
-	[string]$Version,
+	[string]$Version,
-	[string]$Vendor,
+	[string]$Vendor,
-	[string]$CompatibilityMode = "Version8_3_24",
+	[string]$CompatibilityMode = "Version8_3_24",
-	[string]$ConfigPath,
+	[string]$ConfigPath,
-	[switch]$NoRole
+	[switch]$NoRole
-)
+)
-
+
-$ErrorActionPreference = "Stop"
+$ErrorActionPreference = "Stop"
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-# --- Default NamePrefix ---
+# --- Default NamePrefix ---
-if (-not $NamePrefix) {
+if (-not $NamePrefix) {
-	$NamePrefix = "${Name}_"
+	$NamePrefix = "${Name}_"
-}
+}
-
+
-# --- Resolve output dir ---
+# --- Resolve output dir ---
-if (-not [System.IO.Path]::IsPathRooted($OutputDir)) {
+if (-not [System.IO.Path]::IsPathRooted($OutputDir)) {
-	$OutputDir = Join-Path (Get-Location).Path $OutputDir
+	$OutputDir = Join-Path (Get-Location).Path $OutputDir
-}
+}
-
+
-# --- Check existing ---
+# --- Check existing ---
-$cfgFile = Join-Path $OutputDir "Configuration.xml"
+$cfgFile = Join-Path $OutputDir "Configuration.xml"
-if (Test-Path $cfgFile) {
+if (Test-Path $cfgFile) {
-	Write-Error "Configuration.xml already exists: $cfgFile"
+	Write-Error "Configuration.xml already exists: $cfgFile"
-	exit 1
+	exit 1
-}
+}
-
+
-# --- Resolve ConfigPath ---
+# MDClasses format version — inherited from the base config so the extension stays uniform
-$baseLangUuid = "00000000-0000-0000-0000-000000000000"
+# with it (a 2.13 base must yield a 2.13 extension, else platform import rejects the mismatch).
-if ($ConfigPath) {
+$formatVersion = "2.17"
-	if (-not [System.IO.Path]::IsPathRooted($ConfigPath)) {
+
-		$ConfigPath = Join-Path (Get-Location).Path $ConfigPath
+# --- Resolve ConfigPath ---
-	}
+$baseLangUuid = "00000000-0000-0000-0000-000000000000"
-	if (Test-Path $ConfigPath -PathType Container) {
+if ($ConfigPath) {
-		$candidate = Join-Path $ConfigPath "Configuration.xml"
+	if (-not [System.IO.Path]::IsPathRooted($ConfigPath)) {
-		if (Test-Path $candidate) { $ConfigPath = $candidate }
+		$ConfigPath = Join-Path (Get-Location).Path $ConfigPath
-		else { Write-Error "No Configuration.xml in config directory: $ConfigPath"; exit 1 }
+	}
-	}
+	if (Test-Path $ConfigPath -PathType Container) {
-	if (-not (Test-Path $ConfigPath)) { Write-Error "Config file not found: $ConfigPath"; exit 1 }
+		$candidate = Join-Path $ConfigPath "Configuration.xml"
-	$cfgDir = Split-Path (Resolve-Path $ConfigPath).Path -Parent
+		if (Test-Path $candidate) { $ConfigPath = $candidate }
-
+		else { Write-Error "No Configuration.xml in config directory: $ConfigPath"; exit 1 }
-	# 3a. Read Language UUID from base config
+	}
-	$baseLangFile = Join-Path (Join-Path $cfgDir "Languages") "Русский.xml"
+	if (-not (Test-Path $ConfigPath)) { Write-Error "Config file not found: $ConfigPath"; exit 1 }
-	if (Test-Path $baseLangFile) {
+	$cfgDir = Split-Path (Resolve-Path $ConfigPath).Path -Parent
-		$baseLangDoc = New-Object System.Xml.XmlDocument
+
-		$baseLangDoc.PreserveWhitespace = $false
+	# 3a. Read Language UUID from base config
-		$baseLangDoc.Load($baseLangFile)
+	$baseLangFile = Join-Path (Join-Path $cfgDir "Languages") "Русский.xml"
-		$langEl = $null
+	if (Test-Path $baseLangFile) {
-		foreach ($c in $baseLangDoc.DocumentElement.ChildNodes) {
+		$baseLangDoc = New-Object System.Xml.XmlDocument
-			if ($c.NodeType -eq 'Element' -and $c.LocalName -eq 'Language') { $langEl = $c; break }
+		$baseLangDoc.PreserveWhitespace = $false
-		}
+		$baseLangDoc.Load($baseLangFile)
-		if ($langEl) {
+		$langEl = $null
-			$baseLangUuid = $langEl.GetAttribute("uuid")
+		foreach ($c in $baseLangDoc.DocumentElement.ChildNodes) {
-			Write-Host "[INFO] Base config Language UUID: $baseLangUuid"
+			if ($c.NodeType -eq 'Element' -and $c.LocalName -eq 'Language') { $langEl = $c; break }
-		} else {
+		}
-			Write-Host "[WARN] No <Language> element in $baseLangFile"
+		if ($langEl) {
-		}
+			$baseLangUuid = $langEl.GetAttribute("uuid")
-	} else {
+			Write-Host "[INFO] Base config Language UUID: $baseLangUuid"
-		Write-Host "[WARN] Base config language not found: $baseLangFile"
+		} else {
-	}
+			Write-Host "[WARN] No <Language> element in $baseLangFile"
-
+		}
-	# 3b. Read CompatibilityMode and InterfaceCompatibilityMode from base config
+	} else {
-	$baseCfgDoc = New-Object System.Xml.XmlDocument
+		Write-Host "[WARN] Base config language not found: $baseLangFile"
-	$baseCfgDoc.PreserveWhitespace = $false
+	}
-	$baseCfgDoc.Load((Resolve-Path $ConfigPath).Path)
+
-	$baseCfgNs = New-Object System.Xml.XmlNamespaceManager($baseCfgDoc.NameTable)
+	# 3b. Read CompatibilityMode and InterfaceCompatibilityMode from base config
-	$baseCfgNs.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
+	$baseCfgDoc = New-Object System.Xml.XmlDocument
-	$compatNode = $baseCfgDoc.SelectSingleNode("//md:Configuration/md:Properties/md:CompatibilityMode", $baseCfgNs)
+	$baseCfgDoc.PreserveWhitespace = $false
-	if ($compatNode -and $compatNode.InnerText) {
+	$baseCfgDoc.Load((Resolve-Path $ConfigPath).Path)
-		$CompatibilityMode = $compatNode.InnerText.Trim()
+	$baseCfgNs = New-Object System.Xml.XmlNamespaceManager($baseCfgDoc.NameTable)
-		Write-Host "[INFO] Base config CompatibilityMode: $CompatibilityMode"
+	$baseCfgNs.AddNamespace("md", "http://v8.1c.ru/8.3/MDClasses")
-	} else {
+	$fmtVer = $baseCfgDoc.DocumentElement.GetAttribute("version")
-		Write-Host "[WARN] CompatibilityMode not found in base config, using default: $CompatibilityMode"
+	if ($fmtVer) {
-	}
+		$formatVersion = $fmtVer
-	$ifcNode = $baseCfgDoc.SelectSingleNode("//md:Configuration/md:Properties/md:InterfaceCompatibilityMode", $baseCfgNs)
+		Write-Host "[INFO] Base config format version: $formatVersion"
-	if ($ifcNode -and $ifcNode.InnerText) {
+	}
-		$InterfaceCompatibilityMode = $ifcNode.InnerText.Trim()
+	$compatNode = $baseCfgDoc.SelectSingleNode("//md:Configuration/md:Properties/md:CompatibilityMode", $baseCfgNs)
-		Write-Host "[INFO] Base config InterfaceCompatibilityMode: $InterfaceCompatibilityMode"
+	if ($compatNode -and $compatNode.InnerText) {
-	} else {
+		$CompatibilityMode = $compatNode.InnerText.Trim()
-		$InterfaceCompatibilityMode = "TaxiEnableVersion8_2"
+		Write-Host "[INFO] Base config CompatibilityMode: $CompatibilityMode"
-		Write-Host "[WARN] InterfaceCompatibilityMode not found in base config, using default: $InterfaceCompatibilityMode"
+	} else {
-	}
+		Write-Host "[WARN] CompatibilityMode not found in base config, using default: $CompatibilityMode"
-} else {
+	}
-	$InterfaceCompatibilityMode = "TaxiEnableVersion8_2"
+	$ifcNode = $baseCfgDoc.SelectSingleNode("//md:Configuration/md:Properties/md:InterfaceCompatibilityMode", $baseCfgNs)
-	Write-Host "[WARN] Language ExtendedConfigurationObject set to zeros. Use -ConfigPath to auto-resolve from base config, or fix manually before loading."
+	if ($ifcNode -and $ifcNode.InnerText) {
-}
+		$InterfaceCompatibilityMode = $ifcNode.InnerText.Trim()
-
+		Write-Host "[INFO] Base config InterfaceCompatibilityMode: $InterfaceCompatibilityMode"
-# --- Generate UUIDs ---
+	} else {
-$uuidCfg  = [guid]::NewGuid().ToString()
+		$InterfaceCompatibilityMode = "TaxiEnableVersion8_2"
-$uuidLang = [guid]::NewGuid().ToString()
+		Write-Host "[WARN] InterfaceCompatibilityMode not found in base config, using default: $InterfaceCompatibilityMode"
-$uuidRole = [guid]::NewGuid().ToString()
+	}
-
+} else {
-# 7 ContainedObject ObjectIds
+	$InterfaceCompatibilityMode = "TaxiEnableVersion8_2"
-$co1 = [guid]::NewGuid().ToString()
+	Write-Host "[WARN] Language ExtendedConfigurationObject set to zeros. Use -ConfigPath to auto-resolve from base config, or fix manually before loading."
-$co2 = [guid]::NewGuid().ToString()
+}
-$co3 = [guid]::NewGuid().ToString()
+
-$co4 = [guid]::NewGuid().ToString()
+# --- Generate UUIDs ---
-$co5 = [guid]::NewGuid().ToString()
+$uuidCfg  = [guid]::NewGuid().ToString()
-$co6 = [guid]::NewGuid().ToString()
+$uuidLang = [guid]::NewGuid().ToString()
-$co7 = [guid]::NewGuid().ToString()
+$uuidRole = [guid]::NewGuid().ToString()
-
+
-# --- Synonym XML ---
+# 7 ContainedObject ObjectIds
-$synonymXml = ""
+$co1 = [guid]::NewGuid().ToString()
-if ($Synonym) {
+$co2 = [guid]::NewGuid().ToString()
-	$synonymXml = "`r`n`t`t`t`t<v8:item>`r`n`t`t`t`t`t<v8:lang>ru</v8:lang>`r`n`t`t`t`t`t<v8:content>$([System.Security.SecurityElement]::Escape($Synonym))</v8:content>`r`n`t`t`t`t</v8:item>`r`n`t`t`t"
+$co3 = [guid]::NewGuid().ToString()
-}
+$co4 = [guid]::NewGuid().ToString()
-
+$co5 = [guid]::NewGuid().ToString()
-# --- Optional properties ---
+$co6 = [guid]::NewGuid().ToString()
-$vendorXml = if ($Vendor) { [System.Security.SecurityElement]::Escape($Vendor) } else { "" }
+$co7 = [guid]::NewGuid().ToString()
-$versionXml = if ($Version) { [System.Security.SecurityElement]::Escape($Version) } else { "" }
+
-
+# --- Synonym XML ---
-# --- Role name ---
+$synonymXml = ""
-$roleName = "${NamePrefix}ОсновнаяРоль"
+if ($Synonym) {
-
+	$synonymXml = "`r`n`t`t`t`t<v8:item>`r`n`t`t`t`t`t<v8:lang>ru</v8:lang>`r`n`t`t`t`t`t<v8:content>$([System.Security.SecurityElement]::Escape($Synonym))</v8:content>`r`n`t`t`t`t</v8:item>`r`n`t`t`t"
-# --- DefaultRoles XML ---
+}
-$defaultRolesXml = ""
+
-if (-not $NoRole) {
+# --- Optional properties ---
-	$defaultRolesXml = "`r`n`t`t`t`t<xr:Item xsi:type=`"xr:MDObjectRef`">Role.$roleName</xr:Item>`r`n`t`t`t"
+# Элемент целиком, а не значение внутри пары: при пустом значении Конфигуратор
-}
+# пишет <Vendor/>, а не <Vendor></Vendor>.
-
+$vendorEl = if ($Vendor) { "<Vendor>$([System.Security.SecurityElement]::Escape($Vendor))</Vendor>" } else { "<Vendor/>" }
-# --- ChildObjects ---
+$versionEl = if ($Version) { "<Version>$([System.Security.SecurityElement]::Escape($Version))</Version>" } else { "<Version/>" }
-$childObjectsXml = "`r`n`t`t`t<Language>Русский</Language>"
+
-if (-not $NoRole) {
+# --- Role name ---
-	$childObjectsXml += "`r`n`t`t`t<Role>$roleName</Role>"
+$roleName = "${NamePrefix}ОсновнаяРоль"
-}
+
-$childObjectsXml += "`r`n`t`t"
+# --- DefaultRoles XML ---
-
+# Элемент целиком: без роли Конфигуратор пишет <DefaultRoles/>, а не пустую пару.
-# --- Configuration.xml ---
+$defaultRolesEl = "<DefaultRoles/>"
-$cfgXml = @"
+if (-not $NoRole) {
-<?xml version="1.0" encoding="UTF-8"?>
+	$defaultRolesEl = "<DefaultRoles>`r`n`t`t`t`t<xr:Item xsi:type=`"xr:MDObjectRef`">Role.$roleName</xr:Item>`r`n`t`t`t</DefaultRoles>"
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+}
-	<Configuration uuid="$uuidCfg">
+
-		<InternalInfo>
+# --- ChildObjects ---
-			<xr:ContainedObject>
+$childObjectsXml = "`r`n`t`t`t<Language>Русский</Language>"
-				<xr:ClassId>9cd510cd-abfc-11d4-9434-004095e12fc7</xr:ClassId>
+if (-not $NoRole) {
-				<xr:ObjectId>$co1</xr:ObjectId>
+	$childObjectsXml += "`r`n`t`t`t<Role>$roleName</Role>"
-			</xr:ContainedObject>
+}
-			<xr:ContainedObject>
+$childObjectsXml += "`r`n`t`t"
-				<xr:ClassId>9fcd25a0-4822-11d4-9414-008048da11f9</xr:ClassId>
+
-				<xr:ObjectId>$co2</xr:ObjectId>
+# Объявления пространств имён — одной переменной: места эмиссии её только интерполируют.
-			</xr:ContainedObject>
+# Правки шапки (как xmlns:pal в формате 2.21) делаются здесь, в одном месте.
-			<xr:ContainedObject>
+$xmlnsDecl = 'xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-				<xr:ClassId>e3687481-0a87-462c-a166-9f34594f9bba</xr:ClassId>
+
-				<xr:ObjectId>$co3</xr:ObjectId>
+# Версия формата как число для сравнений: "2.20" → 220, "2.9" → 209.
-			</xr:ContainedObject>
+# Строковое сравнение здесь неверно ("2.9" > "2.17" лексикографически) — известная ловушка.
-			<xr:ContainedObject>
+function Get-FormatRank([string]$ver) {
-				<xr:ClassId>9de14907-ec23-4a07-96f0-85521cb6b53b</xr:ClassId>
+	if ($ver -match '^(\d+)\.(\d+)$') { return [int]$Matches[1] * 100 + [int]$Matches[2] }
-				<xr:ObjectId>$co4</xr:ObjectId>
+	return 0
-			</xr:ContainedObject>
+}
-			<xr:ContainedObject>
+
-				<xr:ClassId>51f2d5d8-ea4d-4064-8892-82951750031e</xr:ClassId>
+# 2.21 (8.5) добавила в шапку пространство палитры — ради <Color> у значений перечисления.
-				<xr:ObjectId>$co5</xr:ObjectId>
+# Вставляем НА МЕСТО (после lf, перед style): платформа держит объявления по алфавиту,
-			</xr:ContainedObject>
+# дописать в конец нельзя.
-			<xr:ContainedObject>
+# Caption/ShortCaption — свойства корня из того же формата 2.21, между Version и
-				<xr:ClassId>e68182ea-4237-4383-967f-90c1e3370bc7</xr:ClassId>
+# DefaultLanguage (позиция снята с выгрузки расширения из базы 8.5).
-				<xr:ObjectId>$co6</xr:ObjectId>
+$f221Captions = ""
-			</xr:ContainedObject>
+if ((Get-FormatRank $formatVersion) -ge 221) {
-			<xr:ContainedObject>
+	$xmlnsDecl = $xmlnsDecl -replace ' xmlns:style=', ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
-				<xr:ClassId>fb282519-d103-4dd3-bc12-cb271d631dfc</xr:ClassId>
+	$f221Captions = "`r`n`t`t`t<Caption/>`r`n`t`t`t<ShortCaption/>"
-				<xr:ObjectId>$co7</xr:ObjectId>
+}
-			</xr:ContainedObject>
+
-		</InternalInfo>
+# --- Configuration.xml ---
-		<Properties>
+$cfgXml = @"
-			<ObjectBelonging>Adopted</ObjectBelonging>
+<?xml version="1.0" encoding="UTF-8"?>
-			<Name>$([System.Security.SecurityElement]::Escape($Name))</Name>
+<MetaDataObject $xmlnsDecl version="$formatVersion">
-			<Synonym>$synonymXml</Synonym>
+	<Configuration uuid="$uuidCfg">
-			<Comment/>
+		<InternalInfo>
-			<ConfigurationExtensionPurpose>$Purpose</ConfigurationExtensionPurpose>
+			<xr:ContainedObject>
-			<KeepMappingToExtendedConfigurationObjectsByIDs>true</KeepMappingToExtendedConfigurationObjectsByIDs>
+				<xr:ClassId>9cd510cd-abfc-11d4-9434-004095e12fc7</xr:ClassId>
-			<NamePrefix>$([System.Security.SecurityElement]::Escape($NamePrefix))</NamePrefix>
+				<xr:ObjectId>$co1</xr:ObjectId>
-			<ConfigurationExtensionCompatibilityMode>$CompatibilityMode</ConfigurationExtensionCompatibilityMode>
+			</xr:ContainedObject>
-			<DefaultRunMode>ManagedApplication</DefaultRunMode>
+			<xr:ContainedObject>
-			<UsePurposes>
+				<xr:ClassId>9fcd25a0-4822-11d4-9414-008048da11f9</xr:ClassId>
-				<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
+				<xr:ObjectId>$co2</xr:ObjectId>
-			</UsePurposes>
+			</xr:ContainedObject>
-			<ScriptVariant>Russian</ScriptVariant>
+			<xr:ContainedObject>
-			<DefaultRoles>$defaultRolesXml</DefaultRoles>
+				<xr:ClassId>e3687481-0a87-462c-a166-9f34594f9bba</xr:ClassId>
-			<Vendor>$vendorXml</Vendor>
+				<xr:ObjectId>$co3</xr:ObjectId>
-			<Version>$versionXml</Version>
+			</xr:ContainedObject>
-			<DefaultLanguage>Language.Русский</DefaultLanguage>
+			<xr:ContainedObject>
-			<BriefInformation/>
+				<xr:ClassId>9de14907-ec23-4a07-96f0-85521cb6b53b</xr:ClassId>
-			<DetailedInformation/>
+				<xr:ObjectId>$co4</xr:ObjectId>
-			<Copyright/>
+			</xr:ContainedObject>
-			<VendorInformationAddress/>
+			<xr:ContainedObject>
-			<ConfigurationInformationAddress/>
+				<xr:ClassId>51f2d5d8-ea4d-4064-8892-82951750031e</xr:ClassId>
-			<InterfaceCompatibilityMode>$InterfaceCompatibilityMode</InterfaceCompatibilityMode>
+				<xr:ObjectId>$co5</xr:ObjectId>
-		</Properties>
+			</xr:ContainedObject>
-		<ChildObjects>$childObjectsXml</ChildObjects>
+			<xr:ContainedObject>
-	</Configuration>
+				<xr:ClassId>e68182ea-4237-4383-967f-90c1e3370bc7</xr:ClassId>
-</MetaDataObject>
+				<xr:ObjectId>$co6</xr:ObjectId>
-"@
+			</xr:ContainedObject>
-
+			<xr:ContainedObject>
-# --- Languages/Русский.xml (adopted format) ---
+				<xr:ClassId>fb282519-d103-4dd3-bc12-cb271d631dfc</xr:ClassId>
-$langXml = @"
+				<xr:ObjectId>$co7</xr:ObjectId>
-<?xml version="1.0" encoding="UTF-8"?>
+			</xr:ContainedObject>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+		</InternalInfo>
-	<Language uuid="$uuidLang">
+		<Properties>
-		<InternalInfo/>
+			<ObjectBelonging>Adopted</ObjectBelonging>
-		<Properties>
+			<Name>$([System.Security.SecurityElement]::Escape($Name))</Name>
-			<ObjectBelonging>Adopted</ObjectBelonging>
+			<Synonym>$synonymXml</Synonym>
-			<Name>Русский</Name>
+			<Comment/>
-			<Comment/>
+			<ConfigurationExtensionPurpose>$Purpose</ConfigurationExtensionPurpose>
-			<ExtendedConfigurationObject>$baseLangUuid</ExtendedConfigurationObject>
+			<KeepMappingToExtendedConfigurationObjectsByIDs>true</KeepMappingToExtendedConfigurationObjectsByIDs>
-			<LanguageCode>ru</LanguageCode>
+			<NamePrefix>$([System.Security.SecurityElement]::Escape($NamePrefix))</NamePrefix>
-		</Properties>
+			<ConfigurationExtensionCompatibilityMode>$CompatibilityMode</ConfigurationExtensionCompatibilityMode>
-	</Language>
+			<DefaultRunMode>ManagedApplication</DefaultRunMode>
-</MetaDataObject>
+			<UsePurposes>
-"@
+				<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
-
+			</UsePurposes>
-# --- Role XML ---
+			<ScriptVariant>Russian</ScriptVariant>
-$roleXml = @"
+			$defaultRolesEl
-<?xml version="1.0" encoding="UTF-8"?>
+			$vendorEl
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+			$versionEl$f221Captions
-	<Role uuid="$uuidRole">
+			<DefaultLanguage>Language.Русский</DefaultLanguage>
-		<Properties>
+			<BriefInformation/>
-			<Name>$([System.Security.SecurityElement]::Escape($roleName))</Name>
+			<DetailedInformation/>
-			<Synonym/>
+			<Copyright/>
-			<Comment/>
+			<VendorInformationAddress/>
-		</Properties>
+			<ConfigurationInformationAddress/>
-	</Role>
+			<InterfaceCompatibilityMode>$InterfaceCompatibilityMode</InterfaceCompatibilityMode>
-</MetaDataObject>
+		</Properties>
-"@
+		<ChildObjects>$childObjectsXml</ChildObjects>
-
+	</Configuration>
-# --- Create directories ---
+</MetaDataObject>
-if (-not (Test-Path $OutputDir)) {
+"@
-	New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+
-}
+# --- Languages/Русский.xml (adopted format) ---
-$langDir = Join-Path $OutputDir "Languages"
+$langXml = @"
-if (-not (Test-Path $langDir)) {
+<?xml version="1.0" encoding="UTF-8"?>
-	New-Item -ItemType Directory -Path $langDir -Force | Out-Null
+<MetaDataObject $xmlnsDecl version="$formatVersion">
-}
+	<Language uuid="$uuidLang">
-
+		<InternalInfo/>
-# --- Write files with UTF-8 BOM ---
+		<Properties>
-$enc = New-Object System.Text.UTF8Encoding($true)
+			<ObjectBelonging>Adopted</ObjectBelonging>
-
+			<Name>Русский</Name>
-[System.IO.File]::WriteAllText($cfgFile, $cfgXml, $enc)
+			<Comment/>
-$langFile = Join-Path $langDir "Русский.xml"
+			<ExtendedConfigurationObject>$baseLangUuid</ExtendedConfigurationObject>
-[System.IO.File]::WriteAllText($langFile, $langXml, $enc)
+			<LanguageCode>ru</LanguageCode>
-
+		</Properties>
-# --- Role ---
+	</Language>
-if (-not $NoRole) {
+</MetaDataObject>
-	$roleDir = Join-Path $OutputDir "Roles"
+"@
-	if (-not (Test-Path $roleDir)) {
+
-		New-Item -ItemType Directory -Path $roleDir -Force | Out-Null
+# --- Role XML ---
-	}
+$roleXml = @"
-	$roleFile = Join-Path $roleDir "$roleName.xml"
+<?xml version="1.0" encoding="UTF-8"?>
-	[System.IO.File]::WriteAllText($roleFile, $roleXml, $enc)
+<MetaDataObject $xmlnsDecl version="$formatVersion">
-}
+	<Role uuid="$uuidRole">
-
+		<Properties>
-# --- Output ---
+			<Name>$([System.Security.SecurityElement]::Escape($roleName))</Name>
-Write-Host "[OK] Создано расширение: $Name"
+			<Synonym/>
-Write-Host "     Каталог:            $OutputDir"
+			<Comment/>
-Write-Host "     Назначение:         $Purpose"
+		</Properties>
-Write-Host "     Префикс:           $NamePrefix"
+	</Role>
-Write-Host "     Совместимость:     $CompatibilityMode"
+</MetaDataObject>
-Write-Host "     Configuration.xml:  $cfgFile"
+"@
-Write-Host "     Languages:          $langFile"
+
-if (-not $NoRole) {
+# --- Create directories ---
-	Write-Host "     Role:               $roleFile"
+if (-not (Test-Path $OutputDir)) {
-}
+	New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+}
+$langDir = Join-Path $OutputDir "Languages"
+if (-not (Test-Path $langDir)) {
+	New-Item -ItemType Directory -Path $langDir -Force | Out-Null
+}
+
+# --- Write files with UTF-8 BOM ---
+$enc = New-Object System.Text.UTF8Encoding($true)
+
+# XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+#
+# Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+# копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+function Write-XmlFile([string]$path, [string]$text, $encoding) {
+	$t = ($text -replace "`r`n", "`n") -replace "`n", "`r`n"
+	[System.IO.File]::WriteAllText($path, $t.TrimEnd("`r", "`n"), $encoding)
+}
+
+Write-XmlFile $cfgFile $cfgXml $enc
+$langFile = Join-Path $langDir "Русский.xml"
+Write-XmlFile $langFile $langXml $enc
+
+# --- Role ---
+if (-not $NoRole) {
+	$roleDir = Join-Path $OutputDir "Roles"
+	if (-not (Test-Path $roleDir)) {
+		New-Item -ItemType Directory -Path $roleDir -Force | Out-Null
+	}
+	$roleFile = Join-Path $roleDir "$roleName.xml"
+	Write-XmlFile $roleFile $roleXml $enc
+}
+
+# --- Output ---
+Write-Host "[OK] Создано расширение: $Name"
+Write-Host "     Каталог:            $OutputDir"
+Write-Host "     Назначение:         $Purpose"
+Write-Host "     Префикс:           $NamePrefix"
+Write-Host "     Совместимость:     $CompatibilityMode"
+Write-Host "     Configuration.xml:  $cfgFile"
+Write-Host "     Languages:          $langFile"
+if (-not $NoRole) {
+	Write-Host "     Role:               $roleFile"
+}

.claude/skills/cfe-init/scripts/cfe-init.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python3
-# cfe-init v1.1 — Create 1C configuration extension scaffold (CFE)
+# cfe-init v1.7 — Create 1C configuration extension scaffold (CFE)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C configuration extension."""
-import sys, os, argparse, uuid
+import sys, os, re, argparse, uuid
 from xml.etree import ElementTree as ET
 
 def esc_xml(s):
@@ -15,6 +15,22 @@ def write_utf8_bom(path, content):
     with open(path, 'w', encoding='utf-8-sig', newline='') as f:
         f.write(content)
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    write_utf8_bom(path, text)
+
+
+def format_rank(ver):
+    """"2.20" → 220, "2.9" → 209. Строковое сравнение неверно ("2.9" > "2.17")."""
+    m = re.match(r'^(\d+)\.(\d+)$', ver or '')
+    return int(m.group(1)) * 100 + int(m.group(2)) if m else 0
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -50,6 +66,10 @@ def main():
         print(f"Configuration.xml already exists: {cfg_file}", file=sys.stderr)
         sys.exit(1)
 
+    # MDClasses format version — inherited from the base config so the extension stays uniform
+    # with it (a 2.13 base must yield a 2.13 extension, else platform import rejects the mismatch).
+    format_version = "2.17"
+
     # --- Resolve ConfigPath ---
     base_lang_uuid = "00000000-0000-0000-0000-000000000000"
     if args.ConfigPath:
@@ -88,6 +108,10 @@ def main():
         try:
             base_cfg_tree = ET.parse(os.path.abspath(config_path))
             base_cfg_root = base_cfg_tree.getroot()
+            fmt_ver = base_cfg_root.get("version")
+            if fmt_ver:
+                format_version = fmt_ver
+                print(f"[INFO] Base config format version: {format_version}")
             ns = {'md': 'http://v8.1c.ru/8.3/MDClasses'}
             compat_node = base_cfg_root.find('.//md:Configuration/md:Properties/md:CompatibilityMode', ns)
             if compat_node is not None and compat_node.text:
@@ -120,16 +144,21 @@ def main():
     if synonym:
         synonym_xml = f"\r\n\t\t\t\t<v8:item>\r\n\t\t\t\t\t<v8:lang>ru</v8:lang>\r\n\t\t\t\t\t<v8:content>{esc_xml(synonym)}</v8:content>\r\n\t\t\t\t</v8:item>\r\n\t\t\t"
 
-    vendor_xml = esc_xml(vendor) if vendor else ""
+    # Элемент целиком, а не значение внутри пары: при пустом значении Конфигуратор
-    version_xml = esc_xml(version) if version else ""
+    # пишет <Vendor/>, а не <Vendor></Vendor>.
+    vendor_el = f"<Vendor>{esc_xml(vendor)}</Vendor>" if vendor else "<Vendor/>"
+    version_el = f"<Version>{esc_xml(version)}</Version>" if version else "<Version/>"
 
     # --- Role name ---
     role_name = f"{name_prefix}ОсновнаяРоль"
 
     # --- DefaultRoles XML ---
-    default_roles_xml = ""
+    # Элемент целиком: без роли Конфигуратор пишет <DefaultRoles/>, а не пустую пару.
+    default_roles_el = "<DefaultRoles/>"
     if not args.NoRole:
-        default_roles_xml = f'\r\n\t\t\t\t<xr:Item xsi:type="xr:MDObjectRef">Role.{role_name}</xr:Item>\r\n\t\t\t'
+        default_roles_el = ('<DefaultRoles>\r\n\t\t\t\t'
+                            f'<xr:Item xsi:type="xr:MDObjectRef">Role.{role_name}</xr:Item>'
+                            '\r\n\t\t\t</DefaultRoles>')
 
     # --- ChildObjects ---
     child_objects_xml = f"\r\n\t\t\t<Language>Русский</Language>"
@@ -148,6 +177,40 @@ def main():
     ]
 
     contained_objects = ""
+
+    # Объявления пространств имён — одной переменной: места эмиссии её только подставляют.
+    # Правки шапки (как xmlns:pal в формате 2.21) делаются здесь, в одном месте.
+    xmlns_decl = (
+        'xmlns="http://v8.1c.ru/8.3/MDClasses"'
+        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
+        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
+        ' xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi"'
+        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
+        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
+        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
+        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
+        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
+        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
+        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
+        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
+        ' xmlns:xen="http://v8.1c.ru/8.3/xcf/enums"'
+        ' xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef"'
+        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
+        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+    )
+
+    # 2.21 (8.5) добавила в шапку пространство палитры — ради <Color> у значений перечисления.
+    # Вставляем НА МЕСТО (после lf, перед style): платформа держит объявления по алфавиту,
+    # дописать в конец нельзя.
+    # Caption/ShortCaption — свойства корня из того же формата 2.21, между Version и
+    # DefaultLanguage (позиция снята с выгрузки расширения из базы 8.5).
+    f221_captions = ""
+    if format_rank(format_version) >= 221:
+        xmlns_decl = xmlns_decl.replace(
+            ' xmlns:style=',
+            ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style=')
+        f221_captions = "\r\n\t\t\t<Caption/>\r\n\t\t\t<ShortCaption/>"
     for i in range(7):
         contained_objects += f"""\t\t\t<xr:ContainedObject>
 \t\t\t\t<xr:ClassId>{class_ids[i]}</xr:ClassId>
@@ -155,7 +218,7 @@ def main():
 \t\t\t</xr:ContainedObject>\n"""
 
     cfg_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<Configuration uuid="{uuid_cfg}">
 \t\t<InternalInfo>
 {contained_objects}\t\t</InternalInfo>
@@ -173,9 +236,9 @@ def main():
 \t\t\t\t<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
 \t\t\t</UsePurposes>
 \t\t\t<ScriptVariant>Russian</ScriptVariant>
-\t\t\t<DefaultRoles>{default_roles_xml}</DefaultRoles>
+\t\t\t{default_roles_el}
-\t\t\t<Vendor>{vendor_xml}</Vendor>
+\t\t\t{vendor_el}
-\t\t\t<Version>{version_xml}</Version>
+\t\t\t{version_el}{f221_captions}
 \t\t\t<DefaultLanguage>Language.Русский</DefaultLanguage>
 \t\t\t<BriefInformation/>
 \t\t\t<DetailedInformation/>
@@ -190,7 +253,7 @@ def main():
 
     # --- Languages/Русский.xml (adopted format) ---
     lang_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<Language uuid="{uuid_lang}">
 \t\t<InternalInfo/>
 \t\t<Properties>
@@ -205,7 +268,7 @@ def main():
 
     # --- Role XML ---
     role_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<Role uuid="{uuid_role}">
 \t\t<Properties>
 \t\t\t<Name>{esc_xml(role_name)}</Name>
@@ -221,9 +284,9 @@ def main():
     os.makedirs(lang_dir, exist_ok=True)
 
     # --- Write files ---
-    write_utf8_bom(cfg_file, cfg_xml)
+    write_xml_file(cfg_file, cfg_xml)
     lang_file = os.path.join(lang_dir, "Русский.xml")
-    write_utf8_bom(lang_file, lang_xml)
+    write_xml_file(lang_file, lang_xml)
 
     # --- Role ---
     role_file = None
@@ -231,7 +294,7 @@ def main():
         role_dir = os.path.join(output_dir, "Roles")
         os.makedirs(role_dir, exist_ok=True)
         role_file = os.path.join(role_dir, f"{role_name}.xml")
-        write_utf8_bom(role_file, role_xml)
+        write_xml_file(role_file, role_xml)
 
     # --- Output ---
     print(f"[OK] Создано расширение: {name}")

.claude/skills/cfe-patch-method/SKILL.md

@@ -1,78 +1,145 @@
----
+---
-name: cfe-patch-method
+name: cfe-patch-method
-description: Генерация перехватчика метода в расширении 1С (CFE). Используй когда нужно перехватить метод заимствованного объекта — вставить код до, после или вместо оригинального
+description: Генерация и актуализация перехватчика метода в расширении 1С (CFE). Используй когда нужно перехватить метод заимствованного объекта — вставить код до, после, вместо оригинала, изменить его тело (ИзменениеИКонтроль) — или актуализировать перехватчик после изменения оригинала
-argument-hint: -ExtensionPath <path> -ModulePath "Catalog.X.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+argument-hint: -ExtensionPath <path> -ConfigPath <path> -ModulePath "Catalog.X.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cfe-patch-method — Генерация перехватчика метода
+# /cfe-patch-method — Генерация перехватчика метода
-
+
-Генерирует `.bsl` файл с декоратором перехвата для заимствованного объекта расширения. Создаёт файл или дописывает в существующий.
+Читает оригинал метода из конфигурации-источника и генерирует `.bsl`-перехватчик заимствованного объекта: с правильной директивой контекста, полной сигнатурой, обрамляющими инструкциями препроцессора и областями. Для `ИзменениеИКонтроль` копирует всё тело оригинала. Создаёт файл модуля, дописывает в существующий или актуализирует уже заимствованный метод.
-
+
-## Предусловие
+## Предусловие
-
+
-Объект должен быть заимствован в расширение (`/cfe-borrow`). Скрипт читает `NamePrefix` из `Configuration.xml` расширения для формирования имени процедуры.
+Объект должен быть заимствован в расширение (`/cfe-borrow`). Нужен доступ к исходникам базовой конфигурации (`-ConfigPath`) — оттуда читается оригинал метода. `NamePrefix` берётся из `Configuration.xml` расширения.
-
+
-## Параметры
+### Авто-определение ConfigPath
-
+
-| Параметр | Описание | По умолчанию |
+Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
-|----------|----------|--------------|
+1. Прочитай `.v8-project.json` из корня проекта
-| `ExtensionPath` | Путь к расширению (обязат.) | — |
+2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
-| `ModulePath` | Путь к модулю (обязат.) | — |
+3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
-| `MethodName` | Имя перехватываемого метода (обязат.) | — |
+4. Если `configSrc` нет — спроси у пользователя
-| `InterceptorType` | `Before` / `After` / `ModificationAndControl` (обязат.) | — |
+
-| `Context` | Директива контекста | `НаСервере` |
+## Параметры
-| `IsFunction` | Метод — функция (добавит `Возврат`) | false |
+
-
+| Параметр | Описание | По умолчанию |
-## Формат ModulePath
+|----------|----------|--------------|
-
+| `ExtensionPath` | Путь к расширению (обязат.) | — |
-| ModulePath | Файл |
+| `ConfigPath` | Путь к конфигурации-источнику | обязат., кроме случая, когда `ModulePath` — путь к файлу |
-|------------|------|
+| `ModulePath` | Логическое имя (`Тип.Имя.Модуль`) **или** путь к файлу модуля `.bsl` | обязат. для генерации |
-| `Catalog.X.ObjectModule` | `Catalogs/X/Ext/ObjectModule.bsl` |
+| `MethodName` | Имя перехватываемого метода | обязат. для генерации |
-| `Catalog.X.ManagerModule` | `Catalogs/X/Ext/ManagerModule.bsl` |
+| `InterceptorType` | `Before` / `After` / `Instead` / `ModificationAndControl` | обязат. для генерации |
-| `Catalog.X.Form.Y` | `Catalogs/X/Forms/Y/Ext/Form/Module.bsl` |
+| `Check` | Проверить контролируемые методы на дрейф (только отчёт) | — |
-| `CommonModule.X` | `CommonModules/X/Ext/Module.bsl` |
+| `Actualize` | Актуализировать дрейфнувшие контролируемые методы | — |
-| `Document.X.ObjectModule` | `Documents/X/Ext/ObjectModule.bsl` |
+
-| `Document.X.Form.Y` | `Documents/X/Forms/Y/Ext/Form/Module.bsl` |
+## Формат ModulePath
-
+
-Аналогично для Report, DataProcessor, InformationRegister и других типов.
+| ModulePath | Файл |
-
+|------------|------|
-## Типы перехвата
+| `Catalog.X.ObjectModule` | `Catalogs/X/Ext/ObjectModule.bsl` |
-
+| `Catalog.X.ManagerModule` | `Catalogs/X/Ext/ManagerModule.bsl` |
-| InterceptorType | Декоратор | Назначение |
+| `Catalog.X.Form.Y` | `Catalogs/X/Forms/Y/Ext/Form/Module.bsl` |
-|-----------------|-----------|------------|
+| `CommonModule.X` | `CommonModules/X/Ext/Module.bsl` |
-| `Before` | `&Перед` | Код до вызова оригинального метода |
+| `Document.X.ObjectModule` | `Documents/X/Ext/ObjectModule.bsl` |
-| `After` | `&После` | Код после вызова оригинального метода |
+| `Document.X.Form.Y` | `Documents/X/Forms/Y/Ext/Form/Module.bsl` |
-| `ModificationAndControl` | `&ИзменениеИКонтроль` | Копия тела метода с маркерами `#Вставка`/`#Удаление` |
+
-
+Аналогично для Report, DataProcessor, InformationRegister и других типов.
-## Команда
+
-
+Вместо логического имени в `ModulePath` можно передать **путь к файлу** модуля-источника `.bsl` — тогда `-ConfigPath` указывать не нужно (оригинал читается прямо из этого файла). Путь модуля расширения определяется от типовой папки в пути автоматически.
-```powershell
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.ps1" -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+## Типы перехвата
-```
+
-
+| InterceptorType | Декоратор | Назначение | Применим к |
-## Примеры
+|-----------------|-----------|------------|------------|
-
+| `Before` | `&Перед` | Код до вызова оригинального метода | процедуры |
-```powershell
+| `After` | `&После` | Код после вызова оригинального метода | процедуры |
-# Перехват &Перед на сервере
+| `Instead` | `&Вместо` | Замена метода; в теле — скаффолд `ПродолжитьВызов(...)` | процедуры и функции |
-... -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+| `ModificationAndControl` | `&ИзменениеИКонтроль` | Копия тела оригинала для правки маркерами `#Вставка`/`#Удаление` | процедуры и функции |
-
+
-# Перехват &После на клиенте
+## Маркеры `#Вставка` / `#Удаление` (для `ModificationAndControl`)
-... -ExtensionPath src -ModulePath "Document.Заказ.Form.ФормаДокумента" -MethodName "ПослеЗаписиНаСервере" -InterceptorType After -Context "НаКлиенте"
+
-
+`&ИзменениеИКонтроль` вставляет в перехватчик **копию тела оригинала**. Дальше отредактируй тело под свою доработку, **помечая каждое изменение** — платформа так отличает твою правку от неизменного оригинала:
-# ИзменениеИКонтроль для функции
+
-... -ExtensionPath src -ModulePath "CommonModule.ОбщийМодуль" -MethodName "ПолучитьДанные" -InterceptorType ModificationAndControl -IsFunction
+- **Добавляешь код** → оберни его `#Вставка` … `#КонецВставки`.
-```
+- **Удаляешь код оригинала** → оберни удаляемые строки `#Удаление` … `#КонецУдаления`, но сами строки **оставь между маркерами** (платформа сверяет их с оригиналом).
-
+- **Заменяешь** → `#Удаление` старое `#КонецУдаления` сразу за ним `#Вставка` новое `#КонецВставки`.
-## Генерируемый код (Before)
+
-
+Пример:
-```bsl
+```bsl
-&НаСервере
+&ИзменениеИКонтроль("ПриЗаписи")
-&Перед("ПриЗаписи")
+Процедура Расш_ПриЗаписи(Отказ)
-Процедура Расш1_ПриЗаписи()
+	СуммаДокумента = РассчитатьСумму();
-	// TODO: код перед вызовом оригинального метода
+#Вставка
-КонецПроцедуры
+	// доработка: округляем
-```
+	СуммаДокумента = Окр(СуммаДокумента, 2);
+#КонецВставки
+#Удаление
+	Записать();
+#КонецУдаления
+#Вставка
+	ЗаписатьСПроверкой(Отказ);
+#КонецВставки
+КонецПроцедуры
+```
+
+Правила:
+- Маркеры — на **отдельной строке с 0-й колонки** (без отступа), даже внутри отступов и текста запроса (`|…`).
+- **Незамеченные (unmarked) строки должны совпадать с оригиналом дословно** — это и есть «контроль». Если оригинал в конфигурации-источнике изменится, unmarked-контекст разойдётся → метод потребует актуализации (см. ниже; проверить пачкой — `-Check`).
+- Меняешь только свои `#Вставка`/`#Удаление`; чужой оригинал не трогай.
+
+## Актуализация
+
+После изменения оригинала в конфигурации-источнике перехватчик `&ИзменениеИКонтроль` может рассинхронизироваться — unmarked-контекст разойдётся с новым оригиналом. Платформа при загрузке об этом молчит, поэтому актуализируй сам:
+
+- **Проверить** — `-Check`: отчёт по всем контролируемым методам расширения, ничего не пишет (`exit 1`, если есть дрейф или конфликт).
+- **Актуализировать** — `-Actualize`: переносит правки (`#Вставка`/`#Удаление`) на новый оригинал по всему расширению. Сузить область: `-ModulePath` — один модуль, `+ -MethodName` — один метод. Для одного метода то же делает повторный вызов с `-InterceptorType ModificationAndControl`.
+
+Статусы в выводе:
+
+- `[АКТУАЛЕН]` — оригинал не менялся, правок нет;
+- `[АКТУАЛИЗИРОВАН]` — тело обновлено по новому оригиналу, правки сохранены (в выводе — сводка);
+- `[АКТУАЛИЗИРОВАН-ЧАСТИЧНО]` — часть правок не удалось разместить (якорь изменился в новом оригинале). Они помечены `// [РЕСИНК-КОНФЛИКТ]` в модуле и не потеряны; путь к merge-воркспейсу — в выводе (начни с `index.md`, дальше по каждому конфликту его `conflict.md`, размести блоки вручную в `.bsl` расширения);
+- `[ПЕРЕНЕСЕНО В ОСНОВНУЮ]` — правка уже есть в новом оригинале (вставленный код внесён вендором) или удаляемый блок уже вырезан. Правка неактуальна — убирается из тела, дублировать/конфликтовать не нужно. Если так со всеми правками метода — перехватчик можно удалить. `-Check` этим не роняет `exit`.
+
+Повторный вызов `Before`/`After`/`Instead` для уже перехваченного метода дубль не создаёт (`[ПРОПУЩЕН]`).
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.ps1" -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+```
+
+## Примеры
+
+```powershell
+# Код перед записью
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+
+# Перехват После на форме
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -ModulePath "Document.Заказ.Form.ФормаДокумента" -MethodName "ПослеЗаписиНаСервере" -InterceptorType After
+
+# Замена функции (ПродолжитьВызов)
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -ModulePath "CommonModule.ОбщийМодуль" -MethodName "ПолучитьДанные" -InterceptorType Instead
+
+# ИзменениеИКонтроль — копия тела для правки маркерами
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -ModulePath "Document.РеализацияТоваров.ObjectModule" -MethodName "ОбработкаПроведения" -InterceptorType ModificationAndControl
+
+# ModulePath как путь к файлу модуля-источника (без -ConfigPath)
+... -ExtensionPath src\cfe\ИмяРасширения -ModulePath "src\cf\CommonModules\ОбщийМодуль\Ext\Module.bsl" -MethodName "ПолучитьДанные" -InterceptorType Instead
+
+# Проверить все контролируемые методы расширения на дрейф
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -Check
+
+# Актуализировать дрейфнувшие контролируемые методы пачкой
+... -ExtensionPath src\cfe\ИмяРасширения -ConfigPath src\cf -Actualize
+```
+
+## Верификация
+
+```
+/cfe-validate <ExtensionPath>
+```

.claude/skills/cfe-validate/SKILL.md

@@ -1,29 +1,29 @@
----
+---
-name: cfe-validate
+name: cfe-validate
-description: Валидация расширения конфигурации 1С (CFE). Используй после создания или модификации расширения для проверки корректности
+description: Валидация расширения конфигурации 1С (CFE). Используй после создания или модификации расширения для проверки корректности
-argument-hint: <ExtensionPath> [-Detailed] [-MaxErrors 30]
+argument-hint: <ExtensionPath> [-Detailed] [-MaxErrors 30]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /cfe-validate — валидация расширения конфигурации (CFE)
+# /cfe-validate — валидация расширения конфигурации (CFE)
-
+
-Проверяет структурную корректность расширения: XML-формат, свойства, состав, заимствованные объекты. Аналог `/cf-validate`, но для расширений.
+Проверяет структурную корректность расширения: XML-формат, свойства, состав, заимствованные объекты. Аналог `/cf-validate`, но для расширений.
-
+
-## Параметры
+## Параметры
-
+
-| Параметр      | Обяз. | Умолч. | Описание                                        |
+| Параметр      | Обяз. | Умолч. | Описание                                        |
-|---------------|:-----:|---------|-------------------------------------------------|
+|---------------|:-----:|---------|-------------------------------------------------|
-| ExtensionPath | да    | —       | Путь к каталогу или Configuration.xml расширения |
+| ExtensionPath | да    | —       | Путь к каталогу или Configuration.xml расширения |
-| Detailed      | нет   | —       | Подробный вывод (все проверки, включая успешные)  |
+| Detailed      | нет   | —       | Подробный вывод (все проверки, включая успешные)  |
-| MaxErrors     | нет   | 30      | Остановиться после N ошибок                      |
+| MaxErrors     | нет   | 30      | Остановиться после N ошибок                      |
-| OutFile       | нет   | —       | Записать результат в файл                        |
+| OutFile       | нет   | —       | Записать результат в файл                        |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src/Configuration.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src/Configuration.xml"
-```
+```

.claude/skills/cfe-validate/scripts/cfe-validate.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# cfe-validate v1.4 — Validate 1C configuration extension XML structure (CFE)
+# cfe-validate v1.5 — Validate 1C configuration extension XML structure (CFE)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Validates extension Configuration.xml: root, InternalInfo, extension properties, ChildObjects, borrowed objects."""
 import sys, os, argparse, re
@@ -216,8 +216,9 @@ def main():
     version = root.get('version', '')
     if not version:
         r.warn('1. Missing version attribute on MetaDataObject')
-    elif version not in ('2.17', '2.20', '2.21'):
+    elif version not in ('2.17', '2.18', '2.19', '2.20', '2.21'):
-        r.warn(f"1. Unusual version '{version}' (expected 2.17, 2.20 or 2.21)")
+        # Лестница версий формата: 2.17 (8.3.20-8.3.24), 2.18 (8.3.25), 2.19 (8.3.26), 2.20 (8.3.27).
+        r.warn(f"1. Unusual version '{version}' (expected 2.17-2.20 or 2.21)")
 
     # Must have Configuration child
     cfg_node = None
@@ -885,6 +886,21 @@ def main():
     elif check13_ok:
         r.ok('13. TypeLink: clean')
 
+    # --- Breadcrumb: controlled methods (&ИзменениеИКонтроль) drift is not checked here ---
+    ctrl_count = 0
+    for dp, _dn, files in os.walk(config_dir):
+        for fn in files:
+            if fn.endswith('.bsl'):
+                try:
+                    with open(os.path.join(dp, fn), 'r', encoding='utf-8-sig') as f:
+                        for ln in f:
+                            if re.match(r'^\s*&ИзменениеИКонтроль\(', ln):
+                                ctrl_count += 1
+                except OSError:
+                    pass
+    if ctrl_count > 0:
+        r.out('[INFO]  Контролируемых методов (&ИзменениеИКонтроль): %d — их актуальность здесь не проверяется. Сверьте: /cfe-patch-method -Check -ExtensionPath <ext> -ConfigPath <cf>' % ctrl_count)
+
     # --- Final output ---
     r.finalize(out_file)
     sys.exit(1 if r.errors > 0 else 0)

.claude/skills/db-create/SKILL.md

@@ -1,78 +1,72 @@
----
+---
-name: db-create
+name: db-create
-description: Создание информационной базы 1С. Используй когда нужно создать базу, новую ИБ, пустую базу
+description: Создание информационной базы 1С. Используй когда нужно создать базу, новую ИБ, пустую базу
-argument-hint: <path|name>
+argument-hint: <path|name>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Write
+  - Write
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-create — Создание информационной базы
+# /db-create — Создание информационной базы
-
+
-Создаёт новую информационную базу 1С (файловую или серверную) и предлагает зарегистрировать в `.v8-project.json`.
+Создаёт новую информационную базу 1С (файловую или серверную) и предлагает зарегистрировать в `.v8-project.json`.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-create <path>                   — файловая база по указанному пути
+/db-create <path>                   — файловая база по указанному пути
-/db-create <server>/<name>          — серверная база
+/db-create <server>/<name>          — серверная база
-/db-create                          — интерактивно
+/db-create                          — интерактивно
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта для `v8path` (путь к платформе).
+Прочитай `.v8-project.json` из корня проекта для `v8path` (путь к платформе).
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-После создания базы предложи зарегистрировать через `/db-list add`.
+После создания базы предложи зарегистрировать через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Путь к файловой базе |
+| `-InfoBasePath <путь>` | * | Путь к файловой базе |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UseTemplate <файл>` | нет | Создать из шаблона (.cf или .dt) |
+| `-UseTemplate <файл>` | нет | Создать из шаблона (.cf или .dt) |
-| `-AddToList` | нет | Добавить в список баз 1С |
+| `-AddToList` | нет | Добавить в список баз 1С |
-| `-ListName <имя>` | нет | Имя базы в списке |
+| `-ListName <имя>` | нет | Имя базы в списке |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Коды возврата
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Код | Описание |
+## После создания
-|-----|----------|
+
-| 0 | Успешно |
+Предложи зарегистрировать базу в `.v8-project.json` (через `/db-list add`)
-| 1 | Ошибка (см. лог) |
+3. Если указан шаблон `/UseTemplate` — предупреди что конфигурация будет загружена из шаблона
-
+
-## После создания
+## Примеры
-
+
-1. Прочитай лог-файл и покажи результат
+```powershell
-2. Предложи зарегистрировать базу в `.v8-project.json` (через `/db-list add`)
+# Создать файловую базу
-3. Если указан шаблон `/UseTemplate` — предупреди что конфигурация будет загружена из шаблона
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB"
-
+
-## Примеры
+# Создать серверную базу
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
-```powershell
+
-# Создать файловую базу
+# Создать из шаблона CF
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf"
-
+
-# Создать серверную базу
+# Создать и добавить в список баз
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
-
+```
-# Создать из шаблона CF
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf"
-
-# Создать и добавить в список баз
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
-```

.claude/skills/db-create/scripts/db-create.ps1

@@ -1,163 +1,476 @@
-# db-create v1.0 — Create 1C information base
+# db-create v1.10 — Create 1C information base
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Создание информационной базы 1С
+.SYNOPSIS
-
+    Создание информационной базы 1С
-.DESCRIPTION
+
-    Создаёт новую информационную базу 1С (файловую или серверную).
+.DESCRIPTION
-    Поддерживает создание из шаблона и добавление в список баз.
+    Создаёт новую информационную базу 1С (файловую или серверную).
-
+    Поддерживает создание из шаблона и добавление в список баз.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UseTemplate
+
-    Путь к файлу шаблона (.cf или .dt)
+.PARAMETER UseTemplate
-
+    Путь к файлу шаблона (.cf или .dt)
-.PARAMETER AddToList
+
-    Добавить в список баз 1С
+.PARAMETER AddToList
-
+    Добавить в список баз 1С
-.PARAMETER ListName
+
-    Имя базы в списке
+.PARAMETER ListName
-
+    Имя базы в списке
-.EXAMPLE
+
-    .\db-create.ps1 -InfoBasePath "C:\Bases\NewDB"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-create.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
+.PARAMETER AdditionalIbcmdArguments
-
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-.EXAMPLE
+
-    .\db-create.ps1 -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf" -AddToList -ListName "Новая база"
+.EXAMPLE
-#>
+    .\db-create.ps1 -InfoBasePath "C:\Bases\NewDB"
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-create.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-create.ps1 -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf" -AddToList -ListName "Новая база"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UseTemplate,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AddToList,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$false)]
+
-    [string]$ListName
+    [Parameter(Mandatory=$false)]
-)
+    [string]$UseTemplate,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [switch]$AddToList,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [string]$ListName,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+# --- Additional platform arguments ---
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+$script:V8OwnedKeys = @(
-    exit 1
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-}
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-# --- Validate connection ---
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-    exit 1
+)
-}
+$script:IbcmdOwnedKeys = @(
-
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-# --- Validate template ---
+    '--import', '--export', '--apply', '--force', '--create-database',
-if ($UseTemplate -and -not (Test-Path $UseTemplate)) {
+    '--user', '--password'
-    Write-Host "Error: template file not found: $UseTemplate" -ForegroundColor Red
+)
-    exit 1
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-}
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-
+
-# --- Temp dir ---
+function Test-ArgKeyMatch {
-$tempDir = Join-Path $env:TEMP "db_create_$(Get-Random)"
+    # A token matches a key when it equals the key, or starts with it and the next
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    # character is not a letter — catches glued /N"user" and --password=x, while
-
+    # keeping /ClearCache distinct from /C.
-try {
+    param([string]$Token, [string]$Key)
-    # --- Build arguments ---
+    if ($Token.Length -lt $Key.Length) { return $false }
-    $arguments = @("CREATEINFOBASE")
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-
+    if ($Token.Length -eq $Key.Length) { return $true }
-    if ($InfoBaseServer -and $InfoBaseRef) {
+    return -not [char]::IsLetter($Token[$Key.Length])
-        $arguments += "Srvr=`"$InfoBaseServer`";Ref=`"$InfoBaseRef`""
+}
-    } else {
+
-        $arguments += "File=`"$InfoBasePath`""
+function Get-ProjectExtraArgs {
-    }
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-
+    param([string]$Name)
-    # --- Template ---
+    $dir = (Get-Location).Path
-    if ($UseTemplate) {
+    while ($dir) {
-        $arguments += "/UseTemplate", "`"$UseTemplate`""
+        $pf = Join-Path $dir ".v8-project.json"
-    }
+        if (Test-Path $pf) {
-
+            try {
-    # --- Add to list ---
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-    if ($AddToList) {
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-        if ($ListName) {
+            } catch {}
-            $arguments += "/AddToList", "`"$ListName`""
+            return @()
-        } else {
+        }
-            $arguments += "/AddToList"
+        $parent = Split-Path $dir -Parent
-        }
+        if (-not $parent -or $parent -eq $dir) { break }
-    }
+        $dir = $parent
-
+    }
-    # --- Output ---
+    return @()
-    $outFile = Join-Path $tempDir "create_log.txt"
+}
-    $arguments += "/Out", "`"$outFile`""
+
-    $arguments += "/DisableStartupDialogs"
+function Assert-ExtraArgs {
-
+    # The platform accepts only one batch operation, and a duplicate connection or
-    # --- Execute ---
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    $exitCode = $process.ExitCode
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-
+    foreach ($tok in $ExtraArgs) {
-    # --- Result ---
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-    if ($exitCode -eq 0) {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-        if ($InfoBaseServer -and $InfoBaseRef) {
+            exit 1
-            Write-Host "Information base created successfully: $InfoBaseServer/$InfoBaseRef" -ForegroundColor Green
+        }
-        } else {
+        foreach ($k in $owned) {
-            Write-Host "Information base created successfully: $InfoBasePath" -ForegroundColor Green
+            if (Test-ArgKeyMatch $tok $k) {
-        }
+                $hint = ''
-    } else {
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-        Write-Host "Error creating information base (code: $exitCode)" -ForegroundColor Red
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-    }
+                exit 1
-
+            }
-    if (Test-Path $outFile) {
+        }
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+    }
-        if ($logContent) {
+}
-            Write-Host "--- Log ---"
+
-            Write-Host $logContent
+function Resolve-ExtraArgs {
-            Write-Host "--- End ---"
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
-        }
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
-    }
+    # simply do not apply — a project may describe both engines.
-
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
-    exit $exitCode
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
-
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
-} finally {
+    # single token. So accept the repo's list convention (comma-separated) and split here;
-    if (Test-Path $tempDir) {
+    # a native array call keeps working. A value containing a comma is not supported.
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    }
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-}
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$UseTemplate = ConvertTo-CleanPath $UseTemplate '-UseTemplate'
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-FileIbCreated {
+    # File-infobase postcondition: the platform must have produced a non-empty 1Cv8.1CD.
+    # Exit code 0 without it (broken/headless env) is a false success — reject it.
+    param([string]$IbPath)
+    $f = Join-Path $IbPath "1Cv8.1CD"
+    return (Test-Path $f) -and ((Get-Item $f -ErrorAction SilentlyContinue).Length -gt 0)
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/UseTemplate' = '-UseTemplate'; '/AddToList' = '-AddToList'; '--db-path' = '-InfoBasePath'; '--load' = '-UseTemplate'; '--restore' = '-UseTemplate' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate template ---
+if ($UseTemplate -and -not (Test-Path $UseTemplate)) {
+    Write-Host "Error: template file not found: $UseTemplate" -ForegroundColor Red
+    exit 1
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_create_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        $arguments = @("infobase", "create", "--db-path=$InfoBasePath", "--create-database")
+        if ($UseTemplate) {
+            if ([System.IO.Path]::GetExtension($UseTemplate) -ieq ".dt") {
+                $arguments += "--restore=$UseTemplate"
+            } else {
+                $arguments += "--load=$UseTemplate", "--apply"
+            }
+        }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $((Format-ArgsForDisplay $arguments $engine) -join ' ')"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $ibMissing = ($exitCode -eq 0) -and -not (Test-FileIbCreated $InfoBasePath)
+        if ($ibMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "Information base created successfully: $InfoBasePath" -ForegroundColor Green
+        } elseif ($ibMissing) {
+            Write-Host "Error: exit code 0 but 1Cv8.1CD is missing or empty at $InfoBasePath — information base was not created" -ForegroundColor Red
+        } else {
+            Write-Host "Error creating information base (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("CREATEINFOBASE")
+
+    # Quotes go INSIDE the token (File="path"): 1C's own parser wants them there, quoting
+    # the whole token instead breaks a path with spaces. Hence -PreQuoted on the launch.
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "Srvr=`"$InfoBaseServer`";Ref=`"$InfoBaseRef`""
+    } else {
+        $arguments += "File=`"$InfoBasePath`""
+    }
+
+    # --- Template ---
+    if ($UseTemplate) {
+        $arguments += "/UseTemplate", "`"$UseTemplate`""
+    }
+
+    # --- Add to list ---
+    if ($AddToList) {
+        if ($ListName) {
+            $arguments += "/AddToList", "`"$ListName`""
+        } else {
+            $arguments += "/AddToList"
+        }
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "create_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $((Format-ArgsForDisplay $arguments $engine) -join ' ')"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition (file infobase only): exit 0 without a non-empty 1Cv8.1CD is a false success.
+    $ibMissing = ($exitCode -eq 0) -and -not ($InfoBaseServer -and $InfoBaseRef) -and -not (Test-FileIbCreated $InfoBasePath)
+    if ($ibMissing) { $exitCode = 1 }
+
+    if ($exitCode -eq 0) {
+        if ($InfoBaseServer -and $InfoBaseRef) {
+            Write-Host "Information base created successfully: $InfoBaseServer/$InfoBaseRef" -ForegroundColor Green
+        } else {
+            Write-Host "Information base created successfully: $InfoBasePath" -ForegroundColor Green
+        }
+    } elseif ($ibMissing) {
+        Write-Host "Error: exit code 0 but 1Cv8.1CD is missing or empty at $InfoBasePath — information base was not created" -ForegroundColor Red
+    } else {
+        Write-Host "Error creating information base (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-create/scripts/db-create.py

@@ -1,35 +1,340 @@
 #!/usr/bin/env python3
-# db-create v1.0 — Create 1C information base
+# db-create v1.10 — Create 1C information base
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        found = sorted(glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe"))
+    while True:
-        if found:
+        pf = os.path.join(d, ".v8-project.json")
-            return found[-1]
+        if os.path.isfile(pf):
-        else:
+            try:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                with open(pf, encoding="utf-8-sig") as f:
-            sys.exit(1)
+                    data = json.load(f)
-    elif os.path.isdir(v8path):
+                v = data.get("v8path")
-        v8path = os.path.join(v8path, "1cv8.exe")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
         sys.exit(1)
     return v8path
 
 
+def file_ib_created(ib_path):
+    """File-infobase postcondition: the platform must have produced a non-empty 1Cv8.1CD.
+    Exit code 0 without it (broken/headless env) is a false success — reject it."""
+    f = os.path.join(ib_path, "1Cv8.1CD")
+    return os.path.isfile(f) and os.path.getsize(f) > 0
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -44,12 +349,39 @@ def main():
     parser.add_argument("-UseTemplate", default="")
     parser.add_argument("-AddToList", action="store_true")
     parser.add_argument("-ListName", default="")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    args.UseTemplate = clean_path(args.UseTemplate, "-UseTemplate")
 
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/UseTemplate": "-UseTemplate",
+        "/AddToList": "-AddToList",
+        "--db-path": "-InfoBasePath",
+        "--load": "-UseTemplate",
+        "--restore": "-UseTemplate",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
 
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
@@ -58,6 +390,37 @@ def main():
         print(f"Error: template file not found: {args.UseTemplate}", file=sys.stderr)
         sys.exit(1)
 
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        arguments = ["infobase", "create", f"--db-path={args.InfoBasePath}", "--create-database"]
+        if args.UseTemplate:
+            if os.path.splitext(args.UseTemplate)[1].lower() == ".dt":
+                arguments.append(f"--restore={args.UseTemplate}")
+            else:
+                arguments.extend([f"--load={args.UseTemplate}", "--apply"])
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
+        print(f"Running: ibcmd {' '.join(format_args_for_display(arguments, engine))}")
+        result = run_ibcmd([v8path] + arguments, warn_no_user=False)
+        exit_code = result.returncode
+        ib_missing = exit_code == 0 and not file_ib_created(args.InfoBasePath)
+        if ib_missing:
+            exit_code = 1
+        if exit_code == 0:
+            print(f"Information base created successfully: {args.InfoBasePath}")
+        elif ib_missing:
+            print(
+                f"Error: exit code 0 but 1Cv8.1CD is missing or empty at {args.InfoBasePath} "
+                "— information base was not created",
+                file=sys.stderr,
+            )
+        else:
+            print(f"Error creating information base (code: {exit_code})", file=sys.stderr)
+        print_platform_output(result)
+        sys.exit(exit_code)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_create_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -66,6 +429,8 @@ def main():
         # --- Build arguments ---
         arguments = ["CREATEINFOBASE"]
 
+        # Quotes go INSIDE the token (File="path"): that is where 1C's parser expects them.
+        # Quoting the whole token instead breaks a path with spaces — on both OSes.
         if args.InfoBaseServer and args.InfoBaseRef:
             arguments.append(f'Srvr="{args.InfoBaseServer}";Ref="{args.InfoBaseRef}"')
         else:
@@ -73,35 +438,44 @@ def main():
 
         # --- Template ---
         if args.UseTemplate:
-            arguments.extend(["/UseTemplate", args.UseTemplate])
+            arguments.extend(["/UseTemplate", f'"{args.UseTemplate}"'])
 
         # --- Add to list ---
         if args.AddToList:
             if args.ListName:
-                arguments.extend(["/AddToList", args.ListName])
+                arguments.extend(["/AddToList", f'"{args.ListName}"'])
             else:
                 arguments.append("/AddToList")
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "create_log.txt")
-        arguments.extend(["/Out", out_file])
+        arguments.extend(["/Out", f'"{out_file}"'])
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {' '.join(format_args_for_display(arguments, engine))}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
+        # Postcondition (file infobase only): exit 0 without a non-empty 1Cv8.1CD is a false success.
+        is_server = bool(args.InfoBaseServer and args.InfoBaseRef)
+        ib_missing = exit_code == 0 and not is_server and not file_ib_created(args.InfoBasePath)
+        if ib_missing:
+            exit_code = 1
+
         if exit_code == 0:
-            if args.InfoBaseServer and args.InfoBaseRef:
+            if is_server:
                 print(f"Information base created successfully: {args.InfoBaseServer}/{args.InfoBaseRef}")
             else:
                 print(f"Information base created successfully: {args.InfoBasePath}")
+        elif ib_missing:
+            print(
+                f"Error: exit code 0 but 1Cv8.1CD is missing or empty at {args.InfoBasePath} "
+                "— information base was not created",
+                file=sys.stderr,
+            )
         else:
             print(f"Error creating information base (code: {exit_code})", file=sys.stderr)
 
@@ -115,6 +489,7 @@ def main():
                     print("--- End ---")
             except Exception:
                 pass
+        print_platform_output(result)
 
         sys.exit(exit_code)
 

.claude/skills/db-dump-cf/SKILL.md

@@ -1,79 +1,70 @@
----
+---
-name: db-dump-cf
+name: db-dump-cf
-description: Выгрузка конфигурации 1С в CF-файл. Используй когда нужно выгрузить конфигурацию в CF, сохранить конфигурацию, сделать бэкап CF
+description: Выгрузка конфигурации 1С в CF-файл. Используй когда нужно выгрузить конфигурацию в CF, сохранить конфигурацию, сделать бэкап CF
-argument-hint: "[database] [output.cf]"
+argument-hint: "[database] [output.cf]"
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-dump-cf — Выгрузка конфигурации в CF-файл
+# /db-dump-cf — Выгрузка конфигурации в CF-файл
-
+
-Выгружает конфигурацию информационной базы в бинарный CF-файл.
+Выгружает конфигурацию информационной базы в бинарный CF-файл.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-dump-cf [database] [output.cf]
+/db-dump-cf [database] [output.cf]
-/db-dump-cf dev config.cf
+/db-dump-cf dev config.cf
-/db-dump-cf                          — база по умолчанию, файл config.cf
+/db-dump-cf                          — база по умолчанию, файл config.cf
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-OutputFile <путь>` | да | Путь к выходному CF-файлу |
+| `-OutputFile <путь>` | да | Путь к выходному CF-файлу |
-| `-Extension <имя>` | нет | Выгрузить расширение |
+| `-Extension <имя>` | нет | Выгрузить расширение |
-| `-AllExtensions` | нет | Выгрузить все расширения |
+| `-AllExtensions` | нет | Выгрузить все расширения |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Коды возврата
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Код | Описание |
+## Примеры
-|-----|----------|
+
-| 0 | Успешно |
+```powershell
-| 1 | Ошибка (см. лог) |
+# Выгрузка конфигурации (файловая база)
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"
-## После выполнения
+
-
+# Серверная база
-Прочитай лог-файл и покажи результат. Если есть ошибки — покажи содержимое лога.
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "config.cf"
-
+
-## Примеры
+# Выгрузка расширения
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
-```powershell
+```
-# Выгрузка конфигурации (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"
-
-# Серверная база
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "config.cf"
-
-# Выгрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
-```

.claude/skills/db-dump-cf/scripts/db-dump-cf.ps1

@@ -1,166 +1,496 @@
-# db-dump-cf v1.0 — Dump 1C configuration to CF file
+# db-dump-cf v1.12 — Dump 1C configuration to CF file
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Выгрузка конфигурации 1С в CF-файл
+.SYNOPSIS
-
+    Выгрузка конфигурации 1С в CF-файл
-.DESCRIPTION
+
-    Выгружает конфигурацию информационной базы в бинарный CF-файл.
+.DESCRIPTION
-    Поддерживает выгрузку расширений.
+    Выгружает конфигурацию информационной базы в бинарный CF-файл.
-
+    Поддерживает выгрузку расширений.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER OutputFile
+
-    Путь к выходному CF-файлу
+.PARAMETER OutputFile
-
+    Путь к выходному CF-файлу
-.PARAMETER Extension
+
-    Имя расширения для выгрузки
+.PARAMETER Extension
-
+    Имя расширения для выгрузки
-.PARAMETER AllExtensions
+
-    Выгрузить все расширения
+.PARAMETER AllExtensions
-
+    Выгрузить все расширения
-.EXAMPLE
+
-    .\db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -OutputFile "config.cf"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -OutputFile "ext.cfe" -Extension "МоёРасширение"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -OutputFile "config.cf"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -OutputFile "ext.cfe" -Extension "МоёРасширение"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$OutputFile,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Extension,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Password,
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AllExtensions
+    [Parameter(Mandatory=$true)]
-)
+    [string]$OutputFile,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [string]$Extension,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [switch]$AllExtensions,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+# --- Additional platform arguments ---
-    exit 1
+$script:V8OwnedKeys = @(
-}
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-# --- Ensure output directory exists ---
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-$outDir = Split-Path $OutputFile -Parent
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-if ($outDir -and -not (Test-Path $outDir)) {
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    New-Item -ItemType Directory -Path $outDir -Force | Out-Null
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-}
+)
-
+$script:IbcmdOwnedKeys = @(
-# --- Temp dir ---
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-$tempDir = Join-Path $env:TEMP "db_dump_cf_$(Get-Random)"
+    '--import', '--export', '--apply', '--force', '--create-database',
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    '--user', '--password'
-
+)
-try {
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-    # --- Build arguments ---
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-    $arguments = @("DESIGNER")
+
-
+function Test-ArgKeyMatch {
-    if ($InfoBaseServer -and $InfoBaseRef) {
+    # A token matches a key when it equals the key, or starts with it and the next
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    # character is not a letter — catches glued /N"user" and --password=x, while
-    } else {
+    # keeping /ClearCache distinct from /C.
-        $arguments += "/F", "`"$InfoBasePath`""
+    param([string]$Token, [string]$Key)
-    }
+    if ($Token.Length -lt $Key.Length) { return $false }
-
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Token.Length -eq $Key.Length) { return $true }
-    if ($Password) { $arguments += "/P`"$Password`"" }
+    return -not [char]::IsLetter($Token[$Key.Length])
-
+}
-    $arguments += "/DumpCfg", "`"$OutputFile`""
+
-
+function Get-ProjectExtraArgs {
-    # --- Extensions ---
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-    if ($Extension) {
+    param([string]$Name)
-        $arguments += "-Extension", "`"$Extension`""
+    $dir = (Get-Location).Path
-    } elseif ($AllExtensions) {
+    while ($dir) {
-        $arguments += "-AllExtensions"
+        $pf = Join-Path $dir ".v8-project.json"
-    }
+        if (Test-Path $pf) {
-
+            try {
-    # --- Output ---
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-    $outFile = Join-Path $tempDir "dump_cf_log.txt"
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-    $arguments += "/Out", "`"$outFile`""
+            } catch {}
-    $arguments += "/DisableStartupDialogs"
+            return @()
-
+        }
-    # --- Execute ---
+        $parent = Split-Path $dir -Parent
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+        if (-not $parent -or $parent -eq $dir) { break }
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+        $dir = $parent
-    $exitCode = $process.ExitCode
+    }
-
+    return @()
-    # --- Result ---
+}
-    if ($exitCode -eq 0) {
+
-        Write-Host "Configuration dumped successfully to: $OutputFile" -ForegroundColor Green
+function Assert-ExtraArgs {
-    } else {
+    # The platform accepts only one batch operation, and a duplicate connection or
-        Write-Host "Error dumping configuration (code: $exitCode)" -ForegroundColor Red
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-    }
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    if (Test-Path $outFile) {
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+    foreach ($tok in $ExtraArgs) {
-        if ($logContent) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-            Write-Host "--- Log ---"
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-            Write-Host $logContent
+            exit 1
-            Write-Host "--- End ---"
+        }
-        }
+        foreach ($k in $owned) {
-    }
+            if (Test-ArgKeyMatch $tok $k) {
-
+                $hint = ''
-    exit $exitCode
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-} finally {
+                exit 1
-    if (Test-Path $tempDir) {
+            }
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+        }
-    }
+    }
-}
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$OutputFile = ConvertTo-CleanPath $OutputFile '-OutputFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-OutputNonEmpty {
+    # Postcondition: the platform must have produced a non-empty output file.
+    # Exit code 0 without it (broken/headless env) is a false success — reject it.
+    param([string]$Path)
+    return (Test-Path $Path -PathType Leaf) -and ((Get-Item $Path -ErrorAction SilentlyContinue).Length -gt 0)
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Ensure output directory exists ---
+$outDir = Split-Path $OutputFile -Parent
+if ($outDir -and -not (Test-Path $outDir)) {
+    New-Item -ItemType Directory -Path $outDir -Force | Out-Null
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_dump_cf_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        if ($AllExtensions) {
+            Write-Host "Error: ibcmd config save does not support -AllExtensions (use -Extension)" -ForegroundColor Red
+            exit 1
+        }
+        $arguments = @("infobase", "config", "save", "--db-path=$InfoBasePath")
+        if ($Extension) { $arguments += "--extension=$Extension" }
+        $arguments += "$OutputFile"
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+        if ($outMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "Configuration dumped successfully to: $OutputFile" -ForegroundColor Green
+        } elseif ($outMissing) {
+            Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — configuration was not dumped" -ForegroundColor Red
+        } else {
+            Write-Host "Error dumping configuration (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/DumpCfg", "`"$OutputFile`""
+
+    # --- Extensions ---
+    if ($Extension) {
+        $arguments += "-Extension", "`"$Extension`""
+    } elseif ($AllExtensions) {
+        $arguments += "-AllExtensions"
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "dump_cf_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition: exit 0 without a non-empty output file is a false success.
+    $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+    if ($outMissing) { $exitCode = 1 }
+    if ($exitCode -eq 0) {
+        Write-Host "Configuration dumped successfully to: $OutputFile" -ForegroundColor Green
+    } elseif ($outMissing) {
+        Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — configuration was not dumped" -ForegroundColor Red
+    } else {
+        Write-Host "Error dumping configuration (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-dump-cf/scripts/db-dump-cf.py

@@ -1,35 +1,358 @@
 #!/usr/bin/env python3
-# db-dump-cf v1.0 — Dump 1C configuration to CF file
+# db-dump-cf v1.12 — Dump 1C configuration to CF file
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        found = sorted(glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe"))
+    while True:
-        if found:
+        pf = os.path.join(d, ".v8-project.json")
-            return found[-1]
+        if os.path.isfile(pf):
-        else:
+            try:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                with open(pf, encoding="utf-8-sig") as f:
-            sys.exit(1)
+                    data = json.load(f)
-    elif os.path.isdir(v8path):
+                v = data.get("v8path")
-        v8path = os.path.join(v8path, "1cv8.exe")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
         sys.exit(1)
     return v8path
 
 
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
+        sys.exit(1)
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def output_nonempty(path):
+    """Postcondition: the platform must have produced a non-empty output file.
+    Exit code 0 without it (broken/headless env) is a false success — reject it."""
+    return os.path.isfile(path) and os.path.getsize(path) > 0
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -46,12 +369,40 @@ def main():
     parser.add_argument("-OutputFile", required=True)
     parser.add_argument("-Extension", default="")
     parser.add_argument("-AllExtensions", action="store_true")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.OutputFile = clean_path(args.OutputFile, "-OutputFile")
 
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
 
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
@@ -60,6 +411,37 @@ def main():
     if out_dir and not os.path.isdir(out_dir):
         os.makedirs(out_dir, exist_ok=True)
 
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        if args.AllExtensions:
+            print("Error: ibcmd config save does not support -AllExtensions (use -Extension)", file=sys.stderr)
+            sys.exit(1)
+        arguments = ["infobase", "config", "save", f"--db-path={args.InfoBasePath}"]
+        if args.Extension:
+            arguments.append(f"--extension={args.Extension}")
+        arguments.append(args.OutputFile)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        exit_code = result.returncode
+        out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+        if out_missing:
+            exit_code = 1
+        if exit_code == 0:
+            print(f"Configuration dumped successfully to: {args.OutputFile}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — configuration was not dumped", file=sys.stderr)
+        else:
+            print(f"Error dumping configuration (code: {exit_code})", file=sys.stderr)
+        sys.exit(exit_code)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_dump_cf_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -69,40 +451,43 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments.extend(["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"])
+            arguments.extend(["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"'])
         else:
-            arguments.extend(["/F", args.InfoBasePath])
+            arguments.extend(["/F", f'"{args.InfoBasePath}"'])
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments.extend(["/DumpCfg", args.OutputFile])
+        arguments.extend(["/DumpCfg", f'"{args.OutputFile}"'])
 
         # --- Extensions ---
         if args.Extension:
-            arguments.extend(["-Extension", args.Extension])
+            arguments.extend(["-Extension", f'"{args.Extension}"'])
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "dump_cf_log.txt")
-        arguments.extend(["/Out", out_file])
+        arguments.extend(["/Out", f'"{out_file}"'])
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
+        # Postcondition: exit 0 without a non-empty output file is a false success.
+        out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+        if out_missing:
+            exit_code = 1
         if exit_code == 0:
             print(f"Configuration dumped successfully to: {args.OutputFile}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — configuration was not dumped", file=sys.stderr)
         else:
             print(f"Error dumping configuration (code: {exit_code})", file=sys.stderr)
 
@@ -117,6 +502,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/db-dump-dt/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: db-dump-dt
+description: Выгрузка информационной базы 1С в DT-файл (вся база — конфигурация + данные). Используй когда нужно выгрузить информационную базу, выгрузить архив базы, сделать бэкап, выгрузить dt
+argument-hint: "[database] [output.dt]"
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+  - AskUserQuestion
+---
+
+# /db-dump-dt — Выгрузка информационной базы в DT-файл
+
+Выгружает информационную базу целиком (конфигурация **+ данные**) в DT-файл — полный снимок ИБ.
+
+> В отличие от `/db-dump-cf` (только конфигурация), `.dt` содержит **всю базу**: данные,
+> настройки, пользователей. Это бэкап/точка отката, а не выгрузка метаданных.
+
+## Usage
+
+```
+/db-dump-dt [database] [output.dt]
+/db-dump-dt dev backup.dt
+/db-dump-dt                          — база по умолчанию, имя файла по базе и дате
+```
+
+## Параметры подключения
+
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если ветка не совпала — используй `default`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
+Если файла нет — предложи `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" <параметры>
+```
+
+### Параметры скрипта
+
+| Параметр | Обязательный | Описание |
+|----------|:------------:|----------|
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
+| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-UserName <имя>` | нет | Имя пользователя |
+| `-Password <пароль>` | нет | Пароль |
+| `-OutputFile <путь>` | да | Путь к выходному DT-файлу |
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
+
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+
+## Примеры
+
+```powershell
+# Выгрузка ИБ (файловая база)
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\base.dt"
+
+# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "base.dt"
+```
+
+## Связанные навыки
+
+- `/db-load-dt` — загрузка ИБ из DT (обратная операция)
+- `/db-dump-cf` — выгрузка только конфигурации (без данных)
+- `/db-create` — создать новую базу (в т.ч. из DT-шаблона)

.claude/skills/db-dump-dt/scripts/db-dump-dt.ps1

@@ -0,0 +1,470 @@
+# db-dump-dt v1.11 — Dump 1C information base to DT file
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
+<#
+.SYNOPSIS
+    Выгрузка информационной базы 1С в DT-файл
+
+.DESCRIPTION
+    Выгружает информационную базу целиком (конфигурация + данные) в DT-файл.
+
+.PARAMETER V8Path
+    Путь к каталогу bin платформы или к 1cv8.exe
+
+.PARAMETER InfoBasePath
+    Путь к файловой информационной базе
+
+.PARAMETER InfoBaseServer
+    Сервер 1С (для серверной базы)
+
+.PARAMETER InfoBaseRef
+    Имя базы на сервере
+
+.PARAMETER UserName
+    Имя пользователя 1С
+
+.PARAMETER Password
+    Пароль пользователя
+
+.PARAMETER OutputFile
+    Путь к выходному DT-файлу
+
+.PARAMETER AdditionalV8Arguments
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
+
+.PARAMETER AdditionalIbcmdArguments
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
+
+.EXAMPLE
+    .\db-dump-dt.ps1 -InfoBasePath "C:\Bases\MyDB" -OutputFile "backup.dt"
+#>
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory=$false)]
+    [string]$V8Path,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBasePath,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBaseServer,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBaseRef,
+
+    [Parameter(Mandatory=$false)]
+    [string]$UserName,
+
+    [Parameter(Mandatory=$false)]
+    [string]$Password,
+
+    [Parameter(Mandatory=$true)]
+    [string]$OutputFile,
+
+    [Parameter(Mandatory=$false)]
+    [string[]]$AdditionalV8Arguments = @(),
+
+    [Parameter(Mandatory=$false)]
+    [string[]]$AdditionalIbcmdArguments = @()
+)
+
+$OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+function Protect-Secrets {
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
+    param([string]$Text, [string[]]$Secrets)
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
+    return $Text
+}
+
+# --- Additional platform arguments ---
+$script:V8OwnedKeys = @(
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
+)
+$script:IbcmdOwnedKeys = @(
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
+    '--import', '--export', '--apply', '--force', '--create-database',
+    '--user', '--password'
+)
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
+
+function Test-ArgKeyMatch {
+    # A token matches a key when it equals the key, or starts with it and the next
+    # character is not a letter — catches glued /N"user" and --password=x, while
+    # keeping /ClearCache distinct from /C.
+    param([string]$Token, [string]$Key)
+    if ($Token.Length -lt $Key.Length) { return $false }
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
+    if ($Token.Length -eq $Key.Length) { return $true }
+    return -not [char]::IsLetter($Token[$Key.Length])
+}
+
+function Get-ProjectExtraArgs {
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
+    param([string]$Name)
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
+            } catch {}
+            return @()
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return @()
+}
+
+function Assert-ExtraArgs {
+    # The platform accepts only one batch operation, and a duplicate connection or
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
+    foreach ($tok in $ExtraArgs) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$OutputFile = ConvertTo-CleanPath $OutputFile '-OutputFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-OutputNonEmpty {
+    # Postcondition: the platform must have produced a non-empty output file.
+    # Exit code 0 without it (broken/headless env) is a false success — reject it.
+    param([string]$Path)
+    return (Test-Path $Path -PathType Leaf) -and ((Get-Item $Path -ErrorAction SilentlyContinue).Length -gt 0)
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Ensure output directory exists ---
+$outDir = Split-Path $OutputFile -Parent
+if ($outDir -and -not (Test-Path $outDir)) {
+    New-Item -ItemType Directory -Path $outDir -Force | Out-Null
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_dump_dt_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        $arguments = @("infobase", "dump", "--db-path=$InfoBasePath")
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "$OutputFile"
+
+        $arguments += "--data=$tempDir"
+
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+        if ($outMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "Information base dumped successfully to: $OutputFile" -ForegroundColor Green
+        } elseif ($outMissing) {
+            Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — information base was not dumped" -ForegroundColor Red
+        } else {
+            Write-Host "Error dumping information base (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/DumpIB", "`"$OutputFile`""
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "dump_dt_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition: exit 0 without a non-empty output file is a false success.
+    $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+    if ($outMissing) { $exitCode = 1 }
+    if ($exitCode -eq 0) {
+        Write-Host "Information base dumped successfully to: $OutputFile" -ForegroundColor Green
+    } elseif ($outMissing) {
+        Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — information base was not dumped" -ForegroundColor Red
+    } else {
+        Write-Host "Error dumping information base (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-dump-dt/scripts/db-dump-dt.py

@@ -0,0 +1,501 @@
+#!/usr/bin/env python3
+# db-dump-dt v1.11 — Dump 1C information base to DT file
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+
+import argparse
+import atexit
+import glob
+import json
+import os
+import random
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+
+
+def _find_project_v8path():
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get("v8path")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
+
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
+    if not os.path.isfile(v8path):
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
+        sys.exit(1)
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def output_nonempty(path):
+    """Postcondition: the platform must have produced a non-empty output file.
+    Exit code 0 without it (broken/headless env) is a false success — reject it."""
+    return os.path.isfile(path) and os.path.getsize(path) > 0
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
+def main():
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+    parser = argparse.ArgumentParser(
+        description="Dump 1C information base to DT file",
+        allow_abbrev=False,
+    )
+    parser.add_argument("-V8Path", default="")
+    parser.add_argument("-InfoBasePath", default="")
+    parser.add_argument("-InfoBaseServer", default="")
+    parser.add_argument("-InfoBaseRef", default="")
+    parser.add_argument("-UserName", default="")
+    parser.add_argument("-Password", default="")
+    parser.add_argument("-OutputFile", required=True)
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.OutputFile = clean_path(args.OutputFile, "-OutputFile")
+
+    v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
+    # --- Validate connection ---
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+        print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
+        sys.exit(1)
+
+    # --- Ensure output directory exists ---
+    out_dir = os.path.dirname(args.OutputFile)
+    if out_dir and not os.path.isdir(out_dir):
+        os.makedirs(out_dir, exist_ok=True)
+
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        arguments = ["infobase", "dump", f"--db-path={args.InfoBasePath}"]
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(args.OutputFile)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        exit_code = result.returncode
+        out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+        if out_missing:
+            exit_code = 1
+        if exit_code == 0:
+            print(f"Information base dumped successfully to: {args.OutputFile}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — information base was not dumped", file=sys.stderr)
+        else:
+            print(f"Error dumping information base (code: {exit_code})", file=sys.stderr)
+        sys.exit(exit_code)
+
+    # --- Temp dir ---
+    temp_dir = os.path.join(tempfile.gettempdir(), f"db_dump_dt_{random.randint(0, 999999)}")
+    os.makedirs(temp_dir, exist_ok=True)
+
+    try:
+        # --- Build arguments ---
+        arguments = ["DESIGNER"]
+
+        if args.InfoBaseServer and args.InfoBaseRef:
+            arguments.extend(["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"'])
+        else:
+            arguments.extend(["/F", f'"{args.InfoBasePath}"'])
+
+        if args.UserName:
+            arguments.append(f'/N"{args.UserName}"')
+        if args.Password:
+            arguments.append(f'/P"{args.Password}"')
+
+        arguments.extend(["/DumpIB", f'"{args.OutputFile}"'])
+
+        # --- Output ---
+        out_file = os.path.join(temp_dir, "dump_dt_log.txt")
+        arguments.extend(["/Out", f'"{out_file}"'])
+        arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
+
+        # --- Execute ---
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_v8(v8path, arguments)
+        exit_code = result.returncode
+
+        # --- Result ---
+        # Postcondition: exit 0 without a non-empty output file is a false success.
+        out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+        if out_missing:
+            exit_code = 1
+        if exit_code == 0:
+            print(f"Information base dumped successfully to: {args.OutputFile}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — information base was not dumped", file=sys.stderr)
+        else:
+            print(f"Error dumping information base (code: {exit_code})", file=sys.stderr)
+
+        if os.path.isfile(out_file):
+            try:
+                with open(out_file, "r", encoding="utf-8-sig") as f:
+                    log_content = f.read()
+                if log_content:
+                    print("--- Log ---")
+                    print(log_content)
+                    print("--- End ---")
+            except Exception:
+                pass
+
+        print_platform_output(result)
+        sys.exit(exit_code)
+
+    finally:
+        if os.path.isdir(temp_dir):
+            shutil.rmtree(temp_dir, ignore_errors=True)
+
+
+if __name__ == "__main__":
+    main()

.claude/skills/db-dump-xml/SKILL.md

@@ -1,97 +1,92 @@
----
+---
-name: db-dump-xml
+name: db-dump-xml
-description: Выгрузка конфигурации 1С в XML-файлы. Используй когда нужно выгрузить конфигурацию в файлы, XML, исходники, DumpConfigToFiles
+description: Выгрузка конфигурации 1С в XML-файлы. Используй когда нужно выгрузить конфигурацию в файлы, XML, исходники, DumpConfigToFiles
-argument-hint: "[database] [outputDir]"
+argument-hint: "[database] [outputDir]"
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-dump-xml — Выгрузка конфигурации в XML
+# /db-dump-xml — Выгрузка конфигурации в XML
-
+
-Выгружает конфигурацию информационной базы в XML-файлы (исходники). Поддерживает полную, инкрементальную, частичную выгрузку и обновление ConfigDumpInfo.
+Выгружает конфигурацию информационной базы в XML-файлы (исходники). Поддерживает полную, инкрементальную, частичную выгрузку и обновление ConfigDumpInfo.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-dump-xml [database] [outputDir]
+/db-dump-xml [database] [outputDir]
-/db-dump-xml dev src/config
+/db-dump-xml dev src/config
-/db-dump-xml dev src/config -Mode Full
+/db-dump-xml dev src/config -Mode Full
-/db-dump-xml dev src/config -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
+/db-dump-xml dev src/config -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-Если в записи базы указан `configSrc` — используй как каталог выгрузки по умолчанию.
+Если в записи базы указан `configSrc` — используй как каталог выгрузки по умолчанию.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-ConfigDir <путь>` | да | Каталог для выгрузки |
+| `-ConfigDir <путь>` | да | Каталог для выгрузки |
-| `-Mode <режим>` | нет | `Full` / `Changes` (по умолч.) / `Partial` / `UpdateInfo` |
+| `-Mode <режим>` | нет | `Full` / `Changes` (по умолч.) / `Partial` / `UpdateInfo` |
-| `-Objects <список>` | для Partial | Имена объектов через запятую |
+| `-Objects <список>` | для Partial | Имена объектов через запятую |
-| `-Extension <имя>` | нет | Выгрузить расширение |
+| `-Extension <имя>` | нет | Выгрузить расширение |
-| `-AllExtensions` | нет | Выгрузить все расширения |
+| `-AllExtensions` | нет | Выгрузить все расширения |
-| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
+| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-### Режимы выгрузки
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Режим | Описание |
+### Режимы выгрузки
-|-------|----------|
+
-| `Full` | Полная выгрузка — все объекты конфигурации |
+| Режим | Описание |
-| `Changes` | Инкрементальная — только изменённые с последней выгрузки (использует ConfigDumpInfo.xml) |
+|-------|----------|
-| `Partial` | Частичная — выбранные объекты из параметра `-Objects` |
+| `Full` | Полная выгрузка — все объекты конфигурации |
-| `UpdateInfo` | Обновить только ConfigDumpInfo.xml без выгрузки файлов |
+| `Changes` | Инкрементальная — только изменённые с последней выгрузки (использует ConfigDumpInfo.xml) |
-
+| `Partial` | Частичная — выбранные объекты из параметра `-Objects` |
-## Коды возврата
+| `UpdateInfo` | Обновить только ConfigDumpInfo.xml без выгрузки файлов |
-
+
-| Код | Описание |
+> Если пользователь просит выгрузить конкретные объекты — используй `-Mode Partial` с `-Objects`.
-|-----|----------|
+
-| 0 | Успешно |
+## Примеры
-| 1 | Ошибка (см. лог) |
+
-
+```powershell
-> Если пользователь просит выгрузить конкретные объекты — используй `-Mode Partial` с `-Objects`.
+# Полная выгрузка (файловая база)
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
-## Примеры
+
-
+# Инкрементальная выгрузка
-```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
-# Полная выгрузка (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
+# Частичная выгрузка
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
-# Инкрементальная выгрузка
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
+# Серверная база
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
-# Частичная выгрузка
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
+# Выгрузка расширения
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
-# Серверная база
+```
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
-
-# Выгрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
-```

.claude/skills/db-dump-xml/scripts/db-dump-xml.ps1

@@ -1,224 +1,566 @@
-# db-dump-xml v1.0 — Dump 1C configuration to XML files
+# db-dump-xml v1.14 — Dump 1C configuration to XML files
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Выгрузка конфигурации 1С в XML-файлы
+.SYNOPSIS
-
+    Выгрузка конфигурации 1С в XML-файлы
-.DESCRIPTION
+
-    Выполняет выгрузку конфигурации 1С в файлы в четырёх режимах:
+.DESCRIPTION
-    - Full: полная выгрузка всей конфигурации
+    Выполняет выгрузку конфигурации 1С в файлы в четырёх режимах:
-    - Changes: инкрементальная выгрузка изменённых объектов
+    - Full: полная выгрузка всей конфигурации
-    - Partial: выгрузка конкретных объектов из списка
+    - Changes: инкрементальная выгрузка изменённых объектов
-    - UpdateInfo: обновление только ConfigDumpInfo.xml
+    - Partial: выгрузка конкретных объектов из списка
-
+    - UpdateInfo: обновление только ConfigDumpInfo.xml
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER ConfigDir
+
-    Каталог для выгрузки конфигурации
+.PARAMETER ConfigDir
-
+    Каталог для выгрузки конфигурации
-.PARAMETER Mode
+
-    Режим выгрузки: Full, Changes, Partial, UpdateInfo (по умолчанию Changes)
+.PARAMETER Mode
-
+    Режим выгрузки: Full, Changes, Partial, UpdateInfo (по умолчанию Changes)
-.PARAMETER Objects
+
-    Имена объектов метаданных через запятую (для режима Partial)
+.PARAMETER Objects
-
+    Имена объектов метаданных через запятую (для режима Partial)
-.PARAMETER Extension
+
-    Имя расширения для выгрузки
+.PARAMETER Extension
-
+    Имя расширения для выгрузки
-.PARAMETER AllExtensions
+
-    Выгрузить все расширения
+.PARAMETER AllExtensions
-
+    Выгрузить все расширения
-.PARAMETER Format
+
-    Формат выгрузки: Hierarchical или Plain (по умолчанию Hierarchical)
+.PARAMETER Format
-
+    Формат выгрузки: Hierarchical или Plain (по умолчанию Hierarchical)
-.EXAMPLE
+
-    .\db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Full
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Full
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$ConfigDir,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("Full", "Changes", "Partial", "UpdateInfo")]
+    [Parameter(Mandatory=$false)]
-    [string]$Mode = "Changes",
+    [string]$Password,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$true)]
-    [string]$Objects,
+    [string]$ConfigDir,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [string]$Extension,
+    [ValidateSet("Full", "Changes", "Partial", "UpdateInfo")]
-
+    [string]$Mode = "Changes",
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AllExtensions,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Objects,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("Hierarchical", "Plain")]
+    [Parameter(Mandatory=$false)]
-    [string]$Format = "Hierarchical"
+    [string]$Extension,
-)
+
-
+    [Parameter(Mandatory=$false)]
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [switch]$AllExtensions,
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
-
+    [Parameter(Mandatory=$false)]
-# --- Resolve V8Path ---
+    [ValidateSet("Hierarchical", "Plain")]
-if (-not $V8Path) {
+    [string]$Format = "Hierarchical",
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+# --- Additional platform arguments ---
-    exit 1
+$script:V8OwnedKeys = @(
-}
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-# --- Validate Partial mode ---
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-if ($Mode -eq "Partial" -and -not $Objects) {
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-    Write-Host "Error: -Objects required for Partial mode" -ForegroundColor Red
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    exit 1
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-}
+)
-
+$script:IbcmdOwnedKeys = @(
-# --- Create output dir if needed ---
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-if (-not (Test-Path $ConfigDir)) {
+    '--import', '--export', '--apply', '--force', '--create-database',
-    New-Item -ItemType Directory -Path $ConfigDir -Force | Out-Null
+    '--user', '--password'
-    Write-Host "Created output directory: $ConfigDir"
+)
-}
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-# --- Temp dir ---
+
-$tempDir = Join-Path $env:TEMP "db_dump_xml_$(Get-Random)"
+function Test-ArgKeyMatch {
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    # A token matches a key when it equals the key, or starts with it and the next
-
+    # character is not a letter — catches glued /N"user" and --password=x, while
-try {
+    # keeping /ClearCache distinct from /C.
-    # --- Build arguments ---
+    param([string]$Token, [string]$Key)
-    $arguments = @("DESIGNER")
+    if ($Token.Length -lt $Key.Length) { return $false }
-
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-    if ($InfoBaseServer -and $InfoBaseRef) {
+    if ($Token.Length -eq $Key.Length) { return $true }
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    return -not [char]::IsLetter($Token[$Key.Length])
-    } else {
+}
-        $arguments += "/F", "`"$InfoBasePath`""
+
-    }
+function Get-ProjectExtraArgs {
-
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    param([string]$Name)
-    if ($Password) { $arguments += "/P`"$Password`"" }
+    $dir = (Get-Location).Path
-
+    while ($dir) {
-    $arguments += "/DumpConfigToFiles", "`"$ConfigDir`""
+        $pf = Join-Path $dir ".v8-project.json"
-    $arguments += "-Format", $Format
+        if (Test-Path $pf) {
-
+            try {
-    switch ($Mode) {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-        "Full" {
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-            Write-Host "Executing full configuration dump..."
+            } catch {}
-        }
+            return @()
-        "Changes" {
+        }
-            Write-Host "Executing incremental configuration dump..."
+        $parent = Split-Path $dir -Parent
-            $arguments += "-update"
+        if (-not $parent -or $parent -eq $dir) { break }
-            $arguments += "-force"
+        $dir = $parent
-        }
+    }
-        "Partial" {
+    return @()
-            Write-Host "Executing partial configuration dump..."
+}
-            $objectList = $Objects -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
+
-
+function Assert-ExtraArgs {
-            $listFile = Join-Path $tempDir "dump_list.txt"
+    # The platform accepts only one batch operation, and a duplicate connection or
-            $utf8Bom = New-Object System.Text.UTF8Encoding($true)
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-            [System.IO.File]::WriteAllLines($listFile, $objectList, $utf8Bom)
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-            $arguments += "-listFile", "`"$listFile`""
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-            Write-Host "Objects to dump: $($objectList.Count)"
+    foreach ($tok in $ExtraArgs) {
-            foreach ($obj in $objectList) { Write-Host "  $obj" }
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-        }
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-        "UpdateInfo" {
+            exit 1
-            Write-Host "Updating ConfigDumpInfo.xml..."
+        }
-            $arguments += "-configDumpInfoOnly"
+        foreach ($k in $owned) {
-        }
+            if (Test-ArgKeyMatch $tok $k) {
-    }
+                $hint = ''
-
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-    # --- Extensions ---
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-    if ($Extension) {
+                exit 1
-        $arguments += "-Extension", "`"$Extension`""
+            }
-    } elseif ($AllExtensions) {
+        }
-        $arguments += "-AllExtensions"
+    }
-    }
+}
-
+
-    # --- Output ---
+function Resolve-ExtraArgs {
-    $outFile = Join-Path $tempDir "dump_log.txt"
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
-    $arguments += "/Out", "`"$outFile`""
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
-    $arguments += "/DisableStartupDialogs"
+    # simply do not apply — a project may describe both engines.
-
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
-    # --- Execute ---
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+    # single token. So accept the repo's list convention (comma-separated) and split here;
-    $exitCode = $process.ExitCode
+    # a native array call keeps working. A value containing a comma is not supported.
-
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    # --- Result ---
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    if ($exitCode -eq 0) {
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
-        Write-Host "Dump completed successfully" -ForegroundColor Green
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
-        Write-Host "Configuration dumped to: $ConfigDir"
+        exit 1
-    } else {
+    }
-        Write-Host "Error dumping configuration (code: $exitCode)" -ForegroundColor Red
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
-    }
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
-
+        exit 1
-    if (Test-Path $outFile) {
+    }
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+    if ($Engine -eq 'ibcmd') {
-        if ($logContent) {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
-            Write-Host "--- Log ---"
+    } else {
-            Write-Host $logContent
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
-            Write-Host "--- End ---"
+    }
-        }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
-    }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
-
+    # would nest the array — the tokens would then be glued into one argument.
-    exit $exitCode
+    return $extra
-
+}
-} finally {
+
-    if (Test-Path $tempDir) {
+function Format-ArgsForDisplay {
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
-    }
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
-}
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$ConfigDir = ConvertTo-CleanPath $ConfigDir '-ConfigDir'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-DirNonEmpty {
+    # Postcondition: the platform must have written files into the output directory.
+    # Exit code 0 with an empty dir (broken/headless env) is a false success — reject it.
+    param([string]$Path)
+    return (Test-Path $Path -PathType Container) -and ([bool](Get-ChildItem -LiteralPath $Path -Force -ErrorAction SilentlyContinue | Select-Object -First 1))
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate Partial mode ---
+if ($Mode -eq "Partial" -and -not $Objects) {
+    Write-Host "Error: -Objects required for Partial mode" -ForegroundColor Red
+    exit 1
+}
+
+# --- Create output dir if needed ---
+if (-not (Test-Path $ConfigDir)) {
+    New-Item -ItemType Directory -Path $ConfigDir -Force | Out-Null
+    Write-Host "Created output directory: $ConfigDir"
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_dump_xml_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only; hierarchical Full/Changes) ---
+        if ($Format -eq "Plain") {
+            Write-Host "Error: ibcmd config export supports hierarchical format only (use -Format Hierarchical or 1cv8)" -ForegroundColor Red
+            exit 1
+        }
+        if ($AllExtensions) {
+            $arguments = @("infobase", "config", "export", "all-extensions", "$ConfigDir", "--db-path=$InfoBasePath")
+        } elseif ($Mode -eq "UpdateInfo") {
+            Write-Host "Error: ibcmd config export does not support Mode UpdateInfo; use 1cv8" -ForegroundColor Red
+            exit 1
+        } elseif ($Mode -eq "Partial") {
+            $objList = @($Objects -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ })
+            $arguments = @("infobase", "config", "export", "objects") + $objList
+            $arguments += "--out=$ConfigDir", "--db-path=$InfoBasePath"
+            if ($Extension) { $arguments += "--extension=$Extension" }
+        } else {
+            $arguments = @("infobase", "config", "export", "--db-path=$InfoBasePath")
+            if ($Extension) { $arguments += "--extension=$Extension" }
+            $arguments += "$ConfigDir"
+        }
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $outMissing = ($exitCode -eq 0) -and -not (Test-DirNonEmpty $ConfigDir)
+        if ($outMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "Configuration exported successfully to: $ConfigDir" -ForegroundColor Green
+        } elseif ($outMissing) {
+            Write-Host "Error: exit code 0 but no files under $ConfigDir — configuration was not exported" -ForegroundColor Red
+        } else {
+            Write-Host "Error exporting configuration (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/DumpConfigToFiles", "`"$ConfigDir`""
+    $arguments += "-Format", $Format
+
+    switch ($Mode) {
+        "Full" {
+            Write-Host "Executing full configuration dump..."
+        }
+        "Changes" {
+            Write-Host "Executing incremental configuration dump..."
+            $arguments += "-update"
+            $arguments += "-force"
+        }
+        "Partial" {
+            Write-Host "Executing partial configuration dump..."
+            $objectList = $Objects -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
+
+            $listFile = Join-Path $tempDir "dump_list.txt"
+            $utf8Bom = New-Object System.Text.UTF8Encoding($true)
+            [System.IO.File]::WriteAllLines($listFile, $objectList, $utf8Bom)
+
+            $arguments += "-listFile", "`"$listFile`""
+            Write-Host "Objects to dump: $($objectList.Count)"
+            foreach ($obj in $objectList) { Write-Host "  $obj" }
+        }
+        "UpdateInfo" {
+            Write-Host "Updating ConfigDumpInfo.xml..."
+            $arguments += "-configDumpInfoOnly"
+        }
+    }
+
+    # --- Extensions ---
+    if ($Extension) {
+        $arguments += "-Extension", "`"$Extension`""
+    } elseif ($AllExtensions) {
+        $arguments += "-AllExtensions"
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "dump_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition: exit 0 with an empty output directory is a false success.
+    $outMissing = ($exitCode -eq 0) -and -not (Test-DirNonEmpty $ConfigDir)
+    if ($outMissing) { $exitCode = 1 }
+    if ($exitCode -eq 0) {
+        Write-Host "Dump completed successfully" -ForegroundColor Green
+        Write-Host "Configuration dumped to: $ConfigDir"
+    } elseif ($outMissing) {
+        Write-Host "Error: exit code 0 but no files under $ConfigDir — configuration was not dumped" -ForegroundColor Red
+    } else {
+        Write-Host "Error dumping configuration (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-dump-xml/scripts/db-dump-xml.py

@@ -1,35 +1,356 @@
 #!/usr/bin/env python3
-# db-dump-xml v1.0 — Dump 1C configuration to XML files
+# db-dump-xml v1.14 — Dump 1C configuration to XML files
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        candidates = glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+    while True:
-        if candidates:
+        pf = os.path.join(d, ".v8-project.json")
-            candidates.sort()
+        if os.path.isfile(pf):
-            return candidates[-1]
+            try:
-        else:
+                with open(pf, encoding="utf-8-sig") as f:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                    data = json.load(f)
-            sys.exit(1)
+                v = data.get("v8path")
-    elif os.path.isdir(v8path):
+                if v:
-        v8path = os.path.join(v8path, "1cv8.exe")
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
         sys.exit(1)
 
-    return v8path
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def dir_nonempty(path):
+    """Postcondition: the platform must have written files into the output directory.
+    Exit code 0 with an empty dir (broken/headless env) is a false success — reject it."""
+    return os.path.isdir(path) and any(os.scandir(path))
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
 
 
 def main():
@@ -61,13 +382,41 @@ def main():
         choices=["Hierarchical", "Plain"],
         help="Dump format (default: Hierarchical)",
     )
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.ConfigDir = clean_path(args.ConfigDir, "-ConfigDir")
 
     # --- Resolve V8Path ---
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
 
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
@@ -81,6 +430,49 @@ def main():
         os.makedirs(args.ConfigDir, exist_ok=True)
         print(f"Created output directory: {args.ConfigDir}")
 
+    # --- ibcmd branch (file infobase only; hierarchical Full/Changes) ---
+    if engine == "ibcmd":
+        if args.Format == "Plain":
+            print("Error: ibcmd config export supports hierarchical format only (use -Format Hierarchical or 1cv8)", file=sys.stderr)
+            sys.exit(1)
+        if args.AllExtensions:
+            arguments = ["infobase", "config", "export", "all-extensions", args.ConfigDir, f"--db-path={args.InfoBasePath}"]
+        elif args.Mode == "UpdateInfo":
+            print("Error: ibcmd config export does not support Mode UpdateInfo; use 1cv8", file=sys.stderr)
+            sys.exit(1)
+        elif args.Mode == "Partial":
+            obj_list = [o.strip() for o in args.Objects.split(",") if o.strip()]
+            arguments = ["infobase", "config", "export", "objects"] + obj_list
+            arguments += [f"--out={args.ConfigDir}", f"--db-path={args.InfoBasePath}"]
+            if args.Extension:
+                arguments.append(f"--extension={args.Extension}")
+        else:
+            arguments = ["infobase", "config", "export", f"--db-path={args.InfoBasePath}"]
+            if args.Extension:
+                arguments.append(f"--extension={args.Extension}")
+            arguments.append(args.ConfigDir)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        exit_code = result.returncode
+        out_missing = exit_code == 0 and not dir_nonempty(args.ConfigDir)
+        if out_missing:
+            exit_code = 1
+        if exit_code == 0:
+            print(f"Configuration exported successfully to: {args.ConfigDir}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no files under {args.ConfigDir} — configuration was not exported", file=sys.stderr)
+        else:
+            print(f"Error exporting configuration (code: {exit_code})", file=sys.stderr)
+        sys.exit(exit_code)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_dump_xml_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -90,16 +482,16 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments += ["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"]
+            arguments += ["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"']
         else:
-            arguments += ["/F", args.InfoBasePath]
+            arguments += ["/F", f'"{args.InfoBasePath}"']
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments += ["/DumpConfigToFiles", args.ConfigDir]
+        arguments += ["/DumpConfigToFiles", f'"{args.ConfigDir}"']
         arguments += ["-Format", args.Format]
 
         if args.Mode == "Full":
@@ -116,7 +508,7 @@ def main():
             with open(list_file, "w", encoding="utf-8-sig") as f:
                 f.write("\n".join(object_list))
 
-            arguments += ["-listFile", list_file]
+            arguments += ["-listFile", f'"{list_file}"']
             print(f"Objects to dump: {len(object_list)}")
             for obj in object_list:
                 print(f"  {obj}")
@@ -126,28 +518,31 @@ def main():
 
         # --- Extensions ---
         if args.Extension:
-            arguments += ["-Extension", args.Extension]
+            arguments += ["-Extension", f'"{args.Extension}"']
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "dump_log.txt")
-        arguments += ["/Out", out_file]
+        arguments += ["/Out", f'"{out_file}"']
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
+        # Postcondition: exit 0 with an empty output directory is a false success.
+        out_missing = exit_code == 0 and not dir_nonempty(args.ConfigDir)
+        if out_missing:
+            exit_code = 1
         if exit_code == 0:
             print("Dump completed successfully")
             print(f"Configuration dumped to: {args.ConfigDir}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no files under {args.ConfigDir} — configuration was not dumped", file=sys.stderr)
         else:
             print(f"Error dumping configuration (code: {exit_code})", file=sys.stderr)
 
@@ -162,6 +557,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/db-list/SKILL.md

@@ -1,158 +1,161 @@
----
+---
-name: db-list
+name: db-list
-description: Управление реестром баз данных 1С (.v8-project.json). Используй когда нужно работать с реестром баз — список баз, зарегистрировать базу в реестре, какие базы есть
+description: Управление реестром баз данных 1С (.v8-project.json). Используй когда нужно работать с реестром баз — список баз, зарегистрировать базу в реестре, какие базы есть
-argument-hint: "[add|remove|show]"
+argument-hint: "[add|remove|show]"
-allowed-tools:
+allowed-tools:
-  - Read
+  - Read
-  - Write
+  - Write
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-list — Управление реестром баз данных
+# /db-list — Управление реестром баз данных
-
+
-Управляет файлом `.v8-project.json` — реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.
+Управляет файлом `.v8-project.json` — реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-list                    — показать список баз
+/db-list                    — показать список баз
-/db-list add                — добавить базу (интерактивно)
+/db-list add                — добавить базу (интерактивно)
-/db-list remove <id>        — удалить базу из реестра
+/db-list remove <id>        — удалить базу из реестра
-/db-list show <id|alias>    — подробности по базе
+/db-list show <id|alias>    — подробности по базе
-```
+```
-
+
-## Формат `.v8-project.json`
+## Формат `.v8-project.json`
-
+
-Файл размещается в корне проекта (рядом с `.git/`).
+Файл размещается в корне проекта (рядом с `.git/`).
-
+
-```json
+```json
-{
+{
-  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
+  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
-  "databases": [
+  "v8args": ["/UseHwLicenses+"],
-    {
+  "databases": [
-      "id": "dev",
+    {
-      "name": "Разработка",
+      "id": "dev",
-      "type": "file",
+      "name": "Разработка",
-      "path": "C:\\Bases\\MyApp_Dev",
+      "type": "file",
-      "user": "Admin",
+      "path": "C:\\Bases\\MyApp_Dev",
-      "password": "",
+      "user": "Admin",
-      "aliases": ["dev", "разработка"],
+      "password": "",
-      "branches": ["dev", "develop", "feature/*"],
+      "aliases": ["dev", "разработка"],
-      "configSrc": "C:\\WS\\myapp\\cfsrc"
+      "branches": ["dev", "develop", "feature/*"],
-    },
+      "configSrc": "C:\\WS\\myapp\\cfsrc"
-    {
+    },
-      "id": "test",
+    {
-      "name": "Тестовая",
+      "id": "test",
-      "type": "server",
+      "name": "Тестовая",
-      "server": "srv01",
+      "type": "server",
-      "ref": "MyApp_Test",
+      "server": "srv01",
-      "user": "Admin",
+      "ref": "MyApp_Test",
-      "password": "123",
+      "user": "Admin",
-      "aliases": ["test", "тест"]
+      "password": "123",
-    }
+      "aliases": ["test", "тест"]
-  ],
+    }
-  "default": "dev"
+  ],
-}
+  "default": "dev"
-```
+}
-
+```
-### Поля корневого объекта
+
-
+### Поля корневого объекта
-| Поле | Тип | Описание |
+
-|------|-----|----------|
+| Поле | Тип | Описание |
-| `v8path` | string | Каталог bin платформы 1С. Необязательный — если не задан, автоопределение |
+|------|-----|----------|
-| `databases` | array | Массив баз данных |
+| `v8path` | string | Каталог bin платформы 1С. Необязательный — если не задан, автоопределение |
-| `default` | string | id базы по умолчанию |
+| `v8args` | array | Доп. аргументы запуска `1cv8.exe` для всех навыков, напр. `["/UseHwLicenses+"]` |
-
+| `ibcmdargs` | array | Доп. аргументы `ibcmd` (форма `--ключ=значение`) |
-### Поля объекта базы данных
+| `databases` | array | Массив баз данных |
-
+| `default` | string | id базы по умолчанию |
-| Поле | Тип | Обязательное | Описание |
+
-|------|-----|:------------:|----------|
+### Поля объекта базы данных
-| `id` | string | да | Уникальный идентификатор (латиница, без пробелов) |
+
-| `name` | string | да | Человекочитаемое имя |
+| Поле | Тип | Обязательное | Описание |
-| `type` | `"file"` / `"server"` | да | Тип подключения |
+|------|-----|:------------:|----------|
-| `path` | string | для file | Путь к каталогу файловой базы |
+| `id` | string | да | Уникальный идентификатор (латиница, без пробелов) |
-| `server` | string | для server | Адрес сервера 1С |
+| `name` | string | да | Человекочитаемое имя |
-| `ref` | string | для server | Имя базы на сервере |
+| `type` | `"file"` / `"server"` | да | Тип подключения |
-| `user` | string | нет | Имя пользователя 1С |
+| `path` | string | для file | Путь к каталогу файловой базы |
-| `password` | string | нет | Пароль |
+| `server` | string | для server | Адрес сервера 1С |
-| `aliases` | string[] | нет | Альтернативные имена для быстрого доступа |
+| `ref` | string | для server | Имя базы на сервере |
-| `branches` | string[] | нет | Git-ветки или glob-паттерны (`release/*`, `feature/*`), привязанные к этой базе |
+| `user` | string | нет | Имя пользователя 1С |
-| `configSrc` | string | нет | Каталог XML-выгрузки конфигурации |
+| `password` | string | нет | Пароль |
-
+| `aliases` | string[] | нет | Альтернативные имена для быстрого доступа |
-## Алгоритм разрешения базы данных
+| `branches` | string[] | нет | Git-ветки или glob-паттерны (`release/*`, `feature/*`), привязанные к этой базе |
-
+| `configSrc` | string | нет | Каталог XML-выгрузки конфигурации |
-Этот алгоритм используется ВСЕМИ навыками (`db-*`, `epf-build`, `epf-dump`, `erf-build`, `erf-dump`) для определения целевой базы.
+
-
+## Алгоритм разрешения базы данных
-1. Если пользователь указал **параметры подключения** (путь, сервер) — используй напрямую
+
-2. Если пользователь указал **базу по имени** — ищи совпадение в таком порядке:
+Этот алгоритм используется ВСЕМИ навыками (`db-*`, `epf-build`, `epf-dump`, `erf-build`, `erf-dump`) для определения целевой базы.
-   1. По `id` (точное совпадение)
+
-   2. По `aliases` (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
+1. Если пользователь указал **параметры подключения** (путь, сервер) — используй напрямую
-   3. По `name` (нечёткое совпадение с учётом морфологии и регистра)
+2. Если пользователь указал **базу по имени** — ищи совпадение в таком порядке:
-3. Если пользователь **не указал** базу — сопоставь текущую ветку Git с `databases[].branches`:
+   1. По `id` (точное совпадение)
-   - Точное совпадение: ветка `dev` → `"branches": ["dev"]`
+   2. По `aliases` (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
-   - Glob-паттерн: ветка `release/2.1` → `"branches": ["release/*"]`
+   3. По `name` (нечёткое совпадение с учётом морфологии и регистра)
-4. Если ветка не совпала — используй `default`
+3. Если пользователь **не указал** базу — сопоставь текущую ветку Git с `databases[].branches`:
-5. Если не найдено или неоднозначно — спроси пользователя
+   - Точное совпадение: ветка `dev` → `"branches": ["dev"]`
-6. Если файл `.v8-project.json` не найден — спроси параметры подключения и предложи создать файл
+   - Glob-паттерн: ветка `release/2.1` → `"branches": ["release/*"]`
-
+4. Если ветка не совпала — используй `default`
-После выполнения: если использованная база не зарегистрирована — предложи добавить через `/db-list add`.
+5. Если не найдено или неоднозначно — спроси пользователя
-
+6. Если файл `.v8-project.json` не найден — спроси параметры подключения и предложи создать файл
-### Автоопределение платформы
+
-
+После выполнения: если использованная база не зарегистрирована — предложи добавить через `/db-list add`.
-Если `v8path` не задан в конфиге:
+
-
+### Автоопределение платформы
-```powershell
+
-$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1
+Если `v8path` не задан в конфиге:
-```
+
-
+```powershell
-## Операции
+$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1
-
+```
-### Показать список баз
+
-
+## Операции
-Прочитай `.v8-project.json`, выведи таблицу:
+
-
+### Показать список баз
-```
+
-ID      Имя           Тип      Путь/Сервер              По умолч.
+Прочитай `.v8-project.json`, выведи таблицу:
-dev     Разработка    file     C:\Bases\MyApp_Dev       ✓
+
-test    Тестовая      server   srv01/MyApp_Test
+```
-```
+ID      Имя           Тип      Путь/Сервер              По умолч.
-
+dev     Разработка    file     C:\Bases\MyApp_Dev       ✓
-### Добавить базу
+test    Тестовая      server   srv01/MyApp_Test
-
+```
-Спроси у пользователя через AskUserQuestion:
+
-- id, name, type (file/server)
+### Добавить базу
-- path (для file) или server + ref (для server)
+
-- user, password (необязательно)
+Спроси у пользователя через AskUserQuestion:
-- aliases, branches (необязательно)
+- id, name, type (file/server)
-
+- path (для file) или server + ref (для server)
-Добавь в массив `databases`. Если это первая база — установи как `default`.
+- user, password (необязательно)
-
+- aliases, branches (необязательно)
-### Удалить базу
+
-
+Добавь в массив `databases`. Если это первая база — установи как `default`.
-Удали из массива `databases` по id. Если удаляемая была `default` — спросить новый default.
+
-
+### Удалить базу
-### Подробности по базе
+
-
+Удали из массива `databases` по id. Если удаляемая была `default` — спросить новый default.
-Выведи все поля конкретной базы.
+
-
+### Подробности по базе
-## Формирование строки подключения
+
-
+Выведи все поля конкретной базы.
-Для использования в шаблонах команд других навыков:
+
-
+## Формирование строки подключения
-**Файловая база:**
+
-```
+Для использования в шаблонах команд других навыков:
-/F "<path>"
+
-```
+**Файловая база:**
-
+```
-**Серверная база:**
+/F "<path>"
-```
+```
-/S "<server>/<ref>"
+
-```
+**Серверная база:**
-
+```
-**Аутентификация** (добавляется если user задан):
+/S "<server>/<ref>"
-```
+```
-/N"<user>" /P"<password>"
+
-```
+**Аутентификация** (добавляется если user задан):
-
+```
-> **Важно**: между `/N` и именем пробела нет. Между `/P` и паролем пробела нет. Если пароль пустой — опусти `/P` целиком.
+/N"<user>" /P"<password>"
+```
+
+> **Важно**: между `/N` и именем пробела нет. Между `/P` и паролем пробела нет. Если пароль пустой — опусти `/P` целиком.

.claude/skills/db-load-cf/SKILL.md

@@ -1,81 +1,75 @@
----
+---
-name: db-load-cf
+name: db-load-cf
-description: Загрузка конфигурации 1С из CF-файла. Используй когда нужно загрузить конфигурацию из CF, восстановить из бэкапа CF
+description: Загрузка конфигурации 1С из CF-файла. Используй когда нужно загрузить конфигурацию из CF, восстановить из бэкапа CF
-argument-hint: <input.cf> [database]
+argument-hint: <input.cf> [database]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-load-cf — Загрузка конфигурации из CF-файла
+# /db-load-cf — Загрузка конфигурации из CF-файла
-
+
-Загружает конфигурацию из бинарного CF-файла в информационную базу.
+Загружает конфигурацию из бинарного CF-файла в информационную базу.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-load-cf <input.cf> [database]
+/db-load-cf <input.cf> [database]
-/db-load-cf config.cf dev
+/db-load-cf config.cf dev
-```
+```
-
+
-> **Внимание**: загрузка CF **полностью заменяет** конфигурацию в базе. Перед выполнением запроси подтверждение у пользователя.
+> **Внимание**: загрузка CF **полностью заменяет** конфигурацию в базе. Перед выполнением запроси подтверждение у пользователя.
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-InputFile <путь>` | да | Путь к CF-файлу |
+| `-InputFile <путь>` | да | Путь к CF-файлу |
-| `-Extension <имя>` | нет | Загрузить как расширение |
+| `-Extension <имя>` | нет | Загрузить как расширение |
-| `-AllExtensions` | нет | Загрузить все расширения из архива |
+| `-AllExtensions` | нет | Загрузить все расширения из архива |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Коды возврата
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Код | Описание |
+## После выполнения
-|-----|----------|
+
-| 0 | Успешно |
+**Предложи выполнить `/db-update`** — загрузка CF обновляет только «основную» конфигурацию конфигуратора, для применения к БД нужен `/UpdateDBCfg`
-| 1 | Ошибка (см. лог) |
+
-
+## Примеры
-## После выполнения
+
-
+```powershell
-1. Прочитай лог-файл и покажи результат
+# Файловая база
-2. **Предложи выполнить `/db-update`** — загрузка CF обновляет только «основную» конфигурацию конфигуратора, для применения к БД нужен `/UpdateDBCfg`
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"
-
+
-## Примеры
+# Серверная база
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "config.cf"
-```powershell
+
-# Файловая база
+# Загрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
-
+```
-# Серверная база
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "config.cf"
-
-# Загрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
-```

.claude/skills/db-load-cf/scripts/db-load-cf.ps1

@@ -1,166 +1,497 @@
-# db-load-cf v1.0 — Load 1C configuration from CF file
+# db-load-cf v1.13 — Load 1C configuration from CF file
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Загрузка конфигурации 1С из CF-файла
+.SYNOPSIS
-
+    Загрузка конфигурации 1С из CF-файла
-.DESCRIPTION
+
-    Загружает конфигурацию из бинарного CF-файла в информационную базу.
+.DESCRIPTION
-    Поддерживает загрузку расширений.
+    Загружает конфигурацию из бинарного CF-файла в информационную базу.
-
+    Поддерживает загрузку расширений.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER InputFile
+
-    Путь к CF-файлу для загрузки
+.PARAMETER InputFile
-
+    Путь к CF-файлу для загрузки
-.PARAMETER Extension
+
-    Загрузить как расширение
+.PARAMETER Extension
-
+    Загрузить как расширение
-.PARAMETER AllExtensions
+
-    Загрузить все расширения из архива
+.PARAMETER AllExtensions
-
+    Загрузить все расширения из архива
-.EXAMPLE
+
-    .\db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "config.cf"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "ext.cfe" -Extension "МоёРасширение"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "config.cf"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "ext.cfe" -Extension "МоёРасширение"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$InputFile,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Extension,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Password,
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AllExtensions
+    [Parameter(Mandatory=$true)]
-)
+    [string]$InputFile,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [string]$Extension,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [switch]$AllExtensions,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+function Get-ExitAnnotation {
-    exit 1
+    # Annotate an abnormal process exit code so a crash isn't reported as a bare number.
-}
+    # A batch DESIGNER that crashes (e.g. missing license) may leave the infobase locked or
-
+    # half-updated — surface that instead of a plain code. (Windows exception codes only;
-# --- Validate input file ---
+    # POSIX signals are handled in the .py port.)
-if (-not (Test-Path $InputFile)) {
+    param([int]$Code)
-    Write-Host "Error: input file not found: $InputFile" -ForegroundColor Red
+    $win = @{
-    exit 1
+        -1073741819 = "0xC0000005 (access violation)"
-}
+        -1073741515 = "0xC0000135 (missing DLL)"
-
+        -1073740791 = "0xC0000409 (stack overrun)"
-# --- Temp dir ---
+    }
-$tempDir = Join-Path $env:TEMP "db_load_cf_$(Get-Random)"
+    if ($win.ContainsKey($Code)) {
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+        return " — abnormal termination, exception $($win[$Code]); the infobase may be left in an inconsistent state; verify it before retrying"
-
+    }
-try {
+    return ""
-    # --- Build arguments ---
+}
-    $arguments = @("DESIGNER")
+
-
+# --- Additional platform arguments ---
-    if ($InfoBaseServer -and $InfoBaseRef) {
+$script:V8OwnedKeys = @(
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-    } else {
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-        $arguments += "/F", "`"$InfoBasePath`""
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-    }
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-    if ($Password) { $arguments += "/P`"$Password`"" }
+)
-
+$script:IbcmdOwnedKeys = @(
-    $arguments += "/LoadCfg", "`"$InputFile`""
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-
+    '--import', '--export', '--apply', '--force', '--create-database',
-    # --- Extensions ---
+    '--user', '--password'
-    if ($Extension) {
+)
-        $arguments += "-Extension", "`"$Extension`""
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-    } elseif ($AllExtensions) {
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-        $arguments += "-AllExtensions"
+
-    }
+function Test-ArgKeyMatch {
-
+    # A token matches a key when it equals the key, or starts with it and the next
-    # --- Output ---
+    # character is not a letter — catches glued /N"user" and --password=x, while
-    $outFile = Join-Path $tempDir "load_cf_log.txt"
+    # keeping /ClearCache distinct from /C.
-    $arguments += "/Out", "`"$outFile`""
+    param([string]$Token, [string]$Key)
-    $arguments += "/DisableStartupDialogs"
+    if ($Token.Length -lt $Key.Length) { return $false }
-
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-    # --- Execute ---
+    if ($Token.Length -eq $Key.Length) { return $true }
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    return -not [char]::IsLetter($Token[$Key.Length])
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+}
-    $exitCode = $process.ExitCode
+
-
+function Get-ProjectExtraArgs {
-    # --- Result ---
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-    if ($exitCode -eq 0) {
+    param([string]$Name)
-        Write-Host "Configuration loaded successfully from: $InputFile" -ForegroundColor Green
+    $dir = (Get-Location).Path
-    } else {
+    while ($dir) {
-        Write-Host "Error loading configuration (code: $exitCode)" -ForegroundColor Red
+        $pf = Join-Path $dir ".v8-project.json"
-    }
+        if (Test-Path $pf) {
-
+            try {
-    if (Test-Path $outFile) {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-        if ($logContent) {
+            } catch {}
-            Write-Host "--- Log ---"
+            return @()
-            Write-Host $logContent
+        }
-            Write-Host "--- End ---"
+        $parent = Split-Path $dir -Parent
-        }
+        if (-not $parent -or $parent -eq $dir) { break }
-    }
+        $dir = $parent
-
+    }
-    exit $exitCode
+    return @()
-
+}
-} finally {
+
-    if (Test-Path $tempDir) {
+function Assert-ExtraArgs {
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    # The platform accepts only one batch operation, and a duplicate connection or
-    }
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-}
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
+    foreach ($tok in $ExtraArgs) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$InputFile = ConvertTo-CleanPath $InputFile '-InputFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate input file ---
+if (-not (Test-Path $InputFile)) {
+    Write-Host "Error: input file not found: $InputFile" -ForegroundColor Red
+    exit 1
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_load_cf_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        if ($AllExtensions) {
+            Write-Host "Error: ibcmd config load does not support -AllExtensions (use -Extension)" -ForegroundColor Red
+            exit 1
+        }
+        $arguments = @("infobase", "config", "load", "--db-path=$InfoBasePath")
+        if ($Extension) { $arguments += "--extension=$Extension" }
+        $arguments += "$InputFile"
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        if ($exitCode -eq 0) {
+            Write-Host "Configuration loaded successfully from: $InputFile" -ForegroundColor Green
+        } else {
+            Write-Host "Error loading configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/LoadCfg", "`"$InputFile`""
+
+    # --- Extensions ---
+    if ($Extension) {
+        $arguments += "-Extension", "`"$Extension`""
+    } elseif ($AllExtensions) {
+        $arguments += "-AllExtensions"
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "load_cf_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    if ($exitCode -eq 0) {
+        Write-Host "Configuration loaded successfully from: $InputFile" -ForegroundColor Green
+    } else {
+        Write-Host "Error loading configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-load-cf/scripts/db-load-cf.py

@@ -1,35 +1,376 @@
 #!/usr/bin/env python3
-# db-load-cf v1.0 — Load 1C configuration from CF file
+# db-load-cf v1.13 — Load 1C configuration from CF file
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        found = sorted(glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe"))
+    while True:
-        if found:
+        pf = os.path.join(d, ".v8-project.json")
-            return found[-1]
+        if os.path.isfile(pf):
-        else:
+            try:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                with open(pf, encoding="utf-8-sig") as f:
-            sys.exit(1)
+                    data = json.load(f)
-    elif os.path.isdir(v8path):
+                v = data.get("v8path")
-        v8path = os.path.join(v8path, "1cv8.exe")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
         sys.exit(1)
     return v8path
 
 
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
+        sys.exit(1)
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def describe_exit(code):
+    """Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    Batch 1C in a broken/headless environment (no GUI session, no license) can crash mid-run
+    instead of returning a clean error, possibly leaving the infobase locked or half-mutated."""
+    if code is None:
+        return ""
+    win = {
+        3221225477: "0xC0000005 (access violation)", -1073741819: "0xC0000005 (access violation)",
+        3221225781: "0xC0000135 (missing DLL)", -1073741515: "0xC0000135 (missing DLL)",
+        3221226505: "0xC0000409 (stack overrun)", -1073740791: "0xC0000409 (stack overrun)",
+    }
+    if code in win:
+        return f" — abnormal termination, exception {win[code]}; the infobase may be left in an inconsistent state; verify it before retrying"
+    if -64 <= code < 0:
+        try:
+            import signal
+            name = signal.Signals(-code).name
+        except (ValueError, AttributeError):
+            name = f"signal {-code}"
+        return (f" — process terminated by {name} (abnormal termination, not a normal exit); "
+                "the infobase may be left in an inconsistent state; verify it before retrying")
+    return ""
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -46,12 +387,40 @@ def main():
     parser.add_argument("-InputFile", required=True)
     parser.add_argument("-Extension", default="")
     parser.add_argument("-AllExtensions", action="store_true")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.InputFile = clean_path(args.InputFile, "-InputFile")
 
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
 
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
@@ -60,6 +429,31 @@ def main():
         print(f"Error: input file not found: {args.InputFile}", file=sys.stderr)
         sys.exit(1)
 
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        if args.AllExtensions:
+            print("Error: ibcmd config load does not support -AllExtensions (use -Extension)", file=sys.stderr)
+            sys.exit(1)
+        arguments = ["infobase", "config", "load", f"--db-path={args.InfoBasePath}"]
+        if args.Extension:
+            arguments.append(f"--extension={args.Extension}")
+        arguments.append(args.InputFile)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        if result.returncode == 0:
+            print(f"Configuration loaded successfully from: {args.InputFile}")
+        else:
+            print(f"Error loading configuration (code: {result.returncode}){describe_exit(result.returncode)}", file=sys.stderr)
+        sys.exit(result.returncode)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_load_cf_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -69,42 +463,39 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments.extend(["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"])
+            arguments.extend(["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"'])
         else:
-            arguments.extend(["/F", args.InfoBasePath])
+            arguments.extend(["/F", f'"{args.InfoBasePath}"'])
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments.extend(["/LoadCfg", args.InputFile])
+        arguments.extend(["/LoadCfg", f'"{args.InputFile}"'])
 
         # --- Extensions ---
         if args.Extension:
-            arguments.extend(["-Extension", args.Extension])
+            arguments.extend(["-Extension", f'"{args.Extension}"'])
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "load_cf_log.txt")
-        arguments.extend(["/Out", out_file])
+        arguments.extend(["/Out", f'"{out_file}"'])
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
         if exit_code == 0:
             print(f"Configuration loaded successfully from: {args.InputFile}")
         else:
-            print(f"Error loading configuration (code: {exit_code})", file=sys.stderr)
+            print(f"Error loading configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
 
         if os.path.isfile(out_file):
             try:
@@ -117,6 +508,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/db-load-dt/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: db-load-dt
+description: Загрузка информационной базы 1С из DT-файла — полная перезапись базы (конфигурация + данные). Используй когда нужно загрузить архив информационной базы, восстановить базу, загрузить dt
+disable-model-invocation: true
+argument-hint: <input.dt> [database]
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+  - AskUserQuestion
+---
+
+# /db-load-dt — Загрузка информационной базы из DT-файла
+
+Восстанавливает информационную базу целиком (конфигурация **+ данные**) из DT-файла.
+
+> ⚠️ **Необратимая операция.** Загрузка `.dt` **полностью перезаписывает базу** — и
+> конфигурацию, и все данные. Текущее содержимое базы будет потеряно. После загрузки
+> `/db-update` **не нужен** — конфигурация БД уже синхронна внутри снимка.
+
+## Когда НЕ использовать
+
+- Нужно создать **новую** базу из `.dt` → используй `/db-create` (из DT-шаблона), а не загрузку
+  в существующую.
+- Нужно обновить только конфигурацию (без данных) → `/db-load-cf` или `/db-load-xml`.
+
+## Usage
+
+```
+/db-load-dt <input.dt> [database]
+/db-load-dt backup.dt dev
+```
+
+## Порядок действий перед загрузкой
+
+1. Предложи пользователю сначала сделать `/db-dump-dt` текущего состояния базы — это точка
+   отката (восстановиться будет нечем, если не сохранить).
+2. Запроси **явное подтверждение**: вся база (данные + конфигурация) будет перезаписана.
+3. Только после подтверждения выполняй загрузку.
+
+## Параметры подключения
+
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если ветка не совпала — используй `default`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
+Если файла нет — предложи `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" <параметры>
+```
+
+### Параметры скрипта
+
+| Параметр | Обязательный | Описание |
+|----------|:------------:|----------|
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
+| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-UserName <имя>` | нет | Имя пользователя |
+| `-Password <пароль>` | нет | Пароль |
+| `-InputFile <путь>` | да | Путь к DT-файлу |
+| `-JobsCount <N>` | нет | Число фоновых заданий загрузки (0 = по числу процессоров) |
+| `-UnlockCode <код>` | нет | Код разблокировки (`/UC`), если заблокировано начало сеансов |
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
+
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+
+## После выполнения
+
+Если база занята (активные сеансы), загрузка не выполнится — для серверной базы можно
+передать `-UnlockCode`; иначе освободи базу и повтори.
+
+## Примеры
+
+```powershell
+# Файловая база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\base.dt"
+
+# Серверная база с ускорением загрузки
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "base.dt" -JobsCount 4
+```
+
+## Связанные навыки
+
+- `/db-dump-dt` — выгрузка ИБ в DT (обратная операция, точка отката перед загрузкой)
+- `/db-create` — создать новую базу (в т.ч. из DT-шаблона)

.claude/skills/db-load-dt/scripts/db-load-dt.ps1

@@ -0,0 +1,487 @@
+# db-load-dt v1.12 — Load 1C information base from DT file
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
+<#
+.SYNOPSIS
+    Загрузка информационной базы 1С из DT-файла
+
+.DESCRIPTION
+    Загружает информационную базу целиком (конфигурация + данные) из DT-файла.
+    ВНИМАНИЕ: операция полностью перезаписывает базу.
+
+.PARAMETER V8Path
+    Путь к каталогу bin платформы или к 1cv8.exe
+
+.PARAMETER InfoBasePath
+    Путь к файловой информационной базе
+
+.PARAMETER InfoBaseServer
+    Сервер 1С (для серверной базы)
+
+.PARAMETER InfoBaseRef
+    Имя базы на сервере
+
+.PARAMETER UserName
+    Имя пользователя 1С
+
+.PARAMETER Password
+    Пароль пользователя
+
+.PARAMETER InputFile
+    Путь к DT-файлу для загрузки
+
+.PARAMETER JobsCount
+    Количество фоновых заданий для загрузки (0 = по числу процессоров)
+
+.PARAMETER UnlockCode
+    Код разблокировки базы (/UC) — если заблокировано начало сеансов
+
+.PARAMETER AdditionalV8Arguments
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
+
+.PARAMETER AdditionalIbcmdArguments
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
+
+.EXAMPLE
+    .\db-load-dt.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "backup.dt"
+#>
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory=$false)]
+    [string]$V8Path,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBasePath,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBaseServer,
+
+    [Parameter(Mandatory=$false)]
+    [string]$InfoBaseRef,
+
+    [Parameter(Mandatory=$false)]
+    [string]$UserName,
+
+    [Parameter(Mandatory=$false)]
+    [string]$Password,
+
+    [Parameter(Mandatory=$true)]
+    [string]$InputFile,
+
+    [Parameter(Mandatory=$false)]
+    [int]$JobsCount = 0,
+
+    [Parameter(Mandatory=$false)]
+    [string]$UnlockCode,
+
+    [Parameter(Mandatory=$false)]
+    [string[]]$AdditionalV8Arguments = @(),
+
+    [Parameter(Mandatory=$false)]
+    [string[]]$AdditionalIbcmdArguments = @()
+)
+
+$OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+function Protect-Secrets {
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
+    param([string]$Text, [string[]]$Secrets)
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
+    return $Text
+}
+
+function Get-ExitAnnotation {
+    # Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    # A batch DESIGNER that crashes (e.g. missing license) may leave the infobase locked or
+    # half-updated — surface that instead of a plain code. (Windows exception codes only;
+    # POSIX signals are handled in the .py port.)
+    param([int]$Code)
+    $win = @{
+        -1073741819 = "0xC0000005 (access violation)"
+        -1073741515 = "0xC0000135 (missing DLL)"
+        -1073740791 = "0xC0000409 (stack overrun)"
+    }
+    if ($win.ContainsKey($Code)) {
+        return " — abnormal termination, exception $($win[$Code]); the infobase may be left in an inconsistent state; verify it before retrying"
+    }
+    return ""
+}
+
+# --- Additional platform arguments ---
+$script:V8OwnedKeys = @(
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
+)
+$script:IbcmdOwnedKeys = @(
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
+    '--import', '--export', '--apply', '--force', '--create-database',
+    '--user', '--password'
+)
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
+
+function Test-ArgKeyMatch {
+    # A token matches a key when it equals the key, or starts with it and the next
+    # character is not a letter — catches glued /N"user" and --password=x, while
+    # keeping /ClearCache distinct from /C.
+    param([string]$Token, [string]$Key)
+    if ($Token.Length -lt $Key.Length) { return $false }
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
+    if ($Token.Length -eq $Key.Length) { return $true }
+    return -not [char]::IsLetter($Token[$Key.Length])
+}
+
+function Get-ProjectExtraArgs {
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
+    param([string]$Name)
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
+            } catch {}
+            return @()
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return @()
+}
+
+function Assert-ExtraArgs {
+    # The platform accepts only one batch operation, and a duplicate connection or
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
+    foreach ($tok in $ExtraArgs) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$InputFile = ConvertTo-CleanPath $InputFile '-InputFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate input file ---
+if (-not (Test-Path $InputFile)) {
+    Write-Host "Error: input file not found: $InputFile" -ForegroundColor Red
+    exit 1
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_load_dt_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        $arguments = @("infobase", "restore", "--db-path=$InfoBasePath")
+        if (-not (Test-Path (Join-Path $InfoBasePath "1Cv8.1CD"))) { $arguments += "--create-database" }
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "$InputFile"
+
+        $arguments += "--data=$tempDir"
+
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        if ($exitCode -eq 0) {
+            Write-Host "Information base restored successfully from: $InputFile" -ForegroundColor Green
+        } else {
+            Write-Host "Error restoring information base (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+    if ($UnlockCode) { $arguments += "/UC`"$UnlockCode`"" }
+
+    $arguments += "/RestoreIB", "`"$InputFile`""
+    if ($JobsCount -gt 0) { $arguments += "-JobsCount", "$JobsCount" }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "load_dt_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    if ($exitCode -eq 0) {
+        Write-Host "Information base restored successfully from: $InputFile" -ForegroundColor Green
+    } else {
+        Write-Host "Error restoring information base (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-load-dt/scripts/db-load-dt.py

@@ -0,0 +1,515 @@
+#!/usr/bin/env python3
+# db-load-dt v1.12 — Load 1C information base from DT file
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+
+import argparse
+import atexit
+import glob
+import json
+import os
+import random
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+
+
+def _find_project_v8path():
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get("v8path")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
+
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
+    if not os.path.isfile(v8path):
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
+        sys.exit(1)
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def describe_exit(code):
+    """Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    Batch 1C in a broken/headless environment (no GUI session, no license) can crash mid-run
+    instead of returning a clean error, possibly leaving the infobase locked or half-mutated."""
+    if code is None:
+        return ""
+    win = {
+        3221225477: "0xC0000005 (access violation)", -1073741819: "0xC0000005 (access violation)",
+        3221225781: "0xC0000135 (missing DLL)", -1073741515: "0xC0000135 (missing DLL)",
+        3221226505: "0xC0000409 (stack overrun)", -1073740791: "0xC0000409 (stack overrun)",
+    }
+    if code in win:
+        return f" — abnormal termination, exception {win[code]}; the infobase may be left in an inconsistent state; verify it before retrying"
+    if -64 <= code < 0:
+        try:
+            import signal
+            name = signal.Signals(-code).name
+        except (ValueError, AttributeError):
+            name = f"signal {-code}"
+        return (f" — process terminated by {name} (abnormal termination, not a normal exit); "
+                "the infobase may be left in an inconsistent state; verify it before retrying")
+    return ""
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
+def main():
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+    parser = argparse.ArgumentParser(
+        description="Load 1C information base from DT file",
+        allow_abbrev=False,
+    )
+    parser.add_argument("-V8Path", default="")
+    parser.add_argument("-InfoBasePath", default="")
+    parser.add_argument("-InfoBaseServer", default="")
+    parser.add_argument("-InfoBaseRef", default="")
+    parser.add_argument("-UserName", default="")
+    parser.add_argument("-Password", default="")
+    parser.add_argument("-InputFile", required=True)
+    parser.add_argument("-JobsCount", type=int, default=0)
+    parser.add_argument("-UnlockCode", default="")
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.InputFile = clean_path(args.InputFile, "-InputFile")
+
+    v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
+    # --- Validate connection ---
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+        print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
+        sys.exit(1)
+
+    # --- Validate input file ---
+    if not os.path.isfile(args.InputFile):
+        print(f"Error: input file not found: {args.InputFile}", file=sys.stderr)
+        sys.exit(1)
+
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        arguments = ["infobase", "restore", f"--db-path={args.InfoBasePath}"]
+        if not os.path.isfile(os.path.join(args.InfoBasePath, "1Cv8.1CD")):
+            arguments.append("--create-database")
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(args.InputFile)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        if result.returncode == 0:
+            print(f"Information base restored successfully from: {args.InputFile}")
+        else:
+            print(f"Error restoring information base (code: {result.returncode}){describe_exit(result.returncode)}", file=sys.stderr)
+        sys.exit(result.returncode)
+
+    # --- Temp dir ---
+    temp_dir = os.path.join(tempfile.gettempdir(), f"db_load_dt_{random.randint(0, 999999)}")
+    os.makedirs(temp_dir, exist_ok=True)
+
+    try:
+        # --- Build arguments ---
+        arguments = ["DESIGNER"]
+
+        if args.InfoBaseServer and args.InfoBaseRef:
+            arguments.extend(["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"'])
+        else:
+            arguments.extend(["/F", f'"{args.InfoBasePath}"'])
+
+        if args.UserName:
+            arguments.append(f'/N"{args.UserName}"')
+        if args.Password:
+            arguments.append(f'/P"{args.Password}"')
+        if args.UnlockCode:
+            arguments.append(f'/UC"{args.UnlockCode}"')
+
+        arguments.extend(["/RestoreIB", f'"{args.InputFile}"'])
+        if args.JobsCount > 0:
+            arguments.extend(["-JobsCount", str(args.JobsCount)])
+
+        # --- Output ---
+        out_file = os.path.join(temp_dir, "load_dt_log.txt")
+        arguments.extend(["/Out", f'"{out_file}"'])
+        arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
+
+        # --- Execute ---
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_v8(v8path, arguments)
+        exit_code = result.returncode
+
+        # --- Result ---
+        if exit_code == 0:
+            print(f"Information base restored successfully from: {args.InputFile}")
+        else:
+            print(f"Error restoring information base (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
+
+        if os.path.isfile(out_file):
+            try:
+                with open(out_file, "r", encoding="utf-8-sig") as f:
+                    log_content = f.read()
+                if log_content:
+                    print("--- Log ---")
+                    print(log_content)
+                    print("--- End ---")
+            except Exception:
+                pass
+
+        print_platform_output(result)
+        sys.exit(exit_code)
+
+    finally:
+        if os.path.isdir(temp_dir):
+            shutil.rmtree(temp_dir, ignore_errors=True)
+
+
+if __name__ == "__main__":
+    main()

.claude/skills/db-load-git/SKILL.md

@@ -1,78 +1,79 @@
----
+---
-name: db-load-git
+name: db-load-git
-description: Загрузка изменений из Git в базу 1С. Используй когда нужно загрузить изменения из гита, обновить базу из репозитория, partial load из коммита
+description: Загрузка изменений из Git в базу 1С. Используй когда нужно загрузить изменения из гита, обновить базу из репозитория, partial load из коммита
-argument-hint: "[database] [source]"
+argument-hint: "[database] [source]"
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-load-git — Загрузка изменений из Git
+# /db-load-git — Загрузка изменений из Git
-
+
-Определяет изменённые файлы конфигурации по данным Git и выполняет частичную загрузку в информационную базу.
+Определяет изменённые файлы конфигурации по данным Git и выполняет частичную загрузку в информационную базу.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-load-git [database]
+/db-load-git [database]
-/db-load-git dev                              — все незафиксированные изменения
+/db-load-git dev                              — все незафиксированные изменения
-/db-load-git dev -Source Staged               — только staged
+/db-load-git dev -Source Staged               — только staged
-/db-load-git dev -Source Commit -CommitRange "HEAD~3..HEAD"
+/db-load-git dev -Source Commit -CommitRange "HEAD~3..HEAD"
-/db-load-git dev -DryRun                      — только показать что будет загружено
+/db-load-git dev -DryRun                      — только показать что будет загружено
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-Если в записи базы указан `configSrc` — используй как каталог конфигурации.
+Если в записи базы указан `configSrc` — используй как каталог конфигурации.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-ConfigDir <путь>` | да | Каталог XML-выгрузки (git-репозиторий) |
+| `-ConfigDir <путь>` | да | Каталог XML-выгрузки (git-репозиторий) |
-| `-Source <источник>` | нет | `All` (по умолч.) / `Staged` / `Unstaged` / `Commit` |
+| `-Source <источник>` | нет | `All` (по умолч.) / `Staged` / `Unstaged` / `Commit` |
-| `-CommitRange <range>` | для Commit | Диапазон коммитов (напр. `HEAD~3..HEAD`) |
+| `-CommitRange <range>` | для Commit | Диапазон коммитов (напр. `HEAD~3..HEAD`) |
-| `-Extension <имя>` | нет | Загрузить в расширение |
+| `-Extension <имя>` | нет | Загрузить в расширение |
-| `-AllExtensions` | нет | Загрузить все расширения |
+| `-AllExtensions` | нет | Загрузить все расширения |
-| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
+| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
-| `-DryRun` | нет | Только показать что будет загружено (без загрузки) |
+| `-DryRun` | нет | Только показать что будет загружено (без загрузки) |
-| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
+| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## После выполнения
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-1. Показать список загруженных файлов и результат из лога
+## После выполнения
-2. Если `-UpdateDB` не был указан — **предложить `/db-update`** для применения изменений к БД
+
-
+Если `-UpdateDB` не был указан — **предложить `/db-update`** для применения изменений к БД
-## Примеры
+
-
+## Примеры
-```powershell
+
-# Все незафиксированные изменения
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source All -UpdateDB
+# Все незафиксированные изменения
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source All -UpdateDB
-# Из диапазона коммитов
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"
+# Из диапазона коммитов
-```
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"
+```

.claude/skills/db-load-git/scripts/db-load-git.py

@@ -1,9 +1,11 @@
 #!/usr/bin/env python3
-# db-load-git v1.3 — Load Git changes into 1C database
+# db-load-git v1.18 — Load Git changes into 1C database
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
 import re
@@ -13,24 +15,327 @@ import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        candidates = glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+    while True:
-        if candidates:
+        pf = os.path.join(d, ".v8-project.json")
-            candidates.sort()
+        if os.path.isfile(pf):
-            return candidates[-1]
+            try:
-        else:
+                with open(pf, encoding="utf-8-sig") as f:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                    data = json.load(f)
-            sys.exit(1)
+                v = data.get("v8path")
-    elif os.path.isdir(v8path):
+                if v:
-        v8path = os.path.join(v8path, "1cv8.exe")
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
         sys.exit(1)
 
-    return v8path
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
 
 
 def get_object_xml_from_subfile(relative_path):
@@ -44,7 +349,7 @@ def get_object_xml_from_subfile(relative_path):
 def run_git(config_dir, git_args):
     """Run a git command in config_dir and return output lines on success."""
     result = subprocess.run(
-        ["git"] + git_args,
+        ["git", "-c", "core.quotePath=false"] + git_args,
         capture_output=True,
         text=True,
         encoding="utf-8",
@@ -55,6 +360,39 @@ def run_git(config_dir, git_args):
     return []
 
 
+def describe_exit(code):
+    """Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    Batch 1C in a broken/headless environment (no GUI session, no license) can crash mid-run
+    instead of returning a clean error, possibly leaving the infobase locked or half-mutated."""
+    if code is None:
+        return ""
+    win = {
+        3221225477: "0xC0000005 (access violation)", -1073741819: "0xC0000005 (access violation)",
+        3221225781: "0xC0000135 (missing DLL)", -1073741515: "0xC0000135 (missing DLL)",
+        3221226505: "0xC0000409 (stack overrun)", -1073740791: "0xC0000409 (stack overrun)",
+    }
+    if code in win:
+        return f" — abnormal termination, exception {win[code]}; the infobase may be left in an inconsistent state; verify it before retrying"
+    if -64 <= code < 0:
+        try:
+            import signal
+            name = signal.Signals(-code).name
+        except (ValueError, AttributeError):
+            name = f"signal {-code}"
+        return (f" — process terminated by {name} (abnormal termination, not a normal exit); "
+                "the infobase may be left in an inconsistent state; verify it before retrying")
+    return ""
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -86,19 +424,48 @@ def main():
     )
     parser.add_argument("-DryRun", action="store_true", help="Only show what would be loaded (no actual load)")
     parser.add_argument("-UpdateDB", action="store_true", help="Also update database configuration after load")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.ConfigDir = clean_path(args.ConfigDir, "-ConfigDir")
 
     # --- Resolve V8Path (skip if DryRun) ---
     v8path = None
     if not args.DryRun:
         v8path = resolve_v8path(args.V8Path)
 
-    # --- Validate connection (skip if DryRun) ---
+    # --- Detect engine + validate connection (skip if DryRun) ---
+    engine = "1cv8"
     if not args.DryRun:
-        if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+        engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+        if engine == "ibcmd":
+            if not args.InfoBasePath:
+                print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+                sys.exit(1)
+        elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
             print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
             sys.exit(1)
 
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
     # --- Validate config dir ---
     if not os.path.exists(args.ConfigDir):
         print(f"Error: config directory not found: {args.ConfigDir}", file=sys.stderr)
@@ -146,14 +513,19 @@ def main():
 
     # --- Filter and map to config files ---
     config_files = []
+    support_skipped = []
 
     for file in changed_files:
         file = file.strip().replace("\\", "/")
         if not file:
             continue
 
-        # Skip service files
+        # Skip service files (not partially loadable). Support-state files are
-        if file == "ConfigDumpInfo.xml":
+        # tracked to warn: support changes apply only via a full load.
+        if file.endswith("ParentConfigurations.bin"):
+            support_skipped.append(file)
+            continue
+        if file == "ConfigDumpInfo.xml" or file.endswith("/ConfigDumpInfo.xml"):
             continue
 
         full_path = os.path.join(args.ConfigDir, file)
@@ -186,6 +558,12 @@ def main():
                                     if rel_path not in config_files:
                                         config_files.append(rel_path)
 
+    if support_skipped:
+        print("[ВНИМАНИЕ] Состояние поддержки изменено в коммите, но частично не загружается (исключено):", file=sys.stderr)
+        for sf in support_skipped:
+            print(f"  - {sf}", file=sys.stderr)
+        print("  Смена состояния поддержки применяется только полной загрузкой (db-load-xml -Mode Full).", file=sys.stderr)
+
     if len(config_files) == 0:
         print("No configuration files found in changes")
         sys.exit(0)
@@ -205,6 +583,51 @@ def main():
     os.makedirs(temp_dir, exist_ok=True)
 
     try:
+        if engine == "ibcmd":
+            # --- ibcmd branch (file infobase only; import specific files) ---
+            if args.Format == "Plain":
+                print("Error: ibcmd config import supports hierarchical format only (use -Format Hierarchical or 1cv8)", file=sys.stderr)
+                sys.exit(1)
+            if args.AllExtensions:
+                print("Error: ibcmd config import does not support -AllExtensions (use -Extension or 1cv8)", file=sys.stderr)
+                sys.exit(1)
+            arguments = ["infobase", "config", "import", "files"] + config_files
+            arguments += [f"--base-dir={args.ConfigDir}", f"--db-path={args.InfoBasePath}"]
+            if args.Extension:
+                arguments.append(f"--extension={args.Extension}")
+            ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+            atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+            if args.UserName:
+                arguments.append(f"--user={args.UserName}")
+            if args.Password:
+                arguments.append(f"--password={args.Password}")
+            arguments.append(f"--data={ib_data}")
+            arguments.extend(extra_args)
+            print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+            result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+            if result.returncode != 0:
+                print(f"Error loading changes (code: {result.returncode}){describe_exit(result.returncode)}", file=sys.stderr)
+                sys.exit(result.returncode)
+            print(f"Changes loaded successfully ({len(config_files)} files)")
+            exit_code = 0
+            if args.UpdateDB:
+                apply_args = ["infobase", "config", "apply", f"--db-path={args.InfoBasePath}", "--force"]
+                if args.UserName:
+                    apply_args.append(f"--user={args.UserName}")
+                if args.Password:
+                    apply_args.append(f"--password={args.Password}")
+                apply_args.append(f"--data={ib_data}")
+                apply_args.extend(extra_args)
+                print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(apply_args, engine)), args.Password, args.UserName)}")
+                ar = run_ibcmd([v8path] + apply_args, bool(args.UserName))
+                exit_code = ar.returncode
+                if exit_code == 0:
+                    print("Database configuration updated successfully")
+                else:
+                    print(f"Error updating database configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
+                print_platform_output(ar)
+            sys.exit(exit_code)
+
         # --- Write list file (UTF-8 with BOM) ---
         list_file = os.path.join(temp_dir, "load_list.txt")
         with open(list_file, "w", encoding="utf-8-sig") as f:
@@ -214,24 +637,24 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments += ["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"]
+            arguments += ["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"']
         else:
-            arguments += ["/F", args.InfoBasePath]
+            arguments += ["/F", f'"{args.InfoBasePath}"']
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments += ["/LoadConfigFromFiles", args.ConfigDir]
+        arguments += ["/LoadConfigFromFiles", f'"{args.ConfigDir}"']
-        arguments += ["-listFile", list_file]
+        arguments += ["-listFile", f'"{list_file}"']
         arguments += ["-Format", args.Format]
         arguments.append("-partial")
         arguments.append("-updateConfigDumpInfo")
 
         # --- Extensions ---
         if args.Extension:
-            arguments += ["-Extension", args.Extension]
+            arguments += ["-Extension", f'"{args.Extension}"']
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
@@ -241,19 +664,16 @@ def main():
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "load_log.txt")
-        arguments += ["/Out", out_file]
+        arguments += ["/Out", f'"{out_file}"']
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
         print("")
         print("Executing partial configuration load...")
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
 
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
@@ -261,7 +681,7 @@ def main():
         if exit_code == 0:
             print("Load completed successfully")
         else:
-            print(f"Error loading configuration (code: {exit_code})", file=sys.stderr)
+            print(f"Error loading configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
 
         if os.path.isfile(out_file):
             try:
@@ -274,6 +694,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/db-load-xml/SKILL.md

@@ -1,109 +1,103 @@
----
+---
-name: db-load-xml
+name: db-load-xml
-description: Загрузка конфигурации 1С из XML-файлов. Используй когда нужно загрузить конфигурацию из файлов, XML, исходников, LoadConfigFromFiles
+description: Загрузка конфигурации 1С из XML-файлов. Используй когда нужно загрузить конфигурацию из файлов, XML, исходников, LoadConfigFromFiles
-argument-hint: <configDir> [database]
+argument-hint: <configDir> [database]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-load-xml — Загрузка конфигурации из XML
+# /db-load-xml — Загрузка конфигурации из XML
-
+
-Загружает конфигурацию в информационную базу из XML-файлов (исходников). Поддерживает полную и частичную загрузку.
+Загружает конфигурацию в информационную базу из XML-файлов (исходников). Поддерживает полную и частичную загрузку.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-load-xml <configDir> [database]
+/db-load-xml <configDir> [database]
-/db-load-xml src/config dev
+/db-load-xml src/config dev
-/db-load-xml src/config dev -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
+/db-load-xml src/config dev -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
-```
+```
-
+
-> **Внимание**: полная загрузка **заменяет всю конфигурацию** в базе. Перед выполнением запроси подтверждение у пользователя.
+> **Внимание**: полная загрузка **заменяет всю конфигурацию** в базе. Перед выполнением запроси подтверждение у пользователя.
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-Если в записи базы указан `configSrc` — используй как каталог загрузки по умолчанию.
+Если в записи базы указан `configSrc` — используй как каталог загрузки по умолчанию.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-ConfigDir <путь>` | да | Каталог XML-исходников |
+| `-ConfigDir <путь>` | да | Каталог XML-исходников |
-| `-Mode <режим>` | нет | `Full` (по умолч.) / `Partial` |
+| `-Mode <режим>` | нет | `Full` (по умолч.) / `Partial` |
-| `-Files <список>` | для Partial | Относительные пути файлов через запятую |
+| `-Files <список>` | для Partial | Относительные пути файлов через запятую |
-| `-ListFile <путь>` | для Partial | Путь к файлу со списком (альтернатива `-Files`) |
+| `-ListFile <путь>` | для Partial | Путь к файлу со списком (альтернатива `-Files`) |
-| `-Extension <имя>` | нет | Загрузить в расширение |
+| `-Extension <имя>` | нет | Загрузить в расширение |
-| `-AllExtensions` | нет | Загрузить все расширения |
+| `-AllExtensions` | нет | Загрузить все расширения |
-| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
+| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
-| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
+| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-### Режимы загрузки
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Режим | Описание |
+### Режимы загрузки
-|-------|----------|
+
-| `Full` | Полная загрузка — замена всей конфигурации из каталога XML |
+| Режим | Описание |
-| `Partial` | Частичная — загрузка выбранных файлов (с `-partial -updateConfigDumpInfo`) |
+|-------|----------|
-
+| `Full` | Полная загрузка — замена всей конфигурации из каталога XML |
-### Формат файла списка (listFile)
+| `Partial` | Частичная — загрузка выбранных файлов (с `-partial -updateConfigDumpInfo`) |
-
+
-Файл содержит **относительные пути к файлам** в каталоге выгрузки (один на строку), кодировка **UTF-8 с BOM**:
+### Формат файла списка (listFile)
-
+
-```
+Файл содержит **относительные пути к файлам** в каталоге выгрузки (один на строку), кодировка **UTF-8 с BOM**:
-Catalogs/Номенклатура.xml
+
-Catalogs/Номенклатура/Ext/ObjectModule.bsl
+```
-Documents/Заказ.xml
+Catalogs/Номенклатура.xml
-Documents/Заказ/Forms/ФормаДокумента.xml
+Catalogs/Номенклатура/Ext/ObjectModule.bsl
-```
+Documents/Заказ.xml
-
+Documents/Заказ/Forms/ФормаДокумента.xml
-## Коды возврата
+```
-
+
-| Код | Описание |
+## После выполнения
-|-----|----------|
+
-| 0 | Успешно |
+Если `-UpdateDB` не был указан — **предложи выполнить `/db-update`** для применения изменений к БД
-| 1 | Ошибка (см. лог) |
+
-
+## Примеры
-## После выполнения
+
-
+```powershell
-1. Прочитай лог и покажи результат
+# Полная загрузка
-2. Если `-UpdateDB` не был указан — **предложи выполнить `/db-update`** для применения изменений к БД
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
-
+
-## Примеры
+# Частичная загрузка конкретных файлов
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
-```powershell
+
-# Полная загрузка
+# Загрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
-
+
-# Частичная загрузка конкретных файлов
+# Загрузка + обновление БД в одном запуске
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
-
+```
-# Загрузка расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
-
-# Загрузка + обновление БД в одном запуске
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
-```

.claude/skills/db-load-xml/scripts/db-load-xml.ps1

@@ -1,279 +1,664 @@
-# db-load-xml v1.3 — Load 1C configuration from XML files
+# db-load-xml v1.19 — Load 1C configuration from XML files
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Загрузка конфигурации 1С из XML-файлов
+.SYNOPSIS
-
+    Загрузка конфигурации 1С из XML-файлов
-.DESCRIPTION
+
-    Загружает конфигурацию в информационную базу из XML-файлов.
+.DESCRIPTION
-    Поддерживает полную и частичную загрузку.
+    Загружает конфигурацию в информационную базу из XML-файлов.
-
+    Поддерживает полную и частичную загрузку.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER ConfigDir
+
-    Каталог XML-исходников конфигурации
+.PARAMETER ConfigDir
-
+    Каталог XML-исходников конфигурации
-.PARAMETER Mode
+
-    Режим загрузки: Full или Partial (по умолчанию Full)
+.PARAMETER Mode
-
+    Режим загрузки: Full или Partial (по умолчанию Full)
-.PARAMETER Files
+
-    Относительные пути файлов через запятую (для режима Partial)
+.PARAMETER Files
-
+    Относительные пути файлов через запятую (для режима Partial)
-.PARAMETER ListFile
+
-    Путь к файлу со списком файлов (альтернатива -Files, для режима Partial)
+.PARAMETER ListFile
-
+    Путь к файлу со списком файлов (альтернатива -Files, для режима Partial)
-.PARAMETER Extension
+
-    Имя расширения для загрузки
+.PARAMETER Extension
-
+    Имя расширения для загрузки
-.PARAMETER AllExtensions
+
-    Загрузить все расширения
+.PARAMETER AllExtensions
-
+    Загрузить все расширения
-.PARAMETER Format
+
-    Формат файлов: Hierarchical или Plain (по умолчанию Hierarchical)
+.PARAMETER Format
-
+    Формат файлов: Hierarchical или Plain (по умолчанию Hierarchical)
-.EXAMPLE
+
-    .\db-load-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Full
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-load-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-load-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Full
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-load-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\src" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$ConfigDir,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("Full", "Partial")]
+    [Parameter(Mandatory=$false)]
-    [string]$Mode = "Full",
+    [string]$Password,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$true)]
-    [string]$Files,
+    [string]$ConfigDir,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [string]$ListFile,
+    [ValidateSet("Full", "Partial")]
-
+    [string]$Mode = "Full",
-    [Parameter(Mandatory=$false)]
+
-    [string]$Extension,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Files,
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AllExtensions,
+    [Parameter(Mandatory=$false)]
-
+    [string]$ListFile,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("Hierarchical", "Plain")]
+    [Parameter(Mandatory=$false)]
-    [string]$Format = "Hierarchical",
+    [string]$Extension,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [switch]$UpdateDB,
+    [switch]$AllExtensions,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [switch]$StrictLog
+    [ValidateSet("Hierarchical", "Plain")]
-)
+    [string]$Format = "Hierarchical",
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [switch]$UpdateDB,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [switch]$StrictLog,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+function Get-ExitAnnotation {
-    exit 1
+    # Annotate an abnormal process exit code so a crash isn't reported as a bare number.
-}
+    # A batch DESIGNER that crashes (e.g. missing license) may leave the infobase locked or
-
+    # half-updated — surface that instead of a plain code. (Windows exception codes only;
-# --- Validate config dir ---
+    # POSIX signals are handled in the .py port.)
-if (-not (Test-Path $ConfigDir)) {
+    param([int]$Code)
-    Write-Host "Error: config directory not found: $ConfigDir" -ForegroundColor Red
+    $win = @{
-    exit 1
+        -1073741819 = "0xC0000005 (access violation)"
-}
+        -1073741515 = "0xC0000135 (missing DLL)"
-
+        -1073740791 = "0xC0000409 (stack overrun)"
-# --- Validate Partial mode ---
+    }
-if ($Mode -eq "Partial" -and -not $Files -and -not $ListFile) {
+    if ($win.ContainsKey($Code)) {
-    Write-Host "Error: -Files or -ListFile required for Partial mode" -ForegroundColor Red
+        return " — abnormal termination, exception $($win[$Code]); the infobase may be left in an inconsistent state; verify it before retrying"
-    exit 1
+    }
-}
+    return ""
-
+}
-# --- Temp dir ---
+
-$tempDir = Join-Path $env:TEMP "db_load_xml_$(Get-Random)"
+# --- Additional platform arguments ---
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+$script:V8OwnedKeys = @(
-
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-try {
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-    # --- Build arguments ---
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-    $arguments = @("DESIGNER")
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    if ($InfoBaseServer -and $InfoBaseRef) {
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+)
-    } else {
+$script:IbcmdOwnedKeys = @(
-        $arguments += "/F", "`"$InfoBasePath`""
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-    }
+    '--import', '--export', '--apply', '--force', '--create-database',
-
+    '--user', '--password'
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+)
-    if ($Password) { $arguments += "/P`"$Password`"" }
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-    $arguments += "/LoadConfigFromFiles", "`"$ConfigDir`""
+
-
+function Test-ArgKeyMatch {
-    if ($Mode -eq "Full") {
+    # A token matches a key when it equals the key, or starts with it and the next
-        Write-Host "Executing full configuration load..."
+    # character is not a letter — catches glued /N"user" and --password=x, while
-    } else {
+    # keeping /ClearCache distinct from /C.
-        Write-Host "Executing partial configuration load..."
+    param([string]$Token, [string]$Key)
-
+    if ($Token.Length -lt $Key.Length) { return $false }
-        # Build list file
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-        $generatedListFile = $null
+    if ($Token.Length -eq $Key.Length) { return $true }
-        if ($ListFile) {
+    return -not [char]::IsLetter($Token[$Key.Length])
-            # Use provided list file
+}
-            if (-not (Test-Path $ListFile)) {
+
-                Write-Host "Error: list file not found: $ListFile" -ForegroundColor Red
+function Get-ProjectExtraArgs {
-                exit 1
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-            }
+    param([string]$Name)
-            $generatedListFile = $ListFile
+    $dir = (Get-Location).Path
-        } else {
+    while ($dir) {
-            # Generate from -Files parameter
+        $pf = Join-Path $dir ".v8-project.json"
-            $fileList = $Files -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
+        if (Test-Path $pf) {
-            $generatedListFile = Join-Path $tempDir "load_list.txt"
+            try {
-            $utf8Bom = New-Object System.Text.UTF8Encoding($true)
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-            [System.IO.File]::WriteAllLines($generatedListFile, $fileList, $utf8Bom)
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-
+            } catch {}
-            Write-Host "Files to load: $($fileList.Count)"
+            return @()
-            foreach ($f in $fileList) { Write-Host "  $f" }
+        }
-        }
+        $parent = Split-Path $dir -Parent
-
+        if (-not $parent -or $parent -eq $dir) { break }
-        $arguments += "-listFile", "`"$generatedListFile`""
+        $dir = $parent
-        $arguments += "-partial"
+    }
-        $arguments += "-updateConfigDumpInfo"
+    return @()
-    }
+}
-
+
-    $arguments += "-Format", $Format
+function Assert-ExtraArgs {
-
+    # The platform accepts only one batch operation, and a duplicate connection or
-    # --- Extensions ---
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-    if ($Extension) {
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-        $arguments += "-Extension", "`"$Extension`""
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    } elseif ($AllExtensions) {
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-        $arguments += "-AllExtensions"
+    foreach ($tok in $ExtraArgs) {
-    }
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-    # --- UpdateDB ---
+            exit 1
-    if ($UpdateDB) {
+        }
-        $arguments += "/UpdateDBCfg"
+        foreach ($k in $owned) {
-    }
+            if (Test-ArgKeyMatch $tok $k) {
-
+                $hint = ''
-    # --- Output ---
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-    $outFile = Join-Path $tempDir "load_log.txt"
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-    $arguments += "/Out", "`"$outFile`""
+                exit 1
-    $arguments += "/DisableStartupDialogs"
+            }
-
+        }
-    # --- Execute ---
+    }
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+}
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+
-    $exitCode = $process.ExitCode
+function Resolve-ExtraArgs {
-
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
-    # --- Read log ---
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
-    $logContent = $null
+    # simply do not apply — a project may describe both engines.
-    if (Test-Path $outFile) {
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
-    }
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
-
+    # single token. So accept the repo's list convention (comma-separated) and split here;
-    # --- Scan log for silent rejections ---
+    # a native array call keeps working. A value containing a comma is not supported.
-    # Platform often writes load-time rejections into /Out but exits with code 0.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    # These patterns flag cases where metadata was dropped or rejected silently.
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    $fatalLogPatterns = @(
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
-        'Неверное свойство объекта метаданных',
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
-        'не входит в состав объекта метаданных',
+        exit 1
-        'Неизвестное имя типа',
+    }
-        'Неизвестный объект метаданных',
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
-        'Ни один из документов не является регистратором для регистра',
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
-        'Неверное значение перечисления',
+        exit 1
-        'не может быть приведен к типу'
+    }
-    )
+    if ($Engine -eq 'ibcmd') {
-    $silentFailures = @()
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
-    if ($logContent) {
+    } else {
-        foreach ($line in ($logContent -split "`r?`n")) {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
-            foreach ($pat in $fatalLogPatterns) {
+    }
-                if ($line -match [regex]::Escape($pat)) {
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
-                    $silentFailures += $line.Trim()
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
-                    break
+    # would nest the array — the tokens would then be glued into one argument.
-                }
+    return $extra
-            }
+}
-        }
+
-    }
+function Format-ArgsForDisplay {
-
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
-    # --- Result ---
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
-    # Default: mirror platform's verdict via exit code. Log content (including any
+    # a leaked password does.
-    # rejection warnings) is always printed to stdout for visibility. With -StrictLog,
+    param([string[]]$ArgList, [string]$Engine)
-    # elevate exit code to 1 when rejection patterns are found even if platform said 0.
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
-    if ($exitCode -eq 0) {
+    $res = @()
-        Write-Host "Load completed successfully" -ForegroundColor Green
+    $maskNext = $false
-    } else {
+    foreach ($tok in $ArgList) {
-        Write-Host "Error loading configuration (code: $exitCode)" -ForegroundColor Red
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
-    }
+        $hit = $null
-
+        foreach ($k in $keys) {
-    if ($logContent) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
-        Write-Host "--- Log ---"
+        }
-        Write-Host $logContent
+        if (-not $hit) { $res += $tok; continue }
-        Write-Host "--- End ---"
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
-    }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
-
+        else { $res += ($hit + '***') }
-    if ($silentFailures.Count -gt 0) {
+    }
-        $msg = "[warning] log contains $($silentFailures.Count) rejection(s) — platform loaded config but dropped properties/refs"
+    return ,$res
-        if (-not $StrictLog) { $msg += " (pass -StrictLog to treat as error)" }
+}
-        Write-Host $msg -ForegroundColor Yellow
+
-        foreach ($f in $silentFailures) { Write-Host "  $f" -ForegroundColor Yellow }
+function ConvertTo-CleanPath {
-        if ($StrictLog -and $exitCode -eq 0) { $exitCode = 1 }
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
-    }
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
-
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
-    exit $exitCode
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
-
+    param([string]$Value, [string]$ParamName)
-} finally {
+    if (-not $Value) { return $Value }
-    if (Test-Path $tempDir) {
+    $v = $Value.Trim()
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
-    }
+        $v = $v.Substring(1, $v.Length - 2).Trim()
-}
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$ConfigDir = ConvertTo-CleanPath $ConfigDir '-ConfigDir'
+$ListFile = ConvertTo-CleanPath $ListFile '-ListFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate config dir ---
+if (-not (Test-Path $ConfigDir)) {
+    Write-Host "Error: config directory not found: $ConfigDir" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate Partial mode ---
+if ($Mode -eq "Partial" -and -not $Files -and -not $ListFile) {
+    Write-Host "Error: -Files or -ListFile required for Partial mode" -ForegroundColor Red
+    exit 1
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_load_xml_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only; hierarchical full-directory import) ---
+        if ($Format -eq "Plain") {
+            Write-Host "Error: ibcmd config import supports hierarchical format only (use -Format Hierarchical or 1cv8)" -ForegroundColor Red
+            exit 1
+        }
+        if ($AllExtensions) {
+            $arguments = @("infobase", "config", "import", "all-extensions", "$ConfigDir", "--db-path=$InfoBasePath")
+        } elseif ($Mode -eq "Partial" -or $Files -or $ListFile) {
+            # partial: import specific files (relative to ConfigDir)
+            $fileList = @()
+            if ($ListFile) {
+                if (-not (Test-Path $ListFile)) {
+                    Write-Host "Error: list file not found: $ListFile" -ForegroundColor Red
+                    exit 1
+                }
+                $fileList = @(Get-Content -Path $ListFile -Encoding UTF8 | ForEach-Object { $_.Trim() } | Where-Object { $_ })
+            } elseif ($Files) {
+                $fileList = @($Files -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ })
+            }
+            if ($fileList.Count -eq 0) {
+                Write-Host "Error: -Files or -ListFile required for partial import" -ForegroundColor Red
+                exit 1
+            }
+            $arguments = @("infobase", "config", "import", "files") + $fileList
+            $arguments += "--base-dir=$ConfigDir", "--db-path=$InfoBasePath"
+            if ($Extension) { $arguments += "--extension=$Extension" }
+        } else {
+            $arguments = @("infobase", "config", "import", "--db-path=$InfoBasePath")
+            if ($Extension) { $arguments += "--extension=$Extension" }
+            $arguments += "$ConfigDir"
+        }
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        if ($exitCode -ne 0) {
+            Write-Host "Error loading configuration from files (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+            Write-PlatformOutput $output
+            exit $exitCode
+        }
+        Write-Host "Configuration loaded successfully from: $ConfigDir" -ForegroundColor Green
+        Write-PlatformOutput $output
+
+        if ($UpdateDB) {
+            $applyArgs = @("infobase", "config", "apply", "--db-path=$InfoBasePath", "--force")
+            if ($UserName) { $applyArgs += "--user=$UserName" }
+            if ($Password) { $applyArgs += "--password=$Password" }
+            $applyArgs += "--data=$tempDir"
+            $applyArgs += $extraArgs
+            Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $applyArgs $engine) -join ' ') @($Password, $UserName))"
+            $__ib = Invoke-PlatformProcess $V8Path $applyArgs
+            $applyOut = $__ib.Output
+            $exitCode = $__ib.ExitCode
+            if ($exitCode -eq 0) {
+                Write-Host "Database configuration updated successfully" -ForegroundColor Green
+            } else {
+                Write-Host "Error updating database configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+            }
+            Write-PlatformOutput $applyOut
+        }
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/LoadConfigFromFiles", "`"$ConfigDir`""
+
+    if ($Mode -eq "Full") {
+        Write-Host "Executing full configuration load..."
+    } else {
+        Write-Host "Executing partial configuration load..."
+
+        # Build list file
+        $rawList = @()
+        if ($ListFile) {
+            if (-not (Test-Path $ListFile)) {
+                Write-Host "Error: list file not found: $ListFile" -ForegroundColor Red
+                exit 1
+            }
+            $rawList = @(Get-Content -Path $ListFile -Encoding UTF8 | ForEach-Object { $_.Trim() } | Where-Object { $_ })
+        } else {
+            $rawList = @($Files -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ })
+        }
+
+        # Support-state service files are NOT partially loadable — exclude with a hint.
+        $supportRe = 'ParentConfigurations\.bin$|(^|[\\/])ConfigDumpInfo\.xml$'
+        $supportFiles = @($rawList | Where-Object { $_ -match $supportRe })
+        $fileList = @($rawList | Where-Object { $_ -notmatch $supportRe })
+        if ($supportFiles.Count -gt 0) {
+            Write-Host "[ВНИМАНИЕ] Служебные файлы состояния поддержки исключены из частичной загрузки (частично не грузятся):" -ForegroundColor Yellow
+            foreach ($sf in $supportFiles) { Write-Host "  - $sf" -ForegroundColor Yellow }
+            Write-Host "  Смена состояния поддержки применяется только полной загрузкой: -Mode Full." -ForegroundColor Yellow
+        }
+        if ($fileList.Count -eq 0) {
+            Write-Host "Error: после исключения служебных файлов поддержки загружать нечего. Для смены поддержки используйте -Mode Full." -ForegroundColor Red
+            exit 1
+        }
+        $generatedListFile = Join-Path $tempDir "load_list.txt"
+        $utf8Bom = New-Object System.Text.UTF8Encoding($true)
+        [System.IO.File]::WriteAllLines($generatedListFile, $fileList, $utf8Bom)
+        Write-Host "Files to load: $($fileList.Count)"
+        foreach ($f in $fileList) { Write-Host "  $f" }
+
+        $arguments += "-listFile", "`"$generatedListFile`""
+        $arguments += "-partial"
+        $arguments += "-updateConfigDumpInfo"
+    }
+
+    $arguments += "-Format", $Format
+
+    # --- Extensions ---
+    if ($Extension) {
+        $arguments += "-Extension", "`"$Extension`""
+    } elseif ($AllExtensions) {
+        $arguments += "-AllExtensions"
+    }
+
+    # --- UpdateDB ---
+    if ($UpdateDB) {
+        $arguments += "/UpdateDBCfg"
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "load_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Read log ---
+    $logContent = $null
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+    }
+
+    # --- Scan log for silent rejections ---
+    # Platform often writes load-time rejections into /Out but exits with code 0.
+    # These patterns flag cases where metadata was dropped or rejected silently.
+    $fatalLogPatterns = @(
+        'Неверное свойство объекта метаданных',
+        'не входит в состав объекта метаданных',
+        'Неизвестное имя типа',
+        'Неизвестный объект метаданных',
+        'Ни один из документов не является регистратором для регистра',
+        'Неверное значение перечисления',
+        'не может быть приведен к типу'
+    )
+    $silentFailures = @()
+    if ($logContent) {
+        foreach ($line in ($logContent -split "`r?`n")) {
+            foreach ($pat in $fatalLogPatterns) {
+                if ($line -match [regex]::Escape($pat)) {
+                    $silentFailures += $line.Trim()
+                    break
+                }
+            }
+        }
+    }
+
+    # --- Result ---
+    # Default: mirror platform's verdict via exit code. Log content (including any
+    # rejection warnings) is always printed to stdout for visibility. With -StrictLog,
+    # elevate exit code to 1 when rejection patterns are found even if platform said 0.
+    if ($exitCode -eq 0) {
+        Write-Host "Load completed successfully" -ForegroundColor Green
+    } else {
+        Write-Host "Error loading configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+    }
+
+    if ($logContent) {
+        Write-Host "--- Log ---"
+        Write-Host $logContent
+        Write-Host "--- End ---"
+    }
+    Write-PlatformOutput $__v8.Output
+
+    if ($silentFailures.Count -gt 0) {
+        $msg = "[warning] log contains $($silentFailures.Count) rejection(s) — platform loaded config but dropped properties/refs"
+        if (-not $StrictLog) { $msg += " (pass -StrictLog to treat as error)" }
+        Write-Host $msg -ForegroundColor Yellow
+        foreach ($f in $silentFailures) { Write-Host "  $f" -ForegroundColor Yellow }
+        if ($StrictLog -and $exitCode -eq 0) { $exitCode = 1 }
+    }
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-load-xml/scripts/db-load-xml.py

@@ -1,35 +1,374 @@
 #!/usr/bin/env python3
-# db-load-xml v1.3 — Load 1C configuration from XML files
+# db-load-xml v1.19 — Load 1C configuration from XML files
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        candidates = glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+    while True:
-        if candidates:
+        pf = os.path.join(d, ".v8-project.json")
-            candidates.sort()
+        if os.path.isfile(pf):
-            return candidates[-1]
+            try:
-        else:
+                with open(pf, encoding="utf-8-sig") as f:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                    data = json.load(f)
-            sys.exit(1)
+                v = data.get("v8path")
-    elif os.path.isdir(v8path):
+                if v:
-        v8path = os.path.join(v8path, "1cv8.exe")
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
         sys.exit(1)
 
-    return v8path
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def describe_exit(code):
+    """Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    Batch 1C in a broken/headless environment (no GUI session, no license) can crash mid-run
+    instead of returning a clean error, possibly leaving the infobase locked or half-mutated."""
+    if code is None:
+        return ""
+    win = {
+        3221225477: "0xC0000005 (access violation)", -1073741819: "0xC0000005 (access violation)",
+        3221225781: "0xC0000135 (missing DLL)", -1073741515: "0xC0000135 (missing DLL)",
+        3221226505: "0xC0000409 (stack overrun)", -1073740791: "0xC0000409 (stack overrun)",
+    }
+    if code in win:
+        return f" — abnormal termination, exception {win[code]}; the infobase may be left in an inconsistent state; verify it before retrying"
+    if -64 <= code < 0:
+        try:
+            import signal
+            name = signal.Signals(-code).name
+        except (ValueError, AttributeError):
+            name = f"signal {-code}"
+        return (f" — process terminated by {name} (abnormal termination, not a normal exit); "
+                "the infobase may be left in an inconsistent state; verify it before retrying")
+    return ""
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
 
 
 def main():
@@ -68,13 +407,43 @@ def main():
         action="store_true",
         help="Treat silent rejection warnings in the log as errors (elevate exit code to 1)",
     )
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.ConfigDir = clean_path(args.ConfigDir, "-ConfigDir")
+    args.ListFile = clean_path(args.ListFile, "-ListFile")
 
     # --- Resolve V8Path ---
     v8path = resolve_v8path(args.V8Path)
 
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
@@ -88,6 +457,70 @@ def main():
         print("Error: -Files or -ListFile required for Partial mode", file=sys.stderr)
         sys.exit(1)
 
+    # --- ibcmd branch (file infobase only; hierarchical full-directory import) ---
+    if engine == "ibcmd":
+        if args.Format == "Plain":
+            print("Error: ibcmd config import supports hierarchical format only (use -Format Hierarchical or 1cv8)", file=sys.stderr)
+            sys.exit(1)
+        if args.AllExtensions:
+            arguments = ["infobase", "config", "import", "all-extensions", args.ConfigDir, f"--db-path={args.InfoBasePath}"]
+        elif args.Mode == "Partial" or args.Files or args.ListFile:
+            # partial: import specific files (relative to ConfigDir)
+            if args.ListFile:
+                if not os.path.isfile(args.ListFile):
+                    print(f"Error: list file not found: {args.ListFile}", file=sys.stderr)
+                    sys.exit(1)
+                with open(args.ListFile, encoding="utf-8-sig") as f:
+                    file_list = [ln.strip() for ln in f if ln.strip()]
+            elif args.Files:
+                file_list = [p.strip() for p in args.Files.split(",") if p.strip()]
+            else:
+                file_list = []
+            if not file_list:
+                print("Error: -Files or -ListFile required for partial import", file=sys.stderr)
+                sys.exit(1)
+            arguments = ["infobase", "config", "import", "files"] + file_list
+            arguments += [f"--base-dir={args.ConfigDir}", f"--db-path={args.InfoBasePath}"]
+            if args.Extension:
+                arguments.append(f"--extension={args.Extension}")
+        else:
+            arguments = ["infobase", "config", "import", f"--db-path={args.InfoBasePath}"]
+            if args.Extension:
+                arguments.append(f"--extension={args.Extension}")
+            arguments.append(args.ConfigDir)
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        if result.returncode != 0:
+            print(f"Error loading configuration from files (code: {result.returncode}){describe_exit(result.returncode)}", file=sys.stderr)
+            sys.exit(result.returncode)
+        print(f"Configuration loaded successfully from: {args.ConfigDir}")
+        exit_code = 0
+        if args.UpdateDB:
+            apply_args = ["infobase", "config", "apply", f"--db-path={args.InfoBasePath}", "--force"]
+            if args.UserName:
+                apply_args.append(f"--user={args.UserName}")
+            if args.Password:
+                apply_args.append(f"--password={args.Password}")
+            apply_args.append(f"--data={ib_data}")
+            apply_args.extend(extra_args)
+            print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(apply_args, engine)), args.Password, args.UserName)}")
+            ar = run_ibcmd([v8path] + apply_args, bool(args.UserName))
+            exit_code = ar.returncode
+            if exit_code == 0:
+                print("Database configuration updated successfully")
+            else:
+                print(f"Error updating database configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
+            print_platform_output(ar)
+        sys.exit(exit_code)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_load_xml_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -97,16 +530,16 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments += ["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"]
+            arguments += ["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"']
         else:
-            arguments += ["/F", args.InfoBasePath]
+            arguments += ["/F", f'"{args.InfoBasePath}"']
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments += ["/LoadConfigFromFiles", args.ConfigDir]
+        arguments += ["/LoadConfigFromFiles", f'"{args.ConfigDir}"']
 
         if args.Mode == "Full":
             print("Executing full configuration load...")
@@ -114,25 +547,35 @@ def main():
             print("Executing partial configuration load...")
 
             # Build list file
-            generated_list_file = None
             if args.ListFile:
-                # Use provided list file
                 if not os.path.isfile(args.ListFile):
                     print(f"Error: list file not found: {args.ListFile}", file=sys.stderr)
                     sys.exit(1)
-                generated_list_file = args.ListFile
+                with open(args.ListFile, encoding="utf-8-sig") as f:
+                    raw_list = [ln.strip() for ln in f if ln.strip()]
             else:
-                # Generate from -Files parameter
+                raw_list = [f.strip() for f in args.Files.split(",") if f.strip()]
-                file_list = [f.strip() for f in args.Files.split(",") if f.strip()]
-                generated_list_file = os.path.join(temp_dir, "load_list.txt")
-                with open(generated_list_file, "w", encoding="utf-8-sig") as f:
-                    f.write("\n".join(file_list))
 
-                print(f"Files to load: {len(file_list)}")
+            # Support-state service files are NOT partially loadable — exclude with a hint.
-                for fl in file_list:
+            support_re = re.compile(r"ParentConfigurations\.bin$|(^|[\\/])ConfigDumpInfo\.xml$")
-                    print(f"  {fl}")
+            support_files = [x for x in raw_list if support_re.search(x)]
+            file_list = [x for x in raw_list if not support_re.search(x)]
+            if support_files:
+                print("[ВНИМАНИЕ] Служебные файлы состояния поддержки исключены из частичной загрузки (частично не грузятся):", file=sys.stderr)
+                for sf in support_files:
+                    print(f"  - {sf}", file=sys.stderr)
+                print("  Смена состояния поддержки применяется только полной загрузкой: -Mode Full.", file=sys.stderr)
+            if not file_list:
+                print("Error: после исключения служебных файлов поддержки загружать нечего. Для смены поддержки используйте -Mode Full.", file=sys.stderr)
+                sys.exit(1)
+            generated_list_file = os.path.join(temp_dir, "load_list.txt")
+            with open(generated_list_file, "w", encoding="utf-8-sig") as f:
+                f.write("\n".join(file_list))
+            print(f"Files to load: {len(file_list)}")
+            for fl in file_list:
+                print(f"  {fl}")
 
-            arguments += ["-listFile", generated_list_file]
+            arguments += ["-listFile", f'"{generated_list_file}"']
             arguments.append("-partial")
             arguments.append("-updateConfigDumpInfo")
 
@@ -140,7 +583,7 @@ def main():
 
         # --- Extensions ---
         if args.Extension:
-            arguments += ["-Extension", args.Extension]
+            arguments += ["-Extension", f'"{args.Extension}"']
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
@@ -150,16 +593,13 @@ def main():
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "load_log.txt")
-        arguments += ["/Out", out_file]
+        arguments += ["/Out", f'"{out_file}"']
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Read log ---
@@ -198,13 +638,14 @@ def main():
         if exit_code == 0:
             print("Load completed successfully")
         else:
-            print(f"Error loading configuration (code: {exit_code})", file=sys.stderr)
+            print(f"Error loading configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
 
         if log_content:
             print("--- Log ---")
             print(log_content)
             print("--- End ---")
 
+        print_platform_output(result)
         if silent_failures:
             suffix = "" if args.StrictLog else " (pass -StrictLog to treat as error)"
             print(

.claude/skills/db-run/SKILL.md

@@ -1,76 +1,77 @@
----
+---
-name: db-run
+name: db-run
-description: Запуск 1С:Предприятие. Используй когда нужно запустить 1С, открыть базу, запустить предприятие
+description: Запуск 1С:Предприятие. Используй когда нужно запустить 1С, открыть базу, запустить предприятие
-argument-hint: "[database]"
+argument-hint: "[database]"
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-run — Запуск 1С:Предприятие
+# /db-run — Запуск 1С:Предприятие
-
+
-Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).
+Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-run [database]
+/db-run [database]
-/db-run dev
+/db-run dev
-/db-run dev /Execute process.epf
+/db-run dev /Execute process.epf
-/db-run dev /C "параметр запуска"
+/db-run dev /C "параметр запуска"
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-Execute <файл.epf>` | нет | Запуск внешней обработки сразу после старта |
+| `-Execute <файл.epf>` | нет | Запуск внешней обработки сразу после старта |
-| `-CParam <строка>` | нет | Параметр запуска (/C) |
+| `-CParam <строка>` | нет | Параметр запуска (/C) |
-| `-URL <ссылка>` | нет | Навигационная ссылка (формат `e1cib/...`) |
+| `-URL <ссылка>` | нет | Навигационная ссылка (формат `e1cib/...`) |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+
-
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-## Важно
+
-
+## Важно
-Скрипт запускает 1С в фоне (`Start-Process` без `-Wait`) — управление возвращается сразу.
+
-
+Скрипт запускает 1С в фоне (`Start-Process` без `-Wait`) — управление возвращается сразу.
-## Примеры
+
-
+## Примеры
-```powershell
+
-# Простой запуск
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+# Простой запуск
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
-# Запуск с обработкой
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"
+# Запуск с обработкой
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"
-# Открыть по навигационной ссылке
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"
+# Открыть по навигационной ссылке
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"
-# Серверная база с параметром запуска
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
+# Серверная база с параметром запуска
-```
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
+```

.claude/skills/db-run/scripts/db-run.ps1

@@ -1,145 +1,369 @@
-# db-run v1.0 — Launch 1C:Enterprise
+# db-run v1.7 — Launch 1C:Enterprise
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Запуск 1С:Предприятие
+.SYNOPSIS
-
+    Запуск 1С:Предприятие
-.DESCRIPTION
+
-    Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).
+.DESCRIPTION
-    Запуск в фоне — не ждёт завершения процесса.
+    Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).
-
+    Запуск в фоне — не ждёт завершения процесса.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER Execute
+
-    Путь к внешней обработке для запуска
+.PARAMETER Execute
-
+    Путь к внешней обработке для запуска
-.PARAMETER CParam
+
-    Параметр запуска (/C)
+.PARAMETER CParam
-
+    Параметр запуска (/C)
-.PARAMETER URL
+
-    Навигационная ссылка (e1cib/...)
+.PARAMETER URL
-
+    Навигационная ссылка (e1cib/...)
-.EXAMPLE
+
-    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -Execute "C:\epf\МояОбработка.epf"
+.PARAMETER AdditionalIbcmdArguments
-
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-.EXAMPLE
+
-    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -CParam "ЗапуститьОбновление"
+.EXAMPLE
-#>
+    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB"
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -Execute "C:\epf\МояОбработка.epf"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -CParam "ЗапуститьОбновление"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Execute,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [string]$CParam,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Password,
-    [Parameter(Mandatory=$false)]
+
-    [string]$URL
+    [Parameter(Mandatory=$false)]
-)
+    [string]$Execute,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [string]$CParam,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [string]$URL,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+# --- Additional platform arguments ---
-    exit 1
+$script:V8OwnedKeys = @(
-}
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-# --- Build arguments as single string ---
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-# Note: Start-Process without -NoNewWindow uses ShellExecute.
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-# Passing ArgumentList as array can corrupt Cyrillic when ShellExecute
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-# re-joins elements. Single string avoids this.
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-$argString = "ENTERPRISE"
+)
-
+$script:IbcmdOwnedKeys = @(
-if ($InfoBaseServer -and $InfoBaseRef) {
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-    $argString += " /S `"$InfoBaseServer/$InfoBaseRef`""
+    '--import', '--export', '--apply', '--force', '--create-database',
-} else {
+    '--user', '--password'
-    $argString += " /F `"$InfoBasePath`""
+)
-}
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-if ($UserName) { $argString += " /N`"$UserName`"" }
+
-if ($Password) { $argString += " /P`"$Password`"" }
+function Test-ArgKeyMatch {
-
+    # A token matches a key when it equals the key, or starts with it and the next
-# --- Optional params ---
+    # character is not a letter — catches glued /N"user" and --password=x, while
-if ($Execute) {
+    # keeping /ClearCache distinct from /C.
-    $ext = [System.IO.Path]::GetExtension($Execute).ToLower()
+    param([string]$Token, [string]$Key)
-    if ($ext -eq ".erf") {
+    if ($Token.Length -lt $Key.Length) { return $false }
-        Write-Host "[WARN] /Execute не поддерживает ERF-файлы (внешние отчёты)." -ForegroundColor Yellow
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-        Write-Host "       Откройте отчёт через «Файл -> Открыть»: $Execute" -ForegroundColor Yellow
+    if ($Token.Length -eq $Key.Length) { return $true }
-        Write-Host "       Запускаю базу без /Execute." -ForegroundColor Yellow
+    return -not [char]::IsLetter($Token[$Key.Length])
-        $Execute = ""
+}
-    }
+
-}
+function Get-ProjectExtraArgs {
-if ($Execute) {
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-    $argString += " /Execute `"$Execute`""
+    param([string]$Name)
-}
+    $dir = (Get-Location).Path
-if ($CParam) {
+    while ($dir) {
-    $argString += " /C `"$CParam`""
+        $pf = Join-Path $dir ".v8-project.json"
-}
+        if (Test-Path $pf) {
-if ($URL) {
+            try {
-    $argString += " /URL `"$URL`""
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-}
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-
+            } catch {}
-$argString += " /DisableStartupDialogs"
+            return @()
-
+        }
-# --- Execute (background, no wait) ---
+        $parent = Split-Path $dir -Parent
-Write-Host "Running: 1cv8.exe $argString"
+        if (-not $parent -or $parent -eq $dir) { break }
-Start-Process -FilePath $V8Path -ArgumentList $argString
+        $dir = $parent
-Write-Host "1C:Enterprise launched" -ForegroundColor Green
+    }
+    return @()
+}
+
+function Assert-ExtraArgs {
+    # The platform accepts only one batch operation, and a duplicate connection or
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
+    foreach ($tok in $ExtraArgs) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$Execute = ConvertTo-CleanPath $Execute '-Execute'
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Resolve additional arguments ---
+# 1C:Enterprise is always launched by 1cv8 — ibcmd has no interactive mode.
+$engine = "1cv8"
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '/Execute' = '-Execute'; '/C' = '-CParam'; '/URL' = '-URL' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+function Format-ArgToken {
+    # ShellExecute re-joins the argument string, so quote each extra token that needs it.
+    param([string]$Token)
+    if ($Token -match '[\s"]') { return ' "' + ($Token -replace '"', '\"') + '"' }
+    return " $Token"
+}
+
+# --- Validate connection ---
+if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Build arguments as single string ---
+# Note: Start-Process without -NoNewWindow uses ShellExecute.
+# Passing ArgumentList as array can corrupt Cyrillic when ShellExecute
+# re-joins elements. Single string avoids this.
+$argString = "ENTERPRISE"
+
+if ($InfoBaseServer -and $InfoBaseRef) {
+    $argString += " /S `"$InfoBaseServer/$InfoBaseRef`""
+} else {
+    $argString += " /F `"$InfoBasePath`""
+}
+
+if ($UserName) { $argString += " /N`"$UserName`"" }
+if ($Password) { $argString += " /P`"$Password`"" }
+
+# --- Optional params ---
+if ($Execute) {
+    $ext = [System.IO.Path]::GetExtension($Execute).ToLower()
+    if ($ext -eq ".erf") {
+        Write-Host "[WARN] /Execute не поддерживает ERF-файлы (внешние отчёты)." -ForegroundColor Yellow
+        Write-Host "       Откройте отчёт через «Файл -> Открыть»: $Execute" -ForegroundColor Yellow
+        Write-Host "       Запускаю базу без /Execute." -ForegroundColor Yellow
+        $Execute = ""
+    }
+}
+if ($Execute) {
+    $argString += " /Execute `"$Execute`""
+}
+if ($CParam) {
+    $argString += " /C `"$CParam`""
+}
+if ($URL) {
+    $argString += " /URL `"$URL`""
+}
+
+$argString += " /DisableStartupDialogs"
+
+# The display string is built from the same tokens with secret-prone values redacted.
+$displayString = $argString
+foreach ($tok in $extraArgs) { $argString += (Format-ArgToken $tok) }
+foreach ($tok in (Format-ArgsForDisplay $extraArgs $engine)) { $displayString += (Format-ArgToken $tok) }
+
+# --- Execute (background) ---
+# Redact the password/user before printing the command line — never leak secrets.
+$displayArg = Protect-Secrets $displayString @($Password, $UserName)
+Write-Host "Running: 1cv8.exe $displayArg"
+$proc = Start-Process -FilePath $V8Path -ArgumentList $argString -PassThru
+
+# --- Bounded early-exit check ---
+# The launch is a background GUI process, so we don't wait for completion. But a process
+# that dies within the first ~1.5s never really started (bad base, no display, license) —
+# report that honestly instead of a blind "launched".
+$deadline = (Get-Date).AddMilliseconds(1500)
+while ((Get-Date) -lt $deadline -and -not $proc.HasExited) {
+    Start-Sleep -Milliseconds 200
+}
+if ($proc.HasExited) {
+    Write-Host "Error: 1C:Enterprise exited immediately (code: $($proc.ExitCode))" -ForegroundColor Red
+    if ($proc.ExitCode -ne 0) { exit $proc.ExitCode } else { exit 1 }
+}
+Write-Host "PID: $($proc.Id)"
+Write-Host "1C:Enterprise launched" -ForegroundColor Green

.claude/skills/db-run/scripts/db-run.py

@@ -1,32 +1,264 @@
 #!/usr/bin/env python3
-# db-run v1.0 — Launch 1C:Enterprise
+# db-run v1.7 — Launch 1C:Enterprise
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
 import glob
+import json
 import os
+import re
 import subprocess
 import sys
+import time
+
+
+def _find_project_v8path():
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get("v8path")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
+
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
 
 
 def resolve_v8path(v8path):
-    """Resolve path to 1cv8.exe."""
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
     if not v8path:
-        found = sorted(glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe"))
+        v8path = _find_project_v8path()
-        if found:
+    if not v8path:
-            return found[-1]
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
         else:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
             sys.exit(1)
-    elif os.path.isdir(v8path):
+    if os.path.isdir(v8path):
-        v8path = os.path.join(v8path, "1cv8.exe")
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
-
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
         sys.exit(1)
     return v8path
 
 
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -43,10 +275,34 @@ def main():
     parser.add_argument("-Execute", default="")
     parser.add_argument("-CParam", default="")
     parser.add_argument("-URL", default="")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    args.Execute = clean_path(args.Execute, "-Execute")
 
     v8path = resolve_v8path(args.V8Path)
 
+    # --- Resolve additional arguments ---
+    # 1C:Enterprise is always launched by 1cv8 — ibcmd has no interactive mode.
+    engine = "1cv8"
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "/Execute": "-Execute",
+        "/C": "-CParam",
+        "/URL": "-URL",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
     # --- Validate connection ---
     if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
@@ -83,10 +339,25 @@ def main():
         arguments.extend(["/URL", args.URL])
 
     arguments.append("/DisableStartupDialogs")
+    arguments.extend(extra_args)
 
-    # --- Execute (background, no wait) ---
+    # --- Execute (background) ---
-    print(f"Running: 1cv8.exe {' '.join(arguments)}")
+    # Redact the password/user before printing the command line — never leak secrets.
-    subprocess.Popen([v8path] + arguments)
+    print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+    proc = subprocess.Popen([v8path] + arguments)
+
+    # --- Bounded early-exit check ---
+    # The launch is a background GUI process, so we don't wait for completion. But a process
+    # that dies within the first ~1.5s never really started (bad base, no display, license) —
+    # report that honestly instead of a blind "launched".
+    deadline = time.monotonic() + 1.5
+    while time.monotonic() < deadline and proc.poll() is None:
+        time.sleep(0.2)
+    rc = proc.poll()
+    if rc is not None:
+        print(f"Error: 1C:Enterprise exited immediately (code: {rc})", file=sys.stderr)
+        sys.exit(rc if rc and rc > 0 else 1)
+    print(f"PID: {proc.pid}")
     print("1C:Enterprise launched")
 
 

.claude/skills/db-update/SKILL.md

@@ -1,93 +1,88 @@
----
+---
-name: db-update
+name: db-update
-description: Обновление конфигурации базы данных 1С. Используй когда нужно обновить БД, применить конфигурацию, UpdateDBCfg
+description: Обновление конфигурации базы данных 1С. Используй когда нужно обновить БД, применить конфигурацию, UpdateDBCfg
-argument-hint: "[database]"
+argument-hint: "[database]"
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - AskUserQuestion
+  - AskUserQuestion
----
+---
-
+
-# /db-update — Обновление конфигурации БД
+# /db-update — Обновление конфигурации БД
-
+
-Применяет изменения основной конфигурации к конфигурации базы данных (`/UpdateDBCfg`). Обязательный шаг после `/db-load-cf`, `/db-load-xml`, `/db-load-git`.
+Применяет изменения основной конфигурации к конфигурации базы данных (`/UpdateDBCfg`). Обязательный шаг после `/db-load-cf`, `/db-load-xml`, `/db-load-git`.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/db-update [database]
+/db-update [database]
-/db-update dev
+/db-update dev
-/db-update dev -Dynamic+
+/db-update dev -Dynamic+
-```
+```
-
+
-## Параметры подключения
+## Параметры подключения
-
+
-Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
+Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
-1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-4. Если ветка не совпала — используй `default`
+4. Если ветка не совпала — используй `default`
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если файла нет — предложи `/db-list add`.
+Если файла нет — предложи `/db-list add`.
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-Extension <имя>` | нет | Обновить расширение |
+| `-Extension <имя>` | нет | Обновить расширение |
-| `-AllExtensions` | нет | Обновить все расширения |
+| `-AllExtensions` | нет | Обновить все расширения |
-| `-Dynamic <+/->` | нет | `+` — динамическое обновление, `-` — отключить |
+| `-Dynamic <+/->` | нет | `+` — динамическое обновление, `-` — отключить |
-| `-Server` | нет | Обновление на стороне сервера |
+| `-Server` | нет | Обновление на стороне сервера |
-| `-WarningsAsErrors` | нет | Предупреждения считать ошибками |
+| `-WarningsAsErrors` | нет | Предупреждения считать ошибками |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-### Фоновое обновление (серверная база)
+> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
-
+
-| Параметр | Описание |
+### Фоновое обновление (серверная база)
-|----------|----------|
+
-| `-BackgroundStart` | Начать фоновое обновление |
+| Параметр | Описание |
-| `-BackgroundFinish` | Дождаться окончания |
+|----------|----------|
-| `-BackgroundCancel` | Отменить |
+| `-BackgroundStart` | Начать фоновое обновление |
-| `-BackgroundSuspend` | Приостановить |
+| `-BackgroundFinish` | Дождаться окончания |
-| `-BackgroundResume` | Возобновить |
+| `-BackgroundCancel` | Отменить |
-
+| `-BackgroundSuspend` | Приостановить |
-## Коды возврата
+| `-BackgroundResume` | Возобновить |
-
+
-| Код | Описание |
+## Предупреждения
-|-----|----------|
+
-| 0 | Успешно |
+- Если обновление **не динамическое** — потребуется **монопольный доступ** к базе (все пользователи должны выйти)
-| 1 | Ошибка (см. лог) |
+- Для серверных баз рекомендуется `-Dynamic+` для обновления без остановки
-
+- Если структура данных существенно изменилась (удаление реквизитов, изменение типов) — динамическое обновление может быть невозможно
-## Предупреждения
+
-
+## Примеры
-- Если обновление **не динамическое** — потребуется **монопольный доступ** к базе (все пользователи должны выйти)
+
-- Для серверных баз рекомендуется `-Dynamic+` для обновления без остановки
+```powershell
-- Если структура данных существенно изменилась (удаление реквизитов, изменение типов) — динамическое обновление может быть невозможно
+# Обычное обновление (файловая база)
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
-## Примеры
+
-
+# Динамическое обновление (серверная база)
-```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"
-# Обычное обновление (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+# Обновление расширения
-
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
-# Динамическое обновление (серверная база)
+```
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"
-
-# Обновление расширения
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
-```

.claude/skills/db-update/scripts/db-update.ps1

@@ -1,184 +1,515 @@
-# db-update v1.0 — Update 1C database configuration
+# db-update v1.13 — Update 1C database configuration
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Обновление конфигурации базы данных 1С
+.SYNOPSIS
-
+    Обновление конфигурации базы данных 1С
-.DESCRIPTION
+
-    Применяет изменения основной конфигурации к конфигурации базы данных.
+.DESCRIPTION
-    Поддерживает динамическое обновление, обновление расширений.
+    Применяет изменения основной конфигурации к конфигурации базы данных.
-
+    Поддерживает динамическое обновление, обновление расширений.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER Extension
+
-    Имя расширения для обновления
+.PARAMETER Extension
-
+    Имя расширения для обновления
-.PARAMETER AllExtensions
+
-    Обновить все расширения
+.PARAMETER AllExtensions
-
+    Обновить все расширения
-.PARAMETER Dynamic
+
-    Динамическое обновление: "+" включить, "-" отключить
+.PARAMETER Dynamic
-
+    Динамическое обновление: "+" включить, "-" отключить
-.PARAMETER Server
+
-    Обновление на стороне сервера
+.PARAMETER Server
-
+    Обновление на стороне сервера
-.PARAMETER WarningsAsErrors
+
-    Предупреждения считать ошибками
+.PARAMETER WarningsAsErrors
-
+    Предупреждения считать ошибками
-.EXAMPLE
+
-    .\db-update.ps1 -InfoBasePath "C:\Bases\MyDB"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -Dynamic "+" -Extension "МоёРасширение"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\db-update.ps1 -InfoBasePath "C:\Bases\MyDB"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -Dynamic "+" -Extension "МоёРасширение"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Extension,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$false)]
+
-    [switch]$AllExtensions,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Password,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("+", "-")]
+    [Parameter(Mandatory=$false)]
-    [string]$Dynamic,
+    [string]$Extension,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [switch]$Server,
+    [switch]$AllExtensions,
-
+
-    [Parameter(Mandatory=$false)]
+    [Parameter(Mandatory=$false)]
-    [switch]$WarningsAsErrors
+    [ValidateSet("+", "-")]
-)
+    [string]$Dynamic,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$false)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [switch]$Server,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$false)]
-if (-not $V8Path) {
+    [switch]$WarningsAsErrors,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Validate connection ---
+}
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+
-    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+function Get-ExitAnnotation {
-    exit 1
+    # Annotate an abnormal process exit code so a crash isn't reported as a bare number.
-}
+    # A batch DESIGNER that crashes (e.g. missing license) may leave the infobase locked or
-
+    # half-updated — surface that instead of a plain code. (Windows exception codes only;
-# --- Temp dir ---
+    # POSIX signals are handled in the .py port.)
-$tempDir = Join-Path $env:TEMP "db_update_$(Get-Random)"
+    param([int]$Code)
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    $win = @{
-
+        -1073741819 = "0xC0000005 (access violation)"
-try {
+        -1073741515 = "0xC0000135 (missing DLL)"
-    # --- Build arguments ---
+        -1073740791 = "0xC0000409 (stack overrun)"
-    $arguments = @("DESIGNER")
+    }
-
+    if ($win.ContainsKey($Code)) {
-    if ($InfoBaseServer -and $InfoBaseRef) {
+        return " — abnormal termination, exception $($win[$Code]); the infobase may be left in an inconsistent state; verify it before retrying"
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    }
-    } else {
+    return ""
-        $arguments += "/F", "`"$InfoBasePath`""
+}
-    }
+
-
+# --- Additional platform arguments ---
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+$script:V8OwnedKeys = @(
-    if ($Password) { $arguments += "/P`"$Password`"" }
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-    $arguments += "/UpdateDBCfg"
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-    # --- Options ---
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    if ($Dynamic) {
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-        $arguments += "-Dynamic$Dynamic"
+)
-    }
+$script:IbcmdOwnedKeys = @(
-    if ($Server) {
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-        $arguments += "-Server"
+    '--import', '--export', '--apply', '--force', '--create-database',
-    }
+    '--user', '--password'
-    if ($WarningsAsErrors) {
+)
-        $arguments += "-WarningsAsErrors"
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-    }
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-
+
-    # --- Extensions ---
+function Test-ArgKeyMatch {
-    if ($Extension) {
+    # A token matches a key when it equals the key, or starts with it and the next
-        $arguments += "-Extension", "`"$Extension`""
+    # character is not a letter — catches glued /N"user" and --password=x, while
-    } elseif ($AllExtensions) {
+    # keeping /ClearCache distinct from /C.
-        $arguments += "-AllExtensions"
+    param([string]$Token, [string]$Key)
-    }
+    if ($Token.Length -lt $Key.Length) { return $false }
-
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-    # --- Output ---
+    if ($Token.Length -eq $Key.Length) { return $true }
-    $outFile = Join-Path $tempDir "update_log.txt"
+    return -not [char]::IsLetter($Token[$Key.Length])
-    $arguments += "/Out", "`"$outFile`""
+}
-    $arguments += "/DisableStartupDialogs"
+
-
+function Get-ProjectExtraArgs {
-    # --- Execute ---
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    param([string]$Name)
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+    $dir = (Get-Location).Path
-    $exitCode = $process.ExitCode
+    while ($dir) {
-
+        $pf = Join-Path $dir ".v8-project.json"
-    # --- Result ---
+        if (Test-Path $pf) {
-    if ($exitCode -eq 0) {
+            try {
-        Write-Host "Database configuration updated successfully" -ForegroundColor Green
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-    } else {
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-        Write-Host "Error updating database configuration (code: $exitCode)" -ForegroundColor Red
+            } catch {}
-    }
+            return @()
-
+        }
-    if (Test-Path $outFile) {
+        $parent = Split-Path $dir -Parent
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if (-not $parent -or $parent -eq $dir) { break }
-        if ($logContent) {
+        $dir = $parent
-            Write-Host "--- Log ---"
+    }
-            Write-Host $logContent
+    return @()
-            Write-Host "--- End ---"
+}
-        }
+
-    }
+function Assert-ExtraArgs {
-
+    # The platform accepts only one batch operation, and a duplicate connection or
-    exit $exitCode
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-} finally {
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    if (Test-Path $tempDir) {
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    foreach ($tok in $ExtraArgs) {
-    }
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-}
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+# --- Validate connection ---
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+} elseif (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef" -ForegroundColor Red
+    exit 1
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "db_update_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch (file infobase only) ---
+        if ($AllExtensions) {
+            Write-Host "Error: ibcmd config apply does not support -AllExtensions (use -Extension)" -ForegroundColor Red
+            exit 1
+        }
+        $arguments = @("infobase", "config", "apply", "--db-path=$InfoBasePath", "--force")
+        if ($Dynamic -eq "+") { $arguments += "--dynamic=auto" }
+        elseif ($Dynamic -eq "-") { $arguments += "--dynamic=disable" }
+        if ($Extension) { $arguments += "--extension=$Extension" }
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        if ($exitCode -eq 0) {
+            Write-Host "Database configuration updated successfully" -ForegroundColor Green
+        } else {
+            Write-Host "Error updating database configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/UpdateDBCfg"
+
+    # --- Options ---
+    if ($Dynamic) {
+        $arguments += "-Dynamic$Dynamic"
+    }
+    if ($Server) {
+        $arguments += "-Server"
+    }
+    if ($WarningsAsErrors) {
+        $arguments += "-WarningsAsErrors"
+    }
+
+    # --- Extensions ---
+    if ($Extension) {
+        $arguments += "-Extension", "`"$Extension`""
+    } elseif ($AllExtensions) {
+        $arguments += "-AllExtensions"
+    }
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "update_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    if ($exitCode -eq 0) {
+        Write-Host "Database configuration updated successfully" -ForegroundColor Green
+    } else {
+        Write-Host "Error updating database configuration (code: $exitCode)$(Get-ExitAnnotation $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/db-update/scripts/db-update.py

@@ -1,35 +1,376 @@
 #!/usr/bin/env python3
-# db-update v1.0 — Update 1C database configuration
+# db-update v1.13 — Update 1C database configuration
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        found = sorted(glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe"))
+    while True:
-        if found:
+        pf = os.path.join(d, ".v8-project.json")
-            return found[-1]
+        if os.path.isfile(pf):
-        else:
+            try:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                with open(pf, encoding="utf-8-sig") as f:
-            sys.exit(1)
+                    data = json.load(f)
-    elif os.path.isdir(v8path):
+                v = data.get("v8path")
-        v8path = os.path.join(v8path, "1cv8.exe")
+                if v:
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
         sys.exit(1)
     return v8path
 
 
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
+        sys.exit(1)
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def describe_exit(code):
+    """Annotate an abnormal process exit code so a crash isn't reported as a bare number.
+    Batch 1C in a broken/headless environment (no GUI session, no license) can crash mid-run
+    instead of returning a clean error, possibly leaving the infobase locked or half-mutated."""
+    if code is None:
+        return ""
+    win = {
+        3221225477: "0xC0000005 (access violation)", -1073741819: "0xC0000005 (access violation)",
+        3221225781: "0xC0000135 (missing DLL)", -1073741515: "0xC0000135 (missing DLL)",
+        3221226505: "0xC0000409 (stack overrun)", -1073740791: "0xC0000409 (stack overrun)",
+    }
+    if code in win:
+        return f" — abnormal termination, exception {win[code]}; the infobase may be left in an inconsistent state; verify it before retrying"
+    if -64 <= code < 0:
+        try:
+            import signal
+            name = signal.Signals(-code).name
+        except (ValueError, AttributeError):
+            name = f"signal {-code}"
+        return (f" — process terminated by {name} (abnormal termination, not a normal exit); "
+                "the infobase may be left in an inconsistent state; verify it before retrying")
+    return ""
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -48,15 +389,71 @@ def main():
     parser.add_argument("-Dynamic", default="", choices=["", "+", "-"])
     parser.add_argument("-Server", action="store_true")
     parser.add_argument("-WarningsAsErrors", action="store_true")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
 
     v8path = resolve_v8path(args.V8Path)
 
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+
     # --- Validate connection ---
-    if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+    elif not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: specify -InfoBasePath or -InfoBaseServer + -InfoBaseRef", file=sys.stderr)
         sys.exit(1)
 
+    # --- ibcmd branch (file infobase only) ---
+    if engine == "ibcmd":
+        if args.AllExtensions:
+            print("Error: ibcmd config apply does not support -AllExtensions (use -Extension)", file=sys.stderr)
+            sys.exit(1)
+        arguments = ["infobase", "config", "apply", f"--db-path={args.InfoBasePath}", "--force"]
+        if args.Dynamic == "+":
+            arguments.append("--dynamic=auto")
+        elif args.Dynamic == "-":
+            arguments.append("--dynamic=disable")
+        if args.Extension:
+            arguments.append(f"--extension={args.Extension}")
+        ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+        atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+        if args.UserName:
+            arguments.append(f"--user={args.UserName}")
+        if args.Password:
+            arguments.append(f"--password={args.Password}")
+        arguments.append(f"--data={ib_data}")
+        arguments.extend(extra_args)
+        print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+        result = run_ibcmd([v8path] + arguments, bool(args.UserName))
+        if result.returncode == 0:
+            print("Database configuration updated successfully")
+        else:
+            print(f"Error updating database configuration (code: {result.returncode}){describe_exit(result.returncode)}", file=sys.stderr)
+        sys.exit(result.returncode)
+
     # --- Temp dir ---
     temp_dir = os.path.join(tempfile.gettempdir(), f"db_update_{random.randint(0, 999999)}")
     os.makedirs(temp_dir, exist_ok=True)
@@ -66,14 +463,14 @@ def main():
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments.extend(["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"])
+            arguments.extend(["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"'])
         else:
-            arguments.extend(["/F", args.InfoBasePath])
+            arguments.extend(["/F", f'"{args.InfoBasePath}"'])
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
         arguments.append("/UpdateDBCfg")
 
@@ -87,29 +484,26 @@ def main():
 
         # --- Extensions ---
         if args.Extension:
-            arguments.extend(["-Extension", args.Extension])
+            arguments.extend(["-Extension", f'"{args.Extension}"'])
         elif args.AllExtensions:
             arguments.append("-AllExtensions")
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "update_log.txt")
-        arguments.extend(["/Out", out_file])
+        arguments.extend(["/Out", f'"{out_file}"'])
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
         if exit_code == 0:
             print("Database configuration updated successfully")
         else:
-            print(f"Error updating database configuration (code: {exit_code})", file=sys.stderr)
+            print(f"Error updating database configuration (code: {exit_code}){describe_exit(exit_code)}", file=sys.stderr)
 
         if os.path.isfile(out_file):
             try:
@@ -122,6 +516,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/epf-bsp-add-command/SKILL.md

@@ -1,196 +1,196 @@
----
+---
-name: epf-bsp-add-command
+name: epf-bsp-add-command
-description: Определить команду в БСП‑описании обработки (`СведенияОВнешнейОбработке`) — открытие формы, вызов клиентского/серверного метода, заполнение объекта и т.п. Используй когда нужно зарегистрировать команду в дополнительной обработке БСП
+description: Определить команду в БСП‑описании обработки (`СведенияОВнешнейОбработке`) — открытие формы, вызов клиентского/серверного метода, заполнение объекта и т.п. Используй когда нужно зарегистрировать команду в дополнительной обработке БСП
-argument-hint: <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
+argument-hint: <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
-allowed-tools:
+allowed-tools:
-  - Read
+  - Read
-  - Edit
+  - Edit
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /epf-bsp-add-command — Добавление команды БСП
+# /epf-bsp-add-command — Добавление команды БСП
-
+
-Добавляет команду в существующую функцию `СведенияОВнешнейОбработке()` и генерирует соответствующий обработчик.
+Добавляет команду в существующую функцию `СведенияОВнешнейОбработке()` и генерирует соответствующий обработчик.
-
+
-Предварительно обработка должна быть инициализирована через `/epf-bsp-init`.
+Предварительно обработка должна быть инициализирована через `/epf-bsp-init`.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/epf-bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
+/epf-bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
-```
+```
-
+
-| Параметр      | Обязательный | По умолчанию          | Описание                                   |
+| Параметр      | Обязательный | По умолчанию          | Описание                                   |
-|---------------|:------------:|-----------------------|--------------------------------------------|
+|---------------|:------------:|-----------------------|--------------------------------------------|
-| ProcessorName | да           | —                     | Имя обработки                              |
+| ProcessorName | да           | —                     | Имя обработки                              |
-| Идентификатор | да           | —                     | Внутреннее имя команды (латиница)          |
+| Идентификатор | да           | —                     | Внутреннее имя команды (латиница)          |
-| ТипКоманды    | нет          | из вида обработки     | Тип запуска команды (см. маппинг ниже)     |
+| ТипКоманды    | нет          | из вида обработки     | Тип запуска команды (см. маппинг ниже)     |
-| Представление | нет          | = Идентификатор       | Отображаемое имя команды для пользователя  |
+| Представление | нет          | = Идентификатор       | Отображаемое имя команды для пользователя  |
-| SrcDir        | нет          | `src`                 | Каталог исходников                         |
+| SrcDir        | нет          | `src`                 | Каталог исходников                         |
-
+
-## Маппинг типов команд
+## Маппинг типов команд
-
+
-Пользователь может указать тип в свободной форме:
+Пользователь может указать тип в свободной форме:
-
+
-| Пользователь пишет                    | ТипКоманды                                          |
+| Пользователь пишет                    | ТипКоманды                                          |
-|---------------------------------------|-----------------------------------------------------|
+|---------------------------------------|-----------------------------------------------------|
-| открыть форму, форма                  | `ТипКомандыОткрытиеФормы()`                         |
+| открыть форму, форма                  | `ТипКомандыОткрытиеФормы()`                         |
-| клиентский метод, на клиенте          | `ТипКомандыВызовКлиентскогоМетода()`                |
+| клиентский метод, на клиенте          | `ТипКомандыВызовКлиентскогоМетода()`                |
-| серверный метод, на сервере           | `ТипКомандыВызовСерверногоМетода()`                 |
+| серверный метод, на сервере           | `ТипКомандыВызовСерверногоМетода()`                 |
-| заполнение формы, заполнить форму     | `ТипКомандыЗаполнениеФормы()`                       |
+| заполнение формы, заполнить форму     | `ТипКомандыЗаполнениеФормы()`                       |
-| сценарий, безопасный режим            | `ТипКомандыСценарийВБезопасномРежиме()`             |
+| сценарий, безопасный режим            | `ТипКомандыСценарийВБезопасномРежиме()`             |
-
+
-Если пользователь не указал тип — определи по виду обработки из существующего кода `СведенияОВнешнейОбработке()`:
+Если пользователь не указал тип — определи по виду обработки из существующего кода `СведенияОВнешнейОбработке()`:
-
+
-| Вид обработки (из кода)    | ТипКоманды по умолчанию                   |
+| Вид обработки (из кода)    | ТипКоманды по умолчанию                   |
-|----------------------------|-------------------------------------------|
+|----------------------------|-------------------------------------------|
-| ДополнительнаяОбработка    | `ТипКомандыОткрытиеФормы()`               |
+| ДополнительнаяОбработка    | `ТипКомандыОткрытиеФормы()`               |
-| ДополнительныйОтчет       | `ТипКомандыОткрытиеФормы()`               |
+| ДополнительныйОтчет       | `ТипКомандыОткрытиеФормы()`               |
-| ЗаполнениеОбъекта          | `ТипКомандыВызовСерверногоМетода()`        |
+| ЗаполнениеОбъекта          | `ТипКомандыВызовСерверногоМетода()`        |
-| Отчет                      | `ТипКомандыОткрытиеФормы()`               |
+| Отчет                      | `ТипКомандыОткрытиеФормы()`               |
-| ПечатнаяФорма              | `ТипКомандыВызовСерверногоМетода()`        |
+| ПечатнаяФорма              | `ТипКомандыВызовСерверногоМетода()`        |
-| СозданиеСвязанныхОбъектов  | `ТипКомандыВызовСерверногоМетода()`        |
+| СозданиеСвязанныхОбъектов  | `ТипКомандыВызовСерверногоМетода()`        |
-
+
-## Шаблон добавления команды
+## Шаблон добавления команды
-
+
-Вставляется в `СведенияОВнешнейОбработке()` **перед** строкой `Возврат ПараметрыРегистрации`:
+Вставляется в `СведенияОВнешнейОбработке()` **перед** строкой `Возврат ПараметрыРегистрации`:
-
+
-```bsl
+```bsl
-	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
+	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
-	НоваяКоманда.Представление        = НСтр("ru = '{{Представление}}'");
+	НоваяКоманда.Представление        = НСтр("ru = '{{Представление}}'");
-	НоваяКоманда.Идентификатор        = "{{Идентификатор}}";
+	НоваяКоманда.Идентификатор        = "{{Идентификатор}}";
-	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
+	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
-	НоваяКоманда.ПоказыватьОповещение = Ложь;
+	НоваяКоманда.ПоказыватьОповещение = Ложь;
-```
+```
-
+
-Для печатных форм (ВидОбработкиПечатнаяФорма) добавь также:
+Для печатных форм (ВидОбработкиПечатнаяФорма) добавь также:
-
+
-```bsl
+```bsl
-	НоваяКоманда.Модификатор = "ПечатьMXL";
+	НоваяКоманда.Модификатор = "ПечатьMXL";
-```
+```
-
+
-Примечание: в отличие от первой команды (из `/epf-bsp-init`), дополнительные команды используют строковые литералы `НСтр("ru = '...'")` для представления и строку для идентификатора, а не `Метаданные()`.
+Примечание: в отличие от первой команды (из `/epf-bsp-init`), дополнительные команды используют строковые литералы `НСтр("ru = '...'")` для представления и строку для идентификатора, а не `Метаданные()`.
-
+
-## Шаблоны обработчиков
+## Шаблоны обработчиков
-
+
-### ВызовСерверногоМетода — если обработчик уже есть
+### ВызовСерверногоМетода — если обработчик уже есть
-
+
-Если процедура `ВыполнитьКоманду` уже существует в модуле объекта, добавь ветку перед `КонецЕсли`:
+Если процедура `ВыполнитьКоманду` уже существует в модуле объекта, добавь ветку перед `КонецЕсли`:
-
+
-```bsl
+```bsl
-	ИначеЕсли ИдентификаторКоманды = "{{Идентификатор}}" Тогда
+	ИначеЕсли ИдентификаторКоманды = "{{Идентификатор}}" Тогда
-		// TODO: Реализация {{Идентификатор}}
+		// TODO: Реализация {{Идентификатор}}
-```
+```
-
+
-### ВызовСерверногоМетода — если обработчика нет
+### ВызовСерверногоМетода — если обработчика нет
-
+
-Для глобальных обработок (без `ОбъектыНазначения`):
+Для глобальных обработок (без `ОбъектыНазначения`):
-
+
-```bsl
+```bsl
-Процедура ВыполнитьКоманду(ИдентификаторКоманды, ПараметрыВыполненияКоманды) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды, ПараметрыВыполненияКоманды) Экспорт
-
+
-	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
+	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
-		// TODO: Реализация {{Идентификатор}}
+		// TODO: Реализация {{Идентификатор}}
-	КонецЕсли;
+	КонецЕсли;
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-Для назначаемых обработок (с `ОбъектыНазначения`):
+Для назначаемых обработок (с `ОбъектыНазначения`):
-
+
-```bsl
+```bsl
-Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыВыполненияКоманды) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыВыполненияКоманды) Экспорт
-
+
-	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
+	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
-		// TODO: Реализация {{Идентификатор}}
+		// TODO: Реализация {{Идентификатор}}
-	КонецЕсли;
+	КонецЕсли;
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-### ПечатнаяФорма — если процедура Печать уже есть
+### ПечатнаяФорма — если процедура Печать уже есть
-
+
-Добавь блок перед `КонецПроцедуры`:
+Добавь блок перед `КонецПроцедуры`:
-
+
-```bsl
+```bsl
-	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
+	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
-	Если ПечатнаяФорма <> Неопределено Тогда
+	Если ПечатнаяФорма <> Неопределено Тогда
-		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
+		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
-		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
+		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
-	КонецЕсли;
+	КонецЕсли;
-```
+```
-
+
-### ПечатнаяФорма — если процедуры Печать нет
+### ПечатнаяФорма — если процедуры Печать нет
-
+
-```bsl
+```bsl
-Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
+Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
-
+
-	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
+	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
-	Если ПечатнаяФорма <> Неопределено Тогда
+	Если ПечатнаяФорма <> Неопределено Тогда
-		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
+		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
-		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
+		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
-	КонецЕсли;
+	КонецЕсли;
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-### ВызовКлиентскогоМетода
+### ВызовКлиентскогоМетода
-
+
-Добавляется в **модуль формы** (`Forms/<FormName>/Ext/Form/Module.bsl`):
+Добавляется в **модуль формы** (`Forms/<FormName>/Ext/Form/Module.bsl`):
-
+
-Для глобальных обработок:
+Для глобальных обработок:
-
+
-```bsl
+```bsl
-&НаКлиенте
+&НаКлиенте
-Процедура ВыполнитьКоманду(ИдентификаторКоманды) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды) Экспорт
-
+
-	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
+	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
-		// TODO: Реализация {{Идентификатор}}
+		// TODO: Реализация {{Идентификатор}}
-	КонецЕсли;
+	КонецЕсли;
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-Для назначаемых обработок:
+Для назначаемых обработок:
-
+
-```bsl
+```bsl
-&НаКлиенте
+&НаКлиенте
-Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначенияМассив) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначенияМассив) Экспорт
-
+
-	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
+	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
-		// TODO: Реализация {{Идентификатор}}
+		// TODO: Реализация {{Идентификатор}}
-	КонецЕсли;
+	КонецЕсли;
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-Если процедура уже есть — добавь ветку `ИначеЕсли`.
+Если процедура уже есть — добавь ветку `ИначеЕсли`.
-
+
-## Инструкции
+## Инструкции
-
+
-1. Найди и прочитай `ObjectModule.bsl` через Glob: `src/{{ProcessorName}}/Ext/ObjectModule.bsl`
+1. Найди и прочитай `ObjectModule.bsl` через Glob: `src/{{ProcessorName}}/Ext/ObjectModule.bsl`
-2. Убедись что `СведенияОВнешнейОбработке()` существует. Если нет — предложи вызвать `/epf-bsp-init`
+2. Убедись что `СведенияОВнешнейОбработке()` существует. Если нет — предложи вызвать `/epf-bsp-init`
-3. Определи вид обработки из существующего кода (найди строку с `ВидОбработки...()`)
+3. Определи вид обработки из существующего кода (найди строку с `ВидОбработки...()`)
-4. Вставь блок команды **перед** `Возврат ПараметрыРегистрации`
+4. Вставь блок команды **перед** `Возврат ПараметрыРегистрации`
-5. Добавь обработчик:
+5. Добавь обработчик:
-   - Для серверных обработчиков — в `ObjectModule.bsl`, область `ПрограммныйИнтерфейс`
+   - Для серверных обработчиков — в `ObjectModule.bsl`, область `ПрограммныйИнтерфейс`
-   - Для клиентских обработчиков — в модуль формы (найти через Glob: `src/{{ProcessorName}}/Forms/*/Ext/Form/Module.bsl`)
+   - Для клиентских обработчиков — в модуль формы (найти через Glob: `src/{{ProcessorName}}/Forms/*/Ext/Form/Module.bsl`)
-6. Если обработчик (`ВыполнитьКоманду` / `Печать`) уже есть — добавь ветку, не создавай дубль процедуры
+6. Если обработчик (`ВыполнитьКоманду` / `Печать`) уже есть — добавь ветку, не создавай дубль процедуры
-7. Используй табы для отступов
+7. Используй табы для отступов
-
+
-## Пример
+## Пример
-
+
-Пользователь: `/epf-bsp-add-command МояОбработка ЗаказПокупателя серверный "Заказ покупателя"`
+Пользователь: `/epf-bsp-add-command МояОбработка ЗаказПокупателя серверный "Заказ покупателя"`
-
+
-В `СведенияОВнешнейОбработке()` перед `Возврат` добавится:
+В `СведенияОВнешнейОбработке()` перед `Возврат` добавится:
-
+
-```bsl
+```bsl
-	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
+	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
-	НоваяКоманда.Представление        = НСтр("ru = 'Заказ покупателя'");
+	НоваяКоманда.Представление        = НСтр("ru = 'Заказ покупателя'");
-	НоваяКоманда.Идентификатор        = "ЗаказПокупателя";
+	НоваяКоманда.Идентификатор        = "ЗаказПокупателя";
-	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
+	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
-	НоваяКоманда.ПоказыватьОповещение = Ложь;
+	НоваяКоманда.ПоказыватьОповещение = Ложь;
-```
+```
-
+
-И в существующую процедуру `ВыполнитьКоманду` добавится блок обработки.
+И в существующую процедуру `ВыполнитьКоманду` добавится блок обработки.

.claude/skills/epf-bsp-init/SKILL.md

@@ -1,208 +1,208 @@
----
+---
-name: epf-bsp-init
+name: epf-bsp-init
-description: Сформировать функцию `СведенияОВнешнейОбработке` в модуле объекта обработки — описание для подключения через подсистему БСП «Дополнительные отчёты и обработки». Используй когда нужно сделать обработку совместимой с БСП, подключаемой через «Дополнительные отчёты и обработки»
+description: Сформировать функцию `СведенияОВнешнейОбработке` в модуле объекта обработки — описание для подключения через подсистему БСП «Дополнительные отчёты и обработки». Используй когда нужно сделать обработку совместимой с БСП, подключаемой через «Дополнительные отчёты и обработки»
-argument-hint: <ProcessorName> <Вид>
+argument-hint: <ProcessorName> <Вид>
-allowed-tools:
+allowed-tools:
-  - Read
+  - Read
-  - Edit
+  - Edit
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /epf-bsp-init — Регистрация обработки в БСП
+# /epf-bsp-init — Регистрация обработки в БСП
-
+
-Добавляет в модуль объекта обработки функцию `СведенияОВнешнейОбработке()`, необходимую для регистрации в подсистеме «Дополнительные отчёты и обработки» БСП.
+Добавляет в модуль объекта обработки функцию `СведенияОВнешнейОбработке()`, необходимую для регистрации в подсистеме «Дополнительные отчёты и обработки» БСП.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/epf-bsp-init <ProcessorName> <Вид> [Назначение...]
+/epf-bsp-init <ProcessorName> <Вид> [Назначение...]
-```
+```
-
+
-| Параметр      | Обязательный | По умолчанию | Описание                                                |
+| Параметр      | Обязательный | По умолчанию | Описание                                                |
-|---------------|:------------:|--------------|---------------------------------------------------------|
+|---------------|:------------:|--------------|---------------------------------------------------------|
-| ProcessorName | да           | —            | Имя обработки (должна быть создана через `/epf-init`)   |
+| ProcessorName | да           | —            | Имя обработки (должна быть создана через `/epf-init`)   |
-| Вид           | да           | —            | Вид обработки (см. маппинг ниже)                        |
+| Вид           | да           | —            | Вид обработки (см. маппинг ниже)                        |
-| Назначение    | *            | —            | Объекты метаданных для назначаемых видов                 |
+| Назначение    | *            | —            | Объекты метаданных для назначаемых видов                 |
-| SrcDir        | нет          | `src`        | Каталог исходников                                      |
+| SrcDir        | нет          | `src`        | Каталог исходников                                      |
-
+
-\* Назначение обязательно для видов: ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов.
+\* Назначение обязательно для видов: ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов.
-
+
-## Маппинг вида обработки
+## Маппинг вида обработки
-
+
-Пользователь может указать вид в свободной форме. Определи нужный по контексту:
+Пользователь может указать вид в свободной форме. Определи нужный по контексту:
-
+
-| Пользователь пишет                        | Вид                        | API-метод                                    |
+| Пользователь пишет                        | Вид                        | API-метод                                    |
-|-------------------------------------------|----------------------------|----------------------------------------------|
+|-------------------------------------------|----------------------------|----------------------------------------------|
-| доп обработка, обработка, глобальная      | ДополнительнаяОбработка    | `ВидОбработкиДополнительнаяОбработка()`      |
+| доп обработка, обработка, глобальная      | ДополнительнаяОбработка    | `ВидОбработкиДополнительнаяОбработка()`      |
-| доп отчёт, глобальный отчёт              | ДополнительныйОтчет       | `ВидОбработкиДополнительныйОтчет()`         |
+| доп отчёт, глобальный отчёт              | ДополнительныйОтчет       | `ВидОбработкиДополнительныйОтчет()`         |
-| заполнение, заполнить                     | ЗаполнениеОбъекта          | `ВидОбработкиЗаполнениеОбъекта()`            |
+| заполнение, заполнить                     | ЗаполнениеОбъекта          | `ВидОбработкиЗаполнениеОбъекта()`            |
-| отчёт (назначаемый, для объекта)          | Отчет                      | `ВидОбработкиОтчет()`                        |
+| отчёт (назначаемый, для объекта)          | Отчет                      | `ВидОбработкиОтчет()`                        |
-| печатная форма, печать                    | ПечатнаяФорма              | `ВидОбработкиПечатнаяФорма()`                |
+| печатная форма, печать                    | ПечатнаяФорма              | `ВидОбработкиПечатнаяФорма()`                |
-| создание связанных объектов               | СозданиеСвязанныхОбъектов  | `ВидОбработкиСозданиеСвязанныхОбъектов()`    |
+| создание связанных объектов               | СозданиеСвязанныхОбъектов  | `ВидОбработкиСозданиеСвязанныхОбъектов()`    |
-
+
-## Тип команды по умолчанию
+## Тип команды по умолчанию
-
+
-| Вид                        | ТипКоманды по умолчанию                   |
+| Вид                        | ТипКоманды по умолчанию                   |
-|----------------------------|-------------------------------------------|
+|----------------------------|-------------------------------------------|
-| ДополнительнаяОбработка    | `ТипКомандыОткрытиеФормы()`               |
+| ДополнительнаяОбработка    | `ТипКомандыОткрытиеФормы()`               |
-| ДополнительныйОтчет       | `ТипКомандыОткрытиеФормы()`               |
+| ДополнительныйОтчет       | `ТипКомандыОткрытиеФормы()`               |
-| ЗаполнениеОбъекта          | `ТипКомандыВызовСерверногоМетода()`        |
+| ЗаполнениеОбъекта          | `ТипКомандыВызовСерверногоМетода()`        |
-| Отчет                      | `ТипКомандыОткрытиеФормы()`               |
+| Отчет                      | `ТипКомандыОткрытиеФормы()`               |
-| ПечатнаяФорма              | `ТипКомандыВызовСерверногоМетода()`        |
+| ПечатнаяФорма              | `ТипКомандыВызовСерверногоМетода()`        |
-| СозданиеСвязанныхОбъектов  | `ТипКомандыВызовСерверногоМетода()`        |
+| СозданиеСвязанныхОбъектов  | `ТипКомандыВызовСерверногоМетода()`        |
-
+
-## Шаблон: СведенияОВнешнейОбработке
+## Шаблон: СведенияОВнешнейОбработке
-
+
-Базовый шаблон — одинаковый для всех видов, отличаются только вызовы API-методов и условные секции.
+Базовый шаблон — одинаковый для всех видов, отличаются только вызовы API-методов и условные секции.
-
+
-```bsl
+```bsl
-Функция СведенияОВнешнейОбработке() Экспорт
+Функция СведенияОВнешнейОбработке() Экспорт
-
+
-	МетаданныеОбработки = Метаданные();
+	МетаданныеОбработки = Метаданные();
-
+
-	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
+	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
-	ПараметрыРегистрации.Вид    = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ВидОбработки}};
+	ПараметрыРегистрации.Вид    = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ВидОбработки}};
-	ПараметрыРегистрации.Версия = "1.0";
+	ПараметрыРегистрации.Версия = "1.0";
-
+
-	{{СЕКЦИЯ_НАЗНАЧЕНИЕ}}
+	{{СЕКЦИЯ_НАЗНАЧЕНИЕ}}
-
+
-	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
+	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
-	НоваяКоманда.Представление        = МетаданныеОбработки.Представление();
+	НоваяКоманда.Представление        = МетаданныеОбработки.Представление();
-	НоваяКоманда.Идентификатор        = МетаданныеОбработки.Имя;
+	НоваяКоманда.Идентификатор        = МетаданныеОбработки.Имя;
-	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
+	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
-	НоваяКоманда.ПоказыватьОповещение = Ложь;
+	НоваяКоманда.ПоказыватьОповещение = Ложь;
-	{{СЕКЦИЯ_МОДИФИКАТОР}}
+	{{СЕКЦИЯ_МОДИФИКАТОР}}
-
+
-	Возврат ПараметрыРегистрации;
+	Возврат ПараметрыРегистрации;
-
+
-КонецФункции
+КонецФункции
-```
+```
-
+
-### Подстановки
+### Подстановки
-
+
-- `{{ВидОбработки}}` — API-метод из таблицы маппинга вида
+- `{{ВидОбработки}}` — API-метод из таблицы маппинга вида
-- `{{ТипКоманды}}` — API-метод из таблицы типа команды по умолчанию
+- `{{ТипКоманды}}` — API-метод из таблицы типа команды по умолчанию
-
+
-### Условные секции
+### Условные секции
-
+
-**`{{СЕКЦИЯ_НАЗНАЧЕНИЕ}}`** — только для назначаемых видов (ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов). Одна строка на каждый объект:
+**`{{СЕКЦИЯ_НАЗНАЧЕНИЕ}}`** — только для назначаемых видов (ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов). Одна строка на каждый объект:
-
+
-```bsl
+```bsl
-	ПараметрыРегистрации.Назначение.Добавить("Документ.СчетНаОплату");
+	ПараметрыРегистрации.Назначение.Добавить("Документ.СчетНаОплату");
-```
+```
-
+
-Формат имени объекта: `ИмяКлассаОбъектаМетаданного.ИмяОбъекта` (например `Документ.СчетНаОплату`, `Справочник.Контрагенты`).
+Формат имени объекта: `ИмяКлассаОбъектаМетаданного.ИмяОбъекта` (например `Документ.СчетНаОплату`, `Справочник.Контрагенты`).
-
+
-Для глобальных видов (ДополнительнаяОбработка, ДополнительныйОтчет) — секция не нужна, удалить вместе с пустой строкой.
+Для глобальных видов (ДополнительнаяОбработка, ДополнительныйОтчет) — секция не нужна, удалить вместе с пустой строкой.
-
+
-**`{{СЕКЦИЯ_МОДИФИКАТОР}}`** — только для ПечатнаяФорма:
+**`{{СЕКЦИЯ_МОДИФИКАТОР}}`** — только для ПечатнаяФорма:
-
+
-```bsl
+```bsl
-	НоваяКоманда.Модификатор = "ПечатьMXL";
+	НоваяКоманда.Модификатор = "ПечатьMXL";
-```
+```
-
+
-Для остальных видов — удалить вместе с пустой строкой.
+Для остальных видов — удалить вместе с пустой строкой.
-
+
-## Шаблоны серверных обработчиков
+## Шаблоны серверных обработчиков
-
+
-Для видов с типом команды `ВызовСерверногоМетода` добавь соответствующую процедуру-обработчик в ту же область `ПрограммныйИнтерфейс`, после `СведенияОВнешнейОбработке`.
+Для видов с типом команды `ВызовСерверногоМетода` добавь соответствующую процедуру-обработчик в ту же область `ПрограммныйИнтерфейс`, после `СведенияОВнешнейОбработке`.
-
+
-### Для ЗаполнениеОбъекта / СозданиеСвязанныхОбъектов
+### Для ЗаполнениеОбъекта / СозданиеСвязанныхОбъектов
-
+
-```bsl
+```bsl
-Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыВыполненияКоманды) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыВыполненияКоманды) Экспорт
-
+
-	// TODO: Реализация
+	// TODO: Реализация
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-### Для ПечатнаяФорма
+### Для ПечатнаяФорма
-
+
-```bsl
+```bsl
-Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
+Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
-
+
-	// TODO: Реализация
+	// TODO: Реализация
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-### Для ДополнительнаяОбработка / ДополнительныйОтчет (с ВызовСерверногоМетода)
+### Для ДополнительнаяОбработка / ДополнительныйОтчет (с ВызовСерверногоМетода)
-
+
-Если пользователь явно выбрал серверный метод вместо открытия формы:
+Если пользователь явно выбрал серверный метод вместо открытия формы:
-
+
-```bsl
+```bsl
-Процедура ВыполнитьКоманду(ИдентификаторКоманды, ПараметрыВыполненияКоманды) Экспорт
+Процедура ВыполнитьКоманду(ИдентификаторКоманды, ПараметрыВыполненияКоманды) Экспорт
-
+
-	// TODO: Реализация
+	// TODO: Реализация
-
+
-КонецПроцедуры
+КонецПроцедуры
-```
+```
-
+
-Обрати внимание: у глобальных обработок нет параметра `ОбъектыНазначения`.
+Обрати внимание: у глобальных обработок нет параметра `ОбъектыНазначения`.
-
+
-## Инструкции
+## Инструкции
-
+
-1. Найди `ObjectModule.bsl` через Glob: `src/{{ProcessorName}}/Ext/ObjectModule.bsl`
+1. Найди `ObjectModule.bsl` через Glob: `src/{{ProcessorName}}/Ext/ObjectModule.bsl`
-2. Прочитай файл
+2. Прочитай файл
-3. Если `СведенияОВнешнейОбработке` уже есть — сообщи пользователю и не дублируй
+3. Если `СведенияОВнешнейОбработке` уже есть — сообщи пользователю и не дублируй
-4. Если файл не найден — предложи сначала вызвать `/epf-init`
+4. Если файл не найден — предложи сначала вызвать `/epf-init`
-5. Найди область `#Область ПрограммныйИнтерфейс` ... `#КонецОбласти`
+5. Найди область `#Область ПрограммныйИнтерфейс` ... `#КонецОбласти`
-6. Вставь функцию `СведенияОВнешнейОбработке()` внутрь этой области
+6. Вставь функцию `СведенияОВнешнейОбработке()` внутрь этой области
-7. Если вид требует серверный обработчик — вставь его тоже в эту область, после функции
+7. Если вид требует серверный обработчик — вставь его тоже в эту область, после функции
-8. Используй табы для отступов (как в исходном файле)
+8. Используй табы для отступов (как в исходном файле)
-
+
-## Пример
+## Пример
-
+
-Пользователь: `/epf-bsp-init МояОбработка печатная форма для Документ.СчетНаОплату`
+Пользователь: `/epf-bsp-init МояОбработка печатная форма для Документ.СчетНаОплату`
-
+
-Результат в `ObjectModule.bsl`:
+Результат в `ObjectModule.bsl`:
-
+
-```bsl
+```bsl
-#Область ОписаниеПеременных
+#Область ОписаниеПеременных
-
+
-#КонецОбласти
+#КонецОбласти
-
+
-#Область ПрограммныйИнтерфейс
+#Область ПрограммныйИнтерфейс
-
+
-Функция СведенияОВнешнейОбработке() Экспорт
+Функция СведенияОВнешнейОбработке() Экспорт
-
+
-	МетаданныеОбработки = Метаданные();
+	МетаданныеОбработки = Метаданные();
-
+
-	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
+	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
-	ПараметрыРегистрации.Вид    = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиПечатнаяФорма();
+	ПараметрыРегистрации.Вид    = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиПечатнаяФорма();
-	ПараметрыРегистрации.Версия = "1.0";
+	ПараметрыРегистрации.Версия = "1.0";
-
+
-	ПараметрыРегистрации.Назначение.Добавить("Документ.СчетНаОплату");
+	ПараметрыРегистрации.Назначение.Добавить("Документ.СчетНаОплату");
-
+
-	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
+	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
-	НоваяКоманда.Представление        = МетаданныеОбработки.Представление();
+	НоваяКоманда.Представление        = МетаданныеОбработки.Представление();
-	НоваяКоманда.Идентификатор        = МетаданныеОбработки.Имя;
+	НоваяКоманда.Идентификатор        = МетаданныеОбработки.Имя;
-	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
+	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
-	НоваяКоманда.ПоказыватьОповещение = Ложь;
+	НоваяКоманда.ПоказыватьОповещение = Ложь;
-	НоваяКоманда.Модификатор = "ПечатьMXL";
+	НоваяКоманда.Модификатор = "ПечатьMXL";
-
+
-	Возврат ПараметрыРегистрации;
+	Возврат ПараметрыРегистрации;
-
+
-КонецФункции
+КонецФункции
-
+
-Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
+Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
-
+
-	// TODO: Реализация
+	// TODO: Реализация
-
+
-КонецПроцедуры
+КонецПроцедуры
-
+
-#КонецОбласти
+#КонецОбласти
-
+
-#Область СлужебныеПроцедурыИФункции
+#Область СлужебныеПроцедурыИФункции
-
+
-#КонецОбласти
+#КонецОбласти
-```
+```
-
+
-## Дальнейшие шаги
+## Дальнейшие шаги
-
+
-- Добавить ещё команду: `/epf-bsp-add-command`
+- Добавить ещё команду: `/epf-bsp-add-command`
-- Добавить форму: `/form-add`
+- Добавить форму: `/form-add`
-- Добавить макет: `/template-add`
+- Добавить макет: `/template-add`
-- Собрать EPF: `/epf-build`
+- Собрать EPF: `/epf-build`

.claude/skills/epf-build/SKILL.md

@@ -1,69 +1,71 @@
----
+---
-name: epf-build
+name: epf-build
-description: Собрать внешнюю обработку 1С (EPF/ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать обработку или получить EPF/ERF файл из исходников
+description: Собрать внешнюю обработку 1С (EPF/ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать обработку или получить EPF/ERF файл из исходников
-argument-hint: <ProcessorName>
+argument-hint: <ProcessorName>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /epf-build — Сборка обработки
+# /epf-build — Сборка обработки
-
+
-## Usage
+## Usage
-
+
-```
+```
-/epf-build <ProcessorName> [SrcDir] [OutDir]
+/epf-build <ProcessorName> [SrcDir] [OutDir]
-```
+```
-
+
-| Параметр      | Обязательный | По умолчанию | Описание                             |
+| Параметр      | Обязательный | По умолчанию | Описание                             |
-|---------------|:------------:|--------------|--------------------------------------|
+|---------------|:------------:|--------------|--------------------------------------|
-| ProcessorName | да           | —            | Имя обработки (имя корневого XML)    |
+| ProcessorName | да           | —            | Имя обработки (имя корневого XML)    |
-| SrcDir        | нет          | `src`        | Каталог исходников                   |
+| SrcDir        | нет          | `src`        | Каталог исходников                   |
-| OutDir        | нет          | `build`      | Каталог для результата               |
+| OutDir        | нет          | `build`      | Каталог для результата               |
-
+
-## Параметры подключения (опционально)
+## Параметры подключения (опционально)
-
+
-Предпочтительно использовать конкретную базу — это надёжнее и не требует создания временной базы.
+Предпочтительно использовать конкретную базу — это надёжнее и не требует создания временной базы.
-
+
-1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
+1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
-2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-5. Если ветка не совпала — используй `default`
+5. Если ветка не совпала — используй `default`
-6. Если `.v8-project.json` нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для EPF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
+6. Если `.v8-project.json` нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для EPF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
-
+
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-SourceFile <путь>` | да | Путь к корневому XML-файлу исходников |
+| `-SourceFile <путь>` | да | Путь к корневому XML-файлу исходников |
-| `-OutputFile <путь>` | да | Путь к выходному EPF/ERF-файлу |
+| `-OutputFile <путь>` | да | Путь к выходному EPF/ERF-файлу |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Примеры
+> `*` — опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
-
+
-```powershell
+## Примеры
-# Сборка обработки (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+```powershell
-
+# Сборка обработки (файловая база)
-# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+
-```
+# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+```

.claude/skills/epf-build/scripts/epf-build.ps1

@@ -1,173 +1,510 @@
-# epf-build v1.0 — Build external data processor or report (EPF/ERF) from XML sources
+# epf-build v1.12 — Build external data processor or report (EPF/ERF) from XML sources
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Сборка внешней обработки/отчёта 1С из XML-исходников
+.SYNOPSIS
-
+    Сборка внешней обработки/отчёта 1С из XML-исходников
-.DESCRIPTION
+
-    Собирает EPF/ERF-файл из XML-исходников с помощью платформы 1С.
+.DESCRIPTION
-    Общий скрипт для epf-build и erf-build.
+    Собирает EPF/ERF-файл из XML-исходников с помощью платформы 1С.
-
+    Общий скрипт для epf-build и erf-build.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER SourceFile
+
-    Путь к корневому XML-файлу исходников
+.PARAMETER SourceFile
-
+    Путь к корневому XML-файлу исходников
-.PARAMETER OutputFile
+
-    Путь к выходному EPF/ERF-файлу
+.PARAMETER OutputFile
-
+    Путь к выходному EPF/ERF-файлу
-.EXAMPLE
+
-    .\epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src\МояОбработка.xml" -OutputFile "build\МояОбработка.epf"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src\МойОтчёт.xml" -OutputFile "build\МойОтчёт.erf"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src\МояОбработка.xml" -OutputFile "build\МояОбработка.epf"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src\МойОтчёт.xml" -OutputFile "build\МойОтчёт.erf"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$SourceFile,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$true)]
+
-    [string]$OutputFile
+    [Parameter(Mandatory=$false)]
-)
+    [string]$Password,
-
+
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [Parameter(Mandatory=$true)]
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [string]$SourceFile,
-
+
-# --- Resolve V8Path ---
+    [Parameter(Mandatory=$true)]
-if (-not $V8Path) {
+    [string]$OutputFile,
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+function Protect-Secrets {
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
-    exit 1
+    param([string]$Text, [string[]]$Secrets)
-}
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
-
+    return $Text
-# --- Auto-create stub database if no connection specified ---
+}
-$autoCreatedBase = $null
+
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+# --- Additional platform arguments ---
-    $sourceDir = Split-Path $SourceFile -Parent
+$script:V8OwnedKeys = @(
-    $autoBasePath = Join-Path $env:TEMP "epf_stub_db_$(Get-Random)"
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-    $stubScript = Join-Path $PSScriptRoot "stub-db-create.ps1"
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-    Write-Host "No database specified. Creating temporary stub database..."
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-    $stubArgs = "-SourceDir `"$sourceDir`" -V8Path `"$V8Path`" -TempBasePath `"$autoBasePath`""
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-    $stubProc = Start-Process -FilePath "powershell.exe" -ArgumentList "-NoProfile -File `"$stubScript`" $stubArgs" -NoNewWindow -Wait -PassThru
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    if ($stubProc.ExitCode -ne 0) {
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-        Write-Host "Error: failed to create stub database" -ForegroundColor Red
+)
-        exit 1
+$script:IbcmdOwnedKeys = @(
-    }
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-    $InfoBasePath = $autoBasePath
+    '--import', '--export', '--apply', '--force', '--create-database',
-    $autoCreatedBase = $autoBasePath
+    '--user', '--password'
-}
+)
-
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-# --- Validate source file ---
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-if (-not (Test-Path $SourceFile)) {
+
-    Write-Host "Error: source file not found: $SourceFile" -ForegroundColor Red
+function Test-ArgKeyMatch {
-    exit 1
+    # A token matches a key when it equals the key, or starts with it and the next
-}
+    # character is not a letter — catches glued /N"user" and --password=x, while
-
+    # keeping /ClearCache distinct from /C.
-# --- Ensure output directory exists ---
+    param([string]$Token, [string]$Key)
-$outDir = Split-Path $OutputFile -Parent
+    if ($Token.Length -lt $Key.Length) { return $false }
-if ($outDir -and -not (Test-Path $outDir)) {
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-    New-Item -ItemType Directory -Path $outDir -Force | Out-Null
+    if ($Token.Length -eq $Key.Length) { return $true }
-}
+    return -not [char]::IsLetter($Token[$Key.Length])
-
+}
-# --- Temp dir ---
+
-$tempDir = Join-Path $env:TEMP "epf_build_$(Get-Random)"
+function Get-ProjectExtraArgs {
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-
+    param([string]$Name)
-try {
+    $dir = (Get-Location).Path
-    # --- Build arguments ---
+    while ($dir) {
-    $arguments = @("DESIGNER")
+        $pf = Join-Path $dir ".v8-project.json"
-
+        if (Test-Path $pf) {
-    if ($InfoBaseServer -and $InfoBaseRef) {
+            try {
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-    } else {
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-        $arguments += "/F", "`"$InfoBasePath`""
+            } catch {}
-    }
+            return @()
-
+        }
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+        $parent = Split-Path $dir -Parent
-    if ($Password) { $arguments += "/P`"$Password`"" }
+        if (-not $parent -or $parent -eq $dir) { break }
-
+        $dir = $parent
-    $arguments += "/LoadExternalDataProcessorOrReportFromFiles", "`"$SourceFile`"", "`"$OutputFile`""
+    }
-
+    return @()
-    # --- Output ---
+}
-    $outFile = Join-Path $tempDir "build_log.txt"
+
-    $arguments += "/Out", "`"$outFile`""
+function Assert-ExtraArgs {
-    $arguments += "/DisableStartupDialogs"
+    # The platform accepts only one batch operation, and a duplicate connection or
-
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-    # --- Execute ---
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-    $exitCode = $process.ExitCode
+    foreach ($tok in $ExtraArgs) {
-
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-    # --- Result ---
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-    if ($exitCode -eq 0) {
+            exit 1
-        Write-Host "Build completed successfully: $OutputFile" -ForegroundColor Green
+        }
-    } else {
+        foreach ($k in $owned) {
-        Write-Host "Error building (code: $exitCode)" -ForegroundColor Red
+            if (Test-ArgKeyMatch $tok $k) {
-    }
+                $hint = ''
-
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-    if (Test-Path $outFile) {
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+                exit 1
-        if ($logContent) {
+            }
-            Write-Host "--- Log ---"
+        }
-            Write-Host $logContent
+    }
-            Write-Host "--- End ---"
+}
-        }
+
-    }
+function Resolve-ExtraArgs {
-
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
-    exit $exitCode
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
-
+    # simply do not apply — a project may describe both engines.
-} finally {
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
-    if (Test-Path $tempDir) {
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
-    }
+    # single token. So accept the repo's list convention (comma-separated) and split here;
-    if ($autoCreatedBase -and (Test-Path $autoCreatedBase)) {
+    # a native array call keeps working. A value containing a comma is not supported.
-        Remove-Item -Path $autoCreatedBase -Recurse -Force -ErrorAction SilentlyContinue
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-    }
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
-}
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$SourceFile = ConvertTo-CleanPath $SourceFile '-SourceFile'
+$OutputFile = ConvertTo-CleanPath $OutputFile '-OutputFile'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-OutputNonEmpty {
+    # Postcondition: the platform must have produced a non-empty output file.
+    # Exit code 0 without it (broken/headless env) is a false success — reject it.
+    param([string]$Path)
+    return (Test-Path $Path -PathType Leaf) -and ((Get-Item $Path -ErrorAction SilentlyContinue).Length -gt 0)
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+if ($engine -eq "ibcmd" -and $InfoBaseServer -and $InfoBaseRef) {
+    Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath or omit for stub)" -ForegroundColor Red
+    exit 1
+}
+
+# --- Auto-create stub database if no connection specified ---
+$autoCreatedBase = $null
+if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    $sourceDir = Split-Path $SourceFile -Parent
+    $autoBasePath = Join-Path $env:TEMP "epf_stub_db_$(Get-Random)"
+    $stubScript = Join-Path $PSScriptRoot "stub-db-create.ps1"
+    Write-Host "No database specified. Creating temporary stub database..."
+    # The stub runs its own platform processes (CREATEINFOBASE, LoadConfigFromFiles,
+    # UpdateDBCfg) — they need the same extra arguments as the final build. Only the
+    # explicit ones are forwarded: the stub reads .v8-project.json itself.
+    # Invoked via -Command, not -File: -File takes the tail literally, so an array
+    # parameter would arrive as a single comma-glued token.
+    $q = { param($s) "'" + ($s -replace "'", "''") + "'" }
+    $stubCmd = "& $(& $q $stubScript) -SourceDir $(& $q $sourceDir) -V8Path $(& $q $V8Path) -TempBasePath $(& $q $autoBasePath)"
+    if ($AdditionalV8Arguments.Count -gt 0) {
+        $stubCmd += " -AdditionalV8Arguments " + (($AdditionalV8Arguments | ForEach-Object { & $q $_ }) -join ',')
+    }
+    if ($AdditionalIbcmdArguments.Count -gt 0) {
+        $stubCmd += " -AdditionalIbcmdArguments " + (($AdditionalIbcmdArguments | ForEach-Object { & $q $_ }) -join ',')
+    }
+    $stubProc = Start-Process -FilePath "powershell.exe" -ArgumentList "-NoProfile -Command `"$stubCmd`"" -NoNewWindow -Wait -PassThru
+    if ($stubProc.ExitCode -ne 0) {
+        Write-Host "Error: failed to create stub database" -ForegroundColor Red
+        exit 1
+    }
+    $InfoBasePath = $autoBasePath
+    $autoCreatedBase = $autoBasePath
+}
+
+# --- Validate source file ---
+if (-not (Test-Path $SourceFile)) {
+    Write-Host "Error: source file not found: $SourceFile" -ForegroundColor Red
+    exit 1
+}
+
+# --- Ensure output directory exists ---
+$outDir = Split-Path $OutputFile -Parent
+if ($outDir -and -not (Test-Path $outDir)) {
+    New-Item -ItemType Directory -Path $outDir -Force | Out-Null
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "epf_build_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch: build EPF/ERF via config import --out ---
+        $srcDir = Split-Path $SourceFile -Parent
+        $arguments = @("infobase", "config", "import", "$srcDir", "--out=$OutputFile", "--db-path=$InfoBasePath")
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+        if ($outMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "External data processor/report built successfully: $OutputFile" -ForegroundColor Green
+        } elseif ($outMissing) {
+            Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — build produced no output" -ForegroundColor Red
+        } else {
+            Write-Host "Error building external data processor/report (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/LoadExternalDataProcessorOrReportFromFiles", "`"$SourceFile`"", "`"$OutputFile`""
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "build_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition: exit 0 without a non-empty output file is a false success.
+    $outMissing = ($exitCode -eq 0) -and -not (Test-OutputNonEmpty $OutputFile)
+    if ($outMissing) { $exitCode = 1 }
+    if ($exitCode -eq 0) {
+        Write-Host "Build completed successfully: $OutputFile" -ForegroundColor Green
+    } elseif ($outMissing) {
+        Write-Host "Error: exit code 0 but no non-empty file at $OutputFile — build produced no output" -ForegroundColor Red
+    } else {
+        Write-Host "Error building (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+    if ($autoCreatedBase -and (Test-Path $autoCreatedBase)) {
+        Remove-Item -Path $autoCreatedBase -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/epf-build/scripts/epf-build.py

@@ -1,35 +1,356 @@
 #!/usr/bin/env python3
-# epf-build v1.0 — Build external data processor or report (EPF/ERF) from XML sources
+# epf-build v1.12 — Build external data processor or report (EPF/ERF) from XML sources
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        candidates = glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+    while True:
-        if candidates:
+        pf = os.path.join(d, ".v8-project.json")
-            candidates.sort()
+        if os.path.isfile(pf):
-            return candidates[-1]
+            try:
-        else:
+                with open(pf, encoding="utf-8-sig") as f:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                    data = json.load(f)
-            sys.exit(1)
+                v = data.get("v8path")
-    elif os.path.isdir(v8path):
+                if v:
-        v8path = os.path.join(v8path, "1cv8.exe")
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
         sys.exit(1)
 
-    return v8path
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def output_nonempty(path):
+    """Postcondition: the platform must have produced a non-empty output file.
+    Exit code 0 without it (broken/headless env) is a false success — reject it."""
+    return os.path.isfile(path) and os.path.getsize(path) > 0
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
 
 
 def main():
@@ -47,10 +368,38 @@ def main():
     parser.add_argument("-Password", default="", help="1C user password")
     parser.add_argument("-SourceFile", required=True, help="Path to root XML source file")
     parser.add_argument("-OutputFile", required=True, help="Path to output EPF/ERF file")
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.SourceFile = clean_path(args.SourceFile, "-SourceFile")
+    args.OutputFile = clean_path(args.OutputFile, "-OutputFile")
 
     # --- Resolve V8Path ---
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
+    if engine == "ibcmd" and args.InfoBaseServer and args.InfoBaseRef:
+        print("Error: ibcmd supports file infobases only (use -InfoBasePath or omit for stub)", file=sys.stderr)
+        sys.exit(1)
 
     # --- Auto-create stub database if no connection specified ---
     auto_created_base = None
@@ -59,10 +408,16 @@ def main():
         auto_base_path = os.path.join(tempfile.gettempdir(), f"epf_stub_db_{random.randint(0, 999999)}")
         stub_script = os.path.join(os.path.dirname(os.path.abspath(__file__)), "stub-db-create.py")
         print("No database specified. Creating temporary stub database...")
-        result = subprocess.run(
+        stub_cmd = [sys.executable, stub_script, "-SourceDir", source_dir, "-V8Path", v8path,
-            [sys.executable, stub_script, "-SourceDir", source_dir, "-V8Path", v8path, "-TempBasePath", auto_base_path],
+                    "-TempBasePath", auto_base_path]
-            capture_output=False,
+        # The stub runs its own platform processes (CREATEINFOBASE, LoadConfigFromFiles,
-        )
+        # UpdateDBCfg) — they need the same extra arguments as the final build. Only the
+        # explicit ones are forwarded: the stub reads .v8-project.json itself.
+        if v8_extra:
+            stub_cmd += ["-AdditionalV8Arguments"] + list(v8_extra)
+        if ibcmd_extra:
+            stub_cmd += ["-AdditionalIbcmdArguments"] + list(ibcmd_extra)
+        result = subprocess.run(stub_cmd, capture_output=False)
         if result.returncode != 0:
             print("Error: failed to create stub database", file=sys.stderr)
             sys.exit(1)
@@ -84,38 +439,67 @@ def main():
     os.makedirs(temp_dir, exist_ok=True)
 
     try:
+        if engine == "ibcmd":
+            # --- ibcmd branch: build EPF/ERF via config import --out ---
+            src_dir = os.path.dirname(os.path.abspath(args.SourceFile))
+            arguments = ["infobase", "config", "import", src_dir, f"--out={args.OutputFile}", f"--db-path={args.InfoBasePath}"]
+            ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+            atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+            if args.UserName:
+                arguments.append(f"--user={args.UserName}")
+            if args.Password:
+                arguments.append(f"--password={args.Password}")
+            arguments.append(f"--data={ib_data}")
+            arguments.extend(extra_args)
+            print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+            result = run_ibcmd([v8path] + arguments, warn_no_user=False)
+            exit_code = result.returncode
+            out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+            if out_missing:
+                exit_code = 1
+            if exit_code == 0:
+                print(f"External data processor/report built successfully: {args.OutputFile}")
+            elif out_missing:
+                print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — build produced no output", file=sys.stderr)
+            else:
+                print(f"Error building external data processor/report (code: {exit_code})", file=sys.stderr)
+            sys.exit(exit_code)
+
         # --- Build arguments ---
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments += ["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"]
+            arguments += ["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"']
         else:
-            arguments += ["/F", args.InfoBasePath]
+            arguments += ["/F", f'"{args.InfoBasePath}"']
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments += ["/LoadExternalDataProcessorOrReportFromFiles", args.SourceFile, args.OutputFile]
+        arguments += ["/LoadExternalDataProcessorOrReportFromFiles", f'"{args.SourceFile}"', f'"{args.OutputFile}"']
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "build_log.txt")
-        arguments += ["/Out", out_file]
+        arguments += ["/Out", f'"{out_file}"']
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
+        # Postcondition: exit 0 without a non-empty output file is a false success.
+        out_missing = exit_code == 0 and not output_nonempty(args.OutputFile)
+        if out_missing:
+            exit_code = 1
         if exit_code == 0:
             print(f"Build completed successfully: {args.OutputFile}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no non-empty file at {args.OutputFile} — build produced no output", file=sys.stderr)
         else:
             print(f"Error building (code: {exit_code})", file=sys.stderr)
 
@@ -130,6 +514,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/epf-build/scripts/stub-db-create.ps1

@@ -1,4 +1,4 @@
-# stub-db-create v1.0 — Create temp 1C infobase with metadata stubs for EPF/ERF build
+# stub-db-create v1.7 — Create temp 1C infobase with metadata stubs for EPF/ERF build
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -7,12 +7,162 @@ param(
 	[Parameter(Mandatory)]
 	[string]$V8Path,
 
-	[string]$TempBasePath
+	[string]$TempBasePath,
+
+	[string[]]$AdditionalV8Arguments = @(),
+
+	[string[]]$AdditionalIbcmdArguments = @()
 )
 
 $ErrorActionPreference = "Stop"
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$SourceDir = ConvertTo-CleanPath $SourceDir '-SourceDir'
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$TempBasePath = ConvertTo-CleanPath $TempBasePath '-TempBasePath'
+
+# --- Additional platform arguments ---
+$script:V8OwnedKeys = @(
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
+)
+$script:IbcmdOwnedKeys = @(
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
+    '--import', '--export', '--apply', '--force', '--create-database',
+    '--user', '--password'
+)
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
+
+function Test-ArgKeyMatch {
+    # A token matches a key when it equals the key, or starts with it and the next
+    # character is not a letter — catches glued /N"user" and --password=x, while
+    # keeping /ClearCache distinct from /C.
+    param([string]$Token, [string]$Key)
+    if ($Token.Length -lt $Key.Length) { return $false }
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
+    if ($Token.Length -eq $Key.Length) { return $true }
+    return -not [char]::IsLetter($Token[$Key.Length])
+}
+
+function Get-ProjectExtraArgs {
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
+    param([string]$Name)
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
+            } catch {}
+            return @()
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return @()
+}
+
+function Assert-ExtraArgs {
+    # The platform accepts only one batch operation, and a duplicate connection or
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
+    foreach ($tok in $ExtraArgs) {
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
+            exit 1
+        }
+        foreach ($k in $owned) {
+            if (Test-ArgKeyMatch $tok $k) {
+                $hint = ''
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
+                exit 1
+            }
+        }
+    }
+}
+
+function Resolve-ExtraArgs {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
+    # simply do not apply — a project may describe both engines.
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+
 # --- 1. Scan XML files for reference types ---
 
 $typeMap = @{}  # MetadataType -> @(Name1, Name2, ...)
@@ -1252,11 +1402,119 @@ $propsXml		</Properties>$childObjLine
 	}
 }
 
+# --- 5a. Stub via ibcmd (one call: create [--import --apply]) ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+$stubEngine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-TempBasePath'; '--db-path' = '-TempBasePath' }
+$extraArgs = @(Resolve-ExtraArgs $stubEngine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+
+function Format-ArgToken {
+	# Start-Process takes these argument lists as one string, so quote each token that needs it.
+	param([string]$Token)
+	if ($Token -match '[\s"]') { return ' "' + ($Token -replace '"', '\"') + '"' }
+	return " $Token"
+}
+$extraArgString = -join ($extraArgs | ForEach-Object { Format-ArgToken $_ })
+if ($stubEngine -eq "ibcmd") {
+	Write-Host "Creating infobase (ibcmd): $TempBasePath"
+	$ibData = Join-Path $env:TEMP "stub_data_$(Get-Random)"
+	New-Item -ItemType Directory -Path $ibData -Force | Out-Null
+	$ibArgs = @("infobase", "create", "--db-path=$TempBasePath", "--create-database")
+	if ($hasRefTypes) { $ibArgs += "--import=$(Join-Path $TempBasePath 'cfg')", "--apply", "--force" }
+	$ibArgs += "--data=$ibData"
+	$ibArgs += $extraArgs
+	$__ib = Invoke-PlatformProcess $V8Path $ibArgs
+	$ibOut = $__ib.Output
+	$ibRc = $__ib.ExitCode
+	Remove-Item -Path $ibData -Recurse -Force -ErrorAction SilentlyContinue
+	if ($ibRc -ne 0) {
+		Write-PlatformOutput $ibOut
+		Write-Error "Failed to create stub infobase (code: $ibRc)"
+		exit 1
+	}
+	if ($hasRefTypes) { Remove-Item -Path (Join-Path $TempBasePath "cfg") -Recurse -Force -ErrorAction SilentlyContinue }
+	Write-Host "[OK] Stub database created: $TempBasePath"
+	Write-Host $TempBasePath
+	exit 0
+}
+
 # --- 5. Create infobase ---
 Write-Host "Creating infobase: $TempBasePath"
-$createArgs = "CREATEINFOBASE File=`"$TempBasePath`" /DisableStartupDialogs"
+$createArgs = "CREATEINFOBASE File=`"$TempBasePath`" /DisableStartupDialogs" + $extraArgString
-$proc = Start-Process -FilePath $V8Path -ArgumentList $createArgs -NoNewWindow -Wait -PassThru
+$proc = Invoke-PlatformProcess $V8Path @($createArgs) -PreQuoted
 if ($proc.ExitCode -ne 0) {
+	Write-PlatformOutput $proc.Output
 	Write-Error "Failed to create infobase (code: $($proc.ExitCode))"
 	exit 1
 }
@@ -1267,10 +1525,11 @@ if ($hasRefTypes) {
 	# LoadConfigFromFiles
 	Write-Host "Loading configuration from files..."
 	$loadLog = Join-Path $env:TEMP "stub_load_log.txt"
-	$loadArgs = "DESIGNER /F`"$TempBasePath`" /LoadConfigFromFiles `"$cfgDir`" /Out `"$loadLog`" /DisableStartupDialogs"
+	$loadArgs = "DESIGNER /F`"$TempBasePath`" /LoadConfigFromFiles `"$cfgDir`" /Out `"$loadLog`" /DisableStartupDialogs" + $extraArgString
-	$proc = Start-Process -FilePath $V8Path -ArgumentList $loadArgs -NoNewWindow -Wait -PassThru
+	$proc = Invoke-PlatformProcess $V8Path @($loadArgs) -PreQuoted
 	if ($proc.ExitCode -ne 0) {
 		if (Test-Path $loadLog) { Get-Content $loadLog -Raw -ErrorAction SilentlyContinue | Write-Host }
+		Write-PlatformOutput $proc.Output
 		Write-Error "Failed to load config (code: $($proc.ExitCode))"
 		exit 1
 	}
@@ -1278,10 +1537,11 @@ if ($hasRefTypes) {
 	# UpdateDBCfg
 	Write-Host "Updating database configuration..."
 	$updateLog = Join-Path $env:TEMP "stub_update_log.txt"
-	$updateArgs = "DESIGNER /F`"$TempBasePath`" /UpdateDBCfg /Out `"$updateLog`" /DisableStartupDialogs"
+	$updateArgs = "DESIGNER /F`"$TempBasePath`" /UpdateDBCfg /Out `"$updateLog`" /DisableStartupDialogs" + $extraArgString
-	$proc = Start-Process -FilePath $V8Path -ArgumentList $updateArgs -NoNewWindow -Wait -PassThru
+	$proc = Invoke-PlatformProcess $V8Path @($updateArgs) -PreQuoted
 	if ($proc.ExitCode -ne 0) {
 		if (Test-Path $updateLog) { Get-Content $updateLog -Raw -ErrorAction SilentlyContinue | Write-Host }
+		Write-PlatformOutput $proc.Output
 		Write-Error "Failed to update DB config (code: $($proc.ExitCode))"
 		exit 1
 	}

.claude/skills/epf-build/scripts/stub-db-create.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# stub-db-create v1.0 — Create temp 1C infobase with metadata stubs for EPF/ERF build
+# stub-db-create v1.7 — Create temp 1C infobase with metadata stubs for EPF/ERF build
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
@@ -12,6 +12,256 @@ import tempfile
 import uuid
 
 
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
 def new_uuid():
     return str(uuid.uuid4())
 
@@ -781,7 +1031,17 @@ def main():
     parser.add_argument('-SourceDir', required=True)
     parser.add_argument('-V8Path', required=True)
     parser.add_argument('-TempBasePath', default='')
-    args = parser.parse_args()
+    parser.add_argument('-AdditionalV8Arguments', nargs='*', default=[],
+                        help='Extra 1cv8 arguments, e.g. /UseHwLicenses+')
+    parser.add_argument('-AdditionalIbcmdArguments', nargs='*', default=[],
+                        help='Extra ibcmd arguments in --key=value form')
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.SourceDir = clean_path(args.SourceDir, "-SourceDir")
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.TempBasePath = clean_path(args.TempBasePath, "-TempBasePath")
 
     type_map = scan_ref_types(args.SourceDir)
     register_columns = scan_register_columns(args.SourceDir)
@@ -1034,13 +1294,43 @@ def main():
         if register_columns:
             print('WARNING: Register column categories (Dimension/Resource/Attribute) are guessed. Form field bindings may not survive round-trip through a real database.')
 
+    # Stub via ibcmd (one call: create [--import --apply])
+    stub_engine = "ibcmd" if os.path.basename(args.V8Path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {"/F": "-TempBasePath", "--db-path": "-TempBasePath"}
+    extra_args = resolve_extra_args(stub_engine, v8_extra, ibcmd_extra, arg_hints)
+    if stub_engine == "ibcmd":
+        import shutil
+        print(f'Creating infobase (ibcmd): {temp_base}')
+        ib_data = tempfile.mkdtemp(prefix="stub_data_")
+        ib_args = [args.V8Path, 'infobase', 'create', f'--db-path={temp_base}', '--create-database']
+        if has_ref_types:
+            ib_args += [f'--import={os.path.join(temp_base, "cfg")}', '--apply', '--force']
+        ib_args.append(f'--data={ib_data}')
+        ib_args.extend(extra_args)
+        result = run_ibcmd(ib_args, warn_no_user=False)
+        shutil.rmtree(ib_data, ignore_errors=True)
+        if result.returncode != 0:
+            if result.stdout:
+                print(result.stdout)
+            if result.stderr:
+                print(result.stderr, file=sys.stderr)
+            print(f'Failed to create stub infobase (code: {result.returncode})', file=sys.stderr)
+            sys.exit(1)
+        if has_ref_types:
+            import shutil
+            shutil.rmtree(os.path.join(temp_base, 'cfg'), ignore_errors=True)
+        print(f'[OK] Stub database created: {temp_base}')
+        print(temp_base)
+        sys.exit(0)
+
     # Create infobase
     print(f'Creating infobase: {temp_base}')
-    result = subprocess.run(
+    result = run_v8(args.V8Path, ['CREATEINFOBASE', f'File="{temp_base}"', '/DisableStartupDialogs']
-        [args.V8Path, 'CREATEINFOBASE', f'File={temp_base}', '/DisableStartupDialogs'],
+                    + [quote_if_needed(a) for a in extra_args])
-        capture_output=True, text=True,
-    )
     if result.returncode != 0:
+        print_platform_output(result)
         print(f'Failed to create infobase (code: {result.returncode})', file=sys.stderr)
         sys.exit(1)
 
@@ -1048,21 +1338,18 @@ def main():
         cfg_dir = os.path.join(temp_base, 'cfg')
         # LoadConfigFromFiles
         print('Loading configuration from files...')
-        result = subprocess.run(
+        result = run_v8(args.V8Path, ['DESIGNER', f'/F"{temp_base}"', '/LoadConfigFromFiles', f'"{cfg_dir}"',
-            [args.V8Path, 'DESIGNER', f'/F{temp_base}', '/LoadConfigFromFiles', cfg_dir, '/DisableStartupDialogs'],
+                                      '/DisableStartupDialogs'] + [quote_if_needed(a) for a in extra_args])
-            capture_output=True, text=True,
-        )
         if result.returncode != 0:
+            print_platform_output(result)
             print(f'Failed to load config (code: {result.returncode})', file=sys.stderr)
             sys.exit(1)
 
         # UpdateDBCfg
         print('Updating database configuration...')
         update_log = os.path.join(tempfile.gettempdir(), 'stub_update_log.txt')
-        result = subprocess.run(
+        result = run_v8(args.V8Path, ['DESIGNER', f'/F"{temp_base}"', '/UpdateDBCfg', '/Out', f'"{update_log}"',
-            [args.V8Path, 'DESIGNER', f'/F{temp_base}', '/UpdateDBCfg', '/Out', update_log, '/DisableStartupDialogs'],
+                                      '/DisableStartupDialogs'] + [quote_if_needed(a) for a in extra_args])
-            capture_output=True, text=True,
-        )
         if result.returncode != 0:
             if os.path.isfile(update_log):
                 try:
@@ -1070,6 +1357,7 @@ def main():
                         print(f.read())
                 except Exception:
                     pass
+            print_platform_output(result)
             print(f'Failed to update DB config (code: {result.returncode})', file=sys.stderr)
             sys.exit(1)
 

.claude/skills/epf-dump/SKILL.md

@@ -1,69 +1,71 @@
----
+---
-name: epf-dump
+name: epf-dump
-description: Разобрать EPF-файл обработки 1С (EPF/ERF) в XML-исходники. Используй когда пользователь просит разобрать, декомпилировать обработку, получить исходники из EPF/ERF файла
+description: Разобрать EPF-файл обработки 1С (EPF/ERF) в XML-исходники. Используй когда пользователь просит разобрать, декомпилировать обработку, получить исходники из EPF/ERF файла
-argument-hint: <EpfFile>
+argument-hint: <EpfFile>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /epf-dump — Разборка обработки
+# /epf-dump — Разборка обработки
-
+
-## Usage
+## Usage
-
+
-```
+```
-/epf-dump <EpfFile> [OutDir]
+/epf-dump <EpfFile> [OutDir]
-```
+```
-
+
-| Параметр | Обязательный | По умолчанию | Описание                            |
+| Параметр | Обязательный | По умолчанию | Описание                            |
-|----------|:------------:|--------------|-------------------------------------|
+|----------|:------------:|--------------|-------------------------------------|
-| EpfFile  | да           | —            | Путь к EPF-файлу                    |
+| EpfFile  | да           | —            | Путь к EPF-файлу                    |
-| OutDir   | нет          | `src`        | Каталог для выгрузки исходников     |
+| OutDir   | нет          | `src`        | Каталог для выгрузки исходников     |
-
+
-## Параметры подключения (обязательно)
+## Параметры подключения (обязательно)
-
+
-Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
+Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
-
+
-1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
+1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
-2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-5. Если ветка не совпала — используй `default`
+5. Если ветка не совпала — используй `default`
-6. Если `.v8-project.json` нет или база не найдена — **сообщи пользователю об ошибке**. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через `/db-list add`.
+6. Если `.v8-project.json` нет или база не найдена — **сообщи пользователю об ошибке**. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через `/db-list add`.
-
+
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-InputFile <путь>` | да | Путь к EPF/ERF-файлу |
+| `-InputFile <путь>` | да | Путь к EPF/ERF-файлу |
-| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
+| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
-| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
+| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Примеры
+> `*` — обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
-
+
-```powershell
+## Примеры
-# Разборка обработки (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+```powershell
-
+# Разборка обработки (файловая база)
-# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+
-```
+# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+```

.claude/skills/epf-dump/scripts/epf-dump.ps1

@@ -1,167 +1,497 @@
-# epf-dump v1.0 — Dump external data processor or report (EPF/ERF) to XML sources
+# epf-dump v1.11 — Dump external data processor or report (EPF/ERF) to XML sources
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-<#
+# NB: *nix-раскладку платформы (/opt/1cv8/<ver>/1cv8, без .exe) знает только .py-порт — PS на *nix не исполняется.
-.SYNOPSIS
+<#
-    Разборка внешней обработки/отчёта 1С в XML-исходники
+.SYNOPSIS
-
+    Разборка внешней обработки/отчёта 1С в XML-исходники
-.DESCRIPTION
+
-    Разбирает EPF/ERF-файл во XML-исходники с помощью платформы 1С.
+.DESCRIPTION
-    Общий скрипт для epf-dump и erf-dump.
+    Разбирает EPF/ERF-файл во XML-исходники с помощью платформы 1С.
-
+    Общий скрипт для epf-dump и erf-dump.
-.PARAMETER V8Path
+
-    Путь к каталогу bin платформы или к 1cv8.exe
+.PARAMETER V8Path
-
+    Путь к каталогу bin платформы или к 1cv8.exe
-.PARAMETER InfoBasePath
+
-    Путь к файловой информационной базе
+.PARAMETER InfoBasePath
-
+    Путь к файловой информационной базе
-.PARAMETER InfoBaseServer
+
-    Сервер 1С (для серверной базы)
+.PARAMETER InfoBaseServer
-
+    Сервер 1С (для серверной базы)
-.PARAMETER InfoBaseRef
+
-    Имя базы на сервере
+.PARAMETER InfoBaseRef
-
+    Имя базы на сервере
-.PARAMETER UserName
+
-    Имя пользователя 1С
+.PARAMETER UserName
-
+    Имя пользователя 1С
-.PARAMETER Password
+
-    Пароль пользователя
+.PARAMETER Password
-
+    Пароль пользователя
-.PARAMETER InputFile
+
-    Путь к EPF/ERF-файлу
+.PARAMETER InputFile
-
+    Путь к EPF/ERF-файлу
-.PARAMETER OutputDir
+
-    Каталог для выгрузки исходников
+.PARAMETER OutputDir
-
+    Каталог для выгрузки исходников
-.PARAMETER Format
+
-    Формат выгрузки: Hierarchical или Plain (по умолчанию Hierarchical)
+.PARAMETER Format
-
+    Формат выгрузки: Hierarchical или Plain (по умолчанию Hierarchical)
-.EXAMPLE
+
-    .\epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МояОбработка.epf" -OutputDir "src"
+.PARAMETER AdditionalV8Arguments
-
+    Дополнительные аргументы запуска 1cv8.exe (например /UseHwLicenses+)
-.EXAMPLE
+
-    .\epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МойОтчёт.erf" -OutputDir "src"
+.PARAMETER AdditionalIbcmdArguments
-#>
+    Дополнительные аргументы запуска ibcmd (форма --ключ=значение)
-
+
-[CmdletBinding()]
+.EXAMPLE
-param(
+    .\epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МояОбработка.epf" -OutputDir "src"
-    [Parameter(Mandatory=$false)]
+
-    [string]$V8Path,
+.EXAMPLE
-
+    .\epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МойОтчёт.erf" -OutputDir "src"
-    [Parameter(Mandatory=$false)]
+#>
-    [string]$InfoBasePath,
+
-
+[CmdletBinding()]
-    [Parameter(Mandatory=$false)]
+param(
-    [string]$InfoBaseServer,
+    [Parameter(Mandatory=$false)]
-
+    [string]$V8Path,
-    [Parameter(Mandatory=$false)]
+
-    [string]$InfoBaseRef,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBasePath,
-    [Parameter(Mandatory=$false)]
+
-    [string]$UserName,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseServer,
-    [Parameter(Mandatory=$false)]
+
-    [string]$Password,
+    [Parameter(Mandatory=$false)]
-
+    [string]$InfoBaseRef,
-    [Parameter(Mandatory=$true)]
+
-    [string]$InputFile,
+    [Parameter(Mandatory=$false)]
-
+    [string]$UserName,
-    [Parameter(Mandatory=$true)]
+
-    [string]$OutputDir,
+    [Parameter(Mandatory=$false)]
-
+    [string]$Password,
-    [Parameter(Mandatory=$false)]
+
-    [ValidateSet("Hierarchical", "Plain")]
+    [Parameter(Mandatory=$true)]
-    [string]$Format = "Hierarchical"
+    [string]$InputFile,
-)
+
-
+    [Parameter(Mandatory=$true)]
-$OutputEncoding = [System.Text.Encoding]::UTF8
+    [string]$OutputDir,
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
-
+    [Parameter(Mandatory=$false)]
-# --- Resolve V8Path ---
+    [ValidateSet("Hierarchical", "Plain")]
-if (-not $V8Path) {
+    [string]$Format = "Hierarchical",
-    $found = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" -ErrorAction SilentlyContinue | Sort-Object FullName -Descending | Select-Object -First 1
+
-    if ($found) {
+    [Parameter(Mandatory=$false)]
-        $V8Path = $found.FullName
+    [string[]]$AdditionalV8Arguments = @(),
-    } else {
+
-        Write-Host "Error: 1cv8.exe not found. Specify -V8Path" -ForegroundColor Red
+    [Parameter(Mandatory=$false)]
-        exit 1
+    [string[]]$AdditionalIbcmdArguments = @()
-    }
+)
-} elseif (Test-Path $V8Path -PathType Container) {
+
-    $V8Path = Join-Path $V8Path "1cv8.exe"
+$OutputEncoding = [System.Text.Encoding]::UTF8
-}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+
-if (-not (Test-Path $V8Path)) {
+# --- Additional platform arguments ---
-    Write-Host "Error: 1cv8.exe not found at $V8Path" -ForegroundColor Red
+$script:V8OwnedKeys = @(
-    exit 1
+    'DESIGNER', 'ENTERPRISE', 'CREATEINFOBASE', 'CONFIG',
-}
+    '/F', '/S', '/N', '/P', '/Out', '/DisableStartupDialogs',
-
+    '/UseTemplate', '/AddToList', '/Execute', '/C', '/URL', '/UC',
-# --- Validate database connection ---
+    '/DumpIB', '/RestoreIB', '/DumpCfg', '/LoadCfg',
-if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    '/DumpConfigToFiles', '/LoadConfigFromFiles', '/UpdateDBCfg',
-    Write-Host "Error: database connection required. Specify -InfoBasePath or -InfoBaseServer/-InfoBaseRef" -ForegroundColor Red
+    '/DumpExternalDataProcessorOrReportToFiles', '/LoadExternalDataProcessorOrReportFromFiles'
-    Write-Host "Dump in an empty database loses reference types (CatalogRef, DocumentRef, etc.) irreversibly." -ForegroundColor Yellow
+)
-    exit 1
+$script:IbcmdOwnedKeys = @(
-}
+    '--db-path', '--data', '--out', '--file', '--load', '--restore',
-
+    '--import', '--export', '--apply', '--force', '--create-database',
-# --- Validate input file ---
+    '--user', '--password'
-if (-not (Test-Path $InputFile)) {
+)
-    Write-Host "Error: input file not found: $InputFile" -ForegroundColor Red
+$script:V8SecretKeys = @('/P', '/UC', '/WSP', '/AWSP')
-    exit 1
+$script:IbcmdSecretKeys = @('--password', '--token', '--db-pwd')
-}
+
-
+function Test-ArgKeyMatch {
-# --- Ensure output directory exists ---
+    # A token matches a key when it equals the key, or starts with it and the next
-if (-not (Test-Path $OutputDir)) {
+    # character is not a letter — catches glued /N"user" and --password=x, while
-    New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+    # keeping /ClearCache distinct from /C.
-}
+    param([string]$Token, [string]$Key)
-
+    if ($Token.Length -lt $Key.Length) { return $false }
-# --- Temp dir ---
+    if (-not $Token.Substring(0, $Key.Length).Equals($Key, [System.StringComparison]::OrdinalIgnoreCase)) { return $false }
-$tempDir = Join-Path $env:TEMP "epf_dump_$(Get-Random)"
+    if ($Token.Length -eq $Key.Length) { return $true }
-New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+    return -not [char]::IsLetter($Token[$Key.Length])
-
+}
-try {
+
-    # --- Build arguments ---
+function Get-ProjectExtraArgs {
-    $arguments = @("DESIGNER")
+    # v8args / ibcmdargs from .v8-project.json — same upward walk as v8path.
-
+    param([string]$Name)
-    if ($InfoBaseServer -and $InfoBaseRef) {
+    $dir = (Get-Location).Path
-        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    while ($dir) {
-    } else {
+        $pf = Join-Path $dir ".v8-project.json"
-        $arguments += "/F", "`"$InfoBasePath`""
+        if (Test-Path $pf) {
-    }
+            try {
-
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
-    if ($UserName) { $arguments += "/N`"$UserName`"" }
+                if ($j.$Name) { return @($j.$Name | ForEach-Object { [string]$_ }) }
-    if ($Password) { $arguments += "/P`"$Password`"" }
+            } catch {}
-
+            return @()
-    $arguments += "/DumpExternalDataProcessorOrReportToFiles", "`"$OutputDir`"", "`"$InputFile`""
+        }
-    $arguments += "-Format", $Format
+        $parent = Split-Path $dir -Parent
-
+        if (-not $parent -or $parent -eq $dir) { break }
-    # --- Output ---
+        $dir = $parent
-    $outFile = Join-Path $tempDir "dump_log.txt"
+    }
-    $arguments += "/Out", "`"$outFile`""
+    return @()
-    $arguments += "/DisableStartupDialogs"
+}
-
+
-    # --- Execute ---
+function Assert-ExtraArgs {
-    Write-Host "Running: 1cv8.exe $($arguments -join ' ')"
+    # The platform accepts only one batch operation, and a duplicate connection or
-    $process = Start-Process -FilePath $V8Path -ArgumentList $arguments -NoNewWindow -Wait -PassThru
+    # output key fails with an opaque 1C error — reject what the skill owns itself.
-    $exitCode = $process.ExitCode
+    param([string[]]$ExtraArgs, [string]$Engine, [hashtable]$Hints)
-
+    $paramName = if ($Engine -eq 'ibcmd') { '-AdditionalIbcmdArguments' } else { '-AdditionalV8Arguments' }
-    # --- Result ---
+    $owned = if ($Engine -eq 'ibcmd') { $script:IbcmdOwnedKeys } else { $script:V8OwnedKeys }
-    if ($exitCode -eq 0) {
+    foreach ($tok in $ExtraArgs) {
-        Write-Host "Dump completed successfully to: $OutputDir" -ForegroundColor Green
+        if ($Engine -eq 'ibcmd' -and $tok -notmatch '^-') {
-    } else {
+            Write-Host "Error: '$tok' is a positional token — pass values as --key=value ($paramName cannot extend the ibcmd command)" -ForegroundColor Red
-        Write-Host "Error dumping (code: $exitCode)" -ForegroundColor Red
+            exit 1
-    }
+        }
-
+        foreach ($k in $owned) {
-    if (Test-Path $outFile) {
+            if (Test-ArgKeyMatch $tok $k) {
-        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+                $hint = ''
-        if ($logContent) {
+                if ($Hints -and $Hints.ContainsKey($k)) { $hint = " (use $($Hints[$k]))" }
-            Write-Host "--- Log ---"
+                Write-Host "Error: $k is controlled by the skill and cannot be passed via $paramName$hint" -ForegroundColor Red
-            Write-Host $logContent
+                exit 1
-            Write-Host "--- End ---"
+            }
-        }
+        }
-    }
+    }
-
+}
-    exit $exitCode
+
-
+function Resolve-ExtraArgs {
-} finally {
+    # Pick the argument list for the selected engine and validate it. An explicitly passed
-    if (Test-Path $tempDir) {
+    # parameter for the other engine is an error; the same keys coming from .v8-project.json
-        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    # simply do not apply — a project may describe both engines.
-    }
+    param([string]$Engine, [string[]]$V8Extra, [string[]]$IbcmdExtra, [hashtable]$Hints)
-}
+    # powershell.exe -File — how skills are invoked — cannot bind an array parameter:
+    # space-separated values spill into positional ones, a comma-joined list arrives as a
+    # single token. So accept the repo's list convention (comma-separated) and split here;
+    # a native array call keeps working. A value containing a comma is not supported.
+    $V8Extra = @($V8Extra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    $IbcmdExtra = @($IbcmdExtra | ForEach-Object { $_ -split ',' } | Where-Object { $_ -ne '' })
+    if ($Engine -eq 'ibcmd' -and $V8Extra.Count -gt 0) {
+        Write-Host "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd (use -AdditionalIbcmdArguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -ne 'ibcmd' -and $IbcmdExtra.Count -gt 0) {
+        Write-Host "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 (use -AdditionalV8Arguments)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Engine -eq 'ibcmd') {
+        $extra = @(Get-ProjectExtraArgs 'ibcmdargs') + @($IbcmdExtra)
+    } else {
+        $extra = @(Get-ProjectExtraArgs 'v8args') + @($V8Extra)
+    }
+    if ($extra.Count -gt 0) { Assert-ExtraArgs $extra $Engine $Hints }
+    # Plain return, no comma trick: the caller re-collects with @(...), and ,@() there
+    # would nest the array — the tokens would then be glued into one argument.
+    return $extra
+}
+
+function Format-ArgsForDisplay {
+    # Redact values of secret-prone keys in glued, =-joined and separate forms.
+    # Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    # a leaked password does.
+    param([string[]]$ArgList, [string]$Engine)
+    $keys = if ($Engine -eq 'ibcmd') { $script:IbcmdSecretKeys } else { $script:V8SecretKeys }
+    $res = @()
+    $maskNext = $false
+    foreach ($tok in $ArgList) {
+        if ($maskNext) { $res += '***'; $maskNext = $false; continue }
+        $hit = $null
+        foreach ($k in $keys) {
+            if ($tok.Length -ge $k.Length -and $tok.Substring(0, $k.Length).Equals($k, [System.StringComparison]::OrdinalIgnoreCase)) { $hit = $k; break }
+        }
+        if (-not $hit) { $res += $tok; continue }
+        if ($tok.Length -eq $hit.Length) { $res += $tok; $maskNext = $true }
+        elseif ($tok[$hit.Length] -eq '=') { $res += ($hit + '=***') }
+        else { $res += ($hit + '***') }
+    }
+    return ,$res
+}
+
+function ConvertTo-CleanPath {
+    # Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    # surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    # inside afterwards cannot be part of a real path — reject it by name instead of letting
+    # 1C answer with its opaque "Неверные или отсутствующие параметры соединения".
+    param([string]$Value, [string]$ParamName)
+    if (-not $Value) { return $Value }
+    $v = $Value.Trim()
+    if ($v.Length -ge 2 -and $v[0] -eq $v[-1] -and ($v[0] -eq '"' -or $v[0] -eq "'")) {
+        $v = $v.Substring(1, $v.Length - 2).Trim()
+    }
+    if ($v.Length -gt 3 -and ($v[-1] -eq '\' -or $v[-1] -eq '/')) { $v = $v.Substring(0, $v.Length - 1) }
+    if ($v.Contains('"')) {
+        Write-Host "Error: $ParamName contains a quote character: $Value" -ForegroundColor Red
+        exit 1
+    }
+    return $v
+}
+
+$V8Path = ConvertTo-CleanPath $V8Path '-V8Path'
+$InfoBasePath = ConvertTo-CleanPath $InfoBasePath '-InfoBasePath'
+$InputFile = ConvertTo-CleanPath $InputFile '-InputFile'
+$OutputDir = ConvertTo-CleanPath $OutputDir '-OutputDir'
+
+function Assert-InfoBaseExists {
+    # These skills work on a ready infobase. Saying so up front beats the platform's
+    # "Неверные или отсутствующие параметры соединения" after a launch.
+    param([string]$Path)
+    if (-not $Path) { return }
+    if (-not (Test-Path (Join-Path $Path "1Cv8.1CD"))) {
+        Write-Host "Error: information base not found at $Path (no 1Cv8.1CD)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Assert-InfoBaseExists $InfoBasePath
+
+# --- Resolve V8Path ---
+function Find-ProjectV8Path {
+    $dir = (Get-Location).Path
+    while ($dir) {
+        $pf = Join-Path $dir ".v8-project.json"
+        if (Test-Path $pf) {
+            try {
+                $j = Get-Content $pf -Raw -Encoding UTF8 | ConvertFrom-Json
+                if ($j.v8path) { return [string]$j.v8path }
+            } catch {}
+            return $null
+        }
+        $parent = Split-Path $dir -Parent
+        if (-not $parent -or $parent -eq $dir) { break }
+        $dir = $parent
+    }
+    return $null
+}
+
+if (-not $V8Path) {
+    $V8Path = Find-ProjectV8Path
+}
+if (-not $V8Path) {
+    $found = Get-ChildItem @("C:\Program Files\1cv8\*\bin\1cv8.exe", "C:\Program Files (x86)\1cv8\*\bin\1cv8.exe") -ErrorAction SilentlyContinue |
+        Sort-Object { try { [version]$_.Directory.Parent.Name } catch { [version]"0.0" } } -Descending |
+        Select-Object -First 1
+    if ($found) {
+        $V8Path = $found.FullName
+        Write-Host "Auto-selected platform $($found.Directory.Parent.Name): $V8Path" -ForegroundColor Yellow
+    } else {
+        Write-Host "Error: 1C executable not found. Specify -V8Path" -ForegroundColor Red
+        exit 1
+    }
+}
+if (Test-Path $V8Path -PathType Container) {
+    $V8Path = Join-Path $V8Path "1cv8.exe"
+}
+
+if (-not (Test-Path $V8Path)) {
+    Write-Host "Error: 1C executable not found at $V8Path" -ForegroundColor Red
+    exit 1
+}
+
+# --- Validate database connection ---
+if (-not $InfoBasePath -and (-not $InfoBaseServer -or -not $InfoBaseRef)) {
+    Write-Host "Error: database connection required. Specify -InfoBasePath or -InfoBaseServer/-InfoBaseRef" -ForegroundColor Red
+    Write-Host "Dump in an empty database loses reference types (CatalogRef, DocumentRef, etc.) irreversibly." -ForegroundColor Yellow
+    exit 1
+}
+
+# --- Detect engine (ibcmd vs 1cv8) by exe name ---
+function ConvertFrom-PlatformBytes {
+    # ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    # OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — guessing
+    # one of them outright mangles Cyrillic.
+    param([byte[]]$Bytes)
+    if (-not $Bytes -or $Bytes.Length -eq 0) { return '' }
+    try {
+        $strict = New-Object System.Text.UTF8Encoding($false, $true)
+        return $strict.GetString($Bytes)
+    } catch {
+        return [System.Text.Encoding]::GetEncoding(866).GetString($Bytes)
+    }
+}
+
+function Invoke-PlatformProcess {
+    # Run the platform non-interactively and capture its console output. A closed stdin pipe
+    # (EOF) makes an auth prompt fast-fail instead of hanging; capturing keeps the child's
+    # text out of our stream until we print it labelled (and out of the wrong encoding).
+    # Returns @{ Output; ExitCode }.
+    #
+    # Quoting differs by engine, so the caller says which it built:
+    #   ibcmd    — tokens are bare (--db-path=C:\a b), the whole token gets quoted here;
+    #   1cv8     — -PreQuoted: the caller already put quotes inside the token (File="C:\a b"),
+    #              which is where 1C's own parser expects them; quoting again breaks the value.
+    param([string]$Exe, [string[]]$ProcArgs, [switch]$PreQuoted)
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $Exe
+    $psi.Arguments = if ($PreQuoted) {
+        $ProcArgs -join ' '
+    } else {
+        ($ProcArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
+    }
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.RedirectStandardInput = $true
+    $psi.RedirectStandardOutput = $true
+    $psi.RedirectStandardError = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    $p.StandardInput.Close()
+    # stderr is drained in parallel: reading the streams one after another deadlocks
+    # as soon as the other one fills its pipe buffer.
+    $errMs = New-Object System.IO.MemoryStream
+    $errTask = $p.StandardError.BaseStream.CopyToAsync($errMs)
+    $outMs = New-Object System.IO.MemoryStream
+    $p.StandardOutput.BaseStream.CopyTo($outMs)
+    $errTask.Wait()
+    $p.WaitForExit()
+    $out = ConvertFrom-PlatformBytes $outMs.ToArray()
+    $err = ConvertFrom-PlatformBytes $errMs.ToArray()
+    if ($err) { $out += $err }
+    return [pscustomobject]@{ Output = $out; ExitCode = $p.ExitCode }
+}
+
+function Write-PlatformOutput {
+    # Print what the platform wrote to the console as its own labelled block. Silence stays
+    # silent: in batch mode 1cv8 reports through /Out and prints nothing here.
+    param([string]$Text)
+    if (-not $Text) { return }
+    $t = $Text.TrimEnd()
+    if (-not $t) { return }
+    $limit = 65536
+    if ($t.Length -gt $limit) {
+        $t = "[... обрезано, показаны последние $limit символов ...]`r`n" + $t.Substring($t.Length - $limit)
+    }
+    Write-Host "--- Вывод платформы ---"
+    Write-Host $t
+    Write-Host "--- End ---"
+}
+
+
+function Test-DirNonEmpty {
+    # Postcondition: the platform must have written files into the output directory.
+    # Exit code 0 with an empty dir (broken/headless env) is a false success — reject it.
+    param([string]$Path)
+    return (Test-Path $Path -PathType Container) -and ([bool](Get-ChildItem -LiteralPath $Path -Force -ErrorAction SilentlyContinue | Select-Object -First 1))
+}
+
+function Protect-Secrets {
+    # Redact literal secret values from a display string (String.Replace is literal, not regex).
+    param([string]$Text, [string[]]$Secrets)
+    foreach ($s in $Secrets) { if ($s) { $Text = $Text.Replace($s, '***') } }
+    return $Text
+}
+
+$engine = if ((Split-Path $V8Path -Leaf) -match '^ibcmd') { "ibcmd" } else { "1cv8" }
+
+# --- Resolve additional arguments for the selected engine ---
+$argHints = @{ '/F' = '-InfoBasePath'; '/S' = '-InfoBaseServer + -InfoBaseRef'; '/N' = '-UserName'; '/P' = '-Password'; '--db-path' = '-InfoBasePath'; '--user' = '-UserName'; '--password' = '-Password' }
+$extraArgs = @(Resolve-ExtraArgs $engine $AdditionalV8Arguments $AdditionalIbcmdArguments $argHints)
+if ($engine -eq "ibcmd") {
+    if (-not $InfoBasePath) {
+        Write-Host "Error: ibcmd supports file infobases only (use -InfoBasePath)" -ForegroundColor Red
+        exit 1
+    }
+    if ($Format -eq "Plain") {
+        Write-Host "Error: ibcmd config export supports hierarchical format only (use -Format Hierarchical or 1cv8)" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# --- Validate input file ---
+if (-not (Test-Path $InputFile)) {
+    Write-Host "Error: input file not found: $InputFile" -ForegroundColor Red
+    exit 1
+}
+
+# --- Ensure output directory exists ---
+if (-not (Test-Path $OutputDir)) {
+    New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
+}
+
+# --- Temp dir ---
+$tempDir = Join-Path $env:TEMP "epf_dump_$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+try {
+    if ($engine -eq "ibcmd") {
+        # --- ibcmd branch: dump EPF/ERF via config export --file ---
+        $arguments = @("infobase", "config", "export", "--file=$InputFile", "$OutputDir", "--db-path=$InfoBasePath")
+        if ($UserName) { $arguments += "--user=$UserName" }
+        if ($Password) { $arguments += "--password=$Password" }
+        $arguments += "--data=$tempDir"
+        $arguments += $extraArgs
+        Write-Host "Running: ibcmd $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+        $__ib = Invoke-PlatformProcess $V8Path $arguments
+        $output = $__ib.Output
+        $exitCode = $__ib.ExitCode
+        $outMissing = ($exitCode -eq 0) -and -not (Test-DirNonEmpty $OutputDir)
+        if ($outMissing) { $exitCode = 1 }
+        if ($exitCode -eq 0) {
+            Write-Host "External data processor/report dumped successfully to: $OutputDir" -ForegroundColor Green
+        } elseif ($outMissing) {
+            Write-Host "Error: exit code 0 but no files under $OutputDir — dump produced no output" -ForegroundColor Red
+        } else {
+            Write-Host "Error dumping external data processor/report (code: $exitCode)" -ForegroundColor Red
+        }
+        Write-PlatformOutput $output
+        exit $exitCode
+    }
+
+    # --- 1cv8 branch ---
+    # --- Build arguments ---
+    $arguments = @("DESIGNER")
+
+    if ($InfoBaseServer -and $InfoBaseRef) {
+        $arguments += "/S", "`"$InfoBaseServer/$InfoBaseRef`""
+    } else {
+        $arguments += "/F", "`"$InfoBasePath`""
+    }
+
+    if ($UserName) { $arguments += "/N`"$UserName`"" }
+    if ($Password) { $arguments += "/P`"$Password`"" }
+
+    $arguments += "/DumpExternalDataProcessorOrReportToFiles", "`"$OutputDir`"", "`"$InputFile`""
+    $arguments += "-Format", $Format
+
+    # --- Output ---
+    $outFile = Join-Path $tempDir "dump_log.txt"
+    $arguments += "/Out", "`"$outFile`""
+    $arguments += "/DisableStartupDialogs"
+    $arguments += $extraArgs
+
+    # --- Execute ---
+    Write-Host "Running: 1cv8.exe $(Protect-Secrets ((Format-ArgsForDisplay $arguments $engine) -join ' ') @($Password, $UserName))"
+    $__v8 = Invoke-PlatformProcess $V8Path $arguments -PreQuoted
+    $exitCode = $__v8.ExitCode
+
+    # --- Result ---
+    # Postcondition: exit 0 with an empty output directory is a false success.
+    $outMissing = ($exitCode -eq 0) -and -not (Test-DirNonEmpty $OutputDir)
+    if ($outMissing) { $exitCode = 1 }
+    if ($exitCode -eq 0) {
+        Write-Host "Dump completed successfully to: $OutputDir" -ForegroundColor Green
+    } elseif ($outMissing) {
+        Write-Host "Error: exit code 0 but no files under $OutputDir — dump produced no output" -ForegroundColor Red
+    } else {
+        Write-Host "Error dumping (code: $exitCode)" -ForegroundColor Red
+    }
+
+    if (Test-Path $outFile) {
+        $logContent = Get-Content $outFile -Raw -ErrorAction SilentlyContinue
+        if ($logContent) {
+            Write-Host "--- Log ---"
+            Write-Host $logContent
+            Write-Host "--- End ---"
+        }
+    }
+    Write-PlatformOutput $__v8.Output
+
+    exit $exitCode
+
+} finally {
+    if (Test-Path $tempDir) {
+        Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}

.claude/skills/epf-dump/scripts/epf-dump.py

@@ -1,35 +1,356 @@
 #!/usr/bin/env python3
-# epf-dump v1.0 — Dump external data processor or report (EPF/ERF) to XML sources
+# epf-dump v1.11 — Dump external data processor or report (EPF/ERF) to XML sources
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import atexit
 import glob
+import json
 import os
 import random
+import re
 import shutil
 import subprocess
 import sys
 import tempfile
 
 
-def resolve_v8path(v8path):
+def _find_project_v8path():
-    """Resolve path to 1cv8.exe."""
+    """Walk up from CWD to find .v8-project.json and read its v8path."""
-    if not v8path:
+    d = os.getcwd()
-        candidates = glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+    while True:
-        if candidates:
+        pf = os.path.join(d, ".v8-project.json")
-            candidates.sort()
+        if os.path.isfile(pf):
-            return candidates[-1]
+            try:
-        else:
+                with open(pf, encoding="utf-8-sig") as f:
-            print("Error: 1cv8.exe not found. Specify -V8Path", file=sys.stderr)
+                    data = json.load(f)
-            sys.exit(1)
+                v = data.get("v8path")
-    elif os.path.isdir(v8path):
+                if v:
-        v8path = os.path.join(v8path, "1cv8.exe")
+                    return v
+            except Exception:
+                pass
+            return None
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
 
+
+# --- Additional platform arguments ---
+V8_OWNED_KEYS = [
+    "DESIGNER", "ENTERPRISE", "CREATEINFOBASE", "CONFIG",
+    "/F", "/S", "/N", "/P", "/Out", "/DisableStartupDialogs",
+    "/UseTemplate", "/AddToList", "/Execute", "/C", "/URL", "/UC",
+    "/DumpIB", "/RestoreIB", "/DumpCfg", "/LoadCfg",
+    "/DumpConfigToFiles", "/LoadConfigFromFiles", "/UpdateDBCfg",
+    "/DumpExternalDataProcessorOrReportToFiles", "/LoadExternalDataProcessorOrReportFromFiles",
+]
+IBCMD_OWNED_KEYS = [
+    "--db-path", "--data", "--out", "--file", "--load", "--restore",
+    "--import", "--export", "--apply", "--force", "--create-database",
+    "--user", "--password",
+]
+V8_SECRET_KEYS = ["/P", "/UC", "/WSP", "/AWSP"]
+IBCMD_SECRET_KEYS = ["--password", "--token", "--db-pwd"]
+
+
+def arg_key_match(token, key):
+    """Token matches a key when it equals it, or starts with it and the next character
+    is not a letter — catches glued /N"user" and --password=x, while keeping
+    /ClearCache distinct from /C."""
+    if len(token) < len(key):
+        return False
+    if token[: len(key)].lower() != key.lower():
+        return False
+    if len(token) == len(key):
+        return True
+    return not token[len(key)].isalpha()
+
+
+def project_extra_args(name):
+    """v8args / ibcmdargs from .v8-project.json — same upward walk as v8path."""
+    d = os.getcwd()
+    while True:
+        pf = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pf):
+            try:
+                with open(pf, encoding="utf-8-sig") as f:
+                    data = json.load(f)
+                v = data.get(name)
+                if v:
+                    return [str(x) for x in v]
+            except Exception:
+                pass
+            return []
+        parent = os.path.dirname(d)
+        if parent == d:
+            return []
+        d = parent
+
+
+def assert_extra_args(extra, engine, hints):
+    """The platform accepts only one batch operation, and a duplicate connection or
+    output key fails with an opaque 1C error — reject what the skill owns itself."""
+    param = "-AdditionalIbcmdArguments" if engine == "ibcmd" else "-AdditionalV8Arguments"
+    owned = IBCMD_OWNED_KEYS if engine == "ibcmd" else V8_OWNED_KEYS
+    for tok in extra:
+        if engine == "ibcmd" and not tok.startswith("-"):
+            print(
+                f"Error: '{tok}' is a positional token — pass values as --key=value "
+                f"({param} cannot extend the ibcmd command)",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        for k in owned:
+            if arg_key_match(tok, k):
+                hint = f" (use {hints[k]})" if hints and k in hints else ""
+                print(
+                    f"Error: {k} is controlled by the skill and cannot be passed via {param}{hint}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+
+def format_args_for_display(arglist, engine):
+    """Redact values of secret-prone keys in glued, =-joined and separate forms.
+    Matching here is a plain prefix (no letter rule): over-masking costs nothing,
+    a leaked password does."""
+    keys = IBCMD_SECRET_KEYS if engine == "ibcmd" else V8_SECRET_KEYS
+    res = []
+    mask_next = False
+    for tok in arglist:
+        if mask_next:
+            res.append("***")
+            mask_next = False
+            continue
+        hit = None
+        for k in keys:
+            if tok[: len(k)].lower() == k.lower():
+                hit = k
+                break
+        if hit is None:
+            res.append(tok)
+        elif len(tok) == len(hit):
+            res.append(tok)
+            mask_next = True
+        elif tok[len(hit)] == "=":
+            res.append(hit + "=***")
+        else:
+            res.append(hit + "***")
+    return res
+
+
+def extract_extra_args(argv, known_opts):
+    """argparse refuses values that start with '-' (every ibcmd key does), so pull the two
+    escape-hatch lists out of argv by hand: after the flag, take everything up to the next
+    declared skill option. Returns (remaining_argv, v8_extra, ibcmd_extra)."""
+    rest, v8, ibcmd = [], [], []
+    i = 0
+    while i < len(argv):
+        low = argv[i].lower()
+        if low in ("-additionalv8arguments", "-additionalibcmdarguments"):
+            target = v8 if low == "-additionalv8arguments" else ibcmd
+            i += 1
+            while i < len(argv) and argv[i].lower() not in known_opts:
+                target.append(argv[i])
+                i += 1
+            continue
+        rest.append(argv[i])
+        i += 1
+    return rest, v8, ibcmd
+
+
+def resolve_extra_args(engine, v8_extra, ibcmd_extra, hints):
+    """Pick the argument list for the selected engine and validate it. An explicitly
+    passed parameter for the other engine is an error; the same keys coming from
+    .v8-project.json simply do not apply — a project may describe both engines.
+
+    Comma-separated elements are split apart: PowerShell's -File cannot bind an array,
+    so that form is the documented one and both ports must accept it. A value containing
+    a comma is not supported."""
+    v8_extra = [p for tok in v8_extra for p in str(tok).split(",") if p]
+    ibcmd_extra = [p for tok in ibcmd_extra for p in str(tok).split(",") if p]
+    if engine == "ibcmd" and v8_extra:
+        print(
+            "Error: -AdditionalV8Arguments applies to 1cv8 only; the selected engine is ibcmd "
+            "(use -AdditionalIbcmdArguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine != "ibcmd" and ibcmd_extra:
+        print(
+            "Error: -AdditionalIbcmdArguments applies to ibcmd only; the selected engine is 1cv8 "
+            "(use -AdditionalV8Arguments)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if engine == "ibcmd":
+        extra = project_extra_args("ibcmdargs") + list(ibcmd_extra)
+    else:
+        extra = project_extra_args("v8args") + list(v8_extra)
+    if extra:
+        assert_extra_args(extra, engine, hints)
+    return extra
+
+
+def _version_dir(p):
+    """Version dir for both Windows (.../1cv8/<ver>/bin/1cv8.exe) and *nix (.../1cv8/<ver>/1cv8)."""
+    parent = os.path.dirname(p)
+    if os.path.basename(parent).lower() == "bin":
+        parent = os.path.dirname(parent)
+    return os.path.basename(parent)
+
+
+def _version_key(p):
+    """Numeric sort key from version dir name."""
+    return [int(x) for x in re.findall(r"\d+", _version_dir(p))]
+
+
+def resolve_v8path(v8path):
+    """Resolve path to a 1C executable (1cv8; ibcmd only when given explicitly)."""
+    if not v8path:
+        v8path = _find_project_v8path()
+    if not v8path:
+        if os.name == "nt":
+            candidates = (
+                glob.glob(r"C:\Program Files\1cv8\*\bin\1cv8.exe")
+                + glob.glob(r"C:\Program Files (x86)\1cv8\*\bin\1cv8.exe")
+            )
+        else:
+            # PY-only: PS-порт на *nix не исполняется, поэтому *nix-раскладки нет в .ps1.
+            candidates = glob.glob("/opt/1cv8/*/1cv8")
+        if candidates:
+            v8path = max(candidates, key=_version_key)
+            print(f"Auto-selected platform {_version_dir(v8path)}: {v8path}")
+        else:
+            print("Error: 1C executable not found. Specify -V8Path", file=sys.stderr)
+            sys.exit(1)
+    if os.path.isdir(v8path):
+        # PY-only: на *nix исполняемый называется "1cv8" (без .exe); ibcmd — только явным путём.
+        exe = "1cv8.exe" if os.name == "nt" else "1cv8"
+        v8path = os.path.join(v8path, exe)
     if not os.path.isfile(v8path):
-        print(f"Error: 1cv8.exe not found at {v8path}", file=sys.stderr)
+        print(f"Error: 1C executable not found at {v8path}", file=sys.stderr)
+        sys.exit(1)
+    return v8path
+
+
+IBCMD_NOUSER_HINT = (
+    "[ibcmd] No -UserName/-Password given; the infobase may require authentication. "
+    "On Windows ibcmd reads credentials from the console (stdin is ignored), so this "
+    "call may block instead of failing. If it does not return promptly, abort and "
+    "re-run with -UserName and -Password.\n"
+)
+
+
+def decode_platform_bytes(data):
+    """ibcmd writes UTF-8 (checked on 8.3.24, 8.3.27, 8.5), a crashing 1cv8 may still emit
+    OEM text. Decode strictly as UTF-8 and fall back to cp866 on invalid bytes — the locale
+    code page (what text=True uses) mangles both."""
+    if not data:
+        return ""
+    try:
+        return data.decode("utf-8")
+    except UnicodeDecodeError:
+        return data.decode("cp866", errors="replace")
+
+
+def assert_infobase_exists(path):
+    """These skills work on a ready infobase. Saying so up front beats the platform's
+    "Неверные или отсутствующие параметры соединения" after a launch."""
+    if not path:
+        return
+    if not os.path.isfile(os.path.join(path, "1Cv8.1CD")):
+        print(f"Error: information base not found at {path} (no 1Cv8.1CD)", file=sys.stderr)
         sys.exit(1)
 
-    return v8path
+
+def clean_path(value, param=""):
+    """Forgive what is unambiguous in a path the caller passed: surrounding whitespace,
+    surrounding quotes that survived shell parsing, a trailing separator. A quote left
+    inside afterwards cannot be part of a real path — reject it by name instead of letting
+    1C answer with its opaque "Неверные или отсутствующие параметры соединения"."""
+    if not value:
+        return value
+    v = value.strip()
+    if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'":
+        v = v[1:-1].strip()
+    if len(v) > 3 and v[-1] in "\\/":
+        v = v[:-1]
+    if '"' in v:
+        print(f"Error: {param or 'path'} contains a quote character: {value}", file=sys.stderr)
+        sys.exit(1)
+    return v
+
+
+def quote_if_needed(token):
+    """Extra arguments come from the caller unquoted; the 1cv8 command line is joined
+    verbatim, so a token with a space needs quotes of its own."""
+    if token and (" " in token or "\t" in token) and '"' not in token:
+        return f'"{token}"'
+    return token
+
+
+def run_v8(v8path, arguments):
+    """Run 1cv8 in batch mode and capture its console output.
+
+    The arguments carry their own quotes inside the value (File="C:\\a b") — that is where
+    1C's parser expects them, on Windows and on *nix alike. Windows list2cmdline would
+    escape those quotes, so there the command line is handed over ready-made.
+    """
+    if os.name == "nt":
+        cmd = '"' + v8path + '" ' + " ".join(arguments)
+    else:
+        cmd = [v8path] + arguments
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def print_platform_output(result):
+    """Print what the platform wrote to the console as its own labelled block. Silence stays
+    silent: in batch mode 1cv8 reports through /Out and prints nothing here."""
+    text = ((result.stdout or "") + (result.stderr or "")).rstrip()
+    if not text:
+        return
+    limit = 65536
+    if len(text) > limit:
+        text = f"[... обрезано, показаны последние {limit} символов ...]\n" + text[-limit:]
+    print("--- Вывод платформы ---")
+    print(text)
+    print("--- End ---")
+
+
+def run_ibcmd(cmd, has_username=False, warn_no_user=True):
+    """Run an ibcmd command non-interactively.
+
+    input="" closes stdin (EOF) so ibcmd's auth prompt fast-fails instead of hanging.
+    On Windows without -UserName ibcmd reads the console directly and may still block —
+    that residual case is flagged via IBCMD_NOUSER_HINT (model-facing).
+    """
+    if warn_no_user and os.name == "nt" and not has_username:
+        sys.stderr.write(IBCMD_NOUSER_HINT)
+        sys.stderr.flush()
+    r = subprocess.run(cmd, input=b"", capture_output=True)
+    r.stdout = decode_platform_bytes(r.stdout)
+    r.stderr = decode_platform_bytes(r.stderr)
+    return r
+
+
+def dir_nonempty(path):
+    """Postcondition: the platform must have written files into the output directory.
+    Exit code 0 with an empty dir (broken/headless env) is a false success — reject it."""
+    return os.path.isdir(path) and any(os.scandir(path))
+
+
+def _redact(text, *secrets):
+    """Redact literal secret values (password, user) from a display string —
+    precise, never touches lookalike paths."""
+    for s in secrets:
+        if s:
+            text = text.replace(s, "***")
+    return text
 
 
 def main():
@@ -53,16 +374,48 @@ def main():
         choices=["Hierarchical", "Plain"],
         help="Dump format (default: Hierarchical)",
     )
-    args = parser.parse_args()
+    parser.add_argument("-AdditionalV8Arguments", nargs="*", default=[],
+                        help="Extra 1cv8 arguments, e.g. /UseHwLicenses+")
+    parser.add_argument("-AdditionalIbcmdArguments", nargs="*", default=[],
+                        help="Extra ibcmd arguments in --key=value form")
+    known_opts = {s.lower() for a in parser._actions for s in a.option_strings}
+    argv, v8_extra, ibcmd_extra = extract_extra_args(sys.argv[1:], known_opts)
+    args = parser.parse_args(argv)
+
+    args.V8Path = clean_path(args.V8Path, "-V8Path")
+    args.InfoBasePath = clean_path(args.InfoBasePath, "-InfoBasePath")
+    assert_infobase_exists(args.InfoBasePath)
+    args.InputFile = clean_path(args.InputFile, "-InputFile")
+    args.OutputDir = clean_path(args.OutputDir, "-OutputDir")
 
     # --- Resolve V8Path ---
     v8path = resolve_v8path(args.V8Path)
+    engine = "ibcmd" if os.path.basename(v8path).lower().startswith("ibcmd") else "1cv8"
+
+    # --- Resolve additional arguments for the selected engine ---
+    arg_hints = {
+        "/F": "-InfoBasePath",
+        "/S": "-InfoBaseServer + -InfoBaseRef",
+        "/N": "-UserName",
+        "/P": "-Password",
+        "--db-path": "-InfoBasePath",
+        "--user": "-UserName",
+        "--password": "-Password",
+    }
+    extra_args = resolve_extra_args(engine, v8_extra, ibcmd_extra, arg_hints)
 
     # --- Validate database connection ---
     if not args.InfoBasePath and (not args.InfoBaseServer or not args.InfoBaseRef):
         print("Error: database connection required. Specify -InfoBasePath or -InfoBaseServer/-InfoBaseRef", file=sys.stderr)
         print("Dump in an empty database loses reference types (CatalogRef, DocumentRef, etc.) irreversibly.")
         sys.exit(1)
+    if engine == "ibcmd":
+        if not args.InfoBasePath:
+            print("Error: ibcmd supports file infobases only (use -InfoBasePath)", file=sys.stderr)
+            sys.exit(1)
+        if args.Format == "Plain":
+            print("Error: ibcmd config export supports hierarchical format only (use -Format Hierarchical or 1cv8)", file=sys.stderr)
+            sys.exit(1)
 
     # --- Validate input file ---
     if not os.path.isfile(args.InputFile):
@@ -78,39 +431,67 @@ def main():
     os.makedirs(temp_dir, exist_ok=True)
 
     try:
+        if engine == "ibcmd":
+            # --- ibcmd branch: dump EPF/ERF via config export --file ---
+            arguments = ["infobase", "config", "export", f"--file={args.InputFile}", args.OutputDir, f"--db-path={args.InfoBasePath}"]
+            ib_data = tempfile.mkdtemp(prefix="ibcmd_data_")
+            atexit.register(shutil.rmtree, ib_data, ignore_errors=True)
+            if args.UserName:
+                arguments.append(f"--user={args.UserName}")
+            if args.Password:
+                arguments.append(f"--password={args.Password}")
+            arguments.append(f"--data={ib_data}")
+            arguments.extend(extra_args)
+            print(f"Running: ibcmd {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
+            result = run_ibcmd([v8path] + arguments, warn_no_user=False)
+            exit_code = result.returncode
+            out_missing = exit_code == 0 and not dir_nonempty(args.OutputDir)
+            if out_missing:
+                exit_code = 1
+            if exit_code == 0:
+                print(f"External data processor/report dumped successfully to: {args.OutputDir}")
+            elif out_missing:
+                print(f"Error: exit code 0 but no files under {args.OutputDir} — dump produced no output", file=sys.stderr)
+            else:
+                print(f"Error dumping external data processor/report (code: {exit_code})", file=sys.stderr)
+            sys.exit(exit_code)
+
         # --- Build arguments ---
         arguments = ["DESIGNER"]
 
         if args.InfoBaseServer and args.InfoBaseRef:
-            arguments += ["/S", f"{args.InfoBaseServer}/{args.InfoBaseRef}"]
+            arguments += ["/S", f'"{args.InfoBaseServer}/{args.InfoBaseRef}"']
         else:
-            arguments += ["/F", args.InfoBasePath]
+            arguments += ["/F", f'"{args.InfoBasePath}"']
 
         if args.UserName:
-            arguments.append(f"/N{args.UserName}")
+            arguments.append(f'/N"{args.UserName}"')
         if args.Password:
-            arguments.append(f"/P{args.Password}")
+            arguments.append(f'/P"{args.Password}"')
 
-        arguments += ["/DumpExternalDataProcessorOrReportToFiles", args.OutputDir, args.InputFile]
+        arguments += ["/DumpExternalDataProcessorOrReportToFiles", f'"{args.OutputDir}"', f'"{args.InputFile}"']
         arguments += ["-Format", args.Format]
 
         # --- Output ---
         out_file = os.path.join(temp_dir, "dump_log.txt")
-        arguments += ["/Out", out_file]
+        arguments += ["/Out", f'"{out_file}"']
         arguments.append("/DisableStartupDialogs")
+        arguments.extend(quote_if_needed(a) for a in extra_args)
 
         # --- Execute ---
-        print(f"Running: 1cv8.exe {' '.join(arguments)}")
+        print(f"Running: 1cv8.exe {_redact(' '.join(format_args_for_display(arguments, engine)), args.Password, args.UserName)}")
-        result = subprocess.run(
+        result = run_v8(v8path, arguments)
-            [v8path] + arguments,
-            capture_output=True,
-            text=True,
-        )
         exit_code = result.returncode
 
         # --- Result ---
+        # Postcondition: exit 0 with an empty output directory is a false success.
+        out_missing = exit_code == 0 and not dir_nonempty(args.OutputDir)
+        if out_missing:
+            exit_code = 1
         if exit_code == 0:
             print(f"Dump completed successfully to: {args.OutputDir}")
+        elif out_missing:
+            print(f"Error: exit code 0 but no files under {args.OutputDir} — dump produced no output", file=sys.stderr)
         else:
             print(f"Error dumping (code: {exit_code})", file=sys.stderr)
 
@@ -125,6 +506,7 @@ def main():
             except Exception:
                 pass
 
+        print_platform_output(result)
         sys.exit(exit_code)
 
     finally:

.claude/skills/epf-init/SKILL.md

@@ -1,41 +1,42 @@
----
+---
-name: epf-init
+name: epf-init
-description: Создать пустую внешнюю обработку 1С (scaffold XML-исходников). Используй когда нужно создать новую внешнюю обработку с нуля
+description: Создать пустую внешнюю обработку 1С (scaffold XML-исходников). Используй когда нужно создать новую внешнюю обработку с нуля
-argument-hint: <Name> [Synonym]
+argument-hint: <Name> [Synonym]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Write
+  - Write
-  - Edit
+  - Edit
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /epf-init — Создание новой обработки
+# /epf-init — Создание новой обработки
-
+
-Генерирует минимальный набор XML-исходников для внешней обработки 1С: корневой файл метаданных и каталог обработки.
+Генерирует минимальный набор XML-исходников для внешней обработки 1С: корневой файл метаданных и каталог обработки.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/epf-init <Name> [Synonym] [SrcDir]
+/epf-init <Name> [Synonym] [SrcDir] [FormatVersion]
-```
+```
-
+
-| Параметр  | Обязательный | По умолчанию | Описание                            |
+| Параметр      | Обязательный | По умолчанию | Описание                                       |
-|-----------|:------------:|--------------|-------------------------------------|
+|---------------|:------------:|--------------|------------------------------------------------|
-| Name      | да           | —            | Имя обработки (латиница/кириллица)  |
+| Name          | да           | —            | Имя обработки (латиница/кириллица)             |
-| Synonym   | нет          | = Name       | Синоним (отображаемое имя)          |
+| Synonym       | нет          | = Name       | Синоним (отображаемое имя)                     |
-| SrcDir    | нет          | `src`        | Каталог исходников относительно CWD |
+| SrcDir        | нет          | `src`        | Каталог исходников относительно CWD            |
-
+| FormatVersion | нет          | `2.17`       | Версия формата: 2.20 — платформа 8.3.27, 2.21 — 8.5. Дефолт открывается любой платформой |
-## Команда
+
-
+## Команда
-```powershell
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
+```powershell
-```
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-FormatVersion "<2.17|2.18|2.19|2.20|2.21>"]
-
+```
-## Дальнейшие шаги
+
-
+## Дальнейшие шаги
-- Добавить форму: `/form-add`
+
-- Добавить макет: `/template-add`
+- Добавить форму: `/form-add`
-- Добавить справку: `/help-add`
+- Добавить макет: `/template-add`
-- Собрать EPF: `/epf-build`
+- Добавить справку: `/help-add`
+- Собрать EPF: `/epf-build`

.claude/skills/epf-init/scripts/init.ps1

@@ -1,90 +1,118 @@
-# epf-init v1.1 — Init 1C external data processor scaffold
+# epf-init v1.4 — Init 1C external data processor scaffold
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-param(
+param(
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$Name,
+	[string]$Name,
-
+
-	[string]$Synonym = $Name,
+	[string]$Synonym = $Name,
-
+
-	[string]$SrcDir = "src"
+	[string]$SrcDir = "src",
-)
+
-
+	# Версия формата выгрузки. Своей конфигурации у автономной обработки нет, наследовать
-$ErrorActionPreference = "Stop"
+	# версию неоткуда — поэтому её задают явно. Формы, макеты и справку внутри обработки
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+	# навыки берут уже отсюда: их детектор читает version из корня этого файла.
-[Console]::InputEncoding = [System.Text.Encoding]::UTF8
+	[ValidateSet("2.17", "2.18", "2.19", "2.20", "2.21")]
-
+	[string]$FormatVersion = "2.17"
-$uuid1 = [guid]::NewGuid().ToString()
+)
-$uuid2 = [guid]::NewGuid().ToString()
+
-$uuid3 = [guid]::NewGuid().ToString()
+$ErrorActionPreference = "Stop"
-$uuid4 = [guid]::NewGuid().ToString()
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8
-$xml = @"
+
-<?xml version="1.0" encoding="UTF-8"?>
+$uuid1 = [guid]::NewGuid().ToString()
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+$uuid2 = [guid]::NewGuid().ToString()
-	<ExternalDataProcessor uuid="$uuid1">
+$uuid3 = [guid]::NewGuid().ToString()
-		<InternalInfo>
+$uuid4 = [guid]::NewGuid().ToString()
-			<xr:ContainedObject>
+
-				<xr:ClassId>c3831ec8-d8d5-4f93-8a22-f9bfae07327f</xr:ClassId>
+# Объявления пространств имён — одной переменной: места эмиссии её только интерполируют.
-				<xr:ObjectId>$uuid2</xr:ObjectId>
+$xmlnsDecl = 'xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-			</xr:ContainedObject>
+# 2.21 (8.5) добавила в шапку пространство палитры. Вставляем НА МЕСТО (после lf, перед style):
-			<xr:GeneratedType name="ExternalDataProcessorObject.$Name" category="Object">
+# платформа держит объявления по алфавиту, дописать в конец нельзя.
-				<xr:TypeId>$uuid3</xr:TypeId>
+if (($FormatVersion -match '^(\d+)\.(\d+)$') -and ([int]$Matches[1] * 100 + [int]$Matches[2]) -ge 221) {
-				<xr:ValueId>$uuid4</xr:ValueId>
+	$xmlnsDecl = $xmlnsDecl -replace ' xmlns:style=', ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
-			</xr:GeneratedType>
+}
-		</InternalInfo>
+
-		<Properties>
+$xml = @"
-			<Name>$Name</Name>
+<?xml version="1.0" encoding="UTF-8"?>
-			<Synonym>
+<MetaDataObject $xmlnsDecl version="$FormatVersion">
-				<v8:item>
+	<ExternalDataProcessor uuid="$uuid1">
-					<v8:lang>ru</v8:lang>
+		<InternalInfo>
-					<v8:content>$Synonym</v8:content>
+			<xr:ContainedObject>
-				</v8:item>
+				<xr:ClassId>c3831ec8-d8d5-4f93-8a22-f9bfae07327f</xr:ClassId>
-			</Synonym>
+				<xr:ObjectId>$uuid2</xr:ObjectId>
-			<Comment/>
+			</xr:ContainedObject>
-			<DefaultForm/>
+			<xr:GeneratedType name="ExternalDataProcessorObject.$Name" category="Object">
-			<AuxiliaryForm/>
+				<xr:TypeId>$uuid3</xr:TypeId>
-		</Properties>
+				<xr:ValueId>$uuid4</xr:ValueId>
-		<ChildObjects/>
+			</xr:GeneratedType>
-	</ExternalDataProcessor>
+		</InternalInfo>
-</MetaDataObject>
+		<Properties>
-"@
+			<Name>$Name</Name>
-
+			<Synonym>
-$rootFile = Join-Path $SrcDir "$Name.xml"
+				<v8:item>
-$processorDir = Join-Path $SrcDir $Name
+					<v8:lang>ru</v8:lang>
-
+					<v8:content>$Synonym</v8:content>
-if (Test-Path $rootFile) {
+				</v8:item>
-	Write-Error "Файл уже существует: $rootFile"
+			</Synonym>
-	exit 1
+			<Comment/>
-}
+			<DefaultForm/>
-
+			<AuxiliaryForm/>
-if (-not (Test-Path $SrcDir)) {
+		</Properties>
-	New-Item -ItemType Directory -Path $SrcDir -Force | Out-Null
+		<ChildObjects/>
-}
+	</ExternalDataProcessor>
-$extDir = Join-Path $processorDir "Ext"
+</MetaDataObject>
-New-Item -ItemType Directory -Path $extDir -Force | Out-Null
+"@
-
+
-$enc = New-Object System.Text.UTF8Encoding($true)
+$rootFile = Join-Path $SrcDir "$Name.xml"
-[System.IO.File]::WriteAllText((Resolve-Path $SrcDir | Join-Path -ChildPath "$Name.xml"), $xml, $enc)
+$processorDir = Join-Path $SrcDir $Name
-
+
-# --- Модуль объекта ---
+if (Test-Path $rootFile) {
-
+	Write-Error "Файл уже существует: $rootFile"
-$moduleBsl = @"
+	exit 1
-#Область ОписаниеПеременных
+}
-
+
-#КонецОбласти
+if (-not (Test-Path $SrcDir)) {
-
+	New-Item -ItemType Directory -Path $SrcDir -Force | Out-Null
-#Область ПрограммныйИнтерфейс
+}
-
+$extDir = Join-Path $processorDir "Ext"
-#КонецОбласти
+New-Item -ItemType Directory -Path $extDir -Force | Out-Null
-
+
-#Область СлужебныеПроцедурыИФункции
+$enc = New-Object System.Text.UTF8Encoding($true)
-
+# XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
-#КонецОбласти
+#
-"@
+# Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
-
+# копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
-$modulePath = Join-Path $extDir "ObjectModule.bsl"
+function Write-XmlFile([string]$path, [string]$text, $encoding) {
-[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $enc)
+	$t = ($text -replace "`r`n", "`n") -replace "`n", "`r`n"
-
+	[System.IO.File]::WriteAllText($path, $t.TrimEnd("`r", "`n"), $encoding)
-Write-Host "[OK] Создана обработка: $rootFile"
+}
-Write-Host "     Каталог: $processorDir"
+
-Write-Host "     Модуль:  $modulePath"
+Write-XmlFile (Resolve-Path $SrcDir | Join-Path -ChildPath "$Name.xml") $xml $enc
+
+# --- Модуль объекта ---
+
+$moduleBsl = @"
+#Область ОписаниеПеременных
+
+#КонецОбласти
+
+#Область ПрограммныйИнтерфейс
+
+#КонецОбласти
+
+#Область СлужебныеПроцедурыИФункции
+
+#КонецОбласти
+"@
+
+$modulePath = Join-Path $extDir "ObjectModule.bsl"
+# Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
+# чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
+# неканоничен (1235 модулей с ним, 766 без). Шаблон берёт переводы строк из
+# самого скрипта, а он в репозитории хранится с LF.
+$moduleBsl = ($moduleBsl -replace "`r`n", "`n") -replace "`n", "`r`n"
+[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $enc)
+
+Write-Host "[OK] Создана обработка: $rootFile"
+Write-Host "     Каталог: $processorDir"
+Write-Host "     Модуль:  $modulePath"

.claude/skills/epf-init/scripts/init.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python3
-# epf-init v1.1 — Init 1C external data processor scaffold
+# epf-init v1.4 — Init 1C external data processor scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C external data processor."""
-import sys, os, argparse, uuid
+import sys, os, re, argparse, uuid
 
 def esc_xml(s):
     return s.replace('&','&amp;').replace('<','&lt;').replace('>','&gt;').replace('"','&quot;')
@@ -14,6 +14,22 @@ def write_utf8_bom(path, content):
     with open(path, 'w', encoding='utf-8-sig', newline='') as f:
         f.write(content)
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    write_utf8_bom(path, text)
+
+
+def format_rank(ver):
+    """"2.20" → 220, "2.9" → 209. Строковое сравнение неверно ("2.9" > "2.17")."""
+    m = re.match(r'^(\d+)\.(\d+)$', ver or '')
+    return int(m.group(1)) * 100 + int(m.group(2)) if m else 0
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -21,6 +37,11 @@ def main():
     parser.add_argument('-Name', dest='Name', required=True)
     parser.add_argument('-Synonym', dest='Synonym', default=None)
     parser.add_argument('-SrcDir', dest='SrcDir', default='src')
+    # Версия формата выгрузки. Своей конфигурации у автономного объекта нет, наследовать
+    # версию неоткуда — поэтому её задают явно. Формы, макеты и справку внутри объекта
+    # навыки берут уже отсюда: их детектор читает version из корня этого файла.
+    parser.add_argument('-FormatVersion', dest='FormatVersion', default='2.17',
+                        choices=['2.17', '2.18', '2.19', '2.20', '2.21'])
     args = parser.parse_args()
 
     name = args.Name
@@ -32,8 +53,36 @@ def main():
     uuid3 = new_uuid()
     uuid4 = new_uuid()
 
+    # Объявления пространств имён — одной переменной: места эмиссии её только подставляют.
+    xmlns_decl = (
+        'xmlns="http://v8.1c.ru/8.3/MDClasses"'
+        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
+        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
+        ' xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi"'
+        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
+        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
+        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
+        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
+        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
+        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
+        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
+        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
+        ' xmlns:xen="http://v8.1c.ru/8.3/xcf/enums"'
+        ' xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef"'
+        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
+        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+    )
+    format_version = args.FormatVersion
+    # 2.21 (8.5) добавила в шапку пространство палитры. Вставляем НА МЕСТО (после lf, перед
+    # style): платформа держит объявления по алфавиту, дописать в конец нельзя.
+    if format_rank(format_version) >= 221:
+        xmlns_decl = xmlns_decl.replace(
+            ' xmlns:style=',
+            ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style=')
+
     xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<ExternalDataProcessor uuid="{uuid1}">
 \t\t<InternalInfo>
 \t\t\t<xr:ContainedObject>
@@ -72,7 +121,7 @@ def main():
     ext_dir = os.path.join(processor_dir, "Ext")
     os.makedirs(ext_dir, exist_ok=True)
 
-    write_utf8_bom(os.path.join(os.path.abspath(src_dir), f"{name}.xml"), xml)
+    write_xml_file(os.path.join(os.path.abspath(src_dir), f"{name}.xml"), xml)
 
     # --- Модуль объекта ---
     module_bsl = """\
@@ -89,7 +138,10 @@ def main():
 #КонецОбласти"""
 
     module_path = os.path.join(ext_dir, "ObjectModule.bsl")
-    write_utf8_bom(module_path, module_bsl)
+    # Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
+    # чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
+    # неканоничен (1235 модулей с ним, 766 без).
+    write_utf8_bom(module_path, module_bsl.replace('\r\n', '\n').replace('\n', '\r\n'))
 
     print(f"[OK] Создана обработка: {root_file}")
     print(f"     Каталог: {processor_dir}")

.claude/skills/epf-validate/SKILL.md

@@ -1,30 +1,30 @@
----
+---
-name: epf-validate
+name: epf-validate
-description: Валидация внешней обработки 1С (EPF). Используй после создания или модификации обработки для проверки корректности
+description: Валидация внешней обработки 1С (EPF). Используй после создания или модификации обработки для проверки корректности
-argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
+argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /epf-validate — валидация внешней обработки (EPF)
+# /epf-validate — валидация внешней обработки (EPF)
-
+
-Проверяет структурную корректность XML-исходников внешней обработки: корневую структуру, InternalInfo, свойства, ChildObjects, реквизиты, табличные части, уникальность имён, наличие файлов форм и макетов. Также работает для внешних отчётов (ERF).
+Проверяет структурную корректность XML-исходников внешней обработки: корневую структуру, InternalInfo, свойства, ChildObjects, реквизиты, табличные части, уникальность имён, наличие файлов форм и макетов. Также работает для внешних отчётов (ERF).
-
+
-## Параметры
+## Параметры
-
+
-| Параметр   | Обяз. | Умолч. | Описание                                      |
+| Параметр   | Обяз. | Умолч. | Описание                                      |
-|------------|:-----:|---------|-------------------------------------------------|
+|------------|:-----:|---------|-------------------------------------------------|
-| ObjectPath | да    | —       | Путь к корневому XML или каталогу обработки     |
+| ObjectPath | да    | —       | Путь к корневому XML или каталогу обработки     |
-| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
+| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
-| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
+| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
-| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
+| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка/МояОбработка.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка/МояОбработка.xml"
-```
+```
-
+

.claude/skills/epf-validate/scripts/epf-validate.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# epf-validate v1.2 — Validate 1C external data processor / report structure
+# epf-validate v1.3 — Validate 1C external data processor / report structure
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 # Works for both EPF (ExternalDataProcessor) and ERF (ExternalReport) — auto-detects
 
@@ -165,8 +165,9 @@ def main():
     version = root.get("version", "")
     if not version:
         report_warn("1. Missing version attribute on MetaDataObject")
-    elif version not in ("2.17", "2.20", "2.21"):
+    elif version not in ("2.17", "2.18", "2.19", "2.20", "2.21"):
-        report_warn(f"1. Unusual version '{version}' (expected 2.17, 2.20 or 2.21)")
+        # Лестница версий формата: 2.17 (8.3.20-8.3.24), 2.18 (8.3.25), 2.19 (8.3.26), 2.20 (8.3.27).
+        report_warn(f"1. Unusual version '{version}' (expected 2.17-2.20 or 2.21)")
 
     # Detect type
     child_elements = []

.claude/skills/erf-build/SKILL.md

@@ -1,71 +1,73 @@
----
+---
-name: erf-build
+name: erf-build
-description: Собрать внешний отчёт 1С (ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать отчёт или получить ERF файл из исходников
+description: Собрать внешний отчёт 1С (ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать отчёт или получить ERF файл из исходников
-argument-hint: <ReportName>
+argument-hint: <ReportName>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /erf-build — Сборка отчёта
+# /erf-build — Сборка отчёта
-
+
-## Usage
+## Usage
-
+
-```
+```
-/erf-build <ReportName> [SrcDir] [OutDir]
+/erf-build <ReportName> [SrcDir] [OutDir]
-```
+```
-
+
-| Параметр   | Обязательный | По умолчанию | Описание                             |
+| Параметр   | Обязательный | По умолчанию | Описание                             |
-|------------|:------------:|--------------|--------------------------------------|
+|------------|:------------:|--------------|--------------------------------------|
-| ReportName | да           | —            | Имя отчёта (имя корневого XML)       |
+| ReportName | да           | —            | Имя отчёта (имя корневого XML)       |
-| SrcDir     | нет          | `src`        | Каталог исходников                   |
+| SrcDir     | нет          | `src`        | Каталог исходников                   |
-| OutDir     | нет          | `build`      | Каталог для результата               |
+| OutDir     | нет          | `build`      | Каталог для результата               |
-
+
-## Параметры подключения (опционально)
+## Параметры подключения (опционально)
-
+
-Предпочтительно использовать конкретную базу — это надёжнее и не требует создания временной базы.
+Предпочтительно использовать конкретную базу — это надёжнее и не требует создания временной базы.
-
+
-1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
+1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
-2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-5. Если ветка не совпала — используй `default`
+5. Если ветка не совпала — используй `default`
-6. Если `.v8-project.json` нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для ERF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
+6. Если `.v8-project.json` нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для ERF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
-
+
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-Используй общий скрипт из epf-build:
+Используй общий скрипт из epf-build:
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-SourceFile <путь>` | да | Путь к корневому XML-файлу исходников |
+| `-SourceFile <путь>` | да | Путь к корневому XML-файлу исходников |
-| `-OutputFile <путь>` | да | Путь к выходному ERF-файлу |
+| `-OutputFile <путь>` | да | Путь к выходному ERF-файлу |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Примеры
+> `*` — опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
-
+
-```powershell
+## Примеры
-# Сборка отчёта (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+```powershell
-
+# Сборка отчёта (файловая база)
-# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+
-```
+# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+```

.claude/skills/erf-dump/SKILL.md

@@ -1,71 +1,73 @@
----
+---
-name: erf-dump
+name: erf-dump
-description: Разобрать ERF-файл отчёта 1С в XML-исходники. Используй когда пользователь просит разобрать, декомпилировать отчёт, получить исходники из ERF файла
+description: Разобрать ERF-файл отчёта 1С в XML-исходники. Используй когда пользователь просит разобрать, декомпилировать отчёт, получить исходники из ERF файла
-argument-hint: <ErfFile>
+argument-hint: <ErfFile>
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /erf-dump — Разборка отчёта
+# /erf-dump — Разборка отчёта
-
+
-## Usage
+## Usage
-
+
-```
+```
-/erf-dump <ErfFile> [OutDir]
+/erf-dump <ErfFile> [OutDir]
-```
+```
-
+
-| Параметр | Обязательный | По умолчанию | Описание                            |
+| Параметр | Обязательный | По умолчанию | Описание                            |
-|----------|:------------:|--------------|-------------------------------------|
+|----------|:------------:|--------------|-------------------------------------|
-| ErfFile  | да           | —            | Путь к ERF-файлу                    |
+| ErfFile  | да           | —            | Путь к ERF-файлу                    |
-| OutDir   | нет          | `src`        | Каталог для выгрузки исходников     |
+| OutDir   | нет          | `src`        | Каталог для выгрузки исходников     |
-
+
-## Параметры подключения (обязательно)
+## Параметры подключения (обязательно)
-
+
-Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
+Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
-
+
-1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
+1. Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
-2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
+2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
-3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
+3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
-4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
+4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
-5. Если ветка не совпала — используй `default`
+5. Если ветка не совпала — используй `default`
-6. Если `.v8-project.json` нет или база не найдена — **сообщи пользователю об ошибке**. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через `/db-list add`.
+6. Если `.v8-project.json` нет или база не найдена — **сообщи пользователю об ошибке**. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через `/db-list add`.
-
+
-Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
+Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
-Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
+Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
-
+
-## Команда
+## Команда
-
+
-Используй общий скрипт из epf-dump:
+Используй общий скрипт из epf-dump:
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" <параметры>
-```
+```
-
+
-### Параметры скрипта
+### Параметры скрипта
-
+
-| Параметр | Обязательный | Описание |
+| Параметр | Обязательный | Описание |
-|----------|:------------:|----------|
+|----------|:------------:|----------|
-| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
-| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBasePath <путь>` | * | Файловая база |
-| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
-| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
-| `-UserName <имя>` | нет | Имя пользователя |
+| `-UserName <имя>` | нет | Имя пользователя |
-| `-Password <пароль>` | нет | Пароль |
+| `-Password <пароль>` | нет | Пароль |
-| `-InputFile <путь>` | да | Путь к ERF-файлу |
+| `-InputFile <путь>` | да | Путь к ERF-файлу |
-| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
+| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
-| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
+| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
-
+| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
-> `*` — обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
+| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
-
+
-## Примеры
+> `*` — обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
-
+
-```powershell
+## Примеры
-# Разборка отчёта (файловая база)
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+```powershell
-
+# Разборка отчёта (файловая база)
-# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+
-```
+# Серверная база
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+```

.claude/skills/erf-init/SKILL.md

@@ -1,42 +1,43 @@
----
+---
-name: erf-init
+name: erf-init
-description: Создать пустой внешний отчёт 1С (scaffold XML-исходников). Используй когда нужно создать новый внешний отчёт с нуля
+description: Создать пустой внешний отчёт 1С (scaffold XML-исходников). Используй когда нужно создать новый внешний отчёт с нуля
-argument-hint: <Name> [Synonym] [--with-skd]
+argument-hint: <Name> [Synonym] [--with-skd]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Write
+  - Write
-  - Edit
+  - Edit
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /erf-init — Создание нового отчёта
+# /erf-init — Создание нового отчёта
-
+
-Генерирует минимальный набор XML-исходников для внешнего отчёта 1С: корневой файл метаданных и каталог отчёта.
+Генерирует минимальный набор XML-исходников для внешнего отчёта 1С: корневой файл метаданных и каталог отчёта.
-
+
-## Usage
+## Usage
-
+
-```
+```
-/erf-init <Name> [Synonym] [SrcDir] [--with-skd]
+/erf-init <Name> [Synonym] [SrcDir] [FormatVersion] [--with-skd]
-```
+```
-
+
-| Параметр  | Обязательный | По умолчанию | Описание                              |
+| Параметр      | Обязательный | По умолчанию | Описание                              |
-|-----------|:------------:|--------------|---------------------------------------|
+|---------------|:------------:|--------------|---------------------------------------|
-| Name      | да           | —            | Имя отчёта (латиница/кириллица)       |
+| Name          | да           | —            | Имя отчёта (латиница/кириллица)       |
-| Synonym   | нет          | = Name       | Синоним (отображаемое имя)            |
+| Synonym       | нет          | = Name       | Синоним (отображаемое имя)            |
-| SrcDir    | нет          | `src`        | Каталог исходников относительно CWD   |
+| SrcDir        | нет          | `src`        | Каталог исходников относительно CWD   |
-| --WithSKD | нет          | —            | Создать пустую СКД и привязать к MainDataCompositionSchema |
+| FormatVersion | нет          | `2.17`       | Версия формата: 2.20 — платформа 8.3.27, 2.21 — 8.5. Дефолт открывается любой платформой |
-
+| --WithSKD     | нет          | —            | Создать пустую СКД и привязать к MainDataCompositionSchema |
-## Команда
+
-
+## Команда
-```powershell
+
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
+```powershell
-```
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-FormatVersion "<2.17|2.18|2.19|2.20|2.21>"] [-WithSKD]
-
+```
-## Дальнейшие шаги
+
-
+## Дальнейшие шаги
-- Добавить форму: `/form-add`
+
-- Добавить макет: `/template-add`
+- Добавить форму: `/form-add`
-- Добавить справку: `/help-add`
+- Добавить макет: `/template-add`
-- Собрать ERF: `/erf-build`
+- Добавить справку: `/help-add`
+- Собрать ERF: `/erf-build`

.claude/skills/erf-init/scripts/init.ps1

@@ -1,180 +1,208 @@
-# erf-init v1.1 — Init 1C external report scaffold
+# erf-init v1.4 — Init 1C external report scaffold
-# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-param(
+param(
-	[Parameter(Mandatory)]
+	[Parameter(Mandatory)]
-	[string]$Name,
+	[string]$Name,
-
+
-	[string]$Synonym = $Name,
+	[string]$Synonym = $Name,
-
+
-	[string]$SrcDir = "src",
+	[string]$SrcDir = "src",
-
+
-	[switch]$WithSKD
+	[switch]$WithSKD,
-)
+
-
+	# Версия формата выгрузки. Своей конфигурации у автономного отчёта нет, наследовать
-$ErrorActionPreference = "Stop"
+	# версию неоткуда — поэтому её задают явно. Формы, макеты и справку внутри отчёта
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+	# навыки берут уже отсюда: их детектор читает version из корня этого файла.
-[Console]::InputEncoding = [System.Text.Encoding]::UTF8
+	[ValidateSet("2.17", "2.18", "2.19", "2.20", "2.21")]
-
+	[string]$FormatVersion = "2.17"
-$uuid1 = [guid]::NewGuid().ToString()
+)
-$uuid2 = [guid]::NewGuid().ToString()
+
-$uuid3 = [guid]::NewGuid().ToString()
+$ErrorActionPreference = "Stop"
-$uuid4 = [guid]::NewGuid().ToString()
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8
-# --- Формируем Properties ---
+
-
+$uuid1 = [guid]::NewGuid().ToString()
-$mainDCSValue = ""
+$uuid2 = [guid]::NewGuid().ToString()
-$childObjectsContent = ""
+$uuid3 = [guid]::NewGuid().ToString()
-
+$uuid4 = [guid]::NewGuid().ToString()
-if ($WithSKD) {
+
-	$mainDCSValue = "ExternalReport.$Name.Template.ОсновнаяСхемаКомпоновкиДанных"
+# Объявления пространств имён — одной переменной: места эмиссии её только интерполируют.
-	$childObjectsContent = @"
+$xmlnsDecl = 'xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-
+# 2.21 (8.5) добавила в шапку пространство палитры. Вставляем НА МЕСТО (после lf, перед style):
-			<Template>ОсновнаяСхемаКомпоновкиДанных</Template>
+# платформа держит объявления по алфавиту, дописать в конец нельзя.
-
+if (($FormatVersion -match '^(\d+)\.(\d+)$') -and ([int]$Matches[1] * 100 + [int]$Matches[2]) -ge 221) {
-"@
+	$xmlnsDecl = $xmlnsDecl -replace ' xmlns:style=', ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
-}
+}
-
+
-$mainDCSElement = if ($mainDCSValue) {
+# --- Формируем Properties ---
-	"<MainDataCompositionSchema>$mainDCSValue</MainDataCompositionSchema>"
+
-} else {
+$mainDCSValue = ""
-	"<MainDataCompositionSchema/>"
+$childObjectsContent = ""
-}
+
-
+if ($WithSKD) {
-$childObjectsXml = if ($childObjectsContent) {
+	$mainDCSValue = "ExternalReport.$Name.Template.ОсновнаяСхемаКомпоновкиДанных"
-	"<ChildObjects>$childObjectsContent</ChildObjects>"
+	$childObjectsContent = @"
-} else {
+
-	"<ChildObjects/>"
+			<Template>ОсновнаяСхемаКомпоновкиДанных</Template>
-}
+
-
+"@
-$xml = @"
+}
-<?xml version="1.0" encoding="UTF-8"?>
+
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+$mainDCSElement = if ($mainDCSValue) {
-	<ExternalReport uuid="$uuid1">
+	"<MainDataCompositionSchema>$mainDCSValue</MainDataCompositionSchema>"
-		<InternalInfo>
+} else {
-			<xr:ContainedObject>
+	"<MainDataCompositionSchema/>"
-				<xr:ClassId>e41aff26-25cf-4bb6-b6c1-3f478a75f374</xr:ClassId>
+}
-				<xr:ObjectId>$uuid2</xr:ObjectId>
+
-			</xr:ContainedObject>
+$childObjectsXml = if ($childObjectsContent) {
-			<xr:GeneratedType name="ExternalReportObject.$Name" category="Object">
+	"<ChildObjects>$childObjectsContent</ChildObjects>"
-				<xr:TypeId>$uuid3</xr:TypeId>
+} else {
-				<xr:ValueId>$uuid4</xr:ValueId>
+	"<ChildObjects/>"
-			</xr:GeneratedType>
+}
-		</InternalInfo>
+
-		<Properties>
+$xml = @"
-			<Name>$Name</Name>
+<?xml version="1.0" encoding="UTF-8"?>
-			<Synonym>
+<MetaDataObject $xmlnsDecl version="$FormatVersion">
-				<v8:item>
+	<ExternalReport uuid="$uuid1">
-					<v8:lang>ru</v8:lang>
+		<InternalInfo>
-					<v8:content>$Synonym</v8:content>
+			<xr:ContainedObject>
-				</v8:item>
+				<xr:ClassId>e41aff26-25cf-4bb6-b6c1-3f478a75f374</xr:ClassId>
-			</Synonym>
+				<xr:ObjectId>$uuid2</xr:ObjectId>
-			<Comment/>
+			</xr:ContainedObject>
-			<DefaultForm/>
+			<xr:GeneratedType name="ExternalReportObject.$Name" category="Object">
-			<AuxiliaryForm/>
+				<xr:TypeId>$uuid3</xr:TypeId>
-			$mainDCSElement
+				<xr:ValueId>$uuid4</xr:ValueId>
-			<DefaultSettingsForm/>
+			</xr:GeneratedType>
-			<AuxiliarySettingsForm/>
+		</InternalInfo>
-			<DefaultVariantForm/>
+		<Properties>
-			<VariantsStorage/>
+			<Name>$Name</Name>
-			<SettingsStorage/>
+			<Synonym>
-		</Properties>
+				<v8:item>
-		$childObjectsXml
+					<v8:lang>ru</v8:lang>
-	</ExternalReport>
+					<v8:content>$Synonym</v8:content>
-</MetaDataObject>
+				</v8:item>
-"@
+			</Synonym>
-
+			<Comment/>
-$rootFile = Join-Path $SrcDir "$Name.xml"
+			<DefaultForm/>
-$reportDir = Join-Path $SrcDir $Name
+			<AuxiliaryForm/>
-
+			$mainDCSElement
-if (Test-Path $rootFile) {
+			<DefaultSettingsForm/>
-	Write-Error "Файл уже существует: $rootFile"
+			<AuxiliarySettingsForm/>
-	exit 1
+			<DefaultVariantForm/>
-}
+			<VariantsStorage/>
-
+			<SettingsStorage/>
-if (-not (Test-Path $SrcDir)) {
+		</Properties>
-	New-Item -ItemType Directory -Path $SrcDir -Force | Out-Null
+		$childObjectsXml
-}
+	</ExternalReport>
-$extDir = Join-Path $reportDir "Ext"
+</MetaDataObject>
-New-Item -ItemType Directory -Path $extDir -Force | Out-Null
+"@
-
+
-$enc = New-Object System.Text.UTF8Encoding($true)
+$rootFile = Join-Path $SrcDir "$Name.xml"
-[System.IO.File]::WriteAllText((Resolve-Path $SrcDir | Join-Path -ChildPath "$Name.xml"), $xml, $enc)
+$reportDir = Join-Path $SrcDir $Name
-
+
-# --- Модуль объекта ---
+if (Test-Path $rootFile) {
-
+	Write-Error "Файл уже существует: $rootFile"
-$moduleBsl = @"
+	exit 1
-#Область ОписаниеПеременных
+}
-
+
-#КонецОбласти
+if (-not (Test-Path $SrcDir)) {
-
+	New-Item -ItemType Directory -Path $SrcDir -Force | Out-Null
-#Область ПрограммныйИнтерфейс
+}
-
+$extDir = Join-Path $reportDir "Ext"
-#КонецОбласти
+New-Item -ItemType Directory -Path $extDir -Force | Out-Null
-
+
-#Область СлужебныеПроцедурыИФункции
+$enc = New-Object System.Text.UTF8Encoding($true)
-
+# XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
-#КонецОбласти
+#
-"@
+# Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
-
+# копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
-$modulePath = Join-Path $extDir "ObjectModule.bsl"
+function Write-XmlFile([string]$path, [string]$text, $encoding) {
-[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $enc)
+	$t = ($text -replace "`r`n", "`n") -replace "`n", "`r`n"
-
+	[System.IO.File]::WriteAllText($path, $t.TrimEnd("`r", "`n"), $encoding)
-Write-Host "[OK] Создан отчёт: $rootFile"
+}
-Write-Host "     Каталог: $reportDir"
+
-Write-Host "     Модуль:  $modulePath"
+Write-XmlFile (Resolve-Path $SrcDir | Join-Path -ChildPath "$Name.xml") $xml $enc
-
+
-# --- СКД-макет (если --WithSKD) ---
+# --- Модуль объекта ---
-
+
-if ($WithSKD) {
+$moduleBsl = @"
-	$templatesDir = Join-Path $reportDir "Templates"
+#Область ОписаниеПеременных
-	$skdName = "ОсновнаяСхемаКомпоновкиДанных"
+
-	$skdMetaPath = Join-Path $templatesDir "$skdName.xml"
+#КонецОбласти
-	$skdExtDir = Join-Path (Join-Path $templatesDir $skdName) "Ext"
+
-	New-Item -ItemType Directory -Path $skdExtDir -Force | Out-Null
+#Область ПрограммныйИнтерфейс
-
+
-	$skdUuid = [guid]::NewGuid().ToString()
+#КонецОбласти
-
+
-	$skdMetaXml = @"
+#Область СлужебныеПроцедурыИФункции
-<?xml version="1.0" encoding="UTF-8"?>
+
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+#КонецОбласти
-	<Template uuid="$skdUuid">
+"@
-		<Properties>
+
-			<Name>$skdName</Name>
+$modulePath = Join-Path $extDir "ObjectModule.bsl"
-			<Synonym>
+# Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
-				<v8:item>
+# чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
-					<v8:lang>ru</v8:lang>
+# неканоничен (1235 модулей с ним, 766 без). Шаблон берёт переводы строк из
-					<v8:content>Основная схема компоновки данных</v8:content>
+# самого скрипта, а он в репозитории хранится с LF.
-				</v8:item>
+$moduleBsl = ($moduleBsl -replace "`r`n", "`n") -replace "`n", "`r`n"
-			</Synonym>
+[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $enc)
-			<Comment/>
+
-			<TemplateType>DataCompositionSchema</TemplateType>
+Write-Host "[OK] Создан отчёт: $rootFile"
-		</Properties>
+Write-Host "     Каталог: $reportDir"
-	</Template>
+Write-Host "     Модуль:  $modulePath"
-</MetaDataObject>
+
-"@
+# --- СКД-макет (если --WithSKD) ---
-
+
-	[System.IO.File]::WriteAllText($skdMetaPath, $skdMetaXml, $enc)
+if ($WithSKD) {
-
+	$templatesDir = Join-Path $reportDir "Templates"
-	$skdContent = @"
+	$skdName = "ОсновнаяСхемаКомпоновкиДанных"
-<?xml version="1.0" encoding="UTF-8"?>
+	$skdMetaPath = Join-Path $templatesDir "$skdName.xml"
-<DataCompositionSchema xmlns="http://v8.1c.ru/8.1/data-composition-system/schema"
+	$skdExtDir = Join-Path (Join-Path $templatesDir $skdName) "Ext"
-		xmlns:dcscom="http://v8.1c.ru/8.1/data-composition-system/common"
+	New-Item -ItemType Directory -Path $skdExtDir -Force | Out-Null
-		xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"
+
-		xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"
+	$skdUuid = [guid]::NewGuid().ToString()
-		xmlns:v8="http://v8.1c.ru/8.1/data/core"
+
-		xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"
+	$skdMetaXml = @"
-		xmlns:xs="http://www.w3.org/2001/XMLSchema"
+<?xml version="1.0" encoding="UTF-8"?>
-		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<MetaDataObject $xmlnsDecl version="$FormatVersion">
-	<dataSource>
+	<Template uuid="$skdUuid">
-		<name>ИсточникДанных1</name>
+		<Properties>
-		<dataSourceType>Local</dataSourceType>
+			<Name>$skdName</Name>
-	</dataSource>
+			<Synonym>
-</DataCompositionSchema>
+				<v8:item>
-"@
+					<v8:lang>ru</v8:lang>
-
+					<v8:content>Основная схема компоновки данных</v8:content>
-	$skdFilePath = Join-Path $skdExtDir "Template.xml"
+				</v8:item>
-	[System.IO.File]::WriteAllText($skdFilePath, $skdContent, $enc)
+			</Synonym>
-
+			<Comment/>
-	Write-Host "     СКД:     $skdMetaPath"
+			<TemplateType>DataCompositionSchema</TemplateType>
-	Write-Host "     Тело:    $skdFilePath"
+		</Properties>
-}
+	</Template>
+</MetaDataObject>
+"@
+
+	Write-XmlFile $skdMetaPath $skdMetaXml $enc
+
+	$skdContent = @"
+<?xml version="1.0" encoding="UTF-8"?>
+<DataCompositionSchema xmlns="http://v8.1c.ru/8.1/data-composition-system/schema"
+		xmlns:dcscom="http://v8.1c.ru/8.1/data-composition-system/common"
+		xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"
+		xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"
+		xmlns:v8="http://v8.1c.ru/8.1/data/core"
+		xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"
+		xmlns:xs="http://www.w3.org/2001/XMLSchema"
+		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+	<dataSource>
+		<name>ИсточникДанных1</name>
+		<dataSourceType>Local</dataSourceType>
+	</dataSource>
+</DataCompositionSchema>
+"@
+
+	$skdFilePath = Join-Path $skdExtDir "Template.xml"
+	Write-XmlFile $skdFilePath $skdContent $enc
+
+	Write-Host "     СКД:     $skdMetaPath"
+	Write-Host "     Тело:    $skdFilePath"
+}

.claude/skills/erf-init/scripts/init.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python3
-# erf-init v1.1 — Init 1C external report scaffold
+# erf-init v1.4 — Init 1C external report scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C external report."""
-import sys, os, argparse, uuid
+import sys, os, re, argparse, uuid
 
 def esc_xml(s):
     return s.replace('&','&amp;').replace('<','&lt;').replace('>','&gt;').replace('"','&quot;')
@@ -14,6 +14,22 @@ def write_utf8_bom(path, content):
     with open(path, 'w', encoding='utf-8-sig', newline='') as f:
         f.write(content)
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    write_utf8_bom(path, text)
+
+
+def format_rank(ver):
+    """"2.20" → 220, "2.9" → 209. Строковое сравнение неверно ("2.9" > "2.17")."""
+    m = re.match(r'^(\d+)\.(\d+)$', ver or '')
+    return int(m.group(1)) * 100 + int(m.group(2)) if m else 0
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -21,6 +37,11 @@ def main():
     parser.add_argument('-Name', dest='Name', required=True)
     parser.add_argument('-Synonym', dest='Synonym', default=None)
     parser.add_argument('-SrcDir', dest='SrcDir', default='src')
+    # Версия формата выгрузки. Своей конфигурации у автономного объекта нет, наследовать
+    # версию неоткуда — поэтому её задают явно. Формы, макеты и справку внутри объекта
+    # навыки берут уже отсюда: их детектор читает version из корня этого файла.
+    parser.add_argument('-FormatVersion', dest='FormatVersion', default='2.17',
+                        choices=['2.17', '2.18', '2.19', '2.20', '2.21'])
     parser.add_argument('-WithSKD', dest='WithSKD', action='store_true')
     args = parser.parse_args()
 
@@ -33,6 +54,34 @@ def main():
     uuid3 = new_uuid()
     uuid4 = new_uuid()
 
+    # Объявления пространств имён — одной переменной: места эмиссии её только подставляют.
+    xmlns_decl = (
+        'xmlns="http://v8.1c.ru/8.3/MDClasses"'
+        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
+        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
+        ' xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi"'
+        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
+        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
+        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
+        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
+        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
+        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
+        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
+        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
+        ' xmlns:xen="http://v8.1c.ru/8.3/xcf/enums"'
+        ' xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef"'
+        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
+        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+    )
+    format_version = args.FormatVersion
+    # 2.21 (8.5) добавила в шапку пространство палитры. Вставляем НА МЕСТО (после lf, перед
+    # style): платформа держит объявления по алфавиту, дописать в конец нельзя.
+    if format_rank(format_version) >= 221:
+        xmlns_decl = xmlns_decl.replace(
+            ' xmlns:style=',
+            ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style=')
+
     # --- Properties ---
     main_dcs_value = ""
     child_objects_content = ""
@@ -45,7 +94,7 @@ def main():
     child_objects_xml = f"<ChildObjects>{child_objects_content}\t\t</ChildObjects>" if child_objects_content else "<ChildObjects/>"
 
     xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<ExternalReport uuid="{uuid1}">
 \t\t<InternalInfo>
 \t\t\t<xr:ContainedObject>
@@ -90,7 +139,7 @@ def main():
     ext_dir = os.path.join(report_dir, "Ext")
     os.makedirs(ext_dir, exist_ok=True)
 
-    write_utf8_bom(os.path.join(os.path.abspath(src_dir), f"{name}.xml"), xml)
+    write_xml_file(os.path.join(os.path.abspath(src_dir), f"{name}.xml"), xml)
 
     # --- Модуль объекта ---
     module_bsl = """\
@@ -107,7 +156,10 @@ def main():
 #КонецОбласти"""
 
     module_path = os.path.join(ext_dir, "ObjectModule.bsl")
-    write_utf8_bom(module_path, module_bsl)
+    # Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
+    # чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
+    # неканоничен (1235 модулей с ним, 766 без).
+    write_utf8_bom(module_path, module_bsl.replace('\r\n', '\n').replace('\n', '\r\n'))
 
     print(f"[OK] Создан отчёт: {root_file}")
     print(f"     Каталог: {report_dir}")
@@ -124,7 +176,7 @@ def main():
         skd_uuid = new_uuid()
 
         skd_meta_xml = f'''<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+<MetaDataObject {xmlns_decl} version="{format_version}">
 \t<Template uuid="{skd_uuid}">
 \t\t<Properties>
 \t\t\t<Name>{skd_name}</Name>
@@ -140,7 +192,7 @@ def main():
 \t</Template>
 </MetaDataObject>'''
 
-        write_utf8_bom(skd_meta_path, skd_meta_xml)
+        write_xml_file(skd_meta_path, skd_meta_xml)
 
         skd_content = '''<?xml version="1.0" encoding="UTF-8"?>
 <DataCompositionSchema xmlns="http://v8.1c.ru/8.1/data-composition-system/schema"
@@ -158,7 +210,7 @@ def main():
 </DataCompositionSchema>'''
 
         skd_file_path = os.path.join(skd_ext_dir, "Template.xml")
-        write_utf8_bom(skd_file_path, skd_content)
+        write_xml_file(skd_file_path, skd_content)
 
         print(f"     СКД:     {skd_meta_path}")
         print(f"     Тело:    {skd_file_path}")

.claude/skills/erf-validate/SKILL.md

@@ -1,32 +1,32 @@
----
+---
-name: erf-validate
+name: erf-validate
-description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности
+description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности
-argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
+argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Glob
+  - Glob
----
+---
-
+
-# /erf-validate — валидация внешнего отчёта (ERF)
+# /erf-validate — валидация внешнего отчёта (ERF)
-
+
-Проверяет структурную корректность XML-исходников внешнего отчёта: корневую структуру, InternalInfo, свойства (включая MainDataCompositionSchema), ChildObjects, реквизиты, табличные части, уникальность имён, наличие файлов форм и макетов.
+Проверяет структурную корректность XML-исходников внешнего отчёта: корневую структуру, InternalInfo, свойства (включая MainDataCompositionSchema), ChildObjects, реквизиты, табличные части, уникальность имён, наличие файлов форм и макетов.
-
+
-Использует тот же скрипт, что и `/epf-validate` — автоопределение по типу элемента (ExternalReport).
+Использует тот же скрипт, что и `/epf-validate` — автоопределение по типу элемента (ExternalReport).
-
+
-## Параметры
+## Параметры
-
+
-| Параметр   | Обяз. | Умолч. | Описание                                      |
+| Параметр   | Обяз. | Умолч. | Описание                                      |
-|------------|:-----:|---------|-------------------------------------------------|
+|------------|:-----:|---------|-------------------------------------------------|
-| ObjectPath | да    | —       | Путь к корневому XML или каталогу отчёта        |
+| ObjectPath | да    | —       | Путь к корневому XML или каталогу отчёта        |
-| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
+| Detailed   | нет   | —       | Подробный вывод (все проверки, включая успешные) |
-| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
+| MaxErrors  | нет   | 30      | Остановиться после N ошибок                     |
-| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
+| OutFile    | нет   | —       | Записать результат в файл (UTF-8 BOM)           |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
-```
+```
-
+

.claude/skills/form-add/SKILL.md

@@ -1,71 +1,71 @@
----
+---
-name: form-add
+name: form-add
-description: Добавить пустую управляемую форму к объекту 1С. Используй когда нужно создать у объекта новую форму
+description: Добавить пустую управляемую форму к объекту 1С. Используй когда нужно создать у объекта новую форму
-argument-hint: <ObjectPath> <FormName> [Purpose] [--set-default]
+argument-hint: <ObjectPath> <FormName> [Purpose] [--set-default]
-allowed-tools:
+allowed-tools:
-  - Bash
+  - Bash
-  - Read
+  - Read
-  - Write
+  - Write
-  - Edit
+  - Edit
-  - Glob
+  - Glob
-  - Grep
+  - Grep
----
+---
-
+
-# /form-add — Добавление формы к объекту конфигурации
+# /form-add — Добавление формы к объекту конфигурации
-
+
-Создаёт управляемую форму (metadata XML + Form.xml + Module.bsl) и регистрирует её в корневом XML объекта конфигурации (Document, Catalog, InformationRegister и др.).
+Создаёт управляемую форму (metadata XML + Form.xml + Module.bsl) и регистрирует её в корневом XML объекта конфигурации (Document, Catalog, InformationRegister и др.).
-
+
-## Usage
+## Usage
-
+
-```
+```
-/form-add <ObjectPath> <FormName> [Purpose] [Synonym] [--set-default]
+/form-add <ObjectPath> <FormName> [Purpose] [Synonym] [--set-default]
-```
+```
-
+
-| Параметр    | Обязательный | По умолчанию | Описание                                     |
+| Параметр    | Обязательный | По умолчанию | Описание                                     |
-|-------------|:------------:|--------------|----------------------------------------------|
+|-------------|:------------:|--------------|----------------------------------------------|
-| ObjectPath  | да           | —            | Путь к XML-файлу объекта (Documents/Док.xml)  |
+| ObjectPath  | да           | —            | Путь к XML-файлу объекта (Documents/Док.xml)  |
-| FormName    | да           | —            | Имя формы (ФормаДокумента)                    |
+| FormName    | да           | —            | Имя формы (ФормаДокумента)                    |
-| Purpose     | нет          | Object       | Назначение: Object, List, Choice, Record      |
+| Purpose     | нет          | Object       | Назначение: Object, List, Choice, Record      |
-| Synonym     | нет          | = FormName   | Синоним формы                                 |
+| Synonym     | нет          | = FormName   | Синоним формы                                 |
-| --set-default | нет        | авто         | Установить как форму по умолчанию             |
+| --set-default | нет        | авто         | Установить как форму по умолчанию             |
-
+
-## Команда
+## Команда
-
+
-```powershell
+```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
-```
+```
-
+
-## Purpose — назначение формы
+## Purpose — назначение формы
-
+
-| Purpose | Допустимые типы объектов | Основной реквизит | DefaultForm-свойство |
+| Purpose | Допустимые типы объектов | Основной реквизит | DefaultForm-свойство |
-|---------|-------------------------|-------------------|---------------------|
+|---------|-------------------------|-------------------|---------------------|
-| Object  | Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, ChartOf*, ExchangePlan, BusinessProcess, Task | Объект (тип: *Object.Имя) | DefaultObjectForm (DefaultForm для DataProcessor/Report/ExternalDataProcessor/ExternalReport) |
+| Object  | Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, ChartOf*, ExchangePlan, BusinessProcess, Task | Объект (тип: *Object.Имя) | DefaultObjectForm (DefaultForm для DataProcessor/Report/ExternalDataProcessor/ExternalReport) |
-| List    | Все кроме DataProcessor | Список (DynamicList) | DefaultListForm |
+| List    | Все кроме DataProcessor | Список (DynamicList) | DefaultListForm |
-| Choice  | Document, Catalog, ChartOf*, ExchangePlan, BusinessProcess, Task | Список (DynamicList) | DefaultChoiceForm |
+| Choice  | Document, Catalog, ChartOf*, ExchangePlan, BusinessProcess, Task | Список (DynamicList) | DefaultChoiceForm |
-| Record  | InformationRegister | Запись (InformationRegisterRecordManager) | DefaultRecordForm |
+| Record  | InformationRegister | Запись (InformationRegisterRecordManager) | DefaultRecordForm |
-
+
-## Примеры
+## Примеры
-
+
-```
+```
-# Форма документа
+# Форма документа
-/form-add Documents/АвансовыйОтчет.xml ФормаДокумента --purpose Object
+/form-add Documents/АвансовыйОтчет.xml ФормаДокумента --purpose Object
-
+
-# Форма списка каталога
+# Форма списка каталога
-/form-add Catalogs/Контрагенты.xml ФормаСписка --purpose List
+/form-add Catalogs/Контрагенты.xml ФормаСписка --purpose List
-
+
-# Форма записи регистра сведений
+# Форма записи регистра сведений
-/form-add InformationRegisters/КурсыВалют.xml ФормаЗаписи --purpose Record
+/form-add InformationRegisters/КурсыВалют.xml ФормаЗаписи --purpose Record
-
+
-# Форма выбора с синонимом
+# Форма выбора с синонимом
-/form-add Catalogs/Номенклатура.xml ФормаВыбора --purpose Choice --synonym "Выбор номенклатуры"
+/form-add Catalogs/Номенклатура.xml ФормаВыбора --purpose Choice --synonym "Выбор номенклатуры"
-
+
-# Установить как форму по умолчанию
+# Установить как форму по умолчанию
-/form-add Documents/Заказ.xml ФормаДокументаНовая --purpose Object --set-default
+/form-add Documents/Заказ.xml ФормаДокументаНовая --purpose Object --set-default
-```
+```
-
+
-## Workflow
+## Workflow
-
+
-1. `/form-add` — создать каркас формы
+1. `/form-add` — создать каркас формы
-2. `/form-compile` или `/form-edit` — наполнить Form.xml элементами
+2. `/form-compile` или `/form-edit` — наполнить Form.xml элементами
-3. `/form-validate` — проверить корректность
+3. `/form-validate` — проверить корректность
-4. `/form-info` — проанализировать результат
+4. `/form-info` — проанализировать результат

.claude/skills/form-add/scripts/form-add.ps1

@@ -1,4 +1,4 @@
-# form-add v1.5 — Add managed form to 1C config object
+# form-add v1.23 — Add managed form to 1C config object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -18,14 +18,156 @@ $ErrorActionPreference = "Stop"
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 [Console]::InputEncoding = [System.Text.Encoding]::UTF8
 
+# --- Support guard (Ext/ParentConfigurations.bin) ---
+# See docs/1c-support-state-spec.md. Blocks edits of vendor objects "на замке" /
+# read-only configs unless allowed. Trigger = bin present; reaction from
+# .v8-project.json editingAllowedCheck (deny|warn|off, default deny). Never
+# throws — guard errors degrade to allow.
+function Get-RootUuid([string]$xmlPath) {
+	if (-not (Test-Path $xmlPath)) { return $null }
+	try {
+		[xml]$mx = Get-Content -Path $xmlPath -Encoding UTF8
+		$el = $mx.DocumentElement.FirstChild
+		while ($el -and $el.NodeType -ne 'Element') { $el = $el.NextSibling }
+		if ($el) { $u = $el.GetAttribute("uuid"); if ($u) { return $u } }
+	} catch {}
+	return $null
+}
+function Test-ExternalObjectRoot([string]$xmlPath) {
+	if (-not (Test-Path $xmlPath)) { return $false }
+	try {
+		[xml]$mx = Get-Content -Path $xmlPath -Encoding UTF8
+		$el = $mx.DocumentElement.FirstChild
+		while ($el -and $el.NodeType -ne 'Element') { $el = $el.NextSibling }
+		if ($el) { return @('ExternalDataProcessor','ExternalReport') -contains $el.LocalName }
+	} catch {}
+	return $false
+}
+function Find-V8Project([string]$startDir) {
+	$d = $startDir
+	for ($i = 0; $i -lt 20 -and $d; $i++) {
+		$pj = Join-Path $d ".v8-project.json"
+		if (Test-Path $pj) { return $pj }
+		$parent = [System.IO.Path]::GetDirectoryName($d)
+		if ($parent -eq $d) { break }
+		$d = $parent
+	}
+	return $null
+}
+function Get-EditMode([string]$cfgDir) {
+	try {
+		$pj = Find-V8Project (Get-Location).Path
+		if (-not $pj) { $pj = Find-V8Project $cfgDir }
+		if (-not $pj) { return 'deny' }
+		$proj = Get-Content -Raw $pj | ConvertFrom-Json
+		$cfgFull = [System.IO.Path]::GetFullPath($cfgDir).TrimEnd('\', '/')
+		if ($proj.databases) {
+			foreach ($db in $proj.databases) {
+				if ($db.configSrc) {
+					$src = [System.IO.Path]::GetFullPath($db.configSrc).TrimEnd('\', '/')
+					if ($cfgFull -eq $src -or $cfgFull.StartsWith($src + [System.IO.Path]::DirectorySeparatorChar)) {
+						if ($db.editingAllowedCheck) { return $db.editingAllowedCheck }
+					}
+				}
+			}
+		}
+		if ($proj.editingAllowedCheck) { return $proj.editingAllowedCheck }
+		return 'deny'
+	} catch { return 'deny' }
+}
+function Assert-EditAllowed([string]$targetPath, [string]$require) {
+	try {
+		$rp = $targetPath
+		try { $rp = (Resolve-Path $targetPath -ErrorAction Stop).Path } catch {}
+		# Autonomous external object (EPF/ERF): never part of a config on support (issue #39).
+		if (Test-ExternalObjectRoot $rp) { return }
+		$elemUuid = Get-RootUuid $rp
+		$cfgDir = $null; $binPath = $null
+		$d = if (Test-Path $rp -PathType Container) { $rp } else { [System.IO.Path]::GetDirectoryName($rp) }
+		for ($i = 0; $i -lt 12 -and $d; $i++) {
+			if (Test-ExternalObjectRoot "$d.xml") { return }
+			if (-not $elemUuid) { $elemUuid = Get-RootUuid "$d.xml" }
+			if (-not $cfgDir) {
+				$cand = Join-Path (Join-Path $d "Ext") "ParentConfigurations.bin"
+				if ((Test-Path $cand) -or (Test-Path (Join-Path $d "Configuration.xml"))) { $cfgDir = $d; $binPath = $cand }
+			}
+			if ($elemUuid -and $cfgDir) { break }
+			$parent = [System.IO.Path]::GetDirectoryName($d)
+			if ($parent -eq $d) { break }
+			$d = $parent
+		}
+		# New object (no element file): fall back to config root uuid.
+		if (-not $elemUuid -and $cfgDir) { $elemUuid = Get-RootUuid (Join-Path $cfgDir "Configuration.xml") }
+		if (-not $binPath -or -not (Test-Path $binPath)) { return }
+		$bytes = [System.IO.File]::ReadAllBytes($binPath)
+		if ($bytes.Length -le 32) { return }
+		$start = 0
+		if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) { $start = 3 }
+		$text = [System.Text.Encoding]::UTF8.GetString($bytes, $start, $bytes.Length - $start)
+		$hm = [regex]::Match($text, '^\{6,(\d+),(\d+),')
+		if (-not $hm.Success) { return }
+		$G = [int]$hm.Groups[1].Value
+		$K = [int]$hm.Groups[2].Value
+		if ($K -eq 0) { return }
+		$best = $null
+		if ($elemUuid) {
+			$u = [regex]::Escape($elemUuid.ToLower())
+			foreach ($m in [regex]::Matches($text, "([0-2]),0,$u")) {
+				$f1 = [int]$m.Groups[1].Value
+				if ($null -eq $best -or $f1 -lt $best) { $best = $f1 }
+			}
+		}
+		$blocked = $false; $code = ""; $reason = ""
+		if ($G -eq 1) { $blocked = $true; $code = "capability-off"; $reason = "возможность изменения конфигурации выключена (вся конфигурация read-only)" }
+		elseif ($require -eq 'removed') {
+			if ($null -ne $best -and $best -ne 2) { $blocked = $true; $code = "not-removed"; $reason = "объект не снят с поддержки — удаление сломает обновления" }
+		}
+		else {
+			if ($null -ne $best -and $best -eq 0) { $blocked = $true; $code = "locked"; $reason = "объект на замке — редактирование сломает обновления" }
+		}
+		if (-not $blocked) { return }
+		$mode = Get-EditMode $cfgDir
+		if ($mode -eq 'off') { return }
+		# Use Console.Error (not Write-Error) — under ErrorActionPreference=Stop the
+		# latter throws and would be swallowed by this function's own catch.
+		if ($mode -eq 'warn') { [Console]::Error.WriteLine("[support-guard] ПРЕДУПРЕЖДЕНИЕ: $reason. Цель: $rp"); return }
+		$head = "[support-guard] Редактирование отклонено: это объект типовой конфигурации на поддержке поставщика, прямое редактирование молча сломает будущие обновления."
+		$cfe = "Рекомендуемый путь: внести доработку в расширение (навыки cfe-borrow / cfe-patch-method) — состояние поддержки менять не нужно, обновления вендора сохраняются."
+		$offNote = "Снять проверку для этой базы: editingAllowedCheck = warn|off в .v8-project.json."
+		if ($code -eq "capability-off") {
+			$state = "Состояние: у всей конфигурации выключена возможность изменения (режим read-only «из коробки») — поэтому объект «$rp» редактировать нельзя."
+			$fix = "Либо снять защиту явно (навык support-edit, два шага):`n  1. support-edit -Path ""$cfgDir"" -Capability on — включить возможность изменения (объекты пока остаются на замке);`n  2. support-edit -Path ""$rp"" -Set editable — открыть этот объект для редактирования.`n  Изменение применяется в базу полной загрузкой выгрузки и обходит механизм обновлений вендора."
+		} elseif ($code -eq "not-removed") {
+			$state = "Состояние: объект «$rp» на поддержке (не снят с поддержки) — его удаление разорвёт обновления вендора."
+			$fix = "Либо сначала снять объект с поддержки, затем удалять:`n  support-edit -Path ""$rp"" -Set off-support — объект уходит из-под обновлений, после этого удаление безопасно."
+		} else {
+			$state = "Состояние: объект «$rp» на замке (возможность изменения конфигурации включена, но сам объект не редактируется)."
+			$fix = "Либо разрешить редактирование этого объекта (навык support-edit, выбрать одно):`n  support-edit -Path ""$rp"" -Set editable — редактировать и дальше получать обновления вендора (возможны конфликты слияния);`n  support-edit -Path ""$rp"" -Set off-support — снять с поддержки: обновления по объекту больше не приходят."
+		}
+		[Console]::Error.WriteLine("$head`n$state`n$cfe`n$fix`n$offNote")
+		exit 1
+	} catch { return }
+}
+
 # --- Detect XML format version ---
 
 function Detect-FormatVersion([string]$dir) {
 	$d = $dir
 	while ($d) {
+		# Автономная внешняя обработка/отчёт: своего Configuration.xml у неё нет, версию несёт
+		# корень самой обработки. Без этого форма и макет внутри обработки 2.21 писались бы 2.17.
+		$extPath = "$d.xml"
+		if (Test-Path $extPath) {
+			$extText = [System.IO.File]::ReadAllText($extPath, [System.Text.Encoding]::UTF8)
+			$extHead = $extText.Substring(0, [Math]::Min(2000, $extText.Length))
+			if ($extHead -match '<(ExternalDataProcessor|ExternalReport)[ >]' -and $extHead -match '<MetaDataObject[^>]+version="(\d+\.\d+)"') { return $Matches[1] }
+		}
 		$cfgPath = Join-Path $d "Configuration.xml"
 		if (Test-Path $cfgPath) {
-			$head = [System.IO.File]::ReadAllText($cfgPath, [System.Text.Encoding]::UTF8).Substring(0, [Math]::Min(2000, (Get-Item $cfgPath).Length))
+			$cfgText = [System.IO.File]::ReadAllText($cfgPath, [System.Text.Encoding]::UTF8)
+			# Длину среза берём по СТРОКЕ, а не по размеру файла: размер в БАЙТАХ, Substring считает
+			# СИМВОЛЫ, и на кириллице байт больше — короткий Configuration.xml ронял навык исключением.
+			$head = $cfgText.Substring(0, [Math]::Min(2000, $cfgText.Length))
 			if ($head -match '<MetaDataObject[^>]+version="(\d+\.\d+)"') { return $Matches[1] }
 		}
 		$parent = Split-Path $d -Parent
@@ -35,6 +177,13 @@ function Detect-FormatVersion([string]$dir) {
 	return "2.17"
 }
 
+# Версия формата как число для сравнений: "2.20" → 220, "2.9" → 209.
+# Строковое сравнение здесь неверно ("2.9" > "2.17" лексикографически) — известная ловушка.
+function Get-FormatRank([string]$ver) {
+	if ($ver -match '^(\d+)\.(\d+)$') { return [int]$Matches[1] * 100 + [int]$Matches[2] }
+	return 0
+}
+
 # --- Фаза 1: Определение типа объекта ---
 
 # Resolve ObjectPath (directory → .xml)
@@ -55,7 +204,27 @@ if (-not (Test-Path $ObjectPath)) {
 }
 
 $objectXmlFull = Resolve-Path $ObjectPath
-$script:formatVersion = Detect-FormatVersion (Split-Path $objectXmlFull.Path -Parent)
+Assert-EditAllowed $objectXmlFull.Path 'editable'
+# Версию берём прежде всего из корня самого объекта — он её несёт всегда, а у автономной
+# внешней обработки/отчёта подниматься к Configuration.xml просто некуда.
+$script:formatVersion = $null
+$objHead = [System.IO.File]::ReadAllText($objectXmlFull.Path, [System.Text.Encoding]::UTF8)
+$objHead = $objHead.Substring(0, [Math]::Min(2000, $objHead.Length))
+if ($objHead -match '<MetaDataObject[^>]+version="(\d+\.\d+)"') { $script:formatVersion = $Matches[1] }
+if (-not $script:formatVersion) { $script:formatVersion = Detect-FormatVersion (Split-Path $objectXmlFull.Path -Parent) }
+
+# Объявления пространств имён — одной переменной на корень: места эмиссии их только
+# интерполируют. Правки шапки (как xmlns:pal в формате 2.21) делаются здесь, в одном месте.
+$script:xmlnsDecl = 'xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+$script:formNsDecl = 'xmlns="http://v8.1c.ru/8.3/xcf/logform" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core" xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+
+# 2.21 (8.5) добавила в шапку пространство палитры — ради <Color> у значений перечисления.
+# Вставляем НА МЕСТО (после lf, перед style): платформа держит объявления по алфавиту,
+# дописать в конец нельзя.
+if ((Get-FormatRank $script:formatVersion) -ge 221) {
+	$script:xmlnsDecl = $script:xmlnsDecl -replace ' xmlns:style=', ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
+	$script:formNsDecl = $script:formNsDecl -replace ' xmlns:style=', ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
+}
 
 $xmlDoc = New-Object System.Xml.XmlDocument
 $xmlDoc.PreserveWhitespace = $true
@@ -76,7 +245,7 @@ $supportedTypes = @(
 	"Document", "Catalog", "DataProcessor", "Report",
 	"ExternalDataProcessor", "ExternalReport",
 	"InformationRegister", "AccumulationRegister", "ChartOfAccounts", "ChartOfCharacteristicTypes",
-	"ExchangePlan", "BusinessProcess", "Task"
+	"ExchangePlan", "BusinessProcess", "Task", "DocumentJournal"
 )
 
 $objectType = $null
@@ -178,9 +347,16 @@ if ($objectType -in $processorLikeTypes) {
 	$extPresentationLine = "`n`t`t`t<ExtendedPresentation/>"
 }
 
+# Использование в режиме совместимости интерфейса — свойство формата 2.21 (8.5),
+# сразу после UsePurposes (проверено по выгрузке 8.5, до ExtendedPresentation).
+$useInIfcLine = ""
+if ((Get-FormatRank $script:formatVersion) -ge 221) {
+	$useInIfcLine = "`n`t`t`t<UseInInterfaceCompatibilityMode>Any</UseInInterfaceCompatibilityMode>"
+}
+
 $formMetaXml = @"
 <?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="$($script:formatVersion)">
+<MetaDataObject $($script:xmlnsDecl) version="$($script:formatVersion)">
 	<Form uuid="$formUuid">
 		<Properties>
 			<Name>$FormName</Name>
@@ -196,20 +372,29 @@ $formMetaXml = @"
 			<UsePurposes>
 				<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
 				<v8:Value xsi:type="app:ApplicationUsePurpose">MobilePlatformApplication</v8:Value>
-			</UsePurposes>$extPresentationLine
+			</UsePurposes>$useInIfcLine$extPresentationLine
 		</Properties>
 	</Form>
 </MetaDataObject>
 "@
 
-[System.IO.File]::WriteAllText($formMetaPath, $formMetaXml, $encBom)
+# XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+#
+# Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+# копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+#
+# Модуль .bsl сюда НЕ идёт — он пишется отдельно.
+function Write-XmlFile([string]$path, [string]$text, $encoding) {
+	$t = ($text -replace "`r`n", "`n") -replace "`n", "`r`n"
+	[System.IO.File]::WriteAllText($path, $t.TrimEnd("`r", "`n"), $encoding)
+}
+
+Write-XmlFile $formMetaPath $formMetaXml $encBom
 
 # --- 3b. Form.xml ---
 
 $formXmlPath = Join-Path $formExtDir "Form.xml"
 
-$formNsDecl = 'xmlns="http://v8.1c.ru/8.3/xcf/logform" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core" xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-
 if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 	# Динамический список
 	# MainTable: тип.имя
@@ -217,7 +402,7 @@ if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 
 	$formXml = @"
 <?xml version="1.0" encoding="UTF-8"?>
-<Form $formNsDecl version="$($script:formatVersion)">
+<Form $($script:formNsDecl) version="$($script:formatVersion)">
 	<AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
 		<Autofill>true</Autofill>
 	</AutoCommandBar>
@@ -242,7 +427,7 @@ if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 
 	$formXml = @"
 <?xml version="1.0" encoding="UTF-8"?>
-<Form $formNsDecl version="$($script:formatVersion)">
+<Form $($script:formNsDecl) version="$($script:formatVersion)">
 	<AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
 		<Autofill>true</Autofill>
 	</AutoCommandBar>
@@ -289,7 +474,7 @@ if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 
 	$formXml = @"
 <?xml version="1.0" encoding="UTF-8"?>
-<Form $formNsDecl version="$($script:formatVersion)">
+<Form $($script:formNsDecl) version="$($script:formatVersion)">
 	<AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
 		<Autofill>true</Autofill>
 	</AutoCommandBar>
@@ -309,7 +494,7 @@ if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 if (Test-Path $formXmlPath) {
 	Write-Host "[SKIP] Form.xml already exists: $formXmlPath — not overwriting"
 } else {
-	[System.IO.File]::WriteAllText($formXmlPath, $formXml, $encBom)
+	Write-XmlFile $formXmlPath $formXml $encBom
 }
 
 # --- 3c. Module.bsl ---
@@ -341,6 +526,11 @@ $moduleBsl = @"
 if (Test-Path $modulePath) {
 	Write-Host "[SKIP] Module.bsl already exists: $modulePath — not overwriting"
 } else {
+	# Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
+	# чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
+	# неканоничен (1235 модулей с ним, 766 без). Шаблон берёт переводы строк из
+	# самого скрипта, а он в репозитории хранится с LF.
+	$moduleBsl = ($moduleBsl -replace "`r`n", "`n") -replace "`n", "`r`n"
 	[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $encBom)
 }
 
@@ -352,7 +542,10 @@ if (-not $childObjects) {
 	exit 1
 }
 
-# Добавить <Form>$FormName</Form>
+# Добавить <Form>$FormName</Form> — идемпотентно (не дублировать уже зарегистрированную)
+$alreadyRegistered = [bool]$childObjects.SelectSingleNode("md:Form[text()='$FormName']", $nsMgr)
+
+if (-not $alreadyRegistered) {
 $formElem = $xmlDoc.CreateElement("Form", "http://v8.1c.ru/8.3/MDClasses")
 $formElem.InnerText = $FormName
 
@@ -406,6 +599,7 @@ if ($insertBefore) {
 		}
 	}
 }
+}
 
 # --- SetDefault ---
 
@@ -446,12 +640,27 @@ if ($SetDefault -or $isFirstFormForPurpose) {
 $settings = New-Object System.Xml.XmlWriterSettings
 $settings.Encoding = $encBom
 $settings.Indent = $false
+$settings.NewLineHandling = [System.Xml.NewLineHandling]::None
 
-$stream = New-Object System.IO.FileStream($objectXmlFull.Path, [System.IO.FileMode]::Create)
+# Через MemoryStream, а не прямо в файл: нужен шаг пост-обработки строки.
-$writer = [System.Xml.XmlWriter]::Create($stream, $settings)
+$memStream = New-Object System.IO.MemoryStream
+$writer = [System.Xml.XmlWriter]::Create($memStream, $settings)
 $xmlDoc.Save($writer)
-$writer.Close()
+$writer.Flush(); $writer.Close()
-$stream.Close()
+
+$xmlText = [System.Text.Encoding]::UTF8.GetString($memStream.ToArray())
+$memStream.Close()
+if ($xmlText.Length -gt 0 -and $xmlText[0] -eq [char]0xFEFF) { $xmlText = $xmlText.Substring(1) }
+$xmlText = $xmlText.Replace('encoding="utf-8"', 'encoding="UTF-8"')
+# Пустой элемент: XmlWriter отдаёт `<a />`, Конфигуратор пишет `<a/>`. Внутри
+# CDATA/комментария ` />` может быть содержимым (там `>` не экранируется),
+# поэтому они идут первыми ветками альтернации и возвращаются как есть.
+$xmlText = [regex]::Replace($xmlText, '(?s)<!\[CDATA\[.*?\]\]>|<!--.*?-->|(?<=\S) />', { param($m) if ($m.Value -eq ' />') { '/>' } else { $m.Value } })
+# Целевой перевод строки: стиль файла-назначения — правка наследует его (#44/#46/#47),
+# новый файл получает канон выгрузки CRLF. Зеркало _detect_xml_style в py-порту.
+$targetEol = if ((Test-Path -LiteralPath $objectXmlFull.Path) -and ([System.IO.File]::ReadAllText($objectXmlFull.Path) -notmatch "`r`n")) { "`n" } else { "`r`n" }
+$xmlText = ($xmlText -replace "`r`n", "`n") -replace "`n", $targetEol
+[System.IO.File]::WriteAllText($objectXmlFull.Path, $xmlText, $encBom)
 
 # --- Фаза 5: Вывод ---
 
@@ -471,7 +680,11 @@ Write-Host "  Metadata: $objDirName\$objBaseName\Forms\$FormName.xml"
 Write-Host "  Form:     $objDirName\$objBaseName\Forms\$FormName\Ext\Form.xml"
 Write-Host "  Module:   $objDirName\$objBaseName\Forms\$FormName\Ext\Form\Module.bsl"
 Write-Host ""
-Write-Host "Registered: <Form>$FormName</Form> in ChildObjects"
+if ($alreadyRegistered) {
+	Write-Host "Already registered: <Form>$FormName</Form> in ChildObjects (skipped duplicate)"
+} else {
+	Write-Host "Registered: <Form>$FormName</Form> in ChildObjects"
+}
 if ($defaultUpdated) {
 	Write-Host "${defaultPropName}: $defaultValue"
 }

.claude/skills/form-add/scripts/form-add.py

@@ -1,8 +1,9 @@
 #!/usr/bin/env python3
-# form-add v1.5 — Add managed form to 1C config object
+# form-add v1.23 — Add managed form to 1C config object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 
 import argparse
+import json
 import os
 import re
 import sys
@@ -10,6 +11,183 @@ import uuid
 
 from lxml import etree
 
+
+# ============================================================
+# Support guard (Ext/ParentConfigurations.bin) — see docs/1c-support-state-spec.md
+# Blocks edits of vendor objects "на замке" / read-only configs. Trigger = bin
+# present; reaction from .v8-project.json editingAllowedCheck (deny|warn|off,
+# default deny). Never throws (except sys.exit on deny) — errors degrade to allow.
+# ============================================================
+
+def _sg_root_uuid(xml_path):
+    if not os.path.isfile(xml_path):
+        return None
+    try:
+        mx = etree.parse(xml_path).getroot()
+        for child in mx:
+            if isinstance(child.tag, str) and child.get("uuid"):
+                return child.get("uuid")
+    except Exception:
+        return None
+    return None
+
+
+def _sg_is_external_root(xml_path):
+    if not os.path.isfile(xml_path):
+        return False
+    try:
+        mx = etree.parse(xml_path).getroot()
+        for child in mx:
+            if isinstance(child.tag, str):
+                return child.tag.split("}")[-1] in ("ExternalDataProcessor", "ExternalReport")
+    except Exception:
+        return False
+    return False
+
+def _sg_find_v8project(start_dir):
+    d = start_dir
+    for _ in range(20):
+        if not d:
+            break
+        pj = os.path.join(d, ".v8-project.json")
+        if os.path.isfile(pj):
+            return pj
+        parent = os.path.dirname(d)
+        if parent == d:
+            break
+        d = parent
+    return None
+
+
+def _sg_get_edit_mode(cfg_dir):
+    try:
+        pj = _sg_find_v8project(os.getcwd()) or _sg_find_v8project(cfg_dir)
+        if not pj:
+            return "deny"
+        proj = json.loads(open(pj, encoding="utf-8-sig").read())
+        cfg_full = os.path.normcase(os.path.abspath(cfg_dir)).rstrip("\\/")
+        for db in proj.get("databases", []):
+            src = db.get("configSrc")
+            if src:
+                src_full = os.path.normcase(os.path.abspath(src)).rstrip("\\/")
+                if cfg_full == src_full or cfg_full.startswith(src_full + os.sep):
+                    if db.get("editingAllowedCheck"):
+                        return db["editingAllowedCheck"]
+        if proj.get("editingAllowedCheck"):
+            return proj["editingAllowedCheck"]
+        return "deny"
+    except Exception:
+        return "deny"
+
+
+def assert_edit_allowed(target_path, require):
+    try:
+        rp = os.path.abspath(target_path)
+        # Autonomous external object (EPF/ERF): never part of a config on support (issue #39).
+        if _sg_is_external_root(rp):
+            return
+        elem_uuid = _sg_root_uuid(rp)
+        cfg_dir = None
+        bin_path = None
+        d = rp if os.path.isdir(rp) else os.path.dirname(rp)
+        for _ in range(12):
+            if not d:
+                break
+            if _sg_is_external_root(d + ".xml"):
+                return
+            if not elem_uuid:
+                elem_uuid = _sg_root_uuid(d + ".xml")
+            if not cfg_dir:
+                cand = os.path.join(d, "Ext", "ParentConfigurations.bin")
+                if os.path.exists(cand) or os.path.exists(os.path.join(d, "Configuration.xml")):
+                    cfg_dir = d
+                    bin_path = cand
+            if elem_uuid and cfg_dir:
+                break
+            parent = os.path.dirname(d)
+            if parent == d:
+                break
+            d = parent
+        if not elem_uuid and cfg_dir:
+            elem_uuid = _sg_root_uuid(os.path.join(cfg_dir, "Configuration.xml"))
+        if not bin_path or not os.path.exists(bin_path):
+            return
+        data = open(bin_path, "rb").read()
+        if len(data) <= 32:
+            return
+        if data[:3] == b"\xef\xbb\xbf":
+            data = data[3:]
+        text = data.decode("utf-8", "replace")
+        h = re.match(r"\{6,(\d+),(\d+),", text)
+        if not h:
+            return
+        g = int(h.group(1))
+        k = int(h.group(2))
+        if k == 0:
+            return
+        best = None
+        if elem_uuid:
+            for m in re.finditer(r"([0-2]),0," + re.escape(elem_uuid.lower()), text):
+                f1 = int(m.group(1))
+                if best is None or f1 < best:
+                    best = f1
+        blocked = False
+        code = ""
+        reason = ""
+        if g == 1:
+            blocked = True
+            code = "capability-off"
+            reason = "возможность изменения конфигурации выключена (вся конфигурация read-only)"
+        elif require == "removed":
+            if best is not None and best != 2:
+                blocked = True
+                code = "not-removed"
+                reason = "объект не снят с поддержки — удаление сломает обновления"
+        else:
+            if best is not None and best == 0:
+                blocked = True
+                code = "locked"
+                reason = "объект на замке — редактирование сломает обновления"
+        if not blocked:
+            return
+        mode = _sg_get_edit_mode(cfg_dir)
+        if mode == "off":
+            return
+        if mode == "warn":
+            sys.stderr.write(f"[support-guard] ПРЕДУПРЕЖДЕНИЕ: {reason}. Цель: {rp}\n")
+            return
+        head = "[support-guard] Редактирование отклонено: это объект типовой конфигурации на поддержке поставщика, прямое редактирование молча сломает будущие обновления."
+        cfe = "Рекомендуемый путь: внести доработку в расширение (навыки cfe-borrow / cfe-patch-method) — состояние поддержки менять не нужно, обновления вендора сохраняются."
+        off_note = "Снять проверку для этой базы: editingAllowedCheck = warn|off в .v8-project.json."
+        if code == "capability-off":
+            state = f"Состояние: у всей конфигурации выключена возможность изменения (режим read-only «из коробки») — поэтому объект «{rp}» редактировать нельзя."
+            fix = (
+                "Либо снять защиту явно (навык support-edit, два шага):\n"
+                f'  1. support-edit -Path "{cfg_dir}" -Capability on — включить возможность изменения (объекты пока остаются на замке);\n'
+                f'  2. support-edit -Path "{rp}" -Set editable — открыть этот объект для редактирования.\n'
+                "  Изменение применяется в базу полной загрузкой выгрузки и обходит механизм обновлений вендора."
+            )
+        elif code == "not-removed":
+            state = f"Состояние: объект «{rp}» на поддержке (не снят с поддержки) — его удаление разорвёт обновления вендора."
+            fix = (
+                "Либо сначала снять объект с поддержки, затем удалять:\n"
+                f'  support-edit -Path "{rp}" -Set off-support — объект уходит из-под обновлений, после этого удаление безопасно.'
+            )
+        else:
+            state = f"Состояние: объект «{rp}» на замке (возможность изменения конфигурации включена, но сам объект не редактируется)."
+            fix = (
+                "Либо разрешить редактирование этого объекта (навык support-edit, выбрать одно):\n"
+                f'  support-edit -Path "{rp}" -Set editable — редактировать и дальше получать обновления вендора (возможны конфликты слияния);\n'
+                f'  support-edit -Path "{rp}" -Set off-support — снять с поддержки: обновления по объекту больше не приходят.'
+            )
+        sys.stderr.write(head + "\n" + state + "\n" + cfe + "\n" + fix + "\n" + off_note + "\n")
+        sys.exit(1)
+    except SystemExit:
+        raise
+    except Exception:
+        return
+
+
 NSMAP = {
     "md": "http://v8.1c.ru/8.3/MDClasses",
     "v8": "http://v8.1c.ru/8.1/data/core",
@@ -18,6 +196,16 @@ NSMAP = {
 
 def detect_format_version(d):
     while d:
+        # Автономная внешняя обработка/отчёт: своего Configuration.xml у неё нет, версию несёт
+        # корень самой обработки. Без этого форма и макет внутри обработки 2.21 писались бы 2.17.
+        ext_path = d + ".xml"
+        if os.path.isfile(ext_path):
+            with open(ext_path, "r", encoding="utf-8-sig") as f:
+                ext_head = f.read(2000)
+            if re.search(r'<(ExternalDataProcessor|ExternalReport)[ >]', ext_head):
+                m = re.search(r'<MetaDataObject[^>]+version="(\d+\.\d+)"', ext_head)
+                if m:
+                    return m.group(1)
         cfg_path = os.path.join(d, "Configuration.xml")
         if os.path.isfile(cfg_path):
             with open(cfg_path, "r", encoding="utf-8-sig") as f:
@@ -32,23 +220,80 @@ def detect_format_version(d):
     return "2.17"
 
 
-def save_xml_with_bom(tree, path):
+def format_rank(ver):
-    """Save XML tree to file with UTF-8 BOM."""
+    """"2.20" → 220, "2.9" → 209. Строковое сравнение неверно ("2.9" > "2.17")."""
-    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    m = re.match(r'^(\d+)\.(\d+)$', ver or '')
-    xml_bytes = xml_bytes.replace(b"<?xml version='1.0' encoding='UTF-8'?>", b'<?xml version="1.0" encoding="utf-8"?>')
+    return int(m.group(1)) * 100 + int(m.group(2)) if m else 0
-    if not xml_bytes.endswith(b"\n"):
+
+
+def _detect_xml_style(path):
+    """Стиль существующего файла для round-trip-сохранения: BOM / EOL / регистр encoding /
+    финальный перенос. None → файл новый (сохранить текущее поведение)."""
+    try:
+        raw = open(path, "rb").read()
+    except OSError:
+        return None
+    bom = raw.startswith(b"\xef\xbb\xbf")
+    body = raw[3:] if bom else raw
+    crlf = b"\r\n" in body
+    m = re.search(rb'encoding="([^"]+)"', body[:200])
+    enc = m.group(1).decode("ascii") if m else "utf-8"
+    final_nl = body.endswith(b"\n")
+    return {"bom": bom, "crlf": crlf, "enc": enc, "final_nl": final_nl}
+
+
+def _finalize_xml_bytes(xml_bytes, style):
+    """Привести байты к стилю оригинала; для НОВОГО файла (style is None) — к канону
+    выгрузки Конфигуратора: encoding="UTF-8", CRLF в разделителях, без перевода в конце."""
+    enc_decl = style["enc"] if style else "UTF-8"
+    xml_bytes = xml_bytes.replace(
+        b"<?xml version='1.0' encoding='UTF-8'?>",
+        b'<?xml version="1.0" encoding="' + enc_decl.encode("ascii") + b'"?>')
+    # Канонизировать переносы к LF (убирает &#13; от \r в tail'ах)
+    xml_bytes = (xml_bytes.replace(b"&#13;\n", b"\n").replace(b"&#13;", b"")
+                 .replace(b"\r\n", b"\n").replace(b"\r", b"\n"))
+    # Финальный перенос — как в оригинале (новый файл → нет, канон #57)
+    want_final_nl = style["final_nl"] if style else False
+    xml_bytes = xml_bytes.rstrip(b"\n")
+    if want_final_nl:
         xml_bytes += b"\n"
+    # EOL — как в оригинале (новый файл → CRLF, канон #57)
+    if (style["crlf"] if style else True):
+        xml_bytes = xml_bytes.replace(b"\n", b"\r\n")
+    return xml_bytes
+
+
+def save_xml_with_bom(tree, path):
+    """Save XML tree preserving the existing file's BOM/EOL/encoding-case/final-newline."""
+    style = _detect_xml_style(path)
+    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
+    xml_bytes = _finalize_xml_bytes(xml_bytes, style)
     with open(path, "wb") as f:
-        f.write(b"\xef\xbb\xbf")
+        if style is None or style["bom"]:
+            f.write(b"\xef\xbb\xbf")
         f.write(xml_bytes)
 
 
 def write_text_with_bom(path, text):
     """Write text to file with UTF-8 BOM."""
-    with open(path, "w", encoding="utf-8-sig") as f:
+    # newline="" => без трансляции: в текстовом режиме Python на Windows превратил
+    # бы \n в \r\n, а на macOS оставил \n — вывод зависел бы от ОС.
+    with open(path, "w", encoding="utf-8-sig", newline="") as f:
         f.write(text)
 
 
+def write_xml_file(path, content):
+    """XML в каноне выгрузки Конфигуратора: CRLF в разделителях, без перевода в конце.
+
+    Копия этой функции есть в каждом навыке-эмиттере (навыки автономны). Держать
+    копии одинаковыми — сознательно: разошедшиеся копии сводят на нет весь смысл.
+
+    Модуль .bsl сюда НЕ идёт — он пишется отдельно.
+    """
+    text = content.replace('\r\n', '\n').replace('\n', '\r\n').rstrip('\r\n')
+    write_text_with_bom(path, text)
+
+
 def main():
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
@@ -84,7 +329,65 @@ def main():
         sys.exit(1)
 
     object_xml_full = os.path.abspath(object_path)
-    format_version = detect_format_version(os.path.dirname(object_xml_full))
+    assert_edit_allowed(object_xml_full, "editable")
+    # Версию берём прежде всего из корня самого объекта — он её несёт всегда, а у автономной
+    # внешней обработки/отчёта подниматься к Configuration.xml просто некуда.
+    format_version = None
+    with open(object_xml_full, "r", encoding="utf-8-sig") as f:
+        obj_head = f.read(2000)
+    m_ver = re.search(r'<MetaDataObject[^>]+version="(\d+\.\d+)"', obj_head)
+    if m_ver:
+        format_version = m_ver.group(1)
+    if not format_version:
+        format_version = detect_format_version(os.path.dirname(object_xml_full))
+
+    # Объявления пространств имён — одной переменной на корень: места эмиссии их только
+    # подставляют. Правки шапки (как xmlns:pal в формате 2.21) делаются здесь, в одном месте.
+    xmlns_decl = (
+        'xmlns="http://v8.1c.ru/8.3/MDClasses"'
+        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
+        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
+        ' xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi"'
+        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
+        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
+        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
+        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
+        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
+        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
+        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
+        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
+        ' xmlns:xen="http://v8.1c.ru/8.3/xcf/enums"'
+        ' xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef"'
+        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
+        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+    )
+    form_ns_decl = (
+        'xmlns="http://v8.1c.ru/8.3/xcf/logform"'
+        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
+        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
+        ' xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"'
+        ' xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"'
+        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
+        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
+        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
+        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
+        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
+        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
+        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
+        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
+        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
+        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
+    )
+
+    # 2.21 (8.5) добавила в шапку пространство палитры — ради <Color> у значений перечисления.
+    # Вставляем НА МЕСТО (после lf, перед style): платформа держит объявления по алфавиту,
+    # дописать в конец нельзя.
+    if format_rank(format_version) >= 221:
+        pal = ' xmlns:pal="http://v8.1c.ru/8.1/data/ui/colors/palette" xmlns:style='
+        xmlns_decl = xmlns_decl.replace(' xmlns:style=', pal)
+        form_ns_decl = form_ns_decl.replace(' xmlns:style=', pal)
 
     parser_xml = etree.XMLParser(remove_blank_text=False)
     tree = etree.parse(object_xml_full, parser_xml)
@@ -94,7 +397,7 @@ def main():
         "Document", "Catalog", "DataProcessor", "Report",
         "ExternalDataProcessor", "ExternalReport",
         "InformationRegister", "AccumulationRegister", "ChartOfAccounts", "ChartOfCharacteristicTypes",
-        "ExchangePlan", "BusinessProcess", "Task",
+        "ExchangePlan", "BusinessProcess", "Task", "DocumentJournal",
     ]
 
     object_type = None
@@ -173,24 +476,7 @@ def main():
 
     form_meta_xml = (
         '<?xml version="1.0" encoding="UTF-8"?>\n'
-        '<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses"'
+        f'<MetaDataObject {xmlns_decl} version="{format_version}">\n'
-        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
-        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
-        ' xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi"'
-        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
-        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
-        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
-        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
-        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
-        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
-        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
-        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
-        ' xmlns:xen="http://v8.1c.ru/8.3/xcf/enums"'
-        ' xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef"'
-        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
-        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
-        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-        f' version="{format_version}">\n'
         f'\t<Form uuid="{form_uuid}">\n'
         '\t\t<Properties>\n'
         f'\t\t\t<Name>{form_name}</Name>\n'
@@ -207,37 +493,22 @@ def main():
         '\t\t\t\t<v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>\n'
         '\t\t\t\t<v8:Value xsi:type="app:ApplicationUsePurpose">MobilePlatformApplication</v8:Value>\n'
         '\t\t\t</UsePurposes>\n'
+        # Использование в режиме совместимости интерфейса — свойство формата 2.21 (8.5),
+        # сразу после UsePurposes (проверено по выгрузке 8.5, до ExtendedPresentation).
+        + ('\t\t\t<UseInInterfaceCompatibilityMode>Any</UseInInterfaceCompatibilityMode>\n'
+           if format_rank(format_version) >= 221 else '')
         + ('\t\t\t<ExtendedPresentation/>\n' if object_type in processor_like_types else '')
         + '\t\t</Properties>\n'
         '\t</Form>\n'
         '</MetaDataObject>'
     )
 
-    write_text_with_bom(form_meta_path, form_meta_xml)
+    write_xml_file(form_meta_path, form_meta_xml)
 
     # --- 3b. Form.xml ---
 
     form_xml_path = os.path.join(form_ext_dir, "Form.xml")
 
-    form_ns_decl = (
-        'xmlns="http://v8.1c.ru/8.3/xcf/logform"'
-        ' xmlns:app="http://v8.1c.ru/8.2/managed-application/core"'
-        ' xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config"'
-        ' xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"'
-        ' xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"'
-        ' xmlns:ent="http://v8.1c.ru/8.1/data/enterprise"'
-        ' xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform"'
-        ' xmlns:style="http://v8.1c.ru/8.1/data/ui/style"'
-        ' xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system"'
-        ' xmlns:v8="http://v8.1c.ru/8.1/data/core"'
-        ' xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"'
-        ' xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web"'
-        ' xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows"'
-        ' xmlns:xr="http://v8.1c.ru/8.3/xcf/readable"'
-        ' xmlns:xs="http://www.w3.org/2001/XMLSchema"'
-        ' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"'
-    )
-
     if purpose in ("List", "Choice"):
         # Dynamic list
         main_table = f"{object_type}.{object_name}"
@@ -336,7 +607,7 @@ def main():
     if os.path.exists(form_xml_path):
         print(f"[SKIP] Form.xml already exists: {form_xml_path} — not overwriting")
     else:
-        write_text_with_bom(form_xml_path, form_xml)
+        write_xml_file(form_xml_path, form_xml)
 
     # --- 3c. Module.bsl ---
 
@@ -367,7 +638,10 @@ def main():
     if os.path.exists(module_path):
         print(f"[SKIP] Module.bsl already exists: {module_path} — not overwriting")
     else:
-        write_text_with_bom(module_path, module_bsl)
+        # Модуль пишем в каноне платформы: CRLF в разделителях строк (корпус: 2643 CRLF,
+        # чисто-LF 0 из 3001). Хвостовой перевод НЕ навязываем — у платформы он
+        # неканоничен (1235 модулей с ним, 766 без).
+        write_text_with_bom(module_path, module_bsl.replace('\r\n', '\n').replace('\n', '\r\n'))
 
     # --- Phase 4: Register in parent object ---
 
@@ -377,47 +651,50 @@ def main():
         print(f"Не найден элемент ChildObjects в {object_path}", file=sys.stderr)
         sys.exit(1)
 
-    # Add <Form>$FormName</Form>
+    # Add <Form>$FormName</Form> — idempotent (do not duplicate already-registered form)
-    form_elem = etree.Element(f"{{{ns}}}Form")
+    already_registered = child_objects.find(f"md:Form[.='{form_name}']", NSMAP) is not None
-    form_elem.text = form_name
 
-    # Find first <Template> to insert before it
+    if not already_registered:
-    first_template = child_objects.find("md:Template", NSMAP)
+        form_elem = etree.Element(f"{{{ns}}}Form")
-    # Find first <TabularSection> to insert before it (if no Template)
+        form_elem.text = form_name
-    first_tabular = child_objects.find("md:TabularSection", NSMAP)
 
-    # Determine insertion point: before Template, before TabularSection, or at end
+        # Find first <Template> to insert before it
-    insert_before = None
+        first_template = child_objects.find("md:Template", NSMAP)
-    if first_template is not None:
+        # Find first <TabularSection> to insert before it (if no Template)
-        insert_before = first_template
+        first_tabular = child_objects.find("md:TabularSection", NSMAP)
-    elif first_tabular is not None:
-        insert_before = first_tabular
 
-    if insert_before is not None:
+        # Determine insertion point: before Template, before TabularSection, or at end
-        # Insert before the found element
+        insert_before = None
-        idx = list(child_objects).index(insert_before)
+        if first_template is not None:
-        child_objects.insert(idx, form_elem)
+            insert_before = first_template
-        # Whitespace: form_elem gets "\n\t\t\t" as tail (indent before insert_before)
+        elif first_tabular is not None:
-        form_elem.tail = "\n\t\t\t"
+            insert_before = first_tabular
-    else:
+
-        # Add to end of ChildObjects
+        if insert_before is not None:
-        children = list(child_objects)
+            # Insert before the found element
-        if len(children) == 0 and (child_objects.text is None or child_objects.text.strip() == ""):
+            idx = list(child_objects).index(insert_before)
-            # Empty ChildObjects (self-closing)
+            child_objects.insert(idx, form_elem)
-            child_objects.text = "\n\t\t\t"
+            # Whitespace: form_elem gets "\n\t\t\t" as tail (indent before insert_before)
-            child_objects.append(form_elem)
+            form_elem.tail = "\n\t\t\t"
-            form_elem.tail = "\n\t\t"
         else:
-            if len(children) > 0:
+            # Add to end of ChildObjects
-                last_child = children[-1]
+            children = list(child_objects)
-                old_tail = last_child.tail
+            if len(children) == 0 and (child_objects.text is None or child_objects.text.strip() == ""):
-                last_child.tail = "\n\t\t\t"
+                # Empty ChildObjects (self-closing)
-                child_objects.append(form_elem)
+                child_objects.text = "\n\t\t\t"
-                form_elem.tail = old_tail if old_tail else "\n\t\t"
-            else:
-                child_objects.text = (child_objects.text or "") + "\n\t\t\t"
                 child_objects.append(form_elem)
                 form_elem.tail = "\n\t\t"
+            else:
+                if len(children) > 0:
+                    last_child = children[-1]
+                    old_tail = last_child.tail
+                    last_child.tail = "\n\t\t\t"
+                    child_objects.append(form_elem)
+                    form_elem.tail = old_tail if old_tail else "\n\t\t"
+                else:
+                    child_objects.text = (child_objects.text or "") + "\n\t\t\t"
+                    child_objects.append(form_elem)
+                    form_elem.tail = "\n\t\t"
 
     # --- SetDefault ---
 
@@ -462,7 +739,10 @@ def main():
     print(f"  Form:     {obj_dir_name}\\{obj_base_name}\\Forms\\{form_name}\\Ext\\Form.xml")
     print(f"  Module:   {obj_dir_name}\\{obj_base_name}\\Forms\\{form_name}\\Ext\\Form\\Module.bsl")
     print()
-    print(f"Registered: <Form>{form_name}</Form> in ChildObjects")
+    if already_registered:
+        print(f"Already registered: <Form>{form_name}</Form> in ChildObjects (skipped duplicate)")
+    else:
+        print(f"Registered: <Form>{form_name}</Form> in ChildObjects")
     if default_updated:
         print(f"{default_prop_name}: {default_value}")
     print()

.claude/skills/form-compile/references/appearance.md

@@ -0,0 +1,123 @@
+# Оформление
+
+Два независимых механизма: **оформление элемента** (постоянные цвета/шрифт/граница на конкретном элементе) и **условное оформление формы** (`conditionalAppearance` — правила, применяемые при выполнении условия).
+
+## Оформление элемента (цвета / шрифты / граница)
+
+Свойства задаются прямо на элементе. Применимо к полям (`input`/`check`/`radio`/`labelField`/`picField`/`calendar`), декорациям (`label`/`picture`), кнопкам (`button`), группам (`group`/`columnGroup`), страницам (`page`/`pages`), попапам (`popup`) и таблицам (`table`). Каждое свойство необязательно.
+
+| Ключ | Что задаёт |
+|------|-----------|
+| `textColor` | Цвет текста |
+| `backColor` | Цвет фона |
+| `borderColor` | Цвет рамки |
+| `font` | Шрифт |
+| `border` | Граница |
+| `titleTextColor` / `titleBackColor` / `titleFont` | Цвет текста / цвет фона / шрифт заголовка колонки (`labelField`, колонки таблицы); у `page`/`pages`/`popup` — `titleTextColor`/`titleFont` заголовка страницы/попапа |
+| `footerTextColor` / `footerBackColor` / `footerFont` | Цвет текста / цвет фона / шрифт подвала колонки |
+
+Те же свойства доступны и через словарь `appearance` элемента — под русскими именами параметров платформы: `ЦветТекста`, `ЦветФона`, `ЦветРамки`, `Шрифт`, `Граница`, `ЦветТекстаЗаголовка`, `ЦветФонаЗаголовка`, `ШрифтЗаголовка`, `ЦветТекстаПодвала`, `ЦветФонаПодвала`, `ШрифтПодвала`. Это та же запись, что и в правилах условного оформления (ниже) и в `appearance` поля дин-списка.
+
+### Цвет
+
+Строка в одной из форм:
+
+| Форма | Значение |
+|-------|----------|
+| `web:Имя` | Цвет из web-палитры, напр. `web:Red`, `web:FireBrick`, `web:HoneyDew` |
+| `win:Имя` | Системный цвет Windows, напр. `win:MenuBar`, `win:ButtonText`, `win:DisabledText` |
+| `style:ИмяСтиля` | Ссылка на элемент стиля конфигурации/платформы, напр. `style:FormBackColor`, `style:BorderColor` |
+| `#RRGGBB` | RGB-hex, напр. `#FF0000` |
+
+Имя должно существовать в своей палитре (несуществующий web-/win-цвет или ссылка на отсутствующий `style:`-элемент — ошибка загрузки формы).
+
+### Шрифт (`font` / `titleFont` / `footerFont`)
+
+- Строка `"style:ИмяСтиля"` — шрифт из элемента стиля. Минимальная форма.
+- Объект — задаются только нужные атрибуты:
+
+| Ключ | Назначение |
+|------|-----------|
+| `ref` | Ссылка на стиль (`"style:X"`) или системный шрифт (`"sys:…"`) |
+| `faceName` | Имя гарнитуры (для собственного шрифта) |
+| `height` | Размер |
+| `bold` / `italic` / `underline` / `strikeout` | `true`/`false` — начертание |
+| `scale` | Масштаб, % |
+| `kind` | `Absolute` (собственный шрифт — с `faceName`+`height`) / `WindowsFont` (системный — с `ref:"sys:…"`) |
+
+```json
+{ "label": "Внимание!", "textColor": "web:FireBrick",
+  "font": { "faceName": "Arial", "height": 12, "bold": true, "kind": "Absolute", "scale": 100 } }
+```
+
+### Граница (`border`)
+
+- Строка `"style:ИмяСтиля"` (или объект `{ "ref": "style:X" }`) — граница из стиля.
+- Объект `{ "width": N, "style": "..." }` — собственная граница. `style` — один из: `Single`, `Double`, `Underline`, `DoubleUnderline`, `Overline`, `Embossed`, `Indented`, `WithoutBorder`.
+
+```json
+{ "input": "Цена", "path": "Объект.Цена", "textColor": "#FF0000",
+  "borderColor": "style:BorderColor", "border": { "width": 1, "style": "Single" } }
+{ "labelField": "Код", "titleTextColor": "web:HoneyDew", "border": "style:ControlBorder" }
+```
+
+## Условное оформление формы (`conditionalAppearance`)
+
+Форменный ключ верхнего уровня — массив правил. Каждое правило применяет оформление к перечисленным полям, когда выполняется его условие.
+
+```json
+"conditionalAppearance": [
+  { "selection": ["ОбычноеПоле"], "filter": ["ЧисловоеПоле > 100"],
+    "appearance": { "ЦветФона": "style:FormBackColor" },
+    "presentation": { "ru": "Подсветка", "en": "Highlight" } }
+]
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `selection` | array | Имена форматируемых полей формы |
+| `filter` | array | Условие применения (грамматика — ниже) |
+| `appearance` | object | Словарь «параметр платформы: значение» |
+| `presentation` | string / object | Подпись правила в списке настроек |
+| `use` | bool | `false` — правило отключено |
+| `viewMode` | string | Режим отображения настройки |
+| `userSettingID` | string | Идентификатор пользовательской настройки; `"auto"` — сгенерировать |
+
+### filter
+
+Та же грамматика, что в отборе списка — shorthand `"Поле оператор значение @флаги"` или объект:
+
+```json
+"filter": [
+  "Статус = 3",
+  { "field": "Сумма", "op": ">=", "value": 1000 },
+  { "group": "Or", "items": [ "Просрочено = true", "Заблокирован = true" ] }
+]
+```
+
+- **Операторы:** `=` `<>` `>` `>=` `<` `<=`, `in` / `notIn`, `inHierarchy`, `contains` / `notContains`, `beginsWith` / `notBeginsWith`, `like` / `notLike` (`%`-шаблон), `filled` / `notFilled`.
+- **Флаги:** `@off` (отключён), `@user`, `@quickAccess`; `_` = пустое значение.
+- **Группа:** `{ "group": "And"|"Or"|"Not", "items": [...], "use"? }`.
+- **Дата-значение:** ISO-дата `"2024-01-01T00:00:00"` — фиксированная дата; именованный относительный период — строкой `"BeginningOfThisWeek"` с `"valueType": "v8:StandardBeginningDate"` (варианты `BeginningOfThisDay`/`BeginningOfThisWeek`/`BeginningOfThisMonth`/`BeginningOfThisYear`/…).
+
+### appearance
+
+Словарь «параметр платформы: значение». Имена параметров — русские: `ЦветТекста`, `ЦветФона`, `Шрифт`, `Граница`, `Текст`, `Заголовок`, `Формат`, `ВидимостьЭлемента`, `Доступность` и другие параметры оформления компоновки.
+
+Значения:
+- **Цвет** (`ЦветТекста`/`ЦветФона`/…) и **шрифт** (`Шрифт`) — те же формы, что в оформлении элемента выше (`web:`/`win:`/`style:`/`#RRGGBB`; шрифт — строка `"style:X"` или объект).
+- **Текстовые параметры** (`Текст`/`Заголовок`/`Формат`) — по форме значения:
+  - голая строка → нелокализованный литерал (`""` → пустое значение);
+  - объект `{ "ru": "...", "en": "..." }` → локализуемая строка;
+  - объект `{ "field": "путь" }` → ссылка на поле компоновки.
+
+```json
+"conditionalAppearance": [
+  { "selection": ["Остаток"], "filter": ["Остаток < 0"],
+    "appearance": { "ЦветТекста": "web:Red", "Шрифт": { "bold": true } } },
+  { "selection": ["Комментарий"], "filter": ["Комментарий notFilled"],
+    "appearance": { "Текст": { "ru": "— нет данных —" }, "ЦветТекста": "win:DisabledText" } }
+]
+```
+
+> Условное оформление **самого дин-списка** задаётся не здесь, а в `settings.conditionalAppearance` реквизита-списка — см. `references/dynamic-list.md`.

.claude/skills/form-compile/references/charts.md

@@ -0,0 +1,143 @@
+# Диаграммы, диаграмма Ганта, планировщик
+
+Поле-диаграмма (`chart` / `ganttChart`), поле-планировщик (`planner`) и дендрограмма выводят значение из реквизита соответствующего типа. Конструкция всегда двойная:
+
+1. **Реквизит** chart/planner-типа (несёт данные и, при необходимости, design-time конфиг).
+2. **Элемент** формы, привязанный к реквизиту через `path`.
+
+Минимум — реквизит нужного типа плюс элемент с тем же `path`:
+
+```json
+"attributes": [ { "name": "Диаграмма", "type": "d5p1:Chart" } ],
+"items":      [ { "chart": "ПолеДиаграммы", "path": "Диаграмма" } ]
+```
+
+Реквизит, заполняемый в коде (без встроенной настройки), достаточно объявить типом — элемент привязывается и работает.
+
+## Типы реквизита и элемента
+
+| Элемент | Ключ типа | Тип реквизита | Что несёт элемент дополнительно |
+|---------|-----------|---------------|---------------------------------|
+| Диаграмма | `chart` | `d5p1:Chart` | — |
+| Диаграмма Ганта | `ganttChart` | `d5p1:GanttChart` | `ganttTable` — вложенная таблица (см. ниже) |
+| Планировщик | `planner` | `pl:Planner` | — |
+| График. схема | `graphicalSchema` | `d5p1:FlowchartContextType` | `edit`, `warningOnEditRepresentation` |
+| Период | `periodField` | `v8:StandardPeriod` | — |
+| Дендрограмма | `dendrogram` | — | — |
+
+Имя элемента — значение ключа (`"chart": "ПолеДиаграммы"`); `path` — короткое имя реквизита.
+
+### Элемент диаграммы Ганта (`ganttTable`)
+
+У поля Ганта внутри лежит полноценная таблица — задаётся ключом `ganttTable` (та же грамматика, что у обычной `table`):
+
+```json
+{ "ganttChart": "Ганта", "path": "Ганта",
+  "ganttTable": { "table": "ТаблицаГанта", "path": "Ганта", "height": 3 } }
+```
+
+## Design-time конфиг диаграммы (`chart`)
+
+Реквизит типа `d5p1:Chart` / `d5p1:GanttChart` может нести встроенную настройку диаграммы — объект `chart` на реквизите. Платформа всегда пишет полный набор свойств (~127: тип, серии, легенда, заголовок, шкалы, цвета, шрифты, оси), поэтому **авторинг с нуля непрактичен** — возьмите рабочую диаграмму за основу и правьте смысловое ядро.
+
+Ключи `chart` = канонические имена свойств диаграммы; задавайте только те, что меняете:
+
+```json
+{ "name": "Диаграмма", "type": "d5p1:Chart", "chart": {
+  "chartType": "Line",
+  "isSeriesDesign": true, "realSeriesCount": "2",
+  "realSeriesData": [
+    { "id": "1", "color": "auto", "line": {"width":2,"gap":false,"style":"Solid"},
+      "marker": "Auto", "text": "Серия 1", "strIsChanged": false, "isExpand": false,
+      "isIndicator": false, "colorPriority": false }
+  ],
+  "isShowTitle": true, "title": "Продажи",
+  "isShowLegend": true, "legendPlacement": "Bottom",
+  "paletteKind": "Auto"
+} }
+```
+
+Смысловое ядро для правки:
+
+| Ключ | Назначение |
+|------|------------|
+| `chartType` | Тип: `Line` / `Pie` / `Bar` / `Histogram` / `Column` / `Area` / … |
+| `realSeriesData` | Массив серий — объекты `{ id, text, color, line, marker, … }` |
+| `isShowTitle` + `title` | Показ и текст заголовка |
+| `isShowLegend` + `legendPlacement` | Показ и расположение легенды (`Bottom` / `Right` / …) |
+| `paletteKind` | Палитра (`Auto` / …) |
+| `bkgColor` / `labelsColor` / … | Базовые цвета |
+
+Формы значений внутри `chart`:
+
+- **Цвета** — verbatim: `auto`, `style:ИмяСтиля`, `web:Red`, `#hex`.
+- **`line`** — `{ width, gap, style }` (стиль линии: `Solid` / …).
+- **`border`** — `{ width, style }`.
+- **`font`** — `{ kind: "AutoFont" }` либо атрибуты шрифта.
+- **Локализуемые строки** (`title`, `vsFormat`, `lbFormat`, `labelFormat`, серия `text`, …) — голая строка либо `{ "ru": "…", "en": "…" }`.
+- **Области** (`elementsChart` / `elementsLegend` / `elementsTitle`) — `{ left, right, top, bottom }`.
+- **Серии** (`realSeriesData` / `realExSeriesData`) — массивы объектов.
+
+Любое из ~127 свойств переопределяется по каноническому имени; остальное оставляйте дефолтным (не указывайте — берётся из основы).
+
+### Диаграмма Ганта (`d5p1:GanttChart`)
+
+Реквизит типа `d5p1:GanttChart` использует **тот же** ключ `chart`. Внутри — вложенный полный `chart`-блок плюс гант-специфика (`points` / `series` / `timeScale` / `drawEmpty` / …). Так же берите рабочую диаграмму Ганта за основу.
+
+> **Ограничение.** Диаграммы (Chart/Gantt) с заполненными **точками/осями** (`realPointData` / `realDataItems`, заполненные `valuesAxis` / `pointsAxis`) генерик-движком не поддержаны — это редкий вариант. Частые дашборд-диаграммы и диаграммы Ганта (серии / легенда / оформление / шкалы) поддержаны полностью.
+
+## Design-time конфиг планировщика (`planner`)
+
+Реквизит типа `pl:Planner` несёт встроенную настройку планировщика — объект `planner`. Компилятор подставляет умолчания для пропущенных ключей, поэтому авторинг может быть кратким:
+
+```json
+{ "name": "Планировщик", "type": "pl:Planner", "planner": {
+  "items": [
+    { "text": "Встреча", "begin": "2026-06-09T01:00:00", "end": "2026-06-09T04:00:00",
+      "borderColor": "auto", "backColor": "auto", "deleted": false, "editMode": "EnableEdit" }
+  ],
+  "period": { "begin": "2026-06-09T00:00:00", "end": "2026-06-09T23:59:59" },
+  "displayCurrentDate": true, "itemsTimeRepresentation": "BeginTime",
+  "timeScale": { "placement": "Left", "levels": [ { "measure": "Hour", "interval": 1 } ] }
+} }
+```
+
+Минимум — один `item`:
+
+```json
+"planner": { "items": [ { "text": "Встреча", "begin": "2026-06-09T01:00:00", "end": "2026-06-09T04:00:00" } ] }
+```
+
+| Ключ `planner` | Тип | Назначение |
+|----------------|-----|------------|
+| `items` | array | Элементы расписания. Поля элемента: `text`, `tooltip`, `begin`, `end`, `value`, `borderColor`, `backColor`, `textColor`, `font`, `border`, `replacementDate`, `deleted` (bool), `editMode` (`EnableEdit` / …), `id` (необязательно — авто-GUID), `textFormatted` |
+| `dimensions` | array | Измерения (разрезы) планировщика. Поля: `value` (объект разреза — ссылка `Enum.X.EnumValue.Y` / `Справочник.X`; опустить → пусто), `text` (заголовок), `borderColor`, `backColor`, `textColor`, `font`, `textFormatted`, `elements`. `elements` — элементы измерения, рекурсивны (могут нести вложенные `elements`): `value`, `text`, цвета, `font`, `showOnlySubordinatesAreas` (bool), `textFormatted` |
+| `period` | object | Отображаемый период `{ begin, end }` (необязательно) |
+| `timeScale` | object | Шкала времени (см. ниже) |
+| `borderColor` / `backColor` / `textColor` / `lineColor` | color | Цвета (умолч. `auto`) |
+| `font` | font | Шрифт (умолч. `{ kind: "AutoFont" }`) |
+| `border` | border | Рамка `{ width, style }` |
+| `beginOfRepresentationPeriod` / `endOfRepresentationPeriod` | dateTime | Период представления |
+| `displayCurrentDate` / `displayWrapHeaders` / `displayTimeScaleWrapHeaders` / `alignElementsOfTimeScale` | bool | Флаги отображения |
+| `timeScaleWrapHeadersFormat` | ML | Формат перенесённых заголовков шкалы |
+| `timeScaleWrapBeginIndent` / `timeScaleWrapEndIndent` | int | Отступы переноса шкалы |
+| `periodicVariantUnit` / `periodicVariantRepetition` | value / int | Единица и кратность периодического варианта |
+| `itemsTimeRepresentation` | value | Представление времени элементов (`BeginTime` / …) |
+| `itemsBehaviorWhenSpaceInsufficient` / `newItemsTextType` / `fixDimensionsHeader` / `fixTimeScaleHeader` | value | Поведение элементов и заголовков |
+| `autoMinColumnWidth` / `autoMinRowHeight` | bool | Авто-минимум размеров |
+| `minColumnWidth` / `minRowHeight` | int | Минимальные размеры |
+
+Шкала времени (`timeScale`):
+
+```json
+"timeScale": {
+  "placement": "Left",
+  "levels": [ { "measure": "Hour", "interval": 1 } ]
+}
+```
+
+Ключи: `placement`, `levels` (массив уровней), `transparent`, `backColor`, `textColor`, `currentLevel`. Уровень: `measure` (`Hour` / `Day` / …), `interval`, `show`, `line` (`{ width, gap, style }`), `scaleColor`, `dayFormatRule`, `format` (ML), `labels` (`{ ticks }`), `backColor`, `textColor`, `showPereodicalLabels`.
+
+Формы значений в `planner` те же, что у диаграммы: цвета verbatim (`auto` / `style:X` / `web:Red` / `#hex`); шрифт `{ kind: "AutoFont" }` либо ref-строка; граница `{ width, style }`; ML-форматы — строка или `{ "ru": …, "en": … }`.
+
+> **Ограничение.** Привязка элемента расписания к элементам измерений (`item.dimensionValues`) пока всегда пустая. Сами измерения (`dimensions`) задавать можно.

.claude/skills/form-compile/references/choice-params.md

@@ -0,0 +1,73 @@
+# Параметры выбора и связь по типу
+
+Свойства поля ввода (`input`), управляющие выбором значения: чем ограничен список выбора и каким будет тип значения. Имена параметров — строки 1С как есть (`"Отбор.Х"`).
+
+```json
+{ "input": "Контрагент", "path": "Объект.Контрагент",
+  "choiceParameters": [
+    { "name": "Отбор.Активный", "value": true },
+    { "name": "Отбор.ВидПродукции", "value": ["Enum.Виды.Агрохимикат", "Enum.Виды.Пестицид"] }
+  ],
+  "choiceParameterLinks": [
+    { "name": "Отбор.Организация", "dataPath": "Объект.Организация" },
+    { "name": "Отбор.Тип", "dataPath": "Объект.Тип", "valueChange": "DontChange" }
+  ],
+  "typeLink": { "dataPath": "Объект.ЗначениеДата", "linkItem": 0 }
+}
+```
+
+## Параметры выбора (`choiceParameters`)
+
+Фиксированные значения параметров выбора, отбирающие список значений независимо от данных формы. Массив объектов `{ name, value }`:
+
+- `name` — имя параметра (`"Отбор.Активный"`).
+- `value` — значение. Допустимы: bool, число, строка, ISO-дата (`"2020-01-01T00:00:00"`), ссылка-путь (`Enum.X.Y`, `Catalog.X`). **Массив** значений задаёт фиксированный массив.
+
+Короткая форма — строки `"name=value"`; значение с запятыми становится массивом, `true`/`false` → bool, число → число, остальное → строка/ссылка:
+
+```json
+"choiceParameters": [
+  "Отбор.Активный=true",
+  "Отбор.ВидПродукции=Enum.Виды.Агрохимикат, Enum.Виды.Пестицид"
+]
+```
+
+## Связи параметров выбора (`choiceParameterLinks`)
+
+Параметры выбора, значение которых берётся из **другого поля формы** (а не задано фиксированно). Типовой случай — отбор списка договоров по выбранному контрагенту. Массив объектов `{ name, dataPath, valueChange? }`:
+
+- `name` — имя параметра выбора.
+- `dataPath` — путь к полю формы, чьё значение подставляется в параметр.
+- `valueChange` — что делать с уже выбранным значением при смене источника: `Clear` (очистить, необязательно — поведение по умолчанию) / `DontChange` (не менять).
+
+```json
+{ "input": "Договор", "path": "Объект.Договор",
+  "choiceParameterLinks": [
+    { "name": "Отбор.Владелец", "dataPath": "Объект.Контрагент" }
+  ]
+}
+```
+
+Короткая форма — строки `"name=dataPath"`, опциональный хвост `:Clear` / `:DontChange`:
+
+```json
+"choiceParameterLinks": [ "Отбор.Организация=Объект.Организация", "Отбор.Тип=Объект.Тип:DontChange" ]
+```
+
+## Связь по типу (`typeLink`)
+
+Тип значения поля определяется другим полем формы (напр. поле «Значение» субконто, тип которого задаётся выбранным видом субконто). Объект `{ dataPath, linkItem }`:
+
+- `dataPath` — путь к полю, задающему тип.
+- `linkItem` — индекс элемента связи (необязательно, по умолчанию `0`).
+
+```json
+"typeLink": { "dataPath": "Объект.ВидСубконто", "linkItem": 0 }
+```
+
+Короткая форма — строка `"dataPath"` либо `"dataPath#linkItem"`:
+
+```json
+"typeLink": "Объект.ВидСубконто"
+"typeLink": "Объект.ВидСубконто#1"
+```

.claude/skills/form-compile/references/command-interface.md

@@ -0,0 +1,86 @@
+# Командный интерфейс формы
+
+Форменный ключ `commandInterface` управляет расстановкой команд по двум панелям формы:
+
+- `commandBar` — командная панель формы;
+- `navigationPanel` — панель навигации.
+
+Указывать нужно **только команды, у которых меняется расстановка по умолчанию** (видимость, группа, порядок). Команды, которые платформа размещает автоматически и без изменений, в блок не включают.
+
+```json
+"commandInterface": {
+  "commandBar": [
+    { "command": "Form.Command.Печать", "defaultVisible": false, "group": "FormCommandBarImportant",
+      "visible": { "common": false, "roles": { "Бухгалтер": true } } },
+    "CommonCommand.История"
+  ],
+  "navigationPanel": {
+    "important": [ { "command": "CommonCommand.СвязанныеДокументы", "defaultVisible": false, "visible": false } ],
+    "seeAlso":   [ { "command": "CommonCommand.Заметки", "defaultVisible": false, "visible": false } ]
+  }
+}
+```
+
+## Элемент-команда
+
+Каждый элемент панели — объект, либо строка-shorthand (= голый `command` со всеми остальными свойствами по умолчанию):
+
+```json
+"CommonCommand.История"
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `command` | string | Ссылка на команду дословно: `CommonCommand.X`, `Document.X.StandardCommand.Y`, `Form.Command.X`, `Form.StandardCommand.OK`, `"0"` (пустой / разделитель) |
+| `type` | string | `Auto` (по умолчанию, необязательно) или `Added` |
+| `defaultVisible` | bool | Видимость по умолчанию. На практике задаётся только `false` — чтобы скрыть команду, которая иначе видна |
+| `visible` | bool / object | Видимость с исключениями по ролям: `bool` либо `{ "common": bool, "roles": { "Имя": bool } }` |
+| `group` | string | Группа размещения дословно: предопределённая (`FormCommandBarImportant`, `FormNavigationPanelGoTo`, …), именованная (`CommandGroup.X`) или GUID-группа расширения |
+| `index` | int | Порядок команды внутри группы |
+| `attribute` | string | Путь реквизита для элемента панели навигации |
+
+## Две формы записи панели
+
+Панель можно описать **плоским массивом** или **деревом по группам** — выбирайте любую.
+
+**Плоский массив** — каждый элемент при необходимости несёт собственный `group`:
+
+```json
+"commandBar": [
+  { "command": "Form.Command.Печать", "group": "FormCommandBarImportant", "defaultVisible": false },
+  { "command": "CommonCommand.История", "group": "FormCommandBarImportant", "index": 1 }
+]
+```
+
+**Дерево** — объект `{ группа: [команды] }`; группа берётся из ключа, элементы её не повторяют:
+
+```json
+"navigationPanel": {
+  "important": [ "CommonCommand.СвязанныеДокументы" ],
+  "goTo":      [ { "command": "Document.Заказ.StandardCommand.Movements", "defaultVisible": false, "visible": false } ],
+  "seeAlso":   [ "CommonCommand.Заметки" ]
+}
+```
+
+Ключи-группы дерева зависят от панели:
+
+- `navigationPanel`: `important`, `goTo`, `seeAlso` (можно по-русски — `важное`, `перейти`, `смТакже`);
+- `commandBar`: `important`, `createBasedOn`;
+- любой другой ключ (`CommandGroup.X` или GUID) подставляется в группу дословно.
+
+## Скрыть видимую команду
+
+Самый частый случай — убрать команду, которую платформа показывает по умолчанию:
+
+```json
+"commandBar": [
+  { "command": "Form.Command.Печать", "defaultVisible": false, "visible": false }
+]
+```
+
+Показать команду только некоторым ролям:
+
+```json
+{ "command": "Form.Command.Печать", "defaultVisible": false,
+  "visible": { "common": false, "roles": { "Бухгалтер": true } } }
+```

.claude/skills/form-compile/references/companion-panels.md

@@ -0,0 +1,131 @@
+# Companion-панели и расширенная подсказка элемента
+
+Любой элемент формы может нести свой собственный контент в трёх companion-свойствах: расширенную подсказку (`extendedTooltip`), командную панель (`commandBar`) и контекстное меню (`contextMenu`). Все три задаются ключами прямо на объекте элемента.
+
+```jsonc
+{ "table": "Список", "path": "Список",
+  "commandBar": { "children": [ … ] },
+  "contextMenu": { "children": [ … ] },
+  "extendedTooltip": "Двойной клик открывает карточку" }
+```
+
+## Расширенная подсказка (`extendedTooltip`)
+
+Подсказка-надпись рядом с элементом. Две формы записи.
+
+**Текст-форма** — просто текст подсказки:
+
+```jsonc
+"extendedTooltip": "Укажите ИНН контрагента"
+"extendedTooltip": { "ru": "Сумма с НДС", "en": "Amount incl. VAT" }
+"extendedTooltip": { "text": "Всего <b>с НДС</b>", "formatted": true }
+```
+
+- строка — ru-текст;
+- `{ "ru": …, "en": … }` — многоязычный (как `title`);
+- `{ "text": …, "formatted": true }` — форматированный текст (inline-разметка 1С: `<b>…</>`, `<i>`, `<u>`, `<color web:Red>…</>`, `<bgColor …>`, `<font …>`, `<fontSize …>`, `<link URL>…</>`, `<img …>`; закрывающий тег — `</>`). `formatted` нужен только когда текст содержит такую разметку.
+
+**Own-content форма** — объект с раскладкой/оформлением/флагами, когда подсказке нужны размеры, цвет, гиперссылка и т.п.:
+
+```jsonc
+"extendedTooltip": {
+  "text": "Перейти к инструкции",
+  "hyperlink": true,
+  "textColor": "web:Blue",
+  "events": { "URLProcessing": "ПодсказкаОбработкаНавигационнойСсылки" }
+}
+```
+
+Ключи own-content объекта (все необязательны):
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `text` | string/ML | Текст подсказки (с `formatted` — форматированный) |
+| `formatted` | bool | Интерпретировать inline-разметку в `text` |
+| `tooltip` | string/ML | Всплывающая подсказка самой расширенной подсказки (редко; ≠ обычному `tooltip` элемента) |
+| `hyperlink` | bool | Сделать подсказку гиперссылкой |
+| `visible` / `enabled` | bool | Видимость / доступность подсказки |
+| `width` / `height` | number | Размеры |
+| `maxWidth` / `autoMaxWidth` | number / bool | Максимальная ширина / авто-максимум |
+| `titleHeight` | number | Высота заголовка |
+| `horizontalStretch` | bool | Горизонтальное растяжение |
+| `verticalAlign` | string | Вертикальное выравнивание |
+| `textColor` / `font` | string/object | Цвет текста / шрифт (см. `references/appearance.md`) |
+| `events` | object | Обработчики событий подсказки, напр. `{ "URLProcessing": "Имя" }` у гиперссылочной подсказки |
+
+## Командная панель (`commandBar`)
+
+Собственная командная панель элемента (обычно таблицы или группы).
+
+**Значение** — массив или объект:
+
+```jsonc
+"commandBar": [ { "button": "Создать", "command": "СоздатьЭлемент" } ]
+
+"commandBar": {
+  "autofill": false,
+  "horizontalAlign": "Right",
+  "children": [
+    { "button": "Создать", "command": "СоздатьЭлемент" },
+    { "buttonGroup": "Печать", "children": [ … ] }
+  ]
+}
+```
+
+- массив `[ … ]` — краткая запись для `{ "children": [ … ] }`;
+- объект — `children` плюс необязательные `autofill` и `horizontalAlign`.
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `children` | array | Содержимое панели — обычная грамматика кнопок (см. основную инструкцию) |
+| `autofill` | bool | `false` — подавить автозаполнение панели стандартными командами. Необязательно (по умолчанию панель автозаполняется) |
+| `horizontalAlign` | string | Горизонтальное выравнивание содержимого: `Left` / `Center` / `Right`. Необязательно |
+
+`children` — кнопки: `button` (с `command` / `commandName` / `stdCommand`), `buttonGroup`, `popup` — как в основной инструкции по кнопкам.
+
+> Для таблицы динамического списка панель по умолчанию подавлена (чтобы не дублировать командную панель формы). Чтобы оставить автозаполняемую панель у самой таблицы — задайте `commandBar: { "autofill": true }`.
+
+## Контекстное меню (`contextMenu`)
+
+Собственное контекстное меню элемента. Грамматика та же, что у `commandBar`, но без `horizontalAlign`.
+
+```jsonc
+"contextMenu": [ { "button": "Карта маршрута", "commandName": "CommonCommand.КартаМаршрута" } ]
+
+"contextMenu": {
+  "autofill": false,
+  "children": [
+    { "button": "Скопировать ссылку", "command": "СкопироватьСсылку" }
+  ]
+}
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `children` | array | Пункты меню — обычная грамматика кнопок |
+| `autofill` | bool | `false` — подавить автозаполнение меню. Необязательно |
+
+## Пример: таблица со своим меню и инфо-баннером
+
+```jsonc
+{ "table": "Заказы", "path": "Объект.Заказы",
+  "extendedTooltip": {
+    "text": "Строки с просрочкой выделены <color web:FireBrick>красным</>",
+    "formatted": true
+  },
+  "commandBar": {
+    "autofill": false,
+    "horizontalAlign": "Right",
+    "children": [
+      { "button": "Добавить", "command": "ДобавитьЗаказ" },
+      { "button": "Удалить", "command": "УдалитьЗаказ" }
+    ]
+  },
+  "contextMenu": {
+    "children": [
+      { "button": "Открыть документ", "command": "ОткрытьЗаказ" },
+      { "buttonGroup": "Экспорт", "children": [
+        { "button": "В Excel", "command": "ВыгрузитьВExcel" } ] }
+    ]
+  } }
+```

.claude/skills/form-compile/references/dynamic-list.md

@@ -0,0 +1,144 @@
+# Динамический список
+
+Реквизит с `type: "DynamicList"` (обычно `main: true`) — основа формы списка. Объект `settings` описывает источник данных и настройки списка. Минимум — указать источник:
+
+```json
+{ "name": "Список", "type": "DynamicList", "main": true,
+  "settings": { "mainTable": "Catalog.Контрагенты" } }
+```
+
+К списку привязывается таблица-элемент (`table`), ссылающаяся на реквизит через `path` — см. основную инструкцию.
+
+## Источник данных
+
+Два взаимоисключающих режима:
+
+**Таблично-ориентированный** — основная таблица метаданных:
+
+```json
+"settings": { "mainTable": "Catalog.Контрагенты" }
+```
+
+**Запросный** — произвольный запрос:
+
+```json
+"settings": {
+  "query": "ВЫБРАТЬ Т.Ссылка, Т.Наименование, Т.Сумма ИЗ Документ.Заказ КАК Т ГДЕ Т.Сумма > &Порог",
+  "mainTable": "Document.Заказ"
+}
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `mainTable` | string | Основная таблица (`Catalog.X` / `Document.X` / …). Можно вместе с `query` |
+| `query` | string | Текст запроса. Поддерживает `@file.sql` (путь к файлу запроса рядом с JSON) |
+| `keyType` | string | Запросный список без `mainTable`: тип ключа набора — `FieldValue` / `RowKey` / `RowNumber` |
+| `keyFields` | array | Поля ключа набора (для `keyType` без `mainTable`) |
+
+Параметры запроса (`&Имя`) задаются в `parameters` (ниже).
+
+`"dynamicDataRead": false` отключает динамическое считывание (список читается обычным запросом, без фонового обновления) — нужно для тяжёлых/агрегатных запросов.
+
+## Параметры запроса (`parameters`)
+
+Значения для `&параметров` текста запроса. Shorthand `"Имя [Заголовок]: тип = Значение"` (всё кроме имени необязательно) либо объект:
+
+```json
+"settings": {
+  "query": "… ГДЕ Т.Артикул = &Артикул И Т.Цена ПОДОБНО &Маска",
+  "parameters": [
+    "Артикул",
+    "Маска: string = %",
+    { "name": "ВидЦен", "valueListAllowed": true },
+    { "name": "Период", "type": "dateTime" }
+  ]
+}
+```
+
+Ключи объекта: `name`, `title`, `type` (грамматика типов — см. основную инструкцию), `value`, `valueListAllowed` (разрешить список значений), `availableValues` (`[{ value, presentation }]`), `expression`, `use`.
+
+## Значения параметров в настройках (`dataParameters`)
+
+Предустановленные значения параметров на уровне настроек списка. Shorthand `"Имя = Значение"` или объект `{ parameter, value?, use?, viewMode? }`:
+
+```json
+"dataParameters": [ "Организация = _", "ВидЦен" ]
+```
+
+## Поля набора (`fields`)
+
+Обычно поля выводятся из источника сами — `fields` нужен **только чтобы переопределить** свойства отдельного поля:
+
+```json
+"fields": [
+  { "field": "Сумма", "title": "Сумма, руб", "appearance": { "Формат": "ЧДЦ=2" } },
+  { "field": "Остаток", "valueType": "number(15,2)" }
+]
+```
+
+Ключи поля: `field`, `dataPath`, `title`, `valueType`, `appearance` (как в условном оформлении), `presentationExpression`, `inputParameters` (связь по параметрам выбора), `typeLink` (`{ field, linkItem }` — связь по типу, напр. субконто).
+
+## Вычисляемые поля (`calculatedFields`)
+
+Поля, считаемые выражением. Shorthand `"Имя [Заголовок]: тип = Выражение"`:
+
+```json
+"calculatedFields": [
+  "Метка = Code + \" \" + Description",
+  "Маржа [Маржа, руб]: number(15,2) = Цена - Закупка"
+]
+```
+
+Объектная форма — для `presentationExpression` / `orderExpression`:
+
+```json
+{ "dataPath": "Сорт", "expression": "Code", "title": "Сорт",
+  "valueType": "string(10)", "presentationExpression": "Code" }
+```
+
+## Отбор (`filter`)
+
+Shorthand `"Поле оператор значение @флаги"` или объект:
+
+```json
+"filter": [
+  "Организация = _ @off @user",
+  "Сумма > 1000",
+  { "field": "Дата", "op": ">=", "value": "2024-01-01T00:00:00" },
+  { "group": "Or", "items": [ "Статус = 1", "Статус = 2" ] }
+]
+```
+
+- **Операторы:** `=` `<>` `>` `>=` `<` `<=`, `in` / `notIn`, `inHierarchy`, `contains` / `notContains`, `beginsWith` / `notBeginsWith`, `like` / `notLike` (`%`-шаблон), `filled` / `notFilled`.
+- **Флаги:** `@off` (отключён), `@user` (в пользовательских настройках), `@quickAccess`; `_` = пустое значение.
+- **Группа:** `{ group: "And"|"Or"|"Not", items: [...] }`.
+- **Дата-значение:** ISO-дата `"2024-01-01T00:00:00"` — фиксированная дата. Именованный относительный период — строкой с типом: `{ "value": "BeginningOfThisWeek", "valueType": "v8:StandardBeginningDate" }` (варианты `BeginningOfThisDay`/`BeginningOfThisWeek`/`BeginningOfThisMonth`/`BeginningOfThisYear`/…).
+
+## Сортировка (`order`)
+
+Строка `"Поле"` (по возр.) / `"Поле desc"`, либо объект `{ field, direction? }`. `"Auto"` — автосортировка:
+
+```json
+"order": [ "Дата desc", "Наименование", "Auto" ]
+```
+
+## Группировка строк (`grouping`)
+
+Линейная цепочка уровней (внешний → внутренний). Шорткат `>` или массив:
+
+```json
+"grouping": "Контрагент > Договор"
+"grouping": [ "Контрагент", { "field": "Дата", "groupType": "Hierarchy" } ]
+```
+
+Ключи уровня-объекта: `field`, `groupType` (`Items` / `Hierarchy`).
+
+## Условное оформление (`conditionalAppearance`)
+
+```json
+"conditionalAppearance": [
+  { "filter": [ "Просрочено = true" ], "appearance": { "ЦветТекста": "web:Red" } }
+]
+```
+
+`filter` — та же грамматика, что выше. `appearance` — словарь «параметр платформы: значение» (`ЦветТекста`, `ЦветФона`, `Шрифт`, `Текст`, `Формат`, …). Значение `Текст`/`Заголовок`/`Формат`: голая строка — нелокализованный литерал; `{ru,en}` — локализуемая строка; `{ field: "путь" }` — ссылка на поле. Подробнее об оформлении — `references/appearance.md`.

.claude/skills/form-compile/references/layout-advanced.md

@@ -0,0 +1,111 @@
+# Продвинутая раскладка
+
+Тонкая настройка размещения элемента внутри родителя сверх базовой геометрии (`width`/`height`/`horizontalStretch`/`verticalStretch`/`visible`/`enabled` и ориентации групп/страниц — они в основной инструкции). Все ключи ниже задаются прямо на элементе и **необязательны** — без них действует поведение платформы по умолчанию.
+
+## Выравнивание внутри родителя
+
+Различают **выравнивание самого элемента** в отведённой ему ячейке и **выравнивание содержимого** элемента.
+
+| Ключ | Значения | Что выравнивает |
+|------|----------|-----------------|
+| `groupHorizontalAlign` | `Left` / `Center` / `Right` | Положение **элемента** по горизонтали в родительской группе (когда элемент у́же доступного места) |
+| `groupVerticalAlign` | `Top` / `Center` / `Bottom` | Положение **элемента** по вертикали в родительской группе |
+| `horizontalAlign` | `Left` / `Center` / `Right` | Выравнивание **содержимого** (текста/значения) внутри самого элемента |
+| `verticalAlign` | `Top` / `Center` / `Bottom` | Выравнивание содержимого по вертикали внутри элемента |
+
+`group*Align` отвечает на вопрос «куда сдвинуть нерастянутый элемент в его ячейке», `horizontalAlign`/`verticalAlign` — «как разместить текст внутри элемента». Это разные оси настройки, их часто комбинируют.
+
+```json
+{ "button": "ОК", "groupHorizontalAlign": "Right" }
+{ "input": "Сумма", "path": "Объект.Сумма", "horizontalAlign": "Right" }
+{ "label": "Итого", "groupHorizontalAlign": "Center", "horizontalAlign": "Center" }
+```
+
+## Ограничение максимального размера
+
+По умолчанию растягивающийся элемент имеет авто-вычисляемый предел ширины/высоты. Чтобы задать жёсткий предел или вовсе снять авто-предел:
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `maxWidth` | число | Жёсткий максимум ширины элемента |
+| `maxHeight` | число | Жёсткий максимум высоты элемента |
+| `autoMaxWidth` | `false` | Отключить авто-предел ширины (элемент тянется без ограничения сверху) |
+| `autoMaxHeight` | `false` | Отключить авто-предел высоты |
+
+`autoMaxWidth: false` нужен, например, для широкого многострочного поля или растянутого по всей форме поля ввода, чтобы платформа не «прижимала» его к авто-пределу. Указывают именно отклонение от дефолта; обычное значение `true` писать не нужно.
+
+```json
+{ "input": "Комментарий", "path": "Объект.Комментарий", "multiLine": true,
+  "horizontalStretch": true, "autoMaxWidth": false }
+{ "input": "Поиск", "path": "СтрокаПоиска", "horizontalStretch": true, "maxWidth": 600 }
+```
+
+## Поведение при вводе и активации
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `skipOnInput` | `true` / `false` | Пропускать элемент при обходе по Enter/Tab (фокус через него не проходит). Указывают явно, в т.ч. `false` чтобы вернуть в обход поле, которое платформа пропустила бы |
+| `defaultItem` | `true` | Элемент получает фокус по умолчанию при открытии формы (поле/таблица для немедленного ввода) |
+
+```json
+{ "input": "Идентификатор", "path": "Объект.Идентификатор", "skipOnInput": true }
+{ "input": "Штрихкод", "path": "Штрихкод", "defaultItem": true }
+```
+
+`skipOnInput: true` — для служебных/расчётных полей, которые видны, но не редактируются вводом с клавиатуры в общем потоке. `defaultItem: true` ставят на одном элементе формы — точке, с которой пользователь начнёт работу.
+
+## Перетаскивание
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `enableStartDrag` | `true` | Разрешить начинать перетаскивание из элемента (источник drag-n-drop) |
+
+Для таблиц приём/перемещение строк управляется ключами таблицы (`enableDrag`, `changeRowOrder`) — см. основную инструкцию; `enableStartDrag` — общий низкоуровневый флаг «этот элемент может быть источником перетаскивания».
+
+## Закрепление колонки в таблице (`fixingInTable`)
+
+Свойство поля-колонки внутри таблицы: закрепить колонку у края, чтобы она не уходила при горизонтальной прокрутке.
+
+| Значения |
+|----------|
+| `None` (по умолчанию — не закреплена) / `Left` / `Right` |
+
+```json
+{ "table": "Товары", "path": "Объект.Товары", "columns": [
+    { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура", "fixingInTable": "Left" },
+    { "input": "Количество", "path": "Объект.Товары.Количество" },
+    { "input": "Сумма", "path": "Объект.Товары.Сумма", "fixingInTable": "Right" } ] }
+```
+
+Закрепляют ключевые колонки (идентифицирующую слева, итоговую справа), чтобы они оставались видны при прокрутке широкой таблицы.
+
+## Ячейки колонок: шапка и подвал
+
+Для поля-колонки внутри таблицы (и `columnGroup`) — размещение в шапке/подвале и выравнивание текста ячеек. Применять только к элементам внутри `columns` таблицы.
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `showInHeader` | `true` / `false` | Показывать колонку в шапке таблицы |
+| `showInFooter` | `true` / `false` | Показывать колонку в подвале (нужно для итогов; подвал самой таблицы включается `footer: true`) |
+| `headerHorizontalAlign` | `Left` / `Right` / `Center` / `Auto` | Выравнивание текста в шапке колонки |
+| `footerHorizontalAlign` | `Left` / `Right` / `Center` | Выравнивание текста в подвале колонки |
+| `autoCellHeight` | `true` / `false` | Авто-высота ячейки (перенос содержимого на несколько строк) |
+
+```json
+{ "table": "Товары", "path": "Объект.Товары", "footer": true, "columns": [
+    { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура", "autoCellHeight": true },
+    { "input": "Сумма", "path": "Объект.Товары.Сумма",
+      "headerHorizontalAlign": "Right", "showInFooter": true, "footerHorizontalAlign": "Right" } ] }
+```
+
+## Адаптивная важность (`displayImportance`)
+
+| Значения |
+|----------|
+| `VeryHigh` / `High` / `Usual` / `VeryLow` / `Low` |
+
+Приоритет элемента при адаптивной перекомпоновке формы на узких/мобильных экранах: элементы с меньшей важностью сворачиваются/прячутся первыми. Применимо к любому элементу.
+
+```json
+{ "input": "Комментарий", "path": "Объект.Комментарий", "displayImportance": "Low" }
+```

.claude/skills/form-compile/references/report-form.md

@@ -0,0 +1,79 @@
+# Форма отчёта
+
+Форма, подключённая к объекту-отчёту (`Report`). Кроме обычных свойств формы у неё есть несколько свойств в `properties`, связывающих форму с механизмом компоновки (СКД): куда выводится результат, где данные расшифровки, какого она типа. Все они задаются в блоке `properties` верхнего уровня.
+
+```json
+"properties": {
+  "reportFormType": "Main",
+  "reportResult": "РезультатОтчета",
+  "detailsData": "ДанныеРасшифровки"
+}
+```
+
+Ни одно из этих свойств не обязательно — указывайте только те, что нужны конкретной форме.
+
+## Тип формы отчёта (`reportFormType`)
+
+Роль формы в составе отчёта:
+
+| Значение | Назначение |
+|----------|-----------|
+| `Main` | Основная форма отчёта (результат + настройки) |
+| `Settings` | Форма настроек |
+| `Variant` | Форма варианта |
+
+```json
+"reportFormType": "Main"
+```
+
+## Привязка к компоновке
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `reportResult` | string | Имя реквизита-результата формы (табличный документ, куда выводится отчёт) |
+| `detailsData` | string | Имя реквизита данных расшифровки |
+| `variantAppearance` | string | Имя реквизита оформления варианта |
+
+Значение каждого ключа — имя реквизита формы (а не путь к данным). Реквизит с таким именем должен присутствовать в `attributes` формы.
+
+## Группа пользовательских настроек (`customSettingsFolder`)
+
+Группа-элемент формы, в которую генерируются пользовательские настройки компоновщика. Задаётся **по имени** элемента-группы:
+
+```json
+"customSettingsFolder": "ГруппаПользовательскихНастроек"
+```
+
+## Прочие свойства компоновки
+
+Редкие, задавайте только при явной необходимости:
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `autoShowState` | `Auto`, `DontShow`, `ShowOnComposition` | Автопоказ состояния формирования |
+| `reportResultViewMode` | `Auto` | Режим просмотра результата |
+| `viewModeApplicationOnSetReportResult` | `Auto` | Применение режима просмотра при установке результата |
+
+## Реалистичный пример
+
+Основная форма отчёта со СКД: реквизит-результат, данные расшифровки и группа пользовательских настроек.
+
+```json
+{
+  "properties": {
+    "reportFormType": "Main",
+    "reportResult": "РезультатОтчета",
+    "detailsData": "ДанныеРасшифровки",
+    "customSettingsFolder": "ГруппаПользовательскихНастроек"
+  },
+  "attributes": [
+    { "name": "РезультатОтчета", "type": "SpreadsheetDocument" },
+    { "name": "ДанныеРасшифровки", "type": "DataCompositionDetailsData" }
+  ],
+  "elements": [
+    { "group": "vertical", "name": "ГруппаПользовательскихНастроек" },
+    { "spreadsheet": "РезультатОтчета", "path": "РезультатОтчета",
+      "titleLocation": "none" }
+  ]
+}
+```

.claude/skills/form-compile/references/roles-access.md

@@ -0,0 +1,73 @@
+# Доступ по ролям
+
+Единый механизм платформы для разграничения по ролям: задаётся общее значение для всех ролей плюс исключения для конкретных ролей. Один и тот же формат значения у четырёх ключей — каждый на своём владельце:
+
+| Ключ | Владелец | Смысл |
+|------|----------|-------|
+| `userVisible` | элемент формы | пользовательская видимость элемента |
+| `view` | реквизит формы | право просмотра |
+| `edit` | реквизит формы | право редактирования |
+| `use` | команда формы | доступность команды |
+
+Ключ необязателен: его отсутствие = полный доступ для всех ролей.
+
+## Значение
+
+Две формы (одинаковы для всех четырёх ключей):
+
+**Скаляр** `true` / `false` — общее значение для всех ролей, без исключений:
+
+```json
+{ "input": "Поле", "userVisible": false }
+```
+
+**Объект** `{ "common": <bool>, "roles": { "ИмяРоли": <bool>, … } }` — общее значение `common` плюс явные исключения по ролям:
+
+```json
+{ "name": "Реквизит",
+  "edit": { "common": false, "roles": { "ПолныеПрава": true } } }
+```
+
+Роль, **не указанная** в `roles`, наследует `common`. Указанная — задаёт явный `true`/`false` (может и совпадать с `common`).
+
+## Имя роли
+
+Ключи в `roles` — имена ролей конфигурации (`ПолныеПрава`, `Бухгалтер`, …).
+
+## Примеры
+
+Элемент скрыт у всех пользователей:
+
+```json
+{ "input": "Комментарий", "userVisible": false }
+```
+
+Реквизит не виден никому и редактируется только одной ролью:
+
+```json
+{ "name": "СуммаБонуса",
+  "view": false,
+  "edit": { "common": false, "roles": { "ПолныеПрава": true } } }
+```
+
+Поле доступно для просмотра всем, но редактируемо только администратору:
+
+```json
+{ "name": "Статус",
+  "view": true,
+  "edit": { "common": false, "roles": { "Администратор": true } } }
+```
+
+Команда недоступна по умолчанию, разрешена только бухгалтеру:
+
+```json
+{ "name": "ПровестиЗакрытие",
+  "use": { "common": false, "roles": { "Бухгалтер": true } } }
+```
+
+Обратный случай — доступно всем, кроме одной роли:
+
+```json
+{ "name": "РедактироватьЦену",
+  "edit": { "common": true, "roles": { "Кладовщик": false } } }
+```

.claude/skills/form-compile/references/special-fields.md

@@ -0,0 +1,109 @@
+# Спец-поля «документ/датчик»
+
+Поля для отображения специальных данных: табличный документ, HTML, текст, форматированный документ, индикатор, ползунок. Каждое привязывается к реквизиту своего платформенного типа.
+
+Структурно это обычные поля — поддерживают общий скелет поля (`path`, `title`, `titleLocation`, флаги `readOnly`/`enabled`/`visible`, `layout`, оформление, события). Ниже — только ключ `type` (имя элемента задаётся значением ключа) и собственные скаляры каждого семейства. Все скаляры необязательны.
+
+| Ключ типа | Тип реквизита |
+|-----------|---------------|
+| `spreadsheet` | `mxl:SpreadsheetDocument` (ТабличныйДокумент) |
+| `html` | `string` |
+| `textDoc` | `d5p1:TextDocument` (ТекстовыйДокумент) |
+| `formattedDoc` | `fd:FormattedDocument` (ФорматированныйДокумент) |
+| `progressBar` | число |
+| `trackBar` | число |
+
+## spreadsheet — поле табличного документа
+
+Просмотр/редактирование табличного документа (отчёт, печатная форма).
+
+```json
+{ "spreadsheet": "ТаблицаОтчета", "path": "ТаблицаОтчета",
+  "titleLocation": "none", "readOnly": true,
+  "output": "Disable", "protection": true }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `output` | string | Использование вывода: `Enable` / `Disable` |
+| `protection` | bool | Защита от изменений |
+| `edit` | bool | Разрешить редактирование |
+| `showGrid` | bool | Показывать сетку |
+| `showHeaders` | bool | Показывать заголовки строк/колонок |
+| `showGroups` | bool | Показывать группировки |
+| `showRowAndColumnNames` | bool | Показывать имена строк и колонок |
+| `showCellNames` | bool | Показывать имена ячеек |
+| `verticalScrollBar` / `horizontalScrollBar` | string | Режим полос прокрутки |
+| `viewScalingMode` | string | Режим масштабирования просмотра |
+| `selectionShowMode` | string | Режим отображения выделения |
+| `pointerType` | string | Тип указателя |
+| `enableDrag` / `enableStartDrag` | bool | Разрешить перетаскивание / начало перетаскивания |
+
+## html — поле HTML-документа
+
+Просмотр HTML. Реквизит — строка (содержит HTML-текст или адрес).
+
+```json
+{ "html": "Просмотр", "path": "СодержимоеHTML", "titleLocation": "none",
+  "output": "Enable", "warningOnEditRepresentation": false }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `output` | string | Использование вывода: `Enable` / `Disable` |
+| `warningOnEditRepresentation` | bool | Предупреждать при изменении представления |
+
+## textDoc — поле текстового документа
+
+Просмотр/редактирование текстового документа.
+
+```json
+{ "textDoc": "Текст", "path": "ТекстДокумента", "editMode": "Edit" }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `editMode` | string | Режим редактирования (напр. `Edit` / `View`) |
+
+## formattedDoc — поле форматированного документа
+
+Просмотр/редактирование форматированного документа.
+
+```json
+{ "formattedDoc": "Описание", "path": "ФорматированноеОписание", "editMode": "Edit" }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `editMode` | string | Режим редактирования (напр. `Edit` / `View`) |
+
+## progressBar — поле индикатора
+
+Индикатор прогресса. Реквизит — числовой.
+
+```json
+{ "progressBar": "Прогресс", "path": "Прогресс",
+  "minValue": 0, "maxValue": 100, "showPercent": true }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `minValue` / `maxValue` | число | Минимальное / максимальное значение |
+| `showPercent` | bool | Показывать проценты |
+
+## trackBar — поле ползунка
+
+Регулятор-ползунок. Реквизит — числовой.
+
+```json
+{ "trackBar": "Масштаб", "path": "Масштаб",
+  "minValue": 20, "maxValue": 400, "markingStep": 20 }
+```
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `minValue` / `maxValue` | число | Минимальное / максимальное значение |
+| `step` | число | Шаг изменения |
+| `largeStep` | число | Крупный шаг |
+| `markingStep` | число | Шаг разметки |
+| `markingAppearance` | string | Оформление разметки |

.claude/skills/form-compile/references/table-advanced.md

@@ -0,0 +1,132 @@
+# Таблица — продвинутые возможности
+
+Базовый элемент таблицы (`type: "table"`, колонки, основные свойства) описан в основной инструкции, раздел «Таблица (table)». Здесь — продвинутые возможности: дополнения командной панели, специфика таблицы динамического списка и неочевидные свойства/режимы.
+
+## Представление (`representation`)
+
+Как таблица рисует строки:
+
+```json
+{ "table": "Список", "path": "Список", "representation": "Tree" }
+```
+
+`List` — плоский список (по умолчанию), `Tree` — дерево, `HierarchicalList` — иерархический список (группы + элементы на одном уровне).
+
+Для дерева/иерархии управляйте раскрытием уровней через `initialTreeView` (`ExpandTopLevel` / `ExpandAllLevels` / `NoExpand`).
+
+## Выделение и текущая строка
+
+| Ключ | Значения | Назначение |
+|------|----------|-----------|
+| `selectionMode` | `SingleRow` / `MultiRow` | Режим выделения строк |
+| `multipleChoice` | bool | Разрешить множественный выбор (для форм выбора) |
+| `currentRowUse` | `DontUse` / `Use` / `SelectionPresentation` / `SelectionPresentationAndChoice` / `Choice` | Использование текущей строки таблицы |
+
+```json
+{ "table": "Список", "path": "Список", "selectionMode": "MultiRow", "multipleChoice": true }
+```
+
+## Поиск при вводе (`searchOnInput`)
+
+Поведение встроенного поиска при наборе текста в таблице:
+
+```json
+{ "table": "Список", "path": "Список", "searchOnInput": "Use" }
+```
+
+`Auto` (по умолчанию) / `Use` (искать) / `DontUse` (не искать).
+
+Где располагать сами элементы поиска — управляется `searchStringLocation` / `viewStatusLocation` / `searchControlLocation` (`None` / `Top` / `Bottom` / `CommandBar` / `Auto`).
+
+## Прочие свойства таблицы
+
+| Ключ | Тип | Назначение |
+|------|-----|-----------|
+| `useAlternationRowColor` | bool | Чередование цвета строк |
+| `verticalLines` / `horizontalLines` | bool | Линии сетки (укажите `false`, чтобы скрыть) |
+| `markIncomplete` | bool | Автоотметка незаполненных ячеек |
+| `heightInTableRows` | int | Высота элемента в строках (отдельно от `height`) |
+| `autoInsertNewRow` | bool | Автодобавление новой строки при вводе в последнюю |
+| `rowsPicture` | string \| object | Картинка строк. Ссылка (`"CommonPicture.X"`, `"abs:..."`) либо объект `{ src, loadTransparent?, transparentPixel? }` |
+| `tooltipRepresentation` | string | Режим показа подсказки таблицы: `None`, `Button`, `ShowBottom`, `ShowTop`, `ShowLeft`, `ShowRight`, `ShowAuto`, `Balloon` |
+
+## Фиксация колонки (`fixingInTable`)
+
+Свойство **колонки** (на `input` / `labelField` / `check` / `picField` внутри `columns`), а не самой таблицы. Закрепляет колонку у края при горизонтальной прокрутке:
+
+```json
+{ "table": "Товары", "path": "Объект.Товары", "columns": [
+  { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура", "fixingInTable": "Left" },
+  { "input": "Количество", "path": "Объект.Товары.Количество" }
+]}
+```
+
+`Left` / `Right` / `None`.
+
+## Исключённые команды (`excludedCommands`)
+
+Убрать стандартные команды редактора таблицы (кнопки добавления/перемещения/сортировки):
+
+```json
+{ "table": "Товары", "path": "Объект.Товары",
+  "excludedCommands": [ "Add", "Delete", "MoveUp", "SortListAsc" ] }
+```
+
+Свойство работает на любом поле и на уровне формы; для таблицы значимы команды вида `Add` / `Delete` / `MoveUp` / `MoveDown` / `SortListAsc` / `SortListDesc`.
+
+## Дополнения командной панели (`additions`)
+
+Дополнения — это «представления» встроенного поиска таблицы:
+
+- `searchString` — отображение строки поиска,
+- `viewStatus` — состояние просмотра,
+- `searchControl` — управление поиском.
+
+Каждое дополнение — полноценный элемент (полный набор свойств поля). Размещать их можно двумя способами.
+
+**(1) Стандартные дополнения** генерирует платформа на уровне таблицы. В DSL указывайте **только отклонения** от стандартного вида — через карту `additions` (ключ = тип дополнения):
+
+```json
+{ "table": "Список", "path": "Список",
+  "additions": { "viewStatus": { "horizontalLocation": "left" } } }
+```
+
+**(2) Кастомное дополнение**, размещённое прямо в командной панели — обычный элемент в `commandBar` с ключом-типом:
+
+```json
+{ "table": "Список", "path": "Список", "commandBar": [
+  { "searchString": "ПоискСписка", "source": "Список", "width": 15, "horizontalStretch": true }
+]}
+```
+
+- Тип-ключ: `searchString` / `viewStatus` / `searchControl`.
+- `source` — имя таблицы-источника; необязательно, по умолчанию = имя родительской таблицы.
+- `horizontalLocation`: `auto` (по умолчанию) / `left` / `right`. Применимо и к обычным элементам командных панелей.
+- Прочие свойства как у поля: `title`, `visible`, `userVisible`, `enabled`, `tooltip`, оформление, `width` / `maxWidth` / `autoMaxWidth` / `horizontalStretch` / `groupHorizontalAlign` и др.
+
+## Таблица динамического списка
+
+Когда `path` таблицы указывает на реквизит `type: "DynamicList"` (см. `references/dynamic-list.md`), доступен блок специфичных свойств. Указывайте **только отличия** от умолчания.
+
+| Ключ | Тип | Умолчание | Назначение |
+|------|-----|-----------|-----------|
+| `rowPictureDataPath` | string | картинка осн. таблицы | Путь к картинке строки. `""` — подавить картинку |
+| `rowsPicture` | string | — | Картинка строк (`"CommonPicture.X"`) |
+| `autoRefresh` | bool | `false` | Автообновление списка |
+| `autoRefreshPeriod` | int | `60` | Период автообновления, сек |
+| `updateOnDataChange` | string | `Auto` | Обновлять при изменении данных: `Auto` / `DontUpdate` |
+| `choiceFoldersAndItems` | string | `Items` | Что выбирать: `Items` / `Folders` / `FoldersAndItems` |
+| `restoreCurrentRow` | bool | `false` | Восстанавливать текущую строку при обновлении |
+| `showRoot` | bool | `true` | Показывать корень |
+| `allowRootChoice` | bool | `false` | Разрешить выбор корня |
+| `allowGettingCurrentRowURL` | bool | `true` | Разрешить получение URL текущей строки |
+| `userSettingsGroup` | string | — | Группа пользовательских настроек (привязка к одноимённой группе настроек) |
+
+```json
+{ "table": "Список", "path": "Список",
+  "representation": "Tree",
+  "rowPictureDataPath": "Список.DefaultPicture",
+  "choiceFoldersAndItems": "FoldersAndItems",
+  "allowRootChoice": true,
+  "updateOnDataChange": "DontUpdate" }
+```

.claude/skills/form-compile/references/type-system-advanced.md

@@ -0,0 +1,77 @@
+# Продвинутые конструкции типов
+
+Примитивы (`string(n)`, `number(p,s)`, `boolean`, `date`/`dateTime`, …) и одиночные ссылки (`CatalogRef.Контрагенты`, `DocumentRef.Заказ`, `EnumRef.X`, …) описаны в основной инструкции. Здесь — типы, которые нельзя выразить одним именем: составные типы, наборы типов и платформенные наборы ссылок.
+
+Любая из этих конструкций пишется в поле `type` реквизита, реквизита-параметра или поля.
+
+## Составные типы
+
+Несколько типов на одном реквизите — части перечисляются через разделитель `" | "` (можно `+`). Реквизит сможет принимать значение любого из перечисленных типов:
+
+```json
+{ "name": "Плательщик",
+  "type": "CatalogRef.Организации | CatalogRef.ИндивидуальныеПредприниматели" }
+```
+
+Смешивать можно типы из разных категорий — ссылки, примитивы, наборы типов:
+
+```json
+{ "name": "Источник",
+  "type": "CatalogRef.Контрагенты | DocumentRef.Заказ | string(150)" }
+```
+
+Каждая часть — самостоятельный токен из этого файла или из основной инструкции. Порядок частей произвольный.
+
+## Наборы типов (TypeSet)
+
+«Набор типов» подставляется вместо конкретного типа — это один токен, а не перечисление. Применимо и в составном типе как одна из частей.
+
+| Токен `type` | Смысл |
+|------|-------|
+| `"DefinedType.ИмяТипа"` | определяемый тип конфигурации |
+| `"Characteristic.ИмяПлана"` | тип значения характеристики (по плану видов характеристик) |
+| `"AnyRef"` | любая ссылка |
+| `"AnyIBRef"` | любая ссылка информационной базы |
+
+Определяемый тип — реквизит принимает то, что задано в определяемом типе конфигурации (например `DefinedType.ДенежнаяСумма`):
+
+```json
+{ "name": "Сумма", "type": "DefinedType.ДенежнаяСумма" }
+```
+
+Характеристика — тип значения берётся из плана видов характеристик:
+
+```json
+{ "name": "Значение", "type": "Characteristic.ДополнительныеРеквизиты" }
+```
+
+## Платформенные наборы ссылок
+
+«Голый» ссылочный токен **без `.Имя`** означает «любая ссылка этой категории объектов»:
+
+| Токен `type` | Смысл |
+|------|-------|
+| `"CatalogRef"` | любая ссылка справочника |
+| `"DocumentRef"` | любая ссылка документа |
+| `"EnumRef"` | любая ссылка перечисления |
+| `"ExchangePlanRef"` | любая ссылка плана обмена |
+| `"TaskRef"` | любая ссылка задачи |
+| `"BusinessProcessRef"` | любая ссылка бизнес-процесса |
+| `"ChartOfCharacteristicTypesRef"` | любая ссылка плана видов характеристик |
+| `"ChartOfAccountsRef"` | любая ссылка плана счетов |
+| `"ChartOfCalculationTypesRef"` | любая ссылка плана видов расчёта |
+
+Различие с одиночной ссылкой — только в наличии `.Имя`:
+
+- `"CatalogRef.Валюты"` — конкретный справочник «Валюты»;
+- `"CatalogRef"` — любой справочник.
+
+```json
+{ "name": "ЛюбойСправочник", "type": "CatalogRef" }
+```
+
+Эти наборы тоже комбинируются в составном типе:
+
+```json
+{ "name": "Объект", "type": "CatalogRef | DocumentRef" }
+```

.claude/skills/form-decompile/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: form-decompile
+description: Декомпиляция управляемой формы 1С (Form.xml) в JSON-черновик в формате form-compile. Используй для scaffold новой формы по образцу или структурного рефакторинга. Не для точечных правок
+argument-hint: <FormPath> [-OutputPath <out.json>]
+disable-model-invocation: true
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /form-decompile — JSON-черновик из Form.xml управляемой формы
+
+Читает Form.xml и эмитит компактный JSON в формате `form-compile`. **Результат — черновик**, а не обратимое представление: см. раздел «Что получаешь».
+
+## Когда использовать
+
+- **Scaffold новой формы по образцу** — взять существующую форму, получить JSON, поправить и скомпилировать в новую.
+- **Структурный рефакторинг** — перебрать дерево элементов, реквизиты, команды.
+
+## Когда **не** использовать
+
+- **Точечные правки готовой формы** (добавить элемент, реквизит, команду) → `/form-edit`. Цикл «декомпиляция → правка JSON → компиляция» переписывает форму целиком, может терять непокрытые конструкции и даёт большой diff. `/form-edit` правит адресно.
+
+## Параметры
+
+| Параметр | Описание |
+|----------|----------|
+| `FormPath` | Путь к Form.xml (обязательный) |
+| `OutputPath` | Путь к выходному JSON. Если не задан — JSON в stdout |
+
+```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-decompile.ps1" -FormPath "<Form.xml>" -OutputPath "<out.json>"
+```
+
+## Что получаешь
+
+JSON-черновик в формате `/form-compile` — **не полное обратимое представление**: раундтрип `xml → json → xml` не гарантируется, часть конструкций DSL не покрывает и **теряет молча**.
+
+Критичные конструкции (`ConditionalAppearance` со scope, design-time диаграммы/планировщики на реквизите, неизвестный тип элемента, не-Form root) → скрипт падает с ненулевым кодом и сообщением в stderr; для правок такой формы — `/form-edit`.
+
+## Workflow
+
+1. `/form-decompile <Form.xml> -OutputPath draft.json` — получить черновик.
+2. Поправить JSON под задачу.
+3. `/form-compile -JsonPath draft.json -OutputPath new/Form.xml` — собрать обратно.
+4. `/form-validate` + `/form-info` — проверить результат.