dsh-edt-projects 0.10.0 → 0.12.0

package/README.md

@@ -11,25 +11,35 @@ SonarQube/GitLab.
 остальных проектах в контексте остаётся только `edt_config`, которым проект и
 включается.
 
+В **linked git worktree** плагин поднимает отдельное окружение EDT
+(`<worktree>/build/ws`, свой порт и логи), импортирует проекты и монтирует
+`mcp__edt__*` туда; включённость и настройки наследуются от основного checkout.
+Управление — инструмент `edt_workspace`.
+
 ## Установка
 
 ```text
 plugin_manager { action: "install_bundle", target: "dsh-edt-projects" }
 ```
 
-Нужны EDT 2026.1/2026.2 с установленным EDT-MCP и запущенным MCP-сервером
-(по умолчанию `127.0.0.1:8765`) — подробности и настройка в
+Нужны EDT 2026.1/2026.2 с установленным EDT-MCP. В основном checkout MCP-сервер
+запускается вручную (по умолчанию `127.0.0.1:8765`); в worktree плагин находит
+установку EDT сам или по `workspace.home`/`DSH_1C_EDT_HOME` и поднимает её.
+Подробности и настройка — в
 [README репозитория](https://github.com/pravets/dsh-edt-projects#readme).
 
 ## Что внутри
 
 - `lib/` — хаб MCP-серверов: активация по проекту, монтаж по требованию
   (`edt_pin`), настройки на проект, правила для системного промпта, провайдер
-  навыков.
+  навыков; `repo.mjs`/`workspace.mjs`/`workspace-run.mjs` — определение worktree,
+  подъём и остановка EDT-окружения в `build/`.
 - `skills/` — навыки `edt-mcp-project-sonar` и `edt-mcp-project-gitlab`,
   включаются флагами `sonar.enabled` и `gitlab.enabled` внутри включённого
   проекта.
-- `cordis.patch.yml` — состав серверов, который применяет менеджер плагинов.
+- `cordis.patch.yml` — состав серверов, который применяет менеджер плагинов:
+  EDT, BSL Language Server по требованию, MCP-трекер и `v8std` (стандарты 1С и
+  расшифровка диагностик EDT/BSL).
 
 ## Лицензия
 

package/cordis.patch.yml

@@ -27,9 +27,19 @@
 # Флаги tests включают правила тестируемости: YAxUnit — закладывать тестируемость
 # и писать тесты в указанный проект, Vanessa — предлагать сценарные тесты.
 #
+# Git worktree: плагин сам поднимает отдельный EDT workspace в
+# <worktree>/build/ws со своим портом MCP-сервера и импортом проектов, а
+# включённость и настройки наследует от основного checkout. Секция настроек:
+#   "workspace": { "home": { "win32": "C:\\Program Files\\1C\\1CE\\components\\1c-edt-..." },
+#                  "import": "auto", "ports": { "min": 20000, "max": 39999 },
+#                  "stopOnSessionEnd": true }
+# Управление из сессии — инструмент edt_workspace (status/init/stop/restart/import).
+#
 # Переменные окружения (префикс DSH_1C_ — чтобы ни с чем не пересекаться):
 #   EDT_MCP_URL               адрес MCP-сервера EDT (по умолчанию 127.0.0.1:8765)
 #   EDT_MCP_TOKEN             токен, если он включён в EDT
+#   DSH_1C_EDT_HOME           каталог установки EDT для worktree (перекрывает workspace.home)
+#   DSH_1C_EDT_IMPORT         1/0 — импортировать проекты в workspace worktree
 #   DSH_1C_WIKI               пути к вики через «;»
 #   DSH_1C_WIKI_ENTRY         входная точка вики, например wiki/index.md
 #   DSH_1C_BSL_LS_JAR         готовый bsl-language-server jar (главнее всего)
@@ -45,6 +55,8 @@
 #   DSH_1C_BSL_MCP_URL        адрес уже запущенного BSL LS по Streamable HTTP
 #   TASKS_MCP_URL             адрес MCP-сервера системы задач
 #   TASKS_MCP_TOKEN           токен системы задач
+#   V8STD_MCP_URL             адрес MCP-сервера стандартов (по умолчанию https://ai.v8std.ru/mcp)
+#   V8STD_MCP_TOKEN           токен своего инстанса v8std, если он нужен
 - insert:
     - id: mcp-hub
       name: 'dsh-edt-projects'
@@ -90,3 +102,17 @@
             headers: !!js 'process.env.TASKS_MCP_TOKEN ? { Authorization: `Bearer ${process.env.TASKS_MCP_TOKEN}` } : {}'
             toolCallTimeoutMs: 120000
             failOnStartupError: false
+
+          # Стандарты 1С и диагностики: публичная read-only база v8std.
+          # lazy: пять схем не занимают контекст, пока не нужны. Модель подключает
+          # сервер по edt_pin, когда EDT или BSL LS выдал код ошибки либо задан
+          # вопрос про стандарт.
+          # Свой инстанс: servers.v8std.url в файлах настроек (перекрывает это
+          # значение) или переменная V8STD_MCP_URL.
+          v8std:
+            lazy: true
+            transport: streamable-http
+            url: !!js 'process.env.V8STD_MCP_URL ?? "https://ai.v8std.ru/mcp"'
+            headers: !!js 'process.env.V8STD_MCP_TOKEN ? { Authorization: `Bearer ${process.env.V8STD_MCP_TOKEN}` } : {}'
+            toolCallTimeoutMs: 60000
+            failOnStartupError: false

package/lib/bsl.mjs

@@ -70,7 +70,9 @@ export function bslSettings(env = process.env) {
     cacheDir: first(env, 'DSH_1C_BSL_LS_CACHE') ?? join(env.DSH_HOME ?? join(homedir(), '.dsh'), 'cache', 'bsl-language-server'),
     java: first(env, 'DSH_1C_BSL_LS_JAVA', 'BSL_LS_JAVA') ?? 'java',
     cwd: first(env, 'DSH_1C_BSL_LS_CWD', 'BSL_LS_CWD') ?? '',
-    root: first(env, 'DSH_1C_BSL_LS_ROOT', 'DSH_1C_BSL_LS_CWD', 'BSL_LS_CWD') ?? process.cwd(),
+    // Пусто = «взять корень проекта»; подставляется в bslSettingsFor, где
+    // известен каталог сессии (для worktree — корень worktree, а не cwd DSH).
+    root: first(env, 'DSH_1C_BSL_LS_ROOT', 'DSH_1C_BSL_LS_CWD', 'BSL_LS_CWD') ?? '',
     port: first(env, 'DSH_1C_BSL_LS_PORT'),
     mode: (first(env, 'DSH_1C_BSL_LS_MODE') ?? 'hybrid').toLowerCase(),
     downloadAllowed: download === undefined ? true : !isOff(download),

package/lib/config.mjs

@@ -5,7 +5,7 @@
 // без перезапуска DSH; разбор кэшируется по mtimeMs.
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 
 const USER_FILE = 'dsh-1c.json';
 const PROJECT_FILE = '.dsh-1c.json';
@@ -73,10 +73,37 @@ export function mergeLayers(...layers) {
 }
 
 /**
- * Собирает действующие настройки: база (патч) <- пользователь <- проект.
+ * Каталоги, чьи `.dsh-1c.json` образуют слои проекта.
+ *
+ * Обычная сессия передаёт только `cwd`. Для worktree вызывающий передаёт
+ * `[cwd, repo, mainRoot]`: настройки основного checkout (в нём файл может быть
+ * незакоммиченным) действуют и в worktree, а файл самого worktree — сильнее.
+ * Порядок сохраняется, дубликаты путей схлопываются.
+ */
+export function projectDirs({ cwd, projectCwds } = {}) {
+  const list = Array.isArray(projectCwds) && projectCwds.length > 0 ? projectCwds : [cwd];
+  const seen = new Set();
+  const out = [];
+  for (const dir of list) {
+    if (typeof dir !== 'string' || dir === '') continue;
+    let key;
+    try {
+      key = resolve(dir);
+    } catch {
+      continue;
+    }
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(dir);
+  }
+  return out;
+}
+
+/**
+ * Собирает действующие настройки: база (патч) <- пользователь <- файлы проектов.
  * @returns {{ config: object, sources: string[], errors: string[] }}
  */
-export function resolveConfig({ cwd, env = process.env, base = {} } = {}) {
+export function resolveConfig({ cwd, projectCwds, env = process.env, base = {} } = {}) {
   const sources = [];
   const errors = [];
 
@@ -84,12 +111,18 @@ export function resolveConfig({ cwd, env = process.env, base = {} } = {}) {
   if (user.error !== undefined) errors.push(user.error);
   if (user.config !== undefined) sources.push(userConfigPath(env));
 
-  const projectPath = projectConfigPath(cwd);
-  const project = readJsonConfig(projectPath);
-  if (project.error !== undefined) errors.push(project.error);
-  if (project.config !== undefined && projectPath !== undefined) sources.push(projectPath);
+  const layers = [];
+  for (const dir of projectDirs({ cwd, projectCwds })) {
+    const projectPath = projectConfigPath(dir);
+    if (projectPath === undefined) continue;
+    const project = readJsonConfig(projectPath);
+    if (project.error !== undefined) errors.push(project.error);
+    if (project.config === undefined) continue;
+    sources.push(projectPath);
+    layers.push(project.config);
+  }
 
-  return { config: mergeLayers(base, user.config, project.config), sources, errors };
+  return { config: mergeLayers(base, user.config, ...layers), sources, errors };
 }
 
 /**

package/lib/enable.mjs

@@ -89,3 +89,31 @@ export function activationFor({ cwd, config, hasProjectFile = false } = {}, opti
 export function isEnabledFor(input, options = {}) {
   return activationFor(input, options).enabled;
 }
+
+/**
+ * Активация с учётом путей worktree.
+ *
+ * Обычная проверка идёт от каталога сессии. Для worktree дополнительно
+ * проверяются его корень и основной checkout: запись `projects` может называть
+ * основной checkout, а файл `.dsh-1c.json` может лежать только в нём (не
+ * закоммичен). Сильнее всего остаётся `enabled` из объединённых настроек.
+ * @param input.cwd каталог сессии (может быть корнем task space).
+ * @param input.paths дополнительные пути: корень worktree, основной checkout.
+ */
+export function activationForPaths({ cwd, config, hasProjectFile = false, paths = [] } = {}, options = {}) {
+  const direct = activationFor({ cwd, config, hasProjectFile }, options);
+  if (direct.reason !== 'not-selected') return direct;
+
+  const projects = Array.isArray(config?.projects) ? config.projects : [];
+  const seen = new Set([normalizeProjectPath(cwd, options)]);
+  for (const candidate of paths) {
+    const key = normalizeProjectPath(candidate, options);
+    if (key === undefined || seen.has(key)) continue;
+    seen.add(key);
+    const entry = projects.find((item) => matchesProject(candidate, item, options));
+    if (entry !== undefined) {
+      return { enabled: true, reason: 'allowlist', entry, path: candidate, inherited: true };
+    }
+  }
+  return direct;
+}