Auto-build: claude-code (python) from 6d119eb

.agents/plugins/marketplace.json

@@ -1,32 +0,0 @@
-{
-  "name": "cc-1c-skills",
-  "interface": {
-    "displayName": "1C Skills"
-  },
-  "plugins": [
-    {
-      "name": "1c-skills",
-      "source": {
-        "source": "url",
-        "url": "https://github.com/Nikolay-Shirokov/cc-1c-skills.git",
-        "ref": "port-codex"
-      },
-      "policy": {
-        "installation": "AVAILABLE"
-      },
-      "category": "Development"
-    },
-    {
-      "name": "1c-skills-py",
-      "source": {
-        "source": "url",
-        "url": "https://github.com/Nikolay-Shirokov/cc-1c-skills.git",
-        "ref": "port-codex-py"
-      },
-      "policy": {
-        "installation": "AVAILABLE"
-      },
-      "category": "Development"
-    }
-  ]
-}

.claude-plugin/marketplace.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-marketplace-manifest.json",
-  "name": "cc-1c-skills",
-  "description": "Маркетплейс навыков для разработки на платформе 1С:Предприятие",
-  "owner": {
-    "name": "Nikolay Shirokov"
-  },
-  "plugins": [
-    {
-      "name": "1c-skills",
-      "source": "./",
-      "description": "[PowerShell] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент."
-    },
-    {
-      "name": "1c-skills-py",
-      "source": {
-        "source": "github",
-        "repo": "Nikolay-Shirokov/cc-1c-skills",
-        "ref": "port-claude-code-py"
-      },
-      "description": "[Python] То же — для Linux/Mac или когда PowerShell недоступен."
-    }
-  ]
-}

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
-  "name": "1c-skills",
+  "name": "1c-skills-py",
-  "description": "[PowerShell] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент.",
+  "description": "[Python] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент. Linux/Mac или когда PowerShell недоступен.",
   "author": {
     "name": "Nikolay Shirokov"
   },

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

@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-edit.ps1" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
+python "${CLAUDE_SKILL_DIR}/scripts/cf-edit.py" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
 ```
 
 ## Операции

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

@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-info.ps1" -ConfigPath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/cf-info.py" -ConfigPath "<путь>"
 ```
 
 ## Три режима

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

@@ -24,7 +24,7 @@ allowed-tools:
 | `CompatibilityMode` | Режим совместимости (default: `Version8_3_24`) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-init.ps1" -Name "МояКонфигурация"
+python "${CLAUDE_SKILL_DIR}/scripts/cf-init.py" -Name "МояКонфигурация"
 ```
 
 ## Примеры

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty"
+python "${CLAUDE_SKILL_DIR}/scripts/cf-validate.py" -ConfigPath "upload/cfempty"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty/Configuration.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/cf-validate.py" -ConfigPath "upload/cfempty/Configuration.xml"
 ```

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

@@ -71,7 +71,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.py" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
 ```
 
 ## Примеры

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

@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-diff.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-diff.py" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
 ```
 
 ## Mode A — обзор расширения

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

@@ -44,7 +44,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-init.ps1" -Name "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-init.py" -Name "МоёРасширение"
 ```
 
 ## Примеры

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

@@ -51,7 +51,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.ps1" -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.py" -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
 ```
 
 ## Примеры

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src"
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.py" -ExtensionPath "src"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src/Configuration.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.py" -ExtensionPath "src/Configuration.xml"
 ```

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

@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-create.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -65,14 +65,14 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <п
 
 ```powershell
 # Создать файловую базу
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB"
+python "${CLAUDE_SKILL_DIR}/scripts/db-create.py" -InfoBasePath "C:\Bases\NewDB"
 
 # Создать серверную базу
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
+python "${CLAUDE_SKILL_DIR}/scripts/db-create.py" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
 
 # Создать из шаблона CF
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf"
+python "${CLAUDE_SKILL_DIR}/scripts/db-create.py" -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 "Новая база"
+python "${CLAUDE_SKILL_DIR}/scripts/db-create.py" -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
 ```

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

@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -69,11 +69,11 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" <п
 
 ```powershell
 # Выгрузка конфигурации (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.py" -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 "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
 ```

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

@@ -37,7 +37,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -81,17 +81,17 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <
 
 ```powershell
 # Полная выгрузка (файловая база)
-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
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" -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 Changes
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
 
 # Частичная выгрузка
-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 "Справочник.Номенклатура,Документ.Заказ"
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" -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" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" -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 "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
 ```

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

@@ -36,7 +36,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -71,11 +71,11 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <п
 
 ```powershell
 # Файловая база
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.py" -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 "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
 ```

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

@@ -38,7 +38,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-git.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -71,8 +71,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-git.ps1" <
 
 ```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
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-git.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-git.py" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"
 ```

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

@@ -38,7 +38,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -96,14 +96,14 @@ Documents/Заказ/Forms/ФормаДокумента.xml
 
 ```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
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.py" -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\ext_src" -Mode Full -Extension "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.py" -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
+python "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
 ```

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

@@ -36,7 +36,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-run.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -63,14 +63,14 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" <пар
 
 ```powershell
 # Простой запуск
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+python "${CLAUDE_SKILL_DIR}/scripts/db-run.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/db-run.py" -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/Справочник.Номенклатура"
+python "${CLAUDE_SKILL_DIR}/scripts/db-run.py" -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 "ЗапуститьОбновление"
+python "${CLAUDE_SKILL_DIR}/scripts/db-run.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
 ```

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

@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/db-update.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -83,11 +83,11 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <п
 
 ```powershell
 # Обычное обновление (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+python "${CLAUDE_SKILL_DIR}/scripts/db-update.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
 
 # Динамическое обновление (серверная база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"
+python "${CLAUDE_SKILL_DIR}/scripts/db-update.py" -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 "МоёРасширение"
+python "${CLAUDE_SKILL_DIR}/scripts/db-update.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
 ```

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

@@ -40,7 +40,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/epf-build.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -62,8 +62,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <п
 
 ```powershell
 # Сборка обработки (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-build.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-build.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
 ```

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

@@ -39,7 +39,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/epf-dump.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -62,8 +62,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <па
 
 ```powershell
 # Разборка обработки (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-dump.py" -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"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-dump.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
 ```

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

@@ -30,7 +30,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
+python "${CLAUDE_SKILL_DIR}/scripts/init.py" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
 ```
 
 ## Дальнейшие шаги

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

@@ -24,7 +24,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-validate.py" -ObjectPath "src/МояОбработка"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка/МояОбработка.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/epf-validate.py" -ObjectPath "src/МояОбработка/МояОбработка.xml"
 ```
 

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

@@ -42,7 +42,7 @@ allowed-tools:
 Используй общий скрипт из epf-build:
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -64,8 +64,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-bu
 
 ```powershell
 # Сборка отчёта (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+python "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.py" -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"
+python "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
 ```

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

@@ -41,7 +41,7 @@ allowed-tools:
 Используй общий скрипт из epf-dump:
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -64,8 +64,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dum
 
 ```powershell
 # Разборка отчёта (файловая база)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+python "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.py" -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"
+python "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
 ```

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

@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
+python "${CLAUDE_SKILL_DIR}/scripts/init.py" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
 ```
 
 ## Дальнейшие шаги

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

@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт"
+python "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.py" -ObjectPath "src/МойОтчёт"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
+python "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.py" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
 ```
 

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

@@ -32,7 +32,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
+python "${CLAUDE_SKILL_DIR}/scripts/form-add.py" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
 ```
 
 ## Purpose — назначение формы

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

@@ -29,10 +29,10 @@ allowed-tools:
 
 ```powershell
 # Режим JSON DSL
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -JsonPath "<json>" -OutputPath "<Form.xml>"
+python "${CLAUDE_SKILL_DIR}/scripts/form-compile.py" -JsonPath "<json>" -OutputPath "<Form.xml>"
 
 # Режим from-object (объект и purpose выводятся из OutputPath; Document и Catalog)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"
+python "${CLAUDE_SKILL_DIR}/scripts/form-compile.py" -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"
 ```
 
 ## JSON DSL — справка

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

@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-edit.ps1" -FormPath "<путь>" -JsonPath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/form-edit.py" -FormPath "<путь>" -JsonPath "<путь>"
 ```
 
 ## JSON формат

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

@@ -15,7 +15,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-info.ps1" -FormPath "<путь к Form.xml>"
+python "${CLAUDE_SKILL_DIR}/scripts/form-info.py" -FormPath "<путь к Form.xml>"
 ```
 
 ## Параметры

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

@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/remove-form.ps1" -ObjectName "<ObjectName>" -FormName "<FormName>" [-SrcDir "<SrcDir>"]
+python "${CLAUDE_SKILL_DIR}/scripts/remove-form.py" -ObjectName "<ObjectName>" -FormName "<FormName>" [-SrcDir "<SrcDir>"]
 ```
 
 ## Что удаляется

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

@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-validate.ps1" -FormPath "Catalogs/Номенклатура/Forms/ФормаЭлемента"
+python "${CLAUDE_SKILL_DIR}/scripts/form-validate.py" -FormPath "Catalogs/Номенклатура/Forms/ФормаЭлемента"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-validate.ps1" -FormPath "src/МояОбработка/Forms/Форма/Ext/Form.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/form-validate.py" -FormPath "src/МояОбработка/Forms/Форма/Ext/Form.xml"
 ```
 

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

@@ -30,7 +30,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-help.ps1" -ObjectName "<ObjectName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
+python "${CLAUDE_SKILL_DIR}/scripts/add-help.py" -ObjectName "<ObjectName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
 ```
 
 ## Что делает скрипт

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

@@ -29,13 +29,13 @@ allowed-tools:
 ### Inline mode
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-edit.ps1" -CIPath '<path>' -Operation hide -Value '<cmd>'
+python "${CLAUDE_SKILL_DIR}/scripts/interface-edit.py" -CIPath '<path>' -Operation hide -Value '<cmd>'
 ```
 
 ### JSON mode
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-edit.ps1" -CIPath '<path>' -DefinitionFile '<json>'
+python "${CLAUDE_SKILL_DIR}/scripts/interface-edit.py" -CIPath '<path>' -DefinitionFile '<json>'
 ```
 
 ## Операции

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи"
+python "${CLAUDE_SKILL_DIR}/scripts/interface-validate.py" -CIPath "Subsystems/Продажи"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи/Ext/CommandInterface.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/interface-validate.py" -CIPath "Subsystems/Продажи/Ext/CommandInterface.xml"
 ```

.claude/skills/meta-compile/SKILL.md

@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-compile.ps1" -JsonPath "<json>" -OutputDir "<ConfigDir>"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-compile.py" -JsonPath "<json>" -OutputDir "<ConfigDir>"
 ```
 
 | Параметр | Описание |

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

@@ -18,13 +18,13 @@ allowed-tools:
 ### Inline mode (простые операции)
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-edit.ps1" -ObjectPath "<path>" -Operation <op> -Value "<val>"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-edit.py" -ObjectPath "<path>" -Operation <op> -Value "<val>"
 ```
 
 ### JSON mode (сложные/комбинированные)
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-edit.ps1" -DefinitionFile "<json>" -ObjectPath "<path>"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-edit.py" -DefinitionFile "<json>" -ObjectPath "<path>"
 ```
 
 | Параметр | Описание |

.claude/skills/meta-edit/json-dsl.md

@@ -3,7 +3,7 @@
 Для сложных и комбинированных операций используйте JSON-файл вместо inline-режима.
 
 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-edit/scripts/meta-edit.ps1 -DefinitionFile "<json>" -ObjectPath "<path>"
+python .claude/skills/meta-edit/scripts/meta-edit.py -DefinitionFile "<json>" -ObjectPath "<path>"
 ```
 
 ## add — добавить элементы

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

@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-info.ps1" -ObjectPath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-info.py" -ObjectPath "<путь>"
 ```
 
 ## Три режима

.claude/skills/meta-remove/SKILL.md

@@ -32,7 +32,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-remove.ps1" -ConfigDir "<путь>" -Object "Catalog.Товары"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-remove.py" -ConfigDir "<путь>" -Object "Catalog.Товары"
 ```
 
 ## Поддерживаемые типы

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-validate.ps1" -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-validate.py" -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-validate.ps1" -ObjectPath "Catalogs/Банки|Documents/Заказ"
+python "${CLAUDE_SKILL_DIR}/scripts/meta-validate.py" -ObjectPath "Catalogs/Банки|Documents/Заказ"
 ```

.claude/skills/mxl-compile/SKILL.md

@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-compile.ps1" -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-compile.py" -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"
 ```
 
 ## Рабочий процесс

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

@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.ps1" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.py" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
 ```
 
 ## Рабочий процесс

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

@@ -38,12 +38,12 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-info.py" -TemplatePath "<путь>"
 ```
 
 Или по имени обработки/макета:
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-info.py" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
 ```
 
 Дополнительные флаги:

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

@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "Catalogs/Номенклатура/Templates/Макет"
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.py" -TemplatePath "Catalogs/Номенклатура/Templates/Макет"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "src/МояОбработка/Templates/ПечатнаяФорма"
+python "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.py" -TemplatePath "src/МояОбработка/Templates/ПечатнаяФорма"
 ```
 

.claude/skills/role-compile/SKILL.md

@@ -21,7 +21,7 @@ allowed-tools:
 | `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Roles/` и т.д.) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-compile.ps1" -JsonPath "<json>" -OutputDir "<ConfigDir>"
+python "${CLAUDE_SKILL_DIR}/scripts/role-compile.py" -JsonPath "<json>" -OutputDir "<ConfigDir>"
 ```
 
 Создаёт `{OutputDir}/Roles/Имя.xml` и `{OutputDir}/Roles/Имя/Ext/Rights.xml`. Регистрирует `<Role>` в `Configuration.xml`.

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

@@ -22,7 +22,7 @@ allowed-tools:
 ## Запуск скрипта
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-info.ps1" -RightsPath <path> -OutFile <output.txt>
+python "${CLAUDE_SKILL_DIR}/scripts/role-info.py" -RightsPath <path> -OutFile <output.txt>
 ```
 
 ### Параметры

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

@@ -23,5 +23,5 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-validate.ps1" -RightsPath "Roles/МояРоль"
+python "${CLAUDE_SKILL_DIR}/scripts/role-validate.py" -RightsPath "Roles/МояРоль"
 ```

.claude/skills/skd-compile/SKILL.md

@@ -23,10 +23,10 @@ allowed-tools:
 
 ```powershell
 # Из файла
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-compile.ps1" -DefinitionFile "<json>" -OutputPath "<Template.xml>"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-compile.py" -DefinitionFile "<json>" -OutputPath "<Template.xml>"
 
 # Из строки (без промежуточного файла)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-compile.ps1" -Value '<json-string>' -OutputPath "<Template.xml>"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-compile.py" -Value '<json-string>' -OutputPath "<Template.xml>"
 ```
 
 ## JSON DSL — краткий справочник

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

@@ -31,7 +31,7 @@ allowed-tools:
 | `OutputPath` | Путь к выходному JSON. Если не задан — JSON в stdout |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-decompile.ps1" -TemplatePath "<Template.xml>" -OutputPath "<out.json>"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-decompile.py" -TemplatePath "<Template.xml>" -OutputPath "<out.json>"
 ```
 
 ## Что получаешь

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

@@ -25,7 +25,7 @@ allowed-tools:
 | `NoSelection` | (опц.) Не добавлять поле в selection варианта |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-edit.ps1" -TemplatePath "<path>" -Operation <op> -Value "<value>"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-edit.py" -TemplatePath "<path>" -Operation <op> -Value "<value>"
 ```
 
 ## Пакетный режим (batch)

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

@@ -25,7 +25,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-info.ps1" -TemplatePath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-info.py" -TemplatePath "<путь>"
 ```
 
 С указанием режима:

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-validate.ps1" -TemplatePath "src/МойОтчёт/Templates/ОсновнаяСхема"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-validate.py" -TemplatePath "src/МойОтчёт/Templates/ОсновнаяСхема"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-validate.ps1" -TemplatePath "Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/skd-validate.py" -TemplatePath "Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml"
 ```

.claude/skills/subsystem-compile/SKILL.md

@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-compile.ps1" -Value '<json>' -OutputDir '<ConfigDir>'
+python "${CLAUDE_SKILL_DIR}/scripts/subsystem-compile.py" -Value '<json>' -OutputDir '<ConfigDir>'
 ```
 
 ## JSON-определение

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

@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-edit.ps1" -SubsystemPath '<path>' -Operation add-content -Value 'Catalog.Товары'
+python "${CLAUDE_SKILL_DIR}/scripts/subsystem-edit.py" -SubsystemPath '<path>' -Operation add-content -Value 'Catalog.Товары'
 ```
 
 ## Операции

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

@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-info.ps1" -SubsystemPath "<путь>"
+python "${CLAUDE_SKILL_DIR}/scripts/subsystem-info.py" -SubsystemPath "<путь>"
 ```
 
 ## Пять режимов

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

@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи"
+python "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.py" -SubsystemPath "Subsystems/Продажи"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи.xml"
+python "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.py" -SubsystemPath "Subsystems/Продажи.xml"
 ```

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

@@ -33,7 +33,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
+python "${CLAUDE_SKILL_DIR}/scripts/add-template.py" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
 ```
 
 ## Пример
@@ -41,7 +41,7 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -
 Добавить основную СКД к отчёту в расширении:
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
+python "${CLAUDE_SKILL_DIR}/scripts/add-template.py" -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
 ```
 
 ## Маппинг типов

.claude/skills/template-remove/SKILL.md

@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/remove-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" [-SrcDir "<SrcDir>"]
+python "${CLAUDE_SKILL_DIR}/scripts/remove-template.py" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" [-SrcDir "<SrcDir>"]
 ```
 
 ## Что удаляется

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

@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/web-info.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -55,8 +55,8 @@ Module: C:/Program Files/1cv8/8.3.24.1691/bin/wsap24.dll
 
 ```powershell
 # Статус по умолчанию
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1"
+python "${CLAUDE_SKILL_DIR}/scripts/web-info.py"
 
 # Указать путь к Apache
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1" -ApachePath "C:\tools\apache24"
+python "${CLAUDE_SKILL_DIR}/scripts/web-info.py" -ApachePath "C:\tools\apache24"
 ```

.claude/skills/web-publish/SKILL.md

@@ -41,7 +41,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/web-publish.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -88,14 +88,14 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" <
 
 ```powershell
 # Файловая база
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+python "${CLAUDE_SKILL_DIR}/scripts/web-publish.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
 
 # С явным именем публикации и портом
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -AppName "mydb" -Port 9090
+python "${CLAUDE_SKILL_DIR}/scripts/web-publish.py" -InfoBasePath "C:\Bases\MyDB" -AppName "mydb" -Port 9090
 
 # Серверная база
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret"
+python "${CLAUDE_SKILL_DIR}/scripts/web-publish.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret"
 
 # Ручной режим (только инструкция)
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -Manual
+python "${CLAUDE_SKILL_DIR}/scripts/web-publish.py" -InfoBasePath "C:\Bases\MyDB" -Manual
 ```

.claude/skills/web-stop/SKILL.md

@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/web-stop.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -45,8 +45,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1" <па
 
 ```powershell
 # Остановить Apache
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1"
+python "${CLAUDE_SKILL_DIR}/scripts/web-stop.py"
 
 # С указанием пути
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1" -ApachePath "C:\tools\apache24"
+python "${CLAUDE_SKILL_DIR}/scripts/web-stop.py" -ApachePath "C:\tools\apache24"
 ```

.claude/skills/web-unpublish/SKILL.md

@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.ps1" <параметры>
+python "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.py" <параметры>
 ```
 
 ### Параметры скрипта
@@ -52,11 +52,11 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.ps1"
 
 ```powershell
 # Удалить одну публикацию
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.ps1" -AppName "bpdemo"
+python "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.py" -AppName "bpdemo"
 
 # Удалить все публикации
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.ps1" -All
+python "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.py" -All
 
 # С указанием пути
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.ps1" -AppName "mydb" -ApachePath "C:\tools\apache24"
+python "${CLAUDE_SKILL_DIR}/scripts/web-unpublish.py" -AppName "mydb" -ApachePath "C:\tools\apache24"
 ```

.github/templates/README.port.md.tmpl

@@ -1,27 +0,0 @@
-# 1C Skills for {{PLATFORM_LABEL}} ({{RUNTIME_LABEL}})
-
-Автоматическая сборка из [main]({{MAIN_REPO_URL}}) — навыки 1С:Предприятие 8.3 для AI-агента **{{PLATFORM_LABEL}}** с рантаймом **{{RUNTIME_LABEL}}**.
-
-> Эта ветка генерируется CI на каждый push в main. **Не редактируйте напрямую** — все правки идут в [main]({{MAIN_REPO_URL}}).
-
-## Установка
-
-1. Скачайте ZIP этой ветки: **Code → Download ZIP** (или `git archive`).
-2. Распакуйте в корень своего проекта — должна появиться папка `{{PLATFORM_DIR}}/`.
-3. Запустите {{PLATFORM_LABEL}} из этого проекта — навыки станут доступны.
-
-## Требования
-
-- **Windows** с PowerShell 5.1+ (входит в Windows) — для PowerShell-сборки.
-- **Python 3.10+** — для Python-сборки. Зависимости: `lxml>=4.9.0`, `psutil>=5.9.0` (для DOM- и web-навыков).
-- **1С:Предприятие 8.3** — для сборки/разборки EPF/ERF и работы с базами.
-- **Node.js 18+** — для `/web-test`.
-
-## Документация
-
-Полные гайды, спецификации и описание навыков — в [main]({{MAIN_REPO_URL}}).
-
----
-
-Source: {{MAIN_REPO_URL}}
-Build commit: `{{COMMIT_SHA}}`

.github/templates/claude-plugin.json.tmpl

@@ -1,31 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
-  "name": "{{PLUGIN_NAME}}",
-  "description": "[Python] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент. Linux/Mac или когда PowerShell недоступен.",
-  "author": {
-    "name": "Nikolay Shirokov"
-  },
-  "homepage": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
-  "repository": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
-  "license": "MIT",
-  "keywords": [
-    "1c",
-    "1c-dev",
-    "cf",
-    "cfe",
-    "epf",
-    "erf",
-    "metadata",
-    "configuration",
-    "extension",
-    "form",
-    "report",
-    "skd",
-    "data-processor",
-    "mxl",
-    "web-client",
-    "testing",
-    "test-automation"
-  ],
-  "skills": "./.claude/skills/"
-}

.github/templates/codex-plugin.json.tmpl

@@ -1,36 +0,0 @@
-{
-  "name": "{{PLUGIN_NAME}}",
-  "version": "{{VERSION}}",
-  "description": "[{{RUNTIME_LABEL}}] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент.",
-  "author": {
-    "name": "Nikolay Shirokov"
-  },
-  "homepage": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
-  "repository": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
-  "license": "MIT",
-  "keywords": [
-    "1c",
-    "1c-dev",
-    "cf",
-    "cfe",
-    "epf",
-    "erf",
-    "metadata",
-    "configuration",
-    "extension",
-    "form",
-    "report",
-    "skd",
-    "data-processor",
-    "mxl",
-    "web-client",
-    "testing",
-    "test-automation"
-  ],
-  "skills": "./.codex/skills/",
-  "interface": {
-    "displayName": "1C Skills ({{RUNTIME_LABEL}})",
-    "shortDescription": "{{SHORT_DESCRIPTION}}",
-    "category": "Development"
-  }
-}

.github/workflows/build-ports.yml

@@ -1,224 +0,0 @@
-name: Build port branches
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - '.claude/skills/**'
-      - 'scripts/switch.py'
-      - '.github/templates/README.port.md.tmpl'
-      - '.github/templates/codex-plugin.json.tmpl'
-      - '.github/templates/claude-plugin.json.tmpl'
-      - '.github/workflows/build-ports.yml'
-      - 'LICENSE'
-  workflow_dispatch:
-
-permissions:
-  contents: write
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - platform: claude-code
-            runtime: python
-            branch: port-claude-code-py
-            label: Claude Code
-            target_dir: .claude/skills
-          - platform: cursor
-            runtime: powershell
-            branch: port-cursor
-            label: Cursor
-            target_dir: .cursor/skills
-          - platform: cursor
-            runtime: python
-            branch: port-cursor-py
-            label: Cursor
-            target_dir: .cursor/skills
-          - platform: codex
-            runtime: powershell
-            branch: port-codex
-            label: Codex
-            target_dir: .codex/skills
-          - platform: codex
-            runtime: python
-            branch: port-codex-py
-            label: Codex
-            target_dir: .codex/skills
-          - platform: copilot
-            runtime: powershell
-            branch: port-copilot
-            label: GitHub Copilot
-            target_dir: .github/skills
-          - platform: copilot
-            runtime: python
-            branch: port-copilot-py
-            label: GitHub Copilot
-            target_dir: .github/skills
-          - platform: augment
-            runtime: powershell
-            branch: port-augment
-            label: Augment
-            target_dir: .augment/skills
-          - platform: augment
-            runtime: python
-            branch: port-augment-py
-            label: Augment
-            target_dir: .augment/skills
-          - platform: cline
-            runtime: powershell
-            branch: port-cline
-            label: Cline
-            target_dir: .cline/skills
-          - platform: cline
-            runtime: python
-            branch: port-cline-py
-            label: Cline
-            target_dir: .cline/skills
-          - platform: kilo
-            runtime: powershell
-            branch: port-kilo
-            label: Kilo Code
-            target_dir: .kilocode/skills
-          - platform: kilo
-            runtime: python
-            branch: port-kilo-py
-            label: Kilo Code
-            target_dir: .kilocode/skills
-          - platform: kiro
-            runtime: powershell
-            branch: port-kiro
-            label: Kiro
-            target_dir: .kiro/skills
-          - platform: kiro
-            runtime: python
-            branch: port-kiro-py
-            label: Kiro
-            target_dir: .kiro/skills
-          - platform: gemini
-            runtime: powershell
-            branch: port-gemini
-            label: Gemini CLI
-            target_dir: .gemini/skills
-          - platform: gemini
-            runtime: python
-            branch: port-gemini-py
-            label: Gemini CLI
-            target_dir: .gemini/skills
-          - platform: opencode
-            runtime: powershell
-            branch: port-opencode
-            label: OpenCode
-            target_dir: .opencode/skills
-          - platform: opencode
-            runtime: python
-            branch: port-opencode-py
-            label: OpenCode
-            target_dir: .opencode/skills
-          - platform: roo
-            runtime: powershell
-            branch: port-roo
-            label: Roo Code
-            target_dir: .roo/skills
-          - platform: roo
-            runtime: python
-            branch: port-roo-py
-            label: Roo Code
-            target_dir: .roo/skills
-          - platform: windsurf
-            runtime: powershell
-            branch: port-windsurf
-            label: Windsurf
-            target_dir: .windsurf/skills
-          - platform: windsurf
-            runtime: python
-            branch: port-windsurf-py
-            label: Windsurf
-            target_dir: .windsurf/skills
-          - platform: agents
-            runtime: powershell
-            branch: port-agents
-            label: Agent Skills
-            target_dir: .agents/skills
-          - platform: agents
-            runtime: python
-            branch: port-agents-py
-            label: Agent Skills
-            target_dir: .agents/skills
-
-    steps:
-      - name: Checkout main
-        uses: actions/checkout@v5
-
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.11'
-
-      - name: Build skills tree for ${{ matrix.platform }} (${{ matrix.runtime }})
-        run: |
-          python scripts/switch.py "${{ matrix.platform }}" \
-            --project-dir build \
-            --runtime "${{ matrix.runtime }}"
-
-      - name: Render port README
-        env:
-          PLATFORM_LABEL: ${{ matrix.label }}
-          PLATFORM_DIR: ${{ matrix.target_dir }}
-          RUNTIME_LABEL: ${{ matrix.runtime == 'powershell' && 'PowerShell' || 'Python' }}
-          COMMIT_SHA: ${{ github.sha }}
-          MAIN_REPO_URL: https://github.com/${{ github.repository }}
-        run: |
-          sed \
-            -e "s|{{PLATFORM_LABEL}}|${PLATFORM_LABEL}|g" \
-            -e "s|{{PLATFORM_DIR}}|${PLATFORM_DIR}|g" \
-            -e "s|{{RUNTIME_LABEL}}|${RUNTIME_LABEL}|g" \
-            -e "s|{{COMMIT_SHA}}|${COMMIT_SHA}|g" \
-            -e "s|{{MAIN_REPO_URL}}|${MAIN_REPO_URL}|g" \
-            .github/templates/README.port.md.tmpl > build/README.md
-
-      - name: Render Codex plugin manifest
-        if: matrix.platform == 'codex'
-        env:
-          PLUGIN_NAME: ${{ matrix.runtime == 'python' && '1c-skills-py' || '1c-skills' }}
-          RUNTIME_LABEL: ${{ matrix.runtime == 'powershell' && 'PowerShell' || 'Python' }}
-          SHORT_DESCRIPTION: ${{ matrix.runtime == 'python' && 'Python runtime (Linux/Mac/Windows)' || 'PowerShell runtime (Windows-first)' }}
-          COMMIT_SHA: ${{ github.sha }}
-        run: |
-          VERSION="$(date -u +%Y.%-m.%-d)+${COMMIT_SHA::7}"
-          mkdir -p build/.codex-plugin
-          sed \
-            -e "s|{{PLUGIN_NAME}}|${PLUGIN_NAME}|g" \
-            -e "s|{{VERSION}}|${VERSION}|g" \
-            -e "s|{{RUNTIME_LABEL}}|${RUNTIME_LABEL}|g" \
-            -e "s|{{SHORT_DESCRIPTION}}|${SHORT_DESCRIPTION}|g" \
-            .github/templates/codex-plugin.json.tmpl > build/.codex-plugin/plugin.json
-
-      - name: Render Claude plugin manifest (Py variant)
-        if: matrix.platform == 'claude-code' && matrix.runtime == 'python'
-        env:
-          PLUGIN_NAME: 1c-skills-py
-        run: |
-          mkdir -p build/.claude-plugin
-          sed -e "s|{{PLUGIN_NAME}}|${PLUGIN_NAME}|g" \
-            .github/templates/claude-plugin.json.tmpl > build/.claude-plugin/plugin.json
-
-      - name: Copy LICENSE
-        run: cp LICENSE build/LICENSE
-
-      - name: Force-push orphan snapshot to ${{ matrix.branch }}
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          cd build
-          git init -q -b master
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add -A
-          git commit -q -m "Auto-build: ${{ matrix.platform }} (${{ matrix.runtime }}) from ${GITHUB_SHA::7}"
-          git push --force \
-            "https://x-access-token:${GH_TOKEN}@github.com/${{ github.repository }}.git" \
-            "master:${{ matrix.branch }}"

.gitignore

@@ -1,52 +0,0 @@
-# Реальные выгрузки обработок (примеры, не для версионирования)
-upload/
-
-# Результаты сборки
-build/
-base/
-*.epf
-*.log
-
-# Временные файлы тестов
-test-tmp/
-
-# Локальные настройки Claude Code
-.claude/settings.local.json
-
-# Инструменты (portable Apache и т.д.)
-tools/
-
-# Отладка навыков (eval, trigger-test, run_loop результаты)
-debug/
-
-# Кэш тестов навыков
-tests/skills/.cache/
-
-# Python кэш
-__pycache__/
-
-# Локальный реестр баз данных 1С
-.v8-project.json
-
-# web-test: Node.js зависимости и runtime-артефакты
-.claude/skills/web-test/scripts/node_modules/
-.claude/skills/web-test/.browser-session.json
-
-# Скриншоты и видео (артефакты тестирования web-test)
-*.png
-*.mp4
-
-# Навыки, скопированные для других AI-платформ (генерируются scripts/switch.py)
-.agents/skills/
-.augment/
-.cline/
-.codex/
-.cursor/
-.gemini/
-.github/skills/
-.kilocode/
-.kiro/
-.opencode/
-.roo/
-.windsurf/
-debug-templates.txt

README.md

@@ -1,278 +1,27 @@
-# 1C Skills for Claude Code
+# 1C Skills for Claude Code (Python)
 
-> **Проект живой, активно развивается** — добавляются новые возможности, отлавливаются и исправляются баги, производится оптимизация. Следите за обновлениями.
+Автоматическая сборка из [main](https://github.com/Nikolay-Shirokov/cc-1c-skills) — навыки 1С:Предприятие 8.3 для AI-агента **Claude Code** с рантаймом **Python**.
 
-Набор навыков для AI-агентов (в первую очередь для [Claude Code](https://docs.anthropic.com/en/docs/claude-code/skills)), помогающий охватить полный цикл разработки на платформе 1С:Предприятие 8.3 — от создания конфигураций, расширений, внешних обработок и отчётов до загрузки изменений в информационную базу, обновления, запуска, публикации на веб-сервере (портативная версия Apache), тестирования через веб-клиент и записи видеоинструкций.
+> Эта ветка генерируется CI на каждый push в main. **Не редактируйте напрямую** — все правки идут в [main](https://github.com/Nikolay-Shirokov/cc-1c-skills).
 
-Навыки дают модели готовые абстракции над XML-форматами и CLI конфигуратора — чтобы работать с сутью задачи, а не с деталями реализации. А веб-тестирование даёт ей глаза и руки для взаимодействия с интерфейсом 1С.
+## Установка
 
-## Версии навыков для разных платформ
+1. Скачайте ZIP этой ветки: **Code → Download ZIP** (или `git archive`).
-
+2. Распакуйте в корень своего проекта — должна появиться папка `.claude/skills/`.
-> **PS** — версия со скриптами на PowerShell (стандартная, для Windows). **Py** — версия со скриптами на Python (если PowerShell не подходит). Можно начать с **PS** — это основной вариант.
+3. Запустите Claude Code из этого проекта — навыки станут доступны.
-
-**Claude Code** [PS](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/main) · [Py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-claude-code-py) — **Cursor** [PS](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cursor) · [Py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cursor-py) — **Codex** [PS](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-codex) · [Py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-codex-py) — [Другие платформы →](#поддерживаемые-платформы)
-
-## Быстрый старт
-
-Скопируйте каталог `.claude/skills/` из этого репозитория в корень вашего проекта. Навыки станут доступны при запуске Claude Code из этого каталога.
-
-```
-МойПроект/
-├── .claude/skills/    ← скопировать сюда
-└── ...
-```
-
-Или установите как плагин Claude Code:
-
-```
-/plugin marketplace add https://github.com/Nikolay-Shirokov/cc-1c-skills
-/plugin install 1c-skills@cc-1c-skills        # PowerShell (Windows)
-/plugin install 1c-skills-py@cc-1c-skills     # Python (Linux/Mac или если PS недоступен)
-```
-
-Или установите как плагин OpenAI Codex:
-
-```
-codex plugin marketplace add Nikolay-Shirokov/cc-1c-skills
-codex /plugins   # выберите 1c-skills (PowerShell) или 1c-skills-py (Python) и нажмите Install
-```
-
-Или используйте скрипт установки:
-
-```bash
-git clone https://github.com/Nikolay-Shirokov/cc-1c-skills.git tools/cc-1c-skills
-
-# Копия (рекомендуется): независимая копия, обновление — повторный запуск
-python tools/cc-1c-skills/scripts/switch.py claude-code --project-dir .
-
-# Ссылки (экспериментально): обновления подхватываются через git pull
-python tools/cc-1c-skills/scripts/switch.py claude-code --project-dir . --link
-
-# Интерактивный режим: пошаговый выбор платформы, способа установки и рантайма
-python tools/cc-1c-skills/scripts/switch.py
-```
-
-Не обязательно запоминать команды и параметры — просто опишите задачу своими словами, Claude сам подберёт нужные навыки. Слеш-команды (например `/epf-init МояОбработка`) тоже работают — для точного контроля.
-
-## Группы навыков
-
-| Группа | Навыки | Описание | Гайд |
-|--------|--------|----------|------|
-| Внешние обработки (EPF) | 7 навыков `/epf-*` | Создание, сборка, разборка, валидация обработок из XML-исходников | [Подробнее](docs/epf-guide.md) |
-| Внешние отчёты (ERF) | 4 навыка `/erf-*` | Создание, сборка, разборка, валидация внешних отчётов | [Подробнее](docs/epf-guide.md#внешние-отчёты-erf) |
-| Универсальные операции | `/template-add`, `/template-remove`, `/help-add`, `/form-remove` | Добавление/удаление макетов, форм, справки для любых объектов | [Подробнее](docs/epf-guide.md#универсальные-навыки) |
-| Табличный документ (MXL) | 4 навыка `/mxl-*` | Анализ, создание, компиляция макетов печатных форм | [Подробнее](docs/mxl-guide.md) |
-| Управляемые формы (Form) | 6 навыков `/form-*` | Создание, анализ, генерация, модификация, валидация управляемых форм | [Подробнее](docs/form-guide.md) |
-| Роли (Role) | 3 навыка `/role-*` | Анализ прав роли, создание из JSON DSL, валидация | [Подробнее](docs/role-guide.md) |
-| Схема компоновки (СКД) | 4 навыка `/skd-*` | Анализ, генерация из JSON DSL, точечное редактирование, валидация схем компоновки данных | [Подробнее](docs/skd-guide.md) |
-| Метаданные конфигурации | 5 навыков `/meta-*` | Создание, анализ, редактирование, удаление, валидация объектов метаданных (23 типа) | [Подробнее](docs/meta-guide.md) |
-| Корневая конфигурация | 4 навыка `/cf-*` | Создание, анализ, редактирование, валидация корневых файлов конфигурации | [Подробнее](docs/cf-guide.md) |
-| Расширения (CFE) | 5 навыков `/cfe-*` | Создание, заимствование, перехват методов, валидация, анализ расширений | [Подробнее](docs/cfe-guide.md) |
-| Подсистемы (Subsystem) | 4 навыка `/subsystem-*` | Анализ, создание, редактирование, валидация подсистем конфигурации | [Подробнее](docs/subsystem-guide.md) |
-| Командный интерфейс (CI) | 2 навыка `/interface-*` | Редактирование и валидация CommandInterface.xml подсистем | [Подробнее](docs/subsystem-guide.md) |
-| Базы данных (DB) | 9 навыков `/db-*` | Создание баз, загрузка/выгрузка конфигураций, обновление БД, загрузка из Git | [Подробнее](docs/db-guide.md) |
-| Веб-публикация (Web) | 4 навыка `/web-*` | Публикация баз через Apache, статус, остановка, удаление публикаций | [Подробнее](docs/web-guide.md) |
-| Тестирование (Web) | `/web-test` | Взаимодействие с веб-клиентом 1С — навигация, формы, таблицы, отчёты, тестирование | [Подробнее](docs/web-test-guide.md) |
-| Запись видео (Web) | `/web-test` | Запись видеоинструкций с субтитрами, подсветкой и TTS-озвучкой | [Подробнее](docs/web-test-recording-guide.md) |
-| Регресс прикладного решения (Web) | `/web-test` | Автоматический регресс конфигурации: тесты, проверки, отчёты, прогон после правок | [Подробнее](docs/web-test-regression-guide.md) |
-| Утилиты | `/img-grid` | Наложение сетки на изображение для определения пропорций колонок | — |
 
 ## Требования
 
-- **Windows** с PowerShell 5.1+ (входит в Windows) — рантайм по умолчанию
+- **Windows** с PowerShell 5.1+ (входит в Windows) — для PowerShell-сборки.
-- **1С:Предприятие 8.3** — для сборки/разборки EPF/ERF (навыки генерации XML работают без платформы)
+- **Python 3.10+** — для Python-сборки. Зависимости: `lxml>=4.9.0`, `psutil>=5.9.0` (для DOM- и web-навыков).
-- **Node.js 18+** — для `/web-test` (тестирование через браузер)
+- **1С:Предприятие 8.3** — для сборки/разборки EPF/ERF и работы с базами.
+- **Node.js 18+** — для `/web-test`.
 
-<a id="поддерживаемые-платформы"></a>
+## Документация
-### Другие AI-платформы
 
-Навыки построены на открытом стандарте [Agent Skills](https://agentskills.io/specification) и совместимы с любой платформой, поддерживающей этот формат. Самый быстрый путь — скачать готовую сборку под нужную платформу из ветки ниже (**Code → Download ZIP**) и распаковать в корень своего проекта.
+Полные гайды, спецификации и описание навыков — в [main](https://github.com/Nikolay-Shirokov/cc-1c-skills).
 
-#### Поддерживаемые платформы
+---
 
-| Платформа | Целевой каталог | PowerShell | Python |
+Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
-|-----------|----------------|------------|--------|
+Build commit: `6d119eb473138dba6212fef2e1de2eb9fda64d16`
-| Claude Code | `.claude/skills/` | [main](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/main) | [port-claude-code-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-claude-code-py) |
-| Cursor | `.cursor/skills/` | [port-cursor](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cursor) | [port-cursor-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cursor-py) |
-| OpenAI Codex | `.codex/skills/` | [port-codex](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-codex) | [port-codex-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-codex-py) |
-| GitHub Copilot | `.github/skills/` | [port-copilot](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-copilot) | [port-copilot-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-copilot-py) |
-| Augment | `.augment/skills/` | [port-augment](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-augment) | [port-augment-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-augment-py) |
-| Cline | `.cline/skills/` | [port-cline](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cline) | [port-cline-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-cline-py) |
-| Kilo Code | `.kilocode/skills/` | [port-kilo](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-kilo) | [port-kilo-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-kilo-py) |
-| Kiro | `.kiro/skills/` | [port-kiro](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-kiro) | [port-kiro-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-kiro-py) |
-| Gemini CLI | `.gemini/skills/` | [port-gemini](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-gemini) | [port-gemini-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-gemini-py) |
-| OpenCode | `.opencode/skills/` | [port-opencode](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-opencode) | [port-opencode-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-opencode-py) |
-| Roo Code | `.roo/skills/` | [port-roo](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-roo) | [port-roo-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-roo-py) |
-| Windsurf | `.windsurf/skills/` | [port-windsurf](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-windsurf) | [port-windsurf-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-windsurf-py) |
-| Agent Skills | `.agents/skills/` | [port-agents](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-agents) | [port-agents-py](https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/port-agents-py) |
-
-Готовые ветки `port-*` пересобираются автоматически на каждое изменение в навыках. Если нужна свежая сборка прямо сейчас — соберите [локально через `switch.py`](#альтернативный-способ--собрать-локально-через-switchpy).
-
-Некоторые платформы (Augment, Cline, VS Code/Copilot) также сканируют `.claude/skills/` как fallback — для них достаточно `main`.
-
-<a id="альтернативный-способ--собрать-локально-через-switchpy"></a>
-#### Альтернативный способ — собрать локально через `switch.py`
-
-Если нужна свежая сборка под свою платформу (или платформа ещё не в матрице port-веток):
-
-```bash
-python scripts/switch.py                                       # интерактивный режим
-python scripts/switch.py cursor                                # скопировать навыки для Cursor
-python scripts/switch.py cursor --runtime python               # Cursor + Python-рантайм
-python scripts/switch.py claude-code --project-dir /my/proj    # установить копию в проект
-python scripts/switch.py claude-code --project-dir /my/proj --link  # ссылки вместо копий
-python scripts/switch.py --undo cursor                         # удалить копию / ссылки
-```
-
-Если репозиторий склонирован внутрь проекта (например, в `tools/cc-1c-skills`), используйте `--project-dir` для установки навыков в целевой проект.
-
-**Ссылки vs копии.** Флаг `--link` (экспериментальный) создаёт directory junction (Windows) или symlink (Linux/Mac) вместо копирования файлов. Обновления в источнике автоматически подхватываются во всех подключённых проектах — достаточно `git pull`. Ссылки доступны только для платформы Claude Code (для остальных платформ требуется перезапись путей в SKILL.md). Удаление ссылок: `--undo` — безопасно удаляет только ссылки, не трогая источник.
-
-> ⚠ **Известные ограничения `--link`:** Node.js резолвит `__dirname` через junction к реальному пути источника, а не к каталогу проекта. Это может приводить к тому, что навыки с Node.js-скриптами (например, `/web-test`) будут записывать файлы в каталог репозитория навыков вместо каталога проекта. При возникновении проблем переключитесь на копирование (без `--link`).
-
-Автоактивация — основной режим: просто опишите задачу своими словами, ассистент сам подберёт нужный навык по `description` в SKILL.md. Слеш-команды (например `/epf-init`) — для точного контроля, когда нужно вызвать конкретный навык.
-
-### Переключение рантайма (PowerShell ↔ Python)
-
-На Windows рекомендуется PS1-рантайм (по умолчанию). Python-порты — для **Linux/Mac** или если PowerShell недоступен. PS1-скрипты — мастер-версия; Python-порты производные (см. [Python Porting Guide](docs/python-porting-guide.md)).
-
-```bash
-python scripts/switch.py --runtime python      # переключить на Python
-python scripts/switch.py --runtime powershell  # вернуть на PowerShell
-```
-
-Дополнительные зависимости Python-рантайма:
-- `lxml>=4.9.0` — для навыков, работающих с DOM (edit/validate/info)
-- `psutil>=5.9.0` — для web-навыков (управление Apache)
-
-Параметры скриптов идентичны для обоих рантаймов — переключение меняет только интерпретатор в вызовах. Подробнее: [Python Porting Guide](docs/python-porting-guide.md).
-
-## Спецификации
-
-Полный индекс с оглавлением по всем 44 типам объектов: **[Сводный индекс спецификаций](docs/1c-specs-index.md)**
-
-- [XML-формат выгрузки обработок](docs/1c-epf-spec.md) — структура XML-файлов, namespace, элементы форм
-- [XML-формат внешних отчётов](docs/1c-erf-spec.md) — отличия ERF от EPF, Properties, MainDataCompositionSchema
-- [Управляемая форма](docs/1c-form-spec.md) — Form.xml, элементы, команды, реквизиты
-- [Встроенная справка](docs/1c-help-spec.md) — Help.xml, HTML-страницы, кнопка справки на форме
-- [Пакетный режим конфигуратора 1С](docs/build-spec.md) — команды `1cv8.exe`, DESIGNER, ENTERPRISE, CREATEINFOBASE
-- [Табличный документ (MXL)](docs/1c-spreadsheet-spec.md) — XML-формат SpreadsheetDocument, совместимость версий
-- [MXL DSL](docs/mxl-dsl-spec.md) — JSON-формат описания макета для `/mxl-compile` и `/mxl-decompile`
-- [Form DSL](docs/form-dsl-spec.md) — JSON-формат описания формы для `/form-compile`
-- [Роли (Rights.xml)](docs/1c-role-spec.md) — XML-формат прав роли, типы объектов, RLS
-- [Role DSL](docs/role-dsl-spec.md) — JSON-формат описания ролей для `/role-compile`
-- [Схема компоновки данных (DCS)](docs/1c-dcs-spec.md) — XML-формат DataCompositionSchema, 930 схем проанализировано
-- [SKD DSL](docs/skd-dsl-spec.md) — JSON-формат описания СКД для `/skd-compile`
-- [Объекты конфигурации](docs/1c-config-objects-spec.md) — XML-формат объектов метаданных конфигурации (23 типа)
-- [Подсистемы и командный интерфейс](docs/1c-subsystem-spec.md) — XML-формат подсистем, CommandInterface.xml, секции видимости/размещения/порядка
-- [Корневая конфигурация](docs/1c-configuration-spec.md) — XML-формат Configuration.xml, ConfigDumpInfo.xml, Languages/, 44 типа ChildObjects
-- [Расширения конфигурации (CFE)](docs/1c-extension-spec.md) — XML-формат выгрузки расширений конфигурации
-- [Веб-публикация 1С](docs/web-spec.md) — VRD, httpd.conf, wsap24.dll, portable Apache
-
-## Структура репозитория
-
-```
-.claude/skills/          # Навыки Claude Code
-├── epf-init/            # Создание обработки
-├── epf-build/           # Сборка EPF
-├── epf-dump/            # Разборка EPF
-├── epf-bsp-init/        # Регистрация БСП
-├── epf-bsp-add-command/ # Команда БСП
-├── epf-validate/        # Валидация обработки
-├── erf-init/            # Создание внешнего отчёта
-├── erf-build/           # Сборка ERF
-├── erf-dump/            # Разборка ERF
-├── erf-validate/        # Валидация отчёта
-├── template-add/        # Добавление макета (универсальный)
-├── template-remove/     # Удаление макета (универсальный)
-├── form-add/            # Добавление формы (универсальный)
-├── form-remove/         # Удаление формы (универсальный)
-├── help-add/            # Добавление справки (универсальный)
-├── mxl-info/            # Анализ макета
-├── mxl-validate/        # Валидация макета
-├── mxl-compile/         # Компиляция макета из JSON
-├── mxl-decompile/       # Декомпиляция макета в JSON
-├── form-info/           # Анализ структуры управляемой формы
-├── form-compile/        # Компиляция формы из JSON
-├── form-validate/       # Валидация формы
-├── form-edit/           # Добавление элементов в форму
-├── form-patterns/       # Справочник паттернов компоновки форм
-├── role-info/           # Анализ прав роли
-├── role-compile/        # Создание роли из JSON DSL
-├── role-validate/       # Валидация роли
-├── skd-info/            # Анализ схемы компоновки данных
-├── skd-compile/         # Компиляция СКД из JSON DSL
-├── skd-edit/            # Точечное редактирование СКД (25 операций)
-├── skd-validate/        # Валидация СКД
-├── meta-info/           # Структура объекта метаданных
-├── meta-compile/        # Создание объекта метаданных
-├── meta-edit/           # Редактирование объекта метаданных
-├── meta-remove/         # Удаление объекта метаданных
-├── meta-validate/       # Валидация объекта метаданных
-├── cf-info/             # Анализ структуры конфигурации
-├── cf-init/             # Создание пустой конфигурации
-├── cf-edit/             # Редактирование конфигурации
-├── cf-validate/         # Валидация конфигурации
-├── cfe-init/            # Создание расширения
-├── cfe-borrow/          # Заимствование объектов
-├── cfe-patch-method/    # Перехват методов
-├── cfe-validate/        # Валидация расширения
-├── cfe-diff/            # Анализ и сравнение
-├── subsystem-info/      # Анализ структуры подсистемы
-├── subsystem-compile/   # Создание подсистемы из JSON
-├── subsystem-edit/      # Редактирование подсистемы
-├── subsystem-validate/  # Валидация подсистемы
-├── interface-edit/      # Редактирование CommandInterface.xml
-├── interface-validate/  # Валидация CommandInterface.xml
-├── db-list/             # Управление реестром баз данных
-├── db-create/           # Создание информационной базы
-├── db-dump-cf/          # Выгрузка конфигурации в CF
-├── db-load-cf/          # Загрузка конфигурации из CF
-├── db-dump-xml/         # Выгрузка конфигурации в XML
-├── db-load-xml/         # Загрузка конфигурации из XML
-├── db-update/           # Обновление конфигурации БД
-├── db-run/              # Запуск 1С:Предприятие
-├── db-load-git/         # Загрузка изменений из Git
-├── web-publish/         # Публикация базы через Apache
-├── web-info/            # Статус Apache и публикаций
-├── web-stop/            # Остановка Apache
-├── web-unpublish/       # Удаление публикации
-├── web-test/            # Тестирование через веб-клиент 1С
-└── img-grid/            # Сетка для анализа изображений
-scripts/
-└── switch.py              # Переключение платформы и рантайма (13 платформ)
-docs/
-├── epf-guide.md            # Гайд: внешние обработки и отчёты
-├── mxl-guide.md            # Гайд: табличный документ
-├── form-guide.md           # Гайд: управляемые формы
-├── role-guide.md           # Гайд: роли
-├── skd-guide.md            # Гайд: схема компоновки данных
-├── meta-guide.md           # Гайд: объекты метаданных конфигурации
-├── cf-guide.md             # Гайд: корневые файлы конфигурации
-├── cfe-guide.md            # Гайд: расширения конфигурации (CFE)
-├── subsystem-guide.md      # Гайд: подсистемы и командный интерфейс
-├── v8-project-guide.md     # Гайд: конфигурация проекта (.v8-project.json)
-├── db-guide.md             # Гайд: базы данных 1С
-├── web-guide.md            # Гайд: веб-публикация через Apache
-├── web-test-guide.md       # Гайд: тестирование через веб-клиент
-├── web-test-recording-guide.md # Гайд: запись видеоинструкций
-├── web-test-regression-guide.md # Гайд: регресс прикладного решения
-├── 1c-epf-spec.md          # Спецификация XML-формата (EPF)
-├── 1c-erf-spec.md          # Спецификация XML-формата (ERF)
-├── 1c-form-spec.md         # Спецификация управляемых форм
-├── 1c-help-spec.md         # Спецификация встроенной справки
-├── 1c-config-objects-spec.md # Спецификация объектов конфигурации
-├── build-spec.md           # Пакетный режим конфигуратора 1С
-├── 1c-spreadsheet-spec.md  # Спецификация табличного документа
-├── mxl-dsl-spec.md         # Спецификация MXL DSL
-├── form-dsl-spec.md        # Спецификация Form DSL
-├── meta-dsl-spec.md        # Спецификация Meta DSL
-├── 1c-role-spec.md         # Спецификация ролей (Rights.xml)
-├── 1c-dcs-spec.md          # Спецификация СКД (DataCompositionSchema)
-├── skd-dsl-spec.md         # Спецификация SKD DSL
-├── role-dsl-spec.md        # Спецификация Role DSL
-├── 1c-extension-spec.md    # Спецификация расширений конфигурации (CFE)
-├── 1c-subsystem-spec.md    # Спецификация подсистем и командного интерфейса
-├── web-spec.md             # Спецификация веб-публикации (VRD, httpd.conf, Apache)
-└── python-porting-guide.md # Руководство по Python-портам навыков
-```

docs/1c-epf-spec.md

@@ -1,785 +0,0 @@
-# Спецификация XML-формата выгрузки внешней обработки 1С
-
-Формат: XML-выгрузка внешней обработки (ExternalDataProcessor) из конфигуратора 1С:Предприятие 8.3.
-Версия формата: `2.17`.
-
-> **Связанная спецификация**: Для внешних отчётов (ExternalReport / ERF) см. [1c-erf-spec.md](1c-erf-spec.md). Формат отчётов основан на формате обработок с дополнительными свойствами для СКД и вариантов.
-
-## 1. Структура каталогов
-
-```
-<ИмяОбработки>.xml                          # Корневой файл метаданных
-<ИмяОбработки>/
-    Ext/
-        ObjectModule.bsl                     # Модуль объекта (опционально)
-        Help.xml                             # Метаданные справки (опционально)
-        Help/
-            ru.html                          # HTML-страница справки
-    Forms/
-        <ИмяФормы>.xml                       # Метаданные формы
-        <ИмяФормы>/
-            Ext/
-                Form.xml                     # Описание формы (элементы, реквизиты, команды)
-                Form/
-                    Module.bsl               # Модуль формы
-    Templates/
-        <ИмяМакета>.xml                      # Метаданные макета
-        <ИмяМакета>/
-            Ext/
-                Template.<расш>              # Тело макета: .html, .xml (mxl) и др.
-```
-
-Обработка может содержать:
-- 0..N реквизитов объекта (описаны в корневом XML)
-- 0..N табличных частей (описаны в корневом XML)
-- 0..N форм (каталог `Forms/`)
-- 0..N макетов (каталог `Templates/`)
-- 0..1 модуль объекта (`Ext/ObjectModule.bsl`)
-- 0..1 встроенная справка (`Ext/Help.xml` + `Ext/Help/<язык>.html`), см. [1c-help-spec.md](1c-help-spec.md)
-
-## 2. Пространства имён XML
-
-### 2.1. Файлы метаданных (корневой XML, формы, макеты)
-
-Корневой элемент — `<MetaDataObject>`, пространство имён:
-
-```
-xmlns="http://v8.1c.ru/8.3/MDClasses"
-```
-
-Полный набор деклараций (можно копировать как есть):
-
-```xml
-<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">
-```
-
-### 2.2. Описание формы (Form.xml)
-
-Корневой элемент — `<Form>`, пространство имён:
-
-```
-xmlns="http://v8.1c.ru/8.3/xcf/logform"
-```
-
-Полный набор деклараций:
-
-```xml
-<Form
-    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"
-    version="2.17">
-```
-
-**Ключевое отличие**: файлы метаданных используют `http://v8.1c.ru/8.3/MDClasses`, описание формы — `http://v8.1c.ru/8.3/xcf/logform`.
-
-## 3. Корневой файл обработки (`<Имя>.xml`)
-
-Определяет имя обработки, синоним, форму по умолчанию и список дочерних объектов.
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="..." version="2.17">
-    <ExternalDataProcessor uuid="<UUID>">
-        <InternalInfo>
-            <xr:ContainedObject>
-                <xr:ClassId>c3831ec8-d8d5-4f93-8a22-f9bfae07327f</xr:ClassId>
-                <xr:ObjectId><UUID></xr:ObjectId>
-            </xr:ContainedObject>
-            <xr:GeneratedType name="ExternalDataProcessorObject.<Имя>" category="Object">
-                <xr:TypeId><UUID></xr:TypeId>
-                <xr:ValueId><UUID></xr:ValueId>
-            </xr:GeneratedType>
-        </InternalInfo>
-        <Properties>
-            <Name><Имя></Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content><Представление></v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-            <DefaultForm>ExternalDataProcessor.<Имя>.Form.<ИмяФормы></DefaultForm>
-            <AuxiliaryForm/>
-        </Properties>
-        <ChildObjects>
-            <!-- Реквизиты объекта (опционально) -->
-            <Attribute uuid="<UUID>">...</Attribute>
-            <!-- Табличные части (опционально) -->
-            <TabularSection uuid="<UUID>">...</TabularSection>
-            <!-- Формы -->
-            <Form><ИмяФормы></Form>
-            <!-- Макеты -->
-            <Template><ИмяМакета></Template>
-        </ChildObjects>
-    </ExternalDataProcessor>
-</MetaDataObject>
-```
-
-### Правила
-
-| Элемент | Описание |
-|---------|----------|
-| `ClassId` | Всегда `c3831ec8-d8d5-4f93-8a22-f9bfae07327f` (идентификатор класса ExternalDataProcessor) |
-| `ObjectId`, `TypeId`, `ValueId` | Уникальные UUID, генерируются при создании |
-| `DefaultForm` | Полный путь: `ExternalDataProcessor.<Имя>.Form.<ИмяФормы>` |
-| `<Form>`, `<Template>` | Только имена (без путей), соответствуют именам подкаталогов в `Forms/` и `Templates/` |
-| `<Attribute>` | Реквизиты объекта обработки (полное описание с типами) |
-| `<TabularSection>` | Полное описание табличных частей объекта (включая реквизиты ТЧ с типами) |
-
-### Порядок элементов в ChildObjects
-
-Порядок дочерних объектов **фиксирован**:
-
-1. `<Attribute>` — реквизиты объекта (0..N)
-2. `<TabularSection>` — табличные части (0..N)
-3. `<Form>` — формы (0..N)
-4. `<Template>` — макеты (0..N)
-
-### Реквизиты объекта
-
-Если обработка имеет реквизиты объекта, они описываются в `<ChildObjects>` корневого файла:
-
-```xml
-<Attribute uuid="<UUID>">
-    <Properties>
-        <Name><ИмяРеквизита></Name>
-        <Synonym/>
-        <Comment/>
-        <Type>
-            <v8:Type>xs:string</v8:Type>
-            <v8:StringQualifiers>
-                <v8:Length>10</v8:Length>
-                <v8:AllowedLength>Variable</v8:AllowedLength>
-            </v8:StringQualifiers>
-        </Type>
-        <PasswordMode>false</PasswordMode>
-        <Format/>
-        <EditFormat/>
-        <ToolTip/>
-        <MarkNegatives>false</MarkNegatives>
-        <Mask/>
-        <MultiLine>false</MultiLine>
-        <ExtendedEdit>false</ExtendedEdit>
-        <MinValue xsi:nil="true"/>
-        <MaxValue xsi:nil="true"/>
-        <FillChecking>DontCheck</FillChecking>
-        <ChoiceFoldersAndItems>Items</ChoiceFoldersAndItems>
-        <ChoiceParameterLinks/>
-        <ChoiceParameters/>
-        <QuickChoice>Auto</QuickChoice>
-        <CreateOnInput>Auto</CreateOnInput>
-        <ChoiceForm/>
-        <LinkByType/>
-        <ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>
-    </Properties>
-</Attribute>
-```
-
-#### Свойства реквизита объекта (полный перечень)
-
-Порядок фиксирован:
-
-| Свойство | Тип | Описание | Значение по умолчанию |
-|----------|-----|----------|----------------------|
-| `Name` | string | Имя реквизита | — |
-| `Synonym` | LocalString | Синоним (отображаемое имя) | — |
-| `Comment` | string | Комментарий | пустой |
-| `Type` | TypeDescription | Тип данных | — |
-| `PasswordMode` | boolean | Режим пароля | `false` |
-| `Format` | string | Формат вывода | пустой |
-| `EditFormat` | string | Формат редактирования | пустой |
-| `ToolTip` | LocalString | Подсказка | пустой |
-| `MarkNegatives` | boolean | Выделять отрицательные | `false` |
-| `Mask` | string | Маска ввода | пустой |
-| `MultiLine` | boolean | Многострочный | `false` |
-| `ExtendedEdit` | boolean | Расширенное редактирование | `false` |
-| `MinValue` | any | Минимальное значение | `xsi:nil="true"` |
-| `MaxValue` | any | Максимальное значение | `xsi:nil="true"` |
-| `FillChecking` | enum | Проверка заполнения | `DontCheck` |
-| `ChoiceFoldersAndItems` | enum | Выбор групп и элементов | `Items` |
-| `ChoiceParameterLinks` | list | Связи параметров выбора | пустой |
-| `ChoiceParameters` | list | Параметры выбора | пустой |
-| `QuickChoice` | enum | Быстрый выбор | `Auto` |
-| `CreateOnInput` | enum | Создание при вводе | `Auto` |
-| `ChoiceForm` | string | Форма выбора | пустой |
-| `LinkByType` | ref | Связь по типу | пустой |
-| `ChoiceHistoryOnInput` | enum | История выбора при вводе | `Auto` |
-
-#### Типы реквизитов
-
-| v8:Type | Описание | Квалификаторы |
-|---------|----------|---------------|
-| `xs:string` | Строка | `v8:StringQualifiers`: `Length`, `AllowedLength` (Variable/Fixed) |
-| `xs:boolean` | Булево | — |
-| `xs:decimal` | Число | `v8:NumberQualifiers`: `Digits`, `FractionDigits`, `AllowedSign` (Any/Nonnegative) |
-| `xs:dateTime` | Дата | `v8:DateQualifiers`: `DateFractions` (Date/Time/DateTime) |
-| `cfg:CatalogRef.<Имя>` | Ссылка на справочник | — |
-| `cfg:DocumentRef.<Имя>` | Ссылка на документ | — |
-| `cfg:EnumRef.<Имя>` | Ссылка на перечисление | — |
-
-> **Примечание**: Ссылочные типы (`cfg:CatalogRef.*` и т.д.) работают **только** при наличии в информационной базе конфигурации с соответствующими объектами.
-
-### Табличные части объекта
-
-Если обработка имеет табличные части, они описываются в `<ChildObjects>` корневого файла:
-
-```xml
-<TabularSection uuid="<UUID>">
-    <InternalInfo>
-        <xr:GeneratedType name="DataProcessorTabularSection.<ИмяОбработки>.<ИмяТЧ>" category="TabularSection">
-            <xr:TypeId><UUID></xr:TypeId>
-            <xr:ValueId><UUID></xr:ValueId>
-        </xr:GeneratedType>
-        <xr:GeneratedType name="DataProcessorTabularSectionRow.<ИмяОбработки>.<ИмяТЧ>" category="TabularSectionRow">
-            <xr:TypeId><UUID></xr:TypeId>
-            <xr:ValueId><UUID></xr:ValueId>
-        </xr:GeneratedType>
-    </InternalInfo>
-    <Properties>
-        <Name><ИмяТЧ></Name>
-        <Synonym>...</Synonym>
-        <Comment/>
-        <ToolTip/>
-        <FillChecking>DontCheck</FillChecking>
-        <StandardAttributes>
-            <xr:StandardAttribute name="LineNumber">
-                <!-- Стандартные свойства реквизита -->
-            </xr:StandardAttribute>
-        </StandardAttributes>
-    </Properties>
-    <ChildObjects>
-        <Attribute uuid="<UUID>">
-            <Properties>
-                <Name><ИмяРеквизита></Name>
-                <Synonym/>
-                <Comment/>
-                <Type>...</Type>
-                <PasswordMode>false</PasswordMode>
-                <Format/>
-                <EditFormat/>
-                <ToolTip/>
-                <MarkNegatives>false</MarkNegatives>
-                <Mask/>
-                <MultiLine>false</MultiLine>
-                <ExtendedEdit>false</ExtendedEdit>
-                <MinValue xsi:nil="true"/>
-                <MaxValue xsi:nil="true"/>
-                <FillFromFillingValue>false</FillFromFillingValue>
-                <FillValue xsi:nil="true"/>
-                <FillChecking>DontCheck</FillChecking>
-                <ChoiceFoldersAndItems>Items</ChoiceFoldersAndItems>
-                <ChoiceParameterLinks/>
-                <ChoiceParameters/>
-                <QuickChoice>Auto</QuickChoice>
-                <CreateOnInput>Auto</CreateOnInput>
-                <ChoiceForm/>
-                <LinkByType/>
-                <ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>
-            </Properties>
-        </Attribute>
-    </ChildObjects>
-</TabularSection>
-```
-
-> **Важно**: Реквизиты табличных частей имеют 2 дополнительных свойства по сравнению с реквизитами объекта: `FillFromFillingValue` и `FillValue`. Они вставляются между `MaxValue` и `FillChecking`. При этом свойства `Indexing`, `FullTextSearch`, `DataHistory` и `Use` **отсутствуют** как у реквизитов объекта, так и у реквизитов ТЧ обработок/отчётов (в отличие от хранимых объектов конфигурации).
-
-## 4. Метаданные формы (`Forms/<Имя>.xml`)
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="..." version="2.17">
-    <Form uuid="<UUID>">
-        <Properties>
-            <Name><ИмяФормы></Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content><Представление></v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-            <FormType>Managed</FormType>
-            <IncludeHelpInContents>false</IncludeHelpInContents>
-            <UsePurposes>
-                <v8:Value xsi:type="app:ApplicationUsePurpose">PlatformApplication</v8:Value>
-            </UsePurposes>
-            <ExtendedPresentation/>
-        </Properties>
-    </Form>
-</MetaDataObject>
-```
-
-`FormType` — всегда `Managed` для управляемых форм.
-
-## 5. Метаданные макета (`Templates/<Имя>.xml`)
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="..." version="2.17">
-    <Template uuid="<UUID>">
-        <Properties>
-            <Name><ИмяМакета></Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content><Представление></v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-            <TemplateType><ТипМакета></TemplateType>
-        </Properties>
-    </Template>
-</MetaDataObject>
-```
-
-### Типы макетов
-
-| Значение `TemplateType` | Расширение файла тела | Описание |
-|---|---|---|
-| `SpreadsheetDocument` | `.xml` | Табличный документ (MXL в XML) |
-| `DataCompositionSchema` | `.xml` | Схема компоновки данных (СКД), см. [1c-dcs-spec.md](1c-dcs-spec.md) |
-| `HTMLDocument` | `.html` | HTML-документ |
-| `TextDocument` | `.txt` | Текстовый документ |
-| `BinaryData` | `.bin` | Двоичные данные |
-| `ActiveDocument` | `.xml` | Активный документ |
-
-## 6. Описание формы (`Form.xml`)
-
-Самый сложный файл. Содержит три корневых секции:
-- `<ChildItems>` — дерево элементов формы (визуальная структура)
-- `<Attributes>` — реквизиты формы (данные)
-- `<Commands>` — команды формы
-
-### 6.1. Общая структура
-
-```xml
-<Form xmlns="http://v8.1c.ru/8.3/xcf/logform" ... version="2.17">
-    <Title>...</Title>
-    <AutoTitle>false</AutoTitle>
-    <AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
-        <Autofill>false</Autofill>
-    </AutoCommandBar>
-    <Events>
-        <Event name="OnCreateAtServer">ПриСозданииНаСервере</Event>
-    </Events>
-    <ChildItems>
-        <!-- Элементы формы -->
-    </ChildItems>
-    <Attributes>
-        <!-- Реквизиты формы -->
-    </Attributes>
-    <Commands>
-        <!-- Команды формы -->
-    </Commands>
-</Form>
-```
-
-### 6.2. Идентификаторы (id)
-
-- Каждый элемент, реквизит и команда имеет уникальный `id` (целое число).
-- `id` уникален в пределах своей секции: элементы, реквизиты и команды нумеруются независимо.
-- `id="-1"` зарезервирован для `AutoCommandBar` формы.
-- `id` колонок (`Column`) — уникальны в пределах своего реквизита.
-
-### 6.3. Элементы формы (`<ChildItems>`)
-
-#### Типы элементов
-
-| XML-тег | Описание | Ключевые свойства |
-|---------|----------|-------------------|
-| `UsualGroup` | Обычная группа | `Group` (Vertical/Horizontal), `Representation`, `ShowTitle` |
-| `Button` | Кнопка | `Type` (UsualButton/CommandBarButton), `CommandName` |
-| `InputField` | Поле ввода | `DataPath`, `MinValue`, `MaxValue` |
-| `CheckBoxField` | Флажок | `DataPath`, `CheckBoxType`, `ThreeState`, `ReadOnly` |
-| `LabelField` | Поле надписи | `DataPath` (только отображение) |
-| `LabelDecoration` | Декорация-надпись | `Title` (статический текст) |
-| `FormTree` | Дерево формы | `DataPath`, `Header`, `RowPictureDataPath` |
-| `Table` | Таблица формы | `DataPath`, `Representation` (List/Tree), `ChangeRowSet` |
-| `HTMLDocumentField` | Поле HTML-документа | `DataPath` |
-| `CommandBar` | Командная панель (внутри элемента) | `Autofill` |
-| `Popup` | Подменю на командной панели | `Title`, `Picture` |
-
-#### Правила DataPath
-
-- Простые реквизиты: `DataPath` = имя реквизита формы. Пример: `<DataPath>СтрокаПоиска</DataPath>`
-- Колонки таблицы/дерева (реквизит формы): `<ИмяРеквизита>.<ИмяКолонки>`. Пример: `<DataPath>ТаблицаРеквизитов.Пометка</DataPath>`
-- Табличные части объекта: `Объект.<ИмяТЧ>.<ИмяРеквизита>`. Пример: `<DataPath>Объект.ТЧМетаданные.Флаг</DataPath>`
-
-#### ExtendedTooltip
-
-Каждый элемент формы **должен** иметь дочерний `<ExtendedTooltip>`. Минимальная форма:
-
-```xml
-<ExtendedTooltip name="<ИмяЭлемента>ExtendedTooltip" id="<ID>"/>
-```
-
-Имя: `<ИмяРодительскогоЭлемента>ExtendedTooltip`. Может содержать `<Title>` с текстом подсказки.
-
-#### ContextMenu
-
-Элементы, поддерживающие контекстное меню (`InputField`, `CheckBoxField`, `LabelField`, `FormTree`, `Table`, `HTMLDocumentField`), **должны** иметь:
-
-```xml
-<ContextMenu name="<ИмяЭлемента>КонтекстноеМеню" id="<ID>"/>
-```
-
-#### Пример: группа с кнопками
-
-```xml
-<UsualGroup name="ГруппаКоманд" id="1">
-    <Title><v8:item><v8:lang>ru</v8:lang><v8:content>Команды</v8:content></v8:item></Title>
-    <Representation>None</Representation>
-    <ShowTitle>false</ShowTitle>
-    <ExtendedTooltip name="ГруппаКомандExtendedTooltip" id="100"/>
-    <ChildItems>
-        <Button name="КнопкаПостроить" id="2">
-            <Type>UsualButton</Type>
-            <Title>...</Title>
-            <CommandName>Form.Command.Построить</CommandName>
-            <ExtendedTooltip name="КнопкаПостроитьExtendedTooltip" id="101"/>
-        </Button>
-    </ChildItems>
-</UsualGroup>
-```
-
-#### Пример: FormTree (дерево)
-
-```xml
-<FormTree name="ДеревоМетаданных" id="11">
-    <DataPath>ДеревоМетаданных</DataPath>
-    <TitleLocation>None</TitleLocation>
-    <ContextMenu name="ДеревоМетаданныхКонтекстноеМеню" id="12"/>
-    <ExtendedTooltip name="ДеревоМетаданныхExtendedTooltip" id="108"/>
-    <CommandBar name="ДеревоМетаданныхКоманднаяПанель" id="13">
-        <Autofill>false</Autofill>
-        <ExtendedTooltip name="ДеревоМетаданныхКоманднаяПанельExtendedTooltip" id="109"/>
-    </CommandBar>
-    <Header>false</Header>
-    <RowPictureDataPath>ДеревоМетаданных.ИндексКартинки</RowPictureDataPath>
-    <Events>
-        <Event name="OnActivateRow">ДеревоМетаданныхПриАктивизацииСтроки</Event>
-    </Events>
-    <ChildItems>
-        <!-- Колонки как дочерние элементы -->
-        <CheckBoxField name="ДеревоМетаданныхПометка" id="14">
-            <DataPath>ДеревоМетаданных.Пометка</DataPath>
-            ...
-        </CheckBoxField>
-    </ChildItems>
-</FormTree>
-```
-
-#### Пример: Table (таблица, привязанная к реквизиту формы типа ValueTable)
-
-```xml
-<Table name="ТаблицаРеквизитов" id="26">
-    <DataPath>ТаблицаРеквизитов</DataPath>
-    <TitleLocation>None</TitleLocation>
-    <ContextMenu name="ТаблицаРеквизитовКонтекстноеМеню" id="27"/>
-    <ExtendedTooltip name="ТаблицаРеквизитовExtendedTooltip" id="119"/>
-    <CommandBar name="ТаблицаРеквизитовКоманднаяПанель" id="28">
-        <Autofill>false</Autofill>
-        <ExtendedTooltip name="ТаблицаРеквизитовКоманднаяПанельExtendedTooltip" id="120"/>
-    </CommandBar>
-    <ChangeRowSet>false</ChangeRowSet>
-    <ChangeRowOrder>false</ChangeRowOrder>
-    <ChildItems>
-        <CheckBoxField name="ТаблицаРеквизитовПометка" id="29">
-            <DataPath>ТаблицаРеквизитов.Пометка</DataPath>
-            ...
-        </CheckBoxField>
-    </ChildItems>
-</Table>
-```
-
-#### Table: режим дерева
-
-Элемент `Table` может отображать данные как дерево через `<Representation>Tree</Representation>`. В этом случае реквизит формы должен иметь тип `v8:ValueTree`.
-
-```xml
-<Table name="ДеревоМетаданных" id="238">
-    <Representation>Tree</Representation>
-    <DataPath>ДеревоМетаданных</DataPath>
-    ...
-</Table>
-```
-
-> **Примечание**: Элемент `FormTree` — альтернативный способ отобразить дерево. `FormTree` не требует явного указания `<Representation>`, дерево подразумевается. `Table` с `<Representation>Tree</Representation>` — более полный элемент с дополнительными возможностями (SearchStringAddition, ViewStatusAddition и др.).
-
-#### Table: привязка к ТЧ объекта vs реквизит формы
-
-| Источник данных | DataPath таблицы | DataPath колонки | Тип реквизита |
-|---|---|---|---|
-| Табличная часть объекта | `Объект.<ИмяТЧ>` | `Объект.<ИмяТЧ>.<ИмяРеквизита>` | (определён в корневом XML) |
-| Реквизит формы (ValueTable) | `<ИмяРеквизита>` | `<ИмяРеквизита>.<ИмяКолонки>` | `v8:ValueTable` |
-| Реквизит формы (ValueTree) | `<ИмяРеквизита>` | `<ИмяРеквизита>.<ИмяКолонки>` | `v8:ValueTree` |
-
-### 6.4. Реквизиты формы (`<Attributes>`)
-
-#### Примитивные типы
-
-```xml
-<Attribute name="СтрокаПоиска" id="18">
-    <Title><v8:item><v8:lang>ru</v8:lang><v8:content>Строка поиска</v8:content></v8:item></Title>
-    <Type>
-        <v8:Type>xs:string</v8:Type>
-        <v8:StringQualifiers>
-            <v8:Length>200</v8:Length>
-            <v8:AllowedLength>Variable</v8:AllowedLength>
-        </v8:StringQualifiers>
-    </Type>
-</Attribute>
-```
-
-#### Таблица типов
-
-| v8:Type | Описание | Квалификаторы |
-|---------|----------|---------------|
-| `xs:string` | Строка | `v8:StringQualifiers`: `Length` (0 = неограниченная), `AllowedLength` (Variable/Fixed) |
-| `xs:boolean` | Булево | — |
-| `xs:decimal` | Число | `v8:NumberQualifiers`: `Digits`, `FractionDigits`, `AllowedSign` (Any/Nonnegative) |
-| `xs:dateTime` | Дата | `v8:DateQualifiers`: `DateFractions` (Date/Time/DateTime) |
-| `v8:ValueTable` | Таблица значений | Должен содержать `<Columns>` |
-| `v8:ValueTree` | Дерево значений | Должен содержать `<Columns>` |
-| `v8:UUID` | Уникальный идентификатор | — |
-| `cfg:ExternalDataProcessorObject.<Имя>` | Объект обработки (основной реквизит) | `<MainAttribute>true</MainAttribute>` |
-| `cfg:CatalogRef.<Имя>` | Ссылка на справочник | — |
-| `xmlns:mxl="http://v8.1c.ru/8.2/data/spreadsheet"` `mxl:SpreadsheetDocument` | Табличный документ | Требует дополнительное объявление namespace `mxl` |
-
-> **ВАЖНО**: Для коллекций (ValueTable, ValueTree) тип **обязателен**. Пустой `<Type/>` приведёт к ошибке «Неверный путь к данным» при обращении к колонкам через DataPath.
-
-#### Коллекции: ValueTable и ValueTree
-
-```xml
-<Attribute name="ТаблицаРеквизитов" id="8">
-    <Title>...</Title>
-    <Type>
-        <v8:Type>v8:ValueTable</v8:Type>
-    </Type>
-    <Columns>
-        <Column name="Пометка" id="1">
-            <Title>...</Title>
-            <Type>
-                <v8:Type>xs:boolean</v8:Type>
-            </Type>
-        </Column>
-        <Column name="ИмяРеквизита" id="2">
-            <Title>...</Title>
-            <Type>
-                <v8:Type>xs:string</v8:Type>
-                <v8:StringQualifiers>
-                    <v8:Length>150</v8:Length>
-                    <v8:AllowedLength>Variable</v8:AllowedLength>
-                </v8:StringQualifiers>
-            </Type>
-        </Column>
-    </Columns>
-</Attribute>
-```
-
-Для дерева — `v8:ValueTree`, структура аналогична.
-
-#### Основной реквизит (Объект)
-
-Связывает форму с объектом обработки. Обязателен для доступа к табличным частям и модулю объекта.
-
-```xml
-<Attribute name="Объект" id="20">
-    <Type>
-        <v8:Type>cfg:ExternalDataProcessorObject.<ИмяОбработки></v8:Type>
-    </Type>
-    <MainAttribute>true</MainAttribute>
-</Attribute>
-```
-
-### 6.5. Команды формы (`<Commands>`)
-
-```xml
-<Command name="Построить" id="1">
-    <Title>
-        <v8:item>
-            <v8:lang>ru</v8:lang>
-            <v8:content>Построить</v8:content>
-        </v8:item>
-    </Title>
-    <ToolTip>
-        <v8:item>
-            <v8:lang>ru</v8:lang>
-            <v8:content>Построить ER-диаграмму</v8:content>
-        </v8:item>
-    </ToolTip>
-    <Action>КомандаПостроить</Action>
-    <CurrentRowUse>DontUse</CurrentRowUse>
-</Command>
-```
-
-Команда привязывается к кнопке через `CommandName`:
-```xml
-<Button ...>
-    <CommandName>Form.Command.Построить</CommandName>
-</Button>
-```
-
-### 6.6. События формы и элементов
-
-#### События формы
-
-```xml
-<Events>
-    <Event name="OnCreateAtServer">ПриСозданииНаСервере</Event>
-    <Event name="OnOpen">ПриОткрытии</Event>
-</Events>
-```
-
-#### События элементов (внутри элемента)
-
-```xml
-<Events>
-    <Event name="OnChange">ДеревоМетаданныхПометкаПриИзменении</Event>
-    <Event name="OnActivateRow">ДеревоМетаданныхПриАктивизацииСтроки</Event>
-</Events>
-```
-
-| Имя события | Описание |
-|-------------|----------|
-| `OnCreateAtServer` | При создании на сервере (форма) |
-| `OnOpen` | При открытии (форма) |
-| `OnChange` | При изменении (элементы ввода, флажки) |
-| `OnActivateRow` | При активизации строки (дерево, таблица) |
-| `OnEditEnd` | При окончании редактирования (таблица) |
-
-## 7. Модули BSL
-
-### 7.1. Модуль объекта (`ObjectModule.bsl`)
-
-Серверная логика без контекста формы. Доступен через `РеквизитФормыВЗначение("Объект")`.
-
-```bsl
-// Экспортные функции — API объекта
-Функция ПолучитьДанные() Экспорт
-    // ...
-КонецФункции
-```
-
-### 7.2. Модуль формы (`Module.bsl`)
-
-Обработчики событий формы, элементов и команд.
-
-Директивы компиляции:
-- `&НаСервере` — выполняется на сервере, есть доступ к реквизитам формы
-- `&НаКлиенте` — выполняется на клиенте
-- `&НаСервереБезКонтекста` — на сервере без контекста формы
-
-```bsl
-#Область ОбработчикиСобытийФормы
-
-&НаСервере
-Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
-    ОбъектОбработки = РеквизитФормыВЗначение("Объект");
-    // ... вызовы функций модуля объекта
-КонецПроцедуры
-
-#КонецОбласти
-```
-
-## 8. Генерация UUID
-
-Все UUID в XML-файлах должны быть валидными UUID v4. Формат: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.
-
-При генерации нового проекта каждый UUID должен быть уникальным. UUID используются для:
-- Идентификации объекта обработки (`ExternalDataProcessor uuid`)
-- Внутренних типов (`ContainedObject`, `GeneratedType`)
-- Форм (`Form uuid`)
-- Макетов (`Template uuid`)
-- Табличных частей и их реквизитов
-
-## 9. Известные ошибки и подводные камни
-
-### «Неверный путь к данным» для колонок таблицы
-
-**Проблема**: При загрузке формы конфигуратор выдаёт ошибку «Неверный путь к данным: <Реквизит>.<Колонка>» для всех колонок таблицы.
-
-**Причина**: Реквизит формы с колонками (`<Columns>`) не имеет правильного типа. Для коллекций тип обязателен:
-- `v8:ValueTable` для таблиц
-- `v8:ValueTree` для деревьев
-
-**Неправильно**:
-```xml
-<Attribute name="МояТаблица" id="1">
-    <Type/>                              <!-- ОШИБКА: тип пустой -->
-    <Columns>...</Columns>
-</Attribute>
-```
-
-**Правильно**:
-```xml
-<Attribute name="МояТаблица" id="1">
-    <Type>
-        <v8:Type>v8:ValueTable</v8:Type>  <!-- Тип обязателен -->
-    </Type>
-    <Columns>...</Columns>
-</Attribute>
-```
-
-### BOM в файлах метаданных
-
-Файлы метаданных (корневой XML, формы, макеты), выгруженные конфигуратором, содержат BOM (Byte Order Mark, `\xEF\xBB\xBF`) в начале. Файл `Form.xml` (описание формы) и `.bsl`-модули — **без BOM**. При ручном создании файлов рекомендуется следовать этому же правилу, хотя конфигуратор принимает файлы и без BOM.
-
-### Кодировка
-
-Все файлы — UTF-8. XML-файлы имеют заголовок `<?xml version="1.0" encoding="UTF-8"?>`.
-
-## 10. Чеклист для создания новой обработки
-
-1. Сгенерировать UUID для каждого объекта (обработка, реквизиты, формы, макеты, ТЧ)
-2. Создать структуру каталогов (раздел 1)
-3. Создать корневой XML (раздел 3) с правильными ChildObjects:
-   - Порядок: Attribute → TabularSection → Form → Template
-   - GeneratedType для ТЧ: `DataProcessorTabularSection.<Имя>.<ТЧ>` (не `ExternalDataProcessorTabularSection`!)
-4. Для каждой формы:
-   - Создать `<Имя>.xml` (раздел 4)
-   - Создать `Form.xml` (раздел 6) — проверить пространство имён!
-   - Создать `Module.bsl` (раздел 7.2)
-5. Для каждого макета:
-   - Создать `<Имя>.xml` (раздел 5) с правильным TemplateType
-   - Создать тело макета (`Template.<расш>`)
-6. При необходимости создать `ObjectModule.bsl` (раздел 7.1)
-7. Проверить:
-   - Все `<Type>` для коллекций содержат `v8:ValueTable` / `v8:ValueTree`
-   - Все `DataPath` корректны (особенно для колонок таблиц)
-   - Все элементы имеют `ExtendedTooltip`
-   - Все ID уникальны в пределах своих секций
-   - `DefaultForm` в корневом файле соответствует реальному имени формы

docs/1c-erf-spec.md

@@ -1,628 +0,0 @@
-# Спецификация XML-формата выгрузки внешнего отчёта 1С
-
-Формат: XML-выгрузка внешнего отчёта (ExternalReport) из конфигуратора 1С:Предприятие 8.3.
-Версия формата: `2.17`.
-
-> **Связь с другими спецификациями**:
-> - Структура каталогов, пространства имён, формат форм и макетов — идентичны [спецификации внешней обработки (EPF)](1c-epf-spec.md).
-> - Формат СКД-макетов — см. [спецификацию СКД](1c-dcs-spec.md).
-> - Формат форм — см. [спецификацию форм](1c-form-spec.md).
-> - Формат MXL-макетов — см. [спецификацию табличного документа](mxl-dsl-spec.md).
->
-> Данный документ описывает **только** отличия внешнего отчёта от внешней обработки.
-
-## 1. Структура каталогов
-
-```
-<ИмяОтчёта>.xml                              # Корневой файл метаданных
-<ИмяОтчёта>/
-    Ext/
-        ObjectModule.bsl                      # Модуль объекта (опционально)
-        Help.xml                              # Метаданные справки (опционально)
-        Help/
-            ru.html                           # HTML-страница справки
-    Forms/
-        <ИмяФормы>.xml                        # Метаданные формы
-        <ИмяФормы>/
-            Ext/
-                Form.xml                      # Описание формы
-                Form/
-                    Module.bsl               # Модуль формы
-    Templates/
-        <ИмяМакета>.xml                       # Метаданные макета
-        <ИмяМакета>/
-            Ext/
-                Template.<расш>              # Тело макета
-```
-
-Структура полностью совпадает с EPF. Отчёт может содержать:
-- 0..N реквизитов объекта (описаны в корневом XML)
-- 0..N табличных частей (описаны в корневом XML)
-- 0..N форм (каталог `Forms/`)
-- 0..N макетов (каталог `Templates/`) — включая СКД и MXL-макеты печатных форм
-- 0..1 модуль объекта (`Ext/ObjectModule.bsl`)
-- 0..1 встроенная справка (`Ext/Help.xml` + `Ext/Help/<язык>.html`)
-
-## 2. Корневой файл отчёта (`<Имя>.xml`)
-
-### 2.1. Общая структура
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="..." version="2.17">
-    <ExternalReport uuid="<UUID>">
-        <InternalInfo>
-            <xr:ContainedObject>
-                <xr:ClassId>e41aff26-25cf-4bb6-b6c1-3f478a75f374</xr:ClassId>
-                <xr:ObjectId><UUID></xr:ObjectId>
-            </xr:ContainedObject>
-            <xr:GeneratedType name="ExternalReportObject.<Имя>" category="Object">
-                <xr:TypeId><UUID></xr:TypeId>
-                <xr:ValueId><UUID></xr:ValueId>
-            </xr:GeneratedType>
-        </InternalInfo>
-        <Properties>
-            <Name><Имя></Name>
-            <Synonym>...</Synonym>
-            <Comment/>
-            <DefaultForm/>
-            <AuxiliaryForm/>
-            <MainDataCompositionSchema/>
-            <DefaultSettingsForm/>
-            <AuxiliarySettingsForm/>
-            <DefaultVariantForm/>
-            <VariantsStorage/>
-            <SettingsStorage/>
-        </Properties>
-        <ChildObjects>
-            <!-- Реквизиты объекта (опционально) -->
-            <Attribute uuid="<UUID>">...</Attribute>
-            <!-- Табличные части (опционально) -->
-            <TabularSection uuid="<UUID>">...</TabularSection>
-            <!-- Формы -->
-            <Form><ИмяФормы></Form>
-            <!-- Макеты -->
-            <Template><ИмяМакета></Template>
-        </ChildObjects>
-    </ExternalReport>
-</MetaDataObject>
-```
-
-### 2.2. Отличия от EPF
-
-| Элемент | EPF | ERF |
-|---------|-----|-----|
-| Корневой элемент | `<ExternalDataProcessor>` | `<ExternalReport>` |
-| ClassId | `c3831ec8-d8d5-4f93-8a22-f9bfae07327f` | `e41aff26-25cf-4bb6-b6c1-3f478a75f374` |
-| GeneratedType (Object) | `ExternalDataProcessorObject.<Имя>` | `ExternalReportObject.<Имя>` |
-| GeneratedType (ТЧ) | `DataProcessorTabularSection.<Имя>.<ТЧ>` | `ReportTabularSection.<Имя>.<ТЧ>` |
-| GeneratedType (строка ТЧ) | `DataProcessorTabularSectionRow.<Имя>.<ТЧ>` | `ReportTabularSectionRow.<Имя>.<ТЧ>` |
-| Путь к форме | `ExternalDataProcessor.<Имя>.Form.<Форма>` | `ExternalReport.<Имя>.Form.<Форма>` |
-| Путь к макету | `ExternalDataProcessor.<Имя>.Template.<Макет>` | `ExternalReport.<Имя>.Template.<Макет>` |
-| Тип реквизита формы | `cfg:ExternalDataProcessorObject.<Имя>` | `cfg:ExternalReportObject.<Имя>` |
-
-### 2.3. Свойства (Properties)
-
-Свойства EPF (`Name`, `Synonym`, `Comment`, `DefaultForm`, `AuxiliaryForm`) сохраняются. Добавляются **6 свойств**, специфичных для отчёта:
-
-| Свойство | Описание | Пример значения |
-|----------|----------|-----------------|
-| `MainDataCompositionSchema` | Основная СКД отчёта. Полный путь к макету-СКД | `ExternalReport.<Имя>.Template.ОсновнаяСхемаКомпоновкиДанных` |
-| `DefaultSettingsForm` | Форма настроек отчёта | `ExternalReport.<Имя>.Form.ФормаНастроек` |
-| `AuxiliarySettingsForm` | Дополнительная форма настроек | (обычно пустой) |
-| `DefaultVariantForm` | Форма вариантов отчёта | `ExternalReport.<Имя>.Form.ФормаВарианта` |
-| `VariantsStorage` | Хранилище вариантов отчёта | `SettingsStorage.ХранилищеВариантовОтчетов` |
-| `SettingsStorage` | Хранилище настроек | (обычно пустой) |
-
-**Порядок свойств фиксирован**: Name → Synonym → Comment → DefaultForm → AuxiliaryForm → MainDataCompositionSchema → DefaultSettingsForm → AuxiliarySettingsForm → DefaultVariantForm → VariantsStorage → SettingsStorage.
-
-Если значение отсутствует, элемент остаётся пустым (самозакрывающимся):
-```xml
-<DefaultForm/>
-<MainDataCompositionSchema>ExternalReport.МойОтчёт.Template.ОсновнаяСхемаКомпоновкиДанных</MainDataCompositionSchema>
-<VariantsStorage/>
-```
-
-## 3. Реквизиты объекта (Attribute)
-
-В отличие от EPF (где реквизиты не документированы), внешний отчёт часто имеет реквизиты объекта. Они размещаются в `<ChildObjects>` корневого файла **перед** `<TabularSection>`, `<Form>` и `<Template>`:
-
-```xml
-<Attribute uuid="<UUID>">
-    <Properties>
-        <Name>Реквизит1</Name>
-        <Synonym/>
-        <Comment/>
-        <Type>
-            <v8:Type>xs:string</v8:Type>
-            <v8:StringQualifiers>
-                <v8:Length>10</v8:Length>
-                <v8:AllowedLength>Variable</v8:AllowedLength>
-            </v8:StringQualifiers>
-        </Type>
-        <PasswordMode>false</PasswordMode>
-        <Format/>
-        <EditFormat/>
-        <ToolTip/>
-        <MarkNegatives>false</MarkNegatives>
-        <Mask/>
-        <MultiLine>false</MultiLine>
-        <ExtendedEdit>false</ExtendedEdit>
-        <MinValue xsi:nil="true"/>
-        <MaxValue xsi:nil="true"/>
-        <FillChecking>DontCheck</FillChecking>
-        <ChoiceFoldersAndItems>Items</ChoiceFoldersAndItems>
-        <ChoiceParameterLinks/>
-        <ChoiceParameters/>
-        <QuickChoice>Auto</QuickChoice>
-        <CreateOnInput>Auto</CreateOnInput>
-        <ChoiceForm/>
-        <LinkByType/>
-        <ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>
-    </Properties>
-</Attribute>
-```
-
-### Типы реквизитов
-
-Типы реквизитов объекта аналогичны типам реквизитов форм:
-
-| v8:Type | Описание | Квалификаторы |
-|---------|----------|---------------|
-| `xs:string` | Строка | `v8:StringQualifiers`: `Length`, `AllowedLength` |
-| `xs:boolean` | Булево | — |
-| `xs:decimal` | Число | `v8:NumberQualifiers`: `Digits`, `FractionDigits`, `AllowedSign` |
-| `xs:dateTime` | Дата | `v8:DateQualifiers`: `DateFractions` |
-| `cfg:CatalogRef.<Имя>` | Ссылка на справочник | — |
-| `cfg:DocumentRef.<Имя>` | Ссылка на документ | — |
-| `cfg:EnumRef.<Имя>` | Ссылка на перечисление | — |
-
-> **Примечание**: Ссылочные типы (`cfg:CatalogRef.*` и т.д.) в контексте внешнего отчёта работают **только** при наличии в информационной базе конфигурации с соответствующими объектами.
-
-### Свойства реквизита объекта (полный перечень)
-
-Порядок фиксирован:
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `Name` | string | Имя реквизита |
-| `Synonym` | LocalString | Синоним (отображаемое имя) |
-| `Comment` | string | Комментарий |
-| `Type` | TypeDescription | Тип данных (см. таблицу типов выше) |
-| `PasswordMode` | boolean | Режим пароля (`false`) |
-| `Format` | string | Формат вывода |
-| `EditFormat` | string | Формат редактирования |
-| `ToolTip` | LocalString | Подсказка |
-| `MarkNegatives` | boolean | Выделять отрицательные (`false`) |
-| `Mask` | string | Маска ввода |
-| `MultiLine` | boolean | Многострочный (`false`) |
-| `ExtendedEdit` | boolean | Расширенное редактирование (`false`) |
-| `MinValue` | any | Минимальное значение (`xsi:nil="true"`) |
-| `MaxValue` | any | Максимальное значение (`xsi:nil="true"`) |
-| `FillChecking` | enum | Проверка заполнения (`DontCheck`) |
-| `ChoiceFoldersAndItems` | enum | Выбор групп и элементов (`Items`) |
-| `ChoiceParameterLinks` | list | Связи параметров выбора |
-| `ChoiceParameters` | list | Параметры выбора |
-| `QuickChoice` | enum | Быстрый выбор (`Auto`) |
-| `CreateOnInput` | enum | Создание при вводе (`Auto`) |
-| `ChoiceForm` | string | Форма выбора |
-| `LinkByType` | ref | Связь по типу |
-| `ChoiceHistoryOnInput` | enum | История выбора при вводе (`Auto`) |
-
-## 4. Табличные части (TabularSection)
-
-Структура полностью аналогична EPF, отличаются только имена GeneratedType:
-
-```xml
-<TabularSection uuid="<UUID>">
-    <InternalInfo>
-        <xr:GeneratedType name="ReportTabularSection.<ИмяОтчёта>.<ИмяТЧ>" category="TabularSection">
-            <xr:TypeId><UUID></xr:TypeId>
-            <xr:ValueId><UUID></xr:ValueId>
-        </xr:GeneratedType>
-        <xr:GeneratedType name="ReportTabularSectionRow.<ИмяОтчёта>.<ИмяТЧ>" category="TabularSectionRow">
-            <xr:TypeId><UUID></xr:TypeId>
-            <xr:ValueId><UUID></xr:ValueId>
-        </xr:GeneratedType>
-    </InternalInfo>
-    <Properties>
-        <Name><ИмяТЧ></Name>
-        <Synonym/>
-        <Comment/>
-        <ToolTip/>
-        <FillChecking>DontCheck</FillChecking>
-    </Properties>
-    <ChildObjects>
-        <Attribute uuid="<UUID>">
-            <Properties>
-                <!-- Те же свойства, что у реквизитов объекта, -->
-                <!-- плюс два дополнительных: -->
-                <FillFromFillingValue>false</FillFromFillingValue>
-                <FillValue xsi:nil="true"/>
-                <!-- ... остальные совпадают -->
-            </Properties>
-        </Attribute>
-    </ChildObjects>
-</TabularSection>
-```
-
-**Важно**: Реквизиты табличной части имеют 2 дополнительных свойства по сравнению с реквизитами объекта:
-- `FillFromFillingValue` — заполнять из значения заполнения (`false`)
-- `FillValue` — значение заполнения (`xsi:nil="true"` или `xsi:type="xs:string"` и т.д.)
-
-Эти свойства вставляются между `MaxValue` и `FillChecking`.
-
-## 5. Порядок элементов в ChildObjects
-
-Порядок дочерних объектов **фиксирован**:
-
-1. `<Attribute>` — реквизиты объекта (0..N)
-2. `<TabularSection>` — табличные части (0..N)
-3. `<Form>` — формы (0..N)
-4. `<Template>` — макеты (0..N)
-
-## 6. Формы отчёта
-
-### 6.1. Метаданные формы (`Forms/<Имя>.xml`)
-
-Формат метаданных формы полностью совпадает с EPF — см. [спецификацию EPF, раздел 4](1c-epf-spec.md).
-
-### 6.2. Специфика Form.xml для отчётов
-
-Формы отчёта имеют дополнительные свойства в `<Form>`, которых нет у форм обработки:
-
-| Свойство | Описание | Допустимые значения |
-|----------|----------|---------------------|
-| `ReportFormType` | Тип формы отчёта | `Main`, `Settings`, `Variant` |
-| `ReportResult` | Имя реквизита-результата | Имя реквизита типа SpreadsheetDocument |
-| `DetailsData` | Имя реквизита данных расшифровки | Имя строкового реквизита |
-| `CustomSettingsFolder` | Группа пользовательских настроек | Имя элемента UsualGroup на форме |
-
-Эти свойства размещаются в начале `<Form>`, после `<CommandBarLocation>` и до `<AutoCommandBar>`.
-
-### 6.3. Основная форма отчёта (ReportFormType = Main)
-
-Форма для отображения результата отчёта.
-
-```xml
-<Form xmlns="http://v8.1c.ru/8.3/xcf/logform" ... version="2.17">
-    <CommandBarLocation>None</CommandBarLocation>
-    <ReportResult>Результат</ReportResult>
-    <DetailsData>ДанныеРасшифровки</DetailsData>
-    <ReportFormType>Main</ReportFormType>
-    <CustomSettingsFolder>КомпоновщикНастроекПользовательскиеНастройки</CustomSettingsFolder>
-    <AutoCommandBar name="" id="-1">
-        <Autofill>false</Autofill>
-    </AutoCommandBar>
-    <ChildItems>
-        <CommandBar name="ОсновнаяКоманднаяПанель" id="1">
-            <Title>...</Title>
-            <CommandSource>Form</CommandSource>
-            <ExtendedTooltip name="ОсновнаяКоманднаяПанельРасширеннаяПодсказка" id="2"/>
-        </CommandBar>
-        <UsualGroup name="КомпоновщикНастроекПользовательскиеНастройки" id="3">
-            <Title>...</Title>
-            <VerticalStretch>false</VerticalStretch>
-            <Group>Vertical</Group>
-            <ShowTitle>false</ShowTitle>
-            <ExtendedTooltip name="КомпоновщикНастроекПользовательскиеНастройкиРасширеннаяПодсказка" id="4"/>
-        </UsualGroup>
-        <SpreadSheetDocumentField name="Результат" id="5">
-            <DataPath>Результат</DataPath>
-            <DefaultItem>true</DefaultItem>
-            <TitleLocation>None</TitleLocation>
-            <Width>100</Width>
-            <ContextMenu name="РезультатКонтекстноеМеню" id="6"/>
-            <ExtendedTooltip name="РезультатРасширеннаяПодсказка" id="7"/>
-        </SpreadSheetDocumentField>
-    </ChildItems>
-    <Attributes>
-        <Attribute name="Отчет" id="1">
-            <Type>
-                <v8:Type>cfg:ExternalReportObject.<ИмяОтчёта></v8:Type>
-            </Type>
-            <MainAttribute>true</MainAttribute>
-        </Attribute>
-        <Attribute name="Результат" id="2">
-            <Title>...</Title>
-            <Type>
-                <v8:Type xmlns:mxl="http://v8.1c.ru/8.2/data/spreadsheet">mxl:SpreadsheetDocument</v8:Type>
-            </Type>
-        </Attribute>
-        <Attribute name="ДанныеРасшифровки" id="3">
-            <Type>
-                <v8:Type>xs:string</v8:Type>
-                <v8:StringQualifiers>
-                    <v8:Length>0</v8:Length>
-                    <v8:AllowedLength>Variable</v8:AllowedLength>
-                </v8:StringQualifiers>
-            </Type>
-        </Attribute>
-    </Attributes>
-</Form>
-```
-
-**Ключевые элементы основной формы отчёта:**
-
-| Элемент | Описание |
-|---------|----------|
-| `SpreadSheetDocumentField` | Поле табличного документа для вывода результата. Привязано к реквизиту типа `mxl:SpreadsheetDocument` |
-| Реквизит `Отчет` | Основной реквизит (`MainAttribute=true`), тип `cfg:ExternalReportObject.<Имя>` |
-| Реквизит `Результат` | Табличный документ. Тип `mxl:SpreadsheetDocument` (требует дополнительный namespace `xmlns:mxl`) |
-| Реквизит `ДанныеРасшифровки` | Строка неограниченной длины для данных расшифровки |
-| Группа `КомпоновщикНастроекПользовательскиеНастройки` | Контейнер для пользовательских настроек СКД |
-
-### 6.4. Форма настроек (ReportFormType = Settings)
-
-Форма настроек отчёта для пользователя.
-
-```xml
-<Form xmlns="http://v8.1c.ru/8.3/xcf/logform" ... version="2.17">
-    <CommandBarLocation>Bottom</CommandBarLocation>
-    <VerticalScroll>useIfNecessary</VerticalScroll>
-    <ReportFormType>Settings</ReportFormType>
-    <CustomSettingsFolder>КомпоновщикНастроекПользовательскиеНастройки</CustomSettingsFolder>
-    <AutoCommandBar name="" id="-1">
-        <HorizontalAlign>Right</HorizontalAlign>
-    </AutoCommandBar>
-    <ChildItems>
-        <UsualGroup name="КомпоновщикНастроекПользовательскиеНастройки" id="1">
-            <Title>...</Title>
-            <Group>Vertical</Group>
-            <Representation>None</Representation>
-            <ShowTitle>false</ShowTitle>
-            <ExtendedTooltip name="КомпоновщикНастроекПользовательскиеНастройкиРасширеннаяПодсказка" id="2"/>
-        </UsualGroup>
-    </ChildItems>
-    <Attributes>
-        <Attribute name="Отчет" id="1">
-            <Type>
-                <v8:Type>cfg:ExternalReportObject.<ИмяОтчёта></v8:Type>
-            </Type>
-            <MainAttribute>true</MainAttribute>
-        </Attribute>
-    </Attributes>
-</Form>
-```
-
-### 6.5. Форма варианта (ReportFormType = Variant)
-
-Форма для настройки варианта отчёта (структуры, группировок, фильтров).
-
-```xml
-<Form xmlns="http://v8.1c.ru/8.3/xcf/logform" ... version="2.17">
-    <CommandBarLocation>Bottom</CommandBarLocation>
-    <CollapseItemsByImportanceVariant>DontUse</CollapseItemsByImportanceVariant>
-    <ReportFormType>Variant</ReportFormType>
-    <AutoCommandBar name="" id="-1">
-        <HorizontalAlign>Right</HorizontalAlign>
-    </AutoCommandBar>
-    <ChildItems>
-        <Table name="КомпоновщикНастроекНастройки" id="1">
-            <Representation>Tree</Representation>
-            <DataPath>Отчет.SettingsComposer.Settings</DataPath>
-            <!-- ... элементы управления деревом настроек -->
-        </Table>
-        <!-- Страницы настроек (параметры, поля, фильтры и т.д.) -->
-    </ChildItems>
-    <!-- ... -->
-</Form>
-```
-
-Форма варианта обычно содержит сложную структуру с деревом настроек (`Table` с `Representation=Tree` и `DataPath=Отчет.SettingsComposer.Settings`) и множеством страниц для редактирования параметров, полей, фильтров, сортировки и условного оформления.
-
-### 6.6. Элемент SpreadSheetDocumentField
-
-Специфичный для отчётов элемент формы — поле табличного документа. Используется для отображения результата отчёта.
-
-```xml
-<SpreadSheetDocumentField name="Результат" id="5">
-    <DataPath>Результат</DataPath>
-    <DefaultItem>true</DefaultItem>
-    <TitleLocation>None</TitleLocation>
-    <Width>100</Width>
-    <ContextMenu name="РезультатКонтекстноеМеню" id="6"/>
-    <ExtendedTooltip name="РезультатРасширеннаяПодсказка" id="7"/>
-</SpreadSheetDocumentField>
-```
-
-| Свойство | Описание |
-|----------|----------|
-| `DataPath` | Путь к реквизиту типа SpreadsheetDocument |
-| `DefaultItem` | Элемент по умолчанию (`true`) |
-| `TitleLocation` | Расположение заголовка (`None`) |
-| `Width` | Ширина в символах |
-
-## 7. Модуль объекта
-
-### 7.1. Событие ПриКомпоновкеРезультата
-
-Основное событие модуля объекта отчёта. Вызывается платформой при формировании результата. Позволяет перехватить стандартную обработку СКД.
-
-```bsl
-Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
-    // СтандартнаяОбработка = Ложь; // отключить стандартное формирование по СКД
-    // Собственная логика формирования отчёта
-КонецПроцедуры
-```
-
-Параметры:
-- `ДокументРезультат` — табличный документ для вывода результата
-- `ДанныеРасшифровки` — данные расшифровки
-- `СтандартнаяОбработка` — если установить `Ложь`, платформа не будет сама формировать отчёт по СКД
-
-### 7.2. Директива условной компиляции
-
-В ERP-отчётах модуль объекта часто обёрнут в директиву условной компиляции:
-
-```bsl
-#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда
-
-// ... весь код модуля ...
-
-#КонецЕсли
-```
-
-### 7.3. Типичные процедуры модуля объекта отчёта
-
-| Процедура | Описание |
-|-----------|----------|
-| `ПриКомпоновкеРезультата` | Событие формирования результата |
-| `ИнициализироватьОтчет` | Инициализация отчёта (экспорт, для БСП) |
-| `ОпределитьНастройкиФормы` | Определение настроек формы (экспорт, для БСП) |
-| `ПередЗагрузкойНастроекВКомпоновщик` | Предобработка настроек (экспорт, для БСП) |
-
-## 8. Макеты (Templates)
-
-### 8.1. СКД-макет (DataCompositionSchema)
-
-Основной макет отчёта. Обязателен, если указан `MainDataCompositionSchema`.
-
-```xml
-<!-- Метаданные: Templates/ОсновнаяСхемаКомпоновкиДанных.xml -->
-<Template uuid="<UUID>">
-    <Properties>
-        <Name>ОсновнаяСхемаКомпоновкиДанных</Name>
-        <Synonym>...</Synonym>
-        <Comment/>
-        <TemplateType>DataCompositionSchema</TemplateType>
-    </Properties>
-</Template>
-```
-
-Тело СКД: `Templates/ОсновнаяСхемаКомпоновкиДанных/Ext/Template.xml` — формат описан в [спецификации СКД](1c-dcs-spec.md).
-
-### 8.2. MXL-макеты печатных форм (SpreadsheetDocument)
-
-Отчёты часто содержат MXL-макеты для вывода печатных форм.
-
-```xml
-<!-- Метаданные: Templates/ПФ_MXL_КарточкаУчета.xml -->
-<Template uuid="<UUID>">
-    <Properties>
-        <Name>ПФ_MXL_КарточкаУчета</Name>
-        <Synonym>...</Synonym>
-        <Comment/>
-        <TemplateType>SpreadsheetDocument</TemplateType>
-    </Properties>
-</Template>
-```
-
-Тело макета: `Templates/ПФ_MXL_КарточкаУчета/Ext/Template.xml` — формат MXL.
-
-Конвенция именования MXL-макетов: `ПФ_MXL_<НазваниеПечатнойФормы>`.
-
-## 9. Сравнение с отчётом конфигурации (Report)
-
-| Аспект | ExternalReport (ERF) | Report (в конфигурации) |
-|--------|---------------------|------------------------|
-| Корневой элемент | `<ExternalReport>` | `<Report>` |
-| ClassId | `e41aff26-25cf-4bb6-b6c1-3f478a75f374` | (нет ContainedObject) |
-| GeneratedType (Object) | `ExternalReportObject.<Имя>` | `ReportObject.<Имя>` |
-| GeneratedType (Manager) | — | `ReportManager.<Имя>` |
-| Тип реквизита формы | `cfg:ExternalReportObject.<Имя>` | `cfg:ReportObject.<Имя>` |
-| Дополнительные свойства | — | `UseStandardCommands`, `IncludeHelpInContents`, `ExtendedPresentation`, `Explanation` |
-| Формы по умолчанию | Могут ссылаться на свои формы | Могут ссылаться на `CommonForm.*` |
-| Хранение | Файл `.erf` | В составе конфигурации |
-
-## 10. Минимальный пример
-
-### Пустой отчёт (без СКД, форм, модулей)
-
-```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">
-    <ExternalReport uuid="b38bc179-9b8a-4eb3-9422-96c6eded1ac3">
-        <InternalInfo>
-            <xr:ContainedObject>
-                <xr:ClassId>e41aff26-25cf-4bb6-b6c1-3f478a75f374</xr:ClassId>
-                <xr:ObjectId>38f084a4-47ce-4e67-ab4b-ac6323b9da08</xr:ObjectId>
-            </xr:ContainedObject>
-            <xr:GeneratedType name="ExternalReportObject.МойОтчёт" category="Object">
-                <xr:TypeId>1fd37c7e-ade2-47ac-8dae-3fafeec96943</xr:TypeId>
-                <xr:ValueId>b85e1756-f044-4907-b4bd-75a57649c486</xr:ValueId>
-            </xr:GeneratedType>
-        </InternalInfo>
-        <Properties>
-            <Name>МойОтчёт</Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content>Мой отчёт</v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-            <DefaultForm/>
-            <AuxiliaryForm/>
-            <MainDataCompositionSchema/>
-            <DefaultSettingsForm/>
-            <AuxiliarySettingsForm/>
-            <DefaultVariantForm/>
-            <VariantsStorage/>
-            <SettingsStorage/>
-        </Properties>
-        <ChildObjects/>
-    </ExternalReport>
-</MetaDataObject>
-```
-
-### Отчёт с СКД
-
-Добавляется ссылка на СКД в `MainDataCompositionSchema` и макет-СКД в `ChildObjects`:
-
-```xml
-<Properties>
-    ...
-    <MainDataCompositionSchema>ExternalReport.МойОтчёт.Template.ОсновнаяСхемаКомпоновкиДанных</MainDataCompositionSchema>
-    ...
-</Properties>
-<ChildObjects>
-    <Template>ОсновнаяСхемаКомпоновкиДанных</Template>
-</ChildObjects>
-```
-
-Плюс файлы:
-- `Templates/ОсновнаяСхемаКомпоновкиДанных.xml` (метаданные, `TemplateType=DataCompositionSchema`)
-- `Templates/ОсновнаяСхемаКомпоновкиДанных/Ext/Template.xml` (тело СКД)
-
-## 11. Чеклист для создания внешнего отчёта
-
-1. Сгенерировать UUID для каждого объекта (отчёт, реквизиты, ТЧ, формы, макеты)
-2. Создать структуру каталогов (раздел 1)
-3. Создать корневой XML (раздел 2) с:
-   - `ClassId = e41aff26-25cf-4bb6-b6c1-3f478a75f374`
-   - `GeneratedType name="ExternalReportObject.<Имя>"`
-   - Корректными путями в `MainDataCompositionSchema`, `DefaultForm` и др.
-   - Правильным порядком элементов в `ChildObjects`
-4. Создать СКД-макет (раздел 8.1):
-   - Метаданные с `TemplateType=DataCompositionSchema`
-   - Тело СКД по [спецификации СКД](1c-dcs-spec.md)
-5. При необходимости создать формы (раздел 6):
-   - Указать `ReportFormType` (`Main` / `Settings` / `Variant`)
-   - Основная форма: `ReportResult`, `DetailsData`, `SpreadSheetDocumentField`
-   - Основной реквизит: `cfg:ExternalReportObject.<Имя>`
-6. При необходимости создать `ObjectModule.bsl` (раздел 7)
-7. При необходимости создать MXL-макеты печатных форм (раздел 8.2)
-8. Проверить:
-   - Все пути используют префикс `ExternalReport.<Имя>` (не `ExternalDataProcessor`)
-   - Тип основного реквизита формы: `cfg:ExternalReportObject.<Имя>`
-   - `MainDataCompositionSchema` соответствует реальному макету в `ChildObjects`
-   - Порядок в `ChildObjects`: Attribute → TabularSection → Form → Template
-   - Все UUID уникальны

docs/1c-help-spec.md

@@ -1,151 +0,0 @@
-# Встроенная справка внешней обработки 1С
-
-Спецификация добавления встроенной справки (Help) к внешней обработке (EPF) в формате XML-выгрузки версии 2.17.
-
-## 1. Структура файлов
-
-```
-<ИмяОбработки>/
-    Ext/
-        Help.xml                    # Метаданные справки (обязательно)
-        Help/
-            ru.html                 # HTML-страница справки на русском языке
-```
-
-Справка **не регистрируется** в `ChildObjects` корневого XML обработки — достаточно наличия файлов `Help.xml` и `Help/<язык>.html` в каталоге `Ext/`.
-
-## 2. Help.xml — метаданные справки
-
-Пространство имён: `http://v8.1c.ru/8.3/xcf/extrnprops` (то же, что у Template.xml).
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<Help xmlns="http://v8.1c.ru/8.3/xcf/extrnprops"
-      xmlns:xs="http://www.w3.org/2001/XMLSchema"
-      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-      version="2.17">
-    <Page>ru</Page>
-</Help>
-```
-
-Элемент `<Page>` указывает код языка. Имя файла страницы: `<код_языка>.html`. Может быть несколько элементов `<Page>` для разных языков.
-
-## 3. HTML-страница справки
-
-Формат: HTML 4.0 Transitional, кодировка UTF-8.
-
-### Минимальный шаблон
-
-```html
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-    <link rel="stylesheet" type="text/css" href="v8help://service_book/service_style"/>
-</head>
-<body>
-    Содержимое справки
-</body>
-</html>
-```
-
-### Обязательные элементы head
-
-| Элемент | Назначение |
-|---------|------------|
-| `<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>` | Кодировка UTF-8 |
-| `<link rel="stylesheet" type="text/css" href="v8help://service_book/service_style"/>` | Стили справки 1С (протокол `v8help://`) |
-
-### Поддерживаемая разметка
-
-Стандартный HTML 4.0: `<h1>`..`<h4>`, `<p>`, `<ul>`, `<ol>`, `<li>`, `<table>`, `<strong>`, `<em>`, `<a>`, `<br>`, `<pre>` и др. Стили 1С автоматически форматируют заголовки и абзацы.
-
-## 4. Метаданные формы — IncludeHelpInContents
-
-В файле метаданных формы (`Forms/<ИмяФормы>.xml`) должен быть элемент:
-
-```xml
-<IncludeHelpInContents>false</IncludeHelpInContents>
-```
-
-Полный контекст в файле формы:
-
-```xml
-<Form uuid="...">
-    <Properties>
-        <Name>ОсновнаяФорма</Name>
-        ...
-        <FormType>Managed</FormType>
-        <IncludeHelpInContents>false</IncludeHelpInContents>
-        <UsePurposes>...</UsePurposes>
-        <ExtendedPresentation/>
-    </Properties>
-</Form>
-```
-
-Значение `false` — справка не включается в общее оглавление справочной системы (стандартное поведение для внешних обработок).
-
-## 5. Кнопка вызова справки на форме
-
-Для вызова справки используется стандартная команда платформы `Form.StandardCommand.Help`.
-
-### Вариант А: кнопка в AutoCommandBar формы
-
-Простейший способ — добавить кнопку в автокомандную панель формы (`id="-1"`):
-
-```xml
-<AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
-    <Autofill>false</Autofill>
-    <ChildItems>
-        <Button name="ФормаСправка" id="<свободный_id>">
-            <Type>CommandBarButton</Type>
-            <CommandName>Form.StandardCommand.Help</CommandName>
-            <ExtendedTooltip name="ФормаСправкаExtendedTooltip" id="<свободный_id>"/>
-        </Button>
-    </ChildItems>
-</AutoCommandBar>
-```
-
-Кнопка появится на автокомандной панели формы (верхняя строка). Подходит для простых форм.
-
-### Вариант Б: кнопка в пользовательской CommandBar
-
-Если форма не использует AutoCommandBar (задан `Autofill=false`, панель скрыта или пуста), кнопку справки можно разместить в произвольной `<CommandBar>` группе среди других пользовательских кнопок:
-
-```xml
-<CommandBar name="МояКоманднаяПанель" id="...">
-    <Autofill>false</Autofill>
-    <HorizontalStretch>false</HorizontalStretch>
-    <ExtendedTooltip name="МояКоманднаяПанельExtendedTooltip" id="..."/>
-    <ChildItems>
-        <!-- Другие кнопки -->
-        <Button name="КнопкаДействие" id="...">
-            <Type>CommandBarButton</Type>
-            <CommandName>Form.Command.МояКоманда</CommandName>
-            ...
-        </Button>
-        <!-- Кнопка справки -->
-        <Button name="ФормаСправка" id="<свободный_id>">
-            <Type>CommandBarButton</Type>
-            <CommandName>Form.StandardCommand.Help</CommandName>
-            <ExtendedTooltip name="ФормаСправкаExtendedTooltip" id="<свободный_id>"/>
-        </Button>
-    </ChildItems>
-</CommandBar>
-```
-
-Для стандартной команды `Help` не нужно объявлять элемент в секции `<Commands>` — платформа предоставляет её автоматически.
-
-### Важно
-
-- `<Type>CommandBarButton</Type>` — кнопка должна быть типа CommandBarButton (внутри `<CommandBar>`)
-- Никакого обработчика в Module.bsl не требуется — `Form.StandardCommand.Help` обрабатывается платформой
-- Платформа сама найдёт `Help.xml` и откроет соответствующую HTML-страницу
-
-## 6. Чек-лист добавления справки
-
-1. Создать `<ИмяОбработки>/Ext/Help.xml` с указанием языка (`<Page>ru</Page>`)
-2. Создать `<ИмяОбработки>/Ext/Help/ru.html` с содержимым справки
-3. Убедиться что в `Forms/<ИмяФормы>.xml` есть `<IncludeHelpInContents>false</IncludeHelpInContents>`
-4. Добавить кнопку `Form.StandardCommand.Help` в CommandBar или AutoCommandBar формы
-5. Собрать EPF — проверить что справка открывается по кнопке

docs/1c-role-spec.md

@@ -1,845 +0,0 @@
-# Спецификация формата ролей 1С:Предприятия 8.3
-
-Полное описание XML-формата ролей в выгрузке конфигурации. Версии формата: 2.17 (платформа 8.3.20–8.3.24), 2.20 (8.3.27+). Структура идентична, отличается только атрибут `version`.
-
-## Файловая структура
-
-Каждая роль состоит из двух файлов:
-
-```
-Roles/
-  ИмяРоли.xml                    ← метаданные (uuid, имя, синоним)
-  ИмяРоли/
-    Ext/
-      Rights.xml                  ← определение прав
-```
-
-## Регистрация роли в конфигурации
-
-При создании роли необходимо прописать ссылки в следующих местах:
-
-### Configuration.xml — ChildObjects
-
-Регистрация объекта в составе конфигурации:
-
-```xml
-<ChildObjects>
-    ...
-    <Role>ИмяРоли</Role>
-    ...
-</ChildObjects>
-```
-
-Элементы `<Role>` располагаются среди других объектов конфигурации в секции `<ChildObjects>`.
-
-### Configuration.xml — DefaultRoles (опционально)
-
-Если роль должна назначаться новым пользователям по умолчанию:
-
-```xml
-<DefaultRoles>
-    <xr:Item xsi:type="xr:MDObjectRef">Role.ИмяРоли</xr:Item>
-</DefaultRoles>
-```
-
-### Form.xml — права редактирования реквизитов (опционально)
-
-В формах роль может упоминаться для ограничения редактирования реквизитов:
-
-```xml
-<Attribute>
-    <Edit>
-        <xr:Common>false</xr:Common>
-        <xr:Value name="Role.ИмяРоли">true</xr:Value>
-    </Edit>
-</Attribute>
-```
-
----
-
-## Файл метаданных: Roles/ИмяРоли.xml
-
-```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">
-    <Role uuid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">
-        <Properties>
-            <Name>ИмяРоли</Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content>Отображаемое имя роли</v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-        </Properties>
-    </Role>
-</MetaDataObject>
-```
-
-### Элементы
-
-| Элемент | Обязательный | Описание |
-|---------|:------------:|----------|
-| `Role/@uuid` | да | UUID роли (формат `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`) |
-| `Name` | да | Программное имя роли (идентификатор, латиница/кириллица) |
-| `Synonym` | да | Мультиязычное отображаемое имя (один или несколько `v8:item`) |
-| `Comment` | да | Комментарий (может быть пустым `<Comment/>`) |
-
-### Namespace
-
-Основной: `http://v8.1c.ru/8.3/MDClasses`
-Мультиязычные строки: `v8` = `http://v8.1c.ru/8.1/data/core`
-
----
-
-## Файл прав: Roles/ИмяРоли/Ext/Rights.xml
-
-### Корневой элемент
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<Rights xmlns="http://v8.1c.ru/8.2/roles"
-        xmlns:xs="http://www.w3.org/2001/XMLSchema"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:type="Rights"
-        version="2.17">
-    <setForNewObjects>false</setForNewObjects>
-    <setForAttributesByDefault>true</setForAttributesByDefault>
-    <independentRightsOfChildObjects>false</independentRightsOfChildObjects>
-
-    <object>...</object>
-    ...
-
-    <restrictionTemplate>...</restrictionTemplate>
-    ...
-</Rights>
-```
-
-### Namespace
-
-`http://v8.1c.ru/8.2/roles` (NB: 8.2, а не 8.3 — исторически)
-
-### Глобальные флаги
-
-| Флаг | Тип | По умолчанию | Описание |
-|------|-----|:------------:|----------|
-| `setForNewObjects` | boolean | false | Устанавливать права для новых объектов конфигурации |
-| `setForAttributesByDefault` | boolean | true | Устанавливать права для реквизитов по умолчанию |
-| `independentRightsOfChildObjects` | boolean | false | Независимые права подчинённых объектов |
-
-### Структура блока `<object>`
-
-```xml
-<object>
-    <name>ТипОбъекта.ИмяОбъекта</name>
-    <right>
-        <name>ИмяПрава</name>
-        <value>true</value>
-    </right>
-    <right>
-        <name>ИмяПрава</name>
-        <value>true</value>
-        <restrictionByCondition>
-            <condition>Текст условия RLS</condition>
-        </restrictionByCondition>
-    </right>
-</object>
-```
-
-| Элемент | Обязательный | Описание |
-|---------|:------------:|----------|
-| `object/name` | да | Полное имя объекта метаданных (dot-нотация) |
-| `right/name` | да | Имя права (см. таблицы ниже) |
-| `right/value` | да | `true` или `false` |
-| `right/restrictionByCondition` | нет | Ограничение на уровне записей (RLS) |
-| `restrictionByCondition/condition` | да | Текст условия на языке шаблонов ограничений |
-
-### Именование объектов (dot-нотация)
-
-Объекты адресуются иерархически через точку:
-
-```
-ТипОбъекта.ИмяОбъекта[.ТипВложенного[.ИмяВложенного[...]]]
-```
-
-#### Верхний уровень — объекты метаданных
-
-```
-Catalog.Контрагенты
-Document.РеализацияТоваровУслуг
-InformationRegister.ЦеныНоменклатуры
-DataProcessor.ЗагрузкаДанных
-Report.АнализПродаж
-Configuration.ИмяКонфигурации
-```
-
-#### Стандартные реквизиты
-
-```
-Catalog.Контрагенты.StandardAttribute.Code
-Catalog.Контрагенты.StandardAttribute.Description
-Catalog.Контрагенты.StandardAttribute.DeletionMark
-Catalog.Контрагенты.StandardAttribute.Predefined
-Catalog.Контрагенты.StandardAttribute.PredefinedDataName
-Catalog.Контрагенты.StandardAttribute.Ref
-Catalog.Контрагенты.StandardAttribute.IsFolder
-Catalog.Контрагенты.StandardAttribute.Parent
-Catalog.Контрагенты.StandardAttribute.Owner
-Document.Реализация.StandardAttribute.Posted
-Document.Реализация.StandardAttribute.Date
-Document.Реализация.StandardAttribute.Number
-```
-
-#### Реквизиты
-
-```
-Catalog.Контрагенты.Attribute.ИНН
-Document.Реализация.Attribute.Организация
-```
-
-#### Табличные части и их реквизиты
-
-```
-Document.Реализация.TabularSection.Товары
-Document.Реализация.TabularSection.Товары.Attribute.Номенклатура
-Document.Реализация.TabularSection.Товары.StandardAttribute.LineNumber
-```
-
-#### Измерения, ресурсы, реквизиты регистров
-
-```
-InformationRegister.Цены.Dimension.Номенклатура
-InformationRegister.Цены.Resource.Цена
-AccumulationRegister.Остатки.Attribute.ДатаОперации
-AccountingRegister.Хозрасчетный.Dimension.Организация
-```
-
-#### Команды
-
-```
-Catalog.Контрагенты.Command.ОткрытьКарточку
-DataProcessor.Обработка.Command.Выполнить
-CommonCommand.УправлениеОборудованием
-```
-
-#### Реквизиты адресации (бизнес-процессы/задачи)
-
-```
-Task.ЗадачаИсполнителя.AddressingAttribute.Исполнитель
-Task.ЗадачаИсполнителя.AddressingAttribute.ОсновнойОбъектАдресации
-```
-
-#### Операции веб-сервисов
-
-```
-WebService.Exchange.Operation.GetIBParameters
-HTTPService.ЭДО.URLTemplate.Документы.Method.POST
-```
-
-#### Вложенные подсистемы
-
-```
-Subsystem.Администрирование.Subsystem.Пользователи
-```
-
----
-
-## Полный каталог прав по типам объектов
-
-### Права объектов верхнего уровня
-
-#### Configuration
-
-Права конфигурации в целом. Объект: `Configuration.ИмяКонфигурации`.
-
-| Право | Описание |
-|-------|----------|
-| `Administration` | Администрирование |
-| `DataAdministration` | Администрирование данных |
-| `UpdateDataBaseConfiguration` | Обновление конфигурации БД |
-| `ConfigurationExtensionsAdministration` | Администрирование расширений |
-| `ActiveUsers` | Активные пользователи |
-| `EventLog` | Журнал регистрации |
-| `ExclusiveMode` | Монопольный режим |
-| `ThinClient` | Тонкий клиент |
-| `ThickClient` | Толстый клиент |
-| `WebClient` | Веб-клиент |
-| `MobileClient` | Мобильный клиент |
-| `ExternalConnection` | Внешнее соединение |
-| `Automation` | Automation (COM) |
-| `Output` | Вывод (печать, сохранение, копирование) |
-| `SaveUserData` | Сохранение данных пользователя |
-| `TechnicalSpecialistMode` | Режим технического специалиста |
-| `InteractiveOpenExtDataProcessors` | Интерактивное открытие внешних обработок |
-| `InteractiveOpenExtReports` | Интерактивное открытие внешних отчётов |
-| `AnalyticsSystemClient` | Клиент системы аналитики |
-| `CollaborationSystemInfoBaseRegistration` | Регистрация ИБ в системе взаимодействия |
-| `MainWindowModeNormal` | Режим обычного окна |
-| `MainWindowModeWorkplace` | Режим рабочего места |
-| `MainWindowModeEmbeddedWorkplace` | Режим встроенного рабочего места |
-| `MainWindowModeFullscreenWorkplace` | Режим полноэкранного рабочего места |
-| `MainWindowModeKiosk` | Режим киоска |
-
-#### Catalog
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Интерактивная пометка удаления |
-| `InteractiveClearDeletionMark` | Интерактивное снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveDeleteMarked` | Интерактивное удаление помеченных |
-| `InteractiveDeletePredefinedData` | Интерактивное удаление предопределённых |
-| `InteractiveSetDeletionMarkPredefinedData` | Пометка удаления предопределённых |
-| `InteractiveClearDeletionMarkPredefinedData` | Снятие пометки удаления предопределённых |
-| `InteractiveDeleteMarkedPredefinedData` | Удаление помеченных предопределённых |
-| `ReadDataHistory` | Чтение истории данных |
-| `ViewDataHistory` | Просмотр истории данных |
-| `UpdateDataHistory` | Обновление истории данных |
-| `UpdateDataHistoryOfMissingData` | Обновление истории отсутствующих данных |
-| `ReadDataHistoryOfMissingData` | Чтение истории отсутствующих данных |
-| `UpdateDataHistorySettings` | Обновление настроек истории данных |
-| `UpdateDataHistoryVersionComment` | Обновление комментария версии |
-| `EditDataHistoryVersionComment` | Редактирование комментария версии |
-| `SwitchToDataHistoryVersion` | Переход к версии истории данных |
-
-#### Document
-
-Все права Catalog (кроме предопределённых) плюс:
-
-| Право | Описание |
-|-------|----------|
-| `Posting` | Проведение |
-| `UndoPosting` | Отмена проведения |
-| `InteractivePosting` | Интерактивное проведение |
-| `InteractivePostingRegular` | Интерактивное проведение (неоперативное) |
-| `InteractiveUndoPosting` | Интерактивная отмена проведения |
-| `InteractiveChangeOfPosted` | Интерактивное изменение проведённых |
-
-#### InformationRegister
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Update` | Изменение |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `TotalsControl` | Управление итогами (для периодических) |
-| `ReadDataHistory` | Чтение истории данных |
-| `ViewDataHistory` | Просмотр истории данных |
-| `UpdateDataHistory` | Обновление истории данных |
-| `UpdateDataHistoryOfMissingData` | Обновление истории отсутствующих данных |
-| `ReadDataHistoryOfMissingData` | Чтение истории отсутствующих данных |
-| `UpdateDataHistorySettings` | Настройки истории данных |
-| `UpdateDataHistoryVersionComment` | Обновление комментария версии |
-| `EditDataHistoryVersionComment` | Редактирование комментария версии |
-| `SwitchToDataHistoryVersion` | Переход к версии |
-
-#### AccumulationRegister
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Update` | Изменение |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `TotalsControl` | Управление итогами |
-
-#### AccountingRegister
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Update` | Изменение |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `TotalsControl` | Управление итогами |
-
-#### CalculationRegister
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `View` | Просмотр |
-
-#### Constant
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Update` | Изменение |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `ReadDataHistory` | Чтение истории данных |
-| `ViewDataHistory` | Просмотр истории данных |
-| `UpdateDataHistory` | Обновление истории данных |
-| `UpdateDataHistorySettings` | Настройки истории данных |
-| `UpdateDataHistoryVersionComment` | Обновление комментария версии |
-| `EditDataHistoryVersionComment` | Редактирование комментария версии |
-| `SwitchToDataHistoryVersion` | Переход к версии |
-
-#### ChartOfAccounts
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Пометка удаления |
-| `InteractiveClearDeletionMark` | Снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveDeletePredefinedData` | Удаление предопределённых |
-| `InteractiveSetDeletionMarkPredefinedData` | Пометка удаления предопределённых |
-| `InteractiveClearDeletionMarkPredefinedData` | Снятие пометки удаления предопределённых |
-| `InteractiveDeleteMarkedPredefinedData` | Удаление помеченных предопределённых |
-| `ReadDataHistory` | Чтение истории данных |
-| `ReadDataHistoryOfMissingData` | Чтение истории отсутствующих данных |
-| `UpdateDataHistory` | Обновление истории данных |
-| `UpdateDataHistoryOfMissingData` | Обновление истории отсутствующих данных |
-| `UpdateDataHistorySettings` | Настройки истории данных |
-| `UpdateDataHistoryVersionComment` | Обновление комментария версии |
-
-#### ChartOfCharacteristicTypes
-
-Аналогично ChartOfAccounts, плюс:
-
-| Право | Описание |
-|-------|----------|
-| `InteractiveDeleteMarked` | Интерактивное удаление помеченных |
-| `EditDataHistoryVersionComment` | Редактирование комментария версии |
-| `SwitchToDataHistoryVersion` | Переход к версии |
-| `ViewDataHistory` | Просмотр истории данных |
-
-#### ChartOfCalculationTypes
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Пометка удаления |
-| `InteractiveClearDeletionMark` | Снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveDeletePredefinedData` | Удаление предопределённых |
-| `InteractiveSetDeletionMarkPredefinedData` | Пометка удаления предопределённых |
-| `InteractiveClearDeletionMarkPredefinedData` | Снятие пометки предопределённых |
-| `InteractiveDeleteMarkedPredefinedData` | Удаление помеченных предопределённых |
-
-#### ExchangePlan
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Пометка удаления |
-| `InteractiveClearDeletionMark` | Снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveDeleteMarked` | Удаление помеченных |
-| `ReadDataHistory` | Чтение истории данных |
-| `ViewDataHistory` | Просмотр истории данных |
-| `UpdateDataHistory` | Обновление истории данных |
-| `ReadDataHistoryOfMissingData` | Чтение истории отсутствующих |
-| `UpdateDataHistoryOfMissingData` | Обновление истории отсутствующих |
-| `UpdateDataHistorySettings` | Настройки истории данных |
-| `UpdateDataHistoryVersionComment` | Обновление комментария версии |
-| `EditDataHistoryVersionComment` | Редактирование комментария версии |
-| `SwitchToDataHistoryVersion` | Переход к версии |
-
-#### BusinessProcess
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `Start` | Старт |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Пометка удаления |
-| `InteractiveClearDeletionMark` | Снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveActivate` | Интерактивная активация |
-| `InteractiveStart` | Интерактивный старт |
-
-#### Task
-
-| Право | Описание |
-|-------|----------|
-| `Read` | Чтение |
-| `Insert` | Добавление |
-| `Update` | Изменение |
-| `Delete` | Удаление |
-| `View` | Просмотр |
-| `Edit` | Редактирование |
-| `InputByString` | Ввод по строке |
-| `Execute` | Выполнение |
-| `InteractiveInsert` | Интерактивное добавление |
-| `InteractiveSetDeletionMark` | Пометка удаления |
-| `InteractiveClearDeletionMark` | Снятие пометки удаления |
-| `InteractiveDelete` | Интерактивное удаление |
-| `InteractiveActivate` | Интерактивная активация |
-| `InteractiveExecute` | Интерактивное выполнение |
-
-#### Простые типы (одно-два права)
-
-| Тип объекта | Права |
-|-------------|-------|
-| `DataProcessor` | Use, View |
-| `Report` | Use, View |
-| `CommonForm` | View |
-| `CommonCommand` | View |
-| `Subsystem` | View |
-| `FilterCriterion` | View |
-| `DocumentJournal` | Read, View |
-| `Sequence` | Read, Update |
-| `WebService` | Use |
-| `HTTPService` | Use |
-| `IntegrationService` | Use |
-| `SessionParameter` | Get, Set |
-| `CommonAttribute` | View, Edit |
-
-#### Типы объектов БЕЗ прав в ролях
-
-Следующие типы не фигурируют в Rights.xml (права не применимы или управляются иначе):
-
-- `Enum` (перечисления)
-- `FunctionalOption`
-- `DefinedType`
-- `CommonModule`
-- `CommonPicture`
-- `CommonTemplate`
-- `SettingsStorage`
-- `ExternalDataSource`
-
----
-
-### Права вложенных объектов
-
-Права можно задавать не только на уровне объекта, но и на уровне его составных частей.
-
-#### Реквизиты и стандартные реквизиты
-
-Доступные права: `View`, `Edit`
-
-```xml
-<object>
-    <name>Catalog.Контрагенты.StandardAttribute.PredefinedDataName</name>
-    <right>
-        <name>View</name>
-        <value>false</value>
-    </right>
-    <right>
-        <name>Edit</name>
-        <value>false</value>
-    </right>
-</object>
-```
-
-Применимо к:
-- `*.StandardAttribute.*` — стандартные реквизиты
-- `*.Attribute.*` — реквизиты
-- `*.TabularSection.*` — табличные части (целиком)
-- `*.TabularSection.*.Attribute.*` — реквизиты табличных частей
-- `*.TabularSection.*.StandardAttribute.*` — стандартные реквизиты табличных частей
-
-#### Измерения, ресурсы регистров
-
-Доступные права: `View`, `Edit`
-
-```xml
-<object>
-    <name>InformationRegister.Цены.Dimension.Номенклатура</name>
-    <right>
-        <name>Edit</name>
-        <value>false</value>
-    </right>
-</object>
-```
-
-Применимо к:
-- `*Register.*.Dimension.*`
-- `*Register.*.Resource.*`
-- `*Register.*.Attribute.*`
-
-#### Команды
-
-Доступные права: `View`
-
-```xml
-<object>
-    <name>Catalog.Контрагенты.Command.ОткрытьКарточку</name>
-    <right>
-        <name>View</name>
-        <value>false</value>
-    </right>
-</object>
-```
-
-Применимо к:
-- `*.Command.*` — команды любого объекта
-
-#### Реквизиты адресации (Task)
-
-Доступные права: `View`, `Edit`
-
-```xml
-<object>
-    <name>Task.ЗадачаИсполнителя.AddressingAttribute.Исполнитель</name>
-    <right>
-        <name>View</name>
-        <value>true</value>
-    </right>
-</object>
-```
-
-#### Полная таблица: вложенные объекты и их права
-
-| Тип вложенного | Родители | Права |
-|----------------|----------|-------|
-| `StandardAttribute` | Catalog, Document, ExchangePlan, ChartOf*, Task, BusinessProcess, *Register, DocumentJournal | View, Edit |
-| `Attribute` | Catalog, Document, ExchangePlan, ChartOf*, Task, BusinessProcess, *Register, DataProcessor, Report | View, Edit |
-| `TabularSection` | Catalog, Document, ExchangePlan, ChartOf*, Task, BusinessProcess, DataProcessor, Report | View, Edit |
-| `TabularSection.*.Attribute` | (все с TabularSection) | View, Edit |
-| `Dimension` | InformationRegister, AccumulationRegister, AccountingRegister | View, Edit |
-| `Resource` | InformationRegister, AccumulationRegister, AccountingRegister | View, Edit |
-| `Command` | Catalog, Document, DataProcessor, Report, *Register, DocumentJournal, ExchangePlan, BusinessProcess, Task | View |
-| `AddressingAttribute` | Task | View, Edit |
-
----
-
-## Ограничения на уровне записей (RLS)
-
-### Структура
-
-```xml
-<right>
-    <name>Read</name>
-    <value>true</value>
-    <restrictionByCondition>
-        <condition>Текст условия</condition>
-    </restrictionByCondition>
-</right>
-```
-
-RLS добавляется внутрь `<right>` как дочерний элемент `<restrictionByCondition>`. Условие содержит текст на языке шаблонов ограничений 1С.
-
-### Типичная структура условия
-
-```
-#Если &ОграничениеДоступаНаУровнеЗаписейУниверсально #Тогда
-#ДляОбъекта("")
-#Иначе
-#ПоЗначениям("Документ.Реализация", "", "",
-"Организации", "Организация",
-"","",
-...)
-#КонецЕсли
-```
-
-Используются препроцессорные директивы (`#Если`, `#Тогда`, `#Иначе`, `#КонецЕсли`) и макросы шаблонов (`#ДляОбъекта`, `#ПоЗначениям`, `#ДляРегистра`, `#ПоЗначениямИНаборамРасширенный`).
-
-XML-кодирование: `&` → `&amp;` в тексте условия.
-
-### Применимость
-
-RLS применяется к правам `Read`, `Update`, `Insert`, `Delete` объектов данных (Catalog, Document, Register и др.). Не применяется к интерактивным правам и правам конфигурации.
-
----
-
-## Шаблоны ограничений (restrictionTemplate)
-
-Располагаются в конце файла Rights.xml, после всех блоков `<object>`.
-
-```xml
-<restrictionTemplate>
-    <name>ИмяШаблона(Параметр1, Параметр2, ...)</name>
-    <condition>
-// Комментарий с описанием параметров
-// ...
-Текст шаблона на языке запросов 1С
-    </condition>
-</restrictionTemplate>
-```
-
-### Типичные шаблоны
-
-| Шаблон | Описание |
-|--------|----------|
-| `ДляОбъекта(Модификатор)` | Ограничение для ссылочных объектов (документы, справочники) |
-| `ПоЗначениям(Таблица, -, Модификатор, В1,П1, ...)` | Ограничение по значениям видов доступа |
-| `ДляРегистра(Регистр, Поле1, ..., Поле5)` | Ограничение для регистров |
-| `ПоЗначениямИНаборамРасширенный(...)` | Расширенное ограничение по наборам и значениям |
-
-Шаблоны определяются в роли и вызываются из `<condition>` блоков RLS через макросы `#ИмяШаблона(...)`.
-
----
-
-## Примеры
-
-### Минимальная роль (без прав)
-
-**Roles/МояРоль.xml:**
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:v8="http://v8.1c.ru/8.1/data/core"
-        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">
-    <Role uuid="00000000-0000-0000-0000-000000000001">
-        <Properties>
-            <Name>МояРоль</Name>
-            <Synonym>
-                <v8:item>
-                    <v8:lang>ru</v8:lang>
-                    <v8:content>Моя роль</v8:content>
-                </v8:item>
-            </Synonym>
-            <Comment/>
-        </Properties>
-    </Role>
-</MetaDataObject>
-```
-
-**Roles/МояРоль/Ext/Rights.xml:**
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<Rights xmlns="http://v8.1c.ru/8.2/roles" xmlns:xs="http://www.w3.org/2001/XMLSchema"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:type="Rights" version="2.17">
-    <setForNewObjects>false</setForNewObjects>
-    <setForAttributesByDefault>true</setForAttributesByDefault>
-    <independentRightsOfChildObjects>false</independentRightsOfChildObjects>
-</Rights>
-```
-
-### Роль для регламентного задания
-
-Типичный набор прав для фонового задания, работающего со справочниками и регистрами:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<Rights xmlns="http://v8.1c.ru/8.2/roles" xmlns:xs="http://www.w3.org/2001/XMLSchema"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:type="Rights" version="2.17">
-    <setForNewObjects>false</setForNewObjects>
-    <setForAttributesByDefault>true</setForAttributesByDefault>
-    <independentRightsOfChildObjects>false</independentRightsOfChildObjects>
-    <object>
-        <name>Catalog.Номенклатура</name>
-        <right>
-            <name>Read</name>
-            <value>true</value>
-        </right>
-    </object>
-    <object>
-        <name>Catalog.Контрагенты</name>
-        <right>
-            <name>Read</name>
-            <value>true</value>
-        </right>
-    </object>
-    <object>
-        <name>InformationRegister.ЦеныНоменклатуры</name>
-        <right>
-            <name>Read</name>
-            <value>true</value>
-        </right>
-        <right>
-            <name>Update</name>
-            <value>true</value>
-        </right>
-    </object>
-    <object>
-        <name>DataProcessor.ОбновлениеЦен</name>
-        <right>
-            <name>Use</name>
-            <value>true</value>
-        </right>
-    </object>
-</Rights>
-```
-
-### Роль с запретом редактирования полей
-
-```xml
-<object>
-    <name>Document.РеализацияТоваровУслуг</name>
-    <right>
-        <name>Read</name>
-        <value>true</value>
-    </right>
-    <right>
-        <name>View</name>
-        <value>true</value>
-    </right>
-</object>
-<object>
-    <name>Document.РеализацияТоваровУслуг.StandardAttribute.Posted</name>
-    <right>
-        <name>Edit</name>
-        <value>false</value>
-    </right>
-</object>
-<object>
-    <name>Document.РеализацияТоваровУслуг.StandardAttribute.DeletionMark</name>
-    <right>
-        <name>Edit</name>
-        <value>false</value>
-    </right>
-</object>
-```
-
----
-
-## Версии формата
-
-| Платформа | version (метаданные) | version (Rights.xml) | Изменения |
-|-----------|:--------------------:|:--------------------:|-----------|
-| 8.3.20 | 2.17 | 2.17 | Базовая |
-| 8.3.24 | 2.17 | 2.17 | Без изменений |
-| 8.3.27 | 2.20 | 2.20 | Только номер версии, структура идентична |
-
-Namespace Rights.xml (`http://v8.1c.ru/8.2/roles`) и namespace метаданных (`http://v8.1c.ru/8.3/MDClasses`) не менялись.

docs/1c-specs-index.md

@@ -1,172 +0,0 @@
-# Сводный индекс спецификаций формата XML конфигурации 1С
-
-Единая точка входа ко всем спецификациям XML-формата выгрузки 1С:Предприятие 8.3.
-
----
-
-## 1. Корневые файлы конфигурации
-
-| Файл | Описание | Спецификация |
-|------|----------|--------------|
-| `Configuration.xml` | Свойства и состав конфигурации | [1c-configuration-spec.md § 2](1c-configuration-spec.md#2-configurationxml--корневой-файл-конфигурации) |
-| `ConfigDumpInfo.xml` | Версии объектов (служебный) | [1c-configuration-spec.md § 3](1c-configuration-spec.md#3-configdumpinfoxml--служебный-файл-выгрузки) |
-| `Ext/` | Модули, интерфейс, начальная страница | [1c-configuration-spec.md § 4](1c-configuration-spec.md#4-ext--корневой-каталог-конфигурации) |
-| `Languages/` | Языки конфигурации | [1c-configuration-spec.md § 5](1c-configuration-spec.md#5-языки-languages) |
-
----
-
-## 2. Объекты метаданных
-
-Все типы объектов, встречающиеся в `ChildObjects` корневого `Configuration.xml`. Порядок соответствует порядку в XML.
-
-### Служебные и интерфейсные
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `Language` | `Languages/` | Языки | [1c-configuration-spec.md § 5](1c-configuration-spec.md#5-языки-languages) |
-| `Subsystem` | `Subsystems/` | Подсистемы | [1c-subsystem-spec.md § 3](1c-subsystem-spec.md#3-формат-подсистемы) |
-| `StyleItem` | `StyleItems/` | Элементы стиля | [1c-configuration-spec.md § 6.16](1c-configuration-spec.md#616-styleitem--элемент-стиля) |
-| `Style` | `Styles/` | Стили (устаревший) | [1c-configuration-spec.md § 6.17](1c-configuration-spec.md#617-style--стиль-устаревший) |
-| `CommandGroup` | `CommandGroups/` | Группы команд | [1c-subsystem-spec.md § 5](1c-subsystem-spec.md#5-формат-группы-команд-commandgroup) |
-
-### Общие объекты
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `CommonPicture` | `CommonPictures/` | Общие картинки | [1c-configuration-spec.md § 6.1](1c-configuration-spec.md#61-commonpicture--общая-картинка) |
-| `SessionParameter` | `SessionParameters/` | Параметры сеанса | [1c-configuration-spec.md § 6.6](1c-configuration-spec.md#66-sessionparameter--параметр-сеанса) |
-| `Role` | `Roles/` | Роли | [1c-role-spec.md § Файл метаданных](1c-role-spec.md#файл-метаданных-rolesимяролиxml) |
-| `CommonTemplate` | `CommonTemplates/` | Общие макеты | [1c-configuration-spec.md § 6.2](1c-configuration-spec.md#62-commontemplate--общий-макет) |
-| `FilterCriterion` | `FilterCriteria/` | Критерии отбора | [1c-configuration-spec.md § 6.11](1c-configuration-spec.md#611-filtercriterion--критерий-отбора) |
-| `CommonModule` | `CommonModules/` | Общие модули | [1c-config-objects-spec.md § 21](1c-config-objects-spec.md#21-общие-модули-commonmodules) |
-| `CommonAttribute` | `CommonAttributes/` | Общие реквизиты | [1c-configuration-spec.md § 6.3](1c-configuration-spec.md#63-commonattribute--общий-реквизит) |
-| `CommonCommand` | `CommonCommands/` | Общие команды | [1c-subsystem-spec.md § 6](1c-subsystem-spec.md#6-формат-общей-команды-commoncommand) |
-| `CommonForm` | `CommonForms/` | Общие формы | [1c-configuration-spec.md § 6.4](1c-configuration-spec.md#64-commonform--общая-форма) |
-
-### Интеграция и сервисы
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `ExchangePlan` | `ExchangePlans/` | Планы обмена | [1c-config-objects-spec.md § 15](1c-config-objects-spec.md#15-планы-обмена-exchangeplans) |
-| `XDTOPackage` | `XDTOPackages/` | XDTO-пакеты | [1c-configuration-spec.md § 6.14](1c-configuration-spec.md#614-xdtopackage--xdto-пакет) |
-| `WebService` | `WebServices/` | Веб-сервисы | [1c-config-objects-spec.md § 25](1c-config-objects-spec.md#25-веб-сервисы-webservices) |
-| `HTTPService` | `HTTPServices/` | HTTP-сервисы | [1c-config-objects-spec.md § 24](1c-config-objects-spec.md#24-http-сервисы-httpservices) |
-| `WSReference` | `WSReferences/` | WS-ссылки | [1c-configuration-spec.md § 6.15](1c-configuration-spec.md#615-wsreference--ws-ссылка) |
-| `IntegrationService` | `IntegrationServices/` | Сервисы интеграции | [1c-configuration-spec.md § 6.13](1c-configuration-spec.md#613-integrationservice--сервис-интеграции) |
-
-### Поведение и параметризация
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `EventSubscription` | `EventSubscriptions/` | Подписки на события | [1c-config-objects-spec.md § 23](1c-config-objects-spec.md#23-подписки-на-события-eventsubscriptions) |
-| `ScheduledJob` | `ScheduledJobs/` | Регламентные задания | [1c-config-objects-spec.md § 22](1c-config-objects-spec.md#22-регламентные-задания-scheduledjobs) |
-| `SettingsStorage` | `SettingsStorages/` | Хранилища настроек | [1c-configuration-spec.md § 6.10](1c-configuration-spec.md#610-settingsstorage--хранилище-настроек) |
-| `FunctionalOption` | `FunctionalOptions/` | Функциональные опции | [1c-configuration-spec.md § 6.7](1c-configuration-spec.md#67-functionaloption--функциональная-опция) |
-| `FunctionalOptionsParameter` | `FunctionalOptionsParameters/` | Параметры ФО | [1c-configuration-spec.md § 6.8](1c-configuration-spec.md#68-functionaloptionsparameter--параметр-функциональных-опций) |
-| `DefinedType` | `DefinedTypes/` | Определяемые типы | [1c-config-objects-spec.md § 20](1c-config-objects-spec.md#20-определяемые-типы-definedtypes) |
-| `Constant` | `Constants/` | Константы | [1c-config-objects-spec.md § 17](1c-config-objects-spec.md#17-константы-constants) |
-
-### Прикладные объекты
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `Catalog` | `Catalogs/` | Справочники | [1c-config-objects-spec.md § 7](1c-config-objects-spec.md#7-справочники-catalogs) |
-| `Document` | `Documents/` | Документы | [1c-config-objects-spec.md § 8](1c-config-objects-spec.md#8-документы-documents) |
-| `DocumentNumerator` | `DocumentNumerators/` | Нумераторы документов | [1c-configuration-spec.md § 6.12](1c-configuration-spec.md#612-documentnumerator--нумератор-документов) |
-| `Sequence` | `Sequences/` | Последовательности | [1c-configuration-spec.md § 6.9](1c-configuration-spec.md#69-sequence--последовательность-документов) |
-| `DocumentJournal` | `DocumentJournals/` | Журналы документов | [1c-config-objects-spec.md § 19](1c-config-objects-spec.md#19-журналы-документов-documentjournals) |
-| `Enum` | `Enums/` | Перечисления | [1c-config-objects-spec.md § 16](1c-config-objects-spec.md#16-перечисления-enums) |
-| `Report` | `Reports/` | Отчёты | [1c-config-objects-spec.md § 18](1c-config-objects-spec.md#18-отчёты-и-обработки) |
-| `DataProcessor` | `DataProcessors/` | Обработки | [1c-config-objects-spec.md § 18](1c-config-objects-spec.md#18-отчёты-и-обработки) |
-
-### Регистры
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `InformationRegister` | `InformationRegisters/` | Регистры сведений | [1c-config-objects-spec.md § 9.1](1c-config-objects-spec.md#91-регистры-сведений-informationregisters) |
-| `AccumulationRegister` | `AccumulationRegisters/` | Регистры накопления | [1c-config-objects-spec.md § 9.4](1c-config-objects-spec.md#94-регистры-накопления-accumulationregisters) |
-| `AccountingRegister` | `AccountingRegisters/` | Регистры бухгалтерии | [1c-config-objects-spec.md § 9.5](1c-config-objects-spec.md#95-регистры-бухгалтерии-accountingregisters) |
-| `CalculationRegister` | `CalculationRegisters/` | Регистры расчёта | [1c-config-objects-spec.md § 9.6](1c-config-objects-spec.md#96-регистры-расчёта-calculationregisters) |
-
-### Планы
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `ChartOfCharacteristicTypes` | `ChartsOfCharacteristicTypes/` | Планы видов характеристик | [1c-config-objects-spec.md § 11](1c-config-objects-spec.md#11-планы-видов-характеристик-chartsofcharacteristictypes) |
-| `ChartOfAccounts` | `ChartsOfAccounts/` | Планы счетов | [1c-config-objects-spec.md § 10](1c-config-objects-spec.md#10-планы-счетов-chartsofaccounts) |
-| `ChartOfCalculationTypes` | `ChartsOfCalculationTypes/` | Планы видов расчёта | [1c-config-objects-spec.md § 12](1c-config-objects-spec.md#12-планы-видов-расчёта-chartsofcalculationtypes) |
-
-### Бизнес-процессы
-
-| XML-элемент | Каталог | Русское название | Спецификация |
-|-------------|---------|-----------------|--------------|
-| `BusinessProcess` | `BusinessProcesses/` | Бизнес-процессы | [1c-config-objects-spec.md § 13](1c-config-objects-spec.md#13-бизнес-процессы-businessprocesses) |
-| `Task` | `Tasks/` | Задачи | [1c-config-objects-spec.md § 14](1c-config-objects-spec.md#14-задачи-tasks) |
-
----
-
-## 3. Вложенные форматы
-
-Форматы файлов, вложенных в каталоги объектов метаданных.
-
-| Формат | Файл | Описание | Спецификация |
-|--------|------|----------|--------------|
-| Управляемая форма | `Ext/Form.xml` | Элементы, реквизиты, команды | [1c-form-spec.md § 1](1c-form-spec.md#1-корневой-элемент) |
-| СКД (DataCompositionSchema) | `Ext/Template.xml` | Схема компоновки данных | [1c-dcs-spec.md § 2](1c-dcs-spec.md#2-общая-структура-datacompositionschema) |
-| Табличный документ (MXL) | `Ext/Template.xml` | Печатная форма | [1c-spreadsheet-spec.md](1c-spreadsheet-spec.md#структура-документа) |
-| Роль (Rights) | `Ext/Rights.xml` | Права доступа и RLS | [1c-role-spec.md](1c-role-spec.md#файл-прав-rolesимяролиextrightsxml) |
-| Справка (Help) | `Ext/Help/` | Встроенная справка | [1c-help-spec.md § 1](1c-help-spec.md#1-структура-файлов) |
-| Предопределённые элементы | `Predefined.xml` | Предопределённые справочники/ПВХ | [1c-config-objects-spec.md § 7.2](1c-config-objects-spec.md#72-предопределённые-элементы-predefinedxml) |
-| Состав плана обмена | `Content.xml` | Объекты синхронизации | [1c-config-objects-spec.md § 15.4](1c-config-objects-spec.md#154-состав-плана-обмена-contentxml) |
-| Карта маршрута | `Flowchart.xml` | Маршрут бизнес-процесса | [1c-config-objects-spec.md § 13.3](1c-config-objects-spec.md#133-карта-маршрута-flowchartxml) |
-
----
-
-## 4. Расширения конфигурации (CFE)
-
-| Тема | Описание | Спецификация |
-|------|----------|--------------|
-| Общая структура выгрузки | Каталоги, отличия от конфигурации | [1c-extension-spec.md § 1](1c-extension-spec.md#1-общая-структура-выгрузки-расширения) |
-| Configuration.xml расширения | Свойства, назначение, ChildObjects | [1c-extension-spec.md § 2](1c-extension-spec.md#2-configurationxml--корневой-файл-расширения) |
-| Заимствованные / собственные объекты | ObjectBelonging, ExtendedConfigurationObject | [1c-extension-spec.md § 4](1c-extension-spec.md#4-заимствованные-и-собственные-объекты) |
-| Расширение свойств (xr:PropertyState) | MultiState, ExtendedProperty | [1c-extension-spec.md § 6](1c-extension-spec.md#6-расширение-свойств-xrpropertystate-и-xrextendedproperty) |
-| Модули и декораторы перехвата | &Перед, &После, &Вместо, diff-маркеры | [1c-extension-spec.md § 7](1c-extension-spec.md#7-модули-в-расширениях) |
-| Предопределённые элементы | ExtensionState: Native | [1c-extension-spec.md § 8](1c-extension-spec.md#8-предопределённые-элементы-в-расширениях) |
-
----
-
-## 5. Внешние обработки и отчёты
-
-| Формат | Описание | Спецификация |
-|--------|----------|--------------|
-| EPF (внешняя обработка) | ExternalDataProcessor | [1c-epf-spec.md § 1](1c-epf-spec.md#1-структура-каталогов) |
-| ERF (внешний отчёт) | ExternalReport | [1c-erf-spec.md § 1](1c-erf-spec.md#1-структура-каталогов) |
-
----
-
-## 6. Общие элементы формата
-
-Общие для всех типов объектов структуры XML описаны в спецификации объектов:
-
-| Тема | Спецификация |
-|------|--------------|
-| Корневой элемент MetaDataObject | [1c-config-objects-spec.md § 2](1c-config-objects-spec.md#2-общий-формат-xml) |
-| Пространства имён XML | [1c-config-objects-spec.md § 2.2](1c-config-objects-spec.md#22-пространства-имён) |
-| InternalInfo / GeneratedType | [1c-config-objects-spec.md § 3](1c-config-objects-spec.md#3-internalinfo--внутренняя-информация) |
-| Общие свойства Properties | [1c-config-objects-spec.md § 4](1c-config-objects-spec.md#4-общие-элементы-properties) |
-| Стандартные реквизиты | [1c-config-objects-spec.md § 5](1c-config-objects-spec.md#5-стандартные-реквизиты-standardattributes) |
-| Дочерние объекты (Attribute, TabularSection, Form, Template, Command) | [1c-config-objects-spec.md § 6](1c-config-objects-spec.md#6-дочерние-объекты-childobjects) |
-| Формат ссылок на объекты | [1c-config-objects-spec.md § 28](1c-config-objects-spec.md#28-формат-ссылок-на-объекты-метаданных) |
-| Различия версий 2.17 → 2.20 | [1c-config-objects-spec.md § 26](1c-config-objects-spec.md#26-различия-версий-платформы) |
-
----
-
-## 7. DSL-спецификации (компактный формат ввода)
-
-| DSL | Описание | Спецификация |
-|-----|----------|--------------|
-| Meta DSL | JSON-формат для создания/редактирования объектов | [meta-dsl-spec.md](meta-dsl-spec.md) |
-| Form DSL | JSON-формат для компиляции форм | [form-dsl-spec.md](form-dsl-spec.md) |
-| SKD DSL | JSON-формат для компиляции СКД | [skd-dsl-spec.md](skd-dsl-spec.md) |
-| MXL DSL | JSON-формат для компиляции табличных документов | [mxl-dsl-spec.md](mxl-dsl-spec.md) |
-| Role DSL | JSON-формат для компиляции ролей | [role-dsl-spec.md](role-dsl-spec.md) |

docs/1c-spreadsheet-spec.md

@@ -1,449 +0,0 @@
-# Спецификация XML-формата табличного документа (SpreadsheetDocument)
-
-Формат файла `Template.xml` для макетов типа `SpreadsheetDocument` (табличный документ / MXL).
-
-## Namespace
-
-```xml
-<document xmlns="http://v8.1c.ru/8.2/data/spreadsheet"
-          xmlns:style="http://v8.1c.ru/8.1/data/ui/style"
-          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">
-```
-
-## Структура документа
-
-Элементы внутри `<document>` идут в фиксированном порядке:
-
-```
-<document>
-    <languageSettings>          — языковые настройки
-    <columns> ...               — наборы колонок (один или несколько)
-    <rowsItem> ...              — строки с данными (повторяются)
-    <drawing> ...               — рисунки (опционально, повторяются)
-    <templateMode>true          — признак макета
-    <defaultFormatIndex>        — индекс формата по умолчанию
-    <height>                    — общее количество строк
-    <vgRows>                    — видимых строк (обычно = height)
-    <merge> ...                 — объединения ячеек (повторяются)
-    <verticalUnmerge> ...       — отмена объединений (опционально)
-    <namedItem> ...             — именованные области (повторяются)
-    <line> ...                  — стили линий (повторяются)
-    <font> ...                  — шрифты (опционально, повторяются)
-    <format> ...                — форматы (повторяются)
-    <picture> ...               — ресурсы картинок (опционально)
-</document>
-```
-
-## Индексация
-
-Все палитры (линии, шрифты, форматы) — **плоские массивы**, на элементы которых ссылаются по индексу.
-
-| Палитра   | Индексация | Индекс 0 означает                   |
-|-----------|------------|--------------------------------------|
-| `<line>`  | 0-based    | Первый элемент `<line>`              |
-| `<font>`  | 0-based    | Первый элемент `<font>`              |
-| `<format>`| **1-based**| 0 = «формат по умолчанию» (не задан) |
-
-Формат с индексом N — это N-й элемент `<format>` в документе (считая от 1).
-
-## Языковые настройки
-
-```xml
-<languageSettings>
-    <currentLanguage>ru</currentLanguage>
-    <defaultLanguage>ru</defaultLanguage>
-    <languageInfo>
-        <id>ru</id>
-        <code>Русский</code>
-        <description>Русский</description>
-    </languageInfo>
-</languageSettings>
-```
-
-## Колонки
-
-### Основной набор
-
-```xml
-<columns>
-    <size>33</size>              <!-- общее количество колонок -->
-    <columnsItem>
-        <index>1</index>         <!-- индекс колонки (0-based) -->
-        <column>
-            <formatIndex>1</formatIndex>  <!-- ссылка на format[] -->
-        </column>
-    </columnsItem>
-    ...
-</columns>
-```
-
-Перечисляются только колонки с нестандартной шириной. Формат колонки определяет ширину через свойство `<width>` в палитре форматов.
-
-### Дополнительные наборы колонок
-
-Некоторые строки документа могут использовать **собственную сетку колонок**, отличную от основной. Каждый дополнительный набор имеет UUID:
-
-```xml
-<columns>
-    <id>f01e015f-de4c-4f97-9fbe-a244c4c30c6c</id>
-    <size>17</size>
-    <columnsItem>
-        <index>0</index>
-        <column>
-            <formatIndex>12</formatIndex>
-        </column>
-    </columnsItem>
-    ...
-</columns>
-```
-
-- Первый `<columns>` — основной набор (без `<id>`)
-- Дополнительные наборы — с `<id>` (UUID), могут иметь другое количество и ширину колонок
-- Строки, merge и namedItem ссылаются на набор через `<columnsID>`
-
-Типичное применение: сложные печатные формы (УПД, УКД), где шапка/подвал/табличная часть имеют разную разбивку на колонки.
-
-## Строки и ячейки
-
-### Строка
-
-```xml
-<rowsItem>
-    <index>3</index>               <!-- индекс строки (0-based) -->
-    <indexTo>5</indexTo>            <!-- опц.: диапазон [index..indexTo] с одинаковым содержимым -->
-    <row>
-        <columnsID>f01e015f-...</columnsID>  <!-- опц.: набор колонок (UUID) -->
-        <formatIndex>5</formatIndex>  <!-- опц.: формат строки (определяет высоту) -->
-        <empty>true</empty>           <!-- опц.: пустая строка -->
-        <c>...</c>                    <!-- ячейки (повторяются) -->
-    </row>
-</rowsItem>
-```
-
-- Строки с одинаковым содержимым объединяются через `<indexTo>`
-- `<columnsID>` привязывает строку к дополнительному набору колонок. Без него — используется основной набор
-
-### Ячейка
-
-Ячейки внутри `<row>` — элементы `<c>` (cell group), каждый содержит `<c>` (cell content):
-
-```xml
-<c>                                <!-- cell group -->
-    <i>6</i>                       <!-- индекс колонки (0-based), опционален -->
-    <c>                            <!-- cell content -->
-        <f>9</f>                   <!-- индекс формата -->
-        <parameter>Имя</parameter>           <!-- параметр для заполнения -->
-        <detailParameter>Расш</detailParameter>  <!-- параметр расшифровки -->
-        <tl>                       <!-- текст (локализованная строка) -->
-            <v8:item>
-                <v8:lang>ru</v8:lang>
-                <v8:content>Итого:</v8:content>
-            </v8:item>
-        </tl>
-    </c>
-</c>
-```
-
-**Правила позиционирования `<i>`:**
-- Если `<i>` указан — ячейка в этой колонке
-- Если `<i>` не указан — колонка = предыдущая + 1
-- Первая ячейка без `<i>` идёт в колонку 0
-
-### Типы заполнения ячеек
-
-Тип заполнения определяется свойством `fillType` в формате ячейки:
-
-| fillType    | Данные ячейки                  | Описание                               |
-|-------------|-------------------------------|----------------------------------------|
-| `Parameter` | `<parameter>Имя</parameter>`  | Значение подставляется программно      |
-| `Template`  | `<tl>Текст [Параметр]</tl>`  | Шаблон — `[Имя]` заменяется на значение |
-| `Text`      | `<tl>Текст</tl>`             | Статический текст                      |
-| *(нет)*     | —                             | Пустая ячейка или ячейка с форматированием |
-
-`<detailParameter>` — имя параметра расшифровки (для навигации при клике на ячейку).
-
-## Рисунки
-
-```xml
-<drawing>
-    <drawingType>Picture</drawingType>
-    <id>1</id>
-    <formatIndex>11</formatIndex>
-    <beginRow>3</beginRow>
-    <beginRowOffset>6</beginRowOffset>
-    <endRow>4</endRow>
-    <endRowOffset>33</endRowOffset>
-    <beginColumn>2</beginColumn>
-    <beginColumnOffset>0</beginColumnOffset>
-    <endColumn>4</endColumn>
-    <endColumnOffset>183</endColumnOffset>
-    <autoSize>false</autoSize>
-    <pictureSize>Proportionally</pictureSize>
-    <zOrder>1</zOrder>
-    <pictureIndex>1</pictureIndex>
-</drawing>
-```
-
-Позиция задаётся через начальную/конечную строку и колонку + смещения в пикселях. `pictureIndex` ссылается на ресурс из палитры `<picture>`.
-
-## Объединения ячеек
-
-```xml
-<merge>
-    <r>3</r>      <!-- строка (0-based), -1 = все строки -->
-    <c>1</c>      <!-- колонка (0-based) -->
-    <h>1</h>      <!-- доп. строк (опц., по умолчанию 0 = одна строка) -->
-    <w>30</w>     <!-- доп. колонок -->
-    <columnsID>f01e015f-...</columnsID>  <!-- опц.: набор колонок -->
-</merge>
-```
-
-Размер объединения: `(h + 1)` строк × `(w + 1)` колонок. Если `<h>` не указан — объединение в пределах одной строки.
-
-`<r>-1</r>` — объединение действует для всех строк, использующих данный набор колонок (аналог объединения колонок на уровне всего документа).
-
-### Отмена объединений
-
-`<verticalUnmerge>` отменяет вертикальное объединение для конкретной строки:
-
-```xml
-<verticalUnmerge>
-    <r>10</r>     <!-- строка (0-based) -->
-    <c>7</c>      <!-- колонка (0-based) -->
-    <w>12</w>     <!-- доп. колонок -->
-</verticalUnmerge>
-```
-
-Используется в сложных макетах, когда глобальное объединение колонок (`<r>-1</r>`) нужно разорвать в отдельных строках.
-
-## Именованные области
-
-Именованные области — аналог «имён» в табличном документе 1С. Используются для программного вывода секций.
-
-Получение области:
-```bsl
-// Горизонтальная область (диапазон строк)
-Область = Макет.ПолучитьОбласть("Заголовок");
-
-// Пересечение горизонтальной и вертикальной областей
-Область = Макет.ПолучитьОбласть("ВысотаЭтикетки|ШиринаЭтикетки");
-```
-
-Пересечение через `|` типично для этикеток и ценников, где нужна область фиксированного размера (высота × ширина).
-
-### Тип Rows — горизонтальная область
-
-```xml
-<namedItem xsi:type="NamedItemCells">
-    <name>Заголовок</name>
-    <area>
-        <type>Rows</type>
-        <beginRow>1</beginRow>        <!-- 0-based -->
-        <endRow>4</endRow>
-        <beginColumn>-1</beginColumn> <!-- -1 = все колонки -->
-        <endColumn>-1</endColumn>
-    </area>
-</namedItem>
-```
-
-### Тип Columns — вертикальная область
-
-```xml
-<namedItem xsi:type="NamedItemCells">
-    <name>ШиринаЭтикетки</name>
-    <area>
-        <type>Columns</type>
-        <beginRow>-1</beginRow>       <!-- -1 = все строки -->
-        <endRow>-1</endRow>
-        <beginColumn>1</beginColumn>  <!-- 0-based -->
-        <endColumn>5</endColumn>
-    </area>
-</namedItem>
-```
-
-### Тип Rectangle — прямоугольная область
-
-Область, ограниченная и по строкам, и по колонкам. Используется с дополнительными наборами колонок:
-
-```xml
-<namedItem xsi:type="NamedItemCells">
-    <name>ОбластьЗаписьДо</name>
-    <area>
-        <type>Rectangle</type>
-        <beginRow>22</beginRow>         <!-- 0-based -->
-        <endRow>22</endRow>
-        <beginColumn>5</beginColumn>    <!-- 0-based -->
-        <endColumn>17</endColumn>
-        <columnsID>c6cb0794-...</columnsID>  <!-- набор колонок -->
-    </area>
-</namedItem>
-```
-
-### Привязка к набору колонок
-
-Именованные области могут ссылаться на дополнительный набор колонок через `<columnsID>`:
-
-```xml
-<namedItem xsi:type="NamedItemCells">
-    <name>НумерацияЛистов</name>
-    <area>
-        <type>Rows</type>
-        <beginRow>59</beginRow>
-        <endRow>59</endRow>
-        <beginColumn>-1</beginColumn>
-        <endColumn>-1</endColumn>
-        <columnsID>0adf41ed-...</columnsID>
-    </area>
-</namedItem>
-```
-
-### Тип Drawing — именованный рисунок
-
-```xml
-<namedItem xsi:type="NamedItemDrawing">
-    <name>Штрихкод</name>
-    <drawingID>1</drawingID>          <!-- ссылка на drawing/id -->
-</namedItem>
-```
-
-## Стили линий
-
-Палитра линий для границ ячеек и рисунков. Индексация 0-based.
-
-```xml
-<!-- Для границ ячеек -->
-<line width="2" gap="false">
-    <v8ui:style xsi:type="v8ui:SpreadsheetDocumentCellLineType">Solid</v8ui:style>
-</line>
-
-<!-- Для границ рисунков -->
-<line width="1" gap="false">
-    <v8ui:style xsi:type="v8ui:SpreadsheetDocumentDrawingLineType">None</v8ui:style>
-</line>
-```
-
-| xsi:type                                | Значения    |
-|-----------------------------------------|-------------|
-| `v8ui:SpreadsheetDocumentCellLineType`  | Solid, None |
-| `v8ui:SpreadsheetDocumentDrawingLineType` | Solid, None |
-
-Атрибут `width` — толщина линии (1 = тонкая, 2 = толстая).
-
-## Шрифты
-
-Палитра шрифтов. Индексация 0-based.
-
-```xml
-<!-- Абсолютный шрифт -->
-<font faceName="Arial" height="14" bold="true" italic="false"
-      underline="false" strikeout="false" kind="Absolute" scale="100"/>
-
-<!-- Ссылка на стиль -->
-<font ref="style:TextFont" kind="StyleItem"/>
-```
-
-## Форматы
-
-Палитра форматов — центральный элемент. **Индексация 1-based** (индекс 0 = формат не задан).
-
-```xml
-<format>
-    <font>0</font>                          <!-- индекс шрифта (0-based) -->
-    <leftBorder>0</leftBorder>              <!-- индекс линии левой границы -->
-    <topBorder>1</topBorder>                <!-- индекс линии верхней границы -->
-    <rightBorder>0</rightBorder>            <!-- индекс линии правой границы -->
-    <bottomBorder>1</bottomBorder>          <!-- индекс линии нижней границы -->
-    <width>24</width>                       <!-- ширина (для колонок) -->
-    <height>84</height>                     <!-- высота (для строк) -->
-    <horizontalAlignment>Center</horizontalAlignment>   <!-- Left | Center | Right -->
-    <verticalAlignment>Center</verticalAlignment>       <!-- Top | Center -->
-    <textPlacement>Wrap</textPlacement>     <!-- Wrap = перенос по словам -->
-    <fillType>Parameter</fillType>          <!-- Parameter | Template | Text -->
-    <format>                                <!-- строка формата (опционально) -->
-        <v8:item>
-            <v8:lang>ru</v8:lang>
-            <v8:content>ЧЦ=15; ЧДЦ=2</v8:content>
-        </v8:item>
-    </format>
-    <drawingBorder>1</drawingBorder>        <!-- индекс линии для рисунка -->
-</format>
-```
-
-Все свойства опциональны. Формат может содержать только `<width>` (для колонки) или только `<height>` (для строки).
-
-### Связь формата с контекстом
-
-| Контекст         | Ссылка             | Значимые свойства формата |
-|------------------|--------------------|--------------------------|
-| Колонка          | `<formatIndex>`    | `width`                  |
-| Строка           | `<formatIndex>`    | `height`                 |
-| Ячейка           | `<f>`              | Все остальные             |
-| Рисунок          | `<formatIndex>`    | `drawingBorder`          |
-| По умолчанию     | `<defaultFormatIndex>` | `width`              |
-
-## Ресурсы картинок
-
-```xml
-<picture>
-    <index>0</index>
-    <picture ref="v8ui:Штрихкод"/>    <!-- ссылка на предопределённую картинку -->
-</picture>
-```
-
-## Типичная структура макета печатной формы
-
-Печатная форма обычно состоит из именованных горизонтальных областей:
-
-```
-Заголовок      — шапка документа (название, номер, дата)
-Поставщик      — реквизиты поставщика
-Покупатель     — реквизиты покупателя
-ШапкаТаблицы   — заголовок таблицы товаров
-Строка         — строка товара (выводится в цикле)
-Итого          — итоговая строка
-СуммаПрописью  — сумма прописью
-Подписи        — блок подписей
-```
-
-Каждая область — диапазон строк, получаемый через `ПолучитьОбласть("Имя")` и выводимый через `Вывести()`.
-
-Параметры в ячейках (`<parameter>`) заполняются программно:
-```bsl
-Область = Макет.ПолучитьОбласть("Строка");
-Область.Параметры.НомерСтроки = НомерСтроки;
-Область.Параметры.Товар = СтрокаТЧ.Номенклатура;
-ТабДок.Вывести(Область);
-```
-
-## Совместимость версий платформы
-
-Проведено сравнение выгрузок конфигурации «Бухгалтерия предприятия 3.0» на трёх версиях платформы: 8.3.20, 8.3.24, 8.3.27.
-
-### Template.xml (табличный документ)
-
-Содержимое `Template.xml` **побайтно идентично** на всех трёх версиях. Формат табличного документа стабилен — пространства имён, набор тегов и структура не менялись между 8.3.20 и 8.3.27.
-
-### Метаданные (version в MetaDataObject)
-
-Атрибут `version` корневого элемента `<MetaDataObject>` в XML-файлах метаданных (`.xml` объектов, форм, макетов):
-
-| Платформа | version |
-|-----------|---------|
-| 8.3.20    | 2.17    |
-| 8.3.24    | 2.17    |
-| 8.3.27    | 2.20    |
-
-### Form.xml (управляемая форма)
-
-Содержимое `Form.xml` идентично между 8.3.20 и 8.3.24. Между 8.3.24 и 8.3.27 различается **только** атрибут `version` в корневом элементе `<Form>`: `"2.17"` → `"2.20"`. Пространства имён и структура не изменились.
-
-### BSL-модули
-
-Модули на встроенном языке (`ObjectModule.bsl`) полностью идентичны на всех трёх версиях.
-
-### Обратная совместимость
-
-Навыки генерируют XML с `version="2.17"`. Сборка EPF через `1cv8.exe` версии 8.3.27 проходит успешно — платформа принимает файлы с более старым номером версии без ошибок. Повышать `version` до `"2.20"` не требуется.

docs/build-spec.md

@@ -1,362 +0,0 @@
-# Пакетный режим конфигуратора 1С
-
-## Общие сведения
-
-Конфигуратор 1С:Предприятия 8.3 поддерживает пакетный (безоконный) режим для автоматизации операций с конфигурациями, информационными базами и внешними обработками. Все операции выполняются через командную строку `1cv8.exe`.
-
-**Два режима запуска:**
-
-| Режим | Назначение |
-|-------|-----------|
-| `DESIGNER` | Конфигуратор — работа с конфигурацией, сборка EPF, обновление БД |
-| `ENTERPRISE` | Предприятие — запуск обработок, навигация по ссылкам |
-| `CREATEINFOBASE` | Создание новой информационной базы |
-
-**Путь к 1cv8.exe** зависит от версии платформы: `C:\Program Files\1cv8\8.3.27.1859\bin\1cv8.exe`.
-
-## Подключение к информационной базе
-
-| Параметр | Описание |
-|----------|----------|
-| `/F <каталог>` | Файловая база — каталог с файлом `1Cv8.1CD` |
-| `/S <адрес>` | Серверная база — формат `server/ibname` |
-| `/IBName <имя>` | По имени из списка баз (в кавычках если содержит пробелы) |
-| `/IBConnectionString` | Полная строка соединения |
-
-Примеры:
-```
-1cv8.exe DESIGNER /F "C:\Bases\MyBase" ...
-1cv8.exe DESIGNER /S server-pc/accounting ...
-1cv8.exe DESIGNER /IBName "Бухгалтерия предприятия" ...
-```
-
-### Аутентификация
-
-| Параметр | Описание |
-|----------|----------|
-| `/N<имя>` | Имя пользователя (**без пробела** после `/N`) |
-| `/P<пароль>` | Пароль (**без пробела** после `/P`). Можно опустить если пароля нет |
-| `/WA-` | Запретить аутентификацию ОС |
-| `/WA+` | Обязательная аутентификация ОС (по умолчанию) |
-
-> **Важно**: между `/N` и именем, а также между `/P` и паролем пробела нет: `/NАдмин /PSecret123`.
-
-## Общие параметры пакетного режима
-
-| Параметр | Описание |
-|----------|----------|
-| `/DisableStartupDialogs` | Подавляет интерактивные диалоги. **Обязательно** для пакетного режима — без него конфигуратор может зависнуть в ожидании ввода |
-| `/DisableStartupMessages` | Подавляет стартовые предупреждения (несоответствие конфигурации БД и т.п.) |
-| `/Out <файл> [-NoTruncate]` | Файл для вывода служебных сообщений (UTF-8). `-NoTruncate` — не очищать файл перед записью |
-| `/DumpResult <файл>` | Записать числовой код результата в файл (0 — успех, 1 — ошибка, 101 — ошибки проверки) |
-| `/Visible` | Показать окно конфигуратора (по умолчанию скрыто в пакетном режиме) |
-
-## Создание информационной базы
-
-```
-1cv8.exe CREATEINFOBASE <строка_соединения> [/AddToList [<имя>]] [/UseTemplate <файл>] [/DumpResult <файл>]
-```
-
-### Файловая база
-
-```
-1cv8.exe CREATEINFOBASE File="C:\Bases\EmptyDB"
-```
-
-### Серверная база
-
-```
-1cv8.exe CREATEINFOBASE Srvr="server-pc";Ref="new_db"
-```
-
-### Параметры
-
-| Параметр | Описание |
-|----------|----------|
-| `File="<путь>"` | Строка соединения для файловой базы |
-| `Srvr="<сервер>";Ref="<имя>"` | Строка соединения для серверной базы |
-| `/AddToList [<имя>]` | Добавить в список баз. Имя — необязательно |
-| `/UseTemplate <файл>` | Создать по шаблону (.cf или .dt) |
-| `/DumpResult <файл>` | Записать результат (0 — успех) |
-
-## Работа с конфигурацией — бинарные файлы (CF)
-
-### Выгрузка конфигурации в CF-файл
-
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpCfg config.cf /Out log.txt
-```
-
-**`/DumpCfg <файл> [-Extension <имя>]`** — сохранить конфигурацию в .cf-файл.
-
-### Загрузка конфигурации из CF-файла
-
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadCfg config.cf /Out log.txt
-```
-
-**`/LoadCfg <файл> [-Extension <имя>] [-AllExtensions]`** — загрузить конфигурацию из .cf-файла.
-
-| Параметр | Описание |
-|----------|----------|
-| `-Extension <имя>` | Работа с расширением (указать имя) |
-| `-AllExtensions` | Работа со всеми расширениями (файл — архив расширений) |
-
-> После `/LoadCfg` конфигурация загружается в «основную» конфигурацию конфигуратора. Для применения к БД необходим `/UpdateDBCfg`.
-
-## Работа с конфигурацией — XML-исходники
-
-### Выгрузка `/DumpConfigToFiles`
-
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles <каталог> [параметры] /Out log.txt
-```
-
-Полная сигнатура:
-```
-/DumpConfigToFiles <каталог> [-Extension <имя>] [-AllExtensions]
-    [-update] [-force] [-getChanges <файл>]
-    [-configDumpInfoForChanges <файл>] [-listFile <файл>]
-    [-configDumpInfoOnly] [-Server] [-Format <формат>]
-    [-Archive <файл>] [-ignoreUnresolvedReferences]
-```
-
-#### Режимы выгрузки
-
-**Полная выгрузка** — все объекты конфигурации:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" /Out log.txt
-```
-
-**Инкрементальная выгрузка** — только изменённые объекты:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -update -force /Out log.txt
-```
-
-Инкрементальная выгрузка с отслеживанием изменений:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -update -getChanges "changes.txt" -configDumpInfoForChanges "old\ConfigDumpInfo.xml" /Out log.txt
-```
-
-**Частичная выгрузка** — выбранные объекты по списку:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -listFile "dump_objects.txt" /Out log.txt
-```
-
-**Обновление ConfigDumpInfo.xml** — без выгрузки файлов:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /DumpConfigToFiles "C:\src\config" -configDumpInfoOnly /Out log.txt
-```
-
-#### Параметры выгрузки
-
-| Параметр | Описание |
-|----------|----------|
-| `-update` | Обновляющая (инкрементальная) выгрузка — только изменённые объекты |
-| `-force` | Принудительная полная выгрузка. Используется с `-update` при несовпадении версий |
-| `-getChanges <файл>` | Записать список изменённых файлов |
-| `-configDumpInfoForChanges <файл>` | Файл ConfigDumpInfo.xml для определения изменений |
-| `-listFile <файл>` | Файл со списком выгружаемых объектов (по одному на строку) |
-| `-configDumpInfoOnly` | Выгрузить только ConfigDumpInfo.xml |
-| `-Extension <имя>` | Выгрузить расширение |
-| `-AllExtensions` | Выгрузить все расширения |
-| `-Server` | Выгрузка на стороне сервера |
-| `-Format <формат>` | Формат файлов (Hierarchical / Plain) |
-| `-Archive <файл>` | Выгрузка в архивный файл |
-| `-ignoreUnresolvedReferences` | Игнорировать неразрешённые ссылки |
-
-#### Формат listFile для выгрузки
-
-Файл содержит **имена объектов метаданных** (одно на строку):
-```
-Справочник.Номенклатура
-Справочник.Валюты
-Документ.РеализацияТоваровУслуг
-Отчет.АнализПродаж
-```
-
-Кодировка: UTF-8 с BOM.
-
-### Загрузка `/LoadConfigFromFiles`
-
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles <каталог> [параметры] /Out log.txt
-```
-
-Полная сигнатура:
-```
-/LoadConfigFromFiles <каталог> [-Extension <имя>] [-AllExtensions]
-    [-updateConfigDumpInfo] [-listFile <файл>]
-    [-Server] [-Archive <файл>] [-Format <формат>]
-```
-
-#### Режимы загрузки
-
-**Полная загрузка** — замена всей конфигурации:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles "C:\src\config" /Out log.txt
-```
-
-**Частичная загрузка** — выбранные файлы по списку:
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /LoadConfigFromFiles "C:\src\config" -listFile "load_list.txt" -Format Hierarchical -partial -updateConfigDumpInfo /Out log.txt
-```
-
-#### Параметры загрузки
-
-| Параметр | Описание |
-|----------|----------|
-| `-listFile <файл>` | Файл со списком загружаемых файлов (по одному на строку) |
-| `-partial` | Частичная загрузка — **не заменять** всю конфигурацию, а внести точечные изменения. Недокументированный, но рабочий параметр |
-| `-updateConfigDumpInfo` | Обновить ConfigDumpInfo.xml после загрузки |
-| `-Extension <имя>` | Загрузить в расширение |
-| `-AllExtensions` | Загрузить все расширения |
-| `-Server` | Загрузка на стороне сервера |
-| `-Archive <файл>` | Загрузка из архивного файла |
-| `-Format <формат>` | Формат файлов (Hierarchical / Plain) |
-
-#### Формат listFile для загрузки
-
-Файл содержит **относительные пути к файлам** в каталоге выгрузки (один на строку):
-```
-Catalogs/Валюты.xml
-Catalogs/Валюты/Ext/ObjectModule.bsl
-Documents/РеализацияТоваровУслуг.xml
-Documents/РеализацияТоваровУслуг/Forms/ФормаДокумента.xml
-```
-
-Кодировка: UTF-8 с BOM.
-
-> **Важно: различие форматов listFile для dump и load:**
-> - **Выгрузка** (`/DumpConfigToFiles -listFile`): имена объектов метаданных — `Справочник.Номенклатура`
-> - **Загрузка** (`/LoadConfigFromFiles -listFile`): относительные пути файлов — `Catalogs/Валюты.xml`
-
-## Обновление конфигурации БД
-
-```
-1cv8.exe DESIGNER /F <база> /DisableStartupDialogs /UpdateDBCfg /Out log.txt
-```
-
-Полная сигнатура:
-```
-/UpdateDBCfg [-Dynamic<режим>] [-Server]
-    [-WarningsAsErrors]
-    [-BackgroundStart] [-BackgroundFinish]
-    [-BackgroundCancel] [-BackgroundSuspend] [-BackgroundResume]
-    [-Extension <имя>] [-AllExtensions]
-```
-
-| Параметр | Описание |
-|----------|----------|
-| `-Dynamic+` | Использовать динамическое обновление |
-| `-Dynamic-` | Не использовать динамическое обновление |
-| `-Server` | Обновление на стороне сервера |
-| `-WarningsAsErrors` | Предупреждения считать ошибками |
-| `-Extension <имя>` | Обновить расширение |
-| `-AllExtensions` | Обновить все расширения |
-
-### Фоновое обновление
-
-| Параметр | Описание |
-|----------|----------|
-| `-BackgroundStart` | Начать фоновое обновление |
-| `-BackgroundFinish` | Дождаться окончания и завершить |
-| `-BackgroundCancel` | Отменить фоновое обновление |
-| `-BackgroundSuspend` | Приостановить |
-| `-BackgroundResume` | Возобновить |
-
-> После `/LoadCfg` или `/LoadConfigFromFiles` необходимо выполнить `/UpdateDBCfg` чтобы изменения применились к базе данных.
-
-## Сборка и разборка внешних обработок (EPF/ERF)
-
-### Сборка (XML → EPF)
-
-```
-1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /LoadExternalDataProcessorOrReportFromFiles <корневой_xml> <путь_к_epf> /Out <лог_файл>
-```
-
-| Параметр | Описание |
-|----------|----------|
-| `<корневой_xml>` | Путь к корневому XML-файлу обработки (например, `src\МояОбработка.xml`) |
-| `<путь_к_epf>` | Путь к выходному файлу `.epf` или `.erf` |
-
-> **Важно**: первый аргумент — путь к **корневому XML-файлу** (не к каталогу). Если указать каталог, конфигуратор вернёт ошибку.
-
-### Разборка (EPF → XML)
-
-```
-1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /DumpExternalDataProcessorOrReportToFiles <каталог_выгрузки> <путь_к_epf> [-Format Hierarchical] /Out <лог_файл>
-```
-
-| Параметр | Описание |
-|----------|----------|
-| `<каталог_выгрузки>` | Каталог для XML-файлов |
-| `<путь_к_epf>` | Исходный файл `.epf` или `.erf` |
-| `-Format Hierarchical` | Иерархическая структура каталогов (по умолчанию) |
-| `-Format Plain` | Плоская структура |
-
-### Примечания по сборке
-
-- Если база не указана — скрипт `epf-build.ps1` автоматически создаёт временную базу. Для обработок со ссылочными типами (`CatalogRef.*`, `DocumentRef.*` и т.п.) генерируются заглушки метаданных. Временная база удаляется после сборки.
-- Категории колонок регистров (Dimension/Resource/Attribute) угадываются по Form.xml — при round-trip через реальную базу привязки полей формы могут не сохраниться.
-
-### Примечания по разборке
-
-- Разборка **обязательно** требует базу с конфигурацией, содержащей используемые типы.
-- Dump в пустой базе **безвозвратно** теряет ссылочные типы — `CatalogRef.XXX` превращается в `xs:string`.
-
-## Запуск в режиме предприятия
-
-```
-1cv8.exe ENTERPRISE /F <база> [/N<имя> /P<пароль>] /DisableStartupDialogs [параметры]
-```
-
-| Параметр | Описание |
-|----------|----------|
-| `/Execute <файл.epf>` | Запуск внешней обработки сразу после старта. При указании `/Execute` параметр `/URL` игнорируется |
-| `/URL <ссылка>` | Навигационная ссылка (формат `e1cib/...`) |
-| `/C <строка>` | Передача параметра в прикладное решение |
-
-Примеры:
-```
-1cv8.exe ENTERPRISE /F "C:\Bases\MyBase" /NАдмин /PSecret /DisableStartupDialogs /Execute "C:\scripts\process.epf"
-```
-
-```
-1cv8.exe ENTERPRISE /IBName "Бухгалтерия" /NАдмин /DisableStartupDialogs /URL "e1cib/data/Справочник.Номенклатура"
-```
-
-## Коды возврата
-
-| Код | Значение |
-|-----|----------|
-| `0` | Успешно |
-| `1` | Ошибка |
-| `101` | Ошибки при проверке конфигурации |
-
-Числовой код можно записать в файл через `/DumpResult <файл>`.
-
-При работе с расширениями (`-Extension`, `-AllExtensions`): 0 — успех, 1 — ошибка.
-
-## ConfigDumpInfo.xml
-
-`ConfigDumpInfo.xml` — служебный файл, создаваемый при выгрузке конфигурации в файлы (`/DumpConfigToFiles`). Содержит информацию о составе и версиях объектов конфигурации на момент выгрузки.
-
-**Назначение:**
-- Определение изменений при инкрементальной выгрузке (`-update`, `-configDumpInfoForChanges`)
-- Синхронизация состояния выгрузки с конфигурацией ИБ
-
-**Использование:**
-- `-configDumpInfoForChanges <файл>` — передать предыдущий ConfigDumpInfo.xml для определения изменений
-- `-configDumpInfoOnly` — обновить только этот файл без выгрузки объектов
-- `-updateConfigDumpInfo` — обновить файл после частичной загрузки (`/LoadConfigFromFiles`)
-
-**Расположение:** корень каталога выгрузки (рядом с `Configuration.xml`).
-
-## Переменные окружения
-
-| Переменная | Описание |
-|-----------|----------|
-| `V8_PATH` | Каталог `bin` платформы 1С (например, `C:\Program Files\1cv8\8.3.27.1859\bin`) |
-| `V8_BASE` | Путь к пустой ИБ для EPF-сборки (создаётся автоматически при первом запуске) |
-

docs/cf-guide.md

@@ -1,182 +0,0 @@
-# Корневые файлы конфигурации
-
-Навыки группы `/cf-*` позволяют создавать, анализировать, редактировать и проверять корневые файлы конфигурации 1С — `Configuration.xml`, `ConfigDumpInfo.xml`, `Languages/`.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/cf-info` | `<ConfigPath> [-Mode overview\|brief\|full]` | Анализ конфигурации: свойства, состав, счётчики объектов (3 режима) |
-| `/cf-init` | `<Name> [-Synonym] [-OutputDir] [-Version] [-Vendor]` | Создание пустой конфигурации (scaffold XML-исходников) |
-| `/cf-validate` | `<ConfigPath> [-MaxErrors 30]` | Валидация структурной корректности (8 проверок) |
-| `/cf-edit` | `<ConfigPath> -Operation <op> -Value "<val>"` | Редактирование свойств, состава ChildObjects, ролей по умолчанию (6 операций) |
-
-## Рабочий цикл
-
-```
-Описание (текст) → /cf-init → XML-исходники → /cf-validate
-                                ↕ /cf-edit      → /cf-info
-```
-
-1. `/cf-init` создаёт scaffold пустой конфигурации (Configuration.xml, ConfigDumpInfo.xml, Languages/)
-2. `/cf-edit` вносит изменения: свойства, объекты в ChildObjects, роли по умолчанию
-3. `/cf-validate` проверяет корректность XML (структура, enum-значения, ссылки, каталоги)
-4. `/cf-info` выводит компактную сводку для визуальной проверки
-
-## cf-info — режимы вывода
-
-### brief — одна строка
-
-```
-Конфигурация: БухгалтерияПредприятия — "Бухгалтерия предприятия" v3.0.181.31 | 2847 объектов | Version8_3_24
-```
-
-### overview (по умолчанию) — заголовок + ключевые свойства + счётчики
-
-```
-Конфигурация: ТестКонфигурация — "Тестовая конфигурация"
-  Version:         2.0.0.1
-  Vendor:          TestCompany
-  Compatibility:   Version8_3_24
-  DefaultLanguage: Language.Русский
-
-Объекты (4 шт.):
-  Language            1
-  Role                1
-  Catalog             1
-  Document            1
-```
-
-### full — все свойства + полный список объектов
-
-Выводит все свойства по категориям (скалярные, enum, ref), полный список ChildObjects поимённо, DefaultRoles и мобильные функциональности.
-
-## cf-edit — операции
-
-### Свойства
-
-```powershell
-# Скалярные и enum
--Operation modify-property -Value "Version=2.0.0.1 ;; Vendor=Фирма 1С ;; CompatibilityMode=Version8_3_27"
-
-# Многоязычные (LocalString)
--Operation modify-property -Value "Synonym=Моя конфигурация ;; Copyright=ООО Фирма"
-
-# Ссылка
--Operation modify-property -Value "DefaultLanguage=Language.Русский"
-```
-
-Поддерживаемые свойства:
-
-| Категория | Свойства |
-|-----------|----------|
-| Скалярные | `Name`, `Version`, `Vendor`, `Comment`, `NamePrefix`, `UpdateCatalogAddress` |
-| LocalString | `Synonym`, `BriefInformation`, `DetailedInformation`, `Copyright`, `VendorInformationAddress`, `ConfigurationInformationAddress` |
-| Enum | `CompatibilityMode`, `ConfigurationExtensionCompatibilityMode`, `DefaultRunMode`, `ScriptVariant`, `DataLockControlMode`, `ObjectAutonumerationMode`, `ModalityUseMode`, `SynchronousPlatformExtensionAndAddInCallUseMode`, `InterfaceCompatibilityMode`, `DatabaseTablespacesUseMode`, `MainClientApplicationWindowMode` |
-| Ref | `DefaultLanguage` |
-
-### Состав объектов (ChildObjects)
-
-```powershell
-# Добавить (вставляется в каноническую позицию — по типу, затем по алфавиту)
--Operation add-childObject -Value "Catalog.Товары ;; Document.Заказ ;; Enum.ВидыОплат"
-
-# Удалить
--Operation remove-childObject -Value "Catalog.Устаревший"
-```
-
-44 типа объектов поддерживаются в каноническом порядке: Language, Subsystem, StyleItem, CommonPicture, ... IntegrationService.
-
-### Роли по умолчанию (DefaultRoles)
-
-```powershell
-# Добавить
--Operation add-defaultRole -Value "ПолныеПрава"
-
-# Удалить
--Operation remove-defaultRole -Value "ПолныеПрава"
-
-# Заменить список целиком
--Operation set-defaultRoles -Value "ПолныеПрава ;; Администратор"
-```
-
-### JSON mode — комбинированные операции
-
-```json
-[
-  { "operation": "modify-property", "value": "Version=2.0.0.1 ;; Vendor=Test" },
-  { "operation": "add-childObject", "value": "Catalog.Товары ;; Document.Заказ" },
-  { "operation": "add-defaultRole", "value": "ПолныеПрава" }
-]
-```
-
-## cf-validate — проверки
-
-| # | Проверка | Уровень |
-|---|----------|---------|
-| 1 | XML well-formedness, MetaDataObject/Configuration, version | ERROR |
-| 2 | InternalInfo: 7 ContainedObject, валидные ClassId | ERROR |
-| 3 | Properties: Name, Synonym, DefaultLanguage, DefaultRunMode | ERROR/WARN |
-| 4 | Enum-значения (11 свойств) | ERROR |
-| 5 | ChildObjects: валидные типы, нет дубликатов, порядок | ERROR/WARN |
-| 6 | DefaultLanguage ссылается на существующий Language | ERROR |
-| 7 | Файлы языков `Languages/<name>.xml` существуют | WARN |
-| 8 | Каталоги объектов из ChildObjects существуют | WARN |
-
-## Сценарии использования
-
-### Обзор существующей конфигурации
-
-```
-> Покажи структуру конфигурации C:\WS\cfsrc\acc_8.3.24
-```
-
-Claude вызовет `/cf-info` и покажет: имя, синоним, версию, поставщика, количество объектов по типам.
-
-### Создание новой конфигурации
-
-```
-> Создай пустую конфигурацию МойПроект, версия 1.0.0.1, поставщик "ООО Ромашка"
-```
-
-Claude вызовет `/cf-init` → `/cf-edit` (Version, Vendor) → `/cf-validate` → `/cf-info`.
-
-### Добавление объектов в конфигурацию
-
-```
-> Добавь в конфигурацию src/ справочник Контрагенты, документ ЗаказКлиента и перечисление ВидыОплат
-```
-
-Claude вызовет `/cf-edit` с `add-childObject`, объекты встанут в каноническом порядке.
-
-### Проверка конфигурации после изменений
-
-```
-> Проверь корректность конфигурации src/
-```
-
-Claude вызовет `/cf-validate` и покажет ошибки и предупреждения.
-
-## Структура корневых файлов
-
-```
-<OutputDir>/
-├── Configuration.xml         # Свойства и состав конфигурации
-├── ConfigDumpInfo.xml        # Служебный (версии объектов)
-├── Ext/                      # Модули конфигурации
-│   ├── ManagedApplicationModule.bsl
-│   ├── SessionModule.bsl
-│   └── ...
-└── Languages/
-    └── Русский.xml           # Язык конфигурации
-```
-
-## Связь с другими навыками
-
-- `/meta-compile` — при создании объекта автоматически регистрирует его в `Configuration.xml` (вызывает логику `add-childObject`)
-- `/subsystem-edit` — при добавлении объекта в подсистему объект уже должен быть в ChildObjects
-- `/cf-edit` + `/meta-compile` — типичная связка: сначала добавить объект в конфигурацию, затем создать его исходники
-
-## Спецификации
-
-- [1c-configuration-spec.md](1c-configuration-spec.md) — XML-формат Configuration.xml, ConfigDumpInfo.xml, Languages/, свойства, 44 типа ChildObjects

docs/cfe-guide.md

@@ -1,202 +0,0 @@
-# Расширения конфигурации (CFE)
-
-Навыки группы `/cfe-*` позволяют создавать, заимствовать объекты, перехватывать методы, проверять и анализировать расширения конфигурации 1С.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/cfe-init` | `<Name> [-Purpose Patch\|Customization\|AddOn] [-CompatibilityMode]` | Создание расширения (scaffold XML-исходников) |
-| `/cfe-borrow` | `-ExtensionPath <path> -ConfigPath <path> -Object "Type.Name" [-BorrowMainAttribute]` | Заимствование объектов из конфигурации |
-| `/cfe-patch-method` | `-ExtensionPath <path> -ModulePath "Type.Name.Module" -MethodName "X" -InterceptorType Before` | Генерация перехватчика метода |
-| `/cfe-validate` | `<ExtensionPath> [-MaxErrors 30]` | Валидация структурной корректности (9 проверок) |
-| `/cfe-diff` | `-ExtensionPath <path> -ConfigPath <path> [-Mode A\|B]` | Анализ расширения и проверка переноса |
-
-## Рабочий цикл
-
-```
-cf-info (версия, совместимость)
-    ↓
-/cfe-init → scaffold расширения
-    ↓
-/cfe-borrow → заимствование объектов из конфигурации
-    ↓
-/cfe-patch-method → перехват методов
-    ↓
-/cfe-validate → проверка корректности
-    ↓
-/cfe-diff Mode A → обзор изменений
-```
-
-## Типичные сценарии
-
-### Создание расширения для исправления бага
-
-```
-> Создай расширение для исправления бага в справочнике Контрагенты,
-  конфигурация ERP в C:\cfsrc\erp
-```
-
-Claude выполнит:
-1. `/cf-info C:\cfsrc\erp -Mode brief` — получить версию и режим совместимости
-2. `/cfe-init` — создать расширение с нужным `CompatibilityMode`
-3. `/cfe-borrow` — заимствовать `Catalog.Контрагенты`
-4. `/cfe-patch-method` — создать перехватчик нужного метода
-5. `/cfe-validate` — проверить результат
-
-### Добавление реквизита в объект и вывод на форму
-
-```
-> Добавь реквизит "ОсновнойПоставщик" (тип СправочникСсылка.Партнеры)
-  в справочник Номенклатура и выведи на форму элемента.
-  Конфигурация ERP в C:\cfsrc\erp
-```
-
-Claude выполнит:
-1. `/cfe-init` — создать расширение
-2. `/cfe-borrow -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute` — заимствовать форму с реквизитами объекта
-3. `/meta-edit` — добавить новый реквизит `Расш1_ОсновнойПоставщик` в Номенклатура
-4. `/form-edit` — вывести реквизит на форму
-5. `/cfe-validate` — проверить результат
-
-### Анализ существующего расширения
-
-```
-> Покажи что изменено в расширении src/
-```
-
-Claude вызовет `/cfe-diff -Mode A` и покажет: заимствованные объекты, перехватчики, собственные объекты.
-
-### Проверка переноса изменений
-
-```
-> Проверь, все ли изменения из расширения перенесены в конфигурацию
-```
-
-Claude вызовет `/cfe-diff -Mode B` — найдёт блоки `#Вставка` и проверит их наличие в конфигурации.
-
-## cfe-init — создание расширения
-
-Параметры:
-
-| Параметр | Описание | По умолчанию |
-|----------|----------|--------------|
-| `Name` | Имя расширения (обязат.) | — |
-| `Synonym` | Синоним | = Name |
-| `NamePrefix` | Префикс собственных объектов | = Name + "_" |
-| `OutputDir` | Каталог | `src` |
-| `Purpose` | Назначение | `Customization` |
-| `Version` | Версия | — |
-| `Vendor` | Поставщик | — |
-| `CompatibilityMode` | Режим совместимости | `Version8_3_24` |
-| `NoRole` | Без основной роли | false |
-
-Создаёт:
-```
-<OutputDir>/
-├── Configuration.xml         # Свойства расширения
-├── Languages/
-│   └── Русский.xml           # Язык (Adopted)
-└── Roles/                    # Если не -NoRole
-    └── <Prefix>ОсновнаяРоль.xml
-```
-
-Назначение расширения (`Purpose`):
-- `Patch` — исправление ошибок (минимальные изменения, только перехватчики)
-- `Customization` — доработка (реквизиты, формы, модули)
-- `AddOn` — дополнение (полноценный функционал)
-
-## cfe-borrow — заимствование объектов
-
-Заимствует объекты из основной конфигурации в расширение. Создаёт минимальные XML-файлы с `ObjectBelonging=Adopted` и `ExtendedConfigurationObject`.
-
-Формат `-Object`:
-- `Catalog.Контрагенты` — справочник
-- `CommonModule.РаботаСФайлами` — общий модуль
-- `Enum.ВидыОплат` — перечисление
-- `Document.Заказ ;; Catalog.Товары` — несколько объектов через `;;`
-
-Поддерживаемые типы: Catalog, Document, Enum, CommonModule, Report, DataProcessor, ExchangePlan, InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess, Task, и другие (44 типа).
-
-### Заимствование формы с реквизитами объекта (-BorrowMainAttribute)
-
-При добавлении нового реквизита на заимствованную форму нужна опция `-BorrowMainAttribute`:
-- Без неё форма заимствуется "пустой" — только визуальные элементы, без привязки к данным
-- С ней — форма сохраняет `DataPath` привязки к реквизитам объекта (`Объект.XXX`)
-
-Два режима:
-- `Form` (по умолчанию) — заимствует только реквизиты, выведенные на форму
-- `All` — заимствует все реквизиты объекта (включая не выведенные на форму)
-
-Каскадно заимствует зависимые объекты по типам реквизитов (справочники, перечисления, определяемые типы) как оболочки. Если зависимый объект уже заимствован с содержимым — не перезаписывает его.
-
-## cfe-patch-method — перехват методов
-
-Генерирует `.bsl` файл с декоратором перехвата для заимствованного объекта.
-
-Параметры:
-
-| Параметр | Описание |
-|----------|----------|
-| `ModulePath` | `Catalog.X.ObjectModule`, `CommonModule.Y`, `Catalog.X.Form.Z` |
-| `MethodName` | Имя перехватываемого метода |
-| `InterceptorType` | `Before` / `After` / `ModificationAndControl` |
-| `Context` | `НаСервере` / `НаКлиенте` / `НаСервереБезКонтекста` |
-| `IsFunction` | Добавить `Возврат` |
-
-Типы перехватчиков:
-
-| Тип | Декоратор | Когда использовать |
-|-----|-----------|-------------------|
-| `Before` | `&Перед` | Выполнить код до вызова оригинального метода |
-| `After` | `&После` | Выполнить код после вызова оригинального метода |
-| `ModificationAndControl` | `&ИзменениеИКонтроль` | Полная замена тела метода с маркерами `#Вставка`/`#Удаление` |
-
-Пример генерируемого кода (`Before`):
-```bsl
-&НаСервере
-&Перед("ПриЗаписи")
-Процедура Расш1_ПриЗаписи()
-	// TODO: код перед вызовом оригинального метода
-КонецПроцедуры
-```
-
-## cfe-validate — проверки
-
-| # | Проверка | Уровень |
-|---|----------|---------|
-| 1 | XML well-formedness, MetaDataObject/Configuration, version | ERROR |
-| 2 | InternalInfo: 7 ContainedObject, валидные ClassId | ERROR |
-| 3 | Extension properties: ObjectBelonging=Adopted, Name, Purpose, NamePrefix, KeepMapping | ERROR |
-| 4 | Enum-значения (4 свойства) | ERROR |
-| 5 | ChildObjects: валидные типы, нет дубликатов, порядок | ERROR/WARN |
-| 6 | DefaultLanguage ссылается на существующий Language | ERROR |
-| 7 | Файлы языков существуют | WARN |
-| 8 | Каталоги объектов существуют | WARN |
-| 9 | Заимствованные объекты: ObjectBelonging=Adopted, ExtendedConfigurationObject UUID | ERROR/WARN |
-
-## cfe-diff — режимы
-
-### Mode A — обзор расширения
-
-Для каждого объекта показывает:
-- `[BORROWED]` — заимствованный: перехватчики, собственные реквизиты/формы
-- `[OWN]` — собственный: количество реквизитов, ТЧ, форм
-
-### Mode B — проверка переноса
-
-Для каждого `&ИзменениеИКонтроль` проверяет, перенесены ли блоки `#Вставка` в конфигурацию:
-- `[TRANSFERRED]` — код найден в конфигурации
-- `[NOT_TRANSFERRED]` — код не найден
-- `[NEEDS_REVIEW]` — нет блоков `#Вставка` или модуль конфигурации не найден
-
-## Связь с другими навыками
-
-- `/cf-info` — получение версии и совместимости конфигурации перед `cfe-init`
-- `/meta-compile` — создание собственных объектов расширения (реквизиты, ТЧ)
-- `/form-compile`, `/form-edit` — создание и модификация форм расширения
-- `/cfe-validate` — всегда проверяйте расширение после изменений
-
-## Спецификации
-
-- [1c-extension-spec.md](1c-extension-spec.md) — XML-формат выгрузки расширений конфигурации (CFE)

docs/db-guide.md

@@ -1,103 +0,0 @@
-# Базы данных 1С
-
-Навыки группы `/db-*` позволяют управлять информационными базами 1С из Claude Code: создавать базы, загружать и выгружать конфигурации, обновлять БД, запускать предприятие, загружать изменения из Git.
-
-## Навыки
-
-| Навык | Скрипт | Описание |
-|-------|:------:|----------|
-| `/db-list` | — | Управление реестром баз (.v8-project.json) |
-| `/db-create` | — | Создание информационной базы |
-| `/db-dump-cf` | — | Выгрузка конфигурации в CF-файл |
-| `/db-load-cf` | — | Загрузка конфигурации из CF-файла |
-| `/db-dump-xml` | `.ps1` | Выгрузка конфигурации в XML-файлы (полная/инкрементальная/частичная) |
-| `/db-load-xml` | `.ps1` | Загрузка конфигурации из XML-файлов (полная/частичная) |
-| `/db-update` | — | Обновление конфигурации БД |
-| `/db-run` | — | Запуск 1С:Предприятие |
-| `/db-load-git` | `.ps1` | Загрузка изменений из Git в базу |
-
-## Рабочий цикл
-
-```
-.v8-project.json → /db-create → /db-load-cf или /db-load-xml → /db-update → /db-run
-                                                                    ↑
-                                 /db-dump-xml ←→ правки в исходниках → /db-load-git → /db-update
-```
-
-### Типичный цикл разработки
-
-1. **Настройка** — `/db-list add` зарегистрировать базу в `.v8-project.json`
-2. **Создание** — `/db-create` создать базу (если нет)
-3. **Загрузка** — `/db-load-xml` или `/db-load-cf` загрузить конфигурацию
-4. **Обновление** — `/db-update` применить к БД
-5. **Работа** — редактирование XML-исходников
-6. **Синхронизация** — `/db-load-git` загрузить изменения из Git
-7. **Обновление** — `/db-update` применить
-8. **Запуск** — `/db-run` открыть предприятие
-
-## Формат `.v8-project.json`
-
-Полное описание формата — в [справочнике .v8-project.json](v8-project-guide.md).
-
-### Разрешение базы
-
-Все навыки `db-*` (а также `epf-build`, `epf-dump`, `erf-build`, `erf-dump`) используют единый алгоритм:
-
-1. Если пользователь указал **параметры подключения** (путь, сервер) — используй напрямую
-2. Если указал **базу по имени** — ищи: `id` → `aliases` (с учётом морфологии) → `name` (нечёткое)
-3. Если **не указал** — сопоставь текущую ветку Git с `branches` (точно или по glob-паттерну)
-4. Fallback на `default`
-5. Если не найдено — спроси пользователя
-6. После выполнения: если использованная база не зарегистрирована — предложи добавить через `/db-list add`
-
-## Сценарии использования
-
-### Создать базу и загрузить конфигурацию
-
-```
-> Создай файловую базу C:\Bases\Test и загрузи в неё конфигурацию из C:\WS\cfsrc
-```
-
-Claude вызовет `/db-create` → `/db-load-xml -Mode Full` → предложит `/db-update`.
-
-### Загрузить изменения из Git
-
-```
-> Загрузи мои последние правки в базу разработки
-```
-
-Claude вызовет `/db-load-git dev -Source All` → предложит `/db-update`.
-
-### Выгрузить конфигурацию
-
-```
-> Выгрузи конфигурацию из тестовой базы в C:\WS\cfsrc
-```
-
-Claude вызовет `/db-dump-xml test C:\WS\cfsrc -Mode Full`.
-
-### Работа с расширениями
-
-```
-> Выгрузи расширение МоёРасширение из базы dev в C:\WS\ext_src
-```
-
-Claude вызовет `/db-dump-xml dev C:\WS\ext_src -Extension МоёРасширение`.
-
-```
-> Загрузи расширение обратно в базу
-```
-
-Claude вызовет `/db-load-xml C:\WS\ext_src dev -Extension МоёРасширение` → предложит `/db-update -Extension МоёРасширение`.
-
-### Запустить предприятие
-
-```
-> Запусти базу разработки
-```
-
-Claude вызовет `/db-run dev`.
-
-## Спецификации
-
-- [build-spec.md](build-spec.md) — пакетный режим конфигуратора 1С (CREATEINFOBASE, DESIGNER, ENTERPRISE, параметры, коды возврата)

docs/epf-guide.md

@@ -1,190 +0,0 @@
-# Внешние обработки и отчёты (EPF / ERF)
-
-Навыки для создания, модификации и сборки внешних обработок (`.epf`) и внешних отчётов (`.erf`) 1С:Предприятия 8.3 из XML-исходников.
-
-## Навыки обработок (EPF)
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/epf-init` | `<Name> [Synonym]` | Создать новую обработку (корневой XML + модуль объекта) |
-| `/epf-build` | `<ProcessorName>` | Собрать EPF из XML (через 1cv8.exe) |
-| `/epf-dump` | `<EpfFile>` | Разобрать EPF в XML (через 1cv8.exe) |
-| `/epf-bsp-init` | `<ProcessorName> <Вид>` | Добавить регистрацию БСП (СведенияОВнешнейОбработке) |
-| `/epf-bsp-add-command` | `<ProcessorName> <Идентификатор>` | Добавить команду в дополнительную обработку БСП |
-| `/epf-validate` | `<ObjectPath> [-MaxErrors 30]` | Валидация структурной корректности обработки (10 проверок) |
-
-## Внешние отчёты (ERF)
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/erf-init` | `<ReportName> [Synonym] [--WithSKD]` | Создать новый отчёт (корневой XML + модуль объекта + опционально СКД) |
-| `/erf-build` | `<ReportName>` | Собрать ERF из XML (через 1cv8.exe) |
-| `/erf-dump` | `<ErfFile>` | Разобрать ERF в XML (через 1cv8.exe) |
-| `/erf-validate` | `<ObjectPath> [-MaxErrors 30]` | Валидация структурной корректности отчёта (10 проверок) |
-
-Флаг `--WithSKD` создаёт макет `ОсновнаяСхемаКомпоновкиДанных` и привязывает его к `MainDataCompositionSchema`.
-
-## Универсальные навыки
-
-Работают с любыми объектами — обработками, отчётами, справочниками, документами и др.
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/template-add` | `<ObjectName> <TemplateName> <TemplateType>` | Добавить макет (HTML, Text, SpreadsheetDocument, BinaryData, DataCompositionSchema) |
-| `/template-remove` | `<ObjectName> <TemplateName>` | Удалить макет |
-| `/help-add` | `<ObjectName>` | Добавить встроенную справку (Help.xml + HTML) |
-| `/form-remove` | `<ObjectName> <FormName>` | Удалить форму |
-
-Для отчётов: при добавлении макета типа DataCompositionSchema автоматически заполняется `MainDataCompositionSchema` (если пуст).
-
-Навыки удаления (`template-remove`, `form-remove`) не вызываются Claude автоматически — только по явной команде пользователя.
-
-## Сценарии использования
-
-Не обязательно запоминать команды и параметры. Просто опишите задачу своими словами — Claude сам подберёт нужные навыки.
-
-### Обработка с формой
-
-Типичная обработка для манипуляций с данными — форма для пользователя, модуль объекта для логики.
-
-```
-> Создай обработку ЗагрузкаПрайса с формой
-```
-
-Claude выполнит `/epf-init` и `/form-add` с правильными параметрами.
-
-### Внешняя печатная форма
-
-Обработка с макетом табличного документа, подключаемая через механизм дополнительных обработок БСП к конкретному документу.
-
-```
-> Создай внешнюю печатную форму для документа Реализация. Макет — табличный документ.
-```
-
-Claude создаст обработку, добавит макет SpreadsheetDocument, вызовет `/epf-bsp-init` с видом ПечатнаяФорма и назначением, сгенерирует `СведенияОВнешнейОбработке()` и процедуру `Печать()`.
-
-### Внешний отчёт с СКД
-
-```
-> Создай внешний отчёт ОстаткиНаСкладе с СКД
-```
-
-Claude выполнит `/erf-init ОстаткиНаСкладе --WithSKD`, затем предложит заполнить схему компоновки через `/skd-compile`.
-
-### Доработка существующей обработки
-
-```
-> Добавь справку с описанием как пользоваться обработкой
-```
-
-Claude вызовет `/help-add` и предложит отредактировать HTML.
-
-```
-> Добавь ещё одну команду печати — накладная
-```
-
-Claude вызовет `/epf-bsp-add-command`, добавит команду в `СведенияОВнешнейОбработке()` и блок обработки в процедуру `Печать()`.
-
-```
-> Собери
-```
-
-Claude вызовет `/epf-build` или `/erf-build` в зависимости от типа объекта.
-
-### Примеры слеш-команд
-
-Слеш-команды работают для случаев, когда хочется точного контроля:
-
-```
-> /epf-init МояОбработка "Моя обработка"
-> /form-add МояОбработка.xml Форма
-> /template-add МояОбработка Макет HTML
-> /help-add МояОбработка
-> /epf-build МояОбработка
-
-> /erf-init МойОтчёт --WithSKD
-> /template-add МойОтчёт ДопМакет SpreadsheetDocument
-> /erf-build МойОтчёт
-```
-
-## Структура каталогов
-
-После `/epf-init` создаётся структура:
-
-```
-src/
-├── МояОбработка.xml                          # Корневой файл метаданных
-└── МояОбработка/
-    └── Ext/
-        └── ObjectModule.bsl                  # Модуль объекта
-```
-
-После `/form-add` и `/template-add`:
-
-```
-src/
-├── МояОбработка.xml
-└── МояОбработка/
-    ├── Ext/
-    │   └── ObjectModule.bsl
-    ├── Forms/
-    │   ├── Форма.xml                         # Метаданные формы
-    │   └── Форма/
-    │       └── Ext/
-    │           ├── Form.xml                  # Описание формы
-    │           └── Form/
-    │               └── Module.bsl            # Модуль формы
-    └── Templates/
-        ├── Макет.xml                         # Метаданные макета
-        └── Макет/
-            └── Ext/
-                └── Template.html             # Содержимое макета
-```
-
-После `/erf-init МойОтчёт --WithSKD`:
-
-```
-src/
-├── МойОтчёт.xml                              # Корневой файл (ExternalReport)
-└── МойОтчёт/
-    ├── Ext/
-    │   └── ObjectModule.bsl                  # Модуль объекта
-    └── Templates/
-        ├── ОсновнаяСхемаКомпоновкиДанных.xml
-        └── ОсновнаяСхемаКомпоновкиДанных/
-            └── Ext/
-                └── Template.xml              # Пустая СКД
-```
-
-Первая добавленная форма автоматически становится основной (DefaultForm). Флаг `--main` нужен только для переназначения основной формы на другую.
-
-## Сборка и разборка
-
-### Сборка (`/epf-build`, `/erf-build`)
-
-Если база не указана — автоматически создаётся временная база с заглушками метаданных для ссылочных типов. Явная база не обязательна, но предпочтительна — обеспечивает точное соответствие типов.
-
-**Ограничение**: если на форме обработки выведены наборы записей регистров, в XML-исходниках нет информации о том, чем является поле регистра — измерением, ресурсом или реквизитом. Скрипт пытается угадать категорию по имени, но при ошибке 1С молча сбрасывает привязки колонок (DataPath). В таких случаях лучше использовать реальную базу с нужной конфигурацией.
-
-### Разборка (`/epf-dump`, `/erf-dump`)
-
-База с конфигурацией **обязательна**. Dump в пустой базе безвозвратно теряет ссылочные типы (`CatalogRef.XXX` → `xs:string`).
-
-## Технические детали
-
-- Все XML-файлы создаются в **UTF-8 с BOM** (как в реальных выгрузках 1С)
-- PowerShell-скрипты используют `System.Xml.XmlDocument` для модификации корневого XML
-- UUID генерируются через `[guid]::NewGuid()`
-- ClassId обработки: `c3831ec8-d8d5-4f93-8a22-f9bfae07327f`
-- ClassId отчёта: `e41aff26-25cf-4bb6-b6c1-3f478a75f374`
-- Порядок элементов в `ChildObjects`: TabularSections → Forms → Templates
-- Первая форма автоматически назначается основной (DefaultForm)
-- Навыки БСП (`epf-bsp-*`) не используют скрипты — Claude модифицирует код напрямую через Read/Edit
-- Для отчётов: `/template-add` с типом DataCompositionSchema автоматически заполняет `MainDataCompositionSchema`
-
-## Спецификации
-
-- [XML-формат выгрузки обработок](1c-epf-spec.md) — структура XML-файлов, namespace, элементы форм
-- [XML-формат внешних отчётов](1c-erf-spec.md) — отличия ERF от EPF, Properties, MainDataCompositionSchema
-- [Встроенная справка](1c-help-spec.md) — Help.xml, HTML-страницы, кнопка справки на форме
-- [Сборка и разборка EPF/ERF](build-spec.md) — команды `1cv8.exe`, параметры, коды возврата

docs/form-dsl-spec.md

@@ -1,531 +0,0 @@
-# Form DSL Specification
-
-Спецификация JSON-формата для `/form-compile` — компактного описания управляемых форм 1С:Предприятия 8.3.
-
----
-
-## 1. Корневой объект
-
-```json
-{
-  "title": "Заголовок формы",
-  "properties": { ... },
-  "excludedCommands": [ ... ],
-  "events": { ... },
-  "elements": [ ... ],
-  "attributes": [ ... ],
-  "parameters": [ ... ],
-  "commands": [ ... ]
-}
-```
-
-| Поле | Тип | Описание |
-|------|-----|----------|
-| `title` | string | Заголовок формы (необязательный) |
-| `properties` | object | Свойства формы (необязательный) |
-| `excludedCommands` | string[] | Исключённые стандартные команды (необязательный) |
-| `events` | object | Обработчики событий формы (необязательный) |
-| `elements` | array | Дерево UI-элементов (необязательный) |
-| `attributes` | array | Реквизиты формы (необязательный) |
-| `parameters` | array | Параметры формы (необязательный) |
-| `commands` | array | Команды формы (необязательный) |
-
----
-
-## 2. Properties — свойства формы
-
-Объект со свойствами в camelCase. Компилятор преобразует в PascalCase для XML.
-
-```json
-"properties": {
-  "autoTitle": false,
-  "windowOpeningMode": "LockOwnerWindow",
-  "commandBarLocation": "Bottom"
-}
-```
-
-### Поддерживаемые свойства
-
-| DSL ключ | XML элемент | Значения |
-|----------|-------------|----------|
-| `autoTitle` | `<AutoTitle>` | `true` / `false` |
-| `windowOpeningMode` | `<WindowOpeningMode>` | `LockOwnerWindow`, `Modeless` |
-| `commandBarLocation` | `<CommandBarLocation>` | `Top`, `Bottom`, `None` |
-| `saveDataInSettings` | `<SaveDataInSettings>` | `UseList`, `Use`, `DontUse` |
-| `autoSaveDataInSettings` | `<AutoSaveDataInSettings>` | `Use`, `DontUse` |
-| `autoTime` | `<AutoTime>` | `CurrentOrLast`, `Current`, `Last` |
-| `usePostingMode` | `<UsePostingMode>` | `Auto`, `Postings`, `Movements` |
-| `repostOnWrite` | `<RepostOnWrite>` | `true` / `false` |
-| `autoURL` | `<AutoURL>` | `true` / `false` |
-| `autoFillCheck` | `<AutoFillCheck>` | `true` / `false` |
-| `customizable` | `<Customizable>` | `true` / `false` |
-| `enterKeyBehavior` | `<EnterKeyBehavior>` | `DefaultButton`, `NewLine` |
-| `verticalScroll` | `<VerticalScroll>` | `useIfNecessary`, `Auto`, `AlwaysShow`, `Never` |
-| `width` | `<Width>` | число |
-| `height` | `<Height>` | число |
-| `group` | `<Group>` | `Vertical`, `Horizontal`, `AlwaysHorizontal`, `AlwaysVertical` |
-| `useForFoldersAndItems` | `<UseForFoldersAndItems>` | `Folders`, `Items`, `FoldersAndItems` |
-
-Нераспознанные ключи преобразуются с автоматическим PascalCase (первая буква в верхний регистр).
-
----
-
-## 3. Events — обработчики событий формы
-
-```json
-"events": {
-  "OnCreateAtServer": "ПриСозданииНаСервере",
-  "OnOpen": "ПриОткрытии"
-}
-```
-
-Ключ — имя события, значение — имя процедуры-обработчика.
-
-### Доступные события
-
-| Событие | Описание |
-|---------|----------|
-| `OnCreateAtServer` | Создание формы на сервере |
-| `OnOpen` | Открытие формы |
-| `BeforeClose` | Перед закрытием |
-| `OnClose` | При закрытии |
-| `BeforeWrite` | Перед записью |
-| `BeforeWriteAtServer` | Перед записью на сервере |
-| `OnWriteAtServer` | При записи на сервере |
-| `AfterWriteAtServer` | После записи на сервере |
-| `AfterWrite` | После записи |
-| `OnReadAtServer` | При чтении объекта |
-| `NotificationProcessing` | Обработка оповещений |
-| `ChoiceProcessing` | Обработка выбора |
-| `FillCheckProcessingAtServer` | Проверка заполнения |
-
----
-
-## 4. Elements — дерево UI-элементов
-
-Массив объектов. Тип элемента определяется ключом-идентификатором.
-
-### 4.1. Общие свойства всех элементов
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `name` | string | Имя элемента (по умолчанию — из значения ключа типа) |
-| `title` | string | Заголовок |
-| `hidden` | bool | `true` → `<Visible>false</Visible>` |
-| `disabled` | bool | `true` → `<Enabled>false</Enabled>` |
-| `readOnly` | bool | `true` → `<ReadOnly>true</ReadOnly>` |
-| `on` | string[] | Массив имён событий |
-| `handlers` | object | Явные имена обработчиков: `{"OnChange": "МойОбработчик"}` |
-
-### 4.2. Автоименование обработчиков
-
-При указании `"on"` без `"handlers"` имя обработчика генерируется автоматически:
-
-```
-<ИмяЭлемента><РусскийСуффикс>
-```
-
-| Событие | Суффикс |
-|---------|---------|
-| `OnChange` | `ПриИзменении` |
-| `StartChoice` | `НачалоВыбора` |
-| `ChoiceProcessing` | `ОбработкаВыбора` |
-| `AutoComplete` | `АвтоПодбор` |
-| `Clearing` | `Очистка` |
-| `Opening` | `Открытие` |
-| `Click` | `Нажатие` |
-| `OnActivateRow` | `ПриАктивизацииСтроки` |
-| `BeforeAddRow` | `ПередНачаломДобавления` |
-| `BeforeDeleteRow` | `ПередУдалением` |
-| `BeforeRowChange` | `ПередНачаломИзменения` |
-| `OnStartEdit` | `ПриНачалеРедактирования` |
-| `OnEndEdit` | `ПриОкончанииРедактирования` |
-| `Selection` | `ВыборСтроки` |
-| `OnCurrentPageChange` | `ПриСменеСтраницы` |
-| `TextEditEnd` | `ОкончаниеВводаТекста` |
-
-Пример: элемент `Контрагент` + событие `OnChange` → обработчик `КонтрагентПриИзменении`.
-
-### 4.3. Типы элементов
-
-#### group — UsualGroup
-
-```json
-{ "group": "horizontal", "name": "ГруппаШапка", "children": [ ... ] }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `group` | string | Ориентация: `horizontal`, `vertical`, `alwaysHorizontal`, `alwaysVertical`, `collapsible` |
-| `children` | array | Вложенные элементы |
-| `showTitle` | bool | Показывать заголовок группы |
-| `representation` | string | `none`, `normal`, `weak`, `strong` |
-| `united` | bool | Объединение |
-
-#### input — InputField
-
-```json
-{ "input": "Организация", "path": "Объект.Организация", "on": ["OnChange"] }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `path` | string | DataPath |
-| `multiLine` | bool | Многострочный режим |
-| `passwordMode` | bool | Режим пароля |
-| `titleLocation` | string | `none`, `left`, `right`, `top`, `bottom` |
-| `choiceButton` | bool | Показывать кнопку выбора |
-| `clearButton` | bool | Показывать кнопку очистки |
-| `spinButton` | bool | Показывать кнопку прокрутки |
-| `dropListButton` | bool | Показывать кнопку раскрытия |
-| `markIncomplete` | bool | Автопометка незаполненных |
-| `skipOnInput` | bool | Пропускать при вводе |
-| `inputHint` | string | Подсказка ввода (placeholder) |
-| `width` | int | Ширина |
-| `height` | int | Высота |
-| `horizontalStretch` | bool | Растягивание по горизонтали |
-| `verticalStretch` | bool | Растягивание по вертикали |
-| `autoMaxWidth` | bool | Автомаксимальная ширина |
-| `autoMaxHeight` | bool | Автомаксимальная высота |
-
-#### check — CheckBoxField
-
-```json
-{ "check": "ФлагАктивности", "path": "Активен", "on": ["OnChange"] }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `path` | string | DataPath |
-| `titleLocation` | string | Расположение заголовка |
-
-#### radio — RadioButtonField
-
-```json
-{
-  "radio": "СпособКурса",
-  "path": "Объект.СпособУстановкиКурса",
-  "radioButtonType": "Auto",
-  "choiceList": [
-    { "value": "Enum.СпособыКурса.EnumValue.Авто",   "presentation": "автоматически" },
-    { "value": "Enum.СпособыКурса.EnumValue.Ручной", "presentation": { "ru": "вручную", "en": "manual" } }
-  ]
-}
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `path` | string | DataPath |
-| `radioButtonType` | string | `Auto` (по умолчанию), `RadioButtons`, `Tumbler` |
-| `columnsCount` | int | Число колонок раскладки |
-| `titleLocation` | string | Расположение заголовка (компилятор подставляет `None`, если не задан) |
-| `choiceList` | array | Варианты выбора: массив `{ value, presentation }` |
-
-`choiceList[*]`:
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `value` | string/number/bool | Значение варианта. Для перечисления — `"Enum.ИмяТипа.EnumValue.ИмяЗначения"` (xsi:type автоматически: `xr:DesignTimeRef` / `xs:string` / `xs:decimal` / `xs:boolean`) |
-| `presentation` | string или object | Текст рядом с переключателем. Строка → ru; объект `{ru, en, ...}` → мультиязык. Если не задано — выводится из имени значения |
-
-#### label — LabelDecoration
-
-```json
-{ "label": "Подсказка", "title": "Выберите параметры", "hyperlink": true }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `title` | string | Текст надписи |
-| `hyperlink` | bool | Режим гиперссылки |
-| `width` | int | Ширина |
-| `height` | int | Высота |
-| `autoMaxWidth` | bool | Автомаксимальная ширина |
-| `autoMaxHeight` | bool | Автомаксимальная высота |
-
-#### labelField — LabelField
-
-```json
-{ "labelField": "СтатусОбработки", "path": "Статус" }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `path` | string | DataPath |
-| `hyperlink` | bool | Режим гиперссылки |
-
-#### table — Table
-
-```json
-{
-  "table": "Товары", "path": "Объект.Товары",
-  "columns": [
-    { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
-  ]
-}
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `path` | string | DataPath |
-| `columns` | array | Колонки (элементы input/check/labelField/picField, либо `columnGroup` для группировки) |
-| `representation` | string | `List`, `Tree`, `HierarchicalList` |
-| `changeRowSet` | bool | Разрешить добавление/удаление строк |
-| `changeRowOrder` | bool | Разрешить перемещение строк |
-| `height` | int | Высота в строках таблицы |
-| `header` | bool | Показывать шапку |
-| `footer` | bool | Показывать подвал |
-| `commandBarLocation` | string | `None`, `Top`, `Bottom`, `Auto` |
-| `searchStringLocation` | string | `None`, `Top`, `Bottom`, `CommandBar`, `Auto` |
-
-#### columnGroup — ColumnGroup
-
-Группа колонок таблицы. Используется только внутри `columns` таблицы. Допускается вложение `columnGroup` в `columnGroup`.
-
-```json
-{ "table": "Список", "path": "Список", "columns": [
-    { "columnGroup": "horizontal", "name": "ГруппаДата", "title": "Срок", "children": [
-        { "input": "ДатаНачала", "path": "Список.ДатаНачала" },
-        { "input": "ДатаОкончания", "path": "Список.ДатаОкончания" }
-    ]},
-    { "columnGroup": "inCell", "name": "ГруппаИсполнитель", "showInHeader": true, "children": [
-        { "input": "Исполнитель", "path": "Список.Исполнитель" }
-    ]}
-]}
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `columnGroup` | string | Ориентация: `horizontal`, `vertical`, `inCell` (склейка колонок в одной ячейке шапки) |
-| `name` | string | Имя элемента (рекомендуется задавать явно) |
-| `title` | string/object | Заголовок группы |
-| `showTitle` | bool | Показывать заголовок |
-| `showInHeader` | bool | Показывать в шапке таблицы |
-| `width` | int | Ширина |
-| `horizontalStretch` | bool | Растягивание |
-| `children` | array | Колонки внутри группы |
-
-#### pages / page — Pages / Page
-
-```json
-{
-  "pages": "Страницы", "children": [
-    { "page": "Основное", "children": [ ... ] },
-    { "page": "Дополнительно", "children": [ ... ] }
-  ]
-}
-```
-
-Page поддерживает `group` для задания ориентации содержимого и `children` для вложенных элементов.
-
-Pages поддерживает `pagesRepresentation`: `None`, `TabsOnTop`, `TabsOnBottom`, `TabsOnLeft`, `TabsOnRight`.
-
-#### button — Button
-
-```json
-{ "button": "Загрузить", "command": "Загрузить", "defaultButton": true }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `command` | string | Имя команды формы (→ `Form.Command.<name>`) |
-| `stdCommand` | string | Стандартная команда (→ `Form.StandardCommand.<name>`) |
-| `type` | string | `usual`, `hyperlink`, `commandBar` |
-| `defaultButton` | bool | Кнопка по умолчанию |
-| `picture` | string | Ссылка на картинку (`StdPicture.Name`) |
-| `representation` | string | `Auto`, `Picture`, `Text`, `PictureAndText` |
-| `locationInCommandBar` | string | `InCommandBar`, `InAdditionalSubmenu` |
-
-#### picture — PictureDecoration
-
-```json
-{ "picture": "Логотип", "src": "CommonPicture.Логотип" }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `src` или `picture` (как свойство) | string | Ссылка на картинку |
-| `hyperlink` | bool | Режим гиперссылки |
-| `width` | int | Ширина |
-| `height` | int | Высота |
-
-#### picField — PictureField
-
-```json
-{ "picField": "Фото", "path": "Фотография" }
-```
-
-Для поля, привязанного к булеву/числу (иконка-индикатор в колонке), задайте картинку значения через `valuesPicture` — без неё иконка не отрисуется:
-
-```json
-{ "picField": "Картинка", "path": "Таблица.Картинка",
-  "valuesPicture": "StdPicture.Favorites", "loadTransparent": true }
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `valuesPicture` | string | Ссылка на картинку значения (`StdPicture.*`, `CommonPicture.*`) |
-| `loadTransparent` | bool | Скрыть кадр «нет значения». Выводится только при `true` |
-
-#### calendar — CalendarField
-
-```json
-{ "calendar": "Дата", "path": "ДатаОтчета" }
-```
-
-#### cmdBar — CommandBar
-
-```json
-{ "cmdBar": "КоманднаяПанель", "children": [ ... ] }
-```
-
-#### popup — Popup
-
-```json
-{ "popup": "Печать", "picture": "StdPicture.Print", "children": [ ... ] }
-```
-
----
-
-## 5. Attributes — реквизиты формы
-
-```json
-"attributes": [
-  { "name": "Объект", "type": "DocumentObject.Реализация", "main": true },
-  { "name": "Итого", "type": "decimal(15,2)" },
-  { "name": "Таблица", "type": "ValueTable", "columns": [
-    { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },
-    { "name": "Количество", "type": "decimal(10,3)" }
-  ]}
-]
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `name` | string | Имя реквизита (обязательно) |
-| `type` | string | Тип (shorthand) |
-| `main` | bool | Основной реквизит формы |
-| `title` | string | Заголовок |
-| `savedData` | bool | Сохраняемые данные |
-| `fillChecking` | string | `Show`, `DontShow` |
-| `columns` | array | Колонки для ValueTable/ValueTree |
-
----
-
-## 6. Parameters — параметры формы
-
-```json
-"parameters": [
-  { "name": "Ключ", "type": "DocumentRef.Реализация", "key": true },
-  { "name": "Основание", "type": "DocumentRef.Реализация" }
-]
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `name` | string | Имя параметра (обязательно) |
-| `type` | string | Тип (shorthand) |
-| `key` | bool | Ключевой параметр |
-
----
-
-## 7. Commands — команды формы
-
-```json
-"commands": [
-  { "name": "Печать", "action": "ПечатьОбработка", "shortcut": "Ctrl+P" },
-  { "name": "Обновить", "action": "ОбновитьОбработка", "picture": "StdPicture.Refresh" }
-]
-```
-
-| Свойство | Тип | Описание |
-|----------|-----|----------|
-| `name` | string | Имя команды (обязательно) |
-| `action` | string | Имя процедуры-обработчика |
-| `title` | string | Заголовок |
-| `shortcut` | string | Клавиатурное сочетание |
-| `picture` | string | Ссылка на картинку |
-| `representation` | string | `Auto`, `Picture`, `Text`, `PictureAndText` |
-
----
-
-## 8. Система типов (shorthand)
-
-### Примитивные типы
-
-| DSL | XML |
-|-----|-----|
-| `"string"` | `xs:string` (неограниченная) |
-| `"string(100)"` | `xs:string` + Length=100 |
-| `"decimal(15,2)"` | `xs:decimal` + Digits=15, FractionDigits=2, AllowedSign=Any |
-| `"decimal(10,0,nonneg)"` | `xs:decimal` + AllowedSign=Nonnegative |
-| `"boolean"` | `xs:boolean` |
-| `"date"` | `xs:dateTime` + DateFractions=Date |
-| `"dateTime"` | `xs:dateTime` + DateFractions=DateTime |
-| `"time"` | `xs:dateTime` + DateFractions=Time |
-
-### Ссылочные типы
-
-| DSL | XML |
-|-----|-----|
-| `"CatalogRef.Организации"` | `cfg:CatalogRef.Организации` |
-| `"DocumentObject.Реализация"` | `cfg:DocumentObject.Реализация` |
-| `"EnumRef.СтавкиНДС"` | `cfg:EnumRef.СтавкиНДС` |
-| `"DataProcessorObject.ЗагрузкаДанных"` | `cfg:DataProcessorObject.ЗагрузкаДанных` |
-
-### Платформенные типы
-
-| DSL | XML |
-|-----|-----|
-| `"ValueTable"` | `v8:ValueTable` |
-| `"ValueTree"` | `v8:ValueTree` |
-| `"ValueList"` | `v8:ValueListType` |
-| `"FormattedString"` | `v8ui:FormattedString` |
-| `"Picture"` | `v8ui:Picture` |
-| `"DynamicList"` | `cfg:DynamicList` |
-
-### Составные типы
-
-Разделитель `" | "`:
-
-```json
-"type": "CatalogRef.Организации | CatalogRef.ИндивидуальныеПредприниматели"
-```
-
----
-
-## 9. Автогенерация
-
-### Companion-элементы
-
-Для каждого элемента автоматически создаются служебные вложенные элементы:
-
-| Тип элемента | Companions |
-|---|---|
-| UsualGroup | ExtendedTooltip |
-| InputField | ContextMenu, ExtendedTooltip |
-| CheckBoxField | ContextMenu, ExtendedTooltip |
-| RadioButtonField | ContextMenu, ExtendedTooltip |
-| LabelDecoration | ContextMenu, ExtendedTooltip |
-| LabelField | ContextMenu, ExtendedTooltip |
-| PictureDecoration | ContextMenu, ExtendedTooltip |
-| PictureField | ContextMenu, ExtendedTooltip |
-| CalendarField | ContextMenu, ExtendedTooltip |
-| Table | ContextMenu, AutoCommandBar, SearchStringAddition, ViewStatusAddition, SearchControlAddition |
-| Pages | ExtendedTooltip |
-| Page | ExtendedTooltip |
-| Button | ExtendedTooltip |
-
-Именование: `<name>КонтекстноеМеню`, `<name>РасширеннаяПодсказка`, `<name>КоманднаяПанель`, `<name>СтрокаПоиска`, `<name>СостояниеПросмотра`, `<name>УправлениеПоиском`.
-
-### ID
-
-Последовательная нумерация начиная с 1. `AutoCommandBar` формы всегда имеет `id="-1"`.
-
-### Namespace
-
-Все 17 namespace-деклараций добавляются автоматически (version="2.17").
-
-### Кодировка
-
-UTF-8 с BOM (как в файлах конфигурации 1С).

docs/form-guide.md

@@ -1,266 +0,0 @@
-# Управляемые формы (Form)
-
-Навыки группы `/form-*` позволяют анализировать, генерировать и валидировать управляемые формы 1С:Предприятия 8.3 из XML-исходников, не читая тысячи строк XML.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/form-add` | `<ObjectPath> <FormName> [Purpose]` | Добавление формы к объекту конфигурации (Document, Catalog и др.) |
-| `/form-info` | `<FormPath>` | Компактная сводка: дерево элементов, реквизиты, команды, события |
-| `/form-compile` | `<JsonPath> <OutputPath>` | Генерация Form.xml из компактного JSON-определения |
-| `/form-validate` | `<FormPath>` | Валидация: уникальность ID, companions, DataPath, команды |
-| `/form-edit` | `<FormPath> <JsonPath>` | Добавление элементов, реквизитов, команд в существующую форму |
-| `/form-patterns` | (без параметров) | Справочник паттернов: архетипы, конвенции именования, продвинутые приёмы |
-
-## Сценарии использования
-
-### Добавление новой формы к объекту конфигурации
-
-`/form-add` создаёт каркас управляемой формы (metadata XML + Form.xml + Module.bsl) и регистрирует её в объекте конфигурации. Поддерживает Document, Catalog, DataProcessor, Report, InformationRegister и другие типы.
-
-```
-> Добавь форму документа к Documents/АвансовыйОтчет.xml
-```
-
-Claude вызовет `/form-add` с нужными параметрами. Назначение формы (Purpose) определяет структуру: Object — форма объекта с реквизитом «Объект», List/Choice — форма списка с DynamicList, Record — форма записи регистра.
-
-Типичный workflow:
-
-1. `/form-add` — создать каркас (metadata + Form.xml + Module.bsl)
-2. `/form-compile` или `/form-edit` — наполнить Form.xml элементами
-3. `/form-validate` — проверить корректность
-4. `/form-info` — проанализировать результат
-
-### Анализ формы перед модификацией
-
-Файлы Form.xml содержат от сотен до десятков тысяч строк XML. 80% объёма — визуальный шум (цвета, шрифты, размеры, автогенерированные подсказки). `/form-info` извлекает суть.
-
-```
-> Покажи структуру формы документа РеализацияТоваровУслуг
-```
-
-Claude найдёт Form.xml и вызовет `/form-info`. Результат — компактная сводка (40–100 строк вместо тысяч):
-
-```
-=== Form: ФормаДокумента — "Реализация товаров и услуг" (Documents.РеализацияТоваровУслуг) ===
-
-Properties: AutoTitle=false, CommandBarLocation=None
-
-Events:
-  OnCreateAtServer -> ПриСозданииНаСервере
-  OnOpen -> ПриОткрытии
-
-Elements:
-  ├─ [Group:AH] ГруппаШапка
-  │ ├─ [Input] Организация -> Объект.Организация {OnChange}
-  │ └─ [Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}
-  ├─ [Table] Товары -> Объект.Товары
-  │ ├─ [Input] Номенклатура -> Объект.Товары.Номенклатура {OnChange}
-  │ └─ [Input] Сумма -> Объект.Товары.Сумма [ro]
-  └─ [Pages] Страницы
-     ├─ [Page] Основное (5 items)
-     └─ [Page] Печать (2 items)
-
-Attributes:
-  *Объект: DocumentObject.РеализацияТоваровУслуг (main)
-  Валюта: CatalogRef.Валюты
-  ...
-
-Commands:
-  Печать -> ПечатьДокумента [Ctrl+P]
-```
-
-### Добавление элементов в существующую форму
-
-`/form-edit` добавляет элементы, реквизиты и команды в существующий Form.xml. Автоматически назначает ID, генерирует companion-элементы и обработчики событий.
-
-```
-> Добавь поле "Склад" в шапку формы после "Контрагент"
-```
-
-Claude вызовет `/form-info` для анализа структуры, создаст JSON и вызовет `/form-edit`:
-
-```json
-{
-  "into": "ГруппаШапка",
-  "after": "Контрагент",
-  "elements": [
-    { "input": "Склад", "path": "Объект.Склад", "on": ["OnChange"] }
-  ],
-  "attributes": [
-    { "name": "Склад", "type": "CatalogRef.Склады" }
-  ]
-}
-```
-
-Позиционирование: `into` указывает группу-контейнер, `after` — элемент, после которого вставлять. Оба опциональны (по умолчанию — в конец корневого ChildItems).
-
-Один вызов может содержать элементы, реквизиты и команды одновременно. Группы поддерживают `children` для вложенных элементов.
-
-### Поиск обработчиков и привязок
-
-Из сводки видно, какие события подключены к каким элементам:
-
-```
-> Какие обработчики срабатывают при изменении контрагента?
-```
-
-Claude вызовет `/form-info` и найдёт: `[Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}` — далее откроет модуль формы и найдёт процедуры по именам событий.
-
-### Точечное погружение в детали
-
-Сводка — это карта. Для деталей по конкретному элементу достаточно grep по имени из сводки:
-
-```
-> Покажи все свойства элемента ДоговорКонтрагента
-```
-
-Claude сделает grep по Form.xml и найдёт полный XML-блок с ChoiceParameters, ChoiceFoldersAndItems, стилями и прочими свойствами.
-
-## Чтение вывода
-
-### Дерево элементов
-
-| Обозначение | Элемент |
-|---|---|
-| `[Group:V]` `[Group:H]` `[Group:AH]` `[Group:AV]` | Группа (Vertical / Horizontal / AlwaysHorizontal / AlwaysVertical) |
-| `[Input]` | Поле ввода |
-| `[Check]` | Флажок |
-| `[Label]` | Декоративная надпись |
-| `[LabelField]` | Поле надписи (привязанное к данным) |
-| `[Table]` | Таблица |
-| `[Pages]` / `[Page]` | Вкладки (страницы показывают количество элементов) |
-| `[Button]` | Кнопка |
-| `[CmdBar]` | Командная панель |
-| `[Popup]` | Выпадающее меню |
-| `[Picture]` | Декоративная картинка |
-| `[PicField]` | Поле картинки |
-| `[Calendar]` | Календарь |
-
-### Флаги
-
-Показываются только при отклонении от умолчания:
-- `[visible:false]` — элемент скрыт (Visible=false)
-- `[enabled:false]` — элемент недоступен (Enabled=false)
-- `[ro]` — только чтение (ReadOnly=true)
-- `,collapse` — сворачиваемая группа (Behavior=Collapsible)
-
-### Привязки и события
-
-- `-> Объект.Поле` — DataPath (привязка к данным)
-- `-> Имя [cmd]` — привязка к команде формы
-- `-> Close [std]` — привязка к стандартной команде
-- `{OnChange, StartChoice}` — имена подключённых событий
-- `[title:Текст]` — заголовок, если отличается от имени элемента
-
-### Реквизиты
-
-- `*Объект: DocumentObject.Реализация (main)` — основной реквизит формы
-- `Таблица: ValueTable [Кол1: тип, Кол2: тип]` — таблица значений с колонками
-- `Список: DynamicList -> Catalog.Пользователи` — динамический список с основной таблицей
-
-## Генерация формы с нуля
-
-`/form-compile` принимает компактное JSON-определение (20–50 строк) и генерирует полный Form.xml (100–500+ строк) с namespace-декларациями, companion-элементами и последовательными ID.
-
-```
-> Создай форму загрузки данных с полями Организация, Контрагент, таблицей Товары и кнопкой Загрузить
-```
-
-Claude создаст JSON-определение и вызовет `/form-compile`. Пример JSON:
-
-```json
-{
-  "properties": { "autoTitle": false },
-  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
-  "elements": [
-    { "group": "horizontal", "name": "Шапка", "children": [
-      { "input": "Организация", "path": "Объект.Организация", "on": ["OnChange"] },
-      { "input": "Контрагент", "path": "Объект.Контрагент" }
-    ]},
-    { "table": "Товары", "path": "Объект.Товары", "columns": [
-      { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" },
-      { "input": "Сумма", "path": "Объект.Товары.Сумма", "readOnly": true }
-    ]},
-    { "button": "Загрузить", "command": "Загрузить" }
-  ],
-  "attributes": [
-    { "name": "Объект", "type": "DataProcessorObject.ЗагрузкаДанных", "main": true }
-  ],
-  "commands": [
-    { "name": "Загрузить", "action": "ЗагрузитьОбработка" }
-  ]
-}
-```
-
-### Верификация результата
-
-После компиляции используйте `/form-validate` и `/form-info` для проверки:
-
-```
-> /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml
-> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
-```
-
-`/form-validate` проверит структурную корректность (ID, companions, ссылки), `/form-info` покажет результат в виде компактной сводки.
-
-## Генерация из метаданных объекта
-
-`/form-compile` умеет автоматически генерировать форму из метаданных объекта (XML-выгрузки). Скрипт читает реквизиты, табличные части, стандартные реквизиты и строит форму по стандарту ERP.
-
-```
-> Создай форму документа ЗаказКлиенту
-```
-
-Claude вызовет `/form-compile` с флагом `-FromObject`. Назначение формы (Purpose) автоматически определяется из имени формы (ФормаДокумента -> Item, ФормаСписка -> List, ФормаВыбора -> Choice).
-
-Поддерживаемые типы: Document, Catalog, InformationRegister, AccumulationRegister, ChartOfCharacteristicTypes, ExchangePlan, ChartOfAccounts.
-
-Не поддерживается: DataProcessor (реквизиты объекта пустые -- форма строится на реквизитах формы, используйте JSON DSL).
-
-### Project-level пресеты
-
-Раскладка формы управляется пресетом (по умолчанию `erp-standard`). Для настройки под проект создайте файл:
-
-```
-<project-root>/presets/skills/form/erp-standard.json
-```
-
-Файл накладывается поверх встроенного пресета через deep merge -- достаточно указать только переопределяемые ключи. Полная документация ключей: `.claude/skills/form-compile/presets/README.md`.
-
-## Примеры слеш-команд
-
-```
-> /form-info upload/acc_8.3.24/Documents/РеализацияТоваровУслуг/Forms/ФормаДокумента/Ext/Form.xml
-> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
-> /form-compile src/form.json src/МояОбработка/Forms/Форма/Ext/Form.xml
-> /form-edit src/МояОбработка/Forms/Форма/Ext/Form.xml src/additions.json
-> /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml
-```
-
-## Связь с EPF-навыками
-
-Навыки `/form-*` работают с формами из любых источников — конфигурации и внешних обработок.
-
-При работе с объектами конфигурации:
-
-1. `/form-add` — создать форму (каркас + регистрация в объекте)
-2. `/form-compile` или `/form-edit` — наполнить Form.xml элементами
-3. `/form-validate` — проверить корректность
-4. `/form-info` — проанализировать результат
-
-При работе с внешними обработками:
-
-1. `/form-add` — создать форму (каркас)
-2. `/form-compile` — сгенерировать Form.xml из JSON-определения
-3. `/form-edit` — добавить элементы/реквизиты/команды в существующую форму
-4. `/form-validate` — проверить корректность
-5. `/form-info` — проанализировать результат
-6. `/epf-build` — собрать EPF
-
-## Спецификации
-
-- [Управляемая форма](1c-form-spec.md) — Form.xml, элементы, команды, реквизиты, система типов
-- [Form DSL](form-dsl-spec.md) — JSON-формат описания формы для `/form-compile` и `/form-edit`
-- [Паттерны компоновки](form-patterns.md) — типовые архетипы форм, конвенции именования, примеры DSL

docs/form-patterns.md

@@ -1,337 +0,0 @@
-# Паттерны компоновки управляемых форм
-
-Рекомендации по дизайну форм, извлечённые из типовых конфигураций 1С. Используйте при создании форм через `/form-compile`, когда требования пользователя не детализируют расположение элементов.
-
-## Архетипы форм
-
-### Форма документа
-
-```
-Шапка (horizontal, 2 колонки)
-├─ Левая (vertical): НомерДата (H: Номер + Дата "от"), Контрагент, Договор
-├─ Правая (vertical): Организация, Подразделение, ЦеныИВалюта (надпись-ссылка)
-Страницы (pages)
-├─ Товары: таблица Объект.Товары
-├─ Услуги: таблица Объект.Услуги (опционально)
-└─ Дополнительно: прочие реквизиты
-Подвал (vertical)
-├─ Итоги (horizontal): Всего, НДС, Скидка
-└─ КомментарийОтветственный (horizontal): Комментарий + Ответственный
-```
-
-**Типичные события:** OnCreateAtServer, OnReadAtServer, OnOpen, BeforeWriteAtServer, AfterWriteAtServer, AfterWrite, NotificationProcessing
-
-**Свойства:** autoTitle=false, командная панель со стандартными + глобальными командами
-
-### Форма обработки (DataProcessor)
-
-```
-Параметры (vertical)
-├─ Группа полей ввода (Организация, Период, режимы работы)
-├─ Информационные надписи (label, hyperlink)
-Рабочая область
-├─ Таблица данных или Pages с вкладками
-Кнопки действий
-├─ Выполнить / Применить (defaultButton)
-├─ Закрыть (stdCommand: Close)
-```
-
-**Типичные события:** OnCreateAtServer, OnOpen, NotificationProcessing
-
-**Свойства:** windowOpeningMode=LockOwnerWindow (если диалог), autoTitle=false
-
-### Форма списка
-
-```
-Отборы (group: alwaysHorizontal)
-├─ ГруппаОтбор[Поле] (H): Флажок + Поле ввода (для каждого фильтра)
-Список (table, DynamicList)
-├─ Колонки: labelField (не input — данные только для чтения)
-```
-
-**Типичные события:** OnCreateAtServer, OnOpen, NotificationProcessing, OnLoadDataFromSettingsAtServer
-
-**Свойства:** autoSaveDataInSettings=Use (запомнить отборы)
-
-**Фильтры:** пара реквизитов на каждый фильтр — `Отбор[Поле]` (значение) + `Отбор[Поле]Использование` (boolean, флажок вкл/выкл)
-
-### Форма элемента справочника
-
-**Простая:**
-```
-ГруппаРеквизитов (horizontal)
-├─ Наименование -> Объект.Description
-└─ Код -> Объект.Code (если нужен)
-```
-
-**Сложная:**
-```
-Главное (vertical)
-├─ Наименование -> Объект.Description
-├─ Параметры (horizontal, 2 колонки)
-│  ├─ Левая: основные реквизиты
-│  └─ Правая: дополнительные реквизиты
-└─ КонтактныеДанные / Дополнительно (vertical)
-```
-
-**Типичные события:** OnCreateAtServer, OnReadAtServer, BeforeWriteAtServer, NotificationProcessing
-
-### Мастер (Wizard)
-
-```
-Страницы (pages, OnCurrentPageChange)
-├─ Шаг1: описание + параметры
-├─ Шаг2: основная работа
-└─ Шаг3: результат
-Кнопки (horizontal)
-├─ Назад (command), Далее (command, defaultButton), Выполнить (command)
-└─ Закрыть (stdCommand: Close)
-```
-
-**Свойства:** windowOpeningMode=LockOwnerWindow
-
-## Конвенции именования
-
-### Группы
-
-| Назначение | Имя | Тип |
-|-----------|-----|-----|
-| Шапка | `ГруппаШапка` | horizontal |
-| Левая колонка | `ГруппаШапкаЛевая` | vertical |
-| Правая колонка | `ГруппаШапкаПравая` | vertical |
-| Номер+Дата | `ГруппаНомерДата` | horizontal |
-| Подвал | `ГруппаПодвал` | vertical |
-| Итоги | `ГруппаИтоги` | horizontal |
-| Кнопки | `ГруппаКнопок` | horizontal |
-| Страницы | `ГруппаСтраницы` / `Страницы` | pages |
-| Предупреждение | `ГруппаПредупреждение` | horizontal, visible:false |
-| Доп. секция | `ГруппаДополнительно` / `ГруппаПрочее` | vertical, collapse |
-
-### Элементы
-
-| Назначение | Имя | Суффикс |
-|-----------|-----|---------|
-| Поле в таблице | `[Таблица][Поле]` | — |
-| Итог | `Итоги[Поле]` | — |
-| Надпись-ссылка | `[Поле]Надпись` | — |
-| Фильтр | `Отбор[Поле]` | — |
-| Флажок фильтра | `Отбор[Поле]Использование` | — |
-| Кнопка команды | `[Команда]Кнопка` | — |
-| Баннер-картинка | `[Баннер]Картинка` | — |
-| Баннер-надпись | `[Баннер]Надпись` | — |
-| Подменю | `Подменю[Действие]` | — |
-
-### Обработчики событий
-
-Имя обработчика = имя элемента + суффикс события на русском:
-
-| Событие | Суффикс | Пример |
-|---------|---------|--------|
-| OnChange | ПриИзменении | `ОрганизацияПриИзменении` |
-| StartChoice | НачалоВыбора | `КонтрагентНачалоВыбора` |
-| Click | Нажатие | `ЦеныИВалютаНажатие` |
-| OnEditEnd | ПриОкончанииРедактирования | `ТоварыПриОкончанииРедактирования` |
-| OnStartEdit | ПриНачалеРедактирования | `ТоварыПриНачалеРедактирования` |
-
-Обработчики формы — стандартные имена: `ПриСозданииНаСервере`, `ПриОткрытии`, `ПередЗакрытием`, `ОбработкаОповещения`.
-
-## Принципы компоновки
-
-1. **Порядок чтения.** Сверху вниз, слева направо. Самое важное — вверху.
-2. **Двухколоночная шапка.** Основные реквизиты слева (контрагент, склад), организационные справа (организация, подразделение).
-3. **Кнопки действий внизу.** Главная кнопка — `defaultButton: true`. Закрыть — всегда последняя.
-4. **Таблицы — основная область.** Табличные части занимают большую часть формы, обычно на Pages.
-5. **Итоги рядом с таблицей.** В подвале, горизонтальная группа, все поля readOnly.
-6. **Фильтры — отдельная зона.** Над списком, горизонтальная группа (alwaysHorizontal), пара "флажок + поле" на каждый фильтр.
-7. **Скрытые элементы для состояний.** Баннеры, предупреждения — `visible: false` по умолчанию, показываются программно.
-8. **Надписи-ссылки для диалогов.** `labelField` с `hyperlink: true` и событием Click — для открытия подформ (ЦеныИВалюта, УчётнаяПолитика).
-
-## Продвинутые паттерны (ERP)
-
-Извлечены из конфигурации «Управление предприятием» (ERP 8.3.24). Применяйте в сложных формах.
-
-### Сворачиваемые группы (Collapsible)
-
-Для необязательных секций — «Подписи», «Дополнительно», «Прочее». Сворачиваются по умолчанию, экономят место.
-
-```
-ГруппаПодписи (vertical, collapse, collapsed)
-├─ Руководитель -> Объект.Руководитель
-└─ ГлавныйБухгалтер -> Объект.ГлавныйБухгалтер
-```
-
-DSL:
-```json
-{ "group": "vertical", "name": "ГруппаПодписи", "title": "Подписи",
-  "behavior": "Collapsible", "collapsed": true, "children": [
-    { "input": "Руководитель", "path": "Объект.Руководитель" },
-    { "input": "ГлавныйБухгалтер", "path": "Объект.ГлавныйБухгалтер" }
-]}
-```
-
-### Баннер-предупреждение (Status Banner)
-
-Группа «картинка + надпись» без заголовка, скрыта по умолчанию. Показывается программно при определённых условиях (просрочка, блокировка, информация).
-
-```
-ГруппаПредупреждение (horizontal, showTitle:false, visible:false)
-├─ [Picture] ПредупреждениеКартинка -> StdPicture.Information
-└─ [Label] ПредупреждениеНадпись (maxWidth:76, textColor:style:ПоясняющийТекст)
-```
-
-DSL:
-```json
-{ "group": "horizontal", "name": "ГруппаПредупреждение", "showTitle": false,
-  "visible": false, "children": [
-    { "picture": "ПредупреждениеКартинка" },
-    { "label": "ПредупреждениеНадпись", "title": "Текст предупреждения",
-      "maxWidth": 76, "autoMaxWidth": false }
-]}
-```
-
-### Выпадающее меню в командной панели (Popup)
-
-Группировка связанных команд (печать, отправка, выгрузка) в одну кнопку-меню с иконкой.
-
-```
-[CmdBar] КоманднаяПанель
-├─ [Popup] ПодменюПечать (picture: StdPicture.Print, representation: Picture)
-│  ├─ [Button] ПечатьНакладная -> Печать [cmd]
-│  └─ [Button] ПечатьСчёт -> ПечатьСчёт [cmd]
-└─ [Popup] ПодменюОтправить (picture: StdPicture.SendByEmail)
-   └─ [Button] ОтправитьПоПочте -> Отправить [cmd]
-```
-
-DSL:
-```json
-{ "cmdBar": "КоманднаяПанель", "children": [
-    { "popup": "ПодменюПечать", "title": "Печать",
-      "picture": "StdPicture.Print", "representation": "Picture", "children": [
-        { "button": "ПечатьНакладная", "command": "Печать" },
-        { "button": "ПечатьСчёт", "command": "ПечатьСчёт" }
-    ]},
-    { "popup": "ПодменюОтправить", "title": "Отправить",
-      "picture": "StdPicture.SendByEmail", "representation": "Picture", "children": [
-        { "button": "ОтправитьПоПочте", "command": "Отправить" }
-    ]}
-]}
-```
-
-### Форма без стандартной командной панели
-
-Для модальных диалогов и мастеров — отключение стандартной командной панели, полностью ручное управление кнопками.
-
-```
-properties: commandBarLocation=None, windowOpeningMode=LockWholeInterface
-Содержимое (vertical)
-├─ ... рабочая область ...
-ГруппаКнопок (horizontal)
-├─ Назад (command), Далее (command, defaultButton)
-└─ Закрыть (stdCommand: Close)
-```
-
-DSL:
-```json
-{
-  "properties": { "commandBarLocation": "None", "windowOpeningMode": "LockWholeInterface" },
-  "elements": [
-    { "group": "vertical", "name": "Содержимое", "children": [ "..." ] },
-    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
-      { "button": "Назад", "command": "Назад" },
-      { "button": "Далее", "command": "Далее", "defaultButton": true },
-      { "button": "Закрыть", "stdCommand": "Close" }
-    ]}
-  ]
-}
-```
-
-### Надпись-гиперссылка для открытия подформ
-
-`labelField` с `hyperlink: true` и событием Click — вместо кнопки. Типичный приём для «ЦеныИВалюта», «УчётнаяПолитика» и подобных.
-
-```
-[LabelField] ЦеныИВалютаНадпись -> ЦеныИВалюта (hyperlink) {Click}
-```
-
-DSL:
-```json
-{ "labelField": "ЦеныИВалютаНадпись", "path": "ЦеныИВалюта",
-  "hyperlink": true, "on": ["Click"] }
-```
-
-## Примеры DSL
-
-### Типичная форма обработки
-
-```json
-{
-  "title": "Загрузка данных из CSV",
-  "properties": { "autoTitle": false, "windowOpeningMode": "LockOwnerWindow" },
-  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
-  "elements": [
-    { "group": "vertical", "name": "ГруппаПараметры", "children": [
-      { "input": "ФайлЗагрузки", "path": "ФайлЗагрузки", "title": "Файл", "clearButton": true, "horizontalStretch": true, "on": ["StartChoice"] },
-      { "input": "Кодировка", "path": "Кодировка", "title": "Кодировка" },
-      { "input": "Разделитель", "path": "Разделитель", "title": "Разделитель колонок" }
-    ]},
-    { "table": "Данные", "path": "Объект.Данные", "on": ["OnStartEdit"], "columns": [
-      { "input": "ДанныеНомерСтроки", "path": "Объект.Данные.LineNumber", "readOnly": true, "title": "№" },
-      { "input": "ДанныеНаименование", "path": "Объект.Данные.Наименование" },
-      { "input": "ДанныеКоличество", "path": "Объект.Данные.Количество", "on": ["OnChange"] },
-      { "input": "ДанныеСумма", "path": "Объект.Данные.Сумма", "readOnly": true }
-    ]},
-    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
-      { "button": "Загрузить", "command": "Загрузить", "title": "Загрузить из файла", "defaultButton": true },
-      { "button": "Очистить", "command": "Очистить", "title": "Очистить таблицу" },
-      { "button": "Закрыть", "stdCommand": "Close" }
-    ]}
-  ],
-  "attributes": [
-    { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзCSV", "main": true },
-    { "name": "ФайлЗагрузки", "type": "string" },
-    { "name": "Кодировка", "type": "string(20)" },
-    { "name": "Разделитель", "type": "string(5)" }
-  ],
-  "commands": [
-    { "name": "Загрузить", "action": "ЗагрузитьОбработка" },
-    { "name": "Очистить", "action": "ОчиститьОбработка" }
-  ]
-}
-```
-
-### Типичная форма со списком и фильтрами
-
-```json
-{
-  "properties": { "autoTitle": false, "autoSaveDataInSettings": "Use" },
-  "events": {
-    "OnCreateAtServer": "ПриСозданииНаСервере",
-    "NotificationProcessing": "ОбработкаОповещения"
-  },
-  "elements": [
-    { "group": "alwaysHorizontal", "name": "ГруппаОтборы", "children": [
-      { "group": "horizontal", "name": "ГруппаОтборОрганизация", "children": [
-        { "check": "ОтборОрганизацияИспользование", "path": "ОтборОрганизацияИспользование", "titleLocation": "none", "on": ["OnChange"] },
-        { "input": "ОтборОрганизация", "path": "ОтборОрганизация", "title": "Организация", "on": ["OnChange"] }
-      ]},
-      { "group": "horizontal", "name": "ГруппаОтборКонтрагент", "children": [
-        { "check": "ОтборКонтрагентИспользование", "path": "ОтборКонтрагентИспользование", "titleLocation": "none", "on": ["OnChange"] },
-        { "input": "ОтборКонтрагент", "path": "ОтборКонтрагент", "title": "Контрагент", "on": ["OnChange"] }
-      ]}
-    ]},
-    { "table": "Список", "path": "Список", "on": ["Selection", "OnActivateRow"], "columns": [
-      { "labelField": "СписокДата", "path": "Список.Дата", "title": "Дата" },
-      { "labelField": "СписокНомер", "path": "Список.Номер", "title": "Номер" },
-      { "labelField": "СписокКонтрагент", "path": "Список.Контрагент" },
-      { "labelField": "СписокСумма", "path": "Список.Сумма" }
-    ]}
-  ],
-  "attributes": [
-    { "name": "Список", "type": "DynamicList", "mainTable": "Document.РеализацияТоваров" },
-    { "name": "ОтборОрганизация", "type": "CatalogRef.Организации" },
-    { "name": "ОтборОрганизацияИспользование", "type": "boolean" },
-    { "name": "ОтборКонтрагент", "type": "CatalogRef.Контрагенты" },
-    { "name": "ОтборКонтрагентИспользование", "type": "boolean" }
-  ]
-}
-```

docs/meta-guide.md

@@ -1,187 +0,0 @@
-# Объекты метаданных конфигурации
-
-Навыки группы `/meta-*` позволяют создавать, анализировать, редактировать и проверять объекты метаданных конфигурации 1С — справочники, документы, регистры, перечисления и ещё 19 типов объектов из XML-выгрузки.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/meta-info` | `<ObjectPath> [-Mode] [-Name]` | Анализ структуры объекта: реквизиты, ТЧ, формы, движения, типы (8 режимов) |
-| `/meta-compile` | `<JsonPath> <OutputPath>` | Создание объекта метаданных из JSON DSL: реквизиты, ТЧ, свойства, формы |
-| `/meta-edit` | `<ObjectPath> -Operation <op> -Value "<val>"` | Точечное редактирование: 30+ атомарных операций (add/remove/modify/set) |
-| `/meta-remove` | `<ConfigDir> -Object <Type.Name> [-DryRun] [-Force]` | Безопасное удаление объекта с проверкой ссылок (блокирует при наличии) |
-| `/meta-validate` | `<ObjectPath> [-MaxErrors 20]` | Валидация структурной корректности: ~40 проверок |
-
-## Рабочий цикл
-
-```
-Описание объекта (текст) → JSON DSL → /meta-compile → XML-исходники → /meta-validate
-                                                       ↕ /meta-edit      → /meta-info
-                                                       ↕ /meta-remove (безопасное удаление)
-```
-
-1. Claude формирует JSON-определение объекта (тип, реквизиты, ТЧ, свойства)
-2. `/meta-compile` генерирует XML-исходники с корректными UUID, namespace, структурой ChildObjects
-3. `/meta-edit` вносит точечные изменения: добавление/удаление реквизитов, ТЧ, владельцев, движений и т.д.
-4. `/meta-remove` безопасно удаляет объект (проверяет ссылки в реквизитах, коде, формах; чистит Configuration.xml и подсистемы)
-5. `/meta-validate` проверяет корректность XML
-6. `/meta-info` выводит компактную сводку для визуальной проверки
-
-## Поддерживаемые типы объектов (23 типа)
-
-| Группа | Типы |
-|--------|------|
-| Прикладные | Catalog, Document, Enum, ChartOfCharacteristicTypes, ChartOfAccounts, ChartOfCalculationTypes |
-| Процессы | BusinessProcess, Task |
-| Регистры | InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister |
-| Отчёты/обработки | Report, DataProcessor |
-| Интеграция | ExchangePlan, HTTPService, WebService |
-| Журналы | DocumentJournal, Sequence |
-| Прочие | Constant, CommonModule, SessionParameter, FunctionalOption, DefinedType |
-
-## Inline mode — типовые операции
-
-### Реквизиты
-
-```powershell
-# Добавить
--Operation add-attribute -Value "Комментарий: Строка(200) ;; Сумма: Число(15,2) | req, index"
-
-# С позиционной вставкой
--Operation add-attribute -Value "Склад: CatalogRef.Склады >> after Организация"
-
-# Удалить
--Operation remove-attribute -Value "УстаревшийРеквизит"
-
-# Переименовать + сменить тип
--Operation modify-attribute -Value "СтароеИмя: name=НовоеИмя, type=Строка(500)"
-```
-
-### Табличные части
-
-```powershell
-# Создать ТЧ с реквизитами
--Operation add-ts -Value "Товары: Ном: CatalogRef.Ном | req, Кол: Число(15,3), Цена: Число(15,2)"
-
-# Добавить реквизит в существующую ТЧ
--Operation add-ts-attribute -Value "Товары.СтавкаНДС: EnumRef.СтавкиНДС"
-
-# Изменить свойства ТЧ
--Operation modify-ts -Value "Товары: synonym=Товарный состав"
-```
-
-### Свойства объекта
-
-```powershell
-# Скалярные свойства
--Operation modify-property -Value "CodeLength=11 ;; DescriptionLength=150"
-
-# Владельцы справочника
--Operation set-owners -Value "Catalog.Контрагенты ;; Catalog.Организации"
-
-# Движения документа
--Operation add-registerRecord -Value "AccumulationRegister.Продажи ;; AccumulationRegister.ОстаткиТоваров"
-```
-
-### Регистры
-
-```powershell
--Operation add-dimension -Value "Организация: CatalogRef.Организации | master, mainFilter"
--Operation add-resource -Value "Сумма: Число(15,2)"
-```
-
-## JSON mode — комбинированные операции
-
-Для сложных сценариев (несколько типов изменений в одном вызове) используйте JSON-файл:
-
-```json
-{
-  "add": {
-    "attributes": ["Комментарий: Строка(200)"],
-    "tabularSections": [{
-      "name": "Товары",
-      "attrs": ["Ном: CatalogRef.Ном | req", "Кол: Число(15,3)"]
-    }]
-  },
-  "remove": { "attributes": ["УстаревшийРеквизит"] },
-  "modify": {
-    "properties": { "DescriptionLength": 150 },
-    "attributes": { "СтароеИмя": { "name": "НовоеИмя" } }
-  }
-}
-```
-
-JSON поддерживает русские синонимы ключей (`реквизиты`, `тч`, `измерения` и др.) и типов (`Строка`, `Число`, `СправочникСсылка` и др.).
-
-## Сценарии использования
-
-### Анализ существующего объекта
-
-```
-> Покажи структуру справочника Catalogs/Номенклатура
-```
-
-Claude вызовет `/meta-info` и покажет: реквизиты с типами, табличные части, формы, владельцев, ввод по строке.
-
-### Создание нового объекта
-
-```
-> Создай справочник Контрагенты: код 9, наименование 150, реквизиты ИНН(12), КПП(9),
-> иерархический с группами, владелец — Catalog.Организации
-```
-
-Claude сформирует JSON и вызовет `/meta-compile` → `/meta-validate` → `/meta-info`.
-
-### Добавление реквизитов к существующему объекту
-
-```
-> Добавь в документ Documents/ЗаказКлиента реквизиты Склад (CatalogRef.Склады)
-> и ТЧ Товары с реквизитами Номенклатура, Количество, Цена, Сумма
-```
-
-Claude вызовет `/meta-edit` дважды: `add-attribute` для реквизита и `add-ts` для ТЧ.
-
-### Настройка движений документа
-
-```
-> Документ Documents/ПриходТоваров должен делать движения
-> по AccumulationRegister.ОстаткиТоваров и AccumulationRegister.Партии
-```
-
-Claude вызовет `/meta-edit` с операцией `set-registerRecords`.
-
-### Удаление неиспользуемого объекта
-
-```
-> Удали справочник Catalogs/Устаревший из конфигурации src/
-```
-
-Claude вызовет `/meta-remove` с `-DryRun`, покажет что будет удалено и проверит ссылки. Если объект нигде не используется — удалит файлы, уберёт из Configuration.xml и подсистем. Если есть ссылки — покажет список и заблокирует удаление.
-
-### Проверка объекта после изменений
-
-```
-> Проверь корректность Documents/ЗаказКлиента
-```
-
-Claude вызовет `/meta-validate` и покажет ошибки и предупреждения.
-
-## Структура файлов объекта метаданных
-
-```
-<MetaType>/<ObjectName>/
-├── <ObjectName>.xml           # Основной XML (Properties, ChildObjects)
-├── Ext/
-│   └── ObjectModule.bsl       # Модуль объекта (опционально)
-├── Forms/
-│   └── <FormName>/            # Формы объекта
-├── Templates/
-│   └── <TemplateName>/        # Макеты
-└── Commands/
-    └── <CommandName>/         # Команды
-```
-
-## Спецификации
-
-- [1c-config-objects-spec.md](1c-config-objects-spec.md) — XML-формат объектов метаданных, Properties, ChildObjects, типы
-- [meta-dsl-spec.md](meta-dsl-spec.md) — JSON DSL для описания объектов (`/meta-compile`)

docs/mxl-dsl-spec.md

@@ -1,160 +0,0 @@
-# Спецификация MXL DSL — JSON-формат описания табличного документа
-
-Компактный JSON-формат для описания макетов табличных документов 1С (SpreadsheetDocument). Используется навыками `/mxl-compile` (JSON → XML) и `/mxl-decompile` (XML → JSON).
-
-## Пример
-
-```json
-{
-  "columns": 10,
-  "defaultWidth": 30,
-  "columnWidths": { "1": 15, "2-8": 40, "9-10": 50 },
-
-  "fonts": {
-    "default": { "face": "Arial", "size": 10 },
-    "bold": { "face": "Arial", "size": 10, "bold": true },
-    "header": { "face": "Arial", "size": 14, "bold": true }
-  },
-
-  "styles": {
-    "default": {},
-    "header": { "font": "header", "align": "center" },
-    "label": { "font": "bold" },
-    "bordered": { "border": "all" },
-    "bordered-right": { "border": "all", "align": "right" },
-    "total-right": { "font": "bold", "border": "top", "align": "right" }
-  },
-
-  "areas": [
-    {
-      "name": "Заголовок",
-      "rows": [
-        { "height": 20, "cells": [
-          { "col": 1, "span": 10, "style": "header", "param": "ТекстЗаголовка" }
-        ]}
-      ]
-    },
-    {
-      "name": "ШапкаТаблицы",
-      "rows": [
-        { "rowStyle": "bordered", "cells": [
-          { "col": 1, "text": "№" },
-          { "col": 2, "span": 6, "text": "Наименование" },
-          { "col": 9, "text": "Кол-во" },
-          { "col": 10, "text": "Сумма" }
-        ]}
-      ]
-    },
-    {
-      "name": "Строка",
-      "rows": [
-        { "rowStyle": "bordered", "cells": [
-          { "col": 1, "param": "НомерСтроки" },
-          { "col": 2, "span": 6, "param": "Товар", "detail": "Номенклатура" },
-          { "col": 9, "style": "bordered-right", "param": "Количество" },
-          { "col": 10, "style": "bordered-right", "param": "Сумма" }
-        ]}
-      ]
-    },
-    {
-      "name": "Итого",
-      "rows": [
-        { "cells": [
-          { "col": 8, "span": 2, "style": "total-right", "text": "Итого:" },
-          { "col": 10, "style": "total-right", "param": "Всего" }
-        ]}
-      ]
-    }
-  ]
-}
-```
-
-## Верхний уровень
-
-| Поле | Обяз. | По умолч. | Описание |
-|------|:-----:|-----------|----------|
-| `columns` | да | — | Количество колонок |
-| `page` | нет | — | Формат страницы: `"A4-landscape"` (780), `"A4-portrait"` (540) или число. Автоматически вычисляет `defaultWidth` из суммы пропорций `"Nx"` |
-| `defaultWidth` | нет | 10 | Ширина колонок по умолчанию. Игнорируется если задан `page` и все колонки используют `"Nx"` |
-| `columnWidths` | нет | `{}` | Ширины колонок. Ключи 1-based: `"1"`, `"3-14"`, `"5,7,9"`. Значения: число (абсолют) или `"Nx"` (множитель от defaultWidth, напр. `"2x"`, `"0.5x"`) |
-| `fonts` | нет | — | Именованные шрифты (если не задано, создаётся Arial 10) |
-| `styles` | нет | `{}` | Именованные стили |
-| `areas` | да | — | Массив именованных областей (порядок = порядок в документе) |
-
-## Шрифты (`fonts.<name>`)
-
-| Поле | По умолч. | Описание |
-|------|-----------|----------|
-| `face` | `"Arial"` | Имя шрифта |
-| `size` | `10` | Размер |
-| `bold` | `false` | Жирный |
-| `italic` | `false` | Курсив |
-| `underline` | `false` | Подчёркнутый |
-| `strikeout` | `false` | Зачёркнутый |
-
-Шрифт `"default"` используется когда стиль не указывает шрифт явно. Если не определён, создаётся автоматически (Arial 10).
-
-## Стили (`styles.<name>`)
-
-| Поле | По умолч. | Описание |
-|------|-----------|----------|
-| `font` | `"default"` | Ссылка на имя шрифта |
-| `align` | — | `left`, `center`, `right` |
-| `valign` | — | `top`, `center` |
-| `border` | — | Стороны рамки: `all`, `top`, `bottom`, `left`, `right`, `none`. Через запятую: `"top,bottom"` |
-| `borderWidth` | `"thin"` | Толщина рамки: `thin` (1px) или `thick` (2px) |
-| `wrap` | `false` | Перенос текста |
-| `format` | — | Формат данных 1С: `"ЧЦ=15; ЧДЦ=2"`, `"ДФ=dd.MM.yyyy"` и т.д. |
-
-## Области (`areas[]`)
-
-| Поле | Обяз. | Описание |
-|------|:-----:|----------|
-| `name` | да | Имя области для `Макет.ПолучитьОбласть("Имя")` |
-| `rows` | да | Массив строк |
-
-## Строки (`rows[]`)
-
-| Поле | По умолч. | Описание |
-|------|-----------|----------|
-| `height` | — | Высота строки (если не задана, используется авто) |
-| `rowStyle` | — | Стиль для ВСЕХ колонок (заполняет пустоты рамками) |
-| `cells` | `[]` | Массив ячеек |
-| `empty` | — | Количество подряд идущих пустых строк (заменяет N отдельных `{}`) |
-
-Строка без `cells` и `rowStyle` → пустая строка. `{ "empty": 3 }` эквивалентно трём `{}`.
-
-## Ячейки (`cells[]`)
-
-| Поле | Обяз. | По умолч. | Описание |
-|------|:-----:|-----------|----------|
-| `col` | да | — | Позиция колонки (1-based) |
-| `span` | нет | `1` | Объединение по горизонтали (количество колонок) |
-| `rowspan` | нет | `1` | Объединение по вертикали (количество строк) |
-| `style` | нет | rowStyle | Стиль ячейки (переопределяет rowStyle) |
-| `param` | нет | — | Параметр заполнения |
-| `detail` | нет | — | Параметр расшифровки (только с `param`) |
-| `text` | нет | — | Статический текст |
-| `template` | нет | — | Шаблонный текст с `[Параметр]` |
-
-### Тип заполнения
-
-Определяется автоматически по содержимому ячейки:
-- `param` → fillType=Parameter
-- `template` → fillType=Template
-- `text` → fillType=Text
-- ничего → без fillType (пустая ячейка или рамка)
-
-## `rowStyle` — автозаполнение
-
-Когда задан `rowStyle`, компилятор создаёт ячейки для ВСЕХ колонок строки. Позиции без явных ячеек заполняются пустыми ячейками с указанным стилем. Это обеспечивает сплошные рамки в табличных строках.
-
-Если в предыдущих строках той же области есть ячейки с `rowspan`, их колонки при автозаполнении пропускаются.
-
-## Ограничения
-
-Текущая версия не поддерживает:
-- Множественные наборы колонок (`columnsID`)
-- Области типа Columns / Rectangle
-- Рисунки (штрихкоды, картинки)
-- Фон ячеек

docs/mxl-guide.md

@@ -1,112 +0,0 @@
-# Табличный документ (MXL)
-
-Навыки группы `/mxl-*` позволяют анализировать, создавать и модифицировать макеты табличных документов 1С — основной формат печатных форм в конфигурациях 1С:Предприятия.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/mxl-info` | `<TemplatePath>` или `<ProcessorName> <TemplateName>` | Анализ структуры: области, параметры, наборы колонок |
-| `/mxl-validate` | `<TemplatePath>` или `<ProcessorName> <TemplateName>` | Валидация: индексы, ссылки, границы |
-| `/mxl-compile` | `<JsonPath> <OutputPath>` | Компиляция макета из JSON-определения в Template.xml |
-| `/mxl-decompile` | `<TemplatePath> [OutputPath]` | Декомпиляция Template.xml в JSON-определение |
-
-## Сценарии использования
-
-### Создание макета печатной формы с нуля
-
-Вы описываете макет словами или через JSON DSL, Claude компилирует его в Template.xml.
-
-```
-> Создай макет накладной М-11: шапка с реквизитами организации и склада,
-> таблица с колонками (номер, наименование, единица, количество, цена, сумма),
-> итоговая строка, подписи.
-```
-
-Claude напишет JSON-определение с областями, параметрами и стилями, вызовет `/mxl-compile` для генерации XML, затем `/mxl-validate` и `/mxl-info` для проверки.
-
-Рабочий цикл:
-1. Claude пишет JSON-определение макета
-2. `/mxl-compile` → Template.xml
-3. `/mxl-validate` → проверка корректности
-4. `/mxl-info` → верификация структуры (области, параметры)
-
-### Создание макета по изображению
-
-Если есть скриншот или скан печатной формы, `/img-grid` поможет точно определить пропорции колонок.
-
-```
-> Вот изображение формы М-11. Создай макет по нему.
-```
-
-Рабочий цикл:
-1. `/img-grid` → изображение с пронумерованной сеткой
-2. Claude считает координаты границ колонок по сетке
-3. Объединяет границы всех таблиц → базовая решётка
-4. Пишет JSON DSL с пропорциями `"Nx"` и `"page": "A4-landscape"`
-5. `/mxl-compile` автоматически вычисляет абсолютные ширины из пропорций и формата страницы
-6. `/mxl-validate` → `/mxl-info` → проверка
-
-### Анализ существующего макета
-
-Быстрый обзор структуры макета без чтения тысяч строк XML.
-
-```
-> Покажи структуру макета ПФ_MXL_М11
-```
-
-Claude вызовет `/mxl-info` и выведет области, параметры и наборы колонок. С флагом `-WithText` покажет ещё и текстовое содержимое ячеек (заголовки колонок, надписи).
-
-### Модификация существующего макета
-
-Декомпиляция в JSON, правка, компиляция обратно.
-
-```
-> Добавь в макет М-11 колонку "Примечание"
-```
-
-Claude вызовет `/mxl-decompile` для получения JSON, добавит колонку в определение, вызовет `/mxl-compile` и `/mxl-validate`.
-
-Рабочий цикл:
-1. `/mxl-decompile` → JSON из существующего Template.xml
-2. Claude модифицирует JSON (добавляет области, меняет стили, параметры)
-3. `/mxl-compile` → обновлённый Template.xml
-4. `/mxl-validate` → проверка
-
-> **Ограничения:** Этот сценарий подразумевает полную перегенерацию макета, а не точечную правку XML. Поэтому diff может показать больше изменений, чем фактическая доработка. Кроме того, DSL пока поддерживает не все конструкции табличного документа — для сложных макетов с рисунками, штрихкодами или нестандартным форматированием часть информации может быть потеряна при round-trip.
-
-### Валидация макета
-
-Проверка структурной корректности после любых изменений.
-
-```
-> Проверь макет ПФ_MXL_М11
-```
-
-Claude вызовет `/mxl-validate`, который проверит индексы палитр, ссылки на наборы колонок, границы областей и другие структурные зависимости.
-
-### Примеры слеш-команд
-
-```
-> /mxl-info src/МояОбработка/Templates/ПФ_MXL_Накладная/Ext/Template.xml
-> /mxl-info МояОбработка ПФ_MXL_Накладная
-> /mxl-validate МояОбработка ПФ_MXL_Накладная
-> /mxl-compile макет.json src/МояОбработка/Templates/ПФ_MXL_Накладная/Ext/Template.xml
-> /mxl-decompile src/МояОбработка/Templates/ПФ_MXL_Накладная/Ext/Template.xml макет.json
-```
-
-## Связь с EPF-навыками
-
-Макет табличного документа — часть обработки. Типичный сценарий создания печатной формы:
-
-1. `/epf-init` — создать обработку
-2. `/template-add` — добавить макет SpreadsheetDocument (с именем `ПФ_MXL_...`)
-3. `/mxl-compile` — заполнить макет содержимым из JSON-определения
-4. `/epf-bsp-init` — добавить регистрацию БСП с видом ПечатнаяФорма
-5. `/epf-bsp-add-command` — добавить команду печати
-6. `/epf-build` — собрать EPF
-
-## Спецификации
-
-- [Табличный документ (MXL)](1c-spreadsheet-spec.md) — XML-формат SpreadsheetDocument, совместимость версий
-- [MXL DSL](mxl-dsl-spec.md) — JSON-формат описания макета для `/mxl-compile` и `/mxl-decompile`

docs/python-porting-guide.md

@@ -1,235 +0,0 @@
-# Python Porting Guide
-
-Руководство по Python-портам навыков 1С (PS1 → Python).
-
-## Зачем Python рядом с PS1
-
-PowerShell 5.1 доступен только на Windows. Python-порты обеспечивают кроссплатформенность (Linux, Mac). Модель opt-in: PS1 — по умолчанию, Python — переключается скриптами.
-
-## PS1 — мастер-версия
-
-**Приоритет при разработке, доработке, отладке и тестировании — у PS1-скриптов.** Python-порты являются производными копиями. Порядок работы:
-
-1. Вносите изменения в `.ps1`
-2. Тестируйте и отлаживайте `.ps1`
-3. Переносите готовые изменения в `.py`
-
-Не дорабатывайте `.py` без аналогичного изменения в `.ps1` — они должны оставаться функционально идентичными.
-
-## Переключение рантайма
-
-```bash
-# Переключить все .md в навыках на Python
-python scripts/switch-to-python.py
-
-# Вернуть на PowerShell
-python scripts/switch-to-powershell.py
-```
-
-Скрипты обрабатывают все `.md` файлы в `.claude/skills/*/` (SKILL.md, json-dsl.md и др.). Идемпотентны — повторный запуск безопасен. Python-only навыки (img-grid) пропускаются при переключении на PowerShell.
-
-## Принцип самодостаточности
-
-Каждый `.py` — полностью автономен, как и его `.ps1`-аналог. Нет общих модулей. Это соответствует [рекомендациям Anthropic](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) и зеркалит существующую архитектуру PS1.
-
-Общие утилиты (5-15 строк) дублируются в каждом скрипте:
-
-```python
-def esc_xml(s):
-    return s.replace('&','&amp;').replace('<','&lt;').replace('>','&gt;').replace('"','&quot;')
-
-def emit_mltext(lines, indent, tag, text):
-    if not text:
-        lines.append(f"{indent}<{tag}/>")
-        return
-    lines.append(f"{indent}<{tag}>")
-    lines.append(f"{indent}\t<v8:item>")
-    lines.append(f"{indent}\t\t<v8:lang>ru</v8:lang>")
-    lines.append(f"{indent}\t\t<v8:content>{esc_xml(text)}</v8:content>")
-    lines.append(f"{indent}\t</v8:item>")
-    lines.append(f"{indent}</{tag}>")
-
-def new_uuid():
-    import uuid
-    return str(uuid.uuid4())
-
-def read_utf8(path):
-    with open(path, 'r', encoding='utf-8-sig') as f:
-        return f.read()
-
-def write_utf8_bom(path, content):
-    with open(path, 'w', encoding='utf-8-sig', newline='') as f:
-        f.write(content)
-```
-
-Большие словари данных (синонимы типов, карты объектов) тоже inline — как `$script:typeSynonyms` в PS1.
-
-## Конвенция параметров
-
-Формат `-ParamName` сохранён для минимальных различий в SKILL.md:
-
-```python
-parser = argparse.ArgumentParser(allow_abbrev=False)
-parser.add_argument('-JsonPath', dest='JsonPath', required=True)
-parser.add_argument('-NoValidate', dest='NoValidate', action='store_true')
-```
-
-Switch-параметры (`-NoValidate`) → `action='store_true'`.
-
-## Таблица маппинга PS → Python
-
-| PS1 | Python |
-|-----|--------|
-| `$script:xml = New-Object StringBuilder` | `lines = []` |
-| `$xml.AppendLine($text)` | `lines.append(text)` |
-| `$xml.ToString()` | `'\n'.join(lines)` |
-| `[System.Xml.XmlDocument] + PreserveWhitespace` | `lxml.etree.XMLParser(remove_blank_text=False)` |
-| `$xmlDoc.SelectSingleNode(xpath, $ns)` | `root.find(xpath, namespaces=NSMAP)` |
-| `$xmlDoc.SelectNodes(xpath, $ns)` | `root.findall(xpath, namespaces=NSMAP)` |
-| `XmlWriter + MemoryStream + BOM fix` | `etree.tostring(root, xml_declaration=True, encoding='UTF-8')` + declaration fix |
-| `[System.Guid]::NewGuid().ToString()` | `str(uuid.uuid4())` |
-| `$json \| ConvertFrom-Json` | `json.loads(text)` |
-| `ConvertTo-Json -Depth 10` | `json.dumps(obj, ensure_ascii=False, indent=2)` |
-| `New-Object System.Text.UTF8Encoding($true)` | `encoding='utf-8-sig'` |
-| `Start-Process -Wait -PassThru` | `subprocess.run([...], capture_output=True)` |
-| `Start-Process` (без -Wait) | `subprocess.Popen([...])` |
-| `[switch]$NoValidate` | `parser.add_argument('-NoValidate', action='store_true')` |
-| `[ValidateSet("a","b")]` | `choices=["a","b"]` |
-| `Get-ChildItem "path\*\..."` | `glob.glob(...)` |
-| `Get-Process httpd` | `psutil.process_iter(['pid','name','exe'])` |
-| `Test-Path $path` | `os.path.exists(path)` |
-| `Resolve-Path` | `os.path.abspath()` |
-| `Join-Path $a $b` | `os.path.join(a, b)` |
-| `New-Item -ItemType Directory -Force` | `os.makedirs(path, exist_ok=True)` |
-| `Remove-Item -Recurse -Force` | `shutil.rmtree(path)` |
-| `Write-Host "text"` | `print("text")` |
-| `Write-Error "text"` | `print("text", file=sys.stderr)` |
-
-## lxml vs stdlib
-
-- **Compile/init скрипты** (строковая сборка): только stdlib
-- **DOM-скрипты** (edit/validate/info): `lxml` с `XMLParser(remove_blank_text=False)` для сохранения whitespace
-- **Web-скрипты**: `psutil` для работы с процессами Apache
-
-Зависимости:
-- `lxml>=4.9.0` — ~25 DOM-скриптов
-- `psutil>=5.9.0` — 4 web-скрипта
-
-## Работа с BOM (UTF-8)
-
-Кодек Python `utf-8-sig` — точный аналог `New-Object System.Text.UTF8Encoding($true)`:
-- Запись: добавляет BOM (EF BB BF)
-- Чтение: убирает BOM автоматически
-
-```python
-# Чтение (BOM убирается)
-with open(path, 'r', encoding='utf-8-sig') as f:
-    content = f.read()
-
-# Запись (BOM добавляется)
-with open(path, 'w', encoding='utf-8-sig', newline='') as f:
-    f.write(content)
-```
-
-Параметр `newline=''` предотвращает двойные `\r\n` на Windows.
-
-## Сохранение XML с lxml
-
-```python
-from lxml import etree
-
-# Загрузка с сохранением whitespace
-parser = etree.XMLParser(remove_blank_text=False)
-tree = etree.parse(path, parser)
-root = tree.getroot()
-
-# Сохранение с BOM
-xml_bytes = etree.tostring(tree, xml_declaration=True, encoding='UTF-8')
-# Fix declaration: etree пишет одинарные кавычки и uppercase encoding,
-# PS1 XmlWriter пишет двойные кавычки и lowercase encoding
-xml_bytes = xml_bytes.replace(
-    b"<?xml version='1.0' encoding='UTF-8'?>",
-    b'<?xml version="1.0" encoding="utf-8"?>')
-# Trailing newline (PS1 XmlWriter добавляет, etree — нет)
-if not xml_bytes.endswith(b"\n"):
-    xml_bytes += b"\n"
-with open(path, 'wb') as f:
-    f.write(b'\xef\xbb\xbf')  # BOM
-    f.write(xml_bytes)
-```
-
-## Известные подводные камни
-
-### Namespace в XPath
-lxml требует явный namespace map. В PS1 используется `XmlNamespaceManager`:
-```python
-NSMAP = {'md': 'http://v8.1c.ru/8.3/MDClasses'}
-node = root.find('.//md:ChildObjects/md:Form', NSMAP)
-```
-
-### d5p1: для ссылочных типов
-В DCS-файлах ссылочные типы используют `d5p1:`, не `cfg:`:
-```xml
-<v8:Type xmlns:d5p1="http://v8.1c.ru/8.1/data/enterprise/current-config">d5p1:CatalogRef.XXX</v8:Type>
-```
-
-### XML declaration кавычки и encoding
-lxml/etree пишут `<?xml version='1.0' encoding='UTF-8'?>` (одинарные кавычки, uppercase). PS1 XmlWriter пишет `<?xml version="1.0" encoding="utf-8"?>` (двойные, lowercase). 1C принимает оба варианта, но одинарные кавычки — нестандартны. Замена всего declaration — в секции "Сохранение XML с lxml".
-
-### etree vs XmlDocument — различия сериализации
-
-Python etree (lxml и stdlib) сериализует XML иначе, чем PS1 XmlDocument:
-
-| Аспект | PS1 XmlDocument | Python etree | Влияние |
-|--------|----------------|--------------|---------|
-| Declaration кавычки | `version="1.0"` | `version='1.0'` | Нестандартные одинарные кавычки |
-| Encoding case | `encoding="utf-8"` | `encoding='UTF-8'` | Косметическое |
-| Self-closing space | `<Tag />` | `<Tag/>` | Косметическое, 1C принимает оба |
-| Trailing newline | Да | Нет | Расхождение при побайтовом сравнении |
-| Unused xmlns | Сохраняет | Удаляет | Файл валиден, но отличается от канона |
-| CR в text content | `\r` as-is | `&#13;` entity | Разный формат, одинаковый смысл |
-| Пустые элементы | `<Tag>\n</Tag>` | `<Tag/>` | Косметическое |
-
-Все эти различия обрабатываются `normalizeXmlContent()` в тест-раннере (только для `--runtime python`). PS1 тесты остаются строгими.
-
-### Hashtable vs dict — порядок итерации
-
-PS1 `@{}` (Hashtable) итерирует ключи в порядке хэш-кодов. Python `dict` — в порядке вставки. Если порядок элементов влияет на вывод (присвоение индексов, генерация UUID), используйте `sorted()` в Python **и** `| Sort-Object` в PS1 для детерминизма.
-
-### Regex: (?i) inline flag в Python 3.11+
-
-PS1: `'^(?i)desc$'` — работает. Python 3.11+: `r'^(?i)desc$'` — ошибка. Inline-флаг `(?i)` должен быть в начале строки паттерна: `r'(?i)^desc$'` или `re.IGNORECASE`.
-
-### Обращение к отсутствующим свойствам
-
-PS1 молча возвращает `$null` при обращении к несуществующему свойству (`.empty` на массиве). Python падает с `AttributeError`. Добавляйте `isinstance()` проверки при портировании.
-
-## Платформозависимые заметки
-
-Скрипты `db-*` и `web-*` используют платформу 1С (Designer CLI, Apache) — работают только на Windows. Но синтаксических ошибок на других ОС не будет: скрипт корректно сообщит об отсутствии платформы.
-
-## Добавление нового навыка
-
-Чеклист:
-1. Создать `.ps1` скрипт
-2. Создать `.py` скрипт с идентичными параметрами
-3. В SKILL.md указать `powershell.exe -NoProfile -File ... .ps1` (по умолчанию)
-4. Скрипт переключения автоматически подхватит новый навык
-
-## Обновление существующего навыка
-
-При доработке `.ps1`:
-1. Применить аналогичные изменения в `.py`
-2. Если затронуты inline-утилиты — обновить во всех скриптах: `grep -r "def esc_xml" .claude/skills/`
-
-## Inline-утилиты — полный список
-
-| Функция | Где используется |
-|---------|-----------------|
-| `esc_xml()` | compile, init, edit, add скрипты |
-| `emit_mltext()` | compile, init, add скрипты |
-| `new_uuid()` | init, add, compile скрипты |
-| `read_utf8()` | все скрипты |
-| `write_utf8_bom()` | все скрипты с записью |
-| `paginate()` | info скрипты |
-| `split_camelcase()` | info скрипты |

docs/role-dsl-spec.md

@@ -1,112 +0,0 @@
-# Спецификация Role JSON DSL
-
-Формат JSON для описания ролей 1С, используемый навыком `/role-compile`.
-
-## Обзор
-
-Role JSON DSL — компактный JSON-формат, транслируемый скриптом в XML-файлы роли 1С:Предприятия (метаданные + Rights.xml). Поддерживает пресеты прав, русские синонимы типов и прав, шаблоны ограничений (RLS).
-
-## Корневой объект
-
-| Поле | Тип | Обяз. | По умолчанию | Описание |
-|------|-----|:-----:|:------------:|----------|
-| `name` | string | да | — | Программное имя роли |
-| `synonym` | string | нет | = name | Отображаемое имя |
-| `comment` | string | нет | `""` | Комментарий |
-| `setForNewObjects` | bool | нет | `false` | Устанавливать для новых объектов |
-| `setForAttributesByDefault` | bool | нет | `true` | Устанавливать для реквизитов по умолчанию |
-| `independentRightsOfChildObjects` | bool | нет | `false` | Независимые права подчинённых объектов |
-| `objects` | array | нет | `[]` | Массив объектов метаданных с правами |
-| `templates` | array | нет | `[]` | Шаблоны ограничений (RLS) |
-
-## Элементы `objects`
-
-Массив принимает два формата, которые можно смешивать.
-
-### Строковый shorthand
-
-```
-"Тип.Имя: @пресет"
-"Тип.Имя: Право1, Право2"
-```
-
-Тип — английский (Catalog) или русский (Справочник). Права — английские (Read) или русские (Чтение).
-
-### Объектная форма
-
-| Поле | Тип | Обяз. | Описание |
-|------|-----|:-----:|----------|
-| `name` | string | да | Полное имя объекта: `Тип.Имя` |
-| `preset` | string | нет | Пресет: `"view"`, `"edit"` (без `@`) |
-| `rights` | object\|array | нет | Переопределения: `{"Right": bool}` или `["Right1", "Right2"]` |
-| `rls` | object | нет | RLS: `{"ИмяПрава": "текст условия или #шаблон"}` |
-
-При наличии `preset` + `rights` — сначала применяется пресет, затем `rights` переопределяют отдельные права.
-
-## Пресеты
-
-Три встроенных пресета определяют набор прав в зависимости от типа объекта:
-
-| Пресет | Назначение |
-|--------|------------|
-| `view` | Просмотр: Read, View (+InputByString для справочников/документов; Use+View для обработок/отчётов) |
-| `edit` | Полное редактирование: CRUD + Interactive* + Posting (документы) |
-
-Подробные таблицы прав для каждого типа объекта — в `.claude/skills/role-compile/dsl-reference.md`.
-
-## Шаблоны ограничений (RLS)
-
-Элементы массива `templates`:
-
-| Поле | Тип | Описание |
-|------|-----|----------|
-| `name` | string | Имя шаблона с параметрами: `"ДляОбъекта(Модификатор)"` |
-| `condition` | string | Текст условия. `&` экранируется в `&` автоматически |
-
-Ссылка на шаблон в `rls`: `"#ИмяШаблона(\"параметры\")"` — начинается с `#`.
-
-## Русские синонимы
-
-DSL принимает русские имена типов и прав, транслируя их в английские. Полные таблицы соответствий — в `.claude/skills/role-compile/dsl-reference.md`.
-
-Примеры: `Справочник` → Catalog, `Документ` → Document, `Чтение` → Read, `Просмотр` → View.
-
-## Пример
-
-```json
-{
-  "name": "МенеджерПродаж",
-  "synonym": "Менеджер продаж",
-  "objects": [
-    "Document.РеализацияТоваровУслуг: @edit",
-    "Catalog.Контрагенты: @view",
-    "Catalog.Номенклатура: @view",
-    {
-      "name": "Document.ЗаказКлиента",
-      "preset": "view",
-      "rls": { "Read": "#ДляОбъекта(\"\")" }
-    }
-  ],
-  "templates": [
-    {
-      "name": "ДляОбъекта(Модификатор)",
-      "condition": "ГДЕ Организация = &ТекущаяОрганизация"
-    }
-  ]
-}
-```
-
-## Генерируемые файлы
-
-```
-Roles/
-  ИмяРоли.xml              # Метаданные (UUID, синоним, флаги)
-  ИмяРоли/
-    └── Ext/
-        └── Rights.xml      # Права доступа (объекты, права, RLS)
-```
-
-## См. также
-
-- [Роли (Rights.xml)](1c-role-spec.md) — XML-формат прав роли, типы объектов, RLS
-- [Гайд по ролям](role-guide.md) — сценарии использования, рабочий цикл

docs/role-guide.md

@@ -1,155 +0,0 @@
-# Роли (Role)
-
-Навыки группы `/role-*` позволяют анализировать, создавать и проверять роли 1С — XML-файлы прав доступа (Rights.xml) и метаданных.
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/role-info` | `<RightsPath>` | Компактная сводка прав: объекты по типам, только разрешённые, RLS, шаблоны |
-| `/role-compile` | `<JsonPath> <RolesDir>` | Генерация роли из JSON DSL: метаданные + Rights.xml, UUID автоматически |
-| `/role-validate` | `<RightsPath> [MetadataPath]` | Валидация структурной корректности: XML, namespace, права, RLS, шаблоны |
-
-## Рабочий цикл
-
-```
-Описание прав (текст) → JSON DSL → /role-compile → XML-исходники → /role-validate
-                                                                  → /role-info
-```
-
-1. Claude формирует JSON-определение роли (с пресетами или явными правами)
-2. `/role-compile` генерирует `Roles/ИмяРоли.xml` + `Roles/ИмяРоли/Ext/Rights.xml`
-3. `/role-validate` проверяет корректность сгенерированного XML
-4. `/role-info` выводит компактную сводку для визуальной проверки
-
-## JSON DSL — компактный формат
-
-Роли описываются в JSON с двумя уровнями детализации:
-
-### Строковый shorthand (простые роли)
-
-```json
-{
-  "name": "ЧтениеНоменклатуры",
-  "synonym": "Чтение номенклатуры",
-  "objects": [
-    "Catalog.Номенклатура: @view",
-    "Catalog.Контрагенты: @view",
-    "DataProcessor.Загрузка: @view"
-  ]
-}
-```
-
-Формат строки: `Тип.Имя: @пресет` или `Тип.Имя: Право1, Право2`.
-
-### Объектная форма (RLS, переопределения)
-
-```json
-{
-  "name": "Document.Реализация",
-  "preset": "view",
-  "rights": { "Delete": false },
-  "rls": { "Read": "#ДляОбъекта(\"\")" }
-}
-```
-
-Форматы можно смешивать в одном массиве `objects`.
-
-### Пресеты
-
-| Пресет | Действие |
-|--------|----------|
-| `@view` | Просмотр: Read, View (+InputByString для справочников/документов; Use+View для обработок/отчётов) |
-| `@edit` | Полное редактирование: CRUD + Interactive* + Posting (для документов) |
-
-`@` обязателен в строковом shorthand. В объектной форме — ключ `preset` без `@`.
-
-### Русские синонимы
-
-Скрипт принимает русские имена типов и прав: `Справочник` → Catalog, `Чтение` → Read, `Проведение` → Posting и т.д. Полный список — в [спецификации Role DSL](role-dsl-spec.md).
-
-## Сценарии использования
-
-### Анализ существующей роли
-
-```
-> Проанализируй права роли Roles/БазовыеПраваБП/Ext/Rights.xml
-```
-
-Claude вызовет `/role-info`, получит компактную сводку (тысячи строк XML → 50–300 строк текста) и опишет:
-- какие объекты доступны и с какими правами
-- где есть ограничения RLS
-- какие шаблоны ограничений используются
-
-### Создание роли по описанию
-
-```
-> Создай роль МенеджерПродаж с правами:
-> - Документ РеализацияТоваровУслуг: полные права
-> - Справочник Контрагенты: чтение
-> - Справочник Номенклатура: чтение
-> - Регистр ЦеныНоменклатуры: чтение
-```
-
-Claude сформирует JSON с пресетами:
-```json
-{
-  "name": "МенеджерПродаж",
-  "synonym": "Менеджер продаж",
-  "objects": [
-    "Document.РеализацияТоваровУслуг: @edit",
-    "Catalog.Контрагенты: @view",
-    "Catalog.Номенклатура: @view",
-    "InformationRegister.ЦеныНоменклатуры: @view"
-  ]
-}
-```
-
-И вызовет `/role-compile` → `/role-validate` → `/role-info`.
-
-### Создание роли для регламентного задания
-
-```
-> Проанализируй модуль регламентного задания ОбновлениеКурсовВалют
-> и создай роль с минимальными правами для его выполнения
-```
-
-Claude проанализирует код, определит используемые объекты, создаст JSON с точечными правами (без пресетов — только нужные права), и скомпилирует роль.
-
-### Создание роли с RLS
-
-```
-> Создай роль для чтения документов с ограничением по организации
-```
-
-Claude использует объектную форму JSON с шаблонами ограничений.
-
-### Проверка существующей роли
-
-```
-> Проверь корректность роли Roles/МояРоль/Ext/Rights.xml
-```
-
-Claude вызовет `/role-validate` и покажет результат: ошибки (невалидный XML, отсутствующие элементы) и предупреждения (неизвестные типы объектов, подозрительные имена прав с подсказками).
-
-## Структура файлов роли
-
-```
-Roles/
-├── ИмяРоли.xml              # Метаданные (UUID, синоним)
-└── ИмяРоли/
-    └── Ext/
-        └── Rights.xml        # Права доступа
-```
-
-Регистрация в `Configuration.xml`:
-```xml
-<ChildObjects>
-    <Role>ИмяРоли</Role>
-</ChildObjects>
-```
-
-## Спецификация
-
-- [1c-role-spec.md](1c-role-spec.md) — XML-формат прав роли, типы объектов, RLS, шаблоны ограничений
-- [role-dsl-spec.md](role-dsl-spec.md) — JSON DSL для описания ролей (формат входных данных `/role-compile`)

docs/skd-guide.md

@@ -1,226 +0,0 @@
-# Схема компоновки данных (СКД)
-
-Навыки группы `/skd-*` позволяют анализировать, создавать, редактировать и проверять схемы компоновки данных 1С — XML-файлы DataCompositionSchema (Template.xml).
-
-## Навыки
-
-| Навык | Параметры | Описание |
-|-------|-----------|----------|
-| `/skd-info` | `<TemplatePath> [-Mode] [-Name]` | Анализ структуры СКД: наборы, поля, параметры, ресурсы, варианты (11 режимов, включая full) |
-| `/skd-compile` | `[-DefinitionFile <json> \| -Value <json-string>] -OutputPath <Template.xml>` | Генерация Template.xml из JSON DSL: наборы, поля, итоги, параметры, варианты |
-| `/skd-decompile` | `<TemplatePath> [-OutputPath <out.json>]` | Преобразование Template.xml в JSON-черновик в формате `/skd-compile` — для нового отчёта по образцу или структурной переработки существующего. Из соображений предосторожности исключён из автоматического подбора моделью — вызывается только явной командой |
-| `/skd-edit` | `<TemplatePath> -Operation <op> -Value "<value>"` | Точечное редактирование: 26 атомарных операций (add/set/patch/modify/clear/remove) |
-| `/skd-validate` | `<TemplatePath> [-MaxErrors 20]` | Валидация структурной корректности: ~30 проверок |
-
-## Рабочий цикл
-
-```
-Описание отчёта (текст) → JSON DSL → /skd-compile → Template.xml → /skd-validate
-                          ↑                          ↕ /skd-edit    → /skd-info
-                          └──── /skd-decompile ──────┘
-```
-
-1. Claude формирует JSON-определение СКД (shorthand-поля, параметры, итоги, варианты) — либо с нуля по описанию, либо `/skd-decompile` готовит черновик по существующему Template.xml
-2. `/skd-compile` генерирует Template.xml с корректными namespace, типами, группировками
-3. `/skd-edit` вносит точечные изменения: добавление полей, фильтров, наборов данных, вариантов, условного оформления и т.д.
-4. `/skd-validate` проверяет корректность XML
-5. `/skd-info` выводит компактную сводку для визуальной проверки
-
-### Когда `/skd-decompile`, а когда `/skd-edit`
-
-- **`/skd-edit`** — точечные правки готового отчёта (добавить поле, фильтр, итог, переименовать параметр). Меняет XML адресно, без полной реконструкции, не задевает непокрытые конструкции.
-- **`/skd-decompile` → правка JSON → `/skd-compile`** — сценарии, где правки структурны: новый отчёт по образцу существующего, переработка варианта, перерисовка макета, перебор набора полей. Цикл переписывает Template.xml целиком.
-
-  **Полнота не гарантируется.** Известные декомпилятору непокрытые конструкции явно отмечаются маркерами в JSON и собираются в файл предупреждений — компилятор откажется собирать такой черновик, пока маркеры не разрешены вручную или не удалены. Но возможны и **тихие потери** — мелкое оформление, редкие настройки, незнакомые декомпилятору расширения. Это даёт валидный XML без части функциональности, и Конфигуратор такой результат не отбракует. Именно поэтому навык не предназначен для точечных правок (для них есть `/skd-edit`) и исключён из автоматического подбора моделью — вызывается только явной командой пользователя. Решение использовать пересобранный Template.xml — на стороне пользователя, и сверка с оригиналом перед коммитом остаётся его ответственностью.
-
-## JSON DSL — компактный формат
-
-СКД описываются в JSON с двумя уровнями детализации для каждой секции:
-
-### Минимальный пример
-
-```json
-{
-  "dataSets": [{
-    "query": "ВЫБРАТЬ Номенклатура.Наименование ИЗ Справочник.Номенклатура КАК Номенклатура",
-    "fields": ["Наименование"]
-  }]
-}
-```
-
-Умолчания: dataSource создаётся автоматически (`ИсточникДанных1/Local`), набор получает имя `НаборДанных1`, вариант настроек "Основной" с деталями.
-
-### Поля — shorthand
-
-```json
-"fields": [
-  "Наименование",
-  "Количество: decimal(15,2)",
-  "Организация: CatalogRef.Организации @dimension",
-  "Служебное: string #noFilter #noOrder"
-]
-```
-
-Формат: `Имя[: Тип] [@роль...] [#ограничение...]`. Роли: `@dimension`, `@account`, `@balance`, `@period`. Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.
-
-### Итоги — shorthand
-
-```json
-"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]
-```
-
-Формат: `Поле: Функция` или `Поле: Функция(выражение)`. Объектная форма поддерживает привязку к группировкам: `{ "dataPath": "X", "expression": "Сумма(X)", "group": ["Группа1", "ОбщийИтог"] }`.
-
-### Параметры — shorthand + @autoDates
-
-```json
-"parameters": [
-  "Период: StandardPeriod = LastMonth @autoDates",
-  "Организация: CatalogRef.Организации"
-]
-```
-
-Флаги: `@autoDates` (авто ДатаНачала/ДатаОкончания), `@valueList` (разрешить список значений), `@hidden` (скрыть параметр, исключить из `dataParameters: auto`).
-
-### Вычисляемые поля — shorthand
-
-```json
-"calculatedFields": ["Итого = Количество * Цена"]
-```
-
-### Варианты настроек — shorthand
-
-```json
-"settingsVariants": [{
-  "name": "Основной",
-  "settings": {
-    "selection": ["Номенклатура", "Количество", "Сумма"],
-    "filter": ["Организация = _ @off @user"],
-    "order": ["Сумма desc"],
-    "dataParameters": ["Период = LastMonth @user"],
-    "outputParameters": { "Заголовок": "Мой отчёт" },
-    "structure": "Организация > details"
-  }
-}]
-```
-
-- **filter shorthand**: `"Поле оператор значение @флаги"` — флаги `@off`, `@user`, `@quickAccess`, `@normal`, `@inaccessible`
-- **dataParameters shorthand**: `"Имя = значение @флаги"`, или `"auto"` — автогенерация для всех не-hidden параметров
-- **structure shorthand**: `"Поле1 > Поле2 > details"` — `>` разделяет уровни группировки
-- **conditionalAppearance**: условное оформление с автоопределением типов (Color, Boolean, LocalStringType для Формат/Текст/Заголовок, DesignTimeValue для ссылок), OrGroup через `{"group": "Or", "items": [...]}`
-- **selection**: поддержка `{"folder": "Название", "items": [...]}` для группировки полей (SelectedItemFolder)
-- **parameters**: `availableValues`, `denyIncompleteValues`, `use: "Always"` в объектной форме
-
-### Шаблоны вывода — компактный DSL
-
-Для отчётов с фиксированным оформлением (ФСД, ведомости) — табличное описание вместо raw XML:
-
-```json
-"templates": [
-  {
-    "name": "Макет1", "style": "header",
-    "widths": [36, 33, 16, 17], "minHeight": 24.75,
-    "rows": [
-      ["Виды кассы", "Валюта", "Остаток на начало\nпериода", "Остаток на конец периода"],
-      ["|", "|", "|", "|"],
-      ["К1", "К2", "К3", "К4"]
-    ]
-  },
-  {
-    "name": "Макет2", "style": "data",
-    "widths": [36, 33, 16, 17],
-    "rows": [["{ВидКассы}", "{Валюта}", "{Остаток}", "{ОстатокКонец}"]],
-    "parameters": [
-      { "name": "ВидКассы", "expression": "Представление(Счет)" }
-    ]
-  }
-],
-"groupTemplates": [
-  { "groupName": "ДанныеОтчета", "templateType": "GroupHeader", "template": "Макет1" },
-  { "groupField": "Счет", "templateType": "Header", "template": "Макет2" }
-]
-```
-
-Синтаксис ячеек: `"текст"` — статика, `"{Имя}"` — параметр, `"|"` — объединение с ячейкой выше, `null` — пустая.
-
-Привязки: `groupField` — к полю, `groupName` — к именованной группировке. `templateType`: `Header`/`OverallHeader` → `<groupTemplate>`, `GroupHeader` → `<groupHeaderTemplate>`.
-
-Расшифровка (drilldown): ключ `drilldown` в параметре шаблона генерирует `DetailsAreaTemplateParameter` и привязку `Расшифровка` в appearance ячеек.
-
-Встроенные стили: `header` (фон, центр, перенос), `data` (фон группы), `subheader` (без фона, центр), `total` (без фона). Все — Arial 10, рамки Solid 1px, цвета через стили платформы. Пользовательские стили — через `skd-styles.json` в директории проекта.
-
-### Объектная форма
-
-Все секции поддерживают полную объектную форму для сложных случаев (title, appearance, role с выражениями, userSettingID, userSettingPresentation, conditionalAppearance, группы фильтров And/Or/Not и т.д.). Подробности — в [спецификации SKD DSL](skd-dsl-spec.md).
-
-## Сценарии использования
-
-### Анализ существующей СКД
-
-```
-> Проанализируй схему компоновки отчёта Reports/АнализНДФЛ/Templates/ОсновнаяСхемаКомпоновкиДанных
-```
-
-Claude вызовет `/skd-info` (overview → trace → query → variant) и опишет:
-- наборы данных и их поля
-- параметры и значения по умолчанию
-- ресурсы и формулы агрегации
-- структуру группировок в вариантах настроек
-
-### Создание СКД по описанию
-
-```
-> Создай СКД для отчёта по продажам: группировка по организациям,
-> поля Номенклатура, Количество, Сумма. Период — параметр.
-```
-
-Claude сформирует JSON (запрос можно вынести в файл: `"query": "@queries/sales.sql"`):
-```json
-{
-  "dataSets": [{
-    "name": "Продажи",
-    "query": "ВЫБРАТЬ ...",
-    "fields": [
-      "Организация: CatalogRef.Организации @dimension",
-      "Номенклатура: CatalogRef.Номенклатура @dimension",
-      "Количество: decimal(15,3)",
-      "Сумма: decimal(15,2)"
-    ]
-  }],
-  "totalFields": ["Количество: Сумма", "Сумма: Сумма"],
-  "parameters": ["Период: StandardPeriod = LastMonth @autoDates"],
-  "settingsVariants": [{
-    "name": "Основной",
-    "settings": {
-      "selection": ["Номенклатура", "Количество", "Сумма"],
-      "dataParameters": ["Период = LastMonth @user"],
-      "structure": "Организация > details"
-    }
-  }]
-}
-```
-
-И вызовет `/skd-compile` → `/skd-validate` → `/skd-info`.
-
-### Проверка существующей СКД
-
-```
-> Проверь корректность СКД Reports/МойОтчёт/Templates/ОсновнаяСхемаКомпоновкиДанных/Ext/Template.xml
-```
-
-Claude вызовет `/skd-validate` и покажет результат: ошибки (битые ссылки, дубликаты, невалидные типы) и предупреждения.
-
-## Структура файлов СКД
-
-```
-<Объект>/Templates/
-├── ИмяМакета.xml              # Метаданные (UUID, TemplateType=DataCompositionSchema)
-└── ИмяМакета/
-    └── Ext/
-        └── Template.xml        # Тело схемы (DataCompositionSchema)
-```
-
-## Спецификации
-
-- [1c-dcs-spec.md](1c-dcs-spec.md) — XML-формат DataCompositionSchema, namespace, элементы, типы
-- [skd-dsl-spec.md](skd-dsl-spec.md) — JSON DSL для описания СКД (формат входных данных `/skd-compile`)