@nitra/cursor 12.8.8 → 12.9.0

package/rules/test/js/sandbox-aware-test.mjs

@@ -0,0 +1,89 @@
+/** @see ./docs/sandbox-aware-test.md */
+import { readFile } from 'node:fs/promises'
+import { basename, relative } from 'node:path'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+/**
+ * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} `true` для `.test.{mjs,js}` файлів
+ */
+function isTestFile(absPath) {
+  const name = basename(absPath)
+  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
+}
+
+/**
+ * Чи файл містить `import.meta.dirname`/`import.meta.url`-навігацію з ≥4 `..`-рівнів.
+ * Для кожного вживання `import.meta.dirname|url` рахує `'..'`/`".."` у вікні 400 символів.
+ * @param {string} body вміст файлу
+ * @returns {boolean} `true` якщо знайдено глибоку навігацію
+ */
+function hasDeepMetaNavigation(body) {
+  const RE = /import\.meta\.(?:dirname|url)\b/gu
+  let match
+  while ((match = RE.exec(body)) !== null) {
+    const chunk = body.slice(match.index, match.index + 400)
+    const dots = (chunk.match(/'\.\.'|"\.\."/gu) ?? []).length
+    if (dots >= 4) return true
+  }
+  return false
+}
+
+/** Захист через тимчасову пісочницю — `withTmpDir`. */
+const WITH_TMP_DIR_RE = /\bwithTmpDir\b/u
+
+/** Захист через явний skip у Stryker-sandbox (`test.skipIf`). */
+const SKIP_IF_STRYKER_RE = /\btest\.skipIf\s*\(\s*(?:env|process\.env)\.STRYKER_MUTATOR_WORKER\b/u
+
+/**
+ * Перевіряє, що `*.test.{mjs,js}` з глибокою `import.meta`-навігацією (≥4 `..`-рівнів)
+ * захищені `withTmpDir` або `test.skipIf(env.STRYKER_MUTATOR_WORKER)`.
+ * Без ізоляції Stryker-sandbox (`reports/stryker/.tmp/sandbox-XXX/`) не має `.git/`,
+ * тому git-операції у таких тестах падають і мутаційний прогін не стартує.
+ * @param {string} [cwdParam] корінь репозиторію
+ * @returns {Promise<number>} 0 — чисто, 1 — є порушення
+ */
+export async function check(cwdParam = process.cwd()) {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  const cwd = cwdParam
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const testFiles = []
+  await walkDir(
+    cwd,
+    absPath => {
+      if (isTestFile(absPath)) testFiles.push(absPath)
+    },
+    ignorePaths
+  )
+
+  /** @type {string[]} */
+  const offenders = []
+  for (const absPath of testFiles) {
+    const body = await readFile(absPath, 'utf8')
+    if (!hasDeepMetaNavigation(body)) continue
+    if (WITH_TMP_DIR_RE.test(body) || SKIP_IF_STRYKER_RE.test(body)) continue
+    offenders.push(relative(cwd, absPath))
+  }
+
+  if (offenders.length === 0) {
+    pass(`Усі ${testFiles.length} тестові файли sandbox-aware (test.mdc)`)
+    return reporter.getExitCode()
+  }
+
+  for (const file of offenders) {
+    fail(
+      `${file}: import.meta deep navigation (≥4 рівні ..) без ізоляції — ` +
+        `оберни у withTmpDir() або захисти test.skipIf(env.STRYKER_MUTATOR_WORKER) (test.mdc, sandbox-aware-test)`
+    )
+  }
+
+  return reporter.getExitCode()
+}

package/rules/text/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/text/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/tool-surface/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/tool-surface/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/vue/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/vue/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/worktree/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/worktree/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/scripts/docs/hook.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: hook.mjs
+resource: npm/scripts/hook.mjs
+docgen:
+  crc: 8a19fee4
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+---
+
+## Огляд
+
+Модуль є точкою входу для хуків Claude Code. Він зчитує контекст, отримуючи шлях до файлу з вхідного потоку або визначаючи його через Git. У режимі `--post-tool-use` шлях до файлу зчитується з JSON, що надходить у stdin. У режимі `--stop` визначається робоче дерево проти HEAD (`git diff HEAD` + untracked). Після зчитування контексту, він делегує виконання перевірки за допомогою `runLint`. Код виходу, отриманий від перевірки, перекодовується у відповідний протокол хука (1 $\rightarrow$ 2).
+
+## Поведінка
+
+extractFilePath: Витягує шлях до файлу з JSON, отриманого з вхідного потоку.
+runHookCli: Виконує логіку хука, визначаючи файли для перевірки на основі аргументів командного рядка, запускає перевірку та повертає відповідний код виходу.
+
+## Публічний API
+
+extractFilePath — витягує шлях до файлу з вхідних даних JSON хука Claude Code PostToolUse.
+runHookCli — виконує команду для хука n-cursor.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/scripts/docs/index.md

@@ -15,11 +15,10 @@ resource: npm/scripts/
 | [coverage-fix-extract.mjs](coverage-fix-extract.md)                                 | JS Module |
 | [coverage-fix.mjs](coverage-fix.md)                                                 | JS Module |
 | [ensure-nitra-cursor-dev-dependencies.mjs](ensure-nitra-cursor-dev-dependencies.md) | JS Module |
+| [hook.mjs](hook.md)                                                                 | JS Module |
 | [post-tool-use-check.mjs](post-tool-use-check.md)                                   | JS Module |
-| [post-tool-use-fix.mjs](post-tool-use-fix.md)                                       | JS Module |
 | [rename-yaml-extensions.mjs](rename-yaml-extensions.md)                             | JS Module |
 | [skills-cli.mjs](skills-cli.md)                                                     | JS Module |
 | [sync-claude-config.mjs](sync-claude-config.md)                                     | JS Module |
 | [sync-setup-bun-deps-action.mjs](sync-setup-bun-deps-action.md)                     | JS Module |
 | [upgrade-nitra-cursor-and-install.mjs](upgrade-nitra-cursor-and-install.md)         | JS Module |
-| [worktree-cli.mjs](worktree-cli.md)                                                 | JS Module |

package/scripts/hook.mjs

@@ -0,0 +1,72 @@
+/**
+ * Thin hook entrypoint для Claude Code hooks: зчитує контекст (stdin / git),
+ * делегує в `runLint({ readOnly: true })`, перекодовує exit-код у hook-протокол (1 → 2).
+ *
+ * Режими:
+ *   --post-tool-use  PostToolUse: file_path зі stdin JSON Claude Code.
+ *   --stop           Stop: робоче дерево vs HEAD (`git diff HEAD` + untracked).
+ */
+import { once } from 'node:events'
+import { cwd as processCwd } from 'node:process'
+
+import { runLint } from './lib/run-lint.mjs'
+import { collectChangedFiles } from './lib/changed-files.mjs'
+
+/**
+ * @returns {Promise<string>} вміст stdin або '' на TTY
+ */
+async function readStdin() {
+  if (process.stdin.isTTY) return ''
+  process.stdin.setEncoding('utf8')
+  const chunks = []
+  process.stdin.on('data', c => chunks.push(c))
+  try {
+    await once(process.stdin, 'end')
+  } catch {
+    // error на stdin — повертаємо що встигли
+  }
+  return chunks.join('')
+}
+
+/**
+ * Дістає `tool_input.file_path` зі stdin JSON Claude Code PostToolUse hook.
+ * @param {string} json сирий stdin
+ * @returns {string|null}
+ */
+export function extractFilePath(json) {
+  if (!json) return null
+  try {
+    const fp = JSON.parse(json)?.tool_input?.file_path
+    return typeof fp === 'string' && fp !== '' ? fp : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * CLI для `n-cursor hook`.
+ * @param {string[]} argv аргументи після 'hook'
+ * @returns {Promise<number>} exit-код (0 — чисто; 2 — є порушення hook-протокол)
+ */
+export async function runHookCli(argv) {
+  const cwd = processCwd()
+  const postToolUse = argv.includes('--post-tool-use')
+  const stop = argv.includes('--stop')
+
+  if (!postToolUse && !stop) {
+    process.stderr.write('hook: потрібен --post-tool-use або --stop\n')
+    return 1
+  }
+
+  let files
+  if (postToolUse) {
+    const fp = extractFilePath(await readStdin())
+    if (!fp) return 0
+    files = [fp]
+  } else {
+    files = collectChangedFiles(cwd)
+  }
+
+  const code = await runLint({ files, readOnly: true, cwd })
+  return code !== 0 ? 2 : 0
+}

package/scripts/lib/docs/index.md

@@ -6,40 +6,39 @@ resource: npm/scripts/lib/
 
 # npm/scripts/lib
 
-| Файл                                                                        | Тип       |
-| --------------------------------------------------------------------------- | --------- |
-| [assert-project-root.mjs](assert-project-root.md)                           | JS Module |
-| [changed-files.mjs](changed-files.md)                                       | JS Module |
-| [check-mdc-template-refs.mjs](check-mdc-template-refs.md)                   | JS Module |
-| [check-reporter.mjs](check-reporter.md)                                     | JS Module |
-| [diff-added-lines.mjs](diff-added-lines.md)                                 | JS Module |
+| Файл | Тип |
+|---|---|
+| [assert-project-root.mjs](assert-project-root.md) | JS Module |
+| [changed-files.mjs](changed-files.md) | JS Module |
+| [check-mdc-template-refs.mjs](check-mdc-template-refs.md) | JS Module |
+| [check-reporter.mjs](check-reporter.md) | JS Module |
+| [diff-added-lines.mjs](diff-added-lines.md) | JS Module |
 | [discover-check-rules-from-cursor.mjs](discover-check-rules-from-cursor.md) | JS Module |
-| [discover-checkable-rules.mjs](discover-checkable-rules.md)                 | JS Module |
-| [ensure-tool.mjs](ensure-tool.md)                                           | JS Module |
-| [generated-markdown.mjs](generated-markdown.md)                             | JS Module |
-| [gha-workflow.mjs](gha-workflow.md)                                         | JS Module |
-| [inline-template-links.mjs](inline-template-links.md)                       | JS Module |
-| [list-project-rules-mdc.mjs](list-project-rules-mdc.md)                     | JS Module |
-| [list-rule-ids.mjs](list-rule-ids.md)                                       | JS Module |
-| [load-cursor-config.mjs](load-cursor-config.md)                             | JS Module |
-| [mirror-parity.mjs](mirror-parity.md)                                       | JS Module |
-| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md)               | JS Module |
-| [resolve-target-files.mjs](resolve-target-files.md)                         | JS Module |
-| [root-notice.mjs](root-notice.md)                                           | JS Module |
-| [rule-meta-helpers.mjs](rule-meta-helpers.md)                               | JS Module |
-| [rule-meta.mjs](rule-meta.md)                                               | JS Module |
-| [rule-predicates.mjs](rule-predicates.md)                                   | JS Module |
-| [run-conftest-batch.mjs](run-conftest-batch.md)                             | JS Module |
-| [run-lint-step.mjs](run-lint-step.md)                                       | JS Module |
-| [run-lint.mjs](run-lint.md)                                                 | JS Module |
-| [run-rule-cli.mjs](run-rule-cli.md)                                         | JS Module |
-| [run-rule.mjs](run-rule.md)                                                 | JS Module |
-| [run-standard-lint.mjs](run-standard-lint.md)                               | JS Module |
-| [run-standard-rule.mjs](run-standard-rule.md)                               | JS Module |
-| [skill-meta.mjs](skill-meta.md)                                             | JS Module |
-| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md)                   | JS Module |
-| [template.mjs](template.md)                                                 | JS Module |
-| [timing-summary.mjs](timing-summary.md)                                     | JS Module |
-| [workspaces.mjs](workspaces.md)                                             | JS Module |
-| [worktree-notice.mjs](worktree-notice.md)                                   | JS Module |
-| [worktree.mjs](worktree.md)                                                 | JS Module |
+| [discover-checkable-rules.mjs](discover-checkable-rules.md) | JS Module |
+| [ensure-tool.mjs](ensure-tool.md) | JS Module |
+| [generated-markdown.mjs](generated-markdown.md) | JS Module |
+| [gha-workflow.mjs](gha-workflow.md) | JS Module |
+| [inline-template-links.mjs](inline-template-links.md) | JS Module |
+| [list-project-rules-mdc.mjs](list-project-rules-mdc.md) | JS Module |
+| [list-rule-ids.mjs](list-rule-ids.md) | JS Module |
+| [load-cursor-config.mjs](load-cursor-config.md) | JS Module |
+| [mirror-parity.mjs](mirror-parity.md) | JS Module |
+| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md) | JS Module |
+| [resolve-target-files.mjs](resolve-target-files.md) | JS Module |
+| [root-notice.mjs](root-notice.md) | JS Module |
+| [rule-meta-helpers.mjs](rule-meta-helpers.md) | JS Module |
+| [rule-meta.mjs](rule-meta.md) | JS Module |
+| [rule-predicates.mjs](rule-predicates.md) | JS Module |
+| [run-conftest-batch.mjs](run-conftest-batch.md) | JS Module |
+| [run-lint-step.mjs](run-lint-step.md) | JS Module |
+| [run-lint.mjs](run-lint.md) | JS Module |
+| [run-rule-cli.mjs](run-rule-cli.md) | JS Module |
+| [run-rule.mjs](run-rule.md) | JS Module |
+| [run-standard-lint.mjs](run-standard-lint.md) | JS Module |
+| [run-standard-rule.mjs](run-standard-rule.md) | JS Module |
+| [skill-meta.mjs](skill-meta.md) | JS Module |
+| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md) | JS Module |
+| [template.mjs](template.md) | JS Module |
+| [timing-summary.mjs](timing-summary.md) | JS Module |
+| [workspaces.mjs](workspaces.md) | JS Module |
+| [worktree-notice.mjs](worktree-notice.md) | JS Module |

package/scripts/lib/docs/rule-meta.md

@@ -3,29 +3,30 @@ type: JS Module
 title: rule-meta.mjs
 resource: npm/scripts/lib/rule-meta.mjs
 docgen:
-  crc: 8eca71d2
+  crc: dd8fe34a
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Файл зчитує метадані правил з `npm/rules/<id>/main.json`. Він нормалізує специфікації активації (`auto`) та області застосування (`lint`). Специфікація `main.json.auto` може мати чотири форми: константу `RULE_ALWAYS` ("завжди"), масив залежних правил, об'єкт з шаблоном `glob` або об'єкт з предикатом. Це забезпечує механізм для визначення умов активації правила на основі конфігурації `main.json`.
+Парсер метаданих правил з `npm/rules/<id>/main.json` інтерпретує специфікації активації (`auto`) та області дії (`lint`). Він нормалізує логіку, визначену у `main.json.auto`, яка може бути константою `RULE_ALWAYS="завжди"`, списком залежностей, об'єктом з шаблоном `glob`, або предикатом. Код лише зчитує дані та не виконує операцій з файловою системою чи базами даних. При виникненні помилок він перехоплює їх, повертаючи безпечне значення замість винятків.
 
 ## Поведінка
 
 RULE_ALWAYS — Константа, що позначає безумовну активацію правила.
 parseRuleAutoSpec — Нормалізує значення поля `auto` з `main.json` у дискриміновану специфікацію активації правила.
-parseRuleLintSpec — Нормалізує значення поля `lint` з `main.json` у специфікацію області застосування детектора.
-readRuleMetaRaw — Зчитує та парсить вміст `main.json` з каталогу правила, повертаючи його як об'єкт або `null` у разі помилки чи відсутності файлу.
+parseRuleLintSpec — Нормалізує значення поля `lint` з `main.json` у специфікацію області дії детектора.
+readRuleMetaRaw — Зчитує та парсить вміст `main.json` з каталогу правила, повертаючи його як об'єкт або `null`.
 
 ## Публічний API
 
-RULE_ALWAYS — позначка для безумовної активації.
-parseRuleAutoSpec — перетворює налаштування автоматичного визначення правил з `main.json` у структурований формат.
-parseRuleLintSpec — перетворює налаштування лінтера з `main.json` у визначення області дії детектора.
-"per-file" — визначає, що детектор аналізує зміни на рівні окремих файлів (порівнює відмінності з оригіналом).
-"full" — визначає, що детектор аналізує весь проєкт одночасно (активується лише при використанні прапорця `--full` або в CI).
+RULE_ALWAYS — константа, що вказує на безумовну активацію.
+parseRuleAutoSpec — перетворює налаштування автоматичного сканування з `main.json` у структурований формат.
+parseRuleLintSpec — перетворює налаштування лінтування з `main.json` у визначення області дії детектора.
+"per-file" — визначає, що детектор аналізує лише змінені файли (порівнюючи їх з оригіналом).
+"full" — визначає, що детектор сканує весь репозиторій; у режимі змін тригериться лише при перетині змінених файлів з шаблоном `auto.glob`.
+Об'єктна форма `{scope, ci}` скасована — оскільки режим CI (`--read-only --full`) сканує весь репозиторій, окремі перевизначення CI для кожного правила не потрібні.
 readRuleMetaRaw — зчитує та розбирає метадані одного правила з `main.json`.
 
 ## Гарантії поведінки

package/scripts/lib/docs/run-lint.md

@@ -3,27 +3,28 @@ type: JS Module
 title: run-lint.mjs
 resource: npm/scripts/lib/run-lint.mjs
 docgen:
-  crc: 24827b04
+  crc: f574f097
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль ініціалізує та керує процесом лінтування коду. Він вибирає та сортує набір правил для перевірки, використовуючи конфігурації `meta.json` та `.n-cursor.json`. Публічна функція `selectLintRules` виконує вибір правил. Публічна функція `runLint` ініціює повний цикл лінтування, який може включати перевірку змінених файлів або всього репозиторію.
+Модуль керує процесом лінтування коду. Він визначає набір активних правил лінтування, використовуючи конфігурації з `meta.json` та `.n-cursor.json`. Модуль надає можливість вибрати ці правила за допомогою `selectLintRules` та ініціювати запуск перевірки коду за допомогою `runLint`.
 
 ## Поведінка
 
-selectLintRules вибирає і алфавітно сортує ідентифікатори правил для лінтування, ґрунтуючись на наявності в конфігурації та заданому обсязі перевірки.
-runLint запускає повну оркестрацію лінтування, виконуючи перевірку змінених файлів або весь репозиторій, залежно від параметрів, і може включати фази конформності та форматування.
+selectLintRules визначає, які правила лінтуються на основі їхньої конфігурації та активності в `.n-cursor.json`, повертаючи відсортований список ID.
+runLint запускає лінтер-оркестрацію залежно від наданих опцій: виконує прогін для конкретних правил, перевіряє лише змінені файли, виконує повний прогін репозиторію або форматування.
 
 ## Публічний API
 
-selectLintRules — обирає ідентифікатори правил для контексту, розташовуючи їх в алфавітному порядку.
+selectLintRules — вибирає ідентифікатори правил для контексту в алфавітному порядку.
 runLint — ініціює процес лінтування.
-full — сканує весь репозиторій, порівнюючи його з початковим станом.
-readOnly — лише виявляє проблеми, не вносячи змін, порівнюючи з початковим станом.
-rules — виконує повне сканування лише для вказаних правил у заданому обсязі.
+full — аналізує весь репозиторій, порівнюючи поточний стан із початковим.
+readOnly — лише виявляє проблеми, не вносячи змін.
+rules — виконує повний прогін лише для заданого набору правил у вказаному контексті.
+files — виконує перевірку лише для перелічених файлів у режимі хука.
 
 ## Гарантії поведінки
 

package/scripts/lib/docs/run-rule.md

@@ -3,25 +3,25 @@ type: JS Module
 title: run-rule.mjs
 resource: npm/scripts/lib/run-rule.mjs
 docgen:
-  crc: 7d0585e1
+  crc: c9b164c7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 90
+  score: 100
 ---
 
 ## Огляд
 
-Файл оркеструє виконання одного правила під CLI `fix`. Він послідовно застосовує гейт `applies` з `js/applies.mjs` для визначення придатності правила. Якщо гейт повертає `false`, правило не застосовується. Далі виконуються JS-концерни та Policy-концерни в алфавітному порядку. Резолвер `resolveTargetFiles` ділить кеш між концернами. Кожен concern створює власний репортер, а їхні exit-коди OR-уються в єдиний контракт, що забезпечує 0/1 результат для правила. Оркестратор спирається на конфігурації `target.json` та `.n-cursor.json`.
+Файл оркеструє виконання одного правила під CLI `fix`. Він послідовно застосовує `applies`-гейт, а потім виконує JS-концерни та Policy-концерни. Резолвер ділить кеш між концернами, а кожен concern має власний механізм звітності, що об'єднується в єдиний exit-код правила. Процес спирається на конфігураційні файли, зокрема `target.json` та `.n-cursor.json`.
 
 ## Поведінка
 
-runTemplateSubsetConcern виконує перевірку концерну, де канон визначається сніпетом у `target.json`, звіряючи його з актуальними файлами-таргетами.
+runTemplateSubsetConcern виконує перевірку концерну, де канон визначено у `target.json` як `template`, звіряючи вміст файлів-таргетів з шаблоном, визначеним у відповідному каталозі.
 
-runRule оркеструє виконання одного правила, послідовно застосовуючи applies-гейт, виконуючи JS-концерни та запускаючи policy-концерни, а також перевіряючи відсутність markdown-посилань.
+runRule оркеструє виконання одного правила, послідовно застосовуючи `applies`-гейт, виконуючи JS-концерни, запускаючи policy-концерни та перевіряючи відсутність markdown-посилань у `main.mdc`.
 
 ## Публічний API
 
-runTemplateSubsetConcern — Порівнює фактичний файл із канонічним шаблоном (з `target.json`) для перевірки, чи всі обов'язкові елементи присутні, дозволяючи додаткові.
-runRule — Виконує окреме правило, яке проходить через перевірки застосовності, JavaScript-концерни та політики.
+runTemplateSubsetConcern — Порівнює фактичний файл з канонічним шаблоном (`target.json:"check":"template"`), визначаючи, чи всі обов'язкові елементи з шаблону присутні у файлі.
+runRule — Виконує окреме правило, перевіряючи його відповідність через гейт, JavaScript-концерни та політики.
 
 ## Гарантії поведінки
 

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

@@ -15,5 +15,4 @@ resource: npm/scripts/lib/fix/
 | [llm-worker.mjs](llm-worker.md)                       | JS Module |
 | [orchestrator.mjs](orchestrator.md)                   | JS Module |
 | [run-conformance-check.mjs](run-conformance-check.md) | JS Module |
-| [run-fix-check.mjs](run-fix-check.md)                 | JS Module |
 | [t0.mjs](t0.md)                                       | JS Module |

package/scripts/lib/rule-meta.mjs

@@ -54,7 +54,8 @@ const LINT_SCOPES = new Set(['per-file', 'full'])
 /**
  * Нормалізує значення `main.json.lint` у scope детектора.
  *  - `"per-file"` — детектор декомпозується на змінені файли (дельта vs origin);
- *  - `"full"`     — нероздільно крос-файловий (лише `--full` / CI).
+ *  - `"full"`     — крос-файловий: у `--full` ганяє весь репо; у delta-режимі тригериться
+ *                   лише якщо змінені файли перетинаються з `auto.glob` правила (whole-repo scan).
  * Об'єктна форма `{scope, ci}` скасована: CI=`--read-only --full` ганяє все повністю,
  * тож per-rule CI-override не потрібен (spec 2026-06-14-lint-rule-consolidation §3-А).
  * @param {unknown} value значення поля `lint`

package/scripts/lib/run-lint.mjs

@@ -5,7 +5,9 @@ import { fileURLToPath } from 'node:url'
 import { cwd as processCwd } from 'node:process'
 import { spawnSync } from 'node:child_process'
 
-import { parseRuleLintSpec, readRuleMetaRaw } from './rule-meta.mjs'
+import picomatch from 'picomatch'
+
+import { parseRuleAutoSpec, parseRuleLintSpec, readRuleMetaRaw } from './rule-meta.mjs'
 import { collectChangedFilesSince, resolveChangedBase } from './changed-files.mjs'
 import { resolveCmd } from '../utils/resolve-cmd.mjs'
 import { isRuleEnabled, readNCursorConfigLite } from './read-n-cursor-config-lite.mjs'
@@ -78,6 +80,30 @@ export function selectLintRules(metaById, full, enabledRuleIds) {
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
+/**
+ * Визначає `full`-scope правила для запуску у delta-режимі.
+ * Правило включається, якщо хоча б один зі змінених файлів відповідає `auto.glob` правила.
+ * Предикат-auto (repo-level сигнал, не file-level) — пропускається.
+ * @param {Record<string, Record<string, unknown>>} metaById
+ * @param {string[]} changed змінені файли (posix-відносні від кореня)
+ * @param {string[]} enabledRuleIds активні rule-id
+ * @returns {string[]} відсортовані id
+ */
+function selectFullRulesForDelta(metaById, changed, enabledRuleIds) {
+  if (changed.length === 0) return []
+  const enabled = new Set(enabledRuleIds)
+  const out = []
+  for (const [id, raw] of Object.entries(metaById)) {
+    if (!enabled.has(id)) continue
+    if (parseRuleLintSpec(raw?.lint) !== 'full') continue
+    const autoSpec = parseRuleAutoSpec(raw?.auto)
+    if (!autoSpec || !('glob' in autoSpec)) continue
+    const isMatch = picomatch(autoSpec.glob, { dot: true })
+    if (changed.some(f => isMatch(f))) out.push(id)
+  }
+  return out.toSorted((a, b) => a.localeCompare(b))
+}
+
 /**
  * Активні правила для unscoped linter-фази. `.n-cursor.json` — єдине джерело
  * whitelist/disable, `meta.json#lint` нижче використовується лише як scope (`per-file`/`full`).
@@ -211,16 +237,18 @@ async function runScopedRules(rules, ctx) {
 
 /**
  * Запускає lint-оркестрацію.
- * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], files?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
  *   - `full` — весь репо (`true`) проти дельти vs origin (`false`, default);
  *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default);
- *   - `rules` — непорожній scope → повний прогін лише цих правил (лінтер + конформність, whole-repo).
+ *   - `rules` — непорожній scope → повний прогін лише цих правил (лінтер + конформність, whole-repo);
+ *   - `files` — явний список файлів (hook-режим): per-file правила без conformance/format/delta-full.
  * @returns {Promise<number>} exit code
  */
 export async function runLint(opts = {}) {
   const full = opts.full === true
   const readOnly = opts.readOnly === true
   const rules = Array.isArray(opts.rules) ? opts.rules : []
+  const explicitFiles = Array.isArray(opts.files) ? opts.files : null
   const cwd = opts.cwd ?? processCwd()
   const rulesDir = opts.rulesDir ?? RULES_DIR
   const log = opts.log ?? (s => process.stdout.write(s))
@@ -230,6 +258,17 @@ export async function runLint(opts = {}) {
     return runScopedRules(rules, { cwd, readOnly, rulesDir, conformance: opts.rulesDir === undefined, log })
   }
 
+  // Hook-режим (явний список файлів): per-file правила, без conformance/format/delta-full.
+  // Правила отримують точний список файлів; пусті files (Stop без змін) — правила однаково
+  // викликаються (orphan-детект у doc-files не залежить від списку джерел).
+  if (explicitFiles !== null) {
+    const metaById = readAllMeta(rulesDir)
+    const enabledRuleIds = await readEnabledLintRuleIds(metaById, cwd)
+    const ids = selectLintRules(metaById, false, enabledRuleIds)
+    const perFile = await runPerFileRules(ids, { rulesDir, changed: explicitFiles, cwd, readOnly, metaById, log })
+    return perFile.stop ? perFile.code : perFile.code
+  }
+
   // Default scope — дельта vs origin (merge-base main/origin/main); `--full` — весь репо.
   const changed = full ? undefined : collectChangedFilesSince(resolveChangedBase(cwd), cwd)
   if (!full && changed.length === 0) {
@@ -244,6 +283,18 @@ export async function runLint(opts = {}) {
   if (perFile.stop) return perFile.code
   let worst = perFile.code
 
+  // Delta-режим: `full`-scope правила, чиї glob-и перетинаються з changed.
+  // Запускаємо з `changed=undefined` (whole-repo scan як зазвичай) — так уникаємо
+  // прогону docker/ga/k8s… коли жоден їхній файл не змінився.
+  if (!full && changed.length > 0) {
+    const fullIds = selectFullRulesForDelta(metaById, changed, enabledRuleIds)
+    if (fullIds.length > 0) {
+      const fullResult = await runPerFileRules(fullIds, { rulesDir, changed: undefined, cwd, readOnly, metaById, log })
+      if (fullResult.stop) return fullResult.code
+      if (fullResult.code !== 0) worst = fullResult.code
+    }
+  }
+
   // Конформність-фаза: whole-repo, лише у `--full`. Кастомний rulesDir (юніт-тести
   // селектора) — реальний пакет недоступний, тож пропускаємо.
   if (full && opts.rulesDir === undefined) {

package/scripts/lib/run-rule.mjs

@@ -117,8 +117,7 @@ async function runPolicyConcern(bundledRulesDir, ruleId, concernName, walkCache)
   if (files.length === 0) {
     if (target.files.required && target.files.single) {
       const msg =
-        target.missingMessage ??
-        `${target.files.single} не існує — створи згідно main.mdc (${ruleId}.${concernName})`
+        target.missingMessage ?? `${target.files.single} не існує — створи згідно main.mdc (${ruleId}.${concernName})`
       reporter.fail(msg)
     }
     return reporter.getExitCode()

package/skills/adr-normalize/SKILL.md

@@ -3,6 +3,7 @@ name: n-adr-normalize
 description: >-
   Ручний запуск ADR-нормалізації — обхід порогу й min-interval, прогон одного
   батчу чернеток через LLM, перегляд результату через git diff
+version: '1.0'
 ---
 
 # n-adr-normalize — ручна нормалізація ADR-чернеток

package/skills/coverage-fix/SKILL.md

@@ -2,6 +2,7 @@
 name: n-coverage-fix
 description: >-
   Автономна команда: запускає n-cursor coverage → читає вцілілих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
+version: '1.0'
 ---
 
 # n-coverage-fix — підвищення mutation score

package/skills/doc-aggregate/SKILL.md

@@ -2,6 +2,7 @@
 name: doc-aggregate
 description: >-
   Агрегуюча документація за запитом: module-summary на кожен логічний модуль (docs/ARCHITECTURE.md) і доменні доки бізнес-процесів у кореневій docs/ — синтез поверх готових файлових док (doc-files), батч-диспатч субагентів у worktree
+version: '1.0'
 ---
 
 # doc-aggregate — агрегуюча документація (за запитом)

package/skills/doc-files/SKILL.md

@@ -2,6 +2,7 @@
 name: doc-files
 description: >-
   Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+version: '1.0'
 ---
 
 # doc-files — файлова документація (обовʼязковий крок)