@7n/rules 1.48.2 → 1.49.0

package/skills/git-reconcile/main.json

@@ -0,0 +1 @@
+{ "requireRoot": true, "tier": "max" }

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

@@ -3,36 +3,58 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/skills/taze/js/orchestrate.mjs
 docgen:
-  crc: 63cee070
+  crc: 6b0cfb17
   model: openai-codex/gpt-5.4-mini
-  score: 100
-  issues: judge:inaccurate:0.98
+  tier: cloud-min
+  score: 80
+  issues: internal-name:assertEcosystemProvider,internal-name:resolvePlugins,judge-refine:kept-original,judge:inaccurate:0.97
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Оркеструє taze як чистий цикл по EcosystemProvider-ах (фаза 5a spec lang-plugins-extraction: ядро — двигун без мовної специфіки). ВСІ екосистеми, включно з npm/bun (`@7n/rules-lang-js`), приходять з плагінів (extension-point `taze`): для кожного провайдера — detect → available → backup → bump → diff, далі по одному ізольованому виклику раннера на кожен major-запис (`promptFor` провайдера), потім cleanup і композиція Markdown-звіту. Виконує файлові операції і запускає зовнішні команди (git, npx для worktree-бутстрапу, команди провайдерів) — не read-only.
+Модуль запускає taze-орchestrator, підключає доступних provider-ів, формує звіт і координує один прогін у межах поточного запуску. Його роль — дати єдину точку входу для запуску, де `callRunner`, `loadPluginTazeProviders`, `formatReport` і `runTazeOrchestrator` працюють узгоджено, а результати можна повторно використовувати в межах прогону. Обробка помилок fail-safe: винятки не виходять назовні, а стан прогону кешується на час виконання.
 
 ## Поведінка
 
-- **callRunner** — диспетчер одного ітеративного виклику: `pi` — вбудований pi-агент (текст через `deps.out`), `cursor`/`codex` — napi-міст ACP (`@7n/llm-lib/acp`).
-- **loadPluginTazeProviders** — завантажує провайдерів з активних плагінів: `.n-rules.json`/автодетект → `resolvePlugins` (плагін доставляється автоматично при першому запуску) → handler-модулі extension-point `taze` → валідація `assertEcosystemProvider`; битий плагін — warning і пропуск, не провал.
-- **formatReport** — Markdown-звіт: рівноправна секція на кожну екосистему з manifests (без manifests — тиша) + загальний підсумок; без окремого LLM-виклику.
-- **runTazeOrchestrator** — повний прогін: гарантує ізольований worktree (авто-створює `<branch>-taze` через `npx @7n/mt worktree create`, після завершення переносить зміни назад і прибирає авто-створене дерево), проганяє кожного провайдера наскрізь і повертає `{ ok, report, ecosystems }`. Без жодного taze-провайдера — попередження (для npm/bun-гілки потрібен `@7n/rules-lang-js`).
-- **bringChangesBackToOriginal** / **removeAutoCreatedWorktree** — перенесення незакомічених змін з авто-створеного worktree у вихідне дерево і його прибирання.
+runTazeOrchestrator запускає спільний цикл для всіх доступних екосистем, збирає провайдерів через loadPluginTazeProviders або бере їх із інжектів, далі для кожної екосистеми зберігає проміжний стан, виконує оновлення пакетів, ізолює виклики для кожного major-стрибка через callRunner і не дає збою одного пакета зупинити решту прогону. Дані для роботи беруться з конфігурації проєкту та сигналів репозиторію, зокрема .n-rules.json і package.json, а результатом стає структурований звіт разом зі зведенням по екосистемах. У межах одного запуску зберігається кеш, щоб повторно використовувати вже підняті дані та не дублювати одні й ті самі перевірки.
+
+loadPluginTazeProviders підтягує плагінні провайдери екосистем, відсіює биті або невалідні модулі й повертає лише ті, що придатні до роботи, не валячи весь прогін через проблему в одному плагіні. Цей список стає джерелом для runTazeOrchestrator, тож плагіни визначають, які екосистеми взагалі потрапляють у цикл обробки.
+
+callRunner виконує один ізольований прогін обраного runner-а для окремого пакета або пакета-міграції, повертаючи не лише успіх, а й текстовий результат або помилку для включення в підсумок. Його вихід напряму живить проміжні кроки runTazeOrchestrator і визначає, чи запис піде в успішні зміни, чи в fail-safe-обробку без падіння всього процесу.
+
+formatReport збирає фінальний markdown-звіт із накопичених результатів усіх екосистем, зберігаючи детермінований порядок і однакове представлення для успішних, пропущених і проблемних записів. Цей звіт стає фінальним артефактом runTazeOrchestrator і не залежить від окремого LLM-виклику для формування самої форми підсумку.
 
 ## Публічний API
 
-- callRunner — виклик обраного раннера (`pi`/`cursor`/`codex`) з одним промптом.
-- loadPluginTazeProviders — валідні EcosystemProvider-и з handler-модулів плагінів.
-- formatReport — фінальний Markdown-звіт із записів екосистем.
-- runTazeOrchestrator — повна оркестрація taze; `deps.ecosystemProviders` повністю замінює список провайдерів (для тестів).
-- bringChangesBackToOriginal / removeAutoCreatedWorktree — життєвий цикл авто-створеного worktree.
+- callRunner — Диспетчер одного ітеративного виклику на обраний раннер. `pi` — вбудований
+pi-агент (`@7n/llm-lib/agent-skill`; текст перехоплюється через `deps.out`,
+бо `runAgentSkill` не повертає його напряму — лише стрімить у stdout).
+`cursor`/`codex` — napi-міст ACP (`@7n/llm-lib/acp`; текст — прямий return,
+idle-timeout і видимість прогресу вже вбудовані в сам міст). Тір `avg`
+(рішення И/Ф3, задача T7) — паритет з pi-гілкою: `runAcpAgent` резолвить
+tier→env/args/post-session-config у Rust, а не бере модель з персонального
+CLI-конфіга на машині.
+- loadPluginTazeProviders — Завантажує EcosystemProvider-и з активних плагінів проєкту: `.n-rules.json`
+(або автодетект за файловими сигналами — `pyproject.toml` → lang-python) →
+`resolvePlugins` (плагін доставляється автоматично при першому запуску) → handler-модулі
+extension-point `taze` → default-експорт кожного валідується
+`assertEcosystemProvider`. Битий плагін (нема модуля/невалідна форма) —
+warning і пропуск, не провал прогону.
+- formatReport — Компонує підсумковий звіт (крок 8 SKILL.md) детерміновано з результатів
+ітерацій — без окремого LLM-виклику для самого звіту. Усі екосистеми
+(включно з npm/bun — плагін `@7n/rules-lang-js`, фаза 5a) — рівноправні
+секції; екосистема без manifests — тиша.
+- runTazeOrchestrator — Оркеструє taze: чистий цикл по EcosystemProvider-ах (кроки 1-3/7/8 —
+детерміновано в провайдері, кроки 4-6 — по одному ізольованому виклику
+`callRunner` на кожен major-запис) замість одного величезного непрозорого
+ходу на весь монорепо. Ядро — двигун без мовної специфіки (фаза 5a spec):
+ВСІ екосистеми, включно з npm/bun (`@7n/rules-lang-js`), приходять з
+плагінів (extension-point `taze`). Падіння одного пакета/однієї екосистеми
+не втрачає прогрес по інших.
 
 ## Гарантії поведінки
 
-- Виконує файлові операції і запускає зовнішні команди — НЕ read-only.
-- Кроки оркестрації виконуються лише в ізольованому worktree; авто-створене дерево прибирається у `finally` навіть при винятку, зміни переносяться назад.
-- Виняток усередині одного провайдера (bump/diff/команда) не зупиняє інших — фіксується в `error` запису екосистеми й у звіті; `ok` результату тоді false.
-- Падіння одного пакета в ізольованому виклику раннера не втрачає прогрес по інших записах.
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Кешує результати в межах одного прогону.

package/skills/taze/js/orchestrate.mjs

@@ -20,11 +20,14 @@ export { bringChangesBackToOriginal, removeAutoCreatedWorktree } from '../../../
  * pi-агент (`@7n/llm-lib/agent-skill`; текст перехоплюється через `deps.out`,
  * бо `runAgentSkill` не повертає його напряму — лише стрімить у stdout).
  * `cursor`/`codex` — napi-міст ACP (`@7n/llm-lib/acp`; текст — прямий return,
- * idle-timeout і видимість прогресу вже вбудовані в сам міст).
+ * idle-timeout і видимість прогресу вже вбудовані в сам міст). Тір `avg`
+ * (рішення И/Ф3, задача T7) — паритет з pi-гілкою: `runAcpAgent` резолвить
+ * tier→env/args/post-session-config у Rust, а не бере модель з персонального
+ * CLI-конфіга на машині.
  * @param {'pi' | 'cursor' | 'codex'} runner раннер
  * @param {string} prompt промпт для одного пакета
  * @param {string} cwd робочий каталог
- * @param {{ runAgentSkill?: (prompt: string, opts?: object) => Promise<{ok: boolean, error: string|null}>, runAcpAgent?: (kind: string, prompt: string, cwd: string) => Promise<string> }} [deps] інжекти для тестів
+ * @param {{ runAgentSkill?: (prompt: string, opts?: object) => Promise<{ok: boolean, error: string|null}>, runAcpAgent?: (kind: string, prompt: string, cwd: string, opts?: {tier?: string}) => Promise<string> }} [deps] інжекти для тестів
  * @returns {Promise<{ ok: boolean, text: string, error: string|null }>} результат виклику
  */
 export async function callRunner(runner, prompt, cwd, deps = {}) {
@@ -50,7 +53,7 @@ export async function callRunner(runner, prompt, cwd, deps = {}) {
     runAcpAgent = acpModule.runAcpAgent
   }
   try {
-    const text = await runAcpAgent(runner, prompt, cwd)
+    const text = await runAcpAgent(runner, prompt, cwd, { tier: 'avg' })
     return { ok: true, text, error: null }
   } catch (error) {
     return { ok: false, text: '', error: error instanceof Error ? error.message : String(error) }