@nitra/cursor 12.8.7 → 12.8.9

package/scripts/lib/docs/index.md

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

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`).
@@ -244,6 +270,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) {