dsh-edt-projects 0.11.0 → 0.12.1

package/lib/repo.mjs

@@ -0,0 +1,185 @@
+// Git-репозиторий и worktree по файлам, без вызова git.
+//
+// Нужно это для двух вещей:
+//   - понять, что каталог сессии — linked worktree, и найти его основной checkout;
+//   - увидеть репозитории task space, когда каталог сессии сам репозиторием не
+//     является (layout `<task>/<repo>` у dsh-worktree-space).
+//
+// Git-команды здесь не используются намеренно: функция вызывается при рендере
+// промпта (синхронно, на каждом шаге) и должна быть дешёвой и предсказуемой.
+// Формат `.git`-файла и `commondir` — стабильный контракт git для linked worktree.
+import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+
+import { normalizeProjectPath, matchesProject } from './enable.mjs';
+
+/** Сколько родителей просматривать в поисках `.git`. */
+const MAX_UP = 8;
+
+/** Каталоги task space, которые заведомо не репозитории. */
+const SKIP_CHILDREN = new Set(['build', 'node_modules', 'archived-docs', '.git', '.worktree-space']);
+
+/** realpath, но для отсутствующего пути — сам путь. */
+function realOrSelf(value) {
+  try {
+    return realpathSync.native(value);
+  } catch {
+    return value;
+  }
+}
+
+/** Файл `.git` со строкой `gitdir: <путь>` — так выглядит linked worktree. */
+export function gitFileAt(root) {
+  const dotGit = path.join(root, '.git');
+  let stat;
+  try {
+    stat = statSync(dotGit);
+  } catch {
+    return undefined;
+  }
+  if (!stat.isFile()) return undefined;
+  let text;
+  try {
+    text = readFileSync(dotGit, 'utf8');
+  } catch {
+    return undefined;
+  }
+  const match = /^gitdir:\s*(.+)$/m.exec(text);
+  if (!match) return undefined;
+  const raw = match[1].trim().replace(/^"(.*)"$/, '$1');
+  return path.isAbsolute(raw) ? path.normalize(raw) : path.resolve(root, raw);
+}
+
+/**
+ * Общий git-каталог для worktree: в `<main>/.git/worktrees/<name>` лежит
+ * файл `commondir` (обычно `../..`). Без него каталог считается общим.
+ */
+export function commonDirOf(gitDir) {
+  try {
+    const text = readFileSync(path.join(gitDir, 'commondir'), 'utf8').trim();
+    if (text === '') return gitDir;
+    return path.resolve(gitDir, text);
+  } catch {
+    return gitDir;
+  }
+}
+
+/** Основной checkout по общему git-каталогу (`<main>/.git` -> `<main>`). */
+export function mainRootOf(commonDir) {
+  return path.basename(commonDir).toLowerCase() === '.git' ? path.dirname(commonDir) : commonDir;
+}
+
+/** Совпадают ли пути (нормализация как в настройках проектов). */
+export function isSamePath(left, right, options = {}) {
+  const a = normalizeProjectPath(left, options);
+  const b = normalizeProjectPath(right, options);
+  return a !== undefined && a === b;
+}
+
+/**
+ * Ближайший git-репозиторий для каталога.
+ * @returns {{ root: string, gitDir: string, commonDir: string, mainRoot: string, isWorktree: boolean }|undefined}
+ */
+export function repositoryAt(startDir, { maxUp = MAX_UP, platform = process.platform } = {}) {
+  if (typeof startDir !== 'string' || startDir.trim() === '') return undefined;
+  let dir = path.resolve(startDir);
+  for (let depth = 0; depth <= maxUp; depth++) {
+    const gitDirFile = gitFileAt(dir);
+    if (gitDirFile !== undefined) {
+      const commonDir = realOrSelf(commonDirOf(gitDirFile));
+      const root = realOrSelf(dir);
+      // Submodule тоже живёт через `.git`-файл, но worktree-ом не является:
+      // его общий каталог лежит в `.git/modules/…` основного репозитория.
+      const isSubmodule = commonDir.split(/[\\/]+/).includes('modules');
+      if (isSubmodule) {
+        return { root, gitDir: gitDirFile, commonDir, mainRoot: root, isWorktree: false };
+      }
+      const mainRoot = realOrSelf(mainRootOf(commonDir));
+      return {
+        root,
+        gitDir: gitDirFile,
+        commonDir,
+        mainRoot,
+        isWorktree: !isSamePath(root, mainRoot, { platform }),
+      };
+    }
+    if (existsSync(path.join(dir, '.git'))) {
+      const root = realOrSelf(dir);
+      const gitDir = realOrSelf(path.join(dir, '.git'));
+      return { root, gitDir, commonDir: gitDir, mainRoot: root, isWorktree: false };
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return undefined;
+}
+
+/**
+ * Репозитории каталога сессии: сам репозиторий либо репозитории первого уровня
+ * (task space). Сортировка детерминированная — от неё зависит выбор окружения.
+ */
+export function repositoriesUnder(cwd, { platform = process.platform, maxChildren = 64 } = {}) {
+  const direct = repositoryAt(cwd, { platform });
+  if (direct !== undefined) return [direct];
+
+  let entries;
+  try {
+    entries = readdirSync(cwd, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  const found = [];
+  for (const entry of entries.slice(0, maxChildren)) {
+    if (!entry.isDirectory() || entry.name.startsWith('.') || SKIP_CHILDREN.has(entry.name)) continue;
+    const repo = repositoryAt(path.join(cwd, entry.name), { maxUp: 0, platform });
+    if (repo !== undefined) found.push(repo);
+  }
+  return found.sort((left, right) => left.root.localeCompare(right.root, undefined, { sensitivity: 'base' }));
+}
+
+/** Уникальные репозитории по нормализованному корню (для `stop-all` и тестов). */
+export function uniqueRepositories(repositories, { platform = process.platform } = {}) {
+  const seen = new Set();
+  const out = [];
+  for (const repo of repositories ?? []) {
+    const key = normalizeProjectPath(repo.root, { platform });
+    if (key === undefined || seen.has(key)) continue;
+    seen.add(key);
+    out.push(repo);
+  }
+  return out;
+}
+
+/**
+ * Каталог, от которого плагин считает проект.
+ *
+ * `origin` — неизменяемый `session.header.cwd`, `work` — эффективный каталог
+ * сессии (`ctx.workingDirectory`). Переключаемся на work только если это
+ * linked worktree, связанный с исходным репозиторием: `cd` в подкаталог или в
+ * чужой репозиторий проект не переключает, а worktree того же репозитория —
+ * переключает. Возвращается корень worktree, а не подкаталог, чтобы настройки
+ * и окружение не зависели от `cd` внутри него.
+ * @returns {string} абсолютный каталог проекта.
+ */
+export function resolveContextCwd({ origin, work, platform = process.platform } = {}) {
+  if (typeof origin !== 'string' || origin === '') {
+    return typeof work === 'string' && work !== '' ? work : process.cwd();
+  }
+  if (typeof work !== 'string' || work === '' || isSamePath(work, origin, { platform })) return origin;
+
+  const workRepo = repositoryAt(work, { platform });
+  if (workRepo === undefined || workRepo.isWorktree !== true) return origin;
+
+  const originRepo = repositoryAt(origin, { platform });
+  if (originRepo === undefined) return origin;
+
+  const related =
+    isSamePath(workRepo.mainRoot, originRepo.root, { platform }) ||
+    isSamePath(workRepo.mainRoot, origin, { platform }) ||
+    matchesProject(originRepo.root, workRepo.mainRoot, { platform }) ||
+    matchesProject(origin, workRepo.mainRoot, { platform });
+
+  return related ? workRepo.root : origin;
+}

package/lib/schema.mjs

@@ -3,7 +3,7 @@
 //
 // Правила апгрейда: существующие значения не меняются, недостающие ключи
 // добавляются, неизвестные ключи сохраняются, версия поднимается.
-export const CONFIG_VERSION = 2;
+export const CONFIG_VERSION = 3;
 
 /** Значения по умолчанию для нового файла. Пустые строки и массивы
  *  нормализаторы игнорируют, поэтому init ничего не включает сам по себе.
@@ -18,6 +18,26 @@ export const DEFAULTS = {
     bsl: { root: '' },
     tasks: { url: '' },
   },
+  // Окружение EDT для git worktree: workspace в <worktree>/build/ws и свой
+  // MCP-сервер на своём порту. Поднимается только в linked worktree.
+  workspace: {
+    enabled: true,
+    root: '',
+    home: { win32: '', linux: '' },
+    vm: '',
+    xmxIde: '6g',
+    xmxImport: '8g',
+    import: 'auto',
+    importTimeout: 3600,
+    startTimeout: 1800,
+    projects: [],
+    ports: { min: 20000, max: 39999 },
+    stopOnSessionEnd: true,
+    // MCP-инструменты EDT-MCP, которые нам нужны в worktree: plain text
+    // вместо embedded resource (DSH их не рендерит) и скриншоты форм.
+    plainText: true,
+    formScreenshots: true,
+  },
   tests: {
     yaxunit: { enabled: false, path: '', project: '' },
     vanessa: { enabled: false, path: '' },
@@ -37,12 +57,24 @@ export const KNOWN = {
   'servers.*.url': { type: 'string', description: 'Адрес MCP-сервера (streamable-http).' },
   'servers.*.headers': { type: 'object', description: 'Заголовки запросов, например Authorization.' },
   'servers.*.root': { type: 'string', description: 'Корень рабочего пространства (для bsl).' },
+  'servers.*.transport': { type: 'string', description: 'Транспорт: stdio или streamable-http.' },
+  'servers.*.disabled': { type: 'boolean', description: 'Не монтировать сервер.' },
+  'servers.*.unavailable': { type: 'boolean', description: 'Сервер описан, но не настроен (нет переменных окружения).' },
+  'servers.*.command': { type: 'string', description: 'Команда запуска для stdio-сервера.' },
+  'servers.*.args': { type: 'array', description: 'Аргументы команды stdio-сервера.' },
+  'servers.*.env': { type: 'object', description: 'Переменные окружения stdio-сервера.' },
+  'servers.*.cwd': { type: 'string', description: 'Рабочий каталог stdio-сервера.' },
+  'servers.*.maxInstructionBytes': { type: 'number', description: 'Предел текста инструкций сервера.' },
   'servers.*.lazy': { type: 'boolean', description: 'Не подключать на старте, только по edt_pin.' },
   'servers.*.shared': { type: 'boolean', description: 'Устарело: серверы всегда монтируются в скоупе сессии.' },
   'servers.*.provision': { type: 'boolean', description: 'Параметры запуска добираются на edt_pin.' },
   'servers.*.toolCallTimeoutMs': { type: 'number', description: 'Таймаут вызова инструмента.' },
   'servers.*.failOnStartupError': { type: 'boolean', description: 'Падать, если стартовое подключение не удалось.' },
   'servers.*.reconnect': { type: 'object', description: 'Политика переподключения.' },
+  'servers.*.reconnect.enabled': { type: 'boolean', description: 'Включено ли переподключение.' },
+  'servers.*.reconnect.initialDelayMs': { type: 'number', description: 'Начальная задержка переподключения, мс.' },
+  'servers.*.reconnect.maxDelayMs': { type: 'number', description: 'Максимальная задержка переподключения, мс.' },
+  'servers.*.reconnect.maxAttempts': { type: 'number', description: 'Максимум попыток переподключения.' },
   'servers.bsl.jar': { type: 'string', description: 'Готовый jar BSL Language Server.' },
   'servers.bsl.url': { type: 'string', description: 'Прямой URL на jar вместо GitHub.' },
   'servers.bsl.version': { type: 'string', description: 'Тег релиза BSL LS, например v1.0.7.' },
@@ -53,6 +85,25 @@ export const KNOWN = {
   'servers.bsl.mode': { type: 'string', description: 'hybrid (LSP+MCP) или stdio.' },
   'servers.bsl.mcpUrl': { type: 'string', description: 'Адрес уже запущенного BSL LS по HTTP.' },
   'servers.bsl.download': { type: 'boolean', description: 'Разрешено ли скачивание jar.' },
+  'workspace': { type: 'object', description: 'Окружение EDT для git worktree: workspace в <worktree>/build/ws и свой MCP-порт.' },
+  'workspace.enabled': { type: 'boolean', description: 'Поднимать ли EDT-окружение в worktree автоматически.' },
+  'workspace.root': { type: 'string', description: 'Корень окружения относительно корня worktree; пусто — сам worktree.' },
+  'workspace.home': { type: 'object', description: 'Каталог установки 1C:EDT по платформам.' },
+  'workspace.home.win32': { type: 'string', description: 'Каталог 1C:EDT в Windows (где 1cedt.exe).' },
+  'workspace.home.linux': { type: 'string', description: 'Каталог 1C:EDT в Linux (где 1cedt).' },
+  'workspace.vm': { type: 'string', description: 'Java для EDT; пусто — автопоиск jdk-full-17 рядом с установкой.' },
+  'workspace.xmxIde': { type: 'string', description: 'Xmx для запуска EDT, например 6g.' },
+  'workspace.xmxImport': { type: 'string', description: 'Xmx для 1cedtcli при импорте проектов.' },
+  'workspace.import': { type: 'string', description: 'Импорт проектов в новый workspace: true, false или auto.' },
+  'workspace.importTimeout': { type: 'number', description: 'Таймаут импорта 1cedtcli, секунды.' },
+  'workspace.startTimeout': { type: 'number', description: 'Ожидание готовности MCP-сервера EDT, секунды.' },
+  'workspace.projects': { type: 'array', description: 'Шаблоны EDT-проектов для импорта; пусто — автопоиск каталогов с .project.' },
+  'workspace.ports': { type: 'object', description: 'Диапазон портов MCP-сервера EDT.' },
+  'workspace.ports.min': { type: 'number', description: 'Нижняя граница диапазона портов.' },
+  'workspace.ports.max': { type: 'number', description: 'Верхняя граница диапазона портов.' },
+  'workspace.stopOnSessionEnd': { type: 'boolean', description: 'Останавливать EDT, когда закрылась последняя сессия на этом worktree.' },
+  'workspace.plainText': { type: 'boolean', description: 'Plain text mode EDT-MCP вместо embedded resource (DSH их не рендерит).' },
+  'workspace.formScreenshots': { type: 'boolean', description: 'Включить get_form_screenshot и JVM-флаг nativeFormBufferedLayoutRender.' },
   'tests.yaxunit.enabled': { type: 'boolean', description: 'Включить правила тестируемости YAxUnit.' },
   'tests.yaxunit.path': { type: 'string', description: 'Каталог тестов как образец стиля.' },
   'tests.yaxunit.project': { type: 'string', description: 'EDT-проект, в который писать тесты.' },
@@ -165,6 +216,8 @@ export function validateConfig(config) {
       warnings.push(`неизвестный ключ: ${path}`);
       return;
     }
+    // У import три допустимых значения (true, false, "auto") — своя проверка ниже.
+    if (path === 'workspace.import') return;
     const expected = KNOWN[path]?.type ?? Object.entries(KNOWN).find(([pattern]) => pattern.includes('*') && matchesPattern(path, pattern))?.[1]?.type;
     if (expected === undefined) return;
     const actual = Array.isArray(value) ? 'array' : typeof value;
@@ -182,6 +235,36 @@ export function validateConfig(config) {
     errors.push('projects: ожидался массив строк');
   }
 
+  if (isPlainObject(config.servers)) {
+    for (const [name, server] of Object.entries(config.servers)) {
+      if (!isPlainObject(server)) continue;
+      if (Array.isArray(server.args) && !server.args.every((item) => typeof item === 'string')) {
+        errors.push(`servers.${name}.args: ожидался массив строк`);
+      }
+    }
+  }
+
+  if (isPlainObject(config.workspace)) {
+    const workspace = config.workspace;
+    if (workspace.import !== undefined && ![true, false, 'auto'].includes(workspace.import)) {
+      errors.push(`workspace.import: ожидалось true, false или "auto", получено ${JSON.stringify(workspace.import)}`);
+    }
+    if (workspace.projects !== undefined) {
+      if (!Array.isArray(workspace.projects)) errors.push('workspace.projects: ожидался массив шаблонов');
+      else if (!workspace.projects.every((item) => typeof item === 'string')) errors.push('workspace.projects: ожидался массив строк');
+    }
+    for (const key of ['importTimeout', 'startTimeout']) {
+      const value = workspace[key];
+      if (value !== undefined && (!Number.isFinite(value) || value <= 0)) errors.push(`workspace.${key}: ожидалось положительное число`);
+    }
+    if (isPlainObject(workspace.ports)) {
+      const { min, max } = workspace.ports;
+      if (min !== undefined && (!Number.isInteger(min) || min < 1 || min > 65535)) errors.push('workspace.ports.min: ожидался порт 1..65535');
+      if (max !== undefined && (!Number.isInteger(max) || max < 1 || max > 65535)) errors.push('workspace.ports.max: ожидался порт 1..65535');
+      if (Number.isInteger(min) && Number.isInteger(max) && min > max) errors.push('workspace.ports: min больше max');
+    }
+  }
+
   return { errors, warnings };
 }