@7n/rules 1.3.0 → 1.3.2

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/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/lib/fix/template-deep-merge.mjs

@@ -25,7 +25,7 @@ const SNIPPET_EXTS = ['yml', 'yaml', 'json', 'jsonc']
  * Чи `needle` структурно вже присутній у якомусь елементі `actualArray`
  * (та сама subset-семантика, що й у детекторі — жодного окремого визначення "збігу").
  * @param {unknown[]} actualArray наявний масив
- * @param {unknown} needle елемент снippета, наявність якого перевіряємо
+ * @param {unknown} needle елемент snippet-а, наявність якого перевіряємо
  * @returns {boolean} true — вже присутній структурно
  */
 function containedIn(actualArray, needle) {
@@ -98,6 +98,57 @@ function mergeYamlDoc(doc, snippet, path) {
   doc.setIn(path, snippet) // leaf — перезаписуємо канонічним значенням
 }
 
+/**
+ * Рахує наступний вміст JSON/JSONC-target. `null` — невалідний вхід (не чіпаємо);
+ * незмінений `prevText` — уже відповідає snippet-у (idempotent, без reformat).
+ * @param {string} prevText наявний вміст target-файлу
+ * @param {string} snippetPath абсолютний шлях до snippet-файлу
+ * @returns {string|null} новий вміст, незмінений `prevText`, або `null`
+ */
+function computeJsonNextText(prevText, snippetPath) {
+  let snippet
+  let actual
+  try {
+    snippet = JSON.parse(readFileSync(snippetPath, 'utf8'))
+    actual = JSON.parse(prevText)
+  } catch {
+    return null // невалідний JSON — не чіпаємо детермінованим фіксом
+  }
+  // Уже відповідає snippet-у (та сама перевірка, що й детектор) → без reformat:
+  // JSON.stringify інакше переформатував би вже коректний файл (напр. компактний
+  // однорядковий snippet → pretty-print) без жодної реальної зміни.
+  if (checkSnippet(actual, snippet, { targetPath: '', source: '' }).length === 0) return prevText
+  return JSON.stringify(mergeJsonValue(actual, snippet), null, 2) + '\n'
+}
+
+/**
+ * Рахує наступний вміст YAML-target через `yaml` Document API. `null` — невалідний
+ * вхід; незмінений `prevText` — уже відповідає snippet-у (idempotent, без reformat).
+ * @param {string} prevText наявний вміст target-файлу
+ * @param {string} snippetPath абсолютний шлях до snippet-файлу
+ * @returns {Promise<string|null>} новий вміст, незмінений `prevText`, або `null`
+ */
+async function computeYamlNextText(prevText, snippetPath) {
+  const { parse, parseDocument } = await import('yaml')
+  let snippet
+  let actualPlain
+  try {
+    snippet = parse(readFileSync(snippetPath, 'utf8'))
+    actualPlain = parse(prevText)
+  } catch {
+    return null // невалідний YAML — не чіпаємо детермінованим фіксом
+  }
+  // Уже відповідає snippet-у → без reformat: Document.toString() не завжди
+  // byte-identical на вже коректному вмісті (напр. folded block scalars).
+  if (checkSnippet(actualPlain, snippet, { targetPath: '', source: '' }).length === 0) return prevText
+  const doc = parseDocument(prevText)
+  if (doc.errors.length > 0) return null
+  if (snippet !== null && typeof snippet === 'object' && !Array.isArray(snippet)) {
+    for (const [k, v] of Object.entries(snippet)) mergeYamlDoc(doc, v, [k])
+  }
+  return doc.toString()
+}
+
 /**
  * Створює T0-патерн, що приводить `targetPath` у відповідність `template/*.snippet.*`
  * свого concern-а (deep-merge, idempotent). Один writer — для будь-якого single-target
@@ -110,16 +161,13 @@ export function createTemplateFixPattern({ id, targetPath }) {
     id,
     test: violations => violations.some(v => v.file === targetPath),
     apply: async (violations, ctx) => {
-      if (!violations.some(v => v.file === targetPath)) return { touchedFiles: [] }
+      if (violations.every(v => v.file !== targetPath)) return { touchedFiles: [] }
       if (!ctx.concernDir) return { touchedFiles: [] }
 
       const snippetPath = findSnippetFile(join(ctx.concernDir, 'template'), basename(targetPath))
       if (!snippetPath) return { touchedFiles: [] }
 
       const absTarget = join(ctx.cwd, targetPath)
-      const ext = extname(snippetPath).toLowerCase()
-      const isJson = ext === '.json' || ext === '.jsonc'
-
       const prevText = existsSync(absTarget) ? readFileSync(absTarget, 'utf8') : null
 
       // Файл відсутній → копіюємо snippet як є (без merge — немає з чим мерджити).
@@ -131,49 +179,12 @@ export function createTemplateFixPattern({ id, targetPath }) {
         return { touchedFiles: [absTarget], message: `${targetPath}: створено зі snippet` }
       }
 
-      let nextText
-      if (isJson) {
-        let snippet
-        let actual
-        try {
-          snippet = JSON.parse(readFileSync(snippetPath, 'utf8'))
-          actual = JSON.parse(prevText)
-        } catch {
-          return { touchedFiles: [] } // невалідний JSON — не чіпаємо детермінованим фіксом
-        }
-        // Уже відповідає snippet-у (та сама перевірка, що й детектор) → не чіпаємо файл
-        // взагалі: без цієї гейтки JSON.stringify переформатував би вже коректний файл
-        // (напр. компактний однорядковий snippet → pretty-print) без жодної реальної зміни.
-        if (checkSnippet(actual, snippet, { targetPath: '', source: '' }).length === 0) {
-          return { touchedFiles: [] }
-        }
-        const merged = mergeJsonValue(actual, snippet)
-        nextText = JSON.stringify(merged, null, 2) + '\n'
-      } else {
-        const { parse, parseDocument } = await import('yaml')
-        let snippet
-        let actualPlain
-        try {
-          snippet = parse(readFileSync(snippetPath, 'utf8'))
-          actualPlain = parse(prevText)
-        } catch {
-          return { touchedFiles: [] } // невалідний YAML — не чіпаємо детермінованим фіксом
-        }
-        // Уже відповідає snippet-у (та сама перевірка, що й детектор) → не чіпаємо файл
-        // взагалі: Document.toString() не завжди byte-identical на вже коректному вмісті
-        // (напр. folded block scalars переформатовуються при round-trip без потреби).
-        if (checkSnippet(actualPlain, snippet, { targetPath: '', source: '' }).length === 0) {
-          return { touchedFiles: [] }
-        }
-        const doc = parseDocument(prevText)
-        if (doc.errors.length > 0) return { touchedFiles: [] }
-        if (snippet !== null && typeof snippet === 'object' && !Array.isArray(snippet)) {
-          for (const [k, v] of Object.entries(snippet)) mergeYamlDoc(doc, v, [k])
-        }
-        nextText = doc.toString()
-      }
+      const isJson = ['.json', '.jsonc'].includes(extname(snippetPath).toLowerCase())
+      const nextText = isJson
+        ? computeJsonNextText(prevText, snippetPath)
+        : await computeYamlNextText(prevText, snippetPath)
 
-      if (nextText === prevText) return { touchedFiles: [] }
+      if (nextText === null || nextText === prevText) return { touchedFiles: [] }
       ctx.recordWrite?.(absTarget)
       writeFileSync(absTarget, nextText, 'utf8')
       return { touchedFiles: [absTarget], message: `${targetPath}: приведено у відповідність snippet` }

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