@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 +6 -0
- package/package.json +1 -1
- package/skills/taze/SKILL.md +13 -11
- package/skills/taze/js/cargo-diff.mjs +117 -0
- package/skills/taze/js/docs/cargo-diff.md +41 -0
- package/skills/taze/js/docs/index.md +1 -0
- package/skills/taze/js/docs/orchestrate.md +1 -2
- package/skills/taze/js/orchestrate.mjs +160 -22
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
package/skills/taze/SKILL.md
CHANGED
|
@@ -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
|
|
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
|
-
|
|
28
|
-
|
|
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
|
-
один
|
|
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`) —
|
|
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
|
|
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`) замість винятку.
|
|
@@ -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:
|
|
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
|
-
*
|
|
158
|
-
*
|
|
159
|
-
*
|
|
160
|
-
*
|
|
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 {{
|
|
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,
|
|
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
|
-
|
|
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
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
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
|
-
|
|
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
|
|
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
|
}
|