Auto-build: codeassistant (python) from ae82412

.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,31 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
-  "name": "1c-skills",
-  "description": "[PowerShell] Навыки для разработки на 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": "./.claude/skills/"
-}

.claude/skills/skd-info/modes-reference.md

@@ -1,246 +0,0 @@
-# /skd-info — полная справка по режимам
-
-Компактное описание — в [SKILL.md](SKILL.md).
-
-## overview (по умолчанию) — карта схемы
-
-Компактная навигационная карта (10-25 строк). Показывает структуру и подсказывает следующие шаги:
-
-```
-=== DCS: ОсновнаяСхемаКомпоновкиДанных (362 lines) ===
-
-Sources: ИсточникДанных1 (Local)
-
-Datasets:
-  [Query]  НоменклатураСЦенами   7 fields, query 40 lines
-Calculated: 1
-Resources: 1
-Templates: 1 templates, 1 group bindings
-Params: (none)
-
-Variants:
-  [1] НоменклатураИЦены  "Номенклатура и цены"  Table(detail)  3 filters
-  [2] НоменклатураБезЦен  "Номенклатура без цен"  Group(detail)  2 filters
-
-Next:
-  -Mode query             query text
-  -Mode fields            field tables by dataset
-  -Mode calculated        calculated field expressions
-  -Mode resources         resource aggregation
-  -Mode variant -Name <N> variant structure (1..2)
-```
-
-Для DataSetUnion — дерево наборов + связи:
-```
-Datasets:
-  [Union] РасчетНалогаНаИмущество  52 fields
-    ├─ [Query] РасчетНалогаНаИмущество   51 fields, query 181 lines
-    ├─ [Query] ДанныеПоКадастровой   29 fields, query 40 lines
-    ├─ [Query] ДанныеПоСреднегодовой   34 fields, query 41 lines
-Links: РасчетНалогаНаИмущество -> СостояниеОС (2 fields)
-```
-
-Параметры разделяются на видимые/скрытые:
-```
-Params: 18 (7 visible, 11 hidden): Период, Ответственный, ...
-```
-
-## query — текст запроса
-
-`-Name <набор>` — имя DataSet (обязателен если наборов > 1).
-
-Извлекает raw-текст запроса с деэкранированием XML (`&amp;`→`&`, `&gt;`→`>`). Для пакетных запросов — оглавление батчей:
-
-```
-=== Query: ДанныеТ13 (334 lines, 13 batches) ===
-  Batch 1: lines 1-8     → ПОМЕСТИТЬ Представления_Периоды
-  Batch 2: lines 9-26    → ПОМЕСТИТЬ Представления_СотрудникиОрганизации
-  ...
---- Batch 1 ---
-ВЫБРАТЬ
-  ДАТАВРЕМЯ(1, 1, 1) КАК Период
-ПОМЕСТИТЬ Представления_Периоды
-...
-```
-
-Фильтр по номеру батча: `-Batch 3` покажет только 3-й пакет.
-
-## fields — поля наборов данных
-
-Без `-Name` — карта: имена полей по наборам:
-```
-=== Fields map ===
-СостояниеОС [Query] (3): Организация, ОсновноеСредство, ДатаСостояния
-РасчетНалогаНаИмущество [Union] (52): ДоляСтоимостиЧислитель, ...
-  РасчетНалогаНаИмущество [Query] (51): КадастроваяСтоимость, ...
-```
-
-С `-Name <поле>` — детали конкретного поля:
-```
-=== Field: ДатаСостояния "Дата ввода в эксплуатацию" ===
-
-Dataset: СостояниеОС [Query]
-Format: ДФ=dd.MM.yyyy
-```
-
-Показывает: dataset, title, type, role, useRestriction, format, presentationExpression.
-
-## links — связи наборов данных
-
-```
-=== Links (4) ===
-
-РасчетНалогаНаИмущество -> СостояниеОС :
-  Организация -> Организация
-  ОсновноеСредство -> ОсновноеСредство
-```
-
-Группирует по парам наборов. Показывает поля связи и параметры.
-
-## calculated — вычисляемые поля
-
-Без `-Name` — карта: имена и заголовки:
-```
-=== Calculated fields (23) ===
-  ДоляСтоимости  "Доля стоимости"
-  КоэффициентКи  "Коэффициент Ки"
-  ...
-```
-
-С `-Name <поле>` — полное выражение:
-```
-=== Calculated: ДоляСтоимости ===
-
-Expression:
-  ВЫБОР КОГДА ... ТОГДА "1" ИНАЧЕ ... КОНЕЦ
-Title: Доля стоимости
-Restrict: condition
-```
-
-## resources — ресурсы (итоги по группировкам)
-
-Без `-Name` — карта: имена полей, `*` = есть формулы по группировкам:
-```
-=== Resources (51) ===
-  НалоговаяБаза
-  КоэффициентКи *
-  ...
-  * = has group-level formulas
-```
-
-С `-Name <поле>` — формулы агрегации:
-```
-=== Resource: ДатаСостояния ===
-
-  [ОсновноеСредство] ЕстьNull(ДатаСостояния, "")
-```
-
-## params — параметры схемы
-
-```
-=== Parameters (16) ===
-  Name                       Type                   Default          Visible  Expression
-  Период                     StandardPeriod         LastMonth        yes      -
-  НачалоПериода              DateTime               -                hidden   &Период.ДатаНачала
-  Организация                CatalogRef.Организации null             yes      -
-```
-
-## variant — варианты отчёта
-
-Без `-Name` — список вариантов:
-```
-=== Variants (2) ===
-  [1] НоменклатураИЦены  "Номенклатура и цены"  Table(detail)  3 filters
-  [2] НоменклатураБезЦен  "Номенклатура без цен"  Group(detail)  2 filters
-```
-
-С `-Name <N|имя>` — структура конкретного варианта:
-```
-=== Variant [1]: НоменклатураИЦены "Номенклатура и цены" ===
-
-Structure:
-  Table "Таблица"
-  ├── Columns: [ТипЦен Items]
-  │     Selection: Auto, Цена
-  └── Rows: [Номенклатура Items]
-        Selection: Номенклатура, УИД, Auto
-
-Filter:
-  [ ] Номенклатура InHierarchy  [user]
-  [ ] ТипЦен Equal
-  [x] ВАрхиве = false  "Исключая скрытые товары"
-
-DataParams: КлючВарианта="НоменклатураИЦены"
-Output: style=ЧерноБелый  groups=Separately  totalsH=None  totalsV=None
-```
-
-## templates — привязки шаблонов вывода
-
-Три типа привязок: `fieldTemplate` (к полю), `groupTemplate` (к группировке, Header/Footer), `groupHeaderTemplate` (заголовок группы).
-
-Без `-Name` — карта привязок:
-```
-=== Templates (70 defined: 49 field, 37 group) ===
-
-Field bindings (49): (all trivial)
-  ОстаточнаяСтоимостьНа0101, ОстаточнаяСтоимостьНа0102, ...
-
-Group bindings (37):
-  ВидНалоговойБазы
-    Header -> Макет3 (1 rows, 1 params)
-  СреднегодоваяСтоимость2019
-    Footer -> Макет50 (1 rows) spacer
-    GroupHeader -> Макет40 (3 rows)
-```
-
-С `-Name <группировка|поле>` — содержимое шаблонов:
-```
-=== Templates: СреднегодоваяСтоимость2019 ===
-
-Footer -> Макет50 [1 rows, 1 cells]:
-  Row 1: (empty)
-
-GroupHeader -> Макет40 [3 rows, 78 cells]:
-  Row 1: "№ п/п" | "###Группировки1###" | "Инв. номер" | ...
-  Row 2: "01.01" | "01.02" | ... | "31.12"
-  Row 3: "1" | "2" | ... | "26"
-```
-
-Для field-привязок:
-```
-=== Field template: ОстаточнаяСтоимостьНа0101 -> Макет4 ===
-[1 rows, 1 cells]
-  Row 1: {ОстаточнаяСтоимостьНа0101}
-  (all params trivial)
-```
-
-**Тривиальность выражений**: `Поле = Поле` и `Поле = Представление(Поле)` считаются тривиальными и НЕ выводятся. Показываются только нетривиальные — когда выражение содержит другое поле, вызов метода, пустую строку и т.д.
-
-## trace — трассировка поля от заголовка до запроса
-
-Ищет поле по dataPath ИЛИ заголовку (включая подстроку) и показывает полную цепочку происхождения за один вызов:
-
-```
-=== Trace: КоэффициентКи "Коэффициент Ки" ===
-
-Dataset: (schema-level only, not in dataset fields)
-
-Calculated:
-  ВЫБОР КОГДА ... ТОГДА 0 ИНАЧЕ ... КОНЕЦ
-  Operands:
-    КоличествоМесяцевИспользования -> РасчетНалогаНаИмущество [Query]
-    КоличествоМесяцевВладения -> РасчетНалогаНаИмущество [Query]
-
-Resource:
-  [ОсновноеСредство] Сумма(КоэффициентКи)
-```
-
-Типичный сценарий: пользователь видит колонку "Коэффициент Ки" в отчёте и спрашивает как она считается. Один вызов `trace` показывает: формулу вычисления, откуда берутся операнды, как агрегируется в ресурс.
-
-## Что не выводится
-
-- XML namespace-декларации
-- Обёртки v8:item/v8:lang/v8:content (извлекаем чистый текст)
-- userSettingID (GUID-ы пользовательских настроек)
-- Дефолтные periodAdditionBegin/End = 0001-01-01
-- viewMode

.codeassistant/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 ".codeassistant/skills/cf-edit/scripts/cf-edit.py" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
 ```
 
 ## Операции

.codeassistant/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 ".codeassistant/skills/cf-info/scripts/cf-info.py" -ConfigPath "<путь>"
 ```
 
 ## Три режима

.codeassistant/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 ".codeassistant/skills/cf-init/scripts/cf-init.py" -Name "МояКонфигурация"
 ```
 
 ## Примеры

.codeassistant/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 ".codeassistant/skills/cf-validate/scripts/cf-validate.py" -ConfigPath "upload/cfempty"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty/Configuration.xml"
+python ".codeassistant/skills/cf-validate/scripts/cf-validate.py" -ConfigPath "upload/cfempty/Configuration.xml"
 ```

.codeassistant/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 ".codeassistant/skills/cfe-borrow/scripts/cfe-borrow.py" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
 ```
 
 ## Примеры

.codeassistant/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 ".codeassistant/skills/cfe-diff/scripts/cfe-diff.py" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
 ```
 
 ## Mode A — обзор расширения

.codeassistant/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 ".codeassistant/skills/cfe-init/scripts/cfe-init.py" -Name "МоёРасширение"
 ```
 
 ## Примеры

.codeassistant/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 ".codeassistant/skills/cfe-patch-method/scripts/cfe-patch-method.py" -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
 ```
 
 ## Примеры

.codeassistant/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 ".codeassistant/skills/cfe-validate/scripts/cfe-validate.py" -ExtensionPath "src"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src/Configuration.xml"
+python ".codeassistant/skills/cfe-validate/scripts/cfe-validate.py" -ExtensionPath "src/Configuration.xml"
 ```

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

@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <параметры>
+python ".codeassistant/skills/db-create/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 ".codeassistant/skills/db-create/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 ".codeassistant/skills/db-create/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 ".codeassistant/skills/db-create/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 ".codeassistant/skills/db-create/scripts/db-create.py" -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
 ```

.codeassistant/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 ".codeassistant/skills/db-dump-cf/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 ".codeassistant/skills/db-dump-cf/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 ".codeassistant/skills/db-dump-cf/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 ".codeassistant/skills/db-dump-cf/scripts/db-dump-cf.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
 ```

.codeassistant/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 ".codeassistant/skills/db-dump-xml/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 ".codeassistant/skills/db-dump-xml/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 ".codeassistant/skills/db-dump-xml/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 ".codeassistant/skills/db-dump-xml/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 ".codeassistant/skills/db-dump-xml/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 ".codeassistant/skills/db-dump-xml/scripts/db-dump-xml.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
 ```

.codeassistant/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 ".codeassistant/skills/db-load-cf/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 ".codeassistant/skills/db-load-cf/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 ".codeassistant/skills/db-load-cf/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 ".codeassistant/skills/db-load-cf/scripts/db-load-cf.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
 ```

.codeassistant/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 ".codeassistant/skills/db-load-git/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 ".codeassistant/skills/db-load-git/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 ".codeassistant/skills/db-load-git/scripts/db-load-git.py" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"
 ```

.codeassistant/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 ".codeassistant/skills/db-load-xml/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 ".codeassistant/skills/db-load-xml/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 ".codeassistant/skills/db-load-xml/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 ".codeassistant/skills/db-load-xml/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 ".codeassistant/skills/db-load-xml/scripts/db-load-xml.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
 ```

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

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

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

@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
+python ".codeassistant/skills/db-update/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 ".codeassistant/skills/db-update/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 ".codeassistant/skills/db-update/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 ".codeassistant/skills/db-update/scripts/db-update.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
 ```

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

@@ -40,7 +40,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>
+python ".codeassistant/skills/epf-build/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 ".codeassistant/skills/epf-build/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 ".codeassistant/skills/epf-build/scripts/epf-build.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
 ```

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

@@ -39,7 +39,7 @@ allowed-tools:
 ## Команда
 
 ```powershell
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
+python ".codeassistant/skills/epf-dump/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 ".codeassistant/skills/epf-dump/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 ".codeassistant/skills/epf-dump/scripts/epf-dump.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
 ```

.codeassistant/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 ".codeassistant/skills/epf-init/scripts/init.py" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
 ```
 
 ## Дальнейшие шаги

.codeassistant/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 ".codeassistant/skills/epf-validate/scripts/epf-validate.py" -ObjectPath "src/МояОбработка"
-powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка/МояОбработка.xml"
+python ".codeassistant/skills/epf-validate/scripts/epf-validate.py" -ObjectPath "src/МояОбработка/МояОбработка.xml"
 ```
 

.codeassistant/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 ".codeassistant/skills/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 ".codeassistant/skills/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 ".codeassistant/skills/epf-build/scripts/epf-build.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
 ```

.codeassistant/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 ".codeassistant/skills/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 ".codeassistant/skills/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 ".codeassistant/skills/epf-dump/scripts/epf-dump.py" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
 ```

.codeassistant/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 ".codeassistant/skills/erf-init/scripts/init.py" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
 ```
 
 ## Дальнейшие шаги

.codeassistant/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 ".codeassistant/skills/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 ".codeassistant/skills/epf-validate/scripts/epf-validate.py" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
 ```
 

.codeassistant/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 ".codeassistant/skills/form-add/scripts/form-add.py" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
 ```
 
 ## Purpose — назначение формы

.codeassistant/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 ".codeassistant/skills/form-compile/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 ".codeassistant/skills/form-compile/scripts/form-compile.py" -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"
 ```
 
 ## JSON DSL — справка
@@ -61,7 +61,7 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 
 | DSL ключ     | XML элемент       | Значение ключа                                    |
 |--------------|-------------------|---------------------------------------------------|
-| `"group"`    | UsualGroup        | `"horizontal"` / `"vertical"` / `"alwaysHorizontal"` / `"alwaysVertical"` / `"collapsible"` |
+| `"group"`    | UsualGroup        | ориентация: `"vertical"` / `"horizontalIfPossible"` / `"alwaysHorizontal"` (поведение — отдельный ключ `behavior`) |
 | `"columnGroup"` | ColumnGroup    | `"horizontal"` / `"vertical"` / `"inCell"` — только внутри `columns` таблицы |
 | `"input"`    | InputField        | имя элемента                                      |
 | `"check"`    | CheckBoxField     | имя                                               |
@@ -83,15 +83,15 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 
 | Ключ | Описание |
 |------|----------|
-| `name` | Переопределить имя (по умолчанию = значение ключа типа) |
+| `name` | Переопределить имя (по умолчанию = значение ключа типа). Имена уникальны во всех коллекциях формы (элементы, реквизиты, команды, колонки) |
 | `title` | Заголовок элемента |
+| `tooltip` | Всплывающая подсказка элемента (строка или `{ru,en}`) |
 | `visible: false` | Скрыть (синоним: `hidden: true`) |
 | `enabled: false` | Сделать недоступным (синоним: `disabled: true`) |
 | `readOnly: true` | Только чтение |
-| `on: [...]` | События с автоименованием обработчиков |
+| `events: {...}` | Обработчики событий: `{ "OnChange": "ИмяОбработчика" }`. Тот же формат, что у событий формы. Значение `null` → имя обработчика сгенерируется автоматически |
-| `handlers: {...}` | Явное задание имён обработчиков: `{"OnChange": "МоёИмя"}` |
 
-### Допустимые имена событий (`on`)
+### Допустимые имена событий (`events`)
 
 Компилятор предупреждает о неизвестных событиях. Имена регистрозависимы — используйте точно как указано.
 
@@ -116,7 +116,7 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 | Ключ | Описание | Пример |
 |------|----------|--------|
 | `path` | DataPath — привязка к данным | `"Объект.Организация"` |
-| `titleLocation` | Размещение заголовка | `"none"`, `"left"`, `"top"` |
+| `titleLocation` | Размещение заголовка | `"none"`, `"left"`, `"right"`, `"top"`, `"bottom"`, `"auto"` |
 | `multiLine: true` | Многострочное поле | текстовое поле, комментарий |
 | `passwordMode: true` | Режим пароля (звёздочки) | поле ввода пароля |
 | `choiceButton: true` | Кнопка выбора ("...") | ссылочное поле |
@@ -179,13 +179,14 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 
 ### Группа (group)
 
-Значение ключа задаёт ориентацию: `"horizontal"`, `"vertical"`, `"alwaysHorizontal"`, `"alwaysVertical"`, `"collapsible"`.
+Значение ключа задаёт **ориентацию**: `"vertical"`, `"horizontalIfPossible"`, `"alwaysHorizontal"`.
 
 | Ключ | Описание |
 |------|----------|
+| `behavior` | Поведение группы: `"collapsible"` (сворачиваемая) / `"popup"` (всплывающая). Опустить = обычная |
 | `showTitle: true` | Показывать заголовок группы |
 | `united: false` | Левый край полей ввода выравнивается только в пределах этой группы (по умолчанию `true` — сквозное выравнивание по самому длинному заголовку, в т.ч. с соседними группами) |
-| `collapsed: true` | Только для `"group": "collapsible"` — группа создаётся свёрнутой |
+| `collapsed: true` | Для `behavior: "collapsible"` / `"popup"` — группа создаётся свёрнутой |
 | `representation` | `"none"`, `"normal"`, `"weak"`, `"strong"` |
 | `children: [...]` | Вложенные элементы |
 
@@ -202,8 +203,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 | `height` | Высота в строках таблицы |
 | `header: false` | Скрыть шапку |
 | `footer: true` | Показать подвал |
-| `commandBarLocation` | `"None"`, `"Top"`, `"Auto"` |
+| `commandBarLocation` | `"None"`, `"Top"`, `"Bottom"`, `"Auto"` |
-| `searchStringLocation` | `"None"`, `"Top"`, `"Auto"` |
+| `searchStringLocation` | `"None"`, `"Top"`, `"Bottom"`, `"CommandBar"`, `"PullFromTop"`, `"Auto"` |
 | `choiceMode: true` | Режим выбора (для форм выбора) |
 | `initialTreeView` | `"ExpandTopLevel"` и др. (иерархические списки) |
 | `enableDrag: true` | Разрешить перетаскивание |
@@ -240,6 +241,15 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 ]}
 ```
 
+### Картинка-поле (picField)
+
+PictureField, привязанный к булеву/числу, рисует иконку только при заданном `valuesPicture`:
+
+| Ключ | Описание |
+|------|----------|
+| `valuesPicture` | Ref картинки значения: `"StdPicture.Favorites"`, `"CommonPicture.X"` |
+| `loadTransparent: true` | Скрыть кадр «нет значения» |
+
 ### Страницы (pages + page)
 
 | Ключ (pages) | Описание |
@@ -431,7 +441,7 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
   "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
   "elements": [
     { "group": "horizontal", "name": "ГруппаФайл", "children": [
-      { "input": "ИмяФайла", "path": "ИмяФайла", "title": "Файл", "inputHint": "Выберите файл...", "choiceButton": true, "on": ["StartChoice"] },
+      { "input": "ИмяФайла", "path": "ИмяФайла", "title": "Файл", "inputHint": "Выберите файл...", "choiceButton": true, "events": { "StartChoice": "ИмяФайлаНачалоВыбора" } },
       { "check": "ПерваяСтрокаЗаголовок", "path": "ПерваяСтрокаЗаголовок" }
     ]},
     { "input": "Результат", "path": "Результат", "multiLine": true, "height": 8, "readOnly": true, "title": "Лог" },
@@ -491,8 +501,8 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
   "title": "Просмотр данных",
   "elements": [
     { "group": "horizontal", "name": "Фильтр", "children": [
-      { "input": "Период", "path": "Период", "on": ["OnChange"] },
+      { "input": "Период", "path": "Период", "events": { "OnChange": "ПериодПриИзменении" } },
-      { "input": "Организация", "path": "Организация", "on": ["OnChange"] }
+      { "input": "Организация", "path": "Организация", "events": { "OnChange": "ОрганизацияПриИзменении" } }
     ]},
     { "table": "Данные", "path": "Данные", "changeRowSet": true, "columns": [
       { "input": "Дата", "path": "Данные.Дата" },
@@ -513,10 +523,26 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -
 }
 ```
 
+## Продвинутые конструкции (по необходимости)
+
+Описанного выше хватает для большинства форм. Под конкретную задачу подгрузите файл из `references/`:
+
+- `dynamic-list.md` — форма списка: источник, отбор, сортировка, группировки, параметры запроса
+- `appearance.md` — условное и статическое оформление элементов (цвета/шрифты/рамки)
+- `choice-params.md` — параметры и связи выбора у полей ввода
+- `command-interface.md` — командный интерфейс формы
+- `roles-access.md` — пользовательская видимость и доступ по ролям
+- `companion-panels.md` — контент расширенной подсказки и контекстного меню
+- `special-fields.md` — поля документа/датчика (HTML, текст, индикатор, ползунок)
+- `charts.md` — диаграммы и планировщик
+- `report-form.md` — свойства формы отчёта
+- `type-system-advanced.md` — наборы и составные типы
+- `table-advanced.md` — расширенные свойства таблиц
+- `layout-advanced.md` — тонкая компоновка и геометрия
+
 ## Автогенерация
 
 - **Companion-элементы**: ContextMenu, ExtendedTooltip и др. создаются автоматически
-- **Обработчики событий**: `"on": ["OnChange"]` → `ОрганизацияПриИзменении`
 - **Namespace**: все 17 namespace-деклараций
 - **ID**: последовательная нумерация, AutoCommandBar = id="-1"
 - **Unknown keys**: выводится предупреждение о нераспознанных ключах

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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