@7n/rules 1.14.1 → 1.15.0

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

@@ -0,0 +1,162 @@
+/** @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}
+ */
+export 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

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

@@ -1,41 +0,0 @@
----
-type: JS Module
-title: uv-diff.mjs
-resource: npm/skills/taze/js/uv-diff.mjs
-docgen:
-  crc: a23e68cc
-  model: openai-codex/gpt-5.4-mini
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Працює з залежностями `pyproject.toml` у форматах PEP 508 і PEP 440: `parsePep508` і `parsePep440Version` розбирають записи, `extractLowerBoundVersion` дістає нижню межу версії, `diffPyprojectDeps` і `collectUvDiff` порівнюють прямі залежності та формують diff відносно backup-версії, а `listDirectDependencies` повертає список прямих залежностей. Код read-only (лише читає файли з диска), fail-safe перехоплює помилки без винятків назовні та для частини збоїв повертає порожнє значення замість помилки.
-
-## Поведінка
-
-- `parsePep508` — розбирає рядок залежності у форматі PEP 508 на назву пакета, extras і version specifier; для невалідного рядка повертає порожній результат.
-- `parsePep440Version` — витягує ядро версії PEP 440 і зводить відсутні компоненти до нулів; для не-версійного рядка повертає порожній результат.
-- `extractLowerBoundVersion` — дістає нижню межу версійного specifier-а, тобто версію, яку відповідає нижньому bound у залежності; якщо межі немає, повертає порожній результат.
-- `diffPyprojectDeps` — порівнює прямі залежності двох `pyproject.toml` за іменем пакета і класифікує зміну як major або minor/patch.
-- `collectUvDiff` — збирає diff для `pyproject.toml` між поточним файлом і його backup-версією, а за відсутності потрібних файлів повертає порожній diff.
-- `listDirectDependencies` — повертає список прямих залежностей із `pyproject.toml` у вигляді назв пакетів та extras.
-
-## Публічний API
-
-- parsePep508 — Розбирає один PEP 508-запис залежності на назву пакета, extras і version specifier.
-- parsePep440Version — Виділяє основні компоненти PEP 440-версії; відсутні частини вважає нулями.
-- extractLowerBoundVersion — Витягає найнижчу допустиму версію з набору `>=` / `==` / `~=`-обмежень.
-- diffPyprojectDeps — Порівнює списки `[project].dependencies` у двох `pyproject.toml` за назвою пакета.
-- collectUvDiff — Збирає різницю між поточним `pyproject.toml` і його backup-копією в `cwd`.
-- listDirectDependencies — Повертає прямі залежності з `[project].dependencies` поточного `pyproject.toml` разом з extras.
-
-Конфіги, на які спирається код: package.json
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

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

@@ -1,176 +0,0 @@
-/** @see ./docs/uv-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'
-
-/** Дефолтний суфікс бекапу — той самий, що й для package.json/Cargo.toml. */
-const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
-
-// Ім'я пакета (PEP 508: літери/цифри/`._-`) + опційні `[extras]` + решта
-// (версійний specifier, можливо з `; marker` — ігнорується, не наш скоуп).
-const PEP508_RE = /^\s*([A-Za-z0-9][A-Za-z0-9._-]*)\s*(\[[^\]]*])?\s*([^;]*)/
-
-/**
- * Парсить один PEP 508-рядок залежності (`"typer>=0.19.1,<0.20.0"`,
- * `"strawberry-graphql[asgi]>=0.282.0"`) на ім'я/extras/specifier.
- * @param {string} requirement рядок із `[project].dependencies`
- * @returns {{name: string, extras: string[], specifier: string}|null} розбір, або null для невалідного рядка
- */
-export function parsePep508(requirement) {
-  if (typeof requirement !== 'string') return null
-  const m = PEP508_RE.exec(requirement)
-  if (!m) return null
-  const extras = m[2]
-    ? m[2]
-        .slice(1, -1)
-        .split(',')
-        .map(s => s.trim())
-        .filter(Boolean)
-    : []
-  return { name: m[1], extras, specifier: (m[3] ?? '').trim() }
-}
-
-// 1-3 числові компоненти PEP 440 (`"1"`, `"0.4"`, `"1.2.3"`), без урахування
-// pre/post/dev-суфіксів (поза скоупом major/minor/patch-класифікації).
-const PEP440_VERSION_RE = /^[\s=><~!]*(\d+)(?:\.(\d+))?(?:\.(\d+))?/
-// Операторний префікс версійного сегмента (`>=`, `==`, `~=`, `!=` тощо) — для відсікання при витягуванні голої версії.
-const VERSION_OPERATOR_PREFIX_RE = /^[>=~!]+/
-
-/**
- * Парсить ядро PEP 440-версії (major.minor.patch, відсутні компоненти → 0).
- * @param {string} spec версійний рядок (сегмент specifier-а, без операторного префікса)
- * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-версії
- */
-export function parsePep440Version(spec) {
-  if (typeof spec !== 'string') return null
-  const m = PEP440_VERSION_RE.exec(spec)
-  if (!m) return null
-  return { major: Number(m[1]), minor: Number(m[2] ?? 0), patch: Number(m[3] ?? 0) }
-}
-
-/**
- * Дістає нижню межу версійного specifier-а (перший сегмент `>=`/`==`/`~=`
- * серед comma-separated списку, напр. `">=0.19.1,<0.20.0"` → `"0.19.1"`).
- * Саме нижня межа відповідає версії, яку реально ставить `uv add --bounds lower`.
- * @param {string} specifier версійний specifier із `parsePep508`
- * @returns {string|null} версія нижньої межі, або null якщо немає жодного `>=`/`==`/`~=`-сегмента
- */
-export function extractLowerBoundVersion(specifier) {
-  if (!specifier) return null
-  const clause = specifier
-    .split(',')
-    .map(s => s.trim())
-    .find(c => c.startsWith('>=') || c.startsWith('==') || c.startsWith('~='))
-  return clause ? clause.replace(VERSION_OPERATOR_PREFIX_RE, '').trim() : null
-}
-
-/**
- * Порівнює `[project].dependencies` двох pyproject.toml — той самий контракт,
- * що й `diffPackageJson`/`diffCargoToml`. Матчинг по ІМЕНІ пакета (не по
- * позиції в масиві — PEP 621 `dependencies` це список PEP 508-рядків, не
- * мапа ім'я→версія).
- * @param {object} oldManifest розпарсений старий pyproject.toml (бекап)
- * @param {object} newManifest розпарсений новий pyproject.toml
- * @param {string} manifest відносний шлях pyproject.toml (мітка джерела запису)
- * @returns {{major: Array<{manifest:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
- */
-export function diffPyprojectDeps(oldManifest, newManifest, manifest) {
-  const oldDeps = oldManifest?.project?.dependencies ?? []
-  const newByName = new Map()
-  for (const requirement of newDeps(newManifest)) {
-    const parsed = parsePep508(requirement)
-    if (parsed) newByName.set(parsed.name, parsed)
-  }
-
-  const major = []
-  let minorPatch = 0
-  for (const oldRequirement of oldDeps) {
-    const oldParsed = parsePep508(oldRequirement)
-    if (!oldParsed) continue
-    const newParsed = newByName.get(oldParsed.name)
-    if (!newParsed || newParsed.specifier === oldParsed.specifier) continue
-
-    const from = extractLowerBoundVersion(oldParsed.specifier)
-    const to = extractLowerBoundVersion(newParsed.specifier)
-    if (from === null || to === null || from === to) continue
-
-    const fromV = parsePep440Version(from)
-    const toV = parsePep440Version(to)
-    if (fromV && toV && isBreaking(fromV, toV)) {
-      major.push({ manifest, pkg: oldParsed.name, from, to })
-    } else {
-      minorPatch += 1
-    }
-  }
-  return { major, minorPatch }
-}
-
-/**
- * @param {object} manifest розпарсений pyproject.toml
- * @returns {string[]} `[project].dependencies` (порожній масив, якщо відсутнє)
- */
-function newDeps(manifest) {
-  return manifest?.project?.dependencies ?? []
-}
-
-/**
- * Читає й парсить 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 по pyproject.toml: порівнює `<cwd>/pyproject.toml` з
- * `<cwd>/pyproject.toml<backupSuffix>` — той самий контракт, що й
- * `collectTazeDiff`/`collectCargoDiff`.
- * @param {string} cwd корінь репозиторію (де лежить pyproject.toml — uv-конвенція: один кореневий файл, не per-crate, як Cargo.toml)
- * @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 collectUvDiff(cwd, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
-  const oldManifest = await readTomlOrNull(join(cwd, `pyproject.toml${backupSuffix}`))
-  const newManifest = await readTomlOrNull(join(cwd, 'pyproject.toml'))
-  if (!oldManifest || !newManifest) {
-    return { major: [], minorPatch: 0, totalChanged: 0, comparedManifests: 0 }
-  }
-  const res = diffPyprojectDeps(oldManifest, newManifest, 'pyproject.toml')
-  return {
-    major: res.major,
-    minorPatch: res.minorPatch,
-    totalChanged: res.major.length + res.minorPatch,
-    comparedManifests: 1
-  }
-}
-
-/**
- * Дістає `{name, extras, raw}` кожної прямої залежності з
- * `[project].dependencies` поточного pyproject.toml — вхід для
- * per-пакетного bump-циклу (`uv` немає єдиної команди "підняти все до
- * latest, навіть через major", на відміну від `bunx taze -w -r latest`/
- * `cargo upgrade --incompatible allow` — підтверджено емпірично: `uv add
- * <pkg>` на вже присутній залежності НЕ переписує specifier, поки не буде
- * `uv remove` спершу). `raw` — оригінальний PEP 508-рядок, потрібен для
- * best-effort відновлення, якщо `uv add` після `uv remove` не вдався.
- * @param {object} manifest розпарсений pyproject.toml
- * @returns {Array<{name: string, extras: string[], raw: string}>} прямі залежності
- */
-export function listDirectDependencies(manifest) {
-  return newDeps(manifest)
-    .map(requirement => {
-      const parsed = parsePep508(requirement)
-      return parsed ? { ...parsed, raw: requirement } : null
-    })
-    .filter(Boolean)
-    .map(({ name, extras, raw }) => ({ name, extras, raw }))
-}