@7n/rules 1.5.0 → 1.6.0

package/.claude-template/hooks/.gitignore.snippet

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+*.secret
+
+# @7n/rules (adr) — локальні артефакти Stop-hook, не коміти
+.claude/hooks/*.log
+.claude/hooks/.normalize-state
+.claude/hooks/.normalize.lock
+.claude/scheduled_tasks.lock

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.6.0] - 2026-07-16
+
+### Changed
+
+- CI-концерни провайдерів: 12 workflow-концернів (lint_*_yml, npm_publish_yml, toolchain_cache, clean_merged_ignore_branches) перенесено у @7n/rules-ci-github; multi-dir mdc-інлайн mixin-концернів у дзеркала правил; рефакторинг aggregateRuleSources
+
+## [1.5.1] - 2026-07-16
+
+### Fixed
+
+- sync-claude-config: відновлено `.gitignore.snippet` для ADR Stop-hook (загублено при переструктуруванні rules/adr на per-concern layout)
+
 ## [1.5.0] - 2026-07-15
 
 ### Added

package/bin/n-rules.js

@@ -258,27 +258,78 @@ async function readRootPackageJsonSafe() {
  * Агрегує імена правил по rules-каталогах (ядро перше, перший власник виграє)
  * і будує мапу `ruleId → rulesDir` для копіювання mdc.
  * @param {string[]} rulesDirs упорядковані rules-каталоги (ядро + плагіни)
- * @returns {Promise<{ names: string[], sources: Map<string, string> }>} імена правил і їх джерела
+ * @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()) {
-    let names
     if (i === 0) {
-      names = await discoverBundledRuleNames(dir) // ядро: відсутність каталогу — фатальна помилка
-    } else {
-      try {
-        names = await discoverBundledRuleNames(dir)
-      } catch {
-        continue // плагін без валідного rules/ — уже повідомлено у resolve-plugins
-      }
+      out.push(await discoverBundledRuleNames(dir))
+      continue
     }
-    for (const name of names) {
-      if (!sources.has(name)) sources.set(name, dir)
+    try {
+      out.push(await discoverBundledRuleNames(dir))
+    } catch {
+      out.push([])
     }
   }
-  return { names: sources.keys().toArray(), sources }
+  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)
+  }
 }
 
 /**
@@ -461,11 +512,16 @@ function normalizeRuleName(ruleName) {
 /**
  * Читає вміст правила з каталогу `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/` у корені пакету-джерела
+ * @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) {
+async function readBundledRuleContent(rule, bundledRulesDir = BUNDLED_RULES_DIR, extraRuleDirs = []) {
   const id = normalizeRuleName(rule)
   const bundledPath = join(bundledRulesDir, id, 'main.mdc')
   if (!existsSync(bundledPath)) {
@@ -474,8 +530,12 @@ async function readBundledRuleContent(rule, bundledRulesDir = BUNDLED_RULES_DIR)
     )
   }
   const text = await readFile(bundledPath, 'utf8')
-  const withTemplates = await inlineTemplateLinks(text, dirname(bundledPath))
-  return appendDiscoveredMdcFiles(withTemplates, dirname(bundledPath))
+  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
 }
 
 /**
@@ -1243,9 +1303,10 @@ async function captureOutput(action) {
  * @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()) {
+async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources = new Map(), ruleExtras = new Map()) {
   let successCount = 0
   let failCount = 0
   for (const rule of rules) {
@@ -1253,8 +1314,9 @@ async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSource
     const destPath = join(rulesDir, fileName)
     try {
       process.stdout.write(`  ⬇  ${rule} → ${RULES_DIR}/${fileName} ... `)
-      const sourceDir = ruleSources.get(normalizeRuleName(rule)) ?? bundledRulesDir
-      const content = await readBundledRuleContent(rule, sourceDir)
+      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++
@@ -1406,9 +1468,9 @@ async function runSync() {
   await mkdir(rulesDir, { recursive: true })
   // Джерела правил: ядро + rules/ плагінів (резолв кешований після readConfig).
   const allRulesDirs = resolveRulesDirs(projectRoot, config, bundledRulesDir).map(d => d.rulesDir)
-  const { sources: ruleSources } = await aggregateRuleSources(allRulesDirs)
+  const { sources: ruleSources, extras: ruleExtras } = await aggregateRuleSources(allRulesDirs)
   const { successCount, failCount } = await captureOutput(async () => {
-    const stats = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources)
+    const stats = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources, ruleExtras)
     return { ...stats, fail: stats.failCount }
   })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/rules/abie/main.mdc

@@ -24,12 +24,6 @@ version: '1.22'
 bun add -d @nitra/abie-shared
 ```
 
-## Git branches
-
-У **`.github/workflows/clean-merged-branch.yml`** у кроці **`phpdocker-io/github-actions-delete-abandoned-branches`** значення **`with.ignore_branches`** має містити **dev** та **ua** (разом з іншими гілками, якщо потрібно):
-
-- abie-specific канон (action marker + required ignore_branches tokens): [clean-merged-branch.yml.snippet.yml](./clean_merged_ignore_branches/template/clean-merged-branch.yml.snippet.yml)
-
 ## Швидкий gate через conftest (Rego)
 
 Підмножину пер-документних правил продубльовано як rego-полісі у **`npm/rules/abie/policy/`** (запускається через **`bun run lint-rego`** для `*_test.rego` юніт-тестів і через **`npx @7n/rules fix abie`** для прогону по реальних YAML — деталі в **conftest.mdc** / **n-rego.mdc**). JS у **`js/<concern>.mjs`** authoritative — rego тільки швидкий gate для одиничного маніфеста (зокрема через IDE-розширення `tsandall.opa`).

package/rules/js/check/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/js/check/main.mjs
 docgen:
-  crc: 8858d876
+  crc: 0b9c8a32
   model: manual
 ---
 

package/rules/js/check/main.mjs

@@ -235,21 +235,17 @@ async function checkOxlintRc(passFn, failFn, cwd) {
 }
 
 /**
- * FS-existence для `lint-js.yml` + cross-file перевірка, що `lint.yml` (якщо існує)
- * не дублює лінт JS-кроки. Структуру `lint-js.yml` (`actions/checkout@v6`,
- * `persist-credentials: false`, `setup-bun-deps`, `bunx oxlint/eslint/jscpd .`,
- * заборона `--fix` у CI) валідує `npm/policy/js_lint/lint_js_yml/`.
+ * Cross-file перевірка: `lint.yml` (якщо існує) не дублює лінт JS-кроки з `lint-js.yml`.
+ * Existence і структуру `lint-js.yml` валідує mixin-концерн `js/lint_js_yml`
+ * плагіна `@7n/rules-ci-github` (провайдер-специфіка — поза ядром).
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  * @param {string} cwd корінь репозиторію
  */
 async function checkLintJsWorkflows(passFn, failFn, cwd) {
-  if (existsSync(join(cwd, '.github/workflows/lint-js.yml'))) {
-    passFn('.github/workflows/lint-js.yml є (структуру перевіряє npx @7n/rules fix → js_lint.lint_js_yml)')
-  } else {
-    failFn('.github/workflows/lint-js.yml не існує — створи його (js.mdc)')
-  }
-
+  // Existence/структуру lint-js.yml вимагає провайдер-плагін @7n/rules-ci-github
+  // (mixin js/lint_js_yml, policy required) — ядро провайдер-агностичне і тут
+  // перевіряє лише крос-файловий дубляж, коли GitHub-workflow уже існують.
   const lintYmlPath = join(cwd, '.github/workflows/lint.yml')
   if (existsSync(lintYmlPath)) {
     const lintYml = await readFile(lintYmlPath, 'utf8')

package/rules/js/main.mdc

@@ -13,7 +13,6 @@ version: '1.31'
 
 Rego-пакети — запускаються `npx @7n/rules lint js` або `conftest`:
 
-- [lint-js.yml.snippet.yml](./lint_js_yml/template/lint-js.yml.snippet.yml)
 - [.jscpd.json.snippet.json](./jscpd_config/template/.jscpd.json.snippet.json)
 - [extensions.json.snippet.json](./vscode_extensions/template/extensions.json.snippet.json)
 - [package.json.snippet.json](./package_json/template/package.json.snippet.json)

package/rules/js/vscode_extensions/template/extensions.json.snippet.json

@@ -1,3 +1,6 @@
 {
-  "recommendations": ["dbaeumer.vscode-eslint", "github.vscode-github-actions", "oxc.oxc-vscode"]
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "oxc.oxc-vscode"
+  ]
 }

package/rules/npm-module/main.mdc

@@ -31,8 +31,6 @@ Bun monorepo: workspace **`npm/`**, кореневий **`package.json`**, **`.g
 
 Rego-пакети (запускаються через `npx @7n/rules fix`):
 
-- `npm_module.npm_publish_yml` — template-driven перевірка `.github/workflows/npm-publish.yml` (deep-subset: усі обовʼязкові поля й кроки з канонічного сніпету).
 - [package.json.snippet.json](./npm_package_json/template/package.json.snippet.json)
-- [npm-publish.yml.snippet.yml](./npm_publish_yml/template/npm-publish.yml.snippet.yml)
 - [package.json.snippet.json](./root_package_json/template/package.json.snippet.json)
 - [tsconfig.emit-types.json.snippet.json](./emit_types_config/template/tsconfig.emit-types.json.snippet.json)

package/rules/php/tooling/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/php/tooling/main.mjs
 docgen:
-  crc: 91381cd7
+  crc: c49aaee6
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/rules/php/tooling/main.mjs

@@ -24,12 +24,7 @@ export function lint(ctx) {
     fail('package.json не знайдено в корені — додай (php.mdc)')
   }
 
-  const wfPath = '.github/workflows/lint-php.yml'
-  if (existsSync(wfPath)) {
-    pass(`${wfPath} є (структуру перевіряє npx @7n/rules fix → php.lint_php_yml)`)
-  } else {
-    fail(`${wfPath} не існує — створи згідно php.mdc`)
-  }
-
+  // Existence/структуру lint-php.yml вимагає провайдер-плагін @7n/rules-ci-github
+  // (mixin php/lint_php_yml) — ядро провайдер-агностичне.
   return Promise.resolve(reporter.result())
 }

package/rules/python/tooling/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/tooling/main.mjs
 docgen:
-  crc: c46acc00
+  crc: 98ec5b8e
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
   issues: surzhik,judge:inaccurate:0.98

package/rules/python/tooling/main.mjs

@@ -39,12 +39,7 @@ export function lint(ctx) {
     fail('package.json не знайдено в корені — додай (python.mdc)')
   }
 
-  const wfPath = '.github/workflows/lint-python.yml'
-  if (existsSync(join(cwd, wfPath))) {
-    pass(`${wfPath} є (структуру перевіряє fix → python.lint_python_yml)`)
-  } else {
-    fail(`${wfPath} не існує — створи згідно python.mdc`)
-  }
-
+  // Existence/структуру lint-python.yml вимагає провайдер-плагін @7n/rules-ci-github
+  // (mixin python/lint_python_yml) — ядро провайдер-агностичне.
   return Promise.resolve(reporter.result())
 }

package/rules/rego/lib/docs/run-external-tool.md

@@ -3,9 +3,8 @@ type: JS Module
 title: run-external-tool.mjs
 resource: npm/rules/rego/lib/run-external-tool.mjs
 docgen:
-  crc: 298f9908
+  crc: 0f1da640
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 100
   issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/rego/lib/run-external-tool.mjs

@@ -24,7 +24,10 @@ const TEST_SUFFIX_RE = /_test\.rego$/u
  * @returns {string[]} цілі для CLI-аргументів інструменту (можливо порожній список).
  */
 export function resolveTargets(files, root) {
-  if (files === undefined) return existsSync(resolve(root, FULL_TARGET)) ? [FULL_TARGET] : []
+  if (files === undefined) {
+    // Full-режим: policy-корінь ядра + rego плагінів (монорепо @7n/rules)
+    return [FULL_TARGET, 'plugins'].filter(t => existsSync(resolve(root, t)))
+  }
   const rego = files.filter(f => REGO_EXT_RE.test(f))
   // `X_test.rego` імпортує сусідній `X.rego`: без нього regal флагує unresolved-import,
   // тож до delta-цілей додаємо наявний сусідній policy-файл.

package/rules/security/main.mdc

@@ -11,5 +11,4 @@ version: '2.1'
 
 `npx @7n/rules fix security`
 
-- [lint-security.yml.snippet.yml](./lint_security_yml/template/lint-security.yml.snippet.yml)
 - [package.json.deny.json](./package_json/template/package.json.deny.json)

package/rules/style/main.mdc

@@ -8,6 +8,5 @@ alwaysApply: false
 Правило **style** для Vue-проєктів: Quasar як стильова система, SCSS-конвенції кольорів і відступів, фікси компонентів, stylelint через `@nitra/stylelint-config`.
 
 - [settings.json.snippet.json](./vscode_settings/template/settings.json.snippet.json)
-- [lint-style.yml.snippet.yml](./lint_style_yml/template/lint-style.yml.snippet.yml)
 - [extensions.json.snippet.json](./vscode_extensions/template/extensions.json.snippet.json)
 - [package.json.snippet.json](./package_json/template/package.json.snippet.json)

package/rules/style/tooling/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/style/tooling/main.mjs
 docgen:
-  crc: 4333b971
+  crc: 015d1c9a
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
   issues: anchor-miss:extensions.json,anchor-miss:settings.json,judge:inaccurate:0.99

package/rules/style/tooling/main.mjs

@@ -67,12 +67,7 @@ export async function lint(ctx) {
     fail('.stylelintignore не існує — створи з вмістом: dist/')
   }
 
-  const wfPath = '.github/workflows/lint-style.yml'
-  if (existsSync(join(cwd, wfPath))) {
-    pass(`${wfPath} є (структуру перевіряє npx @7n/rules fix → style_lint.lint_style_yml)`)
-  } else {
-    fail(`${wfPath} не існує — створи його`)
-  }
-
+  // Existence/структуру lint-style.yml вимагає провайдер-плагін @7n/rules-ci-github
+  // (mixin style/lint_style_yml) — ядро провайдер-агностичне.
   return reporter.result()
 }

package/rules/tauri/release/release.mdc

@@ -10,7 +10,7 @@ Change-файл (`<app>/.changes/<ts>.md`) створюється **одразу
 чіпає код Tauri-workspace — той самий момент, що lint і doc-files, а не окремий крок після
 сигналу `changeset-missing` від delta-lint concern `changelog/presence`. Без нього мердж у
 `main` не тригерить `changelog-release.yml` (тригер — `paths: [app/.changes/**]`), і зміна
-осідає в репозиторії без релізу, доки хтось не помітить і не докомітить change-файл окремо.
+осідає в репозиторії без релізу, доки хтось не помітить і не додасть change-файл у коміт окремо.
 
 Команда: `npx @7n/n ch --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<опис>"`
 (інтерактивно — `npx @7n/n ch`). Повна модель (база порівняння, формат CHANGELOG,

package/rules/text/formatting/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/formatting/main.mjs
 docgen:
-  crc: 2621711a
+  crc: ac0f783c
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: best-of-2:retry-won,judge:inaccurate:0.99

package/rules/text/formatting/main.mjs

@@ -103,19 +103,19 @@ function checkTextConfigsExistence(passFn, failFn, cwd) {
  * @param {string} cwd корінь репозиторію
  */
 async function checkLintTextWorkflow(passFn, failFn, cwd) {
+  // Existence lint-text.yml вимагає провайдер-плагін @7n/rules-ci-github (mixin
+  // text/lint_text) — ядро провайдер-агностичне; тут лише перевірка вмісту,
+  // коли GitHub-workflow уже існує.
   const lintTextWf = join(cwd, '.github/workflows/lint-text.yml')
-  if (existsSync(lintTextWf)) {
-    const wf = await readFile(lintTextWf, 'utf8')
-    const root = parseWorkflowYaml(wf)
-    const canonRun = 'n-rules lint text --no-fix'
-    const ok = root ? anyRunStepIncludes(root, canonRun) : wf.includes(canonRun)
-    if (ok) {
-      passFn(`lint-text.yml викликає ${canonRun}`)
-    } else {
-      failFn(`lint-text.yml має містити крок ${canonRun} (CI — read-only, нуль мутацій)`)
-    }
+  if (!existsSync(lintTextWf)) return
+  const wf = await readFile(lintTextWf, 'utf8')
+  const root = parseWorkflowYaml(wf)
+  const canonRun = 'n-rules lint text --no-fix'
+  const ok = root ? anyRunStepIncludes(root, canonRun) : wf.includes(canonRun)
+  if (ok) {
+    passFn(`lint-text.yml викликає ${canonRun}`)
   } else {
-    failFn('.github/workflows/lint-text.yml не існує — створи згідно n-text.mdc')
+    failFn(`lint-text.yml має містити крок ${canonRun} (CI — read-only, нуль мутацій)`)
   }
 }
 

package/rules/text/main.mdc

@@ -17,7 +17,6 @@ Rego-пакети, що перевіряються через conftest (auto-dis
 - [.cspell.json.deny.json](./cspell/template/.cspell.json.deny.json)
 - [.cspell.json.contains.json](./cspell/template/.cspell.json.contains.json)
 - [extensions.json.snippet.json](./vscode_extensions/template/extensions.json.snippet.json)
-- [lint-text.yml.snippet.yml](./lint_text/template/lint-text.yml.snippet.yml)
 - [package.json.deny.json](./package_json/template/package.json.deny.json)
 
 **Український апостроф:** у словах вживай прямий апостроф U+0027 (`'`, як в `об'єкт`), а не типографський U+2019 (`’`); слова з апострофом додавай у масив `words` cspell-конфігу.

package/scripts/docs/skills-cli.md

@@ -3,7 +3,7 @@ type: JS Module
 title: skills-cli.mjs
 resource: npm/scripts/skills-cli.mjs
 docgen:
-  crc: 33d8696c
+  crc: ce3d7d60
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 
@@ -30,7 +30,7 @@ runSkillsCli виконує логіку командного інтерфейс
 
 ## Гарантії поведінки
 
-- Сам модуль лише читає файли й збирає промпт; **виконання** делегується агенту: `pi` (вбудований, мутує дерево, запускає bash) або зовнішньому ACP-агенту `cursor`/`codex`/`claude` через `runAcpRunner` (`./lib/acp-runner.mjs`) — JSON-RPC поверх stdio (`cursor-agent acp`, бандловані адаптери `@agentclientprotocol/codex-acp` і `@agentclientprotocol/claude-agent-acp`), а не сирий `stdin`/`stdout`-піпінг.
+- Сам модуль лише читає файли й збирає промпт; **виконання** делегується агенту: `pi` (вбудований, мутує дерево, запускає bash) або зовнішньому ACP-агенту `cursor`/`codex`/`claude` через `runAcpRunner` (`./lib/acp-runner.mjs`) — JSON-RPC поверх stdio (`cursor-agent acp`, вбудовані адаптери `@agentclientprotocol/codex-acp` і `@agentclientprotocol/claude-agent-acp`), а не сирий `stdin`/`stdout`-pipe-передавання.
 - Тира моделі для `pi`-runner береться з `main.json.tier` скіла (дефолт `max`).
-- ACP-раннер автоапрувляє `session/request_permission` (без інтерактивних питань) — паритет із колишнім non-interactive режимом; `Client`-реалізація читає/пише файли напряму через `node:fs`.
+- ACP-раннер автоматично схвалює `session/request_permission` (без інтерактивних питань) — паритет із колишнім non-interactive режимом; `Client`-реалізація читає/пише файли напряму через `node:fs`.
 - Лише `claude` — deprecated: друкує попередження й лишається як fallback, доки не налаштовано pi-модель. `cursor`/`codex` — повноцінні раннери без попередження.

package/scripts/docs/sync-claude-config.md

@@ -3,7 +3,7 @@ type: JS Module
 title: sync-claude-config.mjs
 resource: npm/scripts/sync-claude-config.mjs
 docgen:
-  crc: e4513e7a
+  crc: 177ad3ea
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 85
 ---

package/scripts/lib/acp-runner.mjs

@@ -1,17 +1,17 @@
 /**
  * Виконання скіла через зовнішнього ACP-агента (Agent Client Protocol,
  * agentclientprotocol.com) — JSON-RPC поверх stdio замість сирого
- * `stdin`/`stdout`-піпінгу CLI.
+ * `stdin`/`stdout`-передавання через pipe CLI.
  *
  * Заміняє колишній `runLlmCli` (spawnSync + `-p`/`exec -`) для `cursor`/`codex`/`claude`:
  * підʼєднання йде через офіційний TS SDK `@zed-industries/agent-client-protocol`,
- * а дозволи на tool-calls (`session/request_permission`) автоапрувляться без участі
+ * а дозволи на tool-calls (`session/request_permission`) автоматично схвалюються без участі
  * людини — паритет із сьогоднішнім non-interactive `-p`-режимом (full user-trust,
  * без write-guard, як задокументовано в `@7n/llm-lib/agent-skill`).
  *
  * `cursor` — нативний ACP-режим самого `cursor-agent` (`cursor-agent acp`).
  * `codex`/`claude` — офіційні адаптери (`@agentclientprotocol/codex-acp`,
- * `@agentclientprotocol/claude-agent-acp`), що бандлять свій рушій — зовнішній
+ * `@agentclientprotocol/claude-agent-acp`), що вбудовують свій рушій — зовнішній
  * бінарник `codex`/`claude` у PATH більше не потрібен.
  */
 
@@ -26,7 +26,7 @@ const require = createRequire(import.meta.url)
 
 /**
  * Команда запуску ACP-агента на провайдер. `cursor` — зовнішній бінарник у PATH;
- * `codex`/`claude` — резолвляться з `bin`-запису бандлованого npm-пакета-адаптера.
+ * `codex`/`claude` — резолвляться з `bin`-запису вбудованого npm-пакета-адаптера.
  * @type {Record<'cursor' | 'codex' | 'claude', { bin: string, args: string[] } | { adapterPackage: string }>}
  */
 export const ACP_AGENT_COMMANDS = {
@@ -45,7 +45,7 @@ export function stopReasonToExitCode(stopReason) {
 }
 
 /**
- * Резолвить абсолютний шлях до bin-файлу бандлованого ACP-адаптера з його `package.json`.
+ * Резолвить абсолютний шлях до bin-файлу вбудованого ACP-адаптера з його `package.json`.
  * @param {string} adapterPackage назва npm-пакета адаптера (`@agentclientprotocol/codex-acp`, …)
  * @returns {string} абсолютний шлях до виконуваного файлу адаптера
  */
@@ -71,7 +71,7 @@ export function pickAutoPermissionOptionId(options) {
 }
 
 /**
- * ACP `Client` для скіл-раннера: автоапрув дозволів, стрім тексту в stdout,
+ * ACP `Client` для скіл-раннера: автоматичне схвалення дозволів, стрім тексту в stdout,
  * пряма реалізація файлового вводу-виводу поверх `node:fs` (full-trust режим).
  */
 class AcpSkillClient {
@@ -84,7 +84,7 @@ class AcpSkillClient {
 
   /**
    * @param {{ options: { optionId: string, kind: string }[] }} params запит дозволу від агента
-   * @returns {Promise<{ outcome: { outcome: 'selected', optionId: string } }>} автообраний варіант
+   * @returns {Promise<{ outcome: { outcome: 'selected', optionId: string } }>} автоматично обраний варіант
    */
   requestPermission(params) {
     return Promise.resolve({ outcome: { outcome: 'selected', optionId: pickAutoPermissionOptionId(params.options) } })
@@ -136,9 +136,7 @@ export async function runAcpRunner(kind, prompt, projectDir, logError, deps = {}
 
   const command = ACP_AGENT_COMMANDS[kind]
   const { bin, args } =
-    'adapterPackage' in command
-      ? { bin: process.execPath, args: [resolveBin(command.adapterPackage)] }
-      : command
+    'adapterPackage' in command ? { bin: process.execPath, args: [resolveBin(command.adapterPackage)] } : command
 
   if ('bin' in command && deps.isBinaryInPath && !deps.isBinaryInPath(command.bin)) {
     throw new Error(`\`${command.bin}\` not found in PATH. Install ${kind} CLI (ACP mode) or use \`skill pi\`.`)

package/scripts/lib/docs/acp-runner.md

@@ -12,7 +12,7 @@ agentclientprotocol.com) — JSON-RPC поверх stdio замість сиро
 для раннерів `cursor`/`codex`/`claude` у `skills-cli.mjs`.
 
 `cursor` запускається через нативний ACP-режим `cursor-agent acp` (зовнішній
-бінарник у PATH). `codex`/`claude` — через офіційні бандловані адаптери
+бінарник у PATH). `codex`/`claude` — через офіційні вбудовані адаптери
 (`@agentclientprotocol/codex-acp`, `@agentclientprotocol/claude-agent-acp`), що
 самі керують своїм рушієм — зовнішній бінарник `codex`/`claude` у PATH більше
 не потрібен.
@@ -20,7 +20,7 @@ agentclientprotocol.com) — JSON-RPC поверх stdio замість сиро
 ## Поведінка
 
 - `ACP_AGENT_COMMANDS` — команда запуску агента на провайдер: `cursor` — бінарник
-  у PATH; `codex`/`claude` — резолвляться з `bin`-запису бандлованого пакета-адаптера.
+  у PATH; `codex`/`claude` — резолвляться з `bin`-запису вбудованого пакета-адаптера.
 - `stopReasonToExitCode` — мапить ACP `StopReason` прогону на exit code: `end_turn` → `0`,
   усе інше (`max_tokens`, `max_turn_requests`, `refusal`, `cancelled`) → `1`.
 - `resolveAdapterBin` — резолвить абсолютний шлях до bin-файлу адаптера з його `package.json`.
@@ -29,7 +29,7 @@ agentclientprotocol.com) — JSON-RPC поверх stdio замість сиро
   режимом — скіл є явною user-invocation, тож дозволи на tool-calls не питаються
   інтерактивно.
 - `AcpSkillClient` (internal) — ACP `Client` для скіл-раннера: `requestPermission`
-  автоапрувляє через `pickAutoPermissionOptionId`, `sessionUpdate` стрімить текстові
+  автоматично схвалює через `pickAutoPermissionOptionId`, `sessionUpdate` стрімить текстові
   дельти (`agent_message_chunk`) у переданий `out`, `readTextFile`/`writeTextFile`
   реалізовані напряму через `node:fs` (full-trust режим, без write-guard).
 - `runAcpRunner` — підʼєднується до агента (`initialize` → `newSession` → `prompt`),
@@ -41,14 +41,14 @@ agentclientprotocol.com) — JSON-RPC поверх stdio замість сиро
 - `ACP_AGENT_COMMANDS` — таблиця команд запуску на провайдер.
 - `stopReasonToExitCode(stopReason)` — `StopReason` → `0 | 1`.
 - `resolveAdapterBin(adapterPackage)` — шлях до bin-файлу адаптера.
-- `pickAutoPermissionOptionId(options)` — `optionId` автообраного варіанту дозволу.
+- `pickAutoPermissionOptionId(options)` — `optionId` автоматично обраного варіанту дозволу.
 - `runAcpRunner(kind, prompt, projectDir, logError, deps?)` — виконує скіл через
   ACP-агента `kind` (`cursor`|`codex`|`claude`); `deps` — інжекти для тестів
   (`acp`, `spawnFn`, `out`, `resolveAdapterBin`, `isBinaryInPath`).
 
 ## Гарантії поведінки
 
-- Permission-реквести від агента автоапрувляться без інтерактивного проміту —
+- Permission-запити від агента автоматично схвалюються без інтерактивного запиту —
   парність із колишнім non-interactive `-p`/`exec -` режимом (full user-trust,
   без write-guard, як і в `@7n/llm-lib/agent-skill`).
 - `cursor` кидає, якщо `cursor-agent` відсутній у PATH (перевіряється до спавну

package/scripts/lib/docs/mirror-parity.md

@@ -3,7 +3,7 @@ type: JS Module
 title: mirror-parity.mjs
 resource: npm/scripts/lib/mirror-parity.mjs
 docgen:
-  crc: 91a0c9f2
+  crc: 1e89b486
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---