@7n/rules 1.17.3 → 1.18.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.18.1] - 2026-07-18
+
+### Fixed
+
+- `resolveChangedBase` стійкий до stale-ref: merge-base рахується для обох кандидатів (`origin/main` і локальна `main`) і береться новіший (descendant) — у git-worktree застрягла локальна `main` більше не дає застарілу базу з фантомними «зміненими» файлами давно влитих PR (T0-фіксер створював фейкові change-фрагменти для незачеплених воркспейсів); фолбек на єдиний доступний ref офлайн/без remote збережено
+
+## [1.18.0] - 2026-07-18
+
+### Changed
+
+- Фаза 2 spec lang-plugins-extraction: Rust/Cargo-провайдер taze виїхав із ядра в окремий плагін `@7n/rules-lang-rust` (автодетект за кореневим Cargo.toml, extension-point `taze`) — сигнатури порту EcosystemProvider не змінились, оркестратор більше не має вбудованих провайдерів (усі екосистеми — з плагінів)
+
 ## [1.17.3] - 2026-07-18
 
 ### Changed

package/package.json

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

package/scripts/lib/changed-files.mjs

@@ -47,21 +47,32 @@ function dropWorktreeCheckouts(paths) {
 
 /**
  * Визначає git base для scoped-перевірок без зовнішнього runtime-стану.
- * Пріоритет: локальна `main`, потім `origin/main`; якщо обидві відсутні,
- * повертає null і caller порівнює лише робоче дерево з HEAD.
- * Явний `baseRef` (CI: `--base origin/main` після fetch) вимикає каскад —
+ * Кандидати — `origin/main` і локальна `main`: рахуємо merge-base з HEAD для обох
+ * і беремо **новіший** (descendant) з двох. Це захищає від stale-ref з будь-якого
+ * боку: у git-worktree локальна `main` закріплена за іншим деревом і часто відстає
+ * (застаріла база → фантомні «змінені» файли з давно влитих PR), а без свіжого
+ * fetch може відставати вже `origin/main`. Якщо доступний лише один ref (офлайн,
+ * без remote) — його merge-base; якщо жодного — null, і caller порівнює лише
+ * робоче дерево з HEAD. Повернений sha завжди досяжний (це merge-base існуючого
+ * ref), тож fail-closed перевірка в `collectChangedFilesSince` не спрацює хибно.
+ * Явний `baseRef` (CI: `--base origin/main` після fetch) вимикає вибір —
  * merge-base рахується лише проти нього.
  * @param {string} [cwd] корінь репо
- * @param {string|null} [baseRef] явний ref бази замість каскаду main→origin/main
+ * @param {string|null} [baseRef] явний ref бази замість вибору origin/main|main
  * @returns {string|null} merge-base commit або null
  */
 export function resolveChangedBase(cwd = process.cwd(), baseRef = null) {
-  for (const ref of baseRef ? [baseRef] : ['main', 'origin/main']) {
+  const mergeBaseWith = ref => {
     const result = spawnSync('git', ['merge-base', 'HEAD', ref], { cwd, encoding: 'utf8' })
-    const base = result.status === 0 && !result.error ? result.stdout.trim() : ''
-    if (base) return base
+    return result.status === 0 && !result.error ? result.stdout.trim() : ''
   }
-  return null
+  if (baseRef) return mergeBaseWith(baseRef) || null
+  const [primary, secondary] = ['origin/main', 'main'].map(ref => mergeBaseWith(ref)).filter(Boolean)
+  if (!primary || !secondary || primary === secondary) return primary ?? null
+  // Обидва ref-и дали різні merge-base: новіший — той, що є нащадком іншого.
+  // Якщо гілки merge-base розійшлися (екзотика), лишаємо пріоритет origin/main.
+  const ancestry = spawnSync('git', ['merge-base', '--is-ancestor', primary, secondary], { cwd })
+  return ancestry.status === 0 && !ancestry.error ? secondary : primary
 }
 
 /**

package/scripts/lib/docs/changed-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: changed-files.mjs
 resource: npm/scripts/lib/changed-files.mjs
 docgen:
-  crc: 254d852a
+  crc: 1c7d9027
   score: 100
 ---
 
@@ -19,8 +19,9 @@ collectChangedFilesSince Збирає змінені та незакомічен
 
 - collectChangedFiles: Збирає список змінених та невідстежених файлів з робочого дерева відносно робочого дерева.
 - resolveChangedBase: Визначає базовий комміт для обмежених перевірок без використання зовнішнього стану.
-  - Пріоритет: локальна `main`, потім `origin/main`; явний другий аргумент `baseRef` (CI: `--base origin/main`) вимикає каскад — merge-base рахується лише проти нього.
-  - Якщо ref-и відсутні, повертає null, і викликаючий порівнює лише робоче дерево з HEAD.
+  - Кандидати — `origin/main` і локальна `main`: merge-base з HEAD рахується для обох, береться новіший (descendant). Це захищає від stale-ref: у git-worktree локальна `main` часто відстає, без свіжого fetch може відставати `origin/main`.
+  - Явний другий аргумент `baseRef` (CI: `--base origin/main`) вимикає вибір — merge-base рахується лише проти нього.
+  - Якщо доступний лише один ref (офлайн/без remote) — його merge-base; якщо ref-и відсутні, повертає null, і викликаючий порівнює лише робоче дерево з HEAD.
 - collectChangedFilesSince: Збирає список змінених та невідстежених файлів відносно базового комміту.
 - git diff <base>: Порівнює комміт `base` з поточним робочим деревом (включаючи закомічені та незакомічені модифікації).
   - Якщо `base` відсутній, використовується `collectChangedFiles`.

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: ef33c272
+  crc: d1bfa8f2
 ---
 
 Резолв плагінів @7n/rules: визначає, які пакети-плагіни активні у проєкті, де їхні `rules/`-каталоги, які capabilities вони надають і які handlers надають.

package/scripts/lib/resolve-plugins.mjs

@@ -30,7 +30,8 @@ export const KNOWN_CI_PLUGINS = Object.freeze({
 
 /** Відомі мовні плагіни: файловий сигнал екосистеми в корені репо → npm-пакет. */
 export const KNOWN_LANG_PLUGINS = Object.freeze({
-  python: { signal: 'pyproject.toml', pkg: '@7n/rules-lang-python' }
+  python: { signal: 'pyproject.toml', pkg: '@7n/rules-lang-python' },
+  rust: { signal: 'Cargo.toml', pkg: '@7n/rules-lang-rust' }
 })
 
 const WORKFLOW_YML_RE = /\.ya?ml$/u
@@ -96,7 +97,7 @@ function detectCiPlugins(projectRoot) {
 /**
  * Автодетект плагінів за станом репозиторію: CI-плагіни (файлові сигнали з
  * fallback на `repository.url`) + мовні плагіни (лише файлові сигнали —
- * маніфест екосистеми в корені; URL-fallback для мов безглуздий).
+ * маніфест екосистеми в корені — pyproject.toml, кореневий Cargo.toml; URL-fallback для мов безглуздий).
  * @param {string} projectRoot корінь репозиторію
  * @returns {string[]} npm-імена плагінів
  */

package/skills/taze/SKILL.md

@@ -25,11 +25,11 @@ version: '1.2'
 3. Детерміновано прибирає бекапи (крок 7) і компонує звіт (крок 8) з результатів усіх ітерацій.
 
 Не-npm екосистеми оркестратор веде через **EcosystemProvider-порт**
-(`@7n/rules/plugin-api`, spec `docs/specs/2026-07-18-lang-plugins-extraction-spec.md`):
-Rust — вбудований first-party провайдер (`rust-provider.mjs`, до фази 2), Python —
-плагін **`@7n/rules-lang-python`** (автодетект за кореневим `pyproject.toml`,
-доставляється автоматично при першому запуску; extension-point `taze`). На
-чисто-JS проєкті без цих сигналів у звіті немає навіть згадки про інші екосистеми.
+(`@7n/rules/plugin-api`, spec `docs/specs/2026-07-18-lang-plugins-extraction-spec.md`)
+— плагіни, що доставляються автоматично при першому запуску за файловим сигналом
+(extension-point `taze`): Rust — **`@7n/rules-lang-rust`** (кореневий `Cargo.toml`),
+Python — **`@7n/rules-lang-python`** (кореневий `pyproject.toml`). На чисто-JS
+проєкті без цих сигналів у звіті немає навіть згадки про інші екосистеми.
 
 Якщо `Cargo.toml` знайдені, але `cargo-edit` не встановлено — Rust-гілка **не**
 блокує інші гілки: оркестратор пропускає Rust-обробку і в звіті перелічує

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: 256c4e77
+  crc: b675f6e7
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98
@@ -12,7 +12,7 @@ docgen:
 
 ## Огляд
 
-Оркеструє taze детерміновано, без LLM для службових кроків: бекап маніфестів → масовий bump → diff-класифікація major vs minor/patch → прибирання бекапів → Markdown-звіт. Для КОЖНОГО окремого major-пакета з diff-у виконує один ізольований, обмежений виклик обраного раннера — лише перевірка сумісності й рефакторинг, не сам bump. npm/bun-гілка вбудована; решта екосистем — `EcosystemProvider`-и (контракт `@7n/rules/plugin-api`): Rust як first-party (`rust-provider.mjs`), інші — з плагінів (`@7n/rules-lang-*`, extension-point `taze`). Файл виконує реальні файлові операції (бекапи) і запускає зовнішні команди (`bunx`, `bun`, `git`, команди провайдерів) — не read-only.
+Оркеструє 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.
 
 ## Поведінка
 

package/skills/taze/js/orchestrate.mjs

@@ -10,7 +10,6 @@ import { readNRulesConfigLite } from '../../../scripts/lib/read-n-rules-config-l
 import { getHandlers, resolvePlugins } from '../../../scripts/lib/resolve-plugins.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 import { collectTazeDiff } from './diff.mjs'
-import rustProvider from './rust-provider.mjs'
 
 /** Суфікс бекапу package.json — той самий, що й у `diff.mjs`/кроці 1 SKILL.md. */
 const BACKUP_SUFFIX = '.taze-bak'
@@ -318,8 +317,8 @@ export function formatReport({ minorPatch, totalChanged, results, ecosystems = [
  * прибирання → звіт) без LLM, і по одному ізольованому, обмеженому по
  * обсягу виклику `callRunner` на кожен major-пакет (кроки 4-6 SKILL.md) —
  * замість одного величезного непрозорого ходу на весь монорепо. npm/bun-гілка
- * вбудована; решта екосистем — EcosystemProvider-и: first-party (Rust/Cargo)
- * плюс завантажені з плагінів (`@7n/rules-lang-*`, extension-point `taze`).
+ * вбудована; решта екосистем — EcosystemProvider-и, завантажені з плагінів
+ * (`@7n/rules-lang-*`, extension-point `taze`; фаза 2 spec — Rust теж плагін).
  * Падіння одного пакета/однієї екосистеми не втрачає прогрес по інших.
  * @param {{
  *   cwd?: string,
@@ -371,7 +370,7 @@ export async function runTazeOrchestrator(options = {}) {
     log('⏭ npm/bun: кореневого package.json немає — гілка пропущена')
   }
 
-  const providers = deps.ecosystemProviders ?? [rustProvider, ...(await loadPluginTazeProviders(cwd, log, deps))]
+  const providers = deps.ecosystemProviders ?? (await loadPluginTazeProviders(cwd, log, deps))
   const ecosystems = []
   for (const provider of providers) {
     ecosystems.push(await runEcosystem(provider, { cwd, runner, log, deps, spawnFn, call }))

package/skills/taze/js/cargo-diff.mjs

@@ -1,117 +0,0 @@
-/** @see ./docs/cargo-diff.md */
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-import { parse as parseToml } from 'smol-toml'
-
-import { isBreaking } from './diff.mjs'
-
-/** Поля Cargo.toml із залежностями, які порівнюємо (аналог DEP_FIELDS у diff.mjs). */
-const CARGO_DEP_FIELDS = ['dependencies', 'dev-dependencies', 'build-dependencies']
-
-/** Дефолтний суфікс бекапу — той самий, що й для package.json (крок 1 SKILL.md, Rust-гілка). */
-const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
-
-// 1-3 числові компоненти (`"1"`, `"0.4"`, `"1.2.3"`), опційний `=`/`~`/`^`/`>=`-префікс.
-//Cargo трактує відсутні компоненти як 0 і для матчингу, і для caret-сумісності —
-// той самий "найлівіша ненульова компонента" принцип, що й у isBreaking з diff.mjs.
-const CARGO_VERSION_RE = /^[\s=~^><]*(\d+)(?:\.(\d+))?(?:\.(\d+))?/
-
-/**
- * Парсить Cargo-версійний specifier (1-3 компоненти, відсутні → 0).
- * @param {string} spec версійний specifier із Cargo.toml (`"1"`, `"0.4.2"`, `"=1.2.3"`)
- * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver
- */
-export function parseCargoVersion(spec) {
-  if (typeof spec !== 'string') return null
-  const m = CARGO_VERSION_RE.exec(spec)
-  if (!m) return null
-  return { major: Number(m[1]), minor: Number(m[2] ?? 0), patch: Number(m[3] ?? 0) }
-}
-
-/**
- * Дістає версійний specifier одного запису залежності Cargo.toml — рядок
- * напряму (`tokio = "1"`), або поле `version` inline-таблиці
- * (`serde = { version = "1", features = [...] }`).
- * @param {unknown} value значення запису залежності
- * @returns {string|null} specifier, або null для path/git-залежності (без номера версії)
- */
-export function extractCargoVersionSpec(value) {
-  if (typeof value === 'string') return value
-  if (value && typeof value === 'object' && !Array.isArray(value) && typeof value.version === 'string') {
-    return value.version
-  }
-  return null
-}
-
-/**
- * Порівнює два розпарсені Cargo.toml і повертає зміни залежностей —
- * той самий контракт, що й `diffPackageJson` у diff.mjs, лише для Cargo.
- * @param {object} oldManifest розпарсений старий Cargo.toml (бекап)
- * @param {object} newManifest розпарсений новий Cargo.toml
- * @param {string} manifest відносний шлях Cargo.toml (мітка джерела запису)
- * @returns {{major: Array<{manifest:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
- */
-export function diffCargoToml(oldManifest, newManifest, manifest) {
-  const major = []
-  let minorPatch = 0
-  for (const field of CARGO_DEP_FIELDS) {
-    const oldDeps = oldManifest?.[field]
-    const newDeps = newManifest?.[field]
-    if (!oldDeps || !newDeps) continue
-    for (const [crate, oldValue] of Object.entries(oldDeps)) {
-      const newValue = newDeps[crate]
-      if (newValue === undefined) continue
-      const from = extractCargoVersionSpec(oldValue)
-      const to = extractCargoVersionSpec(newValue)
-      if (from === null || to === null || from === to) continue
-      const fromV = parseCargoVersion(from)
-      const toV = parseCargoVersion(to)
-      if (fromV && toV && isBreaking(fromV, toV)) {
-        major.push({ manifest, pkg: crate, from, to })
-      } else {
-        minorPatch += 1
-      }
-    }
-  }
-  return { major, minorPatch }
-}
-
-/**
- * Читає й парсить TOML-файл, або повертає null, якщо файл відсутній/невалідний.
- * @param {string} path абсолютний шлях
- * @returns {Promise<object|null>} розпарсений обʼєкт або null
- */
-async function readTomlOrNull(path) {
-  if (!existsSync(path)) return null
-  try {
-    return parseToml(await readFile(path, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/**
- * Збирає diff по всіх Cargo.toml монорепо: для кожного шляху зі списку
- * порівнює `<manifest>` з `<manifest><backupSuffix>` — той самий контракт,
- * що й `collectTazeDiff` для package.json.
- * @param {string} cwd корінь репозиторію
- * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
- * @param {string} [backupSuffix] суфікс бекап-файлу
- * @returns {Promise<{major: Array<{manifest:string, pkg:string, from:string, to:string}>, minorPatch:number, totalChanged:number, comparedManifests:number}>} агрегований diff
- */
-export async function collectCargoDiff(cwd, manifestPaths, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
-  const major = []
-  let minorPatch = 0
-  let comparedManifests = 0
-  for (const manifest of manifestPaths) {
-    const oldManifest = await readTomlOrNull(join(cwd, `${manifest}${backupSuffix}`))
-    const newManifest = await readTomlOrNull(join(cwd, manifest))
-    if (!oldManifest || !newManifest) continue
-    comparedManifests += 1
-    const res = diffCargoToml(oldManifest, newManifest, manifest)
-    major.push(...res.major)
-    minorPatch += res.minorPatch
-  }
-  return { major, minorPatch, totalChanged: major.length + minorPatch, comparedManifests }
-}

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

@@ -1,41 +0,0 @@
----
-type: JS Module
-title: cargo-diff.mjs
-resource: npm/skills/taze/js/cargo-diff.mjs
-docgen:
-  crc: afe20497
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-`package.json`
-
-Файл читає версії з `Cargo.toml`, виділяє специфікації залежностей, порівнює дві версії маніфесту та збирає diff по змінах версій. Для монорепо проходить по списку `Cargo.toml` і агрегує результати для всіх знайдених маніфестів. Усі помилки перехоплює fail-safe: не кидає винятків назовні й за окремих збоїв повертає порожнє значення замість помилки.
-
-## Поведінка
-
-- parseCargoVersion — виділяє версійну частину Cargo-специфікатора й повертає її як нормалізоване числове ядро; для не-версійних значень повертає null.
-- extractCargoVersionSpec — дістає версійний specifier із запису залежності Cargo.toml; для path/git-залежностей без версії повертає null.
-- diffCargoToml — порівнює два розпарсені Cargo.toml і визначає зміни залежностей, розділяючи їх на major та minor/patch.
-- collectCargoDiff — проходить по списку Cargo.toml у монорепо, зіставляє кожен файл із його backup-файлом і збирає агрегований diff; якщо один із файлів відсутній або невалідний, пропускає його без падіння.
-
-## Публічний API
-
-- Конфіги, на які спирається код: `package.json` — джерело списку залежностей і меж для порівняння змін.
-- `parseCargoVersion` — розбирає Cargo-версійний specifier і заповнює відсутні частини нулями.
-- `extractCargoVersionSpec` — дістає версію залежності з запису `Cargo.toml`, як з короткого рядка, так і з inline-таблиці.
-- `diffCargoToml` — порівнює два розібрані `Cargo.toml` і повертає зміни по залежностях.
-- `collectCargoDiff` — збирає diff для всіх `Cargo.toml` у монорепо, зіставляючи кожен маніфест із його backup-версією.
-
-Changelog: не перевіряв — змін у файлах не вносив.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/skills/taze/js/docs/rust-provider.md

@@ -1,42 +0,0 @@
----
-type: JS Module
-title: rust-provider.mjs
-resource: npm/skills/taze/js/rust-provider.mjs
-docgen:
-  crc: 5f9de45d
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Огляд
-
-Модуль `rustProvider` об’єднує публічні кроки для роботи з Cargo-залежностями: `findCargoManifests` знаходить `Cargo.toml` у репозиторії, `buildCargoDependencyPrompt` готує запит для major-оновлення Rust-крейта, `backupCargoManifests` створює резервні копії маніфестів, а `cleanupCargoBackups` прибирає їх після завершення.  
-
-`rustProvider` — вбудований first-party EcosystemProvider Rust/Cargo для taze-оркестратора (контракт `@7n/rules/plugin-api`); до фази 2 живе в ядрі, далі виїде в `@7n/rules-lang-rust`. Модуль виконує реальні файлові операції (бекапи `Cargo.toml`/`Cargo.lock`) і запускає зовнішні команди (`find`, `cargo upgrade`/`cargo update`) — не read-only; сам до мережі не звертається (посилання на crates.io — лише текст промпта для раннера).
-
-## Поведінка
-
-- `buildCargoDependencyPrompt` — формує текст завдання для перевірки major-оновлення одного Rust-крейта: підказує звірити breaking changes через сторінку на `https://crates.io/crates/`, changelog або releases репозиторію, знайти зачеплене використання в коді й або нічого не змінювати, або виконати сумісний рефакторинг із підсумком у відповіді.
-- `findCargoManifests` — знаходить `Cargo.toml` у репозиторії, свідомо пропускаючи `node_modules`, `.worktrees` і `target`.
-- `backupCargoManifests` — створює резервні копії всіх знайдених `Cargo.toml` і спільного кореневого `Cargo.lock`.
-- `cleanupCargoBackups` — видаляє резервні копії `Cargo.toml` і `Cargo.lock` після завершення роботи.
-- `rustProvider` — описує вбудованого provider для Rust/Cargo в taze: визначає виявлення маніфестів, перевірку доступності через `cargo-edit`, резервне копіювання, оновлення залежностей, побудову prompt і очищення бекапів.
-
-## Публічний API
-
-- buildCargoDependencyPrompt — Формує prompt для одного LLM-циклу оновлення major-версії одного Rust-крейта; оркестратор окремо робить решту кроків без LLM.
-- findCargoManifests — Підбирає всі `Cargo.toml`, оминаючи `node_modules`, `.worktrees` і `target`.
-- backupCargoManifests — Зберігає копії кожного `Cargo.toml` і спільного кореневого `Cargo.lock`; розраховано на один workspace-lock у корені `cwd`, без підтримки кількох незалежних workspace.
-- cleanupCargoBackups — Видаляє тимчасові бекапи `Cargo.toml` і `Cargo.lock` після завершення роботи.
-- rustProvider — Вбудований Rust/Cargo provider для taze-оркестратора у форматі `@7n/rules/plugin-api`; надалі має перейти в `@7n/rules-lang-rust`.
-
-## Гарантії поведінки
-
-- Виконує файлові операції (бекапи) і запускає зовнішні команди (`find`, `cargo`) — НЕ read-only.
-- Провал cargo-команди в `bump` кидає помилку з exit-кодом і stderr.
-- Пошук маніфестів свідомо пропускає шляхи: `node_modules`, `.worktrees`, `target`.

package/skills/taze/js/rust-provider.mjs

@@ -1,162 +0,0 @@
-/** @see ./docs/rust-provider.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 { collectCargoDiff } from './cargo-diff.mjs'
-
-/** Суфікс бекапу — той самий, що й для package.json (крок 1 SKILL.md, Rust-гілка). */
-const BACKUP_SUFFIX = '.taze-bak'
-
-/**
- * Промпт ОДНОГО ітеративного виклику для Rust-крейта (кроки 4-6 SKILL.md,
- * Rust-гілка) для ОДНОГО major-крейта. Кроки 1-3/7/8 виконує оркестратор
- * детерміновано, без LLM.
- * @param {{manifest: string, pkg: string, from: string, to: string}} entry запис major-diff (з `collectCargoDiff`)
- * @returns {string} готовий промпт
- */
-export function buildCargoDependencyPrompt({ manifest, pkg, from, to }) {
-  return [
-    '# Major-оновлення одного Rust-крейта: перевірка сумісності й рефакторинг',
-    '',
-    `Крейт \`${pkg}\` у \`${manifest}\`: **${from} → ${to}** — вже застосовано в Cargo.toml/Cargo.lock (кроки 1-3 виконано детерміновано, без тебе). Твоя задача — лише breaking-changes-перевірка й, за потреби, рефакторинг.`,
-    '',
-    '## Кроки',
-    `1. Зібрати breaking changes цього оновлення: адреса репозиторію з поля \`repository\`/\`documentation\` крейта на crates.io (https://crates.io/crates/${pkg}) — CHANGELOG.md репозиторію чи GitHub Releases. Якщо немає — різниця по публічному API (\`pub fn\`/\`pub struct\`/\`pub trait\`) між закешованою старою версією (\`~/.cargo/registry/src/*/${pkg}-<стара-версія>/\`) і новою.`,
-    `2. Знайти використання зачепленого API в коді проєкту (\`rg -n --type rust\` по use-шляхах/викликах \`${pkg}\`).`,
-    '3. Сумісно — нічого не робити. Несумісно — застосувати міграцію (перейменувати use-шлях, оновити сигнатуру виклику, замінити видалений макрос еквівалентом).',
-    '4. Якщо були правки — запусти `cargo fmt --all -- --check`, `cargo clippy --all-targets --all-features -- -D warnings`, `cargo test`.',
-    '5. Нетривіальна/неоднозначна міграція — не вгадуй, залиш TODO-коментар із посиланням на CHANGELOG.',
-    '',
-    'У відповіді одним абзацом підсумуй: сумісно / зрефакторено (які файли) / TODO (чому).'
-  ].join('\n')
-}
-
-/**
- * Знаходить Cargo.toml поза node_modules/.worktrees/target (крок 0.2 SKILL.md).
- * @param {string} cwd корінь репо
- * @param {{ spawnFn?: (cmd: string, args: string[], opts?: object) => { status: number|null, stdout: string, stderr: string } }} deps інжект зі spawnSync-сумісним викликом
- * @returns {string[]} відносні шляхи знайдених Cargo.toml
- */
-export function findCargoManifests(cwd, deps = {}) {
-  const spawnFn = deps.spawnFn ?? spawnSync
-  const result = spawnFn(
-    'find',
-    [
-      '.',
-      '-name',
-      'Cargo.toml',
-      '-not',
-      '-path',
-      '*/node_modules/*',
-      '-not',
-      '-path',
-      '*/.worktrees/*',
-      '-not',
-      '-path',
-      '*/target/*'
-    ],
-    { cwd, encoding: 'utf8' }
-  )
-  return (result.stdout ?? '')
-    .split('\n')
-    .map(line => line.trim())
-    .filter(Boolean)
-}
-
-/**
- * Чи встановлений cargo-edit (дає `cargo upgrade`) — без нього неможливо
- * детерміновано перетнути major-межу Rust-залежностей (голий `cargo update`
- * піднімає лише semver-сумісні версії; SKILL.md §Передумови).
- * @param {import('../../../scripts/lib/plugin-api.mjs').SpawnFn} spawnFn spawnSync-сумісний виклик
- * @returns {boolean} true — `cargo upgrade` доступна
- */
-function hasCargoEdit(spawnFn) {
-  return spawnFn('cargo', ['upgrade', '--version'], { encoding: 'utf8' }).status === 0
-}
-
-/**
- * Бекапить кожен Cargo.toml + спільний кореневий Cargo.lock (крок 1 SKILL.md,
- * Rust-гілка). v1: один спільний workspace/Cargo.lock у корені `cwd` —
- * поточна реальна топологія репо; кілька незалежних Cargo-workspace поки не
- * підтримується.
- * @param {string} cwd корінь репо
- * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
- * @param {{ copyFile?: (src: string, dest: string) => Promise<void> }} [deps] інжект
- * @returns {Promise<void>}
- */
-export async function backupCargoManifests(cwd, manifestPaths, deps = {}) {
-  const copy = deps.copyFile ?? copyFile
-  for (const manifest of manifestPaths) {
-    const manifestPath = join(cwd, manifest)
-    if (existsSync(manifestPath)) await copy(manifestPath, `${manifestPath}${BACKUP_SUFFIX}`)
-  }
-  const lockPath = join(cwd, 'Cargo.lock')
-  if (existsSync(lockPath)) await copy(lockPath, `${lockPath}${BACKUP_SUFFIX}`)
-}
-
-/**
- * Прибирає бекапи Cargo.toml/Cargo.lock після завершення (крок 7 SKILL.md,
- * Rust-гілка).
- * @param {string} cwd корінь репо
- * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
- * @param {{ rm?: (path: string, opts?: object) => Promise<void> }} [deps] інжект
- * @returns {Promise<void>}
- */
-export async function cleanupCargoBackups(cwd, manifestPaths, deps = {}) {
-  const remove = deps.rm ?? rm
-  for (const manifest of manifestPaths) {
-    await remove(join(cwd, `${manifest}${BACKUP_SUFFIX}`), { force: true })
-  }
-  await remove(join(cwd, `Cargo.lock${BACKUP_SUFFIX}`), { force: true })
-}
-
-/**
- * Виконує cargo-команду, кидає з exit-кодом+stderr при провалі.
- * @param {string[]} args аргументи cargo
- * @param {string} cwd робочий каталог
- * @param {import('../../../scripts/lib/plugin-api.mjs').SpawnFn} spawnFn spawnSync-сумісний виклик
- * @returns {void}
- */
-function runCargo(args, cwd, spawnFn) {
-  const result = spawnFn('cargo', args, { cwd, encoding: 'utf8' })
-  if (result.status !== 0) {
-    throw new Error(`cargo ${args.join(' ')} → exit ${result.status}: ${result.stderr || result.stdout}`)
-  }
-}
-
-/**
- * Вбудований (first-party) EcosystemProvider Rust/Cargo для taze-оркестратора —
- * форма контракту `@7n/rules/plugin-api`. Лишається в ядрі до фази 2
- * (spec 2026-07-18-lang-plugins-extraction), далі виїде в `@7n/rules-lang-rust`.
- * @type {import('../../../scripts/lib/plugin-api.mjs').EcosystemProvider}
- */
-const rustProvider = {
-  id: 'rust-cargo',
-  title: 'Rust-крейти',
-  manifestNoun: 'Cargo.toml',
-  skillSection: 'Rust-гілкою SKILL.md',
-  detect: (cwd, deps) => findCargoManifests(cwd, deps),
-  available: spawnFn =>
-    hasCargoEdit(spawnFn)
-      ? { ok: true, reason: null }
-      : {
-          ok: false,
-          reason:
-            'cargo-edit не встановлено (`cargo install cargo-edit`) — cargo update без нього недетермінований для major'
-        },
-  backup: backupCargoManifests,
-  bump: (cwd, manifests, { spawnFn, log }) => {
-    log('⬆️  cargo upgrade --incompatible allow...')
-    runCargo(['upgrade', '--incompatible', 'allow'], cwd, spawnFn)
-    log('🔄 cargo update...')
-    runCargo(['update'], cwd, spawnFn)
-    return Promise.resolve()
-  },
-  diff: (cwd, manifests) => collectCargoDiff(cwd, manifests),
-  promptFor: buildCargoDependencyPrompt,
-  cleanup: cleanupCargoBackups
-}
-
-export default rustProvider