@vadim-epifanov/dsh-orchestrator 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Vadim Epifanov
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,80 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # Оркестратор
2
+
3
+ Плагин DSH, который раздаёт задачу субагентам: у каждой роли свои правила и своя модель, а число ролей, работающих одновременно, ограничено. Настройки задаются отдельно для каждого рабочего пространства (рабочей папки), поэтому в одном проекте правила могут быть одни, в другом — другие.
4
+
5
+ Для кого: для тех, кто работает в DSH с несколькими проектами и хочет, чтобы исследование, проверка, правка кода и документация шли параллельно, каждая на подходящей модели, но по общим правилам проекта.
6
+
7
+ ## Возможности
8
+
9
+ - **Роли с собственными правилами и моделями.** У каждой роли свой текст правил, а также свой провайдер, модель и уровень рассуждений. Типовой набор ролей — `explorer` (исследователь), `reviewer` (проверяющий), `executor` (исполнитель), `documentalis` (документалист), `master` (мастер). По id роли регистрируется инструмент `delegate_<id>`, которым оркестратор её запускает.
10
+ - **Ограничение числа одновременных ролей.** Для каждого пространства задаётся `maxParallel` (от 1 до 8): лишние вызовы не отклоняются, а ждут очереди.
11
+ - **Настройки на каждое рабочее пространство.** Правила, шаблоны, роли и предел параллельности — свои у каждой рабочей папки; главный выключатель и модель агентов по умолчанию — общие для всех.
12
+ - **Страница настроек «Оркестратор» в Web UI** с блоками:
13
+ - «Главные настройки» — выключатель «Оркестратор включён» и модель агентов по умолчанию;
14
+ - «Настройки для рабочих пространств» — список пространств, каталог, `maxParallel` и роли;
15
+ - «Правила оркестратора»;
16
+ - «Шаблоны оркестратора»;
17
+ - «Роли».
18
+ - **Правила и шаблоны — обычные файлы внутри рабочей папки:** `.orch\orchestrator\rules.md` и `.orch\orchestrator\templates.md`. Их можно править и на странице настроек, и любым редактором.
19
+ - **Путь к файлу в настройках — ссылка:** клик открывает `rules.md` или `templates.md` приложением, которое система назначила для файлов `*.md`.
20
+
21
+ ## Требования
22
+
23
+ - DSH версии, совместимой с диапазоном `engines.dsh` пакета: `>=0.2.1-rc.2 <0.3.0`.
24
+ - Node.js 24 или новее.
25
+ - Профиль DSH (например, `web`): настройки плагина лежат внутри каталога профиля.
26
+ - Настроенный в профиле провайдер LLM и его API-ключ. Ключи в пакет не входят: их получают и прописывают на машине самостоятельно.
27
+ - Права на запись в каталог профиля: установка меняет `package.json` профиля.
28
+
29
+ ## Установка
30
+
31
+ Установка — одна команда: бандл ставится из реестра npm инструментом `plugin_manager` самого DSH.
32
+
33
+ ```
34
+ plugin_manager
35
+ action: install_bundle
36
+ target: "@vadim-epifanov/dsh-orchestrator@1.0.0"
37
+ ```
38
+
39
+ После установки перезапустите DSH, откройте в Web настройки «Оркестратор», включите плагин, добавьте рабочее пространство, заполните правила и роли.
40
+
41
+ ## Обновление версии
42
+
43
+ Та же команда с новым номером версии:
44
+
45
+ ```
46
+ plugin_manager
47
+ action: install_bundle
48
+ target: "@vadim-epifanov/dsh-orchestrator@<новая версия>"
49
+ ```
50
+
51
+ После установки перезапустите DSH. Настройки профиля и файлы правил в рабочих папках при обновлении остаются на месте.
52
+
53
+ ## Удаление
54
+
55
+ ```
56
+ plugin_manager
57
+ action: remove_bundle
58
+ target: "@vadim-epifanov/dsh-orchestrator"
59
+ ```
60
+
61
+ Затем перезапустите DSH, чтобы строка плагина ушла из композиции. Данные при удалении остаются: настройки профиля и каталог `.orch\` в рабочих папках удаляются вручную, если больше не нужны.
62
+
63
+ ## Где лежат данные
64
+
65
+ | Что | Где |
66
+ |---|---|
67
+ | Настройки плагина (формат 2, ключей и секретов в нём нет) | `<каталог профиля>\orchestrator\settings.json` |
68
+ | Правила оркестратора и ролей | `<рабочее пространство>\.orch\orchestrator\rules.md` |
69
+ | Шаблоны заданий и карточка задачи | `<рабочее пространство>\.orch\orchestrator\templates.md` |
70
+ | Карточки задач | `<рабочее пространство>\.orch\tasks\` |
71
+
72
+ Каталог профиля — это значение `$env:DSH_PROFILE_DIR` в запущенной сессии DSH.
73
+
74
+ ## Подробная инструкция
75
+
76
+ Полная инструкция — установка, обновление, перенос правил между пространствами и разбор типовых ошибок — лежит в файле `orchestrator_setup.md`. Он идёт отдельно от пакета, в архиве `orchestrator_setup.zip`, и в пакет не входит.
77
+
78
+ ## Лицензия
79
+
80
+ MIT. Текст лицензии — в файле [LICENSE](LICENSE).