@7n/rules 1.3.1 → 1.4.0

package/rules/security/lint_security_yml/docs/fix-lint_security_yml.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-lint_security_yml.mjs
+resource: npm/rules/security/lint_security_yml/fix-lint_security_yml.mjs
+docgen:
+  crc: cb66ccb7
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає межі пошуку в кодовій базі та свідомо оминає `.github` і `.git`, щоб перевірка не зачіпала службові каталоги. Правило працює в read-only режимі й не записує зміни у файлову систему або бази даних.
+
+## Поведінка
+
+1. `patterns` визначає правило автоматичного приведення workflow перевірки безпеки до еталонного шаблону.
+
+2. Правило орієнтується на файл `.github/workflows/lint-security.yml`, щоб забезпечити наявність узгодженого процесу security lint у CI.
+
+3. Під час підбору файлів для загальної обробки свідомо пропускаються службові шляхи `.github` і `.git`, щоб не аналізувати інфраструктурні каталоги як звичайний код.
+
+4. Зміни не записуються напряму у файлову систему або зовнішні сховища: `patterns` лише описує доступне виправлення для подальшого застосування інструментом.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/security/lint_security_yml/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/security/lint_security_yml
+resource: npm/rules/security/lint_security_yml/
+---
+
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [fix-lint_security_yml.mjs](fix-lint_security_yml.md) | JS Module |

package/rules/security/lint_security_yml/fix-lint_security_yml.mjs

@@ -1,3 +1,8 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'security-lint_security_yml-template', targetPath: '.github/workflows/lint-security.yml' })]
+export const patterns = [
+  createTemplateFixPattern({
+    id: 'security-lint_security_yml-template',
+    targetPath: '.github/workflows/lint-security.yml'
+  })
+]

package/rules/style/lint_style_yml/docs/fix-lint_style_yml.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-lint_style_yml.mjs
+resource: npm/rules/style/lint_style_yml/fix-lint_style_yml.mjs
+docgen:
+  crc: fc52d912
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Публічна функція `patterns` надає шаблони для зовнішньої перевірки очікуваного стану коду. Модуль працює як read-only джерело правил: не змінює ФС чи БД і свідомо пропускає службові шляхи `.github` та `.git`.
+
+## Поведінка
+
+1. `patterns` визначає набір правил автоматичного виправлення для стандартного workflow перевірки стилю.
+
+2. `patterns` спрямовує виправлення на файл `.github/workflows/lint-style.yml`, щоб підтримувати єдиний шаблон CI-перевірки стилю в проєкті.
+
+3. `patterns` не виконує запис у файлову систему чи інші сховища самостійно, а лише описує очікувану зміну для зовнішнього механізму застосування.
+
+4. Під час роботи свідомо не обробляються службові шляхи `.github` і `.git`, окрім цільового workflow-файлу, для якого визначено шаблонне виправлення.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/style/lint_style_yml/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/style/lint_style_yml
+resource: npm/rules/style/lint_style_yml/
+---
+
+| Файл                                            | Тип       |
+| ----------------------------------------------- | --------- |
+| [fix-lint_style_yml.mjs](fix-lint_style_yml.md) | JS Module |

package/rules/style/lint_style_yml/fix-lint_style_yml.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'style-lint_style_yml-template', targetPath: '.github/workflows/lint-style.yml' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'style-lint_style_yml-template', targetPath: '.github/workflows/lint-style.yml' })
+]

package/rules/style/package_json/docs/fix-package_json.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: fix-package_json.mjs
+resource: npm/rules/style/package_json/fix-package_json.mjs
+docgen:
+  crc: deb26703
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надає `patterns` для визначення очікуваних перевірок, що спираються на `package.json`. Використовується як read-only опис вимог до конфігурації пакета, без самостійних змін файлової системи.
+
+## Поведінка
+
+1. `patterns` визначає правило виправлення для `package.json`.
+
+2. `patterns` забезпечує приведення `package.json` до проєктного шаблону стилю.
+
+3. `patterns` не змінює файлову систему самостійно, а лише описує доступний сценарій автоматичного виправлення для зовнішнього механізму перевірок.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/package_json/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/style/package_json
+resource: npm/rules/style/package_json/
+---
+
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [fix-package_json.mjs](fix-package_json.md) | JS Module |

package/rules/style/vscode_settings/docs/fix-vscode_settings.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: fix-vscode_settings.mjs
+resource: npm/rules/style/vscode_settings/fix-vscode_settings.mjs
+docgen:
+  crc: eee71672
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` описує узгоджені шаблони для `settings.json` і визначає, які значення в ньому мають відповідати очікуваному формату. Це потрібно, щоб конфіг лишався передбачуваним і однаково трактувався в різних місцях, де його використовують.
+
+## Поведінка
+
+1. `patterns` описує набір правил для приведення `.vscode/settings.json` до узгодженого стану з шаблонним стилем проєкту.
+2. На основі цього набору система знаходить конфігурацію `settings.json` і підтягує її в механізм виправлення, щоб зберігати єдиний формат налаштувань у робочому середовищі.
+3. Результат роботи `patterns` використовується як джерело стандарту для перевірки та вирівнювання вмісту `settings.json` без ручного втручання.
+4. Модуль не змінює файлову систему чи бази даних; він лише надає опис поведінки для подальшого застосування.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/vscode_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/style/vscode_settings
+resource: npm/rules/style/vscode_settings/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/style/vscode_settings/fix-vscode_settings.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'style-vscode_settings-template', targetPath: '.vscode/settings.json' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'style-vscode_settings-template', targetPath: '.vscode/settings.json' })
+]

package/rules/text/lint_text/docs/fix-lint_text.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-lint_text.mjs
+resource: npm/rules/text/lint_text/fix-lint_text.mjs
+docgen:
+  crc: cefae829
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` визначає, які текстові зміни вважаються придатними для узгодження з еталонною структурою workflow. Вона потрібна, щоб перевірка зосереджувалась на змісті потрібних файлів і не торкалась службових шляхів `.github` і `.git`.
+
+## Поведінка
+
+1. `patterns` формує набір правил для узгодження текстової перевірки з еталонною структурою workflow.
+2. Підготовлює виправлення для цільового файлу `.github/workflows/lint-text.yml`.
+3. Свідомо обходить службові шляхи `.github` і `.git`, щоб не зачіпати внутрішню інфраструктуру репозиторію.
+4. Працює лише на читання: не змінює файлову систему і не виконує запис у БД.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/text/lint_text/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/text/lint_text
+resource: npm/rules/text/lint_text/
+---
+
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
+| [fix-lint_text.mjs](fix-lint_text.md) | JS Module |

package/rules/text/oxfmtrc/docs/fix-oxfmtrc.md

@@ -0,0 +1,26 @@
+---
+type: JS Module
+title: fix-oxfmtrc.mjs
+resource: npm/rules/text/oxfmtrc/fix-oxfmtrc.mjs
+docgen:
+  crc: 2902bd52
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Публічна точка входу `patterns` повертає набір правил вирівнювання для `.oxfmtrc.json` і слугує read-only джерелом очікуваного стану цього конфіга. Код спирається на конфіг `.oxfmtrc.json` як на залежність контексту, щоб узгоджувати його формат із прийнятими правилами.
+
+## Поведінка
+
+1. `patterns` формує набір виправлень для узгодження шаблонного конфіга з цільовим файлом `.oxfmtrc.json`.
+2. Кожен елемент у `patterns` описує окреме правило вирівнювання цього конфіга, щоб тримати його в очікуваному стані.
+3. `patterns` не виконує записів у файлову систему чи базу даних і не змінює інші файли поза `.oxfmtrc.json`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/text/oxfmtrc/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/text/oxfmtrc
+resource: npm/rules/text/oxfmtrc/
+---
+
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
+| [fix-oxfmtrc.mjs](fix-oxfmtrc.md) | JS Module |

package/rules/text/vscode_settings/docs/fix-vscode_settings.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: fix-vscode_settings.mjs
+resource: npm/rules/text/vscode_settings/fix-vscode_settings.mjs
+docgen:
+  crc: aa3c10a6
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.93
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл визначає, за якими правилами `patterns` перевіряє відповідність `.vscode/settings.json` конфігурації з `settings.json`. Це потрібно, щоб підтримувати узгоджений стан редакторських налаштувань у проєкті.
+
+## Поведінка
+
+1. `patterns` формує набір правил для приведення `.vscode/settings.json` до узгодженого стану з шаблоном.
+2. `patterns` орієнтується на конфігурацію `settings.json` як на джерело очікуваного вигляду налаштувань.
+3. `patterns` потрібен, щоб автоматично підтримувати єдину структуру редакторських налаштувань у проєкті.
+4. `patterns` працює лише як опис правил і не виконує запис у файлову систему чи базу даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/text/vscode_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/text/vscode_settings
+resource: npm/rules/text/vscode_settings/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/text/vscode_settings/fix-vscode_settings.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'text-vscode_settings-template', targetPath: '.vscode/settings.json' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'text-vscode_settings-template', targetPath: '.vscode/settings.json' })
+]

package/rules/worktree/vscode_settings/docs/fix-vscode_settings.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-vscode_settings.mjs
+resource: npm/rules/worktree/vscode_settings/fix-vscode_settings.mjs
+docgen:
+  crc: e68a8ed3
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надає `patterns` для визначення конфігураційних файлів, на які має зважати перевірка робочого дерева. Спирається на конфіги: settings.json.
+
+## Поведінка
+
+1. `patterns` визначає правило виправлення для робочого дерева, яке підтримує наявність очікуваного VS Code-конфігу `settings.json`.
+
+2. `patterns` спрямовує перевірку на `.vscode/settings.json`, щоб проєкт мав узгоджені налаштування редактора для всіх учасників.
+
+3. `patterns` не змінює файлову систему самостійно; воно лише описує доступний шаблон виправлення для зовнішнього механізму застосування правил.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/worktree/vscode_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/worktree/vscode_settings
+resource: npm/rules/worktree/vscode_settings/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/worktree/zed_settings/docs/fix-zed_settings.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-zed_settings.mjs
+resource: npm/rules/worktree/zed_settings/fix-zed_settings.mjs
+docgen:
+  crc: 452faa10
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надає правило `patterns` для перевірки очікуваних налаштувань проєкту. Код спирається на конфіг `settings.json` і працює read-only, щоб описати вимоги до конфігурації без самостійного внесення змін.
+
+## Поведінка
+
+1. `patterns` визначає правило автоматичного приведення робочого дерева до очікуваного шаблону налаштувань Zed.
+
+2. `patterns` орієнтується на конфіг `settings.json`, щоб забезпечити наявність і узгодженість `.zed/settings.json` у проєкті.
+
+3. `patterns` не змінює файлову систему самостійно; воно лише описує поведінку виправлення для зовнішнього механізму застосування правил.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/worktree/zed_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/worktree/zed_settings
+resource: npm/rules/worktree/zed_settings/
+---
+
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [fix-zed_settings.mjs](fix-zed_settings.md) | JS Module |

package/rules/worktree/zed_settings/fix-zed_settings.mjs

@@ -1,3 +1,5 @@
 import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
 
-export const patterns = [createTemplateFixPattern({ id: 'worktree-zed_settings-template', targetPath: '.zed/settings.json' })]
+export const patterns = [
+  createTemplateFixPattern({ id: 'worktree-zed_settings-template', targetPath: '.zed/settings.json' })
+]

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: 30b6209c
+  crc: 33d8696c
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

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

@@ -3,12 +3,12 @@ type: JS Module
 title: sync-claude-config.mjs
 resource: npm/scripts/sync-claude-config.mjs
 docgen:
-  crc: 35cf216c
+  crc: e4513e7a
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 85
 ---
 
-Синхронізує конфігурацію Claude Code (`.claude/settings.json`, slash-команди з `commands/` темплейту, ADR Stop-hook) та Cursor hooks (`.cursor/hooks.json`) у поточний проєкт із темплейтів пакету `npm/.claude-template/`. Здійснює злиття конфігурацій: користувацькі поля зберігаються у `.claude/settings.json`, а дозволи (`permissions.allow`) зливаються через union. Керовані хуки, ідентифіковані командою-маркером `MANAGED_HOOK_COMMAND_MARKERS`, перезаписуються. Копіює ADR Stop-hook (`.claude/hooks/capture-decisions.sh`) та ADR normalize Stop-hook (`.claude/hooks/normalize-decisions.sh`) залежно від налаштувань у `.n-rules.json`. Також зливає фрагмент `.gitignore` з канонічного шаблону, додаючи необхідні записи для ADR.
+Синхронізує конфігурацію Claude Code (`.claude/settings.json`, slash-команди з `commands/` темплейту, ADR Stop-hook) та Cursor hooks (`.cursor/hooks.json`) у поточний проєкт із темплейтів пакету `npm/.claude-template/`. Здійснює злиття конфігурацій: користувацькі поля зберігаються у `.claude/settings.json`, а дозволи (`permissions.allow`) зливаються через union. Керовані хуки, ідентифіковані командою-маркером `MANAGED_HOOK_COMMAND_MARKERS`, перезаписуються. Копіює ADR Stop-hook (`.claude/hooks/capture-decisions.sh`) та ADR normalize Stop-hook (`.claude/hooks/normalize-decisions.sh`) залежно від налаштувань у `.n-rules.json`. Також зливає фрагмент `.gitignore` з канонічного шаблону, додаючи необхідні записи для ADR. За правилом `local-ai` керує rtk-інтеграцією (fail-open, працює лише за наявності бінарника rtk): PreToolUse hook `rtk hook claude` у `.claude/settings.json`, preToolUse entry `rtk hook cursor` у `.cursor/hooks.json` і vendored pi-extension `.pi/extensions/rtk.ts`; вимкнення правила прибирає записи та видаляє extension.
 
 ## Поведінка
 
@@ -22,6 +22,8 @@ ADR_HOOK_COMMAND_MARKER — Визначає маркер шляху до bash-
 ADR_NORMALIZE_HOOK_COMMAND_MARKER — Визначає маркер шляху до bash-скрипта ADR normalize Stop-hook.
 CURSOR_ADR_HOOK_COMMAND_MARKER — Визначає маркер шляху до bash-скрипта ADR capture Stop-hook у `.cursor/hooks.json`.
 CURSOR_ADR_NORMALIZE_HOOK_COMMAND_MARKER — Визначає маркер шляху до bash-скрипта ADR normalize Stop-hook у `.cursor/hooks.json`.
+RTK_CLAUDE_HOOK_COMMAND_MARKER — Визначає маркер rtk PreToolUse hook'а (`rtk hook claude`) у `.claude/settings.json` (правило `local-ai`).
+RTK_CURSOR_HOOK_COMMAND_MARKER — Визначає маркер rtk preToolUse hook'а (`rtk hook cursor`) у `.cursor/hooks.json` (правило `local-ai`).
 MANAGED_HOOK_COMMAND_MARKERS — Містить список усіх маркерів, що ідентифікують керовані хуки пакета.
 PI_DIR — Визначає кореневу директорію для артефактів pi.dev у проєкті-споживачі.
 PI_EXTENSIONS_DIR — Визначає директорію для TS-extensions pi.dev у проєкті-споживачі.
@@ -31,8 +33,8 @@ ADR_GITIGNORE_SNIPPET_REL — Визначає відносний шлях до
 mergeAllowList — Об'єднує списки дозволених дозволів, зберігаючи користувацькі записи першими.
 mergeHooks — Зливає секцію `hooks` з `.claude/settings.json`, видаляючи керовані групи з існуючої конфігурації.
 mergeSettings — Зливає конфігурацію `.claude/settings.json` з темплейту, зберігаючи користувацькі поля та оновлюючи керовані хуки.
-mergeCursorHooksConfig — Зливає конфігурацію `.cursor/hooks.json`, зберігаючи користувацькі записи та додаючи/видаляючи керовані ADR stop entries.
-syncCursorHooksConfig — Синхронізує `.cursor/hooks.json` для Cursor Agent stop-hooks, додаючи ADR entries за умовою.
+mergeCursorHooksConfig — Зливає конфігурацію `.cursor/hooks.json`, зберігаючи користувацькі записи та додаючи/видаляючи керовані ADR stop entries і rtk preToolUse entry.
+syncCursorHooksConfig — Синхронізує `.cursor/hooks.json` для Cursor Agent hooks, додаючи ADR stop і rtk preToolUse entries за умовою.
 syncClaudeSettings — Синхронізує `.claude/settings.json` за темплейтом, зберігаючи користувацькі налаштування.
 syncAdrHookScript — Копіює канонічний bash-скрипт ADR capture Stop-hook з темплейту пакета у `.claude/hooks/`.
 syncAdrNormalizeHookScript — Копіює канонічний bash-скрипт ADR normalize Stop-hook з темплейту пакета у `.claude/hooks/`.
@@ -40,6 +42,9 @@ syncAdrHookLibScripts — Копіює всі bash-скрипти з `lib/` те
 removeOrphanAdrHookLib — Видаляє директорію `.claude/hooks/lib/` з проєкту, якщо ADR-хуки вимкнені.
 syncPiExtensions — Копіює bundled pi.dev TS-extension `n-rules-adr` у `.pi/extensions/n-rules-adr/` проєкту.
 removeOrphanPiExtension — Видаляє директорію `.pi/extensions/n-rules-adr/` з проєкту, якщо ADR-хуки вимкнені.
+RTK_PI_EXTENSION_FILE — Визначає ім'я файлу rtk pi-extension (`rtk.ts`) — шлях спільний із `rtk init --agent pi`.
+syncRtkPiExtension — Копіює vendored rtk pi-extension у `.pi/extensions/rtk.ts` проєкту (правило `local-ai`).
+removeOrphanRtkPiExtension — Видаляє `.pi/extensions/rtk.ts` з проєкту, якщо правило `local-ai` вимкнене.
 syncGitignoreAdrFragment — Дописує відсутні рядки з канонічного ADR-фрагмента до кореневого `.gitignore` проєкту.
 syncClaudeCommands — Копіює всі slash-команди з `.claude-template/commands/` у `.claude/commands/` проєкту.
 syncClaudeConfig — Виконує повну синхронізацію Claude Code-конфігу, включаючи ADR-хуки, `.gitignore` та pi-extension, залежно від правил.

package/scripts/lib/fix/docs/index.md

@@ -4,8 +4,7 @@ title: npm/scripts/lib/fix
 resource: npm/scripts/lib/fix/
 ---
 
-# npm/scripts/lib/fix
-
-| Файл                                    | Тип       |
-| --------------------------------------- | --------- |
-| [vscode-ext-add.mjs](vscode-ext-add.md) | JS Module |
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [template-deep-merge.mjs](template-deep-merge.md) | JS Module |
+| [vscode-ext-add.mjs](vscode-ext-add.md)           | JS Module |

package/scripts/lib/fix/docs/template-deep-merge.md

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: template-deep-merge.mjs
+resource: npm/scripts/lib/fix/template-deep-merge.mjs
+docgen:
+  crc: 90221a92
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл створює T0-патерн для одного target-файлу за канонічним `template/*.snippet.{json,jsonc,yml,yaml}` свого concern-а, який резолвиться через `ctx.concernDir`, щоб уніфіковано приводити `engine:"template"` і `engine:"rego"` до потрібного стану без ручного редагування. Для merge об’єкти поєднуються по ключах, масиви зводяться до union за структурним підмножинним збігом, а leaf-значення замінюються канонічним значенням із snippet; якщо target-файл відсутній, snippet копіюється без merge. Для JSON/JSONC застосовується plain-object merge з `JSON.stringify`, а для YAML — `Document API` (`setIn`/`addIn`/`hasIn`), щоб зберігати наявні коментарі й форматування та створювати лише те, чого бракує. `createTemplateFixPattern` працює fail-safe: не кидає винятків назовні й за відсутності потрібного snippet або некоректного входу повертає порожнє значення.
+
+## Поведінка
+
+1. `createTemplateFixPattern` формує T0-патерн для одного цільового файлу, який приводить його до стану, описаного канонічним snippet-файлом у `template/` свого concern-а.
+2. Під час запуску патерн спершу визначає, чи стосується порушення саме цього цільового файлу; якщо ні — нічого не змінює.
+3. Далі він шукає відповідний snippet-файл для цільового файлу; якщо snippet не знайдено або немає контексту concern-а, зміни не виконуються.
+4. Якщо цільового файлу ще немає, він створює його з вмісту snippet без merge — як початковий канонічний стан.
+5. Якщо цільовий файл уже існує, патерн зливає snippet у наявний вміст: об’єкти доповнюються по ключах, масиви поповнюються лише відсутніми структурно елементами, а прості значення замінюються канонічними.
+6. Для JSON і JSONC результат записується як нормалізований JSON-текст; якщо вхід невалідний або файл уже відповідає snippet-у, він лишається без змін.
+7. Для YAML збереження робиться так, щоб не втрачати коментарі й форматування; якщо YAML невалідний, або вже відповідає snippet-у, файл не чіпається.
+8. У разі успішного оновлення патерн фіксує запис і повідомляє, що цільовий файл приведено у відповідність snippet.
+
+## Публічний API
+
+- createTemplateFixPattern — Формує T0-патерн, який вирівнює `targetPath` під `template/*.snippet.*` для свого concern-а; працює як deep-merge, не ламає повторні запуски і лишає одного writer-а для single-target snippet-концернів з `engine:"template"` або `engine:"rego"` на тому самому snippet-шаблоні.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/scripts/skills-cli.mjs

@@ -22,7 +22,7 @@ import { dirname, join } from 'node:path'
 import { cwd } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
-import { readSkillMetaRaw, skillTier } from './lib/skill-meta.mjs'
+import { readSkillMetaRaw, skillRequiresRoot, skillTier } from './lib/skill-meta.mjs'
 
 /** Виконавці скіла. `pi` — вбудований (рекомендований); `cursor`/`codex`/`claude` — зовнішні CLI (`claude` — deprecated). */
 const RUNNERS = new Set(['pi', 'cursor', 'codex', 'claude'])
@@ -177,13 +177,20 @@ async function runPiRunner(prompt, rawSkillName, skillsRoot, projectDir, logErro
  * або deprecated `claude -p`) — промпт передається через stdin. `claude` лишається як
  * deprecated fallback для тих, у кого pi-модель ще не налаштована; буде прибрано
  * (мігруй на `skill pi`). `cursor`/`codex` — повноцінні альтернативні раннери.
+ *
+ * `cursor-agent` у non-interactive режимі блокується власним `approvalMode: "allowlist"`
+ * користувача (git/bun/npx/rm тощо потребують інтерактивного підтвердження, якого в headless
+ * виклику немає). Для `worktree:true`/`requireRoot:true` скілів (блок-радіус вже ізольований)
+ * додаємо `--force`, замість того щоб просити користувача розширювати глобальний allowlist
+ * у `~/.cursor/cli-config.json`.
  * @param {'claude' | 'cursor' | 'codex'} kind який LLM CLI запускати
  * @param {string} prompt промпт для передачі у stdin
  * @param {string} projectDir робочий каталог дочірнього процесу
  * @param {(line: string) => void} logError вивід попередження/помилок
+ * @param {boolean} isolated чи скіл ізольований (worktree/requireRoot) — дозволяє force-approve для `cursor`
  * @returns {number} exit code дочірнього процесу
  */
-function runLlmCli(kind, prompt, projectDir, logError) {
+function runLlmCli(kind, prompt, projectDir, logError, isolated) {
   const runner = EXTERNAL_RUNNERS[kind]
 
   if (runner.deprecated) {
@@ -194,7 +201,9 @@ function runLlmCli(kind, prompt, projectDir, logError) {
     throw new Error(`\`${runner.bin}\` not found in PATH. Install ${kind} CLI or use \`skill pi\`.`)
   }
 
-  const result = spawnSync(runner.bin, runner.args, {
+  const args = kind === 'cursor' && isolated ? [...runner.args, '--force'] : runner.args
+
+  const result = spawnSync(runner.bin, args, {
     input: prompt,
     cwd: projectDir,
     stdio: ['pipe', 'inherit', 'inherit'],
@@ -252,7 +261,9 @@ export async function runSkillsCli(argv, options = {}) {
       if (first === 'pi') {
         return await runPiRunner(prompt, second, skillsRoot, projectDir, logError, deps)
       }
-      return runLlmCli(/** @type {'claude' | 'cursor' | 'codex'} */ (first), prompt, projectDir, logError)
+      const skillMeta = readSkillMetaRaw(join(skillsRoot, normalizeSkillId(second)))
+      const isolated = skillRequiresRoot(skillMeta)
+      return runLlmCli(/** @type {'claude' | 'cursor' | 'codex'} */ (first), prompt, projectDir, logError, isolated)
     }
 
     if (skillIds.includes(normalizeSkillId(first))) {