@7n/rules 1.25.1 → 1.26.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.26.0] - 2026-07-19
+
+### Changed
+
+- Фаза 5a spec lang-plugins-extraction: ядро — двигун без мовної специфіки. npm/bun-гілка taze виїхала в плагін `@7n/rules-lang-js` (EcosystemProvider; бекап воркспейсів, `bunx taze -w -r latest` + `bun install`, collectTazeDiff, SKILL-фрагмент); semver-примітиви (parseVersion/isBreaking) тепер визначені в `@7n/rules/plugin-api` (було — реекспорт із diff.mjs). Оркестратор — чистий цикл провайдерів (без вбудованих гілок), звіт — рівноправні секції екосистем; CLI `n-rules taze diff` резолвиться через handler lang-js. Автодетект — кореневий package.json → lang-js
+
 ## [1.25.1] - 2026-07-19
 
 ### Fixed

package/bin/n-rules.js

@@ -1883,7 +1883,22 @@ try {
         // n-rules taze diff — read-only semver-diff package.json ↔ package.json.taze-bak
         // (root + воркспейси) для скілу n-taze: скрипт класифікує major-оновлення,
         // агент отримує готовий список замість ручного порівняння бекапів.
-        const { runTazeCli } = await import('../skills/taze/js/diff.mjs')
+        // Живе у плагіні @7n/rules-lang-js (фаза 5a spec lang-plugins-extraction) —
+        // резолвимо його taze-handler і беремо named-експорт runTazeCli.
+        const { getHandlers } = await import('../scripts/lib/resolve-plugins.mjs')
+        const { readNRulesConfigLite } = await import('../scripts/lib/read-n-rules-config-lite.mjs')
+        const config = await readNRulesConfigLite(cwd())
+        const handler = getHandlers(cwd(), config, 'taze').find(h => h.pluginName === '@7n/rules-lang-js')
+        if (!handler) {
+          console.error(
+            '❌ taze diff потребує плагін @7n/rules-lang-js (npm/bun-гілка) — запусти npx @7n/rules для авто-встановлення'
+          )
+          process.exitCode = 1
+          break
+        }
+        const { pathToFileURL } = await import('node:url')
+        // eslint-disable-next-line no-unsanitized/method
+        const { runTazeCli } = await import(pathToFileURL(handler.modulePath).href)
         process.exitCode = await runTazeCli(args)
 
         break

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.25.1",
+  "version": "1.26.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/scripts/lib/docs/plugin-api.md

@@ -3,9 +3,8 @@ type: JS Module
 title: plugin-api.mjs
 resource: npm/scripts/lib/plugin-api.mjs
 docgen:
-  crc: dc4f4a12
+  crc: c614a880
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min-retry
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/scripts/lib/docs/resolve-plugins.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-plugins.mjs
 resource: npm/scripts/lib/resolve-plugins.mjs
 docgen:
-  crc: 0d197e39
+  crc: fb58860d
 ---
 
 Резолв плагінів @7n/rules: визначає, які пакети-плагіни активні у проєкті, де їхні `rules/`-каталоги, які capabilities вони надають і які handlers надають.

package/scripts/lib/plugin-api.mjs

@@ -7,11 +7,40 @@
  * модуль-обробник експортує обʼєкт провайдера як `default`. Наступні порти
  * (doc-files, lint) додаються окремими фазами — не проєктуються наперед.
  *
- * Semver-утиліти ядра реекспортуються звідси, щоб плагіни класифікували
- * major/minor за тим самим правилом caret-семантики, що й ядро, без
- * дублювання коду і без імпорту внутрішніх шляхів `@7n/rules`.
+ * Semver-утиліти (caret-класифікація major/minor) живуть саме тут — єдине
+ * джерело правила для всіх мовних плагінів, без імпорту внутрішніх шляхів
+ * `@7n/rules` і без циклу plugin-api ↔ плагін.
  */
-export { isBreaking, parseVersion } from '../../skills/taze/js/diff.mjs'
+// Заякорено на початок (після можливих range-операторів `^~>=<`, пробілів, `v`),
+// щоб НЕ ловити версію всередині protocol-specifier-ів (`workspace:1.0.0`, `npm:x@1.2.3`).
+const SEMVER_RE = /^[\s~^>=<v]*(\d+)\.(\d+)\.(\d+)/
+
+/**
+ * Парсить semver-ядро зі specifier-а (ігнорує range-префікси `^`/`~`/`>=` тощо).
+ * @param {string} spec версійний specifier із package.json
+ * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver (`workspace:*`, git-url, `*`)
+ */
+export function parseVersion(spec) {
+  if (typeof spec !== 'string') return null
+  const m = SEMVER_RE.exec(spec)
+  if (!m) return null
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) }
+}
+
+/**
+ * Чи є перехід `from → to` breaking за caret-семантикою (змінилась найлівіша
+ * ненульова компонента).
+ * @param {{major:number,minor:number,patch:number}} from стара версія
+ * @param {{major:number,minor:number,patch:number}} to нова версія
+ * @returns {boolean} true — major/breaking
+ */
+export function isBreaking(from, to) {
+  if (from.major !== to.major) return true
+  if (from.major > 0) return false
+  if (from.minor !== to.minor) return true
+  if (from.minor > 0) return false
+  return from.patch !== to.patch
+}
 
 /** Версія контракту plugin-api: плагін декларує `requiresPluginApi`, несумісність → skip, не креш. */
 export const PLUGIN_API_VERSION = 1

package/scripts/lib/resolve-plugins.mjs

@@ -31,11 +31,12 @@ export const KNOWN_CI_PLUGINS = Object.freeze({
 /**
  * Відомі мовні плагіни: файловий сигнал екосистеми → npm-пакет. `maxDepth` —
  * до якої глибини шукати сигнал: python — лише корінь (uv-провайдер v1
- * обробляє тільки кореневий pyproject.toml); rust — до 3 рівнів, бо в
+ * обробляє тільки кореневий pyproject.toml; js — кореневий package.json); rust — до 3 рівнів, бо в
  * монорепо Cargo.toml часто вкладений (Tauri `app/src-tauri/Cargo.toml`),
  * а провайдер обробляє всі знайдені маніфести.
  */
 export const KNOWN_LANG_PLUGINS = Object.freeze({
+  js: { signal: 'package.json', pkg: '@7n/rules-lang-js', maxDepth: 0 },
   python: { signal: 'pyproject.toml', pkg: '@7n/rules-lang-python', maxDepth: 0 },
   rust: { signal: 'Cargo.toml', pkg: '@7n/rules-lang-rust', maxDepth: 3 }
 })

package/skills/taze/SKILL.md

@@ -1,144 +1,96 @@
 ---
 name: n-taze
 description: >-
-  Оновлення версій модулів проекту (bun/npm вбудовано; інші екосистеми — Rust,
+  Оновлення версій модулів проекту до останніх (усі екосистеми — JS/npm, Rust,
   Python тощо — через активні lang-плагіни) з аналізом major-змін і
   автоматичним рефакторингом несумісного коду
-version: '1.2'
+version: '2.0'
 ---
 
 # n-taze — Оновлення версій проекту
 
 ## Мета
 
-Оновити всі модулі проекту (npm/bun-залежності вбудовано; інші екосистеми — за активними lang-плагінами, їхні гілки описані у фрагментах наприкінці цього файлу) до останніх версій, виявити major-оновлення, перевірити сумісність змін з кодом проекту і за потреби зрефакторити несумісні місця.
+Оновити всі модулі проекту до останніх версій, виявити major-оновлення, перевірити сумісність змін з кодом проекту і за потреби зрефакторити несумісні місця. Кожна екосистема (JS/npm/bun, Rust/Cargo, Python/uv, …) — гілка відповідного lang-плагіна; конкретні команди гілок описані у фрагментах плагінів наприкінці цього файлу.
 
-## Оркестрація (npm/bun + екосистемні гілки плагінів) — не одним промптом
+## Оркестрація — не одним промптом
 
 `npx @7n/rules skill pi|cursor|codex taze` **не** передає цей файл одним суцільним
 промптом в один агентський хід — так робив старий дизайн, і саме тому реальний
 прогін міг зависати без жодної діагностики (один величезний непрозорий хід на
 весь монорепо, без проміжних зупинок для перевірки прогресу). Замість цього `npm/skills/taze/js/orchestrate.mjs`:
 
-1. Детерміновано, без LLM, виконує кроки 1-3 нижче: npm/bun вбудовано (бекап → `bunx taze -w -r latest` → `bun install` → `n-rules taze diff`), а кожну екосистемну гілку — через її EcosystemProvider (detect → backup → bump → diff; деталі команд — у фрагменті відповідного плагіна наприкінці файлу).
-2. Для кожного **окремого** major-запису з diff-у — один ізольований, обмежений виклик обраного раннера (кроки 4-6, лише для цього запису; промпт генерує `buildDependencyPrompt` ядра або `promptFor` провайдера, не цей SKILL.md).
+1. Детерміновано, без LLM, виконує кроки 1-3 нижче для кожної екосистемної гілки через її EcosystemProvider (detect → backup → bump → diff; конкретні команди — у фрагменті відповідного плагіна наприкінці файлу).
+2. Для кожного **окремого** major-запису з diff-у — один ізольований, обмежений виклик обраного раннера (кроки 4-6, лише для цього запису; промпт генерує `promptFor` провайдера, не цей SKILL.md).
 3. Детерміновано прибирає бекапи (крок 7) і компонує звіт (крок 8) з результатів усіх ітерацій.
 
-Не-npm екосистеми оркестратор веде через **EcosystemProvider-порт**
+Усі екосистеми оркестратор веде через **EcosystemProvider-порт**
 (`@7n/rules/plugin-api`, spec `docs/specs/2026-07-18-lang-plugins-extraction-spec.md`)
 — lang-плагіни доставляються автоматично при першому запуску за файловим
-сигналом (extension-point `taze`) і додають свої гілки як фрагменти цього
-SKILL.md (блок наприкінці файлу). На чисто-JS проєкті без таких сигналів у
-звіті немає навіть згадки про інші екосистеми. Якщо тулчейн гілки не
-встановлено — вона пропускається з причиною у звіті, не блокуючи інші.
+сигналом (extension-point `taze`; JS/npm — `@7n/rules-lang-js` за кореневим
+`package.json`) і додають свої гілки як фрагменти цього SKILL.md (блок
+наприкінці файлу). Ядро — двигун без мовної специфіки: без сигналу екосистеми
+у звіті немає навіть згадки про неї. Якщо тулчейн гілки не встановлено — вона
+пропускається з причиною у звіті, не блокуючи інші.
 
 Переваги: падіння/timeout на одному пакеті/крейті не втрачає прогрес по інших;
 кожен виклик успадковує власний timeout раннера (короткий, бо скоуп малий —
 один запис, не весь монорепо); видно прогрес по записах, а не чорну скриньку.
 
-Кроки 1-8 нижче лишаються джерелом правди щодо ЗМІСТУ роботи npm/bun-гілки
-(і скелетом для екосистемних) — оркестратор їх виконує програмно (1-3/7/8)
-або як промпт на один запис (4-6). Мовні відповідники кроків — у фрагментах
-плагінів наприкінці файлу.
+Кроки 1-8 нижче — **скелет** роботи будь-якої гілки (що означає кожен крок);
+конкретні команди кожної екосистеми — у фрагменті її плагіна. Оркестратор
+виконує кроки 1-3/7/8 програмно, 4-6 — як промпт на один запис.
 
 ## Передумови
 
-- Чисте робоче дерево (`git status` без незакомічених змін у `package.json` / `bun.lock` / `node_modules`) — інакше різницю не відрізнити від оновлення.
-- Встановлений `bun` і доступний `bunx`.
-- Запуск з кореня проекту (де лежить `package.json` / `bun.lock`).
-- Передумови екосистемних гілок (інструменти на кшталт cargo-edit чи uv) — у фрагментах плагінів наприкінці файлу; відсутній тулчейн не блокує інші гілки.
+- Чисте робоче дерево (`git status` без незакомічених змін у маніфестах/lock-файлах залежностей) — інакше різницю не відрізнити від оновлення.
+- Запуск з кореня проекту.
+- Передумови конкретних гілок (bun/bunx, cargo-edit, uv тощо) — у фрагментах плагінів наприкінці файлу; відсутній тулчейн не блокує інші гілки.
 
-## Workflow
+## Workflow (скелет — конкретика у фрагментах плагінів)
 
 ### 1. Зафіксувати стартовий стан
 
-Перед оновленням зберегти список поточних версій, щоб потім обчислити, які модулі стрибнули через major:
-
-```bash
-cp package.json package.json.taze-bak
-cp bun.lock bun.lock.taze-bak
-```
-
-(У monorepo — також усі `*/package.json` воркспейсів. Файли тимчасові, видалити в кінці.)
+Перед оновленням зберегти копії маніфестів залежностей (`<manifest>.taze-bak`) — щоб потім детерміновано обчислити, які модулі стрибнули через major. Файли тимчасові, видаляються в кінці.
 
 ### 2. Запустити оновлення
 
-```bash
-bunx taze -w -r latest
-bun install
-```
-
-- `-w` — записати нові версії у `package.json`.
-- `-r` — рекурсивно по всіх воркспейсах.
-- `latest` — піднімати навіть major.
+Командою екосистеми підняти всі залежності до останніх версій, **включно з major**, і синхронізувати lock-файл.
 
 ### 3. Виявити major-оновлення
 
-> **Не порівнюй `package.json` вручну.** Класифікацію semver несе CLI — детерміновано, по всіх воркспейсах.
-
-```bash
-n-rules taze diff
-```
+> **Не порівнюй маніфести вручну.** Класифікацію semver несе детермінований diff гілки (порівняння з `.taze-bak`-бекапом за caret-правилом: major = змінилась найлівіша ненульова компонента — `1.x→2.x`, `0.4.x→0.5.x`, `0.0.3→0.0.4`).
 
-Друкує компактний JSON: `{ "major": [{workspace, pkg, from, to}], "minorPatch": <N>, "totalChanged": <N> }`. `major` — список залежностей, у яких змінилась найлівіша ненульова компонента semver (`1.x→2.x`, `0.4.x→0.5.x`, `0.0.3→0.0.4`); саме він іде в кроки 4–6. `minorPatch` — лічба сумісних (для звіту в кроці 8).
-
-Покриває **прямі** залежності з `package.json` (root + воркспейси). Транзитивні major-стрибки (`bun.lock`) — за потреби переглянь окремо; основний ризик breaking-змін — у прямих.
+Major-записи йдуть у кроки 4–6; лічба сумісних (minor/patch) — у звіт кроку 8. Покриваються **прямі** залежності; транзитивні — за потреби окремо.
 
 ### 4. Зібрати breaking changes по кожному major-оновленню
 
-Для кожного модуля зі списку зібрати фактичні відмінності одним з джерел (у порядку пріоритету):
-
-1. **CHANGELOG / Releases репозиторію модуля** — найшвидше і найточніше. Адресу репозиторію взяти з `package.json` модуля у `node_modules/<name>/package.json` (поле `repository`). Дістати релізи між старою і новою версією.
-2. **Git-різниця в `node_modules/<name>`** — якщо CHANGELOG відсутній або неінформативний, порівняти попередню версію (з кешу bun: `~/.bun/install/cache/<name>@<old-version>/`) з новою (`node_modules/<name>/`) через `diff -r` по `dist/` / `*.d.ts` / публічних entry-points з `exports`.
-3. **Якщо немає кешованої старої версії** — встановити її окремо в тимчасову теку (`mkdir -p /tmp/taze-old && cd /tmp/taze-old && bun add <name>@<old-version>`) і порівняти.
-
-Цікавлять: видалені/перейменовані експорти, змінені сигнатури функцій, змінені типи, змінена поведінка за замовчуванням, видалені CLI-прапорці.
+Для кожного запису зі списку зібрати фактичні відмінності: CHANGELOG/Releases репозиторію пакета (джерело адреси — у фрагменті гілки), а без них — diff публічного API між кешованою старою версією і новою. Цікавлять: видалені/перейменовані експорти, змінені сигнатури, змінені типи, змінена поведінка за замовчуванням, видалені CLI-прапорці.
 
 ### 5. Перевірити сумісність з кодом проекту
 
-Для кожного breaking change знайти його використання в коді проекту:
-
-```bash
-rg -n "<імпорт|функція|опція>" --type ts --type js --type vue
-```
-
-Класифікувати:
-
-- **сумісно** — проект не використовує зачеплене API → нічого не робити.
-- **несумісно** — використання знайдено → перейти до п. 6.
+Для кожного breaking change знайти використання зачепленого API в коді (`rg -n` по мові гілки). Класифікувати: **сумісно** — не використовується → нічого не робити; **несумісно** — перейти до п. 6.
 
 ### 6. Рефакторинг несумісних місць
 
-Для кожного несумісного місця — застосувати міграцію згідно з changelog модуля (перейменувати імпорт, оновити сигнатуру виклику, замінити видалену опцію еквівалентом тощо). Після правок:
-
-```bash
-npx @7n/rules lint
-bun run typecheck   # якщо є
-bun test            # якщо є
-```
+Застосувати міграцію згідно з changelog пакета (перейменувати імпорт, оновити сигнатуру виклику, замінити видалену опцію еквівалентом тощо). Після правок — прогнати перевірки гілки (лінт/typecheck/тести — конкретні команди у фрагменті). Нетривіальна або неоднозначна міграція — **не вгадувати**: TODO у коді з посиланням на CHANGELOG і запис у звіт як ручна дія.
 
 ### 7. Прибрати тимчасові файли
 
-```bash
-rm package.json.taze-bak bun.lock.taze-bak
-```
-
-(І решту бекапів воркспейсів, якщо створювались.)
+Видалити всі `.taze-bak`-бекапи, створені на кроці 1.
 
 ### 8. Звіт користувачу
 
-Коротко в одному повідомленні:
+Для кожної обробленої гілки — окрема секція:
 
-- **Оновлено (minor/patch):** кількість пакетів (`minorPatch` із кроку 3), без деталей.
+- **Оновлено (minor/patch):** кількість пакетів, без деталей.
 - **Major-оновлення:** список `<name>: <old> → <new>` з посиланням на release notes.
 - **Зрефакторено автоматично:** список файлів і коротко що саме змінено.
 - **Потребує ручного втручання:** список TODO з причиною (нетривіальна міграція / неоднозначність / падіння тестів).
-- **Стан перевірок:** `lint` / `typecheck` / `test` — pass/fail з номером рядка, де впало.
-
-Для кожної обробленої екосистемної гілки — окрема секція з тим самим переліком (оновлено / major / зрефакторено / потребує ручного втручання) і власними перевірками (див. фрагменти плагінів наприкінці файлу).
+- **Стан перевірок:** перевірки гілки — pass/fail з номером рядка, де впало.
 
 ## Примітка
 
 - Не запускати `npx @7n/rules lint` паралельно з іншими ESLint-задачами — діє правило з кореневого `CLAUDE.md`.
 - Якщо проект — `npm/` пакет цього репо, після змін у `package.json` / коді треба підняти `version` і додати запис у `CHANGELOG.md` згідно з `npm/CLAUDE.md`.
-- При великій кількості major-оновлень розбити PR по одному модулю на коміт — щоб `git bisect` залишався корисним. Це стосується і пакетів екосистемних гілок окремо від npm-пакетів.
+- При великій кількості major-оновлень розбити PR по одному модулю на коміт — щоб `git bisect` залишався корисним. Це стосується пакетів кожної гілки окремо.

package/skills/taze/js/docs/orchestrate.md

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/skills/taze/js/orchestrate.mjs
 docgen:
-  crc: 6a269363
+  crc: df10e67a
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98
@@ -12,30 +12,27 @@ docgen:
 
 ## Огляд
 
-Оркеструє taze детерміновано, без LLM для службових кроків: бекап маніфестів → масовий bump → diff-класифікація major vs minor/patch → прибирання бекапів → Markdown-звіт. Для КОЖНОГО окремого major-пакета з diff-у виконує один ізольований, обмежений виклик обраного раннера — лише перевірка сумісності й рефакторинг, не сам bump. npm/bun-гілка вбудована; решта екосистем — `EcosystemProvider`-и (контракт `@7n/rules/plugin-api`), завантажені з плагінів (`@7n/rules-lang-rust`, `@7n/rules-lang-python`, …; extension-point `taze`) — вбудованих провайдерів немає. Файл виконує реальні файлові операції (бекапи) і запускає зовнішні команди (`bunx`, `bun`, `git`, команди провайдерів) — не read-only.
+Оркеструє taze як чистий цикл по EcosystemProvider-ах (фаза 5a spec lang-plugins-extraction: ядро — двигун без мовної специфіки). ВСІ екосистеми, включно з npm/bun (`@7n/rules-lang-js`), приходять з плагінів (extension-point `taze`): для кожного провайдера — detect → available → backup → bump → diff, далі по одному ізольованому виклику раннера на кожен major-запис (`promptFor` провайдера), потім cleanup і композиція Markdown-звіту. Виконує файлові операції і запускає зовнішні команди (git, npx для worktree-бутстрапу, команди провайдерів) — не read-only.
 
 ## Поведінка
 
-- **buildDependencyPrompt** — формує промпт ОДНОГО ітеративного виклику (лише перевірка сумісності й рефакторинг) для одного major-пакета npm/bun.
 - **callRunner** — диспетчер одного ітеративного виклику: `pi` — вбудований pi-агент (текст через `deps.out`), `cursor`/`codex` — napi-міст ACP (`@7n/llm-lib/acp`).
-- **backupWorkspacePackageFiles** / **cleanupBackups** — бекап і прибирання `package.json` кожного воркспейсу.
 - **loadPluginTazeProviders** — завантажує провайдерів з активних плагінів: `.n-rules.json`/автодетект → `resolvePlugins` (плагін доставляється автоматично при першому запуску) → handler-модулі extension-point `taze` → валідація `assertEcosystemProvider`; битий плагін — warning і пропуск, не провал.
-- **formatReport** — компонує підсумковий Markdown-звіт (npm-гілка + секція на кожну екосистему з manifests; екосистема без manifests — тиша) без окремого LLM-виклику.
-- **runTazeOrchestrator** — повний прогін: перевіряє, що `cwd` — ізольований worktree, виконує npm-гілку, далі кожного провайдера наскрізь (detect → available → backup → bump → diff → ізольовані виклики раннера по major-записах → cleanup) і повертає звіт.
+- **formatReport** — Markdown-звіт: рівноправна секція на кожну екосистему з manifests (без manifests — тиша) + загальний підсумок; без окремого LLM-виклику.
+- **runTazeOrchestrator** — повний прогін: гарантує ізольований worktree (авто-створює `<branch>-taze` через `npx @7n/mt worktree create`, після завершення переносить зміни назад і прибирає авто-створене дерево), проганяє кожного провайдера наскрізь і повертає `{ ok, report, ecosystems }`. Без жодного taze-провайдера — попередження (для npm/bun-гілки потрібен `@7n/rules-lang-js`).
+- **bringChangesBackToOriginal** / **removeAutoCreatedWorktree** — перенесення незакомічених змін з авто-створеного worktree у вихідне дерево і його прибирання.
 
 ## Публічний API
 
-- buildDependencyPrompt — промпт одного npm-major-запису.
 - callRunner — виклик обраного раннера (`pi`/`cursor`/`codex`) з одним промптом.
-- backupWorkspacePackageFiles / cleanupBackups — бекап/прибирання `package.json` воркспейсів.
 - loadPluginTazeProviders — валідні EcosystemProvider-и з handler-модулів плагінів.
-- formatReport — фінальний Markdown-звіт із npm-результатів і записів екосистем.
+- formatReport — фінальний Markdown-звіт із записів екосистем.
 - runTazeOrchestrator — повна оркестрація taze; `deps.ecosystemProviders` повністю замінює список провайдерів (для тестів).
+- bringChangesBackToOriginal / removeAutoCreatedWorktree — життєвий цикл авто-створеного worktree.
 
 ## Гарантії поведінки
 
-- Виконує файлові операції (копіювання/видалення бекапів) і запускає зовнішні команди — НЕ read-only.
-- Перед будь-якою мутацією перевіряє, що `cwd` — ізольований worktree (`assertRunningInWorktree`), інакше кидає виняток.
-- npm/bun-гілка активна лише за кореневим package.json: на чисто-Python/Rust репо вона тихо пропускається (лог + без npm-рядків у звіті), а не валить прогін через `bun install → exit 1`.
+- Виконує файлові операції і запускає зовнішні команди — НЕ read-only.
+- Кроки оркестрації виконуються лише в ізольованому worktree; авто-створене дерево прибирається у `finally` навіть при винятку, зміни переносяться назад.
 - Виняток усередині одного провайдера (bump/diff/команда) не зупиняє інших — фіксується в `error` запису екосистеми й у звіті; `ok` результату тоді false.
 - Падіння одного пакета в ізольованому виклику раннера не втрачає прогрес по інших записах.

package/skills/taze/js/orchestrate.mjs

@@ -1,8 +1,5 @@
 /** @see ./docs/orchestrate.md */
 import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { copyFile, rm } from 'node:fs/promises'
-import { join } from 'node:path'
 import { pathToFileURL } from 'node:url'
 
 import {
@@ -13,38 +10,9 @@ import {
 import { assertEcosystemProvider } from '../../../scripts/lib/plugin-api.mjs'
 import { readNRulesConfigLite } from '../../../scripts/lib/read-n-rules-config-lite.mjs'
 import { getHandlers, resolvePlugins } from '../../../scripts/lib/resolve-plugins.mjs'
-import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
-import { collectTazeDiff } from './diff.mjs'
 
 export { bringChangesBackToOriginal, removeAutoCreatedWorktree } from '../../../scripts/lib/auto-worktree.mjs'
 
-/** Суфікс бекапу package.json — той самий, що й у `diff.mjs`/кроці 1 SKILL.md. */
-const BACKUP_SUFFIX = '.taze-bak'
-
-/**
- * Промпт ОДНОГО ітеративного виклику — лише кроки 4-6 SKILL.md (breaking
- * changes → сумісність коду → рефакторинг) для ОДНОГО major-пакета. Кроки
- * 1-3/7/8 виконує оркестратор детерміновано, без LLM.
- * @param {{workspace: string, pkg: string, from: string, to: string}} entry запис major-diff (з `collectTazeDiff`)
- * @returns {string} готовий промпт
- */
-export function buildDependencyPrompt({ workspace, pkg, from, to }) {
-  return [
-    '# Major-оновлення одного пакета: перевірка сумісності й рефакторинг',
-    '',
-    `Пакет \`${pkg}\` у воркспейсі \`${workspace}\`: **${from} → ${to}** — вже застосовано в package.json/bun.lock (кроки 1-3 виконано детерміновано, без тебе). Твоя задача — лише breaking-changes-перевірка й, за потреби, рефакторинг.`,
-    '',
-    '## Кроки',
-    `1. Зібрати breaking changes цього оновлення: CHANGELOG/Releases репозиторію модуля (поле \`repository\` у \`node_modules/${pkg}/package.json\`), або git/diff між закешованою старою версією (\`~/.bun/install/cache/${pkg}@<стара-версія>/\`) і новою (\`node_modules/${pkg}/\`).`,
-    `2. Знайти використання зачепленого API в коді проєкту (\`rg -n\` по імпортах/викликах \`${pkg}\`).`,
-    '3. Сумісно — нічого не робити. Несумісно — застосувати міграцію (перейменувати імпорт, оновити сигнатуру виклику, замінити видалену опцію еквівалентом).',
-    '4. Якщо були правки — запусти `npx @7n/rules lint`, typecheck/test якщо є в проєкті.',
-    '5. Нетривіальна/неоднозначна міграція — не вгадуй, залиш TODO-коментар із посиланням на CHANGELOG.',
-    '',
-    'У відповіді одним абзацом підсумуй: сумісно / зрефакторено (які файли) / TODO (чому).'
-  ].join('\n')
-}
-
 /**
  * Диспетчер одного ітеративного виклику на обраний раннер. `pi` — вбудований
  * pi-агент (`@7n/llm-lib/agent-skill`; текст перехоплюється через `deps.out`,
@@ -87,58 +55,6 @@ export async function callRunner(runner, prompt, cwd, deps = {}) {
   }
 }
 
-/**
- * Синхронно виконує детерміновану команду (bunx/bun), кидає з
- * exit-кодом+stderr при провалі.
- * @param {string} cmd бінарник
- * @param {string[]} args аргументи
- * @param {string} cwd робочий каталог
- * @param {typeof spawnSync} spawnFn інжект для тестів
- * @returns {string} stdout
- */
-function runCommand(cmd, args, cwd, spawnFn) {
-  const result = spawnFn(cmd, args, { cwd, encoding: 'utf8' })
-  if (result.status !== 0) {
-    throw new Error(`${cmd} ${args.join(' ')} → exit ${result.status}: ${result.stderr || result.stdout}`)
-  }
-  return result.stdout
-}
-
-/**
- * Бекапить package.json кожного воркспейсу (крок 1 SKILL.md) — потрібно для
- * класифікації major/minor через `collectTazeDiff` після bump-у.
- * @param {string} cwd корінь репо
- * @param {{ getMonorepoPackageRootDirs?: (cwd: string) => Promise<string[]>, copyFile?: (src: string, dest: string) => Promise<void> }} [deps] інжекти
- * @returns {Promise<string[]>} відносні шляхи воркспейсів, що мали package.json
- */
-export async function backupWorkspacePackageFiles(cwd, deps = {}) {
-  const getRoots = deps.getMonorepoPackageRootDirs ?? getMonorepoPackageRootDirs
-  const copy = deps.copyFile ?? copyFile
-  const roots = await getRoots(cwd)
-  const backedUp = []
-  for (const ws of roots) {
-    const pkgPath = join(cwd, ws, 'package.json')
-    if (!existsSync(pkgPath)) continue
-    await copy(pkgPath, `${pkgPath}${BACKUP_SUFFIX}`)
-    backedUp.push(ws)
-  }
-  return backedUp
-}
-
-/**
- * Прибирає бекапи package.json після завершення (крок 7 SKILL.md).
- * @param {string} cwd корінь репо
- * @param {string[]} workspaces воркспейси з бекапом (з `backupWorkspacePackageFiles`)
- * @param {{ rm?: (path: string, opts?: object) => Promise<void> }} [deps] інжект
- * @returns {Promise<void>}
- */
-export async function cleanupBackups(cwd, workspaces, deps = {}) {
-  const remove = deps.rm ?? rm
-  for (const ws of workspaces) {
-    await remove(join(cwd, ws, `package.json${BACKUP_SUFFIX}`), { force: true })
-  }
-}
-
 /**
  * Завантажує EcosystemProvider-и з активних плагінів проєкту: `.n-rules.json`
  * (або автодетект за файловими сигналами — `pyproject.toml` → lang-python) →
@@ -265,50 +181,39 @@ function appendEcosystemSection(lines, eco) {
 
 /**
  * Компонує підсумковий звіт (крок 8 SKILL.md) детерміновано з результатів
- * ітерацій — без окремого LLM-виклику для самого звіту.
- * @param {{
- *   minorPatch: number,
- *   totalChanged: number,
- *   results: Array<{pkg:string, workspace:string, from:string, to:string, ok:boolean, error:string|null}>,
- *   ecosystems?: Array<object>,
- *   npmPresent?: boolean
- * }} args дані звіту (`ecosystems` — записи з `runEcosystem`, по одному на провайдера;
- *   `npmPresent: false` — репо без кореневого package.json, npm-рядки не друкуються)
+ * ітерацій — без окремого LLM-виклику для самого звіту. Усі екосистеми
+ * (включно з npm/bun — плагін `@7n/rules-lang-js`, фаза 5a) — рівноправні
+ * секції; екосистема без manifests — тиша.
+ * @param {{ ecosystems?: Array<object> }} args записи з `runEcosystem`, по одному на провайдера
  * @returns {string} markdown-звіт
  */
-export function formatReport({ minorPatch, totalChanged, results, ecosystems = [], npmPresent = true }) {
-  const lines = ['## taze: підсумок', '']
-  if (npmPresent) {
-    lines.push(`- **Оновлено (minor/patch):** ${minorPatch}`, `- **Major-оновлення:** ${results.length}`)
-    for (const r of results) {
-      lines.push(formatResultLine(r, r.workspace))
-    }
-  }
+export function formatReport({ ecosystems = [] }) {
+  const lines = ['## taze: підсумок']
 
-  let ecosystemsTotal = 0
+  let total = 0
   for (const eco of ecosystems) {
-    ecosystemsTotal += appendEcosystemSection(lines, eco)
+    total += appendEcosystemSection(lines, eco)
   }
 
-  lines.push('', `- **Всього змінено:** ${totalChanged + ecosystemsTotal}`)
+  lines.push('', `- **Всього змінено:** ${total}`)
   return lines.join('\n')
 }
 
 /**
- * Оркеструє taze: детерміновані кроки (бекап → масовий bump → diff →
- * прибирання → звіт) без LLM, і по одному ізольованому, обмеженому по
- * обсягу виклику `callRunner` на кожен major-пакет (кроки 4-6 SKILL.md) —
- * замість одного величезного непрозорого ходу на весь монорепо. npm/bun-гілка
- * вбудована; решта екосистем — EcosystemProvider-и, завантажені з плагінів
- * (`@7n/rules-lang-*`, extension-point `taze`; фаза 2 spec — Rust теж плагін).
- * Падіння одного пакета/однієї екосистеми не втрачає прогрес по інших.
+ * Оркеструє taze: чистий цикл по EcosystemProvider-ах (кроки 1-3/7/8 —
+ * детерміновано в провайдері, кроки 4-6 — по одному ізольованому виклику
+ * `callRunner` на кожен major-запис) замість одного величезного непрозорого
+ * ходу на весь монорепо. Ядро — двигун без мовної специфіки (фаза 5a spec):
+ * ВСІ екосистеми, включно з npm/bun (`@7n/rules-lang-js`), приходять з
+ * плагінів (extension-point `taze`). Падіння одного пакета/однієї екосистеми
+ * не втрачає прогрес по інших.
  * @param {{
  *   cwd?: string,
  *   runner?: 'pi' | 'cursor' | 'codex',
  *   log?: (line: string) => void,
- *   deps?: { spawnFn?: typeof spawnSync, collectTazeDiff?: (cwd: string) => Promise<object>, callRunner?: (runner: string, prompt: string, cwd: string, deps: object) => Promise<{ok: boolean, text: string, error: string|null}>, ecosystemProviders?: object[] } & Record<string, unknown>
+ *   deps?: { spawnFn?: typeof spawnSync, callRunner?: (runner: string, prompt: string, cwd: string, deps: object) => Promise<{ok: boolean, text: string, error: string|null}>, ecosystemProviders?: object[] } & Record<string, unknown>
  * }} [options] опції + інжекти для тестів (`deps.ecosystemProviders` повністю замінює список провайдерів)
- * @returns {Promise<{ ok: boolean, report: string, results: Array<object>, ecosystems: Array<object> }>} результат
+ * @returns {Promise<{ ok: boolean, report: string, ecosystems: Array<object> }>} результат
  */
 export async function runTazeOrchestrator(options = {}) {
   const runner = options.runner ?? 'pi'
@@ -325,55 +230,22 @@ export async function runTazeOrchestrator(options = {}) {
   const cwd = worktree.cwd
 
   try {
-    // npm/bun-гілка активна лише за кореневим package.json — на чисто-Python/Rust
-    // репо `bun install` падає з exit 1, і без цього гейта весь прогін гинув би
-    // до екосистемних провайдерів. Той самий принцип «тиші», що й для мовних
-    // екосистем: немає сигналу — немає ані кроків, ані згадки у звіті.
-    const npmPresent = existsSync(join(cwd, 'package.json'))
-    let diff = { major: [], minorPatch: 0, totalChanged: 0 }
-    const results = []
-    if (npmPresent) {
-      log('📦 Бекап package.json...')
-      const backedUpWorkspaces = await backupWorkspacePackageFiles(cwd, deps)
-
-      log('⬆️  bunx taze -w -r latest...')
-      runCommand('bunx', ['taze', '-w', '-r', 'latest'], cwd, spawnFn)
-      log('📥 bun install...')
-      runCommand('bun', ['install'], cwd, spawnFn)
-
-      const collectDiff = deps.collectTazeDiff ?? collectTazeDiff
-      diff = await collectDiff(cwd)
-      log(`🔍 diff: ${diff.major.length} major, ${diff.minorPatch} minor/patch`)
-
-      for (const entry of diff.major) {
-        log(`🔧 ${entry.pkg} (${entry.workspace}): ${entry.from} → ${entry.to}...`)
-        const outcome = await call(runner, buildDependencyPrompt(entry), cwd, deps)
-        results.push({ ...entry, ...outcome })
-        log(outcome.ok ? `  ✅ ${entry.pkg}` : `  ❌ ${entry.pkg}: ${outcome.error}`)
-      }
-
-      await cleanupBackups(cwd, backedUpWorkspaces, deps)
-    } else {
-      log('⏭ npm/bun: кореневого package.json немає — гілка пропущена')
-    }
-
     const providers = deps.ecosystemProviders ?? (await loadPluginTazeProviders(cwd, log, deps))
+    if (providers.length === 0) {
+      log(
+        '⏭ Жодного taze-провайдера: жоден активний плагін не надає extension-point `taze` (для npm/bun-гілки потрібен @7n/rules-lang-js)'
+      )
+    }
     const ecosystems = []
     for (const provider of providers) {
       ecosystems.push(await runEcosystem(provider, { cwd, runner, log, deps, spawnFn, call }))
     }
 
-    const report = formatReport({
-      minorPatch: diff.minorPatch,
-      totalChanged: diff.totalChanged,
-      results,
-      ecosystems,
-      npmPresent
-    })
+    const report = formatReport({ ecosystems })
     log(report)
 
     const ecosystemsOk = ecosystems.every(eco => eco.error === null && eco.results.every(r => r.ok))
-    return { ok: results.every(r => r.ok) && ecosystemsOk, report, results, ecosystems }
+    return { ok: ecosystemsOk, report, ecosystems }
   } finally {
     // Лише для АВТОстворених worktree — якщо викликач уже сидів у своєму
     // worktree (worktree.autoCreated === false), це не наш worktree і не

package/skills/taze/js/diff.mjs

@@ -1,140 +0,0 @@
-/** @see ./docs/diff.md */
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
-
-/** Поля package.json із залежностями, які порівнюємо. */
-const DEP_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']
-
-/** Дефолтний суфікс бекапу, який створює крок 1 скіла (`cp package.json package.json.taze-bak`). */
-const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
-
-// Заякорено на початок (після можливих range-операторів `^~>=<`, пробілів, `v`),
-// щоб НЕ ловити версію всередині protocol-specifier-ів (`workspace:1.0.0`, `npm:x@1.2.3`).
-const SEMVER_RE = /^[\s~^>=<v]*(\d+)\.(\d+)\.(\d+)/
-
-/**
- * Парсить semver-ядро зі specifier-а (ігнорує range-префікси `^`/`~`/`>=` тощо).
- * @param {string} spec версійний specifier із package.json
- * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver (`workspace:*`, git-url, `*`)
- */
-export function parseVersion(spec) {
-  if (typeof spec !== 'string') return null
-  const m = SEMVER_RE.exec(spec)
-  if (!m) return null
-  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) }
-}
-
-/**
- * Чи є перехід `from → to` breaking за caret-семантикою (змінилась найлівіша
- * ненульова компонента).
- * @param {{major:number,minor:number,patch:number}} from стара версія
- * @param {{major:number,minor:number,patch:number}} to нова версія
- * @returns {boolean} true — major/breaking
- */
-export function isBreaking(from, to) {
-  if (from.major !== to.major) return true
-  if (from.major > 0) return false
-  if (from.minor !== to.minor) return true
-  if (from.minor > 0) return false
-  return from.patch !== to.patch
-}
-
-/**
- * Порівнює два package.json-обʼєкти й повертає зміни залежностей.
- * @param {object} oldPkg розпарсений старий package.json (бекап)
- * @param {object} newPkg розпарсений новий package.json
- * @param {string} workspace мітка воркспейсу (`.` для кореня)
- * @returns {{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
- */
-export function diffPackageJson(oldPkg, newPkg, workspace) {
-  const major = []
-  let minorPatch = 0
-  for (const field of DEP_FIELDS) {
-    const oldDeps = oldPkg?.[field]
-    const newDeps = newPkg?.[field]
-    if (!oldDeps || !newDeps) continue
-    for (const [pkg, from] of Object.entries(oldDeps)) {
-      const to = newDeps[pkg]
-      if (to === undefined || to === from) continue
-      const fromV = parseVersion(from)
-      const toV = parseVersion(to)
-      if (fromV && toV && isBreaking(fromV, toV)) {
-        major.push({ workspace, pkg, from, to })
-      } else {
-        minorPatch += 1
-      }
-    }
-  }
-  return { major, minorPatch }
-}
-
-/**
- * Читає JSON-файл або повертає null, якщо файл відсутній / невалідний.
- * @param {string} path абсолютний шлях
- * @returns {Promise<object|null>} розпарсений обʼєкт або null
- */
-async function readJsonOrNull(path) {
-  if (!existsSync(path)) return null
-  try {
-    return JSON.parse(await readFile(path, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/**
- * Збирає diff по всьому монорепо: для кожного воркспейсу порівнює
- * `<ws>/package.json` з `<ws>/package.json<backupSuffix>`.
- * @param {string} cwd корінь репозиторію
- * @param {string} [backupSuffix] суфікс бекап-файлу
- * @returns {Promise<{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number, totalChanged:number, comparedWorkspaces:number}>} агрегований diff
- */
-export async function collectTazeDiff(cwd, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
-  const roots = await getMonorepoPackageRootDirs(cwd)
-  const major = []
-  let minorPatch = 0
-  let comparedWorkspaces = 0
-  for (const ws of roots) {
-    const dir = join(cwd, ws)
-    const oldPkg = await readJsonOrNull(join(dir, `package.json${backupSuffix}`))
-    const newPkg = await readJsonOrNull(join(dir, 'package.json'))
-    if (!oldPkg || !newPkg) continue
-    comparedWorkspaces += 1
-    const res = diffPackageJson(oldPkg, newPkg, ws)
-    major.push(...res.major)
-    minorPatch += res.minorPatch
-  }
-  return { major, minorPatch, totalChanged: major.length + minorPatch, comparedWorkspaces }
-}
-
-const USAGE = 'Usage: n-rules taze diff [--backup-suffix <suffix>]'
-
-/**
- * CLI: `n-rules taze diff` друкує компактний JSON зі списком major-оновлень і
- * лічбою minor/patch. Read-only.
- * @param {string[]} args аргументи після `taze`
- * @param {string} [cwd] корінь репозиторію (ін'єкція для тестів)
- * @returns {Promise<number>} exit code
- */
-export async function runTazeCli(args, cwd = process.cwd()) {
-  if (args[0] !== 'diff') {
-    console.error(USAGE)
-    return 1
-  }
-  const flagAt = args.indexOf('--backup-suffix')
-  const backupSuffix = flagAt === -1 ? DEFAULT_BACKUP_SUFFIX : args[flagAt + 1]
-  if (!backupSuffix) {
-    console.error(USAGE)
-    return 1
-  }
-  const diff = await collectTazeDiff(cwd, backupSuffix)
-  if (diff.comparedWorkspaces === 0) {
-    console.error(`✗ Не знайдено жодного package.json${backupSuffix} — спершу зроби бекап (крок 1 скіла).`)
-    return 1
-  }
-  process.stdout.write(`${JSON.stringify(diff)}\n`)
-  return 0
-}

package/skills/taze/js/docs/diff.md

@@ -1,55 +0,0 @@
----
-type: JS Module
-title: diff.mjs
-resource: npm/skills/taze/js/diff.mjs
-docgen:
-  crc: a70297a7
-  score: 100
----
-
-parseVersion
-Парсить версію з specifier.
-
-isBreaking
-Перевіряє перехід версій згідно з caret-семантикою.
-
-diffPackageJson
-Порівнює об'єкти package.json і повертає зміни залежностей.
-
-collectTazeDiff
-Збирає diff по всьому монорепо порівнюючи бекап та новий файл.
-
-runTazeCli
-Друкує результат diff у форматі JSON.
-
-## Поведінка
-
-parseVersion
-Парсить версію з specifier
-
-isBreaking
-Перевіряє перехід версій згідно з caret-семантикою
-
-diffPackageJson
-Порівнює об'єкти package.json і повертає зміни залежностей
-
-collectTazeDiff
-Збирає diff по всьому монорепо порівнюючи бекап та новий файл
-
-runTazeCli
-Друкує результат diff у форматі JSON
-
-## Публічний API
-
-parseVersion — витягує версію з specifier-а, ігноруючи range-префікси.
-isBreaking — визначає, чи є перехід між версіями breaking за caret-семантикою (зміна найлівішої ненульової частини).
-diffPackageJson — порівнює два package.json-об'єкти та генерує список змін залежностей.
-collectTazeDiff — збирає різницю між версіями всього монорепо, порівнюючи `package.json` з його резервною копією у кожному воркспейсі.
-runTazeCli — виконує команду `n-rules taze diff` для виведення компактного JSON зі списком major-оновлень та лічилки minor/patch.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.