@gian-tiaga/eda 3.10.0 → 3.10.1

package/MIGRATION.md

@@ -77,9 +77,9 @@ docs/
 
 Версия npm-пакета и версия схемы настроек независимы: в eda 3.3 актуальным остаётся `docs/settings.yaml` с `version: 3`.
 
-Установщик по-прежнему сохраняет полный валидный v3 байт-в-байт — кроме случая, когда в файле остались устаревшие ключи: тогда он перезаписывает файл без вопросов и печатает, что именно убрал. Старый, неизвестный или неполный YAML нормализуется: известные валидные значения переносятся, а отсутствующие спрашиваются в TTY или получают defaults без TTY.
+Установщик по-прежнему сохраняет полный валидный v3 как есть — кроме двух случаев: если в файле остались устаревшие ключи или если текст файла отстал от шаблона пакета. Тогда он перезаписывает файл без вопросов, сохраняет значения и печатает, что сделал. Старый, неизвестный или неполный YAML нормализуется: известные валидные значения переносятся, а отсутствующие спрашиваются в TTY или получают defaults без TTY.
 
-В `eda update-all` режим `configure` один раз спрашивает общий профиль v3 и записывает его во все проекты. Режим `skip` сохраняет полный v3, индивидуально переносит остальные конфиги и создаёт defaults только при отсутствии файла.
+В `eda update-all` режим `configure` один раз спрашивает общий профиль v3 и записывает его во все проекты. Режим `skip` сохраняет актуальный полный v3, перерисовывает устаревший по шаблону, индивидуально переносит остальные конфиги и создаёт defaults только при отсутствии файла.
 
 ## Ревью и полировка
 

package/README.md

@@ -25,7 +25,7 @@ eda init
 
 `eda update` сначала переносит старые рабочие каталоги из `docs/<тип>/` в `docs/artifacts/<тип>/`, затем обновляет настройки, скилы и агентов. Содержимое файлов при переносе не меняется. Если один относительный путь уже существует в новой структуре, новый файл сохраняется, а старый удаляется.
 
-Полный валидный v3-конфиг сохраняется байт-в-байт. Старый, неизвестный или неполный файл разбирается как YAML: известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно записывается как v3. Без TTY используются перенесённые значения и defaults.
+Полный валидный v3-конфиг сохраняется, пока совпадает с актуальным шаблоном; если в пакете появились новые значения или подсказки, файл молча перерисовывается с сохранением ваших значений. Старый, неизвестный или неполный файл разбирается как YAML: известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно записывается как v3. Без TTY используются перенесённые значения и defaults.
 
 Если пакет уже стоит во многих проектах, можно обновить его одной командой:
 
@@ -33,7 +33,7 @@ eda init
 eda update-all ~/Code
 ```
 
-`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть установленный скил, агент или manifest `eda` для Claude/Codex. В каждом проекте команда переносит рабочие артефакты, затем предлагает настроить один общий профиль для всех проектов или выбрать `skip`. В режиме `skip` полный v3 сохраняется, старые и неполные конфиги индивидуально переносятся, отсутствующие создаются с defaults. Без TTY автоматически используется `skip`. Ошибка одного проекта не останавливает остальные.
+`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть установленный скил, агент или manifest `eda` для Claude/Codex. В каждом проекте команда переносит рабочие артефакты, затем предлагает настроить один общий профиль для всех проектов или выбрать `skip`. В режиме `skip` актуальный полный v3 сохраняется, устаревший по шаблону перерисовывается, старые и неполные конфиги индивидуально переносятся, отсутствующие создаются с defaults. Без TTY автоматически используется `skip`. Ошибка одного проекта не останавливает остальные.
 
 ---
 
@@ -414,9 +414,9 @@ discover-automations:
 
 Каждый скилл читает только свой раздел. Для `eda-review` прямое указание в текущем запросе может разово включить или отключить проверку и заменить её модель, например: «без performance, включи business, architecture на opus».
 
-Поддерживается только `version: 3`. Полный валидный v3 установщик сохраняет байт-в-байт. Старые, неизвестные и неполные файлы разбираются через YAML: валидные известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно нормализуется. Без TTY недостающие поля получают defaults. `plan.meta_review` переносится в `plan.review`, а `plan-polish.strict` удаляется.
+Поддерживается только `version: 3`. Полный валидный v3 установщик сохраняет как есть, пока его текст совпадает с шаблоном пакета; когда шаблон меняется — например, у настройки появляется новое допустимое значение, — файл перерисовывается без вопросов: ваши значения переносятся, посторонние ключи и ручные комментарии не сохраняются. Старые, неизвестные и неполные файлы разбираются через YAML: валидные известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно нормализуется. Без TTY недостающие поля получают defaults. `plan.meta_review` переносится в `plan.review`, а `plan-polish.strict` удаляется.
 
-`eda update-all configure` записывает один общий v3-профиль. `skip` сохраняет полный v3, индивидуально переносит остальные конфиги и создаёт defaults при отсутствии файла. Подробности перехода приведены в [MIGRATION.md](MIGRATION.md)
+`eda update-all configure` записывает один общий v3-профиль. `skip` сохраняет актуальный полный v3 и перерисовывает устаревший по шаблону, индивидуально переносит остальные конфиги и создаёт defaults при отсутствии файла. Подробности перехода приведены в [MIGRATION.md](MIGRATION.md)
 
 ---
 
@@ -526,7 +526,7 @@ eda update-all ~/Code
 | Агент | `.claude/agents/<agent>.md` | `.codex/agents/<agent>.toml` |
 | Manifest владения | `.claude/eda-manifest.json` | `.codex/eda-manifest.json` |
 
-`eda update` переносит известные старые каталоги артефактов, сохраняет полный v3-конфиг как есть, а старый или неполный умно переносит и целиком нормализует; затем идемпотентно синхронизирует обе группы компонентов и отдельно показывает реально изменившиеся скилы и агенты. Manifest хранит только идентификаторы компонентов, которыми владеет `eda`: retired-компоненты удаляются, а чужие скилы и агенты остаются нетронутыми. `eda update-all [dir]` выполняет тот же перенос артефактов в каждом проекте, затем либо записывает общий профиль, либо в `skip` сохраняет полный v3 и переносит остальные настройки. При миграции Codex установщик переносит актуальные скилы в `.agents/skills/` и удаляет принадлежащие `eda` старые копии `.codex/skills/<skill>/` и `.codex/skills/<skill>.md`, не затрагивая чужие компоненты.
+`eda update` переносит известные старые каталоги артефактов, сохраняет актуальный полный v3-конфиг как есть, устаревший по шаблону перерисовывает с сохранением значений, а старый или неполный умно переносит и целиком нормализует; затем идемпотентно синхронизирует обе группы компонентов и отдельно показывает реально изменившиеся скилы и агенты. Manifest хранит только идентификаторы компонентов, которыми владеет `eda`: retired-компоненты удаляются, а чужие скилы и агенты остаются нетронутыми. `eda update-all [dir]` выполняет тот же перенос артефактов в каждом проекте, затем либо записывает общий профиль, либо в `skip` сохраняет актуальный полный v3, перерисовывает устаревший по шаблону и переносит остальные настройки. При миграции Codex установщик переносит актуальные скилы в `.agents/skills/` и удаляет принадлежащие `eda` старые копии `.codex/skills/<skill>/` и `.codex/skills/<skill>.md`, не затрагивая чужие компоненты.
 
 Установленные копии не являются источником правды. Локальные изменения внутри `.claude/skills/eda-*`, `.agents/skills/eda-*`, `.claude/agents/eda-*` или `.codex/agents/eda-*` будут заменены следующим обновлением.
 

package/lib/install.js

@@ -607,21 +607,18 @@ export async function updateAll({
       const projectSettingsPath = path.join(projectDir, SETTINGS_RELATIVE_PATH);
       if (resolvedSettingsMode === 'skip' && await fileExists(projectSettingsPath)) {
         const existingContent = await fs.readFile(projectSettingsPath, 'utf8');
-        const migrated = migrateSettingsContent(existingContent);
-        if (
-          migrated.version === SETTINGS_VERSION
-          && migrated.missingKeys.size === 0
-          && migrated.retiredPaths.length === 0
-          && migrated.normalizedPaths.length === 0
-        ) {
+        const { migrated, needsMigration, rendered, formatChanged } = resolveSettingsUpdate(existingContent);
+        if (!needsMigration && migrated.retiredPaths.length === 0 && !formatChanged) {
           output.write(`Полный файл настроек сохранён: ${SETTINGS_RELATIVE_PATH}\n`);
         } else {
-          await writeSettingsContent(projectDir, formatSettings(migrated.settings));
+          await writeSettingsContent(projectDir, rendered);
           output.write(migrated.retiredPaths.length > 0
             ? `Из файла настроек убраны устаревшие ключи (${migrated.retiredPaths.join(', ')}): ${SETTINGS_RELATIVE_PATH}\n`
             : migrated.normalizedPaths.length > 0
               ? `Переименованы значения настроек (${migrated.normalizedPaths.join(', ')}): ${SETTINGS_RELATIVE_PATH}\n`
-              : `Старый или неполный файл настроек перенесён на version: ${SETTINGS_VERSION}: ${SETTINGS_RELATIVE_PATH}\n`);
+              : needsMigration
+                ? `Старый или неполный файл настроек перенесён на version: ${SETTINGS_VERSION}: ${SETTINGS_RELATIVE_PATH}\n`
+                : `Файл настроек обновлён до актуального формата, значения сохранены: ${SETTINGS_RELATIVE_PATH}\n`);
         }
       } else {
         await writeSettingsContent(projectDir, sharedSettingsContent);
@@ -1089,12 +1086,14 @@ async function ensureSettings(cwd, { input = process.stdin, output = process.std
     return;
   }
 
-  const migrated = migrateSettingsContent(existingContent);
-  const needsMigration = migrated.version !== SETTINGS_VERSION
-    || migrated.missingKeys.size > 0
-    || migrated.normalizedPaths.length > 0;
+  const { migrated, needsMigration, rendered, formatChanged } = resolveSettingsUpdate(existingContent);
   if (!needsMigration && migrated.retiredPaths.length === 0) {
-    output.write(`Настройки уже есть: ${SETTINGS_RELATIVE_PATH}\n`);
+    if (!formatChanged) {
+      output.write(`Настройки уже есть: ${SETTINGS_RELATIVE_PATH}\n`);
+      return;
+    }
+    await writeSettingsContent(cwd, rendered);
+    output.write(`Обновил ${SETTINGS_RELATIVE_PATH} до актуального формата: значения сохранены.\n`);
     return;
   }
 
@@ -1125,12 +1124,14 @@ async function configureSettings(cwd, { input = process.stdin, output = process.
     return;
   }
 
-  const migrated = migrateSettingsContent(existingContent);
-  const needsMigration = migrated.version !== SETTINGS_VERSION
-    || migrated.missingKeys.size > 0
-    || migrated.normalizedPaths.length > 0;
+  const { migrated, needsMigration, rendered, formatChanged } = resolveSettingsUpdate(existingContent);
   if (!needsMigration && migrated.retiredPaths.length === 0) {
-    output.write(`Настройки ${SETTINGS_RELATIVE_PATH} версии ${SETTINGS_VERSION} полные — вопросы не требуются.\n`);
+    if (!formatChanged) {
+      output.write(`Настройки ${SETTINGS_RELATIVE_PATH} версии ${SETTINGS_VERSION} полные — вопросы не требуются.\n`);
+      return;
+    }
+    await writeSettingsContent(cwd, rendered);
+    output.write(`Обновил ${SETTINGS_RELATIVE_PATH} до актуального формата: значения сохранены, вопросы не требуются.\n`);
     return;
   }
 
@@ -1150,6 +1151,17 @@ async function configureSettings(cwd, { input = process.stdin, output = process.
   output.write(`Переписан файл настроек: ${SETTINGS_RELATIVE_PATH} → version: ${SETTINGS_VERSION}.\n`);
 }
 
+// Конфиг несёт подсказки и списки допустимых значений, поэтому при обновлении пакета
+// его форма пересобирается заново: значения пользователя переносятся, текст догоняет актуальный.
+function resolveSettingsUpdate(existingContent) {
+  const migrated = migrateSettingsContent(existingContent);
+  const needsMigration = migrated.version !== SETTINGS_VERSION
+    || migrated.missingKeys.size > 0
+    || migrated.normalizedPaths.length > 0;
+  const rendered = formatSettings(migrated.settings);
+  return { migrated, needsMigration, rendered, formatChanged: rendered !== existingContent };
+}
+
 async function writeSettingsContent(cwd, content) {
   const settingsPath = path.join(cwd, SETTINGS_RELATIVE_PATH);
   await fs.mkdir(path.dirname(settingsPath), { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "3.10.0",
+  "version": "3.10.1",
   "description": "Пакет скилов и специализированных агентов eda-* для Claude Code и Codex CLI",
   "type": "module",
   "bin": {