@gian-tiaga/eda 0.5.0 → 0.5.2

package/README.md

@@ -19,7 +19,7 @@ npm install -g @gian-tiaga/eda
 eda init
 ```
 
-Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Если `docs/settings.yaml` ещё нет, установщик также предложит выбрать настройки скилов и создаст этот файл.
+Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Если `docs/settings.yaml` ещё нет, установщик также предложит выбрать настройки скилов и создаст этот файл. В конце `eda init` пишет, какие скилы реально установлены или изменились.
 
 ---
 
@@ -65,22 +65,29 @@ eda init
 version: 1
 
 defaults:
+  # Включает strict-режим по умолчанию для eda-explore, eda-plan и eda-review.
   # true | false
   strict: false
+  # Задаёт размер плана по умолчанию для eda-plan.
   # normal | short | ask_each_time
   plan_size: normal
+  # Определяет, как eda-explore и eda-plan принимают существенные решения.
   # autonomous | recommend_and_ask | ask_each_time
   decision_mode: recommend_and_ask
+  # Задаёт стратегию тестов по умолчанию для eda-plan.
   # after_each_phase | tdd_each_phase | end_of_plan | ask_each_time
   test_strategy: ask_each_time
+  # Задаёт стратегию логирования по умолчанию для eda-plan.
   # debug_precise | standard | ask_each_time
   logging_strategy: ask_each_time
 
 automate:
+  # Добавляет docs/plans/ в обычный запуск eda-automate.
   # true | false
   include_plans: false
 
 review:
+  # Добавляет в eda-review проверку качества кода и meta-reviewer quality-check.
   # true | false
   include_code_quality: true
 ```
@@ -130,7 +137,7 @@ automate может запускаться от review, fix-by-review или fix
 
 ```bash
 eda init      # выбрать Claude Code / Codex / обе среды и установить скилы
-eda update    # обновить скилы и создать docs/settings.yaml, если его ещё нет
+eda update    # обновить скилы, показать реально изменившиеся и создать docs/settings.yaml, если его ещё нет
 eda --version # показать версию установленного пакета
 eda --help    # справка
 ```
@@ -153,7 +160,7 @@ eda update           # синхронизировать скилы в текущ
 | **Claude Code** | `<project>/.claude/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
 | **Codex CLI** | `<project>/.codex/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
 
-`eda update` идемпотентно перезаписывает файлы в обеих папках. При обновлении старые файлы Codex-формата `<project>/.codex/skills/<skill>.md`, созданные версиями `eda` до этой структуры, удаляются. Если ты хочешь подправить скил локально — лучше копию сделай рядом, а не прямо в `.claude/skills/` или `.codex/skills/`, иначе при следующем `update` твои правки потеряются.
+`eda update` идемпотентно перезаписывает файлы в обеих папках и в конце пишет только те скилы, содержимое которых реально изменилось относительно установленной копии. При обновлении старые файлы Codex-формата `<project>/.codex/skills/<skill>.md`, созданные версиями `eda` до этой структуры, удаляются. Если ты хочешь подправить скил локально — лучше копию сделай рядом, а не прямо в `.claude/skills/` или `.codex/skills/`, иначе при следующем `update` твои правки потеряются.
 
 `AGENTS.md` (как и любые другие файлы в корне проекта) установщик **не трогает**. Если хочешь, чтобы Codex автоматически подгружал скилы, дай ему знать сам — например, одной строкой в `AGENTS.md`: «следуй инструкциям из `.codex/skills/`».
 

package/lib/install.js

@@ -108,7 +108,7 @@ export async function init({ cwd, input = process.stdin, output = process.stdout
     return;
   }
   await ensureSettings(cwd, { input, output });
-  await syncSkills(cwd, targets, output);
+  await syncSkills(cwd, targets, output, { action: 'install' });
 }
 
 export async function update({ cwd, input = process.stdin, output = process.stdout }) {
@@ -119,7 +119,7 @@ export async function update({ cwd, input = process.stdin, output = process.stdo
   }
   output.write(`Найдены установленные среды: ${targets.join(', ')}\n`);
   await ensureSettings(cwd, { input, output });
-  await syncSkills(cwd, targets, output);
+  await syncSkills(cwd, targets, output, { action: 'update' });
 }
 
 export async function askTargets({ input = process.stdin, output = process.stdout } = {}) {
@@ -211,17 +211,29 @@ async function detectTargets(cwd) {
   return targets;
 }
 
-async function syncSkills(cwd, targets, output = process.stdout) {
+async function syncSkills(cwd, targets, output = process.stdout, { action = 'update' } = {}) {
   const skills = await listSkills();
   if (skills.length === 0) {
     throw new Error(`В пакете нет скилов (искал в ${SKILLS_SRC}).`);
   }
   output.write(`Скилы для установки: ${skills.map(s => s.name).join(', ')}\n`);
 
-  if (targets.includes('claude')) await installToClaude(cwd, skills, output);
-  if (targets.includes('codex')) await installToCodex(cwd, skills, output);
+  const changedSkills = new Set();
+  if (targets.includes('claude')) {
+    const result = await installToClaude(cwd, skills, output);
+    for (const skillName of result.changedSkills) changedSkills.add(skillName);
+  }
+  if (targets.includes('codex')) {
+    const result = await installToCodex(cwd, skills, output);
+    for (const skillName of result.changedSkills) changedSkills.add(skillName);
+  }
   await removeRetiredSkills(cwd, targets);
 
+  const actionLabel = action === 'install' ? 'Установлено' : 'Обновлено';
+  const changedSkillNames = skills
+    .map(skill => skill.name)
+    .filter(skillName => changedSkills.has(skillName));
+  output.write(formatChangedSkills(actionLabel, changedSkillNames));
   output.write('\nГотово.\n');
 }
 
@@ -252,22 +264,29 @@ function formatSettings(settings) {
   return `version: 1
 
 defaults:
+  # Включает strict-режим по умолчанию для eda-explore, eda-plan и eda-review.
   # true | false
   strict: ${settings.strict ? 'true' : 'false'}
+  # Задаёт размер плана по умолчанию для eda-plan.
   # normal | short | ask_each_time
   plan_size: ${settings.planSize}
+  # Определяет, как eda-explore и eda-plan принимают существенные решения.
   # autonomous | recommend_and_ask | ask_each_time
   decision_mode: ${settings.decisionMode}
+  # Задаёт стратегию тестов по умолчанию для eda-plan.
   # after_each_phase | tdd_each_phase | end_of_plan | ask_each_time
   test_strategy: ${settings.testStrategy}
+  # Задаёт стратегию логирования по умолчанию для eda-plan.
   # debug_precise | standard | ask_each_time
   logging_strategy: ${settings.loggingStrategy}
 
 automate:
+  # Добавляет docs/plans/ в обычный запуск eda-automate.
   # true | false
   include_plans: ${settings.includePlans ? 'true' : 'false'}
 
 review:
+  # Добавляет в eda-review проверку качества кода и meta-reviewer quality-check.
   # true | false
   include_code_quality: ${settings.includeCodeQuality ? 'true' : 'false'}
 `;
@@ -276,26 +295,64 @@ review:
 async function installToClaude(cwd, skills, output = process.stdout) {
   const dst = path.join(cwd, '.claude/skills');
   await fs.mkdir(dst, { recursive: true });
+  const changedSkills = [];
   for (const skill of skills) {
     const skillDir = path.join(dst, skill.name);
     await fs.mkdir(skillDir, { recursive: true });
     const content = await fs.readFile(skill.path, 'utf-8');
-    await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
+    const changed = await writeSkillFile(path.join(skillDir, 'SKILL.md'), content);
+    if (changed) changedSkills.push(skill.name);
   }
-  output.write(`  ✓ Claude Code: ${dst}\n`);
+  output.write(`  ✓ Claude Code: ${dst} (изменилось ${formatSkillCount(changedSkills.length)})\n`);
+  return { changedSkills };
 }
 
 async function installToCodex(cwd, skills, output = process.stdout) {
   const dst = path.join(cwd, '.codex/skills');
   await fs.mkdir(dst, { recursive: true });
+  const changedSkills = [];
   for (const skill of skills) {
     const skillDir = path.join(dst, skill.name);
     await fs.mkdir(skillDir, { recursive: true });
     const content = await fs.readFile(skill.path, 'utf-8');
-    await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
+    const changed = await writeSkillFile(path.join(skillDir, 'SKILL.md'), content);
+    if (changed) changedSkills.push(skill.name);
     await removeObsoleteCodexFile(dst, skill.name);
   }
-  output.write(`  ✓ Codex CLI: ${dst}\n`);
+  output.write(`  ✓ Codex CLI: ${dst} (изменилось ${formatSkillCount(changedSkills.length)})\n`);
+  return { changedSkills };
+}
+
+async function writeSkillFile(filePath, content) {
+  const previousContent = await readFileIfExists(filePath);
+  await fs.writeFile(filePath, content);
+  return previousContent !== content;
+}
+
+async function readFileIfExists(filePath) {
+  try {
+    return await fs.readFile(filePath, 'utf-8');
+  } catch (err) {
+    if (err?.code !== 'ENOENT') throw err;
+    return null;
+  }
+}
+
+function formatChangedSkills(actionLabel, skillNames) {
+  if (skillNames.length === 0) return `${actionLabel} 0 скилов.\n`;
+  return `${actionLabel} ${formatSkillCount(skillNames.length)}: ${skillNames.join(', ')}.\n`;
+}
+
+function formatSkillCount(count) {
+  return `${count} ${pluralizeSkill(count)}`;
+}
+
+function pluralizeSkill(count) {
+  const mod10 = count % 10;
+  const mod100 = count % 100;
+  if (mod10 === 1 && mod100 !== 11) return 'скил';
+  if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return 'скила';
+  return 'скилов';
 }
 
 async function removeObsoleteCodexFile(dst, skillName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Набор скилов eda-* для Claude Code и Codex CLI: roadmap, explore, plan, execute, fix, review, fix-by-review, send-review, commit, docs, automate",
   "type": "module",
   "bin": {