@7n/rules 1.9.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.10.0] - 2026-07-17
4
+
5
+ ### Added
6
+
7
+ - `skill pi/cursor/codex taze` — Rust-гілку (`Cargo.toml`) тепер теж покриває оркестратор: детермінований `collectCargoDiff` (`npm/skills/taze/js/cargo-diff.mjs`, парсинг через `smol-toml`, той самий caret-семантики принцип, що й для npm) замість ручної класифікації, і по одному ізольованому виклику раннера на кожен major-крейт. Якщо `cargo-edit` не встановлено — Rust-гілка пропускається без блокування npm-гілки (перелік Cargo.toml лишається в звіті)
8
+
3
9
  ## [1.9.0] - 2026-07-17
4
10
 
5
11
  ### Added
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@7n/rules",
3
- "version": "1.9.0",
3
+ "version": "1.10.0",
4
4
  "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
5
5
  "keywords": [
6
6
  "cli",
@@ -13,33 +13,35 @@ version: '1.1'
13
13
 
14
14
  Оновити всі модулі проекту (npm/bun-залежності, а за наявності `Cargo.toml` — і Rust-крейти) до останніх версій, виявити major-оновлення, перевірити сумісність змін з кодом проекту і за потреби зрефакторити несумісні місця.
15
15
 
16
- ## Оркестрація (npm/bun-гілка) — не одним промптом
16
+ ## Оркестрація (npm/bun- і Rust-гілка) — не одним промптом
17
17
 
18
18
  `npx @7n/rules skill pi|cursor|codex taze` **не** передає цей файл одним суцільним
19
19
  промптом в один агентський хід — так робив старий дизайн, і саме тому реальний
20
20
  прогін міг зависати без жодної діагностики (один величезний непрозорий хід на
21
21
  весь монорепо, без проміжних зупинок для перевірки прогресу). Замість цього `npm/skills/taze/js/orchestrate.mjs`:
22
22
 
23
- 1. Детерміновано, без LLM, виконує кроки 1-3 нижче (бекап → `bunx taze -w -r latest` → `bun install` → `n-rules taze diff`).
24
- 2. Для кожного **окремого** major-пакета з diff-у — один ізольований, обмежений виклик обраного раннера (кроки 4-6, лише для цього пакета; промпт генерує `buildDependencyPrompt`, не цей SKILL.md).
23
+ 1. Детерміновано, без LLM, виконує кроки 1-3 нижче для обох гілок: npm/bun (бекап → `bunx taze -w -r latest` → `bun install` → `n-rules taze diff`) і, якщо знайдені `Cargo.toml`, Rust (бекап → `cargo upgrade --incompatible allow` → `cargo update` → `collectCargoDiff` з `cargo-diff.mjs`, детермінований cargo-еквівалент `n-rules taze diff` — парсить кожен `Cargo.toml` через `smol-toml`, класифікує major за тим самим правилом caret-семантики, включно з Cargo-скороченими версіями `"1"`/`"0.4"`).
24
+ 2. Для кожного **окремого** major-пакета/крейта з diff-у — один ізольований, обмежений виклик обраного раннера (кроки 4-6, лише для цього запису; промпт генерує `buildDependencyPrompt`/`buildCargoDependencyPrompt`, не цей SKILL.md).
25
25
  3. Детерміновано прибирає бекапи (крок 7) і компонує звіт (крок 8) з результатів усіх ітерацій.
26
26
 
27
- Переваги: падіння/timeout на одному пакеті не втрачає прогрес по інших; кожен
28
- виклик успадковує власний timeout раннера (короткий, бо скоуп малий — один
29
- пакет, не весь монорепо); видно прогрес по пакетах, а не чорну скриньку.
27
+ Якщо `Cargo.toml` знайдені, але `cargo-edit` не встановлено Rust-гілка **не**
28
+ блокує npm-гілку: оркестратор пропускає Rust-обробку і в звіті перелічує
29
+ знайдені `Cargo.toml` як такі, що потребують ручного прогону (нижче).
30
+
31
+ Переваги: падіння/timeout на одному пакеті/крейті не втрачає прогрес по інших;
32
+ кожен виклик успадковує власний timeout раннера (короткий, бо скоуп малий —
33
+ один запис, не весь монорепо); видно прогрес по записах, а не чорну скриньку.
30
34
 
31
35
  Кроки 1-8 нижче лишаються джерелом правди щодо ЗМІСТУ роботи (що саме робить
32
36
  кожен крок) — оркестратор їх виконує програмно (1-3/7/8) або як промпт на
33
- один пакет (4-6). Пряме читання цього файлу одним агентом (як SKILL.md для
34
- інших скілів) досі стосується лише **Rust-гілки** (нижче) — вона оркестратором
35
- не покрита.
37
+ один запис (4-6) для обох гілок.
36
38
 
37
39
  ## Передумови
38
40
 
39
41
  - Чисте робоче дерево (`git status` без незакомічених змін у `package.json` / `bun.lock` / `node_modules`) — інакше різницю не відрізнити від оновлення.
40
42
  - Встановлений `bun` і доступний `bunx`.
41
43
  - Запуск з кореня проекту (де лежить `package.json` / `bun.lock`).
42
- - Якщо в проекті є хоч один `Cargo.toml` (не в `node_modules`/`.worktrees`) — додатково встановлений `cargo-edit` (`cargo install cargo-edit`, дає команду `cargo upgrade`). Без нього major-бампи Rust-залежностей неможливо застосувати детерміновано (голий `cargo update` піднімає лише semver-сумісні версії) — **STOP** і попроси користувача встановити перед продовженням кроку 2 для Rust-гілки.
44
+ - Якщо в проекті є хоч один `Cargo.toml` (не в `node_modules`/`.worktrees`) — бажано встановлений `cargo-edit` (`cargo install cargo-edit`, дає команду `cargo upgrade`). Без нього major-бампи Rust-залежностей неможливо застосувати детерміновано (голий `cargo update` піднімає лише semver-сумісні версії) — оркестратор пропускає Rust-гілку (без блокування npm-гілки) і перелічує знайдені `Cargo.toml` у звіті як такі, що потребують ручного прогону кроків 2-8 нижче.
43
45
 
44
46
  ### 0.2. Детекція Rust-крейтів
45
47
 
@@ -102,7 +104,7 @@ n-rules taze diff
102
104
 
103
105
  Покриває **прямі** залежності з `package.json` (root + воркспейси). Транзитивні major-стрибки (`bun.lock`) — за потреби переглянь окремо; основний ризик breaking-змін — у прямих.
104
106
 
105
- **Rust-гілка**для `n-rules taze diff` немає cargo-еквівалента, класифікація ручна: для кожного `Cargo.toml.taze-bak` порівняти версію кожної залежності зі свіжим `Cargo.toml` за тим самим правилом (зміна найлівішої ненульової semver-компоненти = major). Швидкий спосіб — `diff Cargo.toml.taze-bak Cargo.toml` по рядках `<name> = "<version>"` і вручну класифікувати кожну зміну.
107
+ **Rust-гілка (оркестровано)** `collectCargoDiff` (`npm/skills/taze/js/cargo-diff.mjs`) робить те саме детерміновано: парсить кожен `Cargo.toml.taze-bak`/`Cargo.toml` через `smol-toml`, порівнює `dependencies`/`dev-dependencies`/`build-dependencies` (рядок чи `{ version = "...", features = [...] }`), класифікує за тим самим правилом caret-семантики — Cargo-скорочені версії (`"1"`, `"0.4"`) трактуються як відсутні компоненти = 0. Ручний прогін поза оркестратором той самий принцип: `diff Cargo.toml.taze-bak Cargo.toml` по рядках `<name> = "<version>"`.
106
108
 
107
109
  ### 4. Зібрати breaking changes по кожному major-оновленню
108
110
 
@@ -0,0 +1,117 @@
1
+ /** @see ./docs/cargo-diff.md */
2
+ import { existsSync } from 'node:fs'
3
+ import { readFile } from 'node:fs/promises'
4
+ import { join } from 'node:path'
5
+ import { parse as parseToml } from 'smol-toml'
6
+
7
+ import { isBreaking } from './diff.mjs'
8
+
9
+ /** Поля Cargo.toml із залежностями, які порівнюємо (аналог DEP_FIELDS у diff.mjs). */
10
+ const CARGO_DEP_FIELDS = ['dependencies', 'dev-dependencies', 'build-dependencies']
11
+
12
+ /** Дефолтний суфікс бекапу — той самий, що й для package.json (крок 1 SKILL.md, Rust-гілка). */
13
+ const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
14
+
15
+ // 1-3 числові компоненти (`"1"`, `"0.4"`, `"1.2.3"`), опційний `=`/`~`/`^`/`>=`-префікс.
16
+ //Cargo трактує відсутні компоненти як 0 і для матчингу, і для caret-сумісності —
17
+ // той самий "найлівіша ненульова компонента" принцип, що й у isBreaking з diff.mjs.
18
+ const CARGO_VERSION_RE = /^[\s=~^><]*(\d+)(?:\.(\d+))?(?:\.(\d+))?/
19
+
20
+ /**
21
+ * Парсить Cargo-версійний specifier (1-3 компоненти, відсутні → 0).
22
+ * @param {string} spec версійний specifier із Cargo.toml (`"1"`, `"0.4.2"`, `"=1.2.3"`)
23
+ * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver
24
+ */
25
+ export function parseCargoVersion(spec) {
26
+ if (typeof spec !== 'string') return null
27
+ const m = CARGO_VERSION_RE.exec(spec)
28
+ if (!m) return null
29
+ return { major: Number(m[1]), minor: Number(m[2] ?? 0), patch: Number(m[3] ?? 0) }
30
+ }
31
+
32
+ /**
33
+ * Дістає версійний specifier одного запису залежності Cargo.toml — рядок
34
+ * напряму (`tokio = "1"`), або поле `version` inline-таблиці
35
+ * (`serde = { version = "1", features = [...] }`).
36
+ * @param {unknown} value значення запису залежності
37
+ * @returns {string|null} specifier, або null для path/git-залежності (без номера версії)
38
+ */
39
+ export function extractCargoVersionSpec(value) {
40
+ if (typeof value === 'string') return value
41
+ if (value && typeof value === 'object' && !Array.isArray(value) && typeof value.version === 'string') {
42
+ return value.version
43
+ }
44
+ return null
45
+ }
46
+
47
+ /**
48
+ * Порівнює два розпарсені Cargo.toml і повертає зміни залежностей —
49
+ * той самий контракт, що й `diffPackageJson` у diff.mjs, лише для Cargo.
50
+ * @param {object} oldManifest розпарсений старий Cargo.toml (бекап)
51
+ * @param {object} newManifest розпарсений новий Cargo.toml
52
+ * @param {string} manifest відносний шлях Cargo.toml (мітка джерела запису)
53
+ * @returns {{major: Array<{manifest:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
54
+ */
55
+ export function diffCargoToml(oldManifest, newManifest, manifest) {
56
+ const major = []
57
+ let minorPatch = 0
58
+ for (const field of CARGO_DEP_FIELDS) {
59
+ const oldDeps = oldManifest?.[field]
60
+ const newDeps = newManifest?.[field]
61
+ if (!oldDeps || !newDeps) continue
62
+ for (const [crate, oldValue] of Object.entries(oldDeps)) {
63
+ const newValue = newDeps[crate]
64
+ if (newValue === undefined) continue
65
+ const from = extractCargoVersionSpec(oldValue)
66
+ const to = extractCargoVersionSpec(newValue)
67
+ if (from === null || to === null || from === to) continue
68
+ const fromV = parseCargoVersion(from)
69
+ const toV = parseCargoVersion(to)
70
+ if (fromV && toV && isBreaking(fromV, toV)) {
71
+ major.push({ manifest, pkg: crate, from, to })
72
+ } else {
73
+ minorPatch += 1
74
+ }
75
+ }
76
+ }
77
+ return { major, minorPatch }
78
+ }
79
+
80
+ /**
81
+ * Читає й парсить TOML-файл, або повертає null, якщо файл відсутній/невалідний.
82
+ * @param {string} path абсолютний шлях
83
+ * @returns {Promise<object|null>} розпарсений обʼєкт або null
84
+ */
85
+ async function readTomlOrNull(path) {
86
+ if (!existsSync(path)) return null
87
+ try {
88
+ return parseToml(await readFile(path, 'utf8'))
89
+ } catch {
90
+ return null
91
+ }
92
+ }
93
+
94
+ /**
95
+ * Збирає diff по всіх Cargo.toml монорепо: для кожного шляху зі списку
96
+ * порівнює `<manifest>` з `<manifest><backupSuffix>` — той самий контракт,
97
+ * що й `collectTazeDiff` для package.json.
98
+ * @param {string} cwd корінь репозиторію
99
+ * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
100
+ * @param {string} [backupSuffix] суфікс бекап-файлу
101
+ * @returns {Promise<{major: Array<{manifest:string, pkg:string, from:string, to:string}>, minorPatch:number, totalChanged:number, comparedManifests:number}>} агрегований diff
102
+ */
103
+ export async function collectCargoDiff(cwd, manifestPaths, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
104
+ const major = []
105
+ let minorPatch = 0
106
+ let comparedManifests = 0
107
+ for (const manifest of manifestPaths) {
108
+ const oldManifest = await readTomlOrNull(join(cwd, `${manifest}${backupSuffix}`))
109
+ const newManifest = await readTomlOrNull(join(cwd, manifest))
110
+ if (!oldManifest || !newManifest) continue
111
+ comparedManifests += 1
112
+ const res = diffCargoToml(oldManifest, newManifest, manifest)
113
+ major.push(...res.major)
114
+ minorPatch += res.minorPatch
115
+ }
116
+ return { major, minorPatch, totalChanged: major.length + minorPatch, comparedManifests }
117
+ }
@@ -0,0 +1,41 @@
1
+ ---
2
+ type: JS Module
3
+ title: cargo-diff.mjs
4
+ resource: npm/skills/taze/js/cargo-diff.mjs
5
+ docgen:
6
+ crc: afe20497
7
+ model: openai-codex/gpt-5.4-mini
8
+ tier: cloud-min
9
+ score: 100
10
+ issues: judge:inaccurate:0.99
11
+ judgeModel: openai-codex/gpt-5.4-mini
12
+ ---
13
+
14
+ ## Огляд
15
+
16
+ `package.json`
17
+
18
+ Файл читає версії з `Cargo.toml`, виділяє специфікації залежностей, порівнює дві версії маніфесту та збирає diff по змінах версій. Для монорепо проходить по списку `Cargo.toml` і агрегує результати для всіх знайдених маніфестів. Усі помилки перехоплює fail-safe: не кидає винятків назовні й за окремих збоїв повертає порожнє значення замість помилки.
19
+
20
+ ## Поведінка
21
+
22
+ - parseCargoVersion — виділяє версійну частину Cargo-специфікатора й повертає її як нормалізоване числове ядро; для не-версійних значень повертає null.
23
+ - extractCargoVersionSpec — дістає версійний specifier із запису залежності Cargo.toml; для path/git-залежностей без версії повертає null.
24
+ - diffCargoToml — порівнює два розпарсені Cargo.toml і визначає зміни залежностей, розділяючи їх на major та minor/patch.
25
+ - collectCargoDiff — проходить по списку Cargo.toml у монорепо, зіставляє кожен файл із його backup-файлом і збирає агрегований diff; якщо один із файлів відсутній або невалідний, пропускає його без падіння.
26
+
27
+ ## Публічний API
28
+
29
+ - Конфіги, на які спирається код: `package.json` — джерело списку залежностей і меж для порівняння змін.
30
+ - `parseCargoVersion` — розбирає Cargo-версійний specifier і заповнює відсутні частини нулями.
31
+ - `extractCargoVersionSpec` — дістає версію залежності з запису `Cargo.toml`, як з короткого рядка, так і з inline-таблиці.
32
+ - `diffCargoToml` — порівнює два розібрані `Cargo.toml` і повертає зміни по залежностях.
33
+ - `collectCargoDiff` — збирає diff для всіх `Cargo.toml` у монорепо, зіставляючи кожен маніфест із його backup-версією.
34
+
35
+ Changelog: не перевіряв — змін у файлах не вносив.
36
+
37
+ ## Гарантії поведінки
38
+
39
+ - Read-only: не виконує операцій запису (ФС/БД).
40
+ - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
41
+ - За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
@@ -6,5 +6,6 @@ resource: npm/skills/taze/js/
6
6
 
7
7
  | Файл | Тип |
8
8
  | --------------------------------- | --------- |
9
+ | [cargo-diff.mjs](cargo-diff.md) | JS Module |
9
10
  | [diff.mjs](diff.md) | JS Module |
10
11
  | [orchestrate.mjs](orchestrate.md) | JS Module |
@@ -3,9 +3,8 @@ type: JS Module
3
3
  title: orchestrate.mjs
4
4
  resource: npm/skills/taze/js/orchestrate.mjs
5
5
  docgen:
6
- crc: 37e2a3e9
6
+ crc: 1ff52a80
7
7
  model: openai-codex/gpt-5.4-mini
8
- tier: cloud-min
9
8
  score: 100
10
9
  issues: judge:inaccurate:0.98
11
10
  judgeModel: openai-codex/gpt-5.4-mini
@@ -5,6 +5,7 @@ import { copyFile, rm } from 'node:fs/promises'
5
5
  import { join } from 'node:path'
6
6
 
7
7
  import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
8
+ import { collectCargoDiff } from './cargo-diff.mjs'
8
9
  import { collectTazeDiff } from './diff.mjs'
9
10
 
10
11
  /** Суфікс бекапу package.json — той самий, що й у `diff.mjs`/кроці 1 SKILL.md. */
@@ -34,6 +35,30 @@ export function buildDependencyPrompt({ workspace, pkg, from, to }) {
34
35
  ].join('\n')
35
36
  }
36
37
 
38
+ /**
39
+ * Промпт ОДНОГО ітеративного виклику для Rust-крейта — Rust-варіант
40
+ * [`buildDependencyPrompt`] (кроки 4-6 SKILL.md, Rust-гілка), для ОДНОГО
41
+ * major-крейта. Кроки 1-3/7/8 виконує оркестратор детерміновано, без LLM.
42
+ * @param {{manifest: string, pkg: string, from: string, to: string}} entry запис major-diff (з `collectCargoDiff`)
43
+ * @returns {string} готовий промпт
44
+ */
45
+ export function buildCargoDependencyPrompt({ manifest, pkg, from, to }) {
46
+ return [
47
+ '# Major-оновлення одного Rust-крейта: перевірка сумісності й рефакторинг',
48
+ '',
49
+ `Крейт \`${pkg}\` у \`${manifest}\`: **${from} → ${to}** — вже застосовано в Cargo.toml/Cargo.lock (кроки 1-3 виконано детерміновано, без тебе). Твоя задача — лише breaking-changes-перевірка й, за потреби, рефакторинг.`,
50
+ '',
51
+ '## Кроки',
52
+ `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}-<стара-версія>/\`) і новою.`,
53
+ `2. Знайти використання зачепленого API в коді проєкту (\`rg -n --type rust\` по use-шляхах/викликах \`${pkg}\`).`,
54
+ '3. Сумісно — нічого не робити. Несумісно — застосувати міграцію (перейменувати use-шлях, оновити сигнатуру виклику, замінити видалений макрос еквівалентом).',
55
+ '4. Якщо були правки — запусти `cargo fmt --all -- --check`, `cargo clippy --all-targets --all-features -- -D warnings`, `cargo test`.',
56
+ '5. Нетривіальна/неоднозначна міграція — не вгадуй, залиш TODO-коментар із посиланням на CHANGELOG.',
57
+ '',
58
+ 'У відповіді одним абзацом підсумуй: сумісно / зрефакторено (які файли) / TODO (чому).'
59
+ ].join('\n')
60
+ }
61
+
37
62
  /**
38
63
  * Диспетчер одного ітеративного виклику на обраний раннер. `pi` — вбудований
39
64
  * pi-агент (`@7n/llm-lib/agent-skill`; текст перехоплюється через `deps.out`,
@@ -154,10 +179,54 @@ export async function cleanupBackups(cwd, workspaces, deps = {}) {
154
179
  }
155
180
 
156
181
  /**
157
- * Знаходить Cargo.toml поза node_modules/.worktrees/target (крок 0.2
158
- * SKILL.md). Лише інформаційно v1 оркестратора Rust-крейти не оновлює
159
- * (немає детермінованого cargo-diff-еквівалента `collectTazeDiff`,
160
- * класифікація major там ручна за SKILL.md).
182
+ * Чи встановлений cargo-edit (дає `cargo upgrade`) — без нього неможливо
183
+ * детерміновано перетнути major-межу Rust-залежностей (голий `cargo update`
184
+ * піднімає лише semver-сумісні версії; SKILL.md §Передумови).
185
+ * @param {typeof spawnSync} spawnFn інжект для тестів
186
+ * @returns {boolean} true — `cargo upgrade` доступна
187
+ */
188
+ function hasCargoEdit(spawnFn) {
189
+ return spawnFn('cargo', ['upgrade', '--version'], { encoding: 'utf8' }).status === 0
190
+ }
191
+
192
+ /**
193
+ * Бекапить кожен Cargo.toml + спільний кореневий Cargo.lock (крок 1 SKILL.md,
194
+ * Rust-гілка). v1: один спільний workspace/Cargo.lock у корені `cwd` —
195
+ * поточна реальна топологія репо (кореневий `Cargo.toml` з `[workspace]` +
196
+ * члени); кілька незалежних Cargo-workspace під час не підтримується.
197
+ * @param {string} cwd корінь репо
198
+ * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
199
+ * @param {{ copyFile?: (src: string, dest: string) => Promise<void> }} [deps] інжект
200
+ * @returns {Promise<void>}
201
+ */
202
+ export async function backupCargoManifests(cwd, manifestPaths, deps = {}) {
203
+ const copy = deps.copyFile ?? copyFile
204
+ for (const manifest of manifestPaths) {
205
+ const manifestPath = join(cwd, manifest)
206
+ if (existsSync(manifestPath)) await copy(manifestPath, `${manifestPath}${BACKUP_SUFFIX}`)
207
+ }
208
+ const lockPath = join(cwd, 'Cargo.lock')
209
+ if (existsSync(lockPath)) await copy(lockPath, `${lockPath}${BACKUP_SUFFIX}`)
210
+ }
211
+
212
+ /**
213
+ * Прибирає бекапи Cargo.toml/Cargo.lock після завершення (крок 7 SKILL.md,
214
+ * Rust-гілка).
215
+ * @param {string} cwd корінь репо
216
+ * @param {string[]} manifestPaths відносні шляхи Cargo.toml (з `findCargoManifests`)
217
+ * @param {{ rm?: (path: string, opts?: object) => Promise<void> }} [deps] інжект
218
+ * @returns {Promise<void>}
219
+ */
220
+ export async function cleanupCargoBackups(cwd, manifestPaths, deps = {}) {
221
+ const remove = deps.rm ?? rm
222
+ for (const manifest of manifestPaths) {
223
+ await remove(join(cwd, `${manifest}${BACKUP_SUFFIX}`), { force: true })
224
+ }
225
+ await remove(join(cwd, `Cargo.lock${BACKUP_SUFFIX}`), { force: true })
226
+ }
227
+
228
+ /**
229
+ * Знаходить Cargo.toml поза node_modules/.worktrees/target (крок 0.2 SKILL.md).
161
230
  * @param {string} cwd корінь репо
162
231
  * @param {{ spawnFn?: typeof spawnSync }} [deps] інжект
163
232
  * @returns {string[]} відносні шляхи знайдених Cargo.toml
@@ -188,13 +257,36 @@ export function findCargoManifests(cwd, deps = {}) {
188
257
  .filter(Boolean)
189
258
  }
190
259
 
260
+ /**
261
+ * Форматує один рядок результату ітерації (спільний для npm- і Rust-гілки).
262
+ * @param {{pkg: string, ok: boolean, error: string|null, from: string, to: string}} r результат ітерації
263
+ * @param {string} scopeLabel мітка джерела (`workspace` для npm, `manifest` для Rust)
264
+ * @returns {string} один рядок звіту
265
+ */
266
+ function formatResultLine(r, scopeLabel) {
267
+ const status = r.ok ? '✅' : '❌'
268
+ const errorSuffix = r.error ? ` — ${r.error}` : ''
269
+ return ` ${status} \`${r.pkg}\` (${scopeLabel}): ${r.from} → ${r.to}${errorSuffix}`
270
+ }
271
+
191
272
  /**
192
273
  * Компонує підсумковий звіт (крок 8 SKILL.md) детерміновано з результатів
193
274
  * ітерацій — без окремого LLM-виклику для самого звіту.
194
- * @param {{ minorPatch: number, totalChanged: number, results: Array<{pkg:string, workspace:string, from:string, to:string, ok:boolean, error:string|null}>, rustCrates: string[] }} args дані звіту
275
+ * @param {{
276
+ * minorPatch: number,
277
+ * totalChanged: number,
278
+ * results: Array<{pkg:string, workspace:string, from:string, to:string, ok:boolean, error:string|null}>,
279
+ * rust: {
280
+ * manifests: string[],
281
+ * processed: boolean,
282
+ * skippedReason: string|null,
283
+ * minorPatch: number,
284
+ * results: Array<{pkg:string, manifest:string, from:string, to:string, ok:boolean, error:string|null}>
285
+ * }
286
+ * }} args дані звіту
195
287
  * @returns {string} markdown-звіт
196
288
  */
197
- export function formatReport({ minorPatch, totalChanged, results, rustCrates }) {
289
+ export function formatReport({ minorPatch, totalChanged, results, rust }) {
198
290
  const lines = [
199
291
  '## taze: підсумок',
200
292
  '',
@@ -202,17 +294,26 @@ export function formatReport({ minorPatch, totalChanged, results, rustCrates })
202
294
  `- **Major-оновлення:** ${results.length}`
203
295
  ]
204
296
  for (const r of results) {
205
- const status = r.ok ? '✅' : '❌'
206
- const errorSuffix = r.error ? ` — ${r.error}` : ''
207
- lines.push(` ${status} \`${r.pkg}\` (${r.workspace}): ${r.from} → ${r.to}${errorSuffix}`)
297
+ lines.push(formatResultLine(r, r.workspace))
208
298
  }
209
- if (rustCrates.length > 0) {
210
- lines.push(
211
- '',
212
- `- **Rust-крейти (${rustCrates.length}), потребують ручного прогону Rust-гілки SKILL.md:** ${rustCrates.join(', ')}`
213
- )
299
+
300
+ let rustTotalChanged = 0
301
+ if (rust.manifests.length > 0) {
302
+ lines.push('', '### Rust-крейти')
303
+ if (rust.processed) {
304
+ lines.push(`- **Оновлено (minor/patch):** ${rust.minorPatch}`, `- **Major-оновлення:** ${rust.results.length}`)
305
+ for (const r of rust.results) {
306
+ lines.push(formatResultLine(r, r.manifest))
307
+ }
308
+ rustTotalChanged = rust.minorPatch + rust.results.length
309
+ } else {
310
+ lines.push(
311
+ `- ⏭ Пропущено (${rust.skippedReason}) — ${rust.manifests.length} Cargo.toml, онови вручну за Rust-гілкою SKILL.md: ${rust.manifests.join(', ')}`
312
+ )
313
+ }
214
314
  }
215
- lines.push('', `- **Всього змінено:** ${totalChanged}`)
315
+
316
+ lines.push('', `- **Всього змінено:** ${totalChanged + rustTotalChanged}`)
216
317
  return lines.join('\n')
217
318
  }
218
319
 
@@ -227,9 +328,9 @@ export function formatReport({ minorPatch, totalChanged, results, rustCrates })
227
328
  * cwd?: string,
228
329
  * runner?: 'pi' | 'cursor' | 'codex',
229
330
  * log?: (line: string) => void,
230
- * 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}> } & Record<string, unknown>
331
+ * deps?: { spawnFn?: typeof spawnSync, collectTazeDiff?: (cwd: string) => Promise<object>, collectCargoDiff?: (cwd: string, manifests: string[]) => Promise<object>, callRunner?: (runner: string, prompt: string, cwd: string, deps: object) => Promise<{ok: boolean, text: string, error: string|null}> } & Record<string, unknown>
231
332
  * }} [options] опції + інжекти для тестів
232
- * @returns {Promise<{ ok: boolean, report: string, results: Array<object> }>} результат
333
+ * @returns {Promise<{ ok: boolean, report: string, results: Array<object>, rustResults: Array<object> }>} результат
233
334
  */
234
335
  export async function runTazeOrchestrator(options = {}) {
235
336
  const cwd = options.cwd ?? process.cwd()
@@ -237,11 +338,10 @@ export async function runTazeOrchestrator(options = {}) {
237
338
  const log = options.log ?? (line => console.log(line))
238
339
  const deps = options.deps ?? {}
239
340
  const spawnFn = deps.spawnFn ?? spawnSync
341
+ const call = deps.callRunner ?? callRunner
240
342
 
241
343
  assertRunningInWorktree(cwd, spawnFn)
242
344
 
243
- const rustCrates = findCargoManifests(cwd, { spawnFn })
244
-
245
345
  log('📦 Бекап package.json...')
246
346
  const backedUpWorkspaces = await backupWorkspacePackageFiles(cwd, deps)
247
347
 
@@ -255,7 +355,6 @@ export async function runTazeOrchestrator(options = {}) {
255
355
  log(`🔍 diff: ${diff.major.length} major, ${diff.minorPatch} minor/patch`)
256
356
 
257
357
  const results = []
258
- const call = deps.callRunner ?? callRunner
259
358
  for (const entry of diff.major) {
260
359
  log(`🔧 ${entry.pkg} (${entry.workspace}): ${entry.from} → ${entry.to}...`)
261
360
  const outcome = await call(runner, buildDependencyPrompt(entry), cwd, deps)
@@ -265,8 +364,47 @@ export async function runTazeOrchestrator(options = {}) {
265
364
 
266
365
  await cleanupBackups(cwd, backedUpWorkspaces, deps)
267
366
 
268
- const report = formatReport({ minorPatch: diff.minorPatch, totalChanged: diff.totalChanged, results, rustCrates })
367
+ const rustManifests = findCargoManifests(cwd, { spawnFn })
368
+ let rust = { manifests: rustManifests, processed: false, skippedReason: null, minorPatch: 0, results: [] }
369
+
370
+ if (rustManifests.length > 0 && !hasCargoEdit(spawnFn)) {
371
+ rust.skippedReason =
372
+ 'cargo-edit не встановлено (`cargo install cargo-edit`) — cargo update без нього недетермінований для major'
373
+ log(`⏭ Rust: ${rust.skippedReason}`)
374
+ } else if (rustManifests.length > 0) {
375
+ log('📦 Бекап Cargo.toml/Cargo.lock...')
376
+ await backupCargoManifests(cwd, rustManifests, deps)
377
+
378
+ log('⬆️ cargo upgrade --incompatible allow...')
379
+ runCommand('cargo', ['upgrade', '--incompatible', 'allow'], cwd, spawnFn)
380
+ log('🔄 cargo update...')
381
+ runCommand('cargo', ['update'], cwd, spawnFn)
382
+
383
+ const collectCargo = deps.collectCargoDiff ?? collectCargoDiff
384
+ const cargoDiff = await collectCargo(cwd, rustManifests)
385
+ log(`🔍 Rust diff: ${cargoDiff.major.length} major, ${cargoDiff.minorPatch} minor/patch`)
386
+
387
+ const rustResults = []
388
+ for (const entry of cargoDiff.major) {
389
+ log(`🔧 [rust] ${entry.pkg} (${entry.manifest}): ${entry.from} → ${entry.to}...`)
390
+ const outcome = await call(runner, buildCargoDependencyPrompt(entry), cwd, deps)
391
+ rustResults.push({ ...entry, ...outcome })
392
+ log(outcome.ok ? ` ✅ ${entry.pkg}` : ` ❌ ${entry.pkg}: ${outcome.error}`)
393
+ }
394
+
395
+ await cleanupCargoBackups(cwd, rustManifests, deps)
396
+
397
+ rust = {
398
+ manifests: rustManifests,
399
+ processed: true,
400
+ skippedReason: null,
401
+ minorPatch: cargoDiff.minorPatch,
402
+ results: rustResults
403
+ }
404
+ }
405
+
406
+ const report = formatReport({ minorPatch: diff.minorPatch, totalChanged: diff.totalChanged, results, rust })
269
407
  log(report)
270
408
 
271
- return { ok: results.every(r => r.ok), report, results }
409
+ return { ok: results.every(r => r.ok) && rust.results.every(r => r.ok), report, results, rustResults: rust.results }
272
410
  }