dsh-edt-projects 0.10.0 → 0.12.0

package/lib/repo.mjs

@@ -0,0 +1,153 @@
+// 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 } 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;
+}

package/lib/schema.mjs

@@ -3,7 +3,7 @@
 //
 // Правила апгрейда: существующие значения не меняются, недостающие ключи
 // добавляются, неизвестные ключи сохраняются, версия поднимается.
-export const CONFIG_VERSION = 2;
+export const CONFIG_VERSION = 3;
 
 /** Значения по умолчанию для нового файла. Пустые строки и массивы
  *  нормализаторы игнорируют, поэтому init ничего не включает сам по себе.
@@ -18,6 +18,22 @@ 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,
+  },
   tests: {
     yaxunit: { enabled: false, path: '', project: '' },
     vanessa: { enabled: false, path: '' },
@@ -53,6 +69,23 @@ 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.' },
   'tests.yaxunit.enabled': { type: 'boolean', description: 'Включить правила тестируемости YAxUnit.' },
   'tests.yaxunit.path': { type: 'string', description: 'Каталог тестов как образец стиля.' },
   'tests.yaxunit.project': { type: 'string', description: 'EDT-проект, в который писать тесты.' },
@@ -165,6 +198,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 +217,27 @@ export function validateConfig(config) {
     errors.push('projects: ожидался массив строк');
   }
 
+  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 };
 }