@7n/rules 1.24.0 → 1.25.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.25.1] - 2026-07-19
+
+### Fixed
+
+- мінімальний @7n/llm-lib піднято до ^2.8.2 — діапазон ^2.7.0 допускав версії з видаленим у pi-coding-agent 0.80.10 API (ModelRegistry.create/AuthStorage), що системно валило doc-files та інші LLM-ланцюжки (registry: Cannot read properties of undefined (reading 'create'))
+
+## [1.25.0] - 2026-07-19
+
+### Added
+
+- taze: по завершенню переносить зміни з автоствореного worktree назад у вихідне дерево (untracked) і прибирає worktree
+- lint --full: worktree-only гейт (auto-create + bring-back + cleanup), спільна логіка з taze винесена у scripts/lib/auto-worktree.mjs
+
 ## [1.24.0] - 2026-07-19
 
 ### Added

package/bin/n-rules.js

@@ -84,6 +84,11 @@ import {
   RULE_MIGRATIONS
 } from '../scripts/auto-rules.mjs'
 import { detectAutoSkills } from '../scripts/auto-skills.mjs'
+import {
+  bringChangesBackToOriginal,
+  ensureRunningInWorktree,
+  removeAutoCreatedWorktree
+} from '../scripts/lib/auto-worktree.mjs'
 import { readSkillMetaRaw } from '../scripts/lib/skill-meta.mjs'
 import { injectWorktreeNotice } from '../scripts/lib/worktree-notice.mjs'
 import { collectSkillFragments, injectSkillFragments } from '../scripts/lib/skill-fragments.mjs'
@@ -1812,28 +1817,55 @@ try {
           baseRef
         }
         const noFix = args.includes('--no-fix')
+        // `--full` без `--no-fix` мутує ВЕСЬ репо (не лише дельту) — той самий клас
+        // ризику, що й taze: якщо запущено поза .worktrees/, треба ізолювати. `--no-fix`
+        // (detect-only, нуль мутацій) і не-full (дельта, за дизайном працює на живому
+        // дереві задачі, worktree-ізоляція зламала б саму суть дельти) — пропускаємо.
+        const needsWorktreeIsolation = full && !noFix
+        const worktree = needsWorktreeIsolation
+          ? ensureRunningInWorktree(cwdArg, spawnSync, line => console.log(line), {
+              suffix: 'lint',
+              description: 'n-rules lint --full: worktree-only full-repo run'
+            })
+          : { cwd: cwdArg, autoCreated: false, branchArg: null }
+        const runCwd = worktree.cwd
         // Глобальна черга full-прогонів (spec 2026-07-03): одночасно виконується один
         // `lint --full` на машину, паралельні --full чекають лока і бачать чергу та
         // живий прогрес активного прогону; не-full запуски йдуть без лока
         // (див. lint-lock.mjs). Publisher пише знімки прогресу для черги.
         const { withGlobalLintLock, createProgressPublisher } =
           await import('../scripts/lib/lint-surface/lint-lock.mjs')
-        process.exitCode = await withGlobalLintLock({ ...lintOpts, noFix }, async () => {
-          const publisher = lintOpts.full ? createProgressPublisher() : null
-          const runOpts = publisher ? { ...lintOpts, onProgress: publisher.onUpdate } : lintOpts
-          try {
-            if (noFix) {
-              const { detectAll } = await import('../scripts/lib/lint-surface/run-detectors.mjs')
-              // окрема змінна замість (await detectAll(...)).exitCode — no-await-expression-member (oxlint)
-              const detectResult = await detectAll(runOpts)
-              return detectResult.exitCode
+        try {
+          process.exitCode = await withGlobalLintLock({ ...lintOpts, cwd: runCwd, noFix }, async () => {
+            const runOpts = { ...lintOpts, cwd: runCwd }
+            const publisher = runOpts.full ? createProgressPublisher() : null
+            if (publisher) runOpts.onProgress = publisher.onUpdate
+            try {
+              if (noFix) {
+                const { detectAll } = await import('../scripts/lib/lint-surface/run-detectors.mjs')
+                // окрема змінна замість (await detectAll(...)).exitCode — no-await-expression-member (oxlint)
+                const detectResult = await detectAll(runOpts)
+                return detectResult.exitCode
+              }
+              const { runFixPipeline } = await import('../scripts/lib/lint-surface/run-fix.mjs')
+              return await runFixPipeline(runOpts)
+            } finally {
+              publisher?.stop()
+            }
+          })
+        } finally {
+          // Лише для АВТОстворених worktree (лінт уже сидів у своєму — не наш, не чіпаємо).
+          if (worktree.autoCreated) {
+            try {
+              await bringChangesBackToOriginal(runCwd, cwdArg, spawnSync, line => console.log(line))
+            } catch (error) {
+              console.log(
+                `⚠️ Перенесення змін назад провалилось: ${error instanceof Error ? error.message : String(error)}`
+              )
             }
-            const { runFixPipeline } = await import('../scripts/lib/lint-surface/run-fix.mjs')
-            return await runFixPipeline(runOpts)
-          } finally {
-            publisher?.stop()
+            removeAutoCreatedWorktree(worktree.branchArg, cwdArg, spawnSync, line => console.log(line))
           }
-        })
+        }
 
         break
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.24.0",
+  "version": "1.25.1",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",
@@ -64,7 +64,7 @@
     "rename-yaml-extensions": "bun ./bin/n-rules.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@7n/llm-lib": "^2.7.0",
+    "@7n/llm-lib": "^2.8.2",
     "@7n/mt": "^0.5.1",
     "@zed-industries/agent-client-protocol": "^0.4.5",
     "ajv": "^8.20.0",

package/scripts/lib/auto-worktree.mjs

@@ -0,0 +1,157 @@
+/** @see ./docs/auto-worktree.md */
+import { existsSync } from 'node:fs'
+import { copyFile, mkdir, rm } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+
+/**
+ * Гарантує, що подальші кроки виконуються в ізольованому worktree
+ * (`main.json.worktree: true`-контракт), навіть коли викликач — детермінований
+ * JS-код, що не годує SKILL.md жодному LLM-агенту (тож агентський preflight-блок
+ * з `worktree-notice.mjs` нікому виконувати). Якщо `cwd` вже під `.worktrees/` —
+ * повертає його без змін. Інакше сам створює `.worktrees/<branch>-<suffix>`
+ * (`npx \@7n/mt worktree create`) і ставить залежності (`bun install`).
+ *
+ * **Гейт на чисте дерево.** Auto-create читає стан і потім переносить зміни
+ * назад копіюванням файлів (`bringChangesBackToOriginal`) — а не git merge.
+ * Якщо у вихідному `cwd` вже є незакомічені зміни, вони НЕ потраплять у щойно
+ * створений worktree (той — checkout HEAD), і перенесення назад мовчки
+ * затерло б їх версією з worktree. Тому за замовчуванням (`requireCleanTree:
+ * true`) auto-create кидає на брудному дереві замість ризикувати чужими
+ * незакоміченими правками. Викликач, що гарантує чистоту дерева сам (наприклад
+ * taze — SKILL.md вимагає цього як передумову ще ДО виклику), може передати
+ * `requireCleanTree: false`, щоб не платити за зайву git-команду.
+ * @param {string} cwd каталог для перевірки
+ * @param {typeof import('node:child_process').spawnSync} spawnFn інжект для тестів
+ * @param {(line: string) => void} log колбек прогресу
+ * @param {{ suffix: string, description: string, requireCleanTree?: boolean }} opts `suffix` — коротка (до 10 символів) назва задачі для `<branch>-<suffix>`; `description` — текст для `npx \@7n/mt worktree create`
+ * @returns {{ cwd: string, autoCreated: boolean, branchArg: string|null }} `autoCreated: false` — `cwd` без змін
+ *   (вже worktree); `autoCreated: true` — `cwd` щойно створеного worktree і `branchArg`, з яким його створено
+ */
+export function ensureRunningInWorktree(cwd, spawnFn, log, { suffix, description, requireCleanTree = true }) {
+  const toplevelResult = spawnFn('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
+  const toplevel = toplevelResult.status === 0 ? toplevelResult.stdout.trim() : ''
+  const segments = new Set(toplevel.replaceAll('\\', '/').split('/'))
+  if (segments.has('.worktrees')) return { cwd, autoCreated: false, branchArg: null }
+
+  const branchResult = spawnFn('git', ['branch', '--show-current'], { cwd, encoding: 'utf8' })
+  const currentBranch = branchResult.status === 0 ? branchResult.stdout.trim() : ''
+  if (!currentBranch) {
+    throw new Error(
+      `"${cwd}" не в ізольованому worktree (git toplevel: "${toplevel || '?'}"), і поточну гілку визначити не вдалось ` +
+        '(detached HEAD?) — автоматичне створення worktree за конвенцією `<current-branch>-<suffix>` неможливе. Перейди на гілку вручну.'
+    )
+  }
+
+  if (requireCleanTree) {
+    const statusResult = spawnFn('git', ['status', '--porcelain'], { cwd, encoding: 'utf8' })
+    if (statusResult.status === 0 && statusResult.stdout.trim().length > 0) {
+      throw new Error(
+        `"${cwd}" не в ізольованому worktree і має незакомічені зміни — auto-create worktree тут НЕБЕЗПЕЧНИЙ: ` +
+          'перенесення результату назад копіюванням файлів затерло б ці незакомічені правки версією зі свіжого ' +
+          'checkout (worktree = HEAD, без твоїх правок). Закомить/застеш зміни або створи worktree вручну.'
+      )
+    }
+  }
+
+  const branchArg = `${currentBranch}-${suffix}`
+  const pathSegment = branchArg.replaceAll('/', '-')
+  log(`⚠️ "${cwd}" не в ізольованому worktree — створюю ".worktrees/${pathSegment}"...`)
+  runCommand('npx', ['@7n/mt', 'worktree', 'create', branchArg, description], cwd, spawnFn)
+
+  const newCwd = join(cwd, '.worktrees', pathSegment)
+  log('📥 bun install (bootstrap нового дерева)...')
+  runCommand('bun', ['install'], newCwd, spawnFn)
+  return { cwd: newCwd, autoCreated: true, branchArg }
+}
+
+/**
+ * Переносить зміни з автоствореного worktree назад у вихідне дерево як
+ * **untracked/незакомічені** правки (просте копіювання файлів, без git
+ * merge/cherry-pick). Джерело істини — `git status --porcelain` у worktree:
+ * для кожного шляху копіює файл, якщо він існує (модифікація/додавання), або
+ * видаляє його у вихідному дереві, якщо existsSync каже, що в worktree його
+ * вже нема (видалення). Перейменування (`old -> new` у porcelain) переносять
+ * лише нову назву — стара лишається як була, прийнятний компроміс для
+ * інструментів, що самі файли не перейменовують (ефект можливий лише як
+ * побічний результат LLM-рефакторингу чи форматера).
+ * @param {string} worktreeCwd автостворений worktree, з якого переносимо
+ * @param {string} originalCwd вихідне дерево, куди переносимо
+ * @param {typeof import('node:child_process').spawnSync} spawnFn інжект для тестів
+ * @param {(line: string) => void} log колбек прогресу
+ * @param {{ copyFile?: (src: string, dest: string) => Promise<void>, rm?: (path: string, opts?: object) => Promise<void>, mkdir?: (path: string, opts?: object) => Promise<void> }} [deps] інжекти для тестів
+ * @returns {Promise<string[]>} відносні шляхи перенесених файлів
+ */
+export async function bringChangesBackToOriginal(worktreeCwd, originalCwd, spawnFn, log, deps = {}) {
+  const copy = deps.copyFile ?? copyFile
+  const removeFile = deps.rm ?? rm
+  const makeDir = deps.mkdir ?? mkdir
+
+  const statusResult = spawnFn('git', ['status', '--porcelain'], { cwd: worktreeCwd, encoding: 'utf8' })
+  if (statusResult.status !== 0) {
+    log(
+      `⚠️ Не вдалось прочитати git status у "${worktreeCwd}" — зміни НЕ перенесені назад, worktree лишиться для ручного розбору.`
+    )
+    return []
+  }
+
+  const lines = statusResult.stdout.split('\n').filter(Boolean)
+  if (lines.length === 0) {
+    log('ℹ️ Worktree без змін — нічого переносити назад.')
+    return []
+  }
+
+  const brought = []
+  for (const line of lines) {
+    const rest = line.slice(3)
+    const relPath = rest.includes(' -> ') ? rest.split(' -> ', 2)[1] : rest
+    const srcPath = join(worktreeCwd, relPath)
+    const destPath = join(originalCwd, relPath)
+    if (existsSync(srcPath)) {
+      await makeDir(dirname(destPath), { recursive: true })
+      await copy(srcPath, destPath)
+    } else {
+      await removeFile(destPath, { force: true })
+    }
+    brought.push(relPath)
+  }
+  log(`📤 Перенесено назад у "${originalCwd}" як untracked: ${brought.join(', ')}`)
+  return brought
+}
+
+/**
+ * Прибирає автостворений worktree разом з його ефемерною git-гілкою
+ * (`npx \@7n/mt worktree remove <branch>`) — викликати лише ПІСЛЯ
+ * `bringChangesBackToOriginal`, інакше зміни згорять разом з деревом.
+ * Не кидає при провалі — це прибирання, а не крок, від якого залежить
+ * результат прогону; провал лише логується, worktree лишається для
+ * ручного розбору.
+ * @param {string} branchArg гілка, з якою worktree був створений (з `ensureRunningInWorktree`)
+ * @param {string} originalCwd вихідне дерево, звідки виконати `npx \@7n/mt worktree remove`
+ * @param {typeof import('node:child_process').spawnSync} spawnFn інжект для тестів
+ * @param {(line: string) => void} log колбек прогресу
+ * @returns {void}
+ */
+export function removeAutoCreatedWorktree(branchArg, originalCwd, spawnFn, log) {
+  log(`🧹 Прибираю автостворений worktree "${branchArg}"...`)
+  const result = spawnFn('npx', ['@7n/mt', 'worktree', 'remove', branchArg], { cwd: originalCwd, encoding: 'utf8' })
+  if (result.status !== 0) {
+    log(`⚠️ Не вдалось прибрати worktree "${branchArg}" — приберіть вручну (${result.stderr || result.stdout})`)
+  }
+}
+
+/**
+ * Синхронно виконує детерміновану команду (bunx/bun/npx), кидає з
+ * exit-кодом+stderr при провалі.
+ * @param {string} cmd бінарник
+ * @param {string[]} args аргументи
+ * @param {string} cwd робочий каталог
+ * @param {typeof import('node:child_process').spawnSync} spawnFn інжект для тестів
+ * @returns {string} stdout
+ */
+function runCommand(cmd, args, cwd, spawnFn) {
+  const result = spawnFn(cmd, args, { cwd, encoding: 'utf8' })
+  if (result.status !== 0) {
+    throw new Error(`${cmd} ${args.join(' ')} → exit ${result.status}: ${result.stderr || result.stdout}`)
+  }
+  return result.stdout
+}

package/scripts/lib/docs/auto-worktree.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: auto-worktree.mjs
+resource: npm/scripts/lib/auto-worktree.mjs
+docgen:
+  crc: 8d55dfc5
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл керує запуском у ізольованому worktree, щоб підготувати зміни в окремому середовищі, потім викликати bringChangesBackToOriginal для повернення результату до вихідного дерева і removeAutoCreatedWorktree для очищення тимчасового worktree. Поведінка спирається на конфіг main.json.
+
+## Поведінка
+
+- `ensureRunningInWorktree` — перевіряє, чи виконання вже йде в ізольованому worktree; якщо ні, за потреби створює його для поточної гілки, ставить залежності й повертає новий `cwd`.
+- `bringChangesBackToOriginal` — переносить зміни з автоствореного worktree назад у вихідне дерево як untracked/незакомічені правки, включно з додаванням, оновленням і видаленням файлів; перейменування переносить лише в нову назву.
+- `removeAutoCreatedWorktree` — прибирає автостворений worktree разом із його ефемерною гілкою після перенесення змін назад, а у разі збою лише повідомляє про ручне прибирання.
+
+## Публічний API
+
+- ensureRunningInWorktree — Гарантує ізольований worktree для наступних кроків; якщо вже працюєш у `.worktrees/`, лишає поточний каталог без змін, інакше створює окремий worktree та ставить залежності. За замовчуванням блокує запуск на брудному дереві, щоб не втратити незакомічені правки; це можна послабити лише там, де чистоту вже забезпечили іншим способом.
+- bringChangesBackToOriginal — Повертає зміни з автоствореного worktree у початкове дерево простим копіюванням файлів: нові й змінені файли переносять, видалені — прибирають у вихідному дереві. Працює як перенесення фактичного стану, а не як merge.
+- removeAutoCreatedWorktree — Прибирає тимчасовий worktree та пов’язану з ним ephemeral branch після того, як зміни вже перенесено назад; якщо прибирання не вдалось, залишає worktree для ручного розбору.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/scripts/lib/docs/index.md

@@ -8,6 +8,7 @@ resource: npm/scripts/lib/
 | --------------------------------------------------------------------------- | --------- |
 | [acp-runner.mjs](acp-runner.md)                                             | JS Module |
 | [assert-project-root.mjs](assert-project-root.md)                           | JS Module |
+| [auto-worktree.mjs](auto-worktree.md)                                       | JS Module |
 | [blue-oak.mjs](blue-oak.md)                                                 | JS Module |
 | [changed-files.mjs](changed-files.md)                                       | JS Module |
 | [check-reporter.mjs](check-reporter.md)                                     | JS Module |
@@ -35,6 +36,7 @@ resource: npm/scripts/lib/
 | [run-conftest-batch.mjs](run-conftest-batch.md)                             | JS Module |
 | [run-lint-step.mjs](run-lint-step.md)                                       | JS Module |
 | [run-standard-lint.mjs](run-standard-lint.md)                               | JS Module |
+| [skill-fragments.mjs](skill-fragments.md)                                   | JS Module |
 | [skill-meta.mjs](skill-meta.md)                                             | JS Module |
 | [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md)                   | JS Module |
 | [template.mjs](template.md)                                                 | JS Module |

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: bce1f492
+  crc: 6a269363
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98

package/skills/taze/js/orchestrate.mjs

@@ -1,16 +1,23 @@
 /** @see ./docs/orchestrate.md */
 import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
-import { copyFile, mkdir, rm } from 'node:fs/promises'
-import { dirname, join } from 'node:path'
+import { copyFile, rm } from 'node:fs/promises'
+import { join } from 'node:path'
 import { pathToFileURL } from 'node:url'
 
+import {
+  bringChangesBackToOriginal,
+  ensureRunningInWorktree,
+  removeAutoCreatedWorktree
+} from '../../../scripts/lib/auto-worktree.mjs'
 import { assertEcosystemProvider } from '../../../scripts/lib/plugin-api.mjs'
 import { readNRulesConfigLite } from '../../../scripts/lib/read-n-rules-config-lite.mjs'
 import { getHandlers, resolvePlugins } from '../../../scripts/lib/resolve-plugins.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 import { collectTazeDiff } from './diff.mjs'
 
+export { bringChangesBackToOriginal, removeAutoCreatedWorktree } from '../../../scripts/lib/auto-worktree.mjs'
+
 /** Суфікс бекапу package.json — той самий, що й у `diff.mjs`/кроці 1 SKILL.md. */
 const BACKUP_SUFFIX = '.taze-bak'
 
@@ -80,125 +87,6 @@ export async function callRunner(runner, prompt, cwd, deps = {}) {
   }
 }
 
-/**
- * Гарантує, що подальші кроки оркестратора виконуються в ізольованому
- * worktree (`main.json.worktree: true`, той самий контракт, що й для інших
- * worktree-only скілів). Оркестратор не годує SKILL.md жодному агенту, тож
- * замість покладатись на агента, що читає SKILL.md-preflight, сам детерміновано
- * створює worktree конвенцією `<current-branch>-taze` (`npx \@7n/mt worktree
- * create`) і ставить залежності — щоб `bunx taze -w -r latest`/`bun install`
- * ніколи не виконались прямо в основному дереві виклику. `autoCreated: true`
- * сигналить викликачеві, що після завершення прогону варто перенести зміни
- * назад (`bringChangesBackToOriginal`) і прибрати worktree
- * (`removeAutoCreatedWorktree`) — а не лишати сирітське дерево.
- * @param {string} cwd каталог для перевірки
- * @param {typeof spawnSync} spawnFn інжект для тестів
- * @param {(line: string) => void} log колбек прогресу
- * @returns {{ cwd: string, autoCreated: boolean, branchArg: string|null }} `autoCreated: false` — `cwd` без змін
- *   (вже worktree); `autoCreated: true` — `cwd` щойно створеного worktree і `branchArg`, з яким його створено
- */
-function ensureRunningInWorktree(cwd, spawnFn, log) {
-  const toplevelResult = spawnFn('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
-  const toplevel = toplevelResult.status === 0 ? toplevelResult.stdout.trim() : ''
-  const segments = new Set(toplevel.replaceAll('\\', '/').split('/'))
-  if (segments.has('.worktrees')) return { cwd, autoCreated: false, branchArg: null }
-
-  const branchResult = spawnFn('git', ['branch', '--show-current'], { cwd, encoding: 'utf8' })
-  const currentBranch = branchResult.status === 0 ? branchResult.stdout.trim() : ''
-  if (!currentBranch) {
-    throw new Error(
-      `taze: "${cwd}" не в ізольованому worktree (git toplevel: "${toplevel || '?'}"), і поточну гілку визначити не вдалось ` +
-        '(detached HEAD?) — автоматичне створення worktree за конвенцією `<current-branch>-taze` неможливе. Перейди на гілку вручну.'
-    )
-  }
-
-  const branchArg = `${currentBranch}-taze`
-  const pathSegment = branchArg.replaceAll('/', '-')
-  log(`⚠️ "${cwd}" не в ізольованому worktree — створюю ".worktrees/${pathSegment}"...`)
-  runCommand('npx', ['@7n/mt', 'worktree', 'create', branchArg, 'n-taze: worktree-only skill'], cwd, spawnFn)
-
-  const newCwd = join(cwd, '.worktrees', pathSegment)
-  log('📥 bun install (bootstrap нового дерева)...')
-  runCommand('bun', ['install'], newCwd, spawnFn)
-  return { cwd: newCwd, autoCreated: true, branchArg }
-}
-
-/**
- * Переносить зміни з автоствореного worktree назад у вихідне дерево як
- * **untracked/незакомічені** правки (просте копіювання файлів, без git
- * merge/cherry-pick) — так само, як їх бачив би користувач, якби сам
- * працював у вихідному дереві. Джерело істини — `git status --porcelain`
- * у worktree: для кожного шляху копіює файл, якщо він існує (модифікація/
- * додавання), або видаляє його у вихідному дереві, якщо existsSync каже,
- * що в worktree його вже нема (видалення). Перейменування (`old -> new` у
- * porcelain) переносять лише нову назву — стара лишається як була, це
- * прийнятний компроміс: taze не перейменовує файли сам, ефект можливий
- * лише як побічний результат LLM-рефакторингу.
- * @param {string} worktreeCwd автостворений worktree, з якого переносимо
- * @param {string} originalCwd вихідне дерево, куди переносимо
- * @param {typeof spawnSync} spawnFn інжект для тестів
- * @param {(line: string) => void} log колбек прогресу
- * @param {{ copyFile?: (src: string, dest: string) => Promise<void>, rm?: (path: string, opts?: object) => Promise<void>, mkdir?: (path: string, opts?: object) => Promise<void> }} [deps] інжекти для тестів
- * @returns {Promise<string[]>} відносні шляхи перенесених файлів
- */
-export async function bringChangesBackToOriginal(worktreeCwd, originalCwd, spawnFn, log, deps = {}) {
-  const copy = deps.copyFile ?? copyFile
-  const removeFile = deps.rm ?? rm
-  const makeDir = deps.mkdir ?? mkdir
-
-  const statusResult = spawnFn('git', ['status', '--porcelain'], { cwd: worktreeCwd, encoding: 'utf8' })
-  if (statusResult.status !== 0) {
-    log(
-      `⚠️ Не вдалось прочитати git status у "${worktreeCwd}" — зміни НЕ перенесені назад, worktree лишиться для ручного розбору.`
-    )
-    return []
-  }
-
-  const lines = statusResult.stdout.split('\n').filter(Boolean)
-  if (lines.length === 0) {
-    log('ℹ️ Worktree без змін — нічого переносити назад.')
-    return []
-  }
-
-  const brought = []
-  for (const line of lines) {
-    const rest = line.slice(3)
-    const relPath = rest.includes(' -> ') ? rest.split(' -> ', 2)[1] : rest
-    const srcPath = join(worktreeCwd, relPath)
-    const destPath = join(originalCwd, relPath)
-    if (existsSync(srcPath)) {
-      await makeDir(dirname(destPath), { recursive: true })
-      await copy(srcPath, destPath)
-    } else {
-      await removeFile(destPath, { force: true })
-    }
-    brought.push(relPath)
-  }
-  log(`📤 Перенесено назад у "${originalCwd}" як untracked: ${brought.join(', ')}`)
-  return brought
-}
-
-/**
- * Прибирає автостворений worktree разом з його ефемерною git-гілкою
- * (`npx \@7n/mt worktree remove <branch>`) — викликати лише ПІСЛЯ
- * `bringChangesBackToOriginal`, інакше зміни згорять разом з деревом.
- * Не кидає при провалі — це прибирання, а не крок, від якого залежить
- * результат прогону; провал лише логується, worktree лишається для
- * ручного розбору.
- * @param {string} branchArg гілка, з якою worktree був створений (з `ensureRunningInWorktree`)
- * @param {string} originalCwd вихідне дерево, звідки виконати `npx \@7n/mt worktree remove`
- * @param {typeof spawnSync} spawnFn інжект для тестів
- * @param {(line: string) => void} log колбек прогресу
- * @returns {void}
- */
-export function removeAutoCreatedWorktree(branchArg, originalCwd, spawnFn, log) {
-  log(`🧹 Прибираю автостворений worktree "${branchArg}"...`)
-  const result = spawnFn('npx', ['@7n/mt', 'worktree', 'remove', branchArg], { cwd: originalCwd, encoding: 'utf8' })
-  if (result.status !== 0) {
-    log(`⚠️ Не вдалось прибрати worktree "${branchArg}" — приберіть вручну (${result.stderr || result.stdout})`)
-  }
-}
-
 /**
  * Синхронно виконує детерміновану команду (bunx/bun), кидає з
  * exit-кодом+stderr при провалі.
@@ -430,7 +318,10 @@ export async function runTazeOrchestrator(options = {}) {
   const call = deps.callRunner ?? callRunner
 
   const originalCwd = options.cwd ?? process.cwd()
-  const worktree = ensureRunningInWorktree(originalCwd, spawnFn, log)
+  const worktree = ensureRunningInWorktree(originalCwd, spawnFn, log, {
+    suffix: 'taze',
+    description: 'n-taze: worktree-only skill'
+  })
   const cwd = worktree.cwd
 
   try {