@7n/rules 1.3.1 → 1.3.2

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/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))) {