@7n/rules 1.48.1 → 1.49.0

package/bin/n-rules.js

@@ -1,2030 +1,8 @@
 #!/usr/bin/env node
 
-/**
- * n-rules — CLI завантаження правил та перевірки проєкту
- *
- * Використання:
- *   `npx \@7n/rules`             — завантажити cursor-правила (синк); якщо в корені вже є `.n-rules.json`,
- *                                     спочатку зчитується конфіг і за потреби дописується `$schema`
- *   `npx \@7n/rules rename-yaml-extensions` — k8s `*.yml` → `*.yaml`, `.github` `*.yaml` → `*.yml` (опції: `--dry-run`, `--root=…`; див. bin/rename-yaml-extensions.mjs)
- *   `npx \@7n/rules hook --post-tool-use` — PostToolUse hook: per-file lint правила для зміненого файлу (stdin JSON `tool_input.file_path`). Прописується автоматично в `.claude/settings.json`.
- *   `npx \@7n/rules hook --stop`           — Stop hook: per-file lint по всіх змінених файлах (git diff HEAD + untracked).
- *   `npx \@7n/rules lint`        — data-driven оркестратор lint+конформності по `rules/<id>/meta.json` (`lint: per-file|full`):
- *                                     за замовчуванням fix-by-default по дельті vs origin (лише `per-file` правила); `--full` =
- *                                     весь репо (`per-file` ∪ `full`); `--no-fix` = без мутацій/LLM (CI); позиційні
- *                                     (не-флаг) аргументи — фільтр правил конформності (мапить колишній `fix <rule>`);
- *                                     `--path <dir>` = перетин піддиректорії з git-дельтою (лише per-file правила; з `--full` —
- *                                     все піддерево), корінь прогону (root-guard, `.n-rules.json`) лишається поточним
- *                                     каталогом/`--cwd`; сумісний із rule-фільтром (`lint js --path run/nexus`);
- *                                     `--repo-wide` = лише full-scope правила (knip/jscpd/dep-policy) по всьому репо.
- *                                     CI = `lint --no-fix --full` (весь репо, нуль мутацій/LLM).
- *   `npx \@7n/rules ci plan`     — skip-логіка сервіс-орієнтованого CI-канону: перетин дельти з `--path` → job outputs
- *                                     «які lint-домени запускати» (`--github` → $GITHUB_OUTPUT, `--azure` → ##vso).
- *   `npx \@7n/rules skill list`     — скіли пакета без синку в проєкт
- *   `npx \@7n/rules skill taze`     — промпт на stdout
- *   `npx \@7n/rules skill cursor taze ["task"]` — Cursor CLI (`cursor-agent -p`)
- *   `npx \@7n/rules skill claude taze ["task"]` — Claude Code CLI (`claude -p`)
- *
- * Agent інтеграція: під час синку, окрім `.cursor/rules` і `.claude/commands` (з skills), CLI ще раз
- * синхронізує `.claude/settings.json` (hooks + permissions; merge — користувацькі поля зберігаються)
- * і `.cursor/hooks.json` (Cursor Agent hooks; merge — користувацькі hooks зберігаються).
- * Опт-аут — поле `claude-config: false` у `.n-rules.json`.
- * Pi.dev інтеграція: для кожного skill у `.cursor/skills/<dir>/` CLI генерує
- * `.pi/skills/<dir>/SKILL.md` із frontmatter `name`+`description` (формат pi.dev). Тіло — делегат
- * на джерельний `.cursor/skills/<dir>/SKILL.md`. Always-on, симетрично до `.claude/commands/`.
- *
- * Якщо у корені репозиторію немає .n-rules.json, спочатку перейменовується за наявності nitra-cursor.json;
- * у `.cursor/rules` файли `nitra-*.mdc` перейменовуються на `n-*.mdc`; інакше конфіг створюється автоматично
- * з усіма правилами з каталогу rules/ пакету (їх можна відредагувати після створення). У файлі завжди має бути
- * поле `$schema` з посиланням на JSON Schema пакету (публічний URL для IDE); при зчитуванні конфігу воно додається або виправляється на диску, якщо відсутнє або некоректне.
- * Масиви `rules`, `skills`, `disable-rules` і `disable-skills` при записі сортуються за алфавітом.
- *
- * Файл AGENTS.md у корені: щоразу повністю перезаписується змістом з AGENTS.template.md
- * пакету; список правил у шаблоні будується з файлів *.mdc у .cursor/rules поточного проєкту.
- * Секція команд — з кореневого package.json (scripts) та фіксовані рядки про CLI синхрону/перевірок.
- *
- * Після завантаження: у .cursor/rules видаляються файли *.mdc з префіксом «n-» (керовані
- * пакетом), яких немає у списку rules у .n-rules.json. Інші .mdc у цій директорії залишаються.
- *
- * Composite GitHub Action `.github/actions/setup-bun-deps/action.yml` копіюється з каталогу
- * `github-actions/` пакету при кожному успішному синку (workflows з правил ga / js-lint / text).
- *
- * Skills копіюються з npm/skills пакету лише для id з масиву «skills» у .n-rules.json
- * (у JSON — без префікса, як імена каталогів у rules/ без n-). У пакеті джерело — каталоги
- * skills/<id>/ (без префікса); у проєкті — .cursor/skills/n-<id>/ (префікс n-, як n-*.mdc).
- * Якщо ключа skills немає, за замовчуванням підтягуються всі підкаталоги skills/ (лише імена без префікса n-).
- * Зайві каталоги n-* у .cursor/skills, яких немає у списку, видаляються.
- * Файл `auto.md` у скілі — джерело правди для auto-skills у CLI (`scripts/auto-skills.mjs`)
- * і у проєкт не копіюється; раніше синхронізовані `auto.md` у `.cursor/skills/n-<id>/` CLI
- * не чіпає — їх потрібно прибрати вручну.
- *
- * Якщо в корені є package.json і в ньому ще немає \@7n/rules у devDependencies (і не оголошено
- * в dependencies), CLI дописує devDependencies з діапазоном ^<version> поточного пакету — зручно після npx.
- *
- * Перед копіюванням правил (режим без підкоманди): оновлення \@7n/rules у package.json до
- * останньої версії з npm (крім workspace:/file:/link: тощо), `bun i`, далі файли беруться з
- * `node_modules/@7n/rules`, якщо пакет з’явився після встановлення.
- */
+import { isRunAsCli } from '../scripts/cli-entry.mjs'
+import { runCli } from './n-rules-cli.mjs'
 
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { mkdir, readdir, readFile, rename, rm, unlink, writeFile } from 'node:fs/promises'
-import { basename, dirname, join, resolve } from 'node:path'
-import { cwd, env } from 'node:process'
-import { fileURLToPath } from 'node:url'
-
-import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
-import { formatGeneratedMarkdownLines, renderAgentsTemplate } from '../scripts/lib/generated-markdown.mjs'
-import { appendDiscoveredMdcFiles, inlineTemplateLinks } from '../scripts/lib/inline-template-links.mjs'
-import {
-  detectAutoRules,
-  detectLegacyRuleIds,
-  mergeConfigWithAutoDetected,
-  normalizeIdList,
-  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'
-import { injectRootNotice } from '../scripts/lib/root-notice.mjs'
-import { listProjectRulesMdcFiles } from '../scripts/lib/list-project-rules-mdc.mjs'
-import { ensureNRulesInRootDevDependencies } from '../scripts/ensure-n-rules-dev-dependencies.mjs'
-import { resolvePluginList, resolvePlugins, resolveRulesDirs } from '../scripts/lib/resolve-plugins.mjs'
-import { assertCwdIsProjectRoot } from '../scripts/lib/assert-project-root.mjs'
-import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
-import { syncGitignoreWorktree } from '../scripts/lib/sync-gitignore-worktree.mjs'
-import { upgradeNRulesToLatestAndBunInstall } from '../scripts/upgrade-n-rules-and-install.mjs'
-import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
-import { isTazeOrchestratorSkillArgs, runSkillsCli } from '../scripts/skills-cli.mjs'
-import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
-
-/**
- * Чи потребуватиме `lint <args>` worktree-ізоляції (той самий предикат, що й
- * `needsWorktreeIsolation` у `case 'lint'`, обчислений із сирих CLI-args ДО
- * парсингу `lintOpts`) — щоб self-upgrade devDependency не забруднив дерево
- * ПЕРЕД гейтом чистоти `ensureRunningInWorktree` (той самий клас проблеми,
- * що й `skill taze`, див. коментар над `skipDevDepsEnsure`).
- * @param {string[]} args сирі аргументи після `lint`
- * @returns {boolean} true, якщо `--full` без `--no-fix`/`--path`/`--repo-wide`
- */
-function isLintFullFixArgs(args) {
-  return (
-    args.includes('--full') && !args.includes('--path') && !args.includes('--repo-wide') && !args.includes('--no-fix')
-  )
-}
-
-const PACKAGE_NAME = '@7n/rules'
-const CONFIG_FILE = '.n-rules.json'
-/** Публічний URL JSON Schema для поля `$schema` у `.n-rules.json` (IDE); вміст правил CLI читає лише з диска пакету */
-const CONFIG_SCHEMA_URL = 'https://unpkg.com/@7n/rules/schemas/n-rules.json'
-const AGENTS_FILE = 'AGENTS.md'
-const AGENTS_TEMPLATE_FILE = 'AGENTS.template.md'
-const RULES_DIR = '.cursor/rules'
-const SKILLS_DIR = '.cursor/skills'
-const COMMANDS_DIR = '.claude/commands'
-const PI_SKILLS_DIR = '.pi/skills'
-const RULE_PREFIX = 'n-'
-
-const binDir = dirname(fileURLToPath(import.meta.url))
-const BUNDLED_RULES_DIR = join(binDir, '..', 'rules')
-const BUNDLED_SKILLS_DIR = join(binDir, '..', 'skills')
-const BUNDLED_AGENTS_TEMPLATE_PATH = join(binDir, '..', AGENTS_TEMPLATE_FILE)
-/** Корінь установленого пакету (каталог з `rules/`, `github-actions/`, …) */
-const BUNDLED_PACKAGE_ROOT = join(binDir, '..')
-
-const YAML_FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/
-const NEWLINE_RE = /\r?\n/
-const LEADING_SPACES_RE = /^\s+/
-
-/** Ключі `.n-rules.json`, де значення — масиви id; після запуску CLI сортуються за алфавітом */
-const CONFIG_SORTED_ARRAY_KEYS = /** @type {const} */ (['rules', 'skills', 'disable-rules', 'disable-skills'])
-
-/**
- * Сортує масиви id у конфігу за алфавітом (`localeCompare`), щоб порядок у файлі був стабільним після синку.
- * @param {Record<string, unknown>} config об'єкт конфігу перед записом на диск
- * @returns {Record<string, unknown>} копія з відсортованими масивами для відомих ключів
- */
-function sortConfigIdArrays(config) {
-  const out = { ...config }
-  for (const key of CONFIG_SORTED_ARRAY_KEYS) {
-    const v = out[key]
-    if (key in out && Array.isArray(v)) {
-      out[key] = v.map(String).toSorted((a, b) => a.localeCompare(b))
-    }
-  }
-  return out
-}
-
-/**
- * Імена правил з каталогу `rules/` поточної інсталяції пакету. Кожне правило — окремий
- * підкаталог `rules/<id>/`, у якому має бути `main.mdc`.
- * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету
- * @returns {Promise<string[]>} відсортовані id правил (імена підкаталогів)
- */
-async function discoverBundledRuleNames(bundledRulesDir = BUNDLED_RULES_DIR) {
-  if (!existsSync(bundledRulesDir)) {
-    throw new Error(
-      `Не знайдено каталог правил пакету.\n` +
-        `Очікуваний шлях: ${bundledRulesDir}\n` +
-        `Перевстановіть ${PACKAGE_NAME} або створіть ${CONFIG_FILE} вручну.`
-    )
-  }
-  const entries = await readdir(bundledRulesDir, { withFileTypes: true })
-  const rules = entries
-    .filter(e => e.isDirectory() && !e.name.startsWith('.'))
-    .filter(e => existsSync(join(bundledRulesDir, e.name, 'main.mdc')))
-    .map(e => e.name)
-    .toSorted((a, b) => a.localeCompare(b))
-  if (rules.length === 0) {
-    throw new Error(`У каталозі rules/ пакету немає підкаталогів з main.mdc. Створіть ${CONFIG_FILE} вручну.`)
-  }
-  return rules
-}
-
-/**
- * Імена skills (id без префікса n-) з каталогу skills пакету — лише підкаталоги `<id>/` без префікса n-
- * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету
- * @returns {Promise<string[]>} відсортовані id
- */
-async function discoverBundledSkillNames(bundledSkillsDir = BUNDLED_SKILLS_DIR) {
-  if (!existsSync(bundledSkillsDir)) {
-    return []
-  }
-  const entries = await readdir(bundledSkillsDir, { withFileTypes: true })
-  return entries
-    .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith(RULE_PREFIX))
-    .map(e => e.name)
-    .toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Перейменовує у каталозі правил файли `nitra-*.mdc` → `n-*.mdc`. Якщо `n-*.mdc` уже є, застарілий файл видаляється.
- * @param {string} rulesDir абсолютний шлях до `.cursor/rules`
- * @returns {Promise<void>}
- */
-async function migrateLegacyManagedRuleFilenames(rulesDir) {
-  if (!existsSync(rulesDir)) {
-    return
-  }
-  const names = await readdir(rulesDir)
-  for (const name of names) {
-    if (!(name.endsWith('.mdc') && name.startsWith('nitra-'))) {
-      continue
-    }
-
-    const rest = name.slice('nitra-'.length)
-    const newName = `${RULE_PREFIX}${rest}`
-    const from = join(rulesDir, name)
-    const to = join(rulesDir, newName)
-    if (existsSync(to)) {
-      await unlink(from)
-      console.log(`📝 Видалено застарілий ${RULES_DIR}/${name} (вже є ${newName})\n`)
-    } else {
-      await rename(from, to)
-      console.log(`📝 Перейменовано ${RULES_DIR}/${name} → ${RULES_DIR}/${newName}\n`)
-    }
-  }
-}
-
-/**
- * Міграція legacy: `nitra-*.mdc` → `n-*.mdc` у `.cursor/rules`; якщо немає `.n-rules.json`, конфіг
- * береться з legacy-імен (`.n-rules.json`, потім `nitra-cursor.json`) з переписуванням `$schema` на новий URL
- * @returns {Promise<void>}
- */
-async function migrateLegacyConfigIfNeeded() {
-  const root = cwd()
-  await migrateLegacyManagedRuleFilenames(join(root, RULES_DIR))
-
-  const target = join(root, CONFIG_FILE)
-  if (existsSync(target)) {
-    return
-  }
-  for (const legacyName of ['.n-cursor.json', 'nitra-cursor.json']) {
-    const legacyPath = join(root, legacyName)
-    if (!existsSync(legacyPath)) {
-      continue
-    }
-    await rename(legacyPath, target)
-    console.log(`📝 Перейменовано ${legacyName} → ${CONFIG_FILE}\n`)
-    try {
-      const parsed = JSON.parse(await readFile(target, 'utf8'))
-      if (typeof parsed?.$schema === 'string' && parsed.$schema.includes('@nitra/cursor')) {
-        parsed.$schema = CONFIG_SCHEMA_URL
-        await writeFile(target, `${JSON.stringify(parsed, null, 2)}\n`)
-      }
-    } catch {
-      /* некоректний JSON — $schema виправить подальший readConfig */
-    }
-    return
-  }
-}
-
-/**
- * Повертає розпарсений package.json з кореня або null, якщо файл відсутній/некоректний.
- * @returns {Promise<unknown | null>} обʼєкт package.json або null
- */
-async function readRootPackageJsonSafe() {
-  const packageJsonPath = join(cwd(), 'package.json')
-  if (!existsSync(packageJsonPath)) {
-    return null
-  }
-  try {
-    return JSON.parse(await readFile(packageJsonPath, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/**
- * Агрегує імена правил по rules-каталогах (ядро перше, перший власник виграє)
- * і будує мапу `ruleId → rulesDir` для копіювання mdc.
- * @param {string[]} rulesDirs упорядковані rules-каталоги (ядро + плагіни)
- * @returns {Promise<{ names: string[], sources: Map<string, string>, extras: Map<string, string[]> }>} імена правил, їх джерела і mixin-теки
- */
-async function aggregateRuleSources(rulesDirs) {
-  /** @type {Map<string, string>} */
-  const sources = new Map()
-  /** @type {Map<string, string[]>} каталоги `rules/<id>/` mixin-джерел (не власник main.mdc) */
-  const extras = new Map()
-  const perDirNames = await listRuleNamesPerDir(rulesDirs)
-  for (const [i, dir] of rulesDirs.entries()) {
-    for (const name of perDirNames[i]) {
-      if (!sources.has(name)) sources.set(name, dir)
-    }
-    if (i > 0) await collectMixinDirs(dir, perDirNames[i], extras)
-  }
-  // Тека з main.mdc у плагіні для правила, яким володіє інше джерело, — теж mixin (дублікат id).
-  for (const [i, dir] of rulesDirs.entries()) {
-    if (i === 0) continue
-    for (const name of perDirNames[i]) {
-      if (sources.get(name) === dir) continue
-      const list = extras.get(name) ?? []
-      list.push(join(dir, name))
-      extras.set(name, list)
-    }
-  }
-  return { names: sources.keys().toArray(), sources, extras }
-}
-
-/**
- * Імена правил (теки з `main.mdc`) кожного rules-каталогу. Для ядра (перший елемент)
- * відсутність каталогу — фатальна помилка; для плагінів — порожній список
- * (уже повідомлено у resolve-plugins).
- * @param {string[]} rulesDirs упорядковані rules-каталоги
- * @returns {Promise<string[][]>} імена правил per-dir у тому ж порядку
- */
-async function listRuleNamesPerDir(rulesDirs) {
-  /** @type {string[][]} */
-  const out = []
-  for (const [i, dir] of rulesDirs.entries()) {
-    if (i === 0) {
-      out.push(await discoverBundledRuleNames(dir))
-      continue
-    }
-    try {
-      out.push(await discoverBundledRuleNames(dir))
-    } catch {
-      out.push([])
-    }
-  }
-  return out
-}
-
-/**
- * Додає у `extras` mixin-теки плагіна: підкаталоги `rules/<id>/` БЕЗ `main.mdc`
- * (плагін доповнює правило іншого джерела концернами).
- * @param {string} dir rules-каталог плагіна
- * @param {string[]} ownNames імена повних правил цього каталогу (з main.mdc)
- * @param {Map<string, string[]>} extras акумулятор mixin-тек (мутується)
- * @returns {Promise<void>}
- */
-async function collectMixinDirs(dir, ownNames, extras) {
-  let entries
-  try {
-    entries = await readdir(dir, { withFileTypes: true })
-  } catch {
-    return // нечитабельний rules/ плагіна — вже пропущений вище
-  }
-  for (const e of entries) {
-    if (!e.isDirectory() || e.name.startsWith('.') || ownNames.includes(e.name)) continue
-    const list = extras.get(e.name) ?? []
-    list.push(join(dir, e.name))
-    extras.set(e.name, list)
-  }
-}
-
-/**
- * Зчитує конфіг .n-rules.json з поточної директорії
- * @param {{ bundledRulesDir?: string, bundledSkillsDir?: string }} [paths] каталоги з пакету-джерела (після `bun i` — зазвичай `node_modules/@7n/rules`)
- * @returns {Promise<{ $schema: string, rules: string[], skills: string[], version?: string } & Record<string, unknown>>} rules, skills (id без префікса n-); поле version у файлі за наявності ігнорується при синхронізації правил
- */
-async function readConfig(paths = {}) {
-  const bundledRulesDir = paths.bundledRulesDir ?? BUNDLED_RULES_DIR
-  const bundledSkillsDir = paths.bundledSkillsDir ?? BUNDLED_SKILLS_DIR
-  await migrateLegacyConfigIfNeeded()
-  const configPath = join(cwd(), CONFIG_FILE)
-
-  /** @type {Record<string, unknown> | null} */
-  let rawConfig = null
-  if (existsSync(configPath)) {
-    try {
-      rawConfig = JSON.parse(await readFile(configPath, 'utf8'))
-    } catch {
-      throw new Error(`Невірний JSON у файлі ${CONFIG_FILE}`)
-    }
-  }
-
-  // Плагіни: явне поле plugins конфігу (з per-категорійним backfill автодетекту — ADR
-  // 260719-2154) або повний автодетект, коли поля нема; sync-контекст — з установкою devDep.
-  // Результат записуємо у конфіг (нижче), щоб hook/lint не залежали від детекту й мережі.
-  const declaredPlugins = Array.isArray(rawConfig?.plugins) ? rawConfig.plugins : null
-  const resolvedPlugins = resolvePluginList(cwd(), rawConfig)
-  const rulesDirs = resolveRulesDirs(cwd(), rawConfig, bundledRulesDir).map(d => d.rulesDir)
-  const { names: availableRules } = await aggregateRuleSources(rulesDirs)
-  const availableSkills = await discoverBundledSkillNames(bundledSkillsDir)
-
-  /**
-   * Автодописує правила/skills за `rules/<rule>/auto.md` і синхронізує `$schema`.
-   * @param {Record<string, unknown>} parsedConfig сирий обʼєкт конфігу
-   * @returns {Promise<Record<string, unknown>>} нормалізований конфіг
-   */
-  async function normalizeConfigWithAutoRules(parsedConfig) {
-    const currentRules = parsedConfig.rules
-    if (!Array.isArray(currentRules)) {
-      throw new TypeError(`У ${CONFIG_FILE} поле "rules" має бути масивом рядків`)
-    }
-    if ('skills' in parsedConfig && !Array.isArray(parsedConfig.skills)) {
-      throw new Error(`У ${CONFIG_FILE} поле "skills" має бути масивом рядків`)
-    }
-    const { ignore } = parsedConfig
-    if (ignore !== undefined && (!Array.isArray(ignore) || ignore.some(p => typeof p !== 'string'))) {
-      throw new Error(`У ${CONFIG_FILE} поле "ignore" має бути масивом рядків (шляхів до директорій)`)
-    }
-
-    const rootPkg = await readRootPackageJsonSafe()
-    const disableRules = normalizeIdList(parsedConfig['disable-rules'])
-    const disableSkills = normalizeIdList(parsedConfig['disable-skills'])
-    const autoDetectedRules = await detectAutoRules({
-      root: cwd(),
-      availableRules,
-      packageJsonParsed: rootPkg,
-      disableRules,
-      rulesDirs
-    })
-    // Skills залежать від ефективного списку правил, який буде у конфізі після merge:
-    // вже існуючі (опт-ін вручну) + auto-detected, мінус `disable-rules`. Без цього
-    // правило, додане вручну (напр. `adr` без auto.md-умови), не активувало б залежні
-    // скіли (`adr-normalize`).
-    const disableRulesSet = new Set(disableRules)
-    const effectiveRulesForSkills = [
-      ...new Set([...normalizeIdList(parsedConfig.rules), ...autoDetectedRules.rules]).difference(disableRulesSet)
-    ]
-    const autoDetectedSkills = detectAutoSkills({
-      availableSkills,
-      detectedRules: effectiveRulesForSkills,
-      disableSkills
-    })
-
-    const merged = mergeConfigWithAutoDetected({
-      config: parsedConfig,
-      detectedRules: autoDetectedRules.rules,
-      detectedSkills: autoDetectedSkills.skills,
-      availableRules,
-      availableSkills
-    })
-
-    if (merged.pruned) {
-      const parts = []
-      if (merged.pruned.rules.length > 0) parts.push(`rules: ${merged.pruned.rules.join(', ')}`)
-      if (merged.pruned.skills.length > 0) parts.push(`skills: ${merged.pruned.skills.join(', ')}`)
-      console.log(`🧹 Прибрано з ${CONFIG_FILE} неактуальні (немає у пакеті) — ${parts.join('; ')}\n`)
-    }
-
-    const rest = Object.fromEntries(Object.entries(parsedConfig).filter(([k]) => k !== '$schema'))
-    const normalized = {
-      $schema: CONFIG_SCHEMA_URL,
-      ...rest,
-      rules: merged.rules,
-      skills: merged.skills
-    }
-    if (merged['disable-rules']?.length) {
-      normalized['disable-rules'] = merged['disable-rules']
-    }
-    if (merged['disable-skills']?.length) {
-      normalized['disable-skills'] = merged['disable-skills']
-    }
-    if (!('plugins' in parsedConfig)) {
-      if (resolvedPlugins.length > 0) {
-        normalized.plugins = resolvedPlugins
-        console.log(`🔌 Автодетект плагінів: ${resolvedPlugins.join(', ')} — записано у ${CONFIG_FILE}\n`)
-      }
-    } else if (declaredPlugins && JSON.stringify(resolvedPlugins) !== JSON.stringify(declaredPlugins)) {
-      // per-категорійний backfill (resolvePluginList, ADR 260719-2154) додав плагін
-      // категорії, відсутньої в явному plugins — фіксуємо результат у конфізі.
-      normalized.plugins = resolvedPlugins
-      const added = resolvedPlugins.filter(p => !declaredPlugins.includes(p))
-      console.log(`🔌 Доповнено plugins у ${CONFIG_FILE} (${added.join(', ')}) — категорія не була задекларована\n`)
-    }
-    return sortConfigIdArrays(normalized)
-  }
-
-  if (rawConfig === null) {
-    const rootPkg = await readRootPackageJsonSafe()
-    const autoDetectedRules = await detectAutoRules({
-      root: cwd(),
-      availableRules,
-      packageJsonParsed: rootPkg,
-      rulesDirs
-    })
-    const autoDetectedSkills = detectAutoSkills({
-      availableSkills,
-      detectedRules: autoDetectedRules.rules
-    })
-    const defaultConfig = sortConfigIdArrays({
-      $schema: CONFIG_SCHEMA_URL,
-      rules: autoDetectedRules.rules,
-      skills: autoDetectedSkills.skills,
-      ...(resolvedPlugins.length > 0 && { plugins: resolvedPlugins })
-    })
-    await writeFile(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, 'utf8')
-    console.log(
-      `📝 Створено ${CONFIG_FILE} з автоаналізом правил (${defaultConfig.rules.length}) і skills (${defaultConfig.skills.length}).\n`
-    )
-    return defaultConfig
-  }
-  const config = rawConfig
-  logRuleMigrationsIfAny(config)
-  const normalized = await normalizeConfigWithAutoRules(config)
-  if (JSON.stringify(normalized) !== JSON.stringify(config)) {
-    await writeFile(configPath, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8')
-    console.log(`📝 Оновлено ${CONFIG_FILE}: синхронізовано $schema та авто-додані rules/skills\n`)
-  }
-  return normalized
-}
-
-/**
- * Якщо у `rules` чи `disable-rules` є застарілі rule-id з `RULE_MIGRATIONS`,
- * виводить пояснювальний лог про автоматичну заміну (саму заміну виконує
- * `migrateRuleIds` у `mergeConfigWithAutoDetected` — тут лише користувацька комунікація).
- * @param {Record<string, unknown>} parsedConfig сирий обʼєкт `.n-rules.json` після `JSON.parse`
- * @returns {void}
- */
-function logRuleMigrationsIfAny(parsedConfig) {
-  /** @type {Set<string>} */
-  const seen = new Set()
-  for (const key of /** @type {const} */ (['rules', 'disable-rules'])) {
-    const list = parsedConfig[key]
-    if (!Array.isArray(list)) continue
-    const legacy = detectLegacyRuleIds(normalizeIdList(list))
-    for (const id of legacy) seen.add(id)
-  }
-  if (seen.size === 0) return
-  console.log(`📦 Авто-міграція ${CONFIG_FILE}:`)
-  for (const id of seen) {
-    const replacement = RULE_MIGRATIONS[id].join(', ')
-    console.log(`   • ${id} → ${replacement}`)
-  }
-  console.log('')
-}
-
-/**
- * Витягує чистий id правила без шляху і без .mdc.
- * "npm/rules/text/text.mdc" → "text"
- * "text.mdc"                → "text"
- * "text"                    → "text"
- * @param {string} ruleName шлях або базове ім'я, з суфіксом .mdc або без
- * @returns {string} id правила (без .mdc, без шляху)
- */
-function normalizeRuleName(ruleName) {
-  const name = basename(String(ruleName).trim())
-  return name.endsWith('.mdc') ? name.slice(0, -'.mdc'.length) : name
-}
-
-/**
- * Читає вміст правила з каталогу `rules/<id>/main.mdc` установленого пакету
- * (наприклад `node_modules/@7n/rules/rules/<id>/main.mdc` або кеш npx).
- * Mixin-концерни: `extraRuleDirs` — каталоги `rules/<id>/` того самого правила з ІНШИХ
- * джерел (плагінів); їхні concern-mdc доінлайнюються після концернів власника, тож
- * `.cursor/rules/n-<id>.mdc` містить і провайдер-специфічні розділи (напр. lint_js_yml
- * з `@7n/rules-ci-github` чи lint_pipeline_js з `@7n/rules-ci-azure`).
- * @param {string} rule елемент масиву rules з `.n-rules.json`
- * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету-джерела (власник main.mdc)
- * @param {string[]} [extraRuleDirs] каталоги `rules/<id>/` mixin-джерел (без main.mdc)
- * @returns {Promise<string>} текст правила для запису в `.cursor/rules/n-*.mdc`
- */
-async function readBundledRuleContent(rule, bundledRulesDir = BUNDLED_RULES_DIR, extraRuleDirs = []) {
-  const id = normalizeRuleName(rule)
-  const bundledPath = join(bundledRulesDir, id, 'main.mdc')
-  if (!existsSync(bundledPath)) {
-    throw new Error(
-      `Немає файлу ${id}/main.mdc у ${bundledRulesDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
-    )
-  }
-  const text = await readFile(bundledPath, 'utf8')
-  let out = await inlineTemplateLinks(text, dirname(bundledPath))
-  out = await appendDiscoveredMdcFiles(out, dirname(bundledPath))
-  for (const extraDir of extraRuleDirs) {
-    out = await appendDiscoveredMdcFiles(out, extraDir)
-  }
-  return out
-}
-
-/**
- * Нормалізує id skill з конфігу до форми без префікса n- (як «fix»)
- * @param {string} skillName елемент масиву skills або ім'я каталогу
- * @returns {string} id без префікса n-
- */
-function normalizeSkillId(skillName) {
-  let s = basename(String(skillName).trim())
-  if (s.startsWith(RULE_PREFIX)) {
-    s = s.slice(RULE_PREFIX.length)
-  }
-  return s
-}
-
-/**
- * Ім'я керованого каталогу skill у .cursor/skills (префікс n-)
- * @param {string} skillId id без префікса (або з префіксом n- у конфігу — нормалізується)
- * @returns {string} наприклад n-fix
- */
-function managedSkillDirName(skillId) {
-  return `${RULE_PREFIX}${normalizeSkillId(skillId)}`
-}
-
-/**
- * Витягує текст description з YAML frontmatter SKILL.md (формат description: >-)
- * @param {string} text повний вміст SKILL.md
- * @returns {string | null} один рядок опису або null
- */
-function extractSkillDescription(text) {
-  const fm = text.match(YAML_FRONTMATTER_RE)
-  if (!fm) {
-    return null
-  }
-  const lines = fm[1].split(NEWLINE_RE)
-  const start = lines.findIndex(line => line.trim() === 'description: >-')
-  if (start === -1) {
-    return null
-  }
-  const descLines = []
-  for (const line of lines.slice(start + 1)) {
-    if (!LEADING_SPACES_RE.test(line)) {
-      break
-    }
-    descLines.push(line.replace(LEADING_SPACES_RE, '').trimEnd())
-  }
-  if (descLines.length === 0) {
-    return null
-  }
-  return descLines.join(' ').trim()
-}
-
-/**
- * Підготовка опису skill для вставки в звичайний markdown (заголовок H1, bullet без code fence).
- * Послідовність `<id>` сприймається markdownlint (MD033) як inline HTML — замінюємо на `{id}`.
- * @param {string} desc один рядок з YAML frontmatter SKILL.md
- * @returns {string} той самий рядок після заміни літералу з кутовими дужками навколо id на плейсхолдер у фігурних дужках (MD033).
- */
-function skillDescriptionSafeForMarkdownInline(desc) {
-  return desc.replaceAll('<id>', '{id}')
-}
-
-/**
- * YAML frontmatter для `.claude/commands/*.md`: поле `description` потрібне розширенню VSCode,
- * щоб команди з’являлись у списку. Текст збігається з полем `description` у frontmatter `SKILL.md`.
- * @param {string} descriptionRaw значення з `extractSkillDescription` (може бути порожнім)
- * @returns {string} блок `---` … `---` і порожній рядок після
- */
-function formatClaudeCommandFrontmatter(descriptionRaw) {
-  let text = skillDescriptionSafeForMarkdownInline(String(descriptionRaw || '').trim())
-  if (!text) {
-    text = 'Див. SKILL.md у каталозі скілу в .cursor/skills.'
-  }
-  return `---\ndescription: >-\n  ${text}\n---\n\n`
-}
-
-/**
- * YAML frontmatter для `.pi/skills/<dir>/SKILL.md` згідно зі специфікацією pi.dev:
- * обов'язкові поля `name` (1-64, `[a-z0-9-]`) і `description` (≤ 1024). Текст description збігається
- * з полем `description` у frontmatter джерельного `SKILL.md`.
- * @param {string} skillName ім'я скілу (наприклад `n-fix`); має бути валідним pi-name
- * @param {string} descriptionRaw значення з `extractSkillDescription` (може бути порожнім)
- * @returns {string} блок `---` … `---` і порожній рядок після
- */
-function formatPiSkillFrontmatter(skillName, descriptionRaw) {
-  let text = skillDescriptionSafeForMarkdownInline(String(descriptionRaw || '').trim())
-  if (!text) {
-    text = 'Див. SKILL.md у каталозі скілу в .cursor/skills.'
-  }
-  return `---\nname: ${skillName}\ndescription: >-\n  ${text}\n---\n\n`
-}
-
-/**
- * Базові імена файлів .mdc, які очікуються згідно з .n-rules.json (префікс n-).
- * @param {string[]} configRules елементи масиву rules з конфігу
- * @returns {Set<string>} множина очікуваних імен файлів (наприклад n-bun.mdc)
- */
-function expectedManagedRuleBasenames(configRules) {
-  return new Set(configRules.map(rule => `${RULE_PREFIX}${normalizeRuleName(rule)}.mdc`))
-}
-
-/**
- * Видаляє з каталогу правил файли *.mdc з префіксом n-, яких немає у конфігурації.
- * Файли без префікса n- не змінює.
- * @param {string} rulesDir абсолютний шлях до .cursor/rules
- * @param {string[]} configRules елементи масиву rules з .n-rules.json
- * @returns {Promise<string[]>} відсортовані імена видалених файлів
- */
-async function removeOrphanManagedRuleFiles(rulesDir, configRules) {
-  if (!existsSync(rulesDir)) {
-    return []
-  }
-  const expected = expectedManagedRuleBasenames(configRules)
-  const names = await readdir(rulesDir)
-  const removed = []
-  for (const name of names) {
-    if (!(name.endsWith('.mdc') && name.startsWith(RULE_PREFIX) && !expected.has(name))) {
-      continue
-    }
-
-    await unlink(join(rulesDir, name))
-    removed.push(name)
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Повертає відсортований список директорій skills у `.cursor/skills`.
- * Директорія вважається skill-каталогом, якщо це підкаталог (без префікса `.`).
- * @returns {Promise<string[]>} імена директорій (наприклад `n-fix`, `custom-skill`)
- */
-async function listProjectSkillDirNames() {
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  if (!existsSync(skillsRoot)) {
-    return []
-  }
-  const entries = await readdir(skillsRoot, { withFileTypes: true })
-  return entries
-    .filter(entry => entry.isDirectory() && !entry.name.startsWith('.'))
-    .map(entry => entry.name)
-    .toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Формує markdown-рядки для секції Skills у AGENTS.md з усіх skill-директорій на диску.
- * @returns {Promise<{ name: string }[]>} елементи з полем name для Mustache-секції skills
- */
-async function buildSkillBulletItems() {
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  const skillDirNames = await listProjectSkillDirNames()
-  const items = []
-  for (const dirName of skillDirNames) {
-    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
-    let desc = ''
-    if (existsSync(skillMdPath)) {
-      const text = await readFile(skillMdPath, 'utf8')
-      const parsed = extractSkillDescription(text)
-      if (parsed) {
-        desc = skillDescriptionSafeForMarkdownInline(parsed)
-      }
-    }
-    const pathLine = `- \`${SKILLS_DIR}/${dirName}/SKILL.md\``
-    const line = desc ? `${pathLine} — ${desc}` : pathLine
-    items.push({ name: line })
-  }
-  return items
-}
-
-/**
- * Видаляє каталоги n-* у .cursor/skills, яких немає у конфігурації skills
- * @param {string} skillsRoot абсолютний шлях до .cursor/skills
- * @param {string[]} configSkills елементи масиву skills з .n-rules.json
- * @returns {Promise<string[]>} імена видалених каталогів
- */
-async function removeOrphanManagedSkillDirs(skillsRoot, configSkills) {
-  if (!existsSync(skillsRoot)) {
-    return []
-  }
-  const expected = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const entries = await readdir(skillsRoot, { withFileTypes: true })
-  const removed = []
-  for (const e of entries) {
-    const isManagedDir = e.isDirectory() && e.name.startsWith(RULE_PREFIX)
-    const isOrphan = isManagedDir && !expected.has(e.name)
-    if (isOrphan) {
-      await rm(join(skillsRoot, e.name), { recursive: true, force: true })
-      removed.push(e.name)
-    }
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Рендерить коротку секцію для CLAUDE.md: full-прогони lint мають вбудовану
- * глобальну чергу з видимим прогресом, дельта-запуски йдуть паралельно без лока.
- * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
- */
-function buildClaudeLintParallelismSectionLines() {
-  return [
-    '',
-    '## Лінт і ESLint (паралелізм)',
-    '',
-    'Дельта-`lint` (типовий задачний прогін) — **без черги**, паралельні запуски по різних файлах дозволені. `npx @7n/rules lint --full` має **вбудовану глобальну чергу** (spec 2026-07-03): один full-прогін на машину; запуск у черзі показує свою позицію, решту черги і живий прогрес-бар активного прогону (`⏳ lint --full у черзі #… · працює pid … [██…] 5/12 · …` — штатна черга, не зависання; fail-closed таймаут 45 хв). Ідентичний повтор --full на незміненому дереві дедуплікується (`♻️ … пропускаю`). Координувати запуски вручну не треба. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
-    ''
-  ]
-}
-
-/**
- * Рендерить секцію для CLAUDE.md: скіли з `main.json.worktree === true` запускаються
- * лише в окремому git-worktree (дублює fail-fast банер `SKILL.md` як завжди-читане правило).
- * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
- */
-function buildClaudeWorktreeEnforcementSectionLines() {
-  return [
-    '',
-    '## Worktree-only skills (`main.json` → `worktree: true`)',
-    '',
-    'Скіл із **`worktree: true`** у `main.json` запускається **виключно** в окремому git-worktree (`.worktrees/<current-branch>-<suffix>/`) — **не** в основному дереві й **не** паралельно. Перший крок такого скіла (блок `n-rules:worktree:start` у його `SKILL.md`) — **preflight**: якщо `git rev-parse --show-toplevel` не вказує під `.worktrees/`, **STOP** і не питай користувача про назву гілки; створи worktree від поточної гілки готовим snippet з `SKILL.md` за конвенцією `<current-branch>-<suffix>` і без shell expansion (без command substitution, variable expansion чи backticks). Чисте робоче дерево — **не** привід пропустити preflight.',
-    ''
-  ]
-}
-
-/**
- * Рендерить секцію для CLAUDE.md: doc-files — обовʼязковий крок задачі (як lint).
- * Після зміни кодового файлу його дока має бути перегенерована; застарілість
- * детермінується за CRC і контролюється Stop-hook'ом.
- * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
- */
-function buildClaudeDocFilesSectionLines() {
-  return [
-    '',
-    '## Файлова документація (`doc-files` — обовʼязковий крок, як lint)',
-    '',
-    'Після зміни чи додавання кодового файлу його файлова дока (`<dir>/docs/<stem>.md`) має бути **актуальною** — це **обовʼязковий крок кожної задачі**, нарівні з lint. Застарілість детермінується за **CRC** джерела у frontmatter доки. PostToolUse hook (`hook --post-tool-use`) **сигналить** про дрейф після правки через per-file lint правила. Регенерація — `/doc-files` (JS-оркестрована, не диспатч субагентів). Агрегуюча дока (module-summary, доменні) — окремий скіл `/doc-aggregate`, за запитом.',
-    ''
-  ]
-}
-
-/**
- * Рендерить секцію Skills для CLAUDE.md з урахуванням наявних slash-команд.
- * @returns {Promise<string[]>} готові рядки секції (або порожній масив)
- */
-async function buildClaudeSkillsSectionLines() {
-  const skillDirNames = await listProjectSkillDirNames()
-  if (skillDirNames.length === 0) {
-    return []
-  }
-
-  const lines = ['', '## Skills', '']
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  const commandsRoot = join(cwd(), COMMANDS_DIR)
-  for (const dirName of skillDirNames) {
-    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
-    const commandPath = join(commandsRoot, `${dirName}.md`)
-    let desc = ''
-    if (existsSync(skillMdPath)) {
-      const text = await readFile(skillMdPath, 'utf8')
-      const parsed = extractSkillDescription(text)
-      if (parsed) {
-        desc = skillDescriptionSafeForMarkdownInline(parsed)
-      }
-    }
-    const ref = `- \`${SKILLS_DIR}/${dirName}/SKILL.md\``
-    lines.push(desc ? `${ref} — ${desc}` : ref)
-    if (existsSync(commandPath)) {
-      lines.push(`  Команда: \`/${dirName}\``)
-    }
-  }
-  return lines
-}
-
-/**
- * Генерує CLAUDE.md у корені cwd з at-імпортами всіх .mdc-правил та посиланнями на skills.
- * Завдяки цьому Claude Code автоматично завантажує вміст кожного правила при старті.
- * @returns {Promise<void>}
- */
-/**
- * @param {string[]} [ignore] директорії заборонені для редагування
- */
-async function syncClaudeMd(ignore) {
-  const lines = [`<!-- Цей файл генерується автоматично через \`npx ${PACKAGE_NAME}\`. Не редагуй вручну. -->`, '']
-
-  if (Array.isArray(ignore) && ignore.length > 0) {
-    lines.push('## Захищені директорії', '', 'Ніколи не змінюй, не видаляй і не створюй файли у цих директоріях:', '')
-    for (const dir of ignore) {
-      let d = dir
-      while (d.endsWith('/')) d = d.slice(0, -1)
-      lines.push(`- \`${d}/\``)
-    }
-    lines.push('')
-  }
-
-  const mdcFiles = await listProjectRulesMdcFiles()
-  for (const mdcFile of mdcFiles) {
-    lines.push(`@${RULES_DIR}/${mdcFile}`)
-  }
-
-  lines.push(
-    ...buildClaudeLintParallelismSectionLines(),
-    ...buildClaudeWorktreeEnforcementSectionLines(),
-    ...buildClaudeDocFilesSectionLines()
-  )
-
-  const skillsSectionLines = await buildClaudeSkillsSectionLines()
-  lines.push(...skillsSectionLines)
-  const claudeMdPath = join(cwd(), 'CLAUDE.md')
-  const hadFile = existsSync(claudeMdPath)
-  await writeFile(claudeMdPath, formatGeneratedMarkdownLines(lines), 'utf8')
-  console.log(hadFile ? `📝 Оновлено CLAUDE.md` : `📝 Створено CLAUDE.md`)
-}
-
-/**
- * Повністю перезаписує AGENTS.md у корені cwd з npm/AGENTS.template.md
- * @param {string} [agentsTemplatePath] шлях до AGENTS.template.md у корені пакету-джерела
- * @returns {Promise<void>} завершення запису файлу
- */
-async function syncAgentsMd(agentsTemplatePath = BUNDLED_AGENTS_TEMPLATE_PATH) {
-  if (!existsSync(agentsTemplatePath)) {
-    throw new Error(
-      `Не знайдено шаблон ${AGENTS_TEMPLATE_FILE} у пакеті.\n` +
-        `Очікуваний шлях: ${agentsTemplatePath}\n` +
-        `Перевстановіть ${PACKAGE_NAME}.`
-    )
-  }
-  const templateText = await readFile(agentsTemplatePath, 'utf8')
-  const mdcFiles = await listProjectRulesMdcFiles()
-  const skillItems = await buildSkillBulletItems()
-  const commandItems = await buildAgentsCommandBulletItems(cwd())
-  const body = renderAgentsTemplate(templateText, mdcFiles, skillItems, commandItems)
-  const agentsPath = join(cwd(), AGENTS_FILE)
-  const hadFile = existsSync(agentsPath)
-  await writeFile(agentsPath, body.endsWith('\n') ? body : `${body}\n`, 'utf8')
-  console.log(
-    hadFile
-      ? `📝 Оновлено ${AGENTS_FILE} з ${AGENTS_TEMPLATE_FILE}`
-      : `📝 Створено ${AGENTS_FILE} з ${AGENTS_TEMPLATE_FILE}`
-  )
-}
-
-/**
- * Копіює лише skills зі списку configSkills (джерело: skills/<id>/ у пакеті)
- * @param {string[]} configSkills id без префікса n-
- * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
- * @param {{ plugins?: unknown } | null} [config] конфіг `.n-rules.json` — активні плагіни для SKILL-фрагментів
- * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих копіювань
- */
-async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR, config = null) {
-  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
-    return { success: 0, fail: 0 }
-  }
-
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  await mkdir(skillsRoot, { recursive: true })
-  // Активні плагіни — джерело конвенційних фрагментів skills/<id>/SKILL.fragment.md
-  // (фаза 4b spec lang-plugins-extraction): мовні гілки скіла їдуть з плагіном.
-  const activePlugins = resolvePlugins(cwd(), config, { allowInstall: false, quiet: true })
-
-  let success = 0
-  let fail = 0
-
-  for (const skillId of configSkills) {
-    const id = normalizeSkillId(skillId)
-    const srcDir = join(bundledSkillsDir, id)
-    const destDirName = managedSkillDirName(skillId)
-    const destDir = join(skillsRoot, destDirName)
-
-    process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${destDirName} ... `)
-    if (existsSync(srcDir)) {
-      try {
-        await mkdir(destDir, { recursive: true })
-        const meta = readSkillMetaRaw(srcDir)
-        const worktree = meta?.worktree === true
-        // root-guard для in-place скілів (мутують CWD без worktree-ізоляції).
-        // Worktree-скіли root-assert уже мають у worktree-блоці, тож тут лише !worktree.
-        const rootOnly = !worktree && meta?.requireRoot === true
-        const entries = await readdir(srcDir, { withFileTypes: true })
-        for (const entry of entries) {
-          // Лише top-level файли скіла. `main.json` — метадані (не для споживача);
-          // підкаталоги (`js/` — скіл-специфічний код) виконуються з пакета через
-          // `npx`, у проєкт не копіюються (як `npm/rules/<id>/js/`). Див. scripts.mdc.
-          if (!entry.isFile() || entry.name === 'main.json') continue
-          let content = await readFile(join(srcDir, entry.name), 'utf8')
-          if (entry.name === 'SKILL.md') {
-            content = injectWorktreeNotice(content, worktree)
-            content = injectRootNotice(content, rootOnly)
-            content = injectSkillFragments(content, collectSkillFragments(id, activePlugins))
-          }
-          await writeFile(join(destDir, entry.name), content, 'utf8')
-        }
-        console.log(`✅`)
-        success++
-      } catch (error) {
-        console.log(`❌`)
-        console.error(`     Помилка: ${error.message}`)
-        fail++
-      }
-    } else {
-      console.log(`❌`)
-      console.error(`     Немає каталогу в пакеті: skills/${id}`)
-      fail++
-    }
-  }
-  return { success, fail }
-}
-
-/**
- * Синхронізує .claude/commands/n-<id>.md зі skills пакету.
- * У кожному файлі обов’язково YAML frontmatter з `description` (як у `SKILL.md`), інакше команди
- * не з’являються у розширенні VSCode; далі — заголовок H1 лише з імені команди (без повтору опису) і посилання на `.cursor/skills/…/SKILL.md`.
- * @param {string[]} configSkills id без префікса n-
- * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
- * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
- */
-async function syncCommands(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
-  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
-    return { success: 0, fail: 0 }
-  }
-
-  const commandsDir = join(cwd(), COMMANDS_DIR)
-  await mkdir(commandsDir, { recursive: true })
-
-  let success = 0
-  let fail = 0
-
-  for (const skillId of configSkills) {
-    const id = normalizeSkillId(skillId)
-    const srcSkillMd = join(bundledSkillsDir, id, 'SKILL.md')
-    const destDirName = managedSkillDirName(skillId)
-    const destFile = join(commandsDir, `${RULE_PREFIX}${id}.md`)
-
-    process.stdout.write(`  ⬇  ${id} → ${COMMANDS_DIR}/${RULE_PREFIX}${id}.md ... `)
-    if (existsSync(srcSkillMd)) {
-      try {
-        const raw = await readFile(srcSkillMd, 'utf8')
-        const descRaw = extractSkillDescription(raw)
-        const frontmatter = formatClaudeCommandFrontmatter(descRaw || '')
-        const header = `# ${RULE_PREFIX}${id}\n\n`
-        const body = `${frontmatter}${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
-        await writeFile(destFile, body, 'utf8')
-        console.log(`✅`)
-        success++
-      } catch (error) {
-        console.log(`❌`)
-        console.error(`     Помилка: ${error.message}`)
-        fail++
-      }
-    } else {
-      console.log(`❌`)
-      console.error(`     Немає SKILL.md у пакеті: skills/${id}`)
-      fail++
-    }
-  }
-  return { success, fail }
-}
-
-/**
- * Видаляє файли n-*.md у .claude/commands, яких немає у конфігурації skills
- * @param {string} commandsDir абсолютний шлях до .claude/commands
- * @param {string[]} configSkills id без префікса n-
- * @returns {Promise<string[]>} імена видалених файлів
- */
-async function removeOrphanManagedCommandFiles(commandsDir, configSkills) {
-  if (!existsSync(commandsDir)) {
-    return []
-  }
-  const expected = new Set(configSkills.map(s => `${RULE_PREFIX}${normalizeSkillId(s)}.md`))
-  const names = await readdir(commandsDir)
-  const removed = []
-  for (const name of names) {
-    if (!(name.endsWith('.md') && name.startsWith(RULE_PREFIX) && !expected.has(name))) {
-      continue
-    }
-
-    await unlink(join(commandsDir, name))
-    removed.push(name)
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Синхронізує .claude/commands/{dirName}.md для всіх локальних скілів з .cursor/skills/
- * що не керуються пакетом (відсутні в configSkills). Frontmatter `description` — як у відповідному SKILL.md.
- * @param {string[]} configSkills id керованих skills (вже оброблені syncCommands)
- * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
- */
-async function syncLocalOnlySkillCommands(configSkills) {
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  if (!existsSync(skillsRoot)) return { success: 0, fail: 0 }
-
-  const commandsDir = join(cwd(), COMMANDS_DIR)
-  await mkdir(commandsDir, { recursive: true })
-
-  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const allDirNames = await listProjectSkillDirNames()
-  const localOnly = allDirNames.filter(d => !managedDirNames.has(d))
-
-  let success = 0
-  let fail = 0
-
-  for (const dirName of localOnly) {
-    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
-    const destFile = join(commandsDir, `${dirName}.md`)
-
-    process.stdout.write(`  ⬇  ${dirName} → ${COMMANDS_DIR}/${dirName}.md ... `)
-    try {
-      let descRaw = ''
-      if (existsSync(skillMdPath)) {
-        const raw = await readFile(skillMdPath, 'utf8')
-        const parsed = extractSkillDescription(raw)
-        if (parsed) descRaw = parsed
-      }
-      const frontmatter = formatClaudeCommandFrontmatter(descRaw)
-      const header = `# ${dirName}\n\n`
-      const body = `${frontmatter}${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
-      await writeFile(destFile, body, 'utf8')
-      console.log(`✅`)
-      success++
-    } catch (error) {
-      console.log(`❌`)
-      console.error(`     Помилка: ${errorMessage(error)}`)
-      fail++
-    }
-  }
-  return { success, fail }
-}
-
-/**
- * Видаляє .claude/commands/{dirName}.md файли локальних скілів, яких більше немає в .cursor/skills/
- * @param {string} commandsDir абсолютний шлях до .claude/commands
- * @param {string[]} configSkills id керованих skills
- * @returns {Promise<string[]>} імена видалених файлів
- */
-async function removeOrphanLocalSkillCommandFiles(commandsDir, configSkills) {
-  if (!existsSync(commandsDir)) return []
-
-  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const allDirNames = new Set(await listProjectSkillDirNames())
-  const names = await readdir(commandsDir)
-  const removed = []
-
-  for (const name of names) {
-    if (!name.endsWith('.md') || name.startsWith(RULE_PREFIX)) continue
-    const dirName = name.slice(0, -3)
-    if (!managedDirNames.has(dirName) && !allDirNames.has(dirName)) {
-      await unlink(join(commandsDir, name))
-      removed.push(name)
-    }
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Синхронізує .pi/skills/n-<id>/SKILL.md зі skills пакету для pi.dev-сумісності.
- * Pi-skill — це директорія з SKILL.md (frontmatter `name`+`description`), тіло-делегат на джерельний
- * `.cursor/skills/<dir>/SKILL.md`. Симетрично до `syncCommands`, але дир замість `.md`-файлу.
- * @param {string[]} configSkills id без префікса n-
- * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
- * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
- */
-async function syncPiSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
-  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
-    return { success: 0, fail: 0 }
-  }
-
-  const piSkillsRoot = join(cwd(), PI_SKILLS_DIR)
-  await mkdir(piSkillsRoot, { recursive: true })
-
-  let success = 0
-  let fail = 0
-
-  for (const skillId of configSkills) {
-    const id = normalizeSkillId(skillId)
-    const srcSkillMd = join(bundledSkillsDir, id, 'SKILL.md')
-    const destDirName = managedSkillDirName(skillId)
-    const destDir = join(piSkillsRoot, destDirName)
-    const destFile = join(destDir, 'SKILL.md')
-
-    process.stdout.write(`  ⬇  ${id} → ${PI_SKILLS_DIR}/${destDirName}/SKILL.md ... `)
-    if (existsSync(srcSkillMd)) {
-      try {
-        const raw = await readFile(srcSkillMd, 'utf8')
-        const descRaw = extractSkillDescription(raw)
-        await mkdir(destDir, { recursive: true })
-        const frontmatter = formatPiSkillFrontmatter(destDirName, descRaw || '')
-        const header = `# ${destDirName}\n\n`
-        const body = `${frontmatter}${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
-        await writeFile(destFile, body, 'utf8')
-        console.log(`✅`)
-        success++
-      } catch (error) {
-        console.log(`❌`)
-        console.error(`     Помилка: ${errorMessage(error)}`)
-        fail++
-      }
-    } else {
-      console.log(`❌`)
-      console.error(`     Немає SKILL.md у пакеті: skills/${id}`)
-      fail++
-    }
-  }
-  return { success, fail }
-}
-
-/**
- * Синхронізує .pi/skills/{dirName}/SKILL.md для всіх локальних скілів з .cursor/skills/
- * що не керуються пакетом. Симетрично до `syncLocalOnlySkillCommands`.
- * @param {string[]} configSkills id керованих skills (уже оброблені syncPiSkills)
- * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
- */
-async function syncLocalOnlyPiSkills(configSkills) {
-  const skillsRoot = join(cwd(), SKILLS_DIR)
-  if (!existsSync(skillsRoot)) return { success: 0, fail: 0 }
-
-  const piSkillsRoot = join(cwd(), PI_SKILLS_DIR)
-  await mkdir(piSkillsRoot, { recursive: true })
-
-  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const allDirNames = await listProjectSkillDirNames()
-  const localOnly = allDirNames.filter(d => !managedDirNames.has(d))
-
-  let success = 0
-  let fail = 0
-
-  for (const dirName of localOnly) {
-    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
-    const destDir = join(piSkillsRoot, dirName)
-    const destFile = join(destDir, 'SKILL.md')
-
-    process.stdout.write(`  ⬇  ${dirName} → ${PI_SKILLS_DIR}/${dirName}/SKILL.md ... `)
-    try {
-      let descRaw = ''
-      if (existsSync(skillMdPath)) {
-        const raw = await readFile(skillMdPath, 'utf8')
-        const parsed = extractSkillDescription(raw)
-        if (parsed) descRaw = parsed
-      }
-      await mkdir(destDir, { recursive: true })
-      const frontmatter = formatPiSkillFrontmatter(dirName, descRaw)
-      const header = `# ${dirName}\n\n`
-      const body = `${frontmatter}${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
-      await writeFile(destFile, body, 'utf8')
-      console.log(`✅`)
-      success++
-    } catch (error) {
-      console.log(`❌`)
-      console.error(`     Помилка: ${errorMessage(error)}`)
-      fail++
-    }
-  }
-  return { success, fail }
-}
-
-/**
- * Видаляє n-* директорії у .pi/skills, яких немає у конфігурації skills.
- * @param {string} piSkillsDir абсолютний шлях до .pi/skills
- * @param {string[]} configSkills id без префікса n-
- * @returns {Promise<string[]>} імена видалених директорій
- */
-async function removeOrphanManagedPiSkillDirs(piSkillsDir, configSkills) {
-  if (!existsSync(piSkillsDir)) return []
-  const expected = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const entries = await readdir(piSkillsDir, { withFileTypes: true })
-  const removed = []
-  for (const entry of entries) {
-    if (!(entry.isDirectory() && entry.name.startsWith(RULE_PREFIX) && !expected.has(entry.name))) {
-      continue
-    }
-
-    await rm(join(piSkillsDir, entry.name), { recursive: true, force: true })
-    removed.push(entry.name)
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Видаляє .pi/skills/{dirName} директорії локальних скілів, яких більше немає в .cursor/skills/.
- * @param {string} piSkillsDir абсолютний шлях до .pi/skills
- * @param {string[]} configSkills id керованих skills
- * @returns {Promise<string[]>} імена видалених директорій
- */
-async function removeOrphanLocalPiSkillDirs(piSkillsDir, configSkills) {
-  if (!existsSync(piSkillsDir)) return []
-  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
-  const allDirNames = new Set(await listProjectSkillDirNames())
-  const entries = await readdir(piSkillsDir, { withFileTypes: true })
-  const removed = []
-  for (const entry of entries) {
-    if (!entry.isDirectory() || entry.name.startsWith(RULE_PREFIX)) continue
-    if (!managedDirNames.has(entry.name) && !allDirNames.has(entry.name)) {
-      await rm(join(piSkillsDir, entry.name), { recursive: true, force: true })
-      removed.push(entry.name)
-    }
-  }
-  return removed.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Людинозрозумілий текст винятку для логів.
- * @param {unknown} error виняток із catch
- * @returns {string} текст повідомлення
- */
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error)
-}
-
-/**
- * Виконує крок синхронізації з уніфікованим логуванням помилки.
- * @template T
- * @param {string} prefix префікс повідомлення про помилку
- * @param {() => Promise<T>} action операція
- * @returns {Promise<T>} результат операції
- */
-async function runSyncStep(prefix, action) {
-  try {
-    return await action()
-  } catch (error) {
-    console.error(`${prefix}${errorMessage(error)}`)
-    throw error
-  }
-}
-
-/**
- * Виконує `action`, буферизуючи весь його stdout/console-вивід.
- *
- * Мотивація: за успішного прогону sync-блоку рядки `⬇ … ✅` і підсумок
- * (`🧩 Skills: N скопійовано, 0 з помилками`) не несуть користі й лише
- * захаращують термінал. Тому буфер скидається в реальний stdout **лише**
- * коли крок повернув `fail > 0` (або кинув виняток); за `fail === 0` —
- * відкидається мовчки.
- * @template T
- * @param {() => Promise<T>} action крок синку, що повертає обʼєкт із лічильником помилок `fail`
- * @returns {Promise<T>} результат `action` без змін
- */
-async function captureOutput(action) {
-  const buffer = []
-  const realStdoutWrite = process.stdout.write
-  const realLog = console.log
-  const realError = console.error
-  const flush = () => realStdoutWrite.call(process.stdout, buffer.join(''))
-  process.stdout.write = (...args) => {
-    const [chunk] = args
-    buffer.push(typeof chunk === 'string' ? chunk : chunk.toString())
-    const cb = args.find(arg => typeof arg === 'function')
-    if (cb) cb()
-    return true
-  }
-  console.log = (...args) => {
-    buffer.push(`${args.map(String).join(' ')}\n`)
-  }
-  console.error = (...args) => {
-    buffer.push(`${args.map(String).join(' ')}\n`)
-  }
-  try {
-    const result = await action()
-    if (result?.fail > 0) flush()
-    return result
-  } catch (error) {
-    flush()
-    throw error
-  } finally {
-    process.stdout.write = realStdoutWrite
-    console.log = realLog
-    console.error = realError
-  }
-}
-
-/**
- * Копіює керовані `.mdc` файли з пакету до `.cursor/rules`.
- * @param {string[]} rules список rules з конфігу
- * @param {string} bundledRulesDir каталог `rules` пакету-джерела (fallback для правил без явного джерела)
- * @param {string} rulesDir абсолютний шлях до `.cursor/rules`
- * @param {Map<string, string>} [ruleSources] мапа `ruleId → rulesDir` власника правила (ядро/плагін)
- * @param {Map<string, string[]>} [ruleExtras] мапа `ruleId → rules/<id>-теки` mixin-джерел (concern-mdc доінлайнюються)
- * @returns {Promise<{ successCount: number, failCount: number }>} статистика копіювання
- */
-async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources = new Map(), ruleExtras = new Map()) {
-  let successCount = 0
-  let failCount = 0
-  for (const rule of rules) {
-    const fileName = `${RULE_PREFIX}${normalizeRuleName(rule)}.mdc`
-    const destPath = join(rulesDir, fileName)
-    try {
-      process.stdout.write(`  ⬇  ${rule} → ${RULES_DIR}/${fileName} ... `)
-      const id = normalizeRuleName(rule)
-      const sourceDir = ruleSources.get(id) ?? bundledRulesDir
-      const content = await readBundledRuleContent(rule, sourceDir, ruleExtras.get(id) ?? [])
-      await writeFile(destPath, content, 'utf8')
-      console.log(`✅`)
-      successCount++
-    } catch (error) {
-      console.log(`❌`)
-      console.error(`     Помилка: ${errorMessage(error)}`)
-      failCount++
-    }
-  }
-  return { successCount, failCount }
-}
-
-/**
- * Логує видалені керовані правила/skills/commands у єдиному форматі.
- * @param {string} title назва сутностей
- * @param {string} basePath базовий шлях для виводу
- * @param {string[]} names перелік елементів
- * @returns {void}
- */
-function logRemovedManagedItems(title, basePath, names) {
-  if (names.length === 0) {
-    return
-  }
-  console.log(`\n🧹 Видалено ${title} поза списком ${CONFIG_FILE} (${names.length}):`)
-  for (const name of names) {
-    console.log(`   − ${basePath}/${name}`)
-  }
-}
-
-/**
- * Читає поле `version` з `package.json` пакету за абсолютним шляхом до його кореня.
- * @param {string} packageRoot корінь пакету (тека з `package.json`)
- * @returns {Promise<string | null>} semver рядком або null, якщо файлу/поля немає або JSON некоректний
- */
-async function readBundledVersionAt(packageRoot) {
-  const p = join(packageRoot, 'package.json')
-  if (!existsSync(p)) {
-    return null
-  }
-  try {
-    const pkg = JSON.parse(await readFile(p, 'utf8'))
-    return typeof pkg.version === 'string' ? pkg.version : null
-  } catch {
-    return null
-  }
-}
-
-/**
- * Якщо `upgradeNRulesToLatestAndBunInstall` встановив у `node_modules/@7n/rules` версію,
- * відмінну від тієї, з якої стартував поточний процес (наприклад, з npx-кешу), запускає бінар нової
- * версії через `spawnSync` і завершує поточний процес із успадкованим exit-кодом. Re-exec потрібен,
- * бо ES-модулі вже завантажені у V8 (RULE_MIGRATIONS, detectAutoRules тощо) і нова логіка
- * без повної заміни процесу не підхопиться. Захист від нескінченного циклу — env `NITRA_CURSOR_REEXEC=1`.
- *
- * Порівнює версії, **не** шляхи: коли `npx` резолвиться в локальний
- * `<projectRoot>/node_modules/@7n/rules` (проєкт уже має пакет у devDependencies),
- * `effectivePackageRoot` до і після `upgradeNRulesToLatestAndBunInstall` — той самий шлях,
- * `bun i` лише перезаписує файли за ним in-place. Читати "поточну" версію з цього шляху
- * ПІСЛЯ апгрейду означало б читати вже НОВУ версію — порівняння завжди збігалося б і
- * re-exec ніколи не спрацьовував би, попри те що в памʼяті процесу лишається старий код.
- * Тому `startVersion` фіксується викликачем ДО апгрейду.
- * @param {string} effectivePackageRoot шлях, повернутий `upgradeNRulesToLatestAndBunInstall`
- * @param {string | null} startVersion версія `@7n/rules`, з якою стартував процес (прочитана
- *   з `BUNDLED_PACKAGE_ROOT` до виклику `upgradeNRulesToLatestAndBunInstall`)
- * @returns {Promise<void>} повертається лише якщо re-exec не потрібен; інакше кидає `ReexecHandoff`,
- *   який ловить top-level catch і прокидає exit-код у `process.exitCode`
- */
-async function reexecIfPackageVersionChanged(effectivePackageRoot, startVersion) {
-  if (env.NITRA_CURSOR_REEXEC === '1') {
-    return
-  }
-  const installedVersion = await readBundledVersionAt(effectivePackageRoot)
-  if (!startVersion || !installedVersion || startVersion === installedVersion) {
-    return
-  }
-  const newBinPath = join(effectivePackageRoot, 'bin', 'n-rules.js')
-  if (!existsSync(newBinPath)) {
-    return
-  }
-  console.log(
-    `🔁 Перезапуск ${PACKAGE_NAME}: процес стартував на ${startVersion}, ` +
-      `після self-upgrade встановлено ${installedVersion}.\n` +
-      `   Re-exec свіжого бінаря, щоб підхопити нову логіку (RULE_MIGRATIONS, auto-detect тощо).\n`
-  )
-  const result = spawnSync(process.execPath, [newBinPath, ...process.argv.slice(2)], {
-    stdio: 'inherit',
-    env: { ...env, NITRA_CURSOR_REEXEC: '1' }
-  })
-  if (result.error) {
-    throw result.error
-  }
-  throw new ReexecHandoff(typeof result.status === 'number' ? result.status : 1)
+if (isRunAsCli(import.meta.url)) {
+  await runCli(process.argv.slice(2))
 }
-
-/**
- * Сентинельна помилка, яку кидає `reexecIfPackageVersionChanged` після успішного re-exec.
- * Top-level catch розпізнає її й виставляє `process.exitCode = code` без stack-trace —
- * процес тоді коректно завершується з тим самим кодом, що й child re-exec-у.
- */
-class ReexecHandoff extends Error {
-  /**
-   * @param {number} code exit-код, який повернув child-процес
-   */
-  constructor(code) {
-    super('reexec-handoff')
-    this.name = 'ReexecHandoff'
-    this.code = code
-  }
-}
-
-/**
- * Копіює правила з каталогу `mdc/` установленого пакету та синхронізує `.cursor/rules`
- * @returns {Promise<void>}
- */
-async function runSync() {
-  console.log(`\n🔧 ${PACKAGE_NAME} — завантаження cursor-правил\n`)
-
-  const projectRoot = cwd()
-  // Фіксуємо ДО апгрейду — див. коментар над reexecIfPackageVersionChanged.
-  const startVersion = await readBundledVersionAt(BUNDLED_PACKAGE_ROOT)
-  const effectivePackageRoot = await runSyncStep(`❌ Не вдалося оновити ${PACKAGE_NAME} або виконати bun i: `, () =>
-    upgradeNRulesToLatestAndBunInstall(projectRoot, BUNDLED_PACKAGE_ROOT)
-  )
-
-  await reexecIfPackageVersionChanged(effectivePackageRoot, startVersion)
-
-  const bundledRulesDir = join(effectivePackageRoot, 'rules')
-  const bundledSkillsDir = join(effectivePackageRoot, 'skills')
-  const bundledAgentsTemplatePath = join(effectivePackageRoot, AGENTS_TEMPLATE_FILE)
-
-  const config = await runSyncStep('❌ ', () => readConfig({ bundledRulesDir, bundledSkillsDir }))
-
-  const { rules, skills, version, ignore } = config
-  const claudeConfigEnabled = config['claude-config'] !== false
-  const bundledVer = await readBundledVersionAt(effectivePackageRoot)
-  if (bundledVer) {
-    const line =
-      effectivePackageRoot === BUNDLED_PACKAGE_ROOT
-        ? `📦 Джерело правил: ${PACKAGE_NAME}@${bundledVer}`
-        : `📦 Джерело правил: ${PACKAGE_NAME}@${bundledVer} (шлях: ${effectivePackageRoot})`
-    console.log(`${line}\n`)
-  }
-  if (version) {
-    console.log(`⚠️  Поле "version" у ${CONFIG_FILE} ігнорується; правила беруться з установленого пакету.\n`)
-  }
-  console.log(`📋 Правил до завантаження: ${rules.length}`)
-  console.log(`📋 Skills до синхронізації: ${skills.length}`)
-
-  await runSyncStep('❌ Не вдалося записати setup-bun-deps action: ', () =>
-    captureOutput(async () => {
-      const { destPath } = await syncSetupBunDepsAction(cwd(), effectivePackageRoot)
-      console.log(`📝 Оновлено ${destPath} (composite setup-bun-deps з пакету)\n`)
-    })
-  )
-
-  const rulesDir = join(cwd(), RULES_DIR)
-  await mkdir(rulesDir, { recursive: true })
-  // Джерела правил: ядро + rules/ плагінів (резолв кешований після readConfig).
-  const allRulesDirs = resolveRulesDirs(projectRoot, config, bundledRulesDir).map(d => d.rulesDir)
-  const { sources: ruleSources, extras: ruleExtras } = await aggregateRuleSources(allRulesDirs)
-  const { successCount, failCount } = await captureOutput(async () => {
-    const stats = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources, ruleExtras)
-    return { ...stats, fail: stats.failCount }
-  })
-
-  await runSyncStep(`❌ Не вдалося прибрати зайві файли в ${RULES_DIR}: `, async () => {
-    const removed = await removeOrphanManagedRuleFiles(rulesDir, rules)
-    logRemovedManagedItems('правила', RULES_DIR, removed)
-  })
-
-  await runSyncStep('❌ Skills: ', async () => {
-    const { fail: skillFail } = await captureOutput(async () => {
-      const { success: skillOk, fail } = await syncSkills(skills, bundledSkillsDir, config)
-      if (skills.length > 0) {
-        console.log(`\n🧩 Skills: ${skillOk} скопійовано, ${fail} з помилками`)
-      }
-      return { fail }
-    })
-    const removedSkills = await removeOrphanManagedSkillDirs(join(cwd(), SKILLS_DIR), skills)
-    logRemovedManagedItems('skills', SKILLS_DIR, removedSkills)
-    if (skillFail > 0) {
-      throw new Error(`Не вдалося скопіювати ${skillFail} з ${skills.length} skills`)
-    }
-  })
-
-  await runSyncStep('❌ Commands: ', async () => {
-    const { fail: totalFail } = await captureOutput(async () => {
-      const { success: cmdOk, fail: cmdFail } = await syncCommands(skills, bundledSkillsDir)
-      const { success: localOk, fail: localFail } = await syncLocalOnlySkillCommands(skills)
-      const totalOk = cmdOk + localOk
-      const fail = cmdFail + localFail
-      if (totalOk + fail > 0) {
-        console.log(`\n⌨️  Commands: ${totalOk} скопійовано, ${fail} з помилками`)
-      }
-      return { fail }
-    })
-    const commandsDir = join(cwd(), COMMANDS_DIR)
-    const removedCmds = await removeOrphanManagedCommandFiles(commandsDir, skills)
-    logRemovedManagedItems('commands', COMMANDS_DIR, removedCmds)
-    const removedLocalCmds = await removeOrphanLocalSkillCommandFiles(commandsDir, skills)
-    logRemovedManagedItems('commands (local)', COMMANDS_DIR, removedLocalCmds)
-    if (totalFail > 0) {
-      throw new Error(`Не вдалося скопіювати ${totalFail} commands`)
-    }
-  })
-
-  await runSyncStep('❌ Pi skills: ', async () => {
-    const { fail: totalFail } = await captureOutput(async () => {
-      const { success: piOk, fail: piFail } = await syncPiSkills(skills, bundledSkillsDir)
-      const { success: piLocalOk, fail: piLocalFail } = await syncLocalOnlyPiSkills(skills)
-      const totalOk = piOk + piLocalOk
-      const fail = piFail + piLocalFail
-      if (totalOk + fail > 0) {
-        console.log(`\n🥧 Pi skills: ${totalOk} скопійовано, ${fail} з помилками`)
-      }
-      return { fail }
-    })
-    const piSkillsDir = join(cwd(), PI_SKILLS_DIR)
-    const removedPi = await removeOrphanManagedPiSkillDirs(piSkillsDir, skills)
-    logRemovedManagedItems('pi skills', PI_SKILLS_DIR, removedPi)
-    const removedLocalPi = await removeOrphanLocalPiSkillDirs(piSkillsDir, skills)
-    logRemovedManagedItems('pi skills (local)', PI_SKILLS_DIR, removedLocalPi)
-    if (totalFail > 0) {
-      throw new Error(`Не вдалося скопіювати ${totalFail} pi skills`)
-    }
-  })
-
-  await runSyncStep(`❌ Не вдалося оновити ${AGENTS_FILE}: `, () =>
-    captureOutput(() => syncAgentsMd(bundledAgentsTemplatePath))
-  )
-  await runSyncStep('❌ Не вдалося оновити CLAUDE.md: ', () =>
-    captureOutput(() => syncClaudeMd(/** @type {string[] | undefined} */ (ignore)))
-  )
-
-  await runSyncStep('❌ Не вдалося синхронізувати Claude-конфіг: ', () =>
-    captureOutput(async () => {
-      const result = await syncClaudeConfig({
-        projectRoot: cwd(),
-        bundledPackageRoot: effectivePackageRoot,
-        enabled: claudeConfigEnabled,
-        rules
-      })
-      if (!claudeConfigEnabled) {
-        console.log('🤖 Claude-конфіг: пропущено (claude-config: false у .n-rules.json)')
-        return
-      }
-      const parts = []
-      if (result.settings) parts.push('.claude/settings.json')
-      if (result.cursorHooks) parts.push('.cursor/hooks.json')
-      if (result.commands.length > 0) parts.push(`${result.commands.length} slash-commands`)
-      if (result.adrHook) parts.push('.claude/hooks/capture-decisions.sh')
-      if (result.adrNormalizeHook) parts.push('.claude/hooks/normalize-decisions.sh')
-      if (result.adrHookLib?.length > 0) {
-        for (const libPath of result.adrHookLib) {
-          parts.push(libPath)
-        }
-      }
-      if (result.gitignoreAdr) parts.push('.gitignore (adr fragment)')
-      if (result.piExtension) parts.push('.pi/extensions/n-rules-adr/')
-      if (result.rtkPiExtension) parts.push('.pi/extensions/rtk.ts')
-      if (parts.length > 0) {
-        console.log(`🤖 Claude-конфіг: ${parts.join(', ')}`)
-      }
-    })
-  )
-
-  await runSyncStep('❌ Не вдалося оновити .gitignore (worktree): ', async () => {
-    const { written } = await syncGitignoreWorktree(cwd())
-    if (written) console.log('🌳 .gitignore (worktree): додано .worktrees/')
-  })
-
-  console.log(`\n✨ Готово: ${successCount} завантажено, ${failCount} з помилками\n`)
-  if (failCount > 0) {
-    throw new Error(`Не вдалося завантажити ${failCount} з ${rules.length} правил`)
-  }
-}
-
-/**
- * Команди, що мутують проєкт у CWD і вимагають кореня репо. `undefined`/`''` —
- * дефолтний sync; `check` — deprecated-alias `fix`. Решта (read-only,
- * `--root`-команди `doc-aggregate`/`rename-yaml-extensions`,
- * sub-лінтери) гард не зачіпає.
- */
-const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'lint', 'release'])
-
-/**
- * Короткий опис дії для тексту root-guard помилки за іменем команди.
- * @param {string | undefined} cmd підкоманда CLI (або undefined для дефолтного sync)
- * @returns {string} фраза «що саме мутує CWD»
- */
-function describeRootGuardedAction(cmd) {
-  switch (cmd) {
-    case undefined:
-    case '': {
-      return 'Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-rules.json і робить bun install у поточному каталозі'
-    }
-    case 'lint': {
-      return '`lint` за замовчуванням авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) і конформності (--full) у поточному каталозі'
-    }
-    case 'release': {
-      return '`release` бампає version і переписує CHANGELOG у поточному каталозі'
-    }
-    default: {
-      return 'Команда @7n/rules мутує проєкт у поточному каталозі'
-    }
-  }
-}
-
-/**
- * Довідка для `n-rules lint --help`: прапори unified lint surface
- * (spec 2026-06-29 fix-by-default, spec 2026-07-03 глобальна черга --full).
- */
-function printLintHelp() {
-  console.log(`Використання: npx @7n/rules lint [rule|concern ...] [прапори]
-
-За замовчуванням лінт іде дельтою (змінені файли vs origin) і одразу
-виправляє (auto-fix: oxfmt/eslint --fix/stylelint --fix + LLM-ladder).
-
-Прапори:
-  --full          Прогін по всьому репозиторію (конформність), не лише дельта.
-                  Один --full на машину: паралельні запуски стають у чергу
-                  й бачать живий прогрес активного прогону.
-  --no-fix        Лише детекція, без мутацій.
-  --cwd <path>    Робочий каталог (корінь прогону) замість поточного —
-                  root-guard, .n-rules.json і devDependencies читаються
-                  з нього.
-  --path <dir>    Звузити файловий набір до піддиректорії, лишивши корінь
-                  прогону незмінним (config/root-guard — з поточного каталогу
-                  чи --cwd). Дефолт — ПЕРЕТИН піддерева з git-дельтою
-                  (vs merge-base main/origin/main або --base), лише per-file
-                  правила (сервіс-орієнтований CI-канон). З --full — все
-                  піддерево, full-scope правила при спрацюванні йдуть по
-                  всьому репо (історична поведінка; без machine-wide локу).
-                  Сумісний із позиційним rule/concern-фільтром
-                  (lint js --path run/nexus).
-  --base <ref>    Явна база дельти (merge-base HEAD <ref>) замість каскаду
-                  main → origin/main — для CI-чекаутів.
-  --repo-wide     ЛИШЕ full-scope правила (knip, jscpd, dep-policy тощо),
-                  весь репозиторій — окремий CI-workflow, що не гейтить
-                  деплой сервісів. Не поєднується з --path/фільтром.
-  --verbose       Розширений вивід детекції та виправлення.
-  --help, -h      Ця довідка.
-
-Позиційні аргументи — фільтр за назвою правила чи concern, наприклад:
-  npx @7n/rules lint ga rego k8s docker text
-
-Приклади:
-  npx @7n/rules lint
-  npx @7n/rules lint --full
-  npx @7n/rules lint --no-fix eslint
-  npx @7n/rules lint --cwd ./packages/foo --verbose
-  npx @7n/rules lint js --path run/nexus --no-fix --base origin/main
-  npx @7n/rules lint --repo-wide --no-fix
-
-Skip-логіка CI (яка джоба взагалі потрібна): npx @7n/rules ci plan
-  ci plan [--path <dir>] [--base <ref>] [--github|--azure|--json]
-  --github → outputs у $GITHUB_OUTPUT; --azure → ##vso-рядки в stdout.
-`)
-}
-
-// CLI: маршрутизація команд
-let [command, ...args] = process.argv.slice(2)
-
-// Deprecated-аліаси до уніфікації lint-поверхні (spec 2026-06-29): старі
-// підкоманди `lint-<scope>` замінені на `lint <scope>`. Аліас тут — щоб
-// існуючі package.json/CI споживачів (lint-text/lint-ga тощо) не ламались
-// мовчки з непрозорим "Невідома команда" при мажорному бампі пакету.
-const LEGACY_LINT_COMMAND_ALIASES = {
-  'lint-ga': 'ga',
-  'lint-text': 'text',
-  'lint-rego': 'rego',
-  'lint-k8s': 'k8s',
-  'lint-docker': 'docker'
-}
-if (command in LEGACY_LINT_COMMAND_ALIASES) {
-  const scope = LEGACY_LINT_COMMAND_ALIASES[command]
-  console.error(`⚠️  "${command}" застаріла назва команди — використовуйте "n-rules lint ${scope}"`)
-  args = [scope, ...args]
-  command = 'lint'
-}
-
-// `lint --help`/`-h` — чиста довідка, без root-guard і без мутації devDependencies.
-const isLintHelp = command === 'lint' && (args.includes('--help') || args.includes('-h'))
-
-try {
-  if (isLintHelp) {
-    printLintHelp()
-  } else {
-    // Root-guard до перших мутацій: дефолтний sync скаффолдить .cursor/.claude/CLAUDE.md/
-    // .n-rules.json + bun install, а lint/release переписують файли в CWD —
-    // усе це ключиться на cwd(). Запуск із піддиректорії git-репо (типово прямий
-    // `bun npm/bin/n-rules.js` не з кореня) зачепив би не той каталог → STOP. Read-only та
-    // `--root`-команди (doc-aggregate, rename-yaml-extensions) не зачіпаємо.
-    // `lint` з явним `--cwd` — свідомий вибір кореня (MT ганяє `## Check` вузла з
-    // node-dir усередині worktree, live e2e 2026-07-12): guard і devDeps-ensure
-    // цілять у ЦІЛЬОВИЙ каталог, а не процесний cwd.
-    const lintCwdIdx = command === 'lint' ? args.indexOf('--cwd') : -1
-    const effectiveRoot = lintCwdIdx !== -1 && args[lintCwdIdx + 1] ? resolve(args[lintCwdIdx + 1]) : cwd()
-    if (ROOT_GUARDED_COMMANDS.has(command)) {
-      assertCwdIsProjectRoot(effectiveRoot, describeRootGuardedAction(command))
-    }
-    // `ci` (plan) — read-only гейт-команда для CI-джоб: не мутує package.json
-    // (ensure дописав би devDependency прямо в чекауті pipeline-агента).
-    // `skill <runner> taze` — JS-оркестрований worktree-only шлях
-    // (skills/taze/js/orchestrate.mjs): сам створює worktree і гейтить на
-    // чистоту дерева ДО checkout. Мутація тут забруднила б дерево прямо
-    // перед тим гейтом і провалювала б auto-create на інакше чистому дереві —
-    // оркестратор сам робить self-upgrade devDependency вже ВСЕРЕДИНІ
-    // щойно створеного worktree, після власного гейту чистоти.
-    // `lint --full` (без --no-fix/--path/--repo-wide) — той самий клас ризику:
-    // `needsWorktreeIsolation` нижче в `case 'lint'` гейтить на чистоту дерева
-    // ЧЕРЕЗ `ensureRunningInWorktree`; self-upgrade тут забруднив би те саме
-    // дерево прямо перед тим гейтом. Відкладаємо ensure до ПІСЛЯ
-    // `ensureRunningInWorktree` (виклик у `case 'lint'`, спрямований на runCwd).
-    const skipDevDepsEnsure =
-      (command === 'skill' && isTazeOrchestratorSkillArgs(args)) || (command === 'lint' && isLintFullFixArgs(args))
-    if (command !== 'ci' && !skipDevDepsEnsure) await ensureNRulesInRootDevDependencies(effectiveRoot)
-    // Підкоманди-оркестратори (hook/lint/skill/adr-normalize-local/taze/release тощо)
-    // можуть спавнити внутрішню agent/LLM-сесію — ADR Stop-hooks (capture/normalize)
-    // мають пропустити її як технічний шум, не людську думку (spec 2026-06-30).
-    env.ADR_HOOKS_SKIP = '1'
-    switch (command) {
-      case 'rename-yaml-extensions': {
-        const code = await runRenameYamlExtensionsCli(args)
-        if (code !== 0) {
-          process.exitCode = 1
-        }
-
-        break
-      }
-      case 'hook': {
-        // Thin hook entrypoint для Claude Code hooks. Делегує в runLint, перекодовує exit 1→2.
-        //   --post-tool-use  PostToolUse: file_path зі stdin JSON
-        //   --stop           Stop: робоче дерево vs HEAD
-        const { runHookCli } = await import('../scripts/hook.mjs')
-        process.exitCode = await runHookCli(args)
-
-        break
-      }
-      case 'lint': {
-        // Unified lint surface (spec 2026-06-29). Осі: --full (весь репо vs дельта) ×
-        // --no-fix (detect-only). Позиційні аргументи — scoped rule/concern фільтр.
-        // Fix-by-default: detect → T0 → LLM-ladder (run-fix). --no-fix: лише detect.
-        const cwdIdx = args.indexOf('--cwd')
-        const cwdArg = cwdIdx === -1 ? cwd() : resolve(args[cwdIdx + 1])
-        // --path: на відміну від --cwd (підміняє корінь), лишає корінь/config
-        // незмінними й лише звужує файловий набір до заданої піддиректорії
-        // (той самий explicitFiles-шлях, що вже годує hook --post-tool-use/--stop).
-        const pathIdx = args.indexOf('--path')
-        const pathArg = pathIdx === -1 ? null : args[pathIdx + 1]
-        // --base <ref>: явна база дельти для CI (merge-base HEAD ↔ ref замість
-        // каскаду main→origin/main) — надійний diff у checkout-ах з fetch.
-        const baseIdx = args.indexOf('--base')
-        const baseRef = baseIdx === -1 ? null : args[baseIdx + 1]
-        const repoWide = args.includes('--repo-wide')
-        const rules = args.filter(
-          (a, i) =>
-            !a.startsWith('-') &&
-            !(cwdIdx !== -1 && i === cwdIdx + 1) &&
-            !(pathIdx !== -1 && i === pathIdx + 1) &&
-            !(baseIdx !== -1 && i === baseIdx + 1)
-        )
-        if (repoWide && (pathArg !== null || rules.length > 0)) {
-          throw new Error('--repo-wide не поєднується з --path чи scoped rule/concern фільтром — оберіть щось одне')
-        }
-        // --path (сервіс-канон): дефолт — перетин піддерева з git-дельтою, лише
-        // per-file concerns (pathMode). --path --full — історична поведінка: все
-        // піддерево, full-scope concerns при збігу glob ідуть whole-repo. База
-        // дельти не резолвиться → fail-open на повне піддерево (не мовчазний скіп).
-        let pathFiles = null
-        let pathMode = false
-        if (pathArg !== null) {
-          const { collectPathScopedFiles, collectPathScopedChangedFiles } =
-            await import('../scripts/lib/lint-surface/path-scope.mjs')
-          if (args.includes('--full')) {
-            pathFiles = await collectPathScopedFiles(cwdArg, pathArg)
-          } else {
-            const scoped = await collectPathScopedChangedFiles(cwdArg, pathArg, { baseRef })
-            if (scoped.baseResolved) {
-              pathFiles = scoped.files
-              pathMode = true
-            } else {
-              console.warn(
-                '⚠️ lint --path: база дельти не резолвиться (немає main/origin/main чи --base-ref) — fail-open: лінтиться все піддерево'
-              )
-              pathFiles = await collectPathScopedFiles(cwdArg, pathArg)
-            }
-          }
-        }
-        // --full + --path: buildPlan ігнорує full, коли передано explicitFiles (той самий
-        // шлях), тож і тут full-вісь вважаємо неактивною — інакше глобальний machine-wide
-        // лок --full брався б для швидкого scoped-прогону без причини.
-        const full = args.includes('--full') && pathArg === null && !repoWide
-        const lintOpts = {
-          cwd: cwdArg,
-          full,
-          rules,
-          verbose: args.includes('--verbose'),
-          files: pathFiles,
-          pathMode,
-          repoWide,
-          baseRef
-        }
-        const noFix = args.includes('--no-fix')
-        // `--full` без `--no-fix` мутує ВЕСЬ репо (не лише дельту) — той самий клас
-        // ризику, що й taze: якщо запущено поза .worktrees/, треба ізолювати. `--no-fix`
-        // (detect-only, нуль мутацій) і не-full (дельта, за дизайном працює на живому
-        // дереві задачі, worktree-ізоляція зламала б саму суть дельти) — пропускаємо.
-        // (той самий предикат, що й `isLintFullFixArgs` вище — тримаємо єдиним джерелом,
-        // інакше `skipDevDepsEnsure` і цей гейт можуть розійтись.)
-        const needsWorktreeIsolation = full && !noFix
-        const worktree = needsWorktreeIsolation
-          ? await 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
-        // Ensure відкладений із root-guard-блоку (skipDevDepsEnsure вище) саме для
-        // цього шляху — self-upgrade тепер усередині (auto-created) worktree, ПІСЛЯ
-        // гейту чистоти, а не до нього.
-        if (needsWorktreeIsolation) await ensureNRulesInRootDevDependencies(runCwd)
-        // Глобальна черга 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')
-        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) {
-            let bringBackFailed = true
-            try {
-              const bringBackResult = await bringChangesBackToOriginal(runCwd, cwdArg, spawnSync, line =>
-                console.log(line)
-              )
-              bringBackFailed = bringBackResult.failed
-            } catch (error) {
-              console.log(
-                `⚠️ Перенесення змін назад провалилось: ${error instanceof Error ? error.message : String(error)}`
-              )
-            }
-            // Прибираємо worktree лише якщо перенесення точно вдалось — інакше
-            // не перенесені зміни згорять разом з деревом.
-            if (bringBackFailed) {
-              console.log(
-                `⚠️ Перенесення назад не підтверджено — worktree "${worktree.branchArg}" лишається для ручного розбору.`
-              )
-            } else {
-              removeAutoCreatedWorktree(worktree.branchArg, cwdArg, spawnSync, line => console.log(line))
-            }
-          }
-        }
-
-        break
-      }
-      case 'ci': {
-        // n-rules ci plan — skip-логіка сервіс-орієнтованого CI-канону: рахує
-        // перетин git-дельти з --path (каталог сервісу) і віддає job outputs
-        // «які lint-домени запускати» для GitHub Actions (--github →
-        // $GITHUB_OUTPUT) та Azure Pipelines (--azure → ##vso-рядки).
-        const { runCiPlanCli } = await import('../scripts/lib/lint-surface/ci-plan.mjs')
-        process.exitCode = await runCiPlanCli(args)
-
-        break
-      }
-      case 'taze': {
-        // n-rules taze diff — read-only semver-diff package.json ↔ package.json.taze-bak
-        // (root + воркспейси) для скілу n-taze: скрипт класифікує major-оновлення,
-        // агент отримує готовий список замість ручного порівняння бекапів.
-        // Живе у плагіні @7n/rules-lang-js (фаза 5a spec lang-plugins-extraction) —
-        // резолвимо його taze-handler і беремо named-експорт runTazeCli.
-        const { getHandlers } = await import('../scripts/lib/resolve-plugins.mjs')
-        const { readNRulesConfigLite } = await import('../scripts/lib/read-n-rules-config-lite.mjs')
-        const config = await readNRulesConfigLite(cwd())
-        const handler = getHandlers(cwd(), config, 'taze').find(h => h.pluginName === '@7n/rules-lang-js')
-        if (!handler) {
-          console.error(
-            '❌ taze diff потребує плагін @7n/rules-lang-js (npm/bun-гілка) — запусти npx @7n/rules для авто-встановлення'
-          )
-          process.exitCode = 1
-          break
-        }
-        const { pathToFileURL } = await import('node:url')
-        // eslint-disable-next-line no-unsanitized/method
-        const { runTazeCli } = await import(pathToFileURL(handler.modulePath).href)
-        process.exitCode = await runTazeCli(args)
-
-        break
-      }
-      case 'release': {
-        const { runReleaseCli } = await import('../rules/release/release.mjs')
-        process.exitCode = await runReleaseCli(args)
-
-        break
-      }
-      case 'skill': {
-        process.exitCode = await runSkillsCli(args)
-
-        break
-      }
-      case 'adr-normalize-local': {
-        // Local-backend ADR-нормалізації: викликається з .claude/hooks/normalize-decisions.sh
-        // як заміна single-shot LLM-виклику. Проганяє конвеєр (retrieval→edge-judge→
-        // cluster→gen) на малій локальній моделі й друкує `{operations}` JSON у stdout.
-        const { runAdrNormalizeLocalCli } = await import('../scripts/lib/adr/normalize-cli.mjs')
-        process.exitCode = await runAdrNormalizeLocalCli(args)
-
-        break
-      }
-      case undefined:
-      case '': {
-        await runSync()
-
-        break
-      }
-      default: {
-        console.error(`❌ Невідома команда: ${command}`)
-        console.error(
-          `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, hook, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), ci plan, taze, release, skill, doc-aggregate`
-        )
-        process.exitCode = 1
-      }
-    }
-  }
-} catch (error) {
-  // TypeError/RangeError/ReferenceError сигналять баг у самому коді (не навмисне
-  // user-facing повідомлення) — друкуємо stack одразу, інакше діагностика вимагає
-  // патчити node_modules вручну (як під час діагностики цього ж класу вад).
-  const isProgrammerError = error instanceof TypeError || error instanceof RangeError || error instanceof ReferenceError
-  if (error instanceof ReexecHandoff) {
-    process.exitCode = error.code
-  } else if (isProgrammerError && error.stack) {
-    console.error(error.stack)
-    process.exitCode = 1
-  } else if (error instanceof Error && error.message) {
-    console.error(error.message)
-    process.exitCode = 1
-  } else {
-    console.error(error)
-    process.exitCode = 1
-  }
-}
-
-// Pi-агент тримає TCP keep-alive сокет відкритим — явний вихід, щоб не висіти.
-// Відтворюємо семантику process.exit() без самого виклику (n/no-process-exit):
-// фіксуємо код, віддаємо 'exit'-слухачам, далі — примусове завершення через reallyExit.
-const exitCode = process.exitCode ?? 0
-process.exitCode = exitCode
-process.emit('exit', exitCode)
-process.reallyExit(exitCode)