@nitra/cursor 5.4.0 → 7.0.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [7.0.0] - 2026-06-14
+
+### Changed
+
+- lint --full поглинає конформність (колишній fix): read-only → детект через per-rule fix.mjs run(); fix → convergence-движок. Конформність як whole-repo фаза лише у --full
+- lint приймає фільтр правил (lint <rule>) → конформність лише цих правил (мапить колишній fix <rule>); hk pre-commit changelog → lint changelog
+- governance: знято заборону паралельного eslint — паралельно по диз'юнктних файлах дозволено; серіалізувати лише whole-tree прогони того самого корпусу (CLAUDE.md-секція + n-lint SKILL)
+
+### Removed
+
+- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/_fix-check лишаються внутрішніми фазами движка
+
+## [6.0.0] - 2026-06-14
+
+### Added
+
+- fix-doc-files: пер-файловий таймінг у виводі — `<total>s (llm <llmS>/<N> calls, orch <orchS>)`: видно, скільки часу зайняла модель (і кількість LLM-викликів) проти JS-оркестрації. `generateDoc` повертає `llmMs`/`llmCalls`; облік через прозору обгортку `callLlm` (синхронні spawnSync-виклики, послідовна генерація — без гонок).
+
+### Changed
+
+- lint: вісь scope per-file|full (база-origin) + вісь behavior fix-by-default/--read-only; meta.json:lint hard-rename quick|ci→per-file|full; lint-ci=--read-only --full; контракт lint(files,cwd,{readOnly})
+
 ## [5.4.0] - 2026-06-14
 
 ### Added

package/bin/n-cursor.js

@@ -637,15 +637,16 @@ async function removeOrphanManagedSkillDirs(skillsRoot, configSkills) {
 }
 
 /**
- * Рендерить коротку секцію для CLAUDE.md: не розпаралелювати лінт (ESLint) між shells/субагентами.
+ * Рендерить коротку секцію для CLAUDE.md: паралелізм лінту — по диз'юнктних файлах дозволено,
+ * серіалізувати лише whole-tree прогони того самого корпусу.
  * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
  */
 function buildClaudeLintParallelismSectionLines() {
   return [
     '',
-    '## Лінт і ESLint (без паралельних запусків)',
+    '## Лінт і ESLint (паралелізм)',
     '',
-    'Щоб не запускати **кілька** одночасних **`eslint`** (і не перевантажувати диск/CPU), **заборонено** стартувати `bun run lint` / `lint-js` / `eslint` **паралельно** в різних Bash-задачах, **фонових** shells чи **субагентах** (Task тощо). Має бути **один** послідовний прогон на сесію; команда **`/n-lint`** — **не** ділити на паралельні підзадачі. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
+    'Паралельний лінт по **різних** файлах — **дозволено**: диз\'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
     ''
   ]
 }
@@ -1597,7 +1598,7 @@ async function runSync() {
  * `--root`-команди `lint-doc-files`/`fix-doc-files`/`doc-files`/`doc-aggregate`/`rename-yaml-extensions`, `worktree`,
  * sub-лінтери) гард не зачіпає.
  */
-const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'fix', 'check', 'lint', 'coverage', 'change', 'release'])
+const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'lint', 'coverage', 'change', 'release'])
 
 /**
  * Короткий опис дії для тексту root-guard помилки за іменем команди.
@@ -1610,12 +1611,8 @@ function describeRootGuardedAction(cmd) {
     case '': {
       return 'Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-cursor.json і робить bun install у поточному каталозі'
     }
-    case 'fix':
-    case 'check': {
-      return '`fix` запускає programmatic-перевірки правил, що переписують конфіги в поточному каталозі'
-    }
     case 'lint': {
-      return '`lint` запускає авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) у поточному каталозі'
+      return '`lint` за замовчуванням авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) і конформності (--full) у поточному каталозі'
     }
     case 'coverage': {
       return '`coverage` генерує COVERAGE.md і Stryker-артефакти в поточному каталозі'
@@ -1646,29 +1643,13 @@ try {
   }
   await ensureNitraCursorInRootDevDependencies(cwd())
   switch (command) {
-    case 'fix': {
-      const { runOrchestratorCli } = await import('../skills/fix/js/orchestrator.mjs')
-      process.exitCode = await runOrchestratorCli(args, cwd())
-      break
-    }
     case '_fix-check': {
-      // Внутрішня команда оркестратора — не є публічним API.
-      // Повертає JSON {total, failed, rules:[{ruleId, ok, output}]} у stdout.
+      // Внутрішня команда движка конформності (не публічний API): per-rule fix.mjs run() = детект.
+      // Повертає JSON {total, failed, rules:[{ruleId, ok, output}]} у stdout. Викликається
+      // конформність-фазою `lint` (read-only) і движком orchestrator/t0.
       await runFixCommand(args, { json: true })
       break
     }
-    case 'check': {
-      // Backward-compatibility alias. Перейменовано на `fix` у 1.13.84 (узгоджено з ім'ям файла `rules/<id>/fix.mjs`).
-      console.warn(
-        `⚠️  Команда \`check\` deprecated — використовуйте \`fix\` (\`npx ${PACKAGE_NAME} fix [<rule>...]\`)`
-      )
-      await runFixCommand(
-        args.filter(a => a !== '--json'),
-        { json: args.includes('--json') }
-      )
-
-      break
-    }
     case 'rename-yaml-extensions': {
       const code = await runRenameYamlExtensionsCli(args)
       if (code !== 0) {
@@ -1686,12 +1667,21 @@ try {
       break
     }
     case 'lint': {
-      process.exitCode = await runLint({ ci: false })
+      // Дві ортогональні осі: --full (scope: весь репо vs дельта vs origin) × --read-only (behavior).
+      // Позиційні (не-флаг) аргументи — фільтр правил конформності (напр. `lint changelog`):
+      // прогнати лише конформність цих правил, без лінтер-скану (мапить колишній `fix <rule>`).
+      const rules = args.filter(a => !a.startsWith('-'))
+      process.exitCode = await runLint({
+        full: args.includes('--full'),
+        readOnly: args.includes('--read-only'),
+        rules
+      })
 
       break
     }
     case 'lint-ci': {
-      process.exitCode = await runLint({ ci: true })
+      // CI = весь репо в read-only (нуль мутацій, нуль LLM) — еквівалент `lint --read-only --full`.
+      process.exitCode = await runLint({ full: true, readOnly: true })
 
       break
     }
@@ -1762,19 +1752,12 @@ try {
 
       break
     }
-    case 'fix-run': {
-      // Backward-compatibility alias → перенаправляємо на `fix`.
-      console.warn(`⚠️  \`fix-run\` deprecated — використовуйте \`fix\``)
-      const { runOrchestratorCli } = await import('../skills/fix/js/orchestrator.mjs')
-      process.exitCode = await runOrchestratorCli(args, cwd())
-      break
-    }
     case 'fix-t0': {
-      // n-cursor fix-t0 [rule...] — T0-auto рівень n-fix оркестратора.
-      // Запускає fix --json, знаходить violation-output із детермінованим паттерном
+      // Внутрішня фаза движка конформності (не публічний API): T0-auto рівень.
+      // Запускає _fix-check, знаходить violation-output із детермінованим паттерном
       // (vscode-ext-add, rm-forbidden-file тощо), застосовує програмний фікс (0 LLM),
-      // перевіряє check-gate. Exit 0 = усі T0-паттерни закриті; 1 = є решта для LLM.
-      const { runT0AutoCli } = await import('../skills/fix/js/t0.mjs')
+      // перевіряє check-gate. Викликається orchestrator.mjs (fix-режим конформності lint).
+      const { runT0AutoCli } = await import('../scripts/lib/fix/t0.mjs')
       process.exitCode = await runT0AutoCli(args, cwd())
 
       break
@@ -1890,7 +1873,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, trace, doc-files, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, change, release, skill, worktree, lint-ci, trace, doc-files, doc-aggregate`
       )
       process.exitCode = 1
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "5.4.0",
+  "version": "7.0.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/doc-files/js/docgen-files-batch.mjs

@@ -90,6 +90,19 @@ function modeSuffix({ overwrite, retryDegraded }) {
   return ''
 }
 
+/**
+ * Рядок таймінгу одного файлу: загальний час, час у LLM (і кількість викликів)
+ * та залишок — оркестрація (екстракт фактів, скоринг, парсинг, IO). Дає зрозуміти,
+ * скільки коштує сама модель проти JS-оркестрації.
+ * @param {{ ms: number, llmMs?: number, llmCalls?: number }} r результат generateDoc
+ * @returns {string} напр. `12.3s (llm 11.8s/7 calls, orch 0.5s)`
+ */
+function fmtTiming(r) {
+  const s = ms => `${(ms / 1000).toFixed(1)}s`
+  const llmMs = r.llmMs ?? 0
+  return `${s(r.ms)} (llm ${s(llmMs)}/${r.llmCalls ?? 0} calls, orch ${s(r.ms - llmMs)})`
+}
+
 /**
  * Генерує й штампує доку для одного файлу, оновлюючи лічильники й прогрес.
  * @param {object} file елемент scanForDocFiles
@@ -114,9 +127,9 @@ async function generateOne(file, root, progress, stats) {
     stats.ok++
     if (result.degraded) {
       stats.degraded++
-      process.stdout.write(`⚠ degraded score=${result.score} crc=${crc}\n`)
+      process.stdout.write(`⚠ degraded score=${result.score} crc=${crc}  ${fmtTiming(result)}\n`)
     } else {
-      process.stdout.write(`✓ score=${result.score ?? '—'} crc=${crc}\n`)
+      process.stdout.write(`✓ score=${result.score ?? '—'} crc=${crc}  ${fmtTiming(result)}\n`)
     }
   } catch (error) {
     stats.err++
@@ -137,7 +150,7 @@ function reportStats(stats) {
     for (const e of stats.errors) console.log(`  - ${e}`)
   }
   if (stats.degraded > 0) {
-    console.log(`Degraded-доки перегенеровуються пізніше: npx @nitra/cursor doc-files gen --retry-degraded`)
+    console.log(`Degraded-доки перегенеровуються пізніше: npx @nitra/cursor fix-doc-files --retry-degraded`)
   }
 }
 
@@ -164,7 +177,7 @@ export async function runDocFilesGenCli(argv) {
 
   const problem = preflightProblem()
   if (problem) {
-    console.error(`✗ doc-files gen: ${problem}`)
+    console.error(`✗ fix-doc-files: ${problem}`)
     return 1
   }
 
@@ -201,7 +214,7 @@ export function runDocFilesStampCli(argv) {
     writeFileSync(docAbs, stampDoc(md, file.sourcePath, crc, score === null ? null : { score, issues }))
     stamped++
   }
-  console.log(`✓ doc-files stamp: оновлено frontmatter у ${stamped} доці(ах).`)
+  console.log(`✓ fix-doc-files --stamp: оновлено frontmatter у ${stamped} доці(ах).`)
   return 0
 }
 

package/rules/doc-files/js/docgen-gen.mjs

@@ -4,7 +4,7 @@ import { basename } from 'node:path'
 import { env } from 'node:process'
 import { resolveModel } from '../../../lib/models.mjs'
 import { DEFAULT_OMLX_MODEL } from '../../../lib/omlx.mjs'
-import { callLlm } from '../../../lib/llm.mjs'
+import { callLlm as callLlmRaw } from '../../../lib/llm.mjs'
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
 import { docPathForSource } from './docgen-scan.mjs'
 import { extractFacts } from './docgen-extract.mjs'
@@ -19,6 +19,26 @@ import {
   guaranteesFromMarkers
 } from './docgen-prompts.mjs'
 
+/** Облік LLM-викликів і часу в них у межах однієї генерації (скидається на старті generateDoc). */
+let llmMeter = { calls: 0, ms: 0 }
+
+/**
+ * Обгортка callLlm з обліком: лічить кількість викликів і сумарний час у них.
+ * callLlm синхронний (spawnSync/curl), генерація одного файлу послідовна — лічильник без гонок.
+ * Усі виклики `callLlm(...)` у цьому модулі йдуть через неї автоматично (імпорт як callLlmRaw).
+ * @param {...any} args ті самі аргументи, що й у callLlm з lib/llm.mjs
+ * @returns {string} відповідь моделі
+ */
+function callLlm(...args) {
+  const started = Date.now()
+  try {
+    return callLlmRaw(...args)
+  } finally {
+    llmMeter.calls += 1
+    llmMeter.ms += Date.now() - started
+  }
+}
+
 const FENCE_OPEN_RE = /^```[a-z]*\n?/
 const FENCE_CLOSE_RE = /\n?```\s*$/
 const LEADING_HEADING_RE = /^#{1,6}[ \t]{1,8}[^\n]{0,400}\n{1,8}/
@@ -360,12 +380,13 @@ export const DEFAULT_LOCAL_MODEL = env.N_CURSOR_DOCGEN_MODEL ?? (resolveModel('m
  * позначається `degraded`, рішення про перегенерацію приймає batch/користувач.
  * @param {string} file абсолютний шлях джерела
  * @param {{ model?: string, threshold?: number, existingMd?: string|null }} [opts] model-id, поріг degraded, наявна дока (для збереження захищеної секції)
- * @returns {{ md: string, ms: number, score: number|null, issues: string[], degraded: boolean, model: string }} документ і метадані генерації
+ * @returns {{ md: string, ms: number, llmMs: number, llmCalls: number, score: number|null, issues: string[], degraded: boolean, model: string }} документ і метадані генерації (ms — увесь файл; llmMs/llmCalls — лише LLM; решта ms — оркестрація)
  */
 export function generateDoc(file, { model = DEFAULT_LOCAL_MODEL, threshold = QUALITY_THRESHOLD, existingMd = null } = {}) {
   const src = readFileSync(file, 'utf8')
   const facts = extractFacts(src, file)
   const t0 = Date.now()
+  llmMeter = { calls: 0, ms: 0 }
 
   // Варіант B: захищена секція «Призначення» з наявної доки — зберегти й подати як контекст
   const intent = existingMd ? splitProtected(existingMd).body : null
@@ -376,7 +397,16 @@ export function generateDoc(file, { model = DEFAULT_LOCAL_MODEL, threshold = QUA
 
   // unsupported (vue/py до юніт-шару): скорер не застосовний — score=null, не degraded
   if (facts.unsupported) {
-    return { ...r, ms: Date.now() - t0, score: null, issues: [], degraded: false, model }
+    return {
+      ...r,
+      ms: Date.now() - t0,
+      llmMs: llmMeter.ms,
+      llmCalls: llmMeter.calls,
+      score: null,
+      issues: [],
+      degraded: false,
+      model
+    }
   }
 
   // Stage 2.5: детермінований скоринг (0 токенів)
@@ -399,7 +429,16 @@ export function generateDoc(file, { model = DEFAULT_LOCAL_MODEL, threshold = QUA
     }
   }
 
-  return { ...r, ms: Date.now() - t0, score, issues, degraded: score < threshold, model }
+  return {
+    ...r,
+    ms: Date.now() - t0,
+    llmMs: llmMeter.ms,
+    llmCalls: llmMeter.calls,
+    score,
+    issues,
+    degraded: score < threshold,
+    model
+  }
 }
 
 // CLI: node docgen-gen.mjs <file> [--model <m>]
@@ -416,6 +455,8 @@ if (isRunAsCli(import.meta.url)) {
   const existingMd = existsSync(docPath) ? readFileSync(docPath, 'utf8') : null
   const r = generateDoc(file, { model, existingMd })
   const issuesTxt = r.issues?.length ? ` issues=${r.issues.join(',')}` : ''
-  process.stderr.write(`[local ${r.model}] ${r.ms}ms / score=${r.score}${r.degraded ? ' DEGRADED' : ''}${issuesTxt}\n`)
+  process.stderr.write(
+    `[local ${r.model}] ${r.ms}ms (llm ${r.llmMs}ms/${r.llmCalls} calls, orch ${r.ms - r.llmMs}ms) / score=${r.score}${r.degraded ? ' DEGRADED' : ''}${issuesTxt}\n`
+  )
   process.stdout.write(r.md)
 }

package/rules/doc-files/js/docgen-scan.mjs

@@ -229,7 +229,7 @@ function runDegradedReport(root) {
     })
     .join('\n')
   console.log(
-    `⚠ doc-files: degraded-док ${degraded.length} (score < ${QUALITY_THRESHOLD}):\n${list}\n→ перегенеруй: npx @nitra/cursor doc-files gen --retry-degraded`
+    `⚠ doc-files: degraded-док ${degraded.length} (score < ${QUALITY_THRESHOLD}):\n${list}\n→ перегенеруй: npx @nitra/cursor fix-doc-files --retry-degraded`
   )
   return 0
 }
@@ -285,7 +285,7 @@ export async function runDocFilesCheckCli(argv) {
   // Великий прогін: Stop-гейт не блокує, лише попереджає (захист від нескінченного блоку).
   if (gitMode && stale.length > gateMax) {
     console.error(
-      `⚠ doc-files: застарілих док ${stale.length} (> ${gateMax}) — гейт не блокує. Запусти масовий прогін:\n  npx @nitra/cursor doc-files gen`
+      `⚠ doc-files: застарілих док ${stale.length} (> ${gateMax}) — гейт не блокує. Запусти масовий прогін:\n  npx @nitra/cursor fix-doc-files`
     )
     return 0
   }

package/rules/doc-files/js/docs/docgen-files-batch.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/doc-files/js/docgen-files-batch.mjs
-  crc: 5c9b8d72
+  crc: 6f01f8b9
   score: 95
 ---
 

package/rules/doc-files/js/docs/docgen-gen.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/doc-files/js/docgen-gen.mjs
-  crc: e2af04d6
+  crc: 70215974
   score: 100
 ---
 

package/rules/doc-files/js/docs/docgen-scan.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/doc-files/js/docgen-scan.mjs
-  crc: 46f11827
+  crc: dcc90d44
   score: 100
 ---
 

package/rules/doc-files/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "lint": "quick" }
+{ "auto": "завжди", "lint": "per-file" }

package/rules/ga/meta.json

@@ -1 +1 @@
-{ "auto": { "glob": ".github/workflows/**" }, "lint": "ci" }
+{ "auto": { "glob": ".github/workflows/**" }, "lint": "full" }

package/rules/js-lint/js/docs/lint.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/js-lint/js/lint.mjs
-  crc: c90c15eb
+  crc: 1f38613e
   score: 100
 ---
 

package/rules/js-lint/js/lint.mjs

@@ -54,14 +54,15 @@ function runJson(args, cwd) {
 }
 
 /**
- * Full-режим (ci): лінт усього проєкту зі стрімінгом і fail-fast (без класифікації).
+ * Full-режим (--full): лінт усього проєкту зі стрімінгом і fail-fast (без класифікації).
  * @param {string} cwd корінь
+ * @param {boolean} readOnly true → без `--fix` (детект, нуль мутацій — CI)
  * @returns {number} exit code
  */
-function lintFullProject(cwd) {
-  const ox = runInherit(['oxlint', '--fix'], cwd)
+function lintFullProject(cwd, readOnly) {
+  const ox = runInherit(readOnly ? ['oxlint'] : ['oxlint', '--fix'], cwd)
   if (ox !== 0) return ox
-  return runInherit(['eslint', '--fix', '.'], cwd)
+  return runInherit(readOnly ? ['eslint', '.'] : ['eslint', '--fix', '.'], cwd)
 }
 
 /**
@@ -69,12 +70,16 @@ function lintFullProject(cwd) {
  * на introduced / pre-existing (беклог #6/A). Блокування на будь-якому finding.
  * @param {string[]} js js-подібні змінені файли
  * @param {string} cwd корінь
+ * @param {boolean} readOnly true → пропустити фікс-пас (детект, нуль мутацій)
  * @returns {number} exit code (0 — чисто; 1 — лишились findings)
  */
-function lintChangedClassified(js, cwd) {
+function lintChangedClassified(js, cwd, readOnly) {
   // Фікс-пас обох інструментів (послідовно; обидва — щоб репорт показав повну картину).
-  runFix(['oxlint', '--fix', ...js], cwd)
-  runFix(['eslint', '--fix', ...js], cwd)
+  // У read-only пропускаємо — лише детект без мутацій (CI / pre-commit).
+  if (!readOnly) {
+    runFix(['oxlint', '--fix', ...js], cwd)
+    runFix(['eslint', '--fix', ...js], cwd)
+  }
 
   // Репорт-пас по ФІНАЛЬНОМУ (пост-фікс) файлу — рядки findings і diff узгоджені.
   const oxRes = runJson(['oxlint', '--format=json', ...js], cwd)
@@ -99,16 +104,18 @@ function lintChangedClassified(js, cwd) {
 }
 
 /**
- * Запускає oxlint+eslint з автофіксом.
- * @param {string[] | undefined} files quick: лише ці файли; undefined: весь проєкт
+ * Запускає oxlint+eslint. За замовчуванням — з автофіксом; `opts.readOnly` — лише детект.
+ * @param {string[] | undefined} files per-file: лише ці файли; undefined: весь проєкт (--full)
  * @param {string} [cwd] корінь репо
+ * @param {{ readOnly?: boolean }} [opts] readOnly → без `--fix` (нуль мутацій)
  * @returns {Promise<number>} 0 — OK, ≠0 — порушення
  */
-export function lint(files, cwd = process.cwd()) {
+export function lint(files, cwd = process.cwd(), opts = {}) {
+  const readOnly = opts.readOnly === true
   if (files === undefined) {
-    return Promise.resolve(lintFullProject(cwd))
+    return Promise.resolve(lintFullProject(cwd, readOnly))
   }
   const js = filterJsFiles(files)
   if (js.length === 0) return Promise.resolve(0)
-  return Promise.resolve(lintChangedClassified(js, cwd))
+  return Promise.resolve(lintChangedClassified(js, cwd, readOnly))
 }

package/rules/js-lint/js-lint.mdc

@@ -75,7 +75,7 @@ version: '1.30'
 
 ## knip
 
-Залежнісний аналіз (knip — невикористані залежності/експорти, `knip.json` канон) крос-файловий, тож винесений у правило `js-lint-ci` (`lint: ci`). Див. `js-lint-ci`.
+Залежнісний аналіз (knip — невикористані залежності/експорти, `knip.json` канон) крос-файловий, тож винесений у правило `js-lint-ci` (`lint: full`). Див. `js-lint-ci`.
 
 ## jscpd: рефакторинг і структура
 

package/rules/js-lint/meta.json

@@ -1 +1 @@
-{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] }, "lint": "quick" }
+{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] }, "lint": "per-file" }

package/rules/js-lint-ci/js-lint-ci.mdc

@@ -10,7 +10,7 @@ version: '1.0'
 `jscpd` і `knip` аналізують увесь граф проєкту, тож мають сенс лише у повному прогоні
 `npx @nitra/cursor lint-ci` (не у швидкому `lint` по змінених файлах). Per-file режиму нема.
 
-Швидкий етап js-lint (oxlint/eslint) — у правилі `js-lint` (`lint: quick`).
+Швидкий етап js-lint (oxlint/eslint) — у правилі `js-lint` (`lint: per-file`).
 
 ## Залежнісна політика (що не додавати)
 

package/rules/js-lint-ci/meta.json

@@ -1 +1 @@
-{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] }, "lint": "ci" }
+{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] }, "lint": "full" }

package/rules/npm-module/js/docs/rule_meta.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/npm-module/js/rule_meta.mjs
-  crc: fa29bd00
+  crc: 8262678c
   score: 100
 ---
 

package/rules/npm-module/js/rule_meta.mjs

@@ -3,7 +3,7 @@ import { existsSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-import { parseRuleAutoSpec, parseRuleLintPhase, readRuleMetaRaw } from '../../../scripts/lib/rule-meta.mjs'
+import { parseRuleAutoSpec, parseRuleLintSpec, readRuleMetaRaw } from '../../../scripts/lib/rule-meta.mjs'
 import { RULE_PREDICATES } from '../../../scripts/lib/rule-predicates.mjs'
 
 /**
@@ -37,8 +37,8 @@ function checkAutoField(id, raw, reporter) {
  */
 function checkLintField(id, ruleDir, raw, reporter) {
   if (raw.lint === undefined) return true
-  if (parseRuleLintPhase(raw.lint) === null) {
-    reporter.fail(`rules/${id}: meta.json.lint нерозпізнане (очікується "quick"|"ci")`)
+  if (parseRuleLintSpec(raw.lint) === null) {
+    reporter.fail(`rules/${id}: meta.json.lint нерозпізнане (очікується "per-file"|"full")`)
     return false
   }
   if (!existsSync(join(ruleDir, 'js', 'lint.mjs'))) {

package/rules/rego/meta.json

@@ -1 +1 @@
-{ "auto": { "glob": "**/*.rego" }, "lint": "ci" }
+{ "auto": { "glob": "**/*.rego" }, "lint": "full" }

package/rules/security/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "lint": "ci" }
+{ "auto": "завжди", "lint": "per-file" }

package/rules/style-lint/js/docs/lint.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/style-lint/js/lint.mjs
-  crc: 94e067b3
+  crc: 2013a66b
   score: 100
 ---
 

package/rules/style-lint/js/lint.mjs

@@ -12,12 +12,13 @@ export function filterStyleFiles(files) {
 }
 
 /**
- * @param {string[] | undefined} files quick: ці файли; undefined: весь проєкт
+ * @param {string[] | undefined} files per-file: ці файли; undefined: весь проєкт (--full)
  * @param {string} [cwd] корінь
+ * @param {{ readOnly?: boolean }} [opts] readOnly → без `--fix` (детект, нуль мутацій)
  * @returns {Promise<number>} exit code
  */
-export function lint(files, cwd = process.cwd()) {
-  const args = ['stylelint', '--fix']
+export function lint(files, cwd = process.cwd(), opts = {}) {
+  const args = opts.readOnly === true ? ['stylelint'] : ['stylelint', '--fix']
   if (files === undefined) {
     args.push('**/*.{css,scss,vue}')
   } else {

package/rules/style-lint/meta.json

@@ -1 +1 @@
-{ "auto": { "glob": ["**/*.css", "**/*.vue"] }, "lint": "quick" }
+{ "auto": { "glob": ["**/*.css", "**/*.vue"] }, "lint": "per-file" }

package/rules/text/js/docs/lint.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/text/js/lint.mjs
-  crc: 4ee054a0
+  crc: 49aab7ce
   score: 100
 ---
 

package/rules/text/js/lint.mjs

@@ -1,12 +1,14 @@
 /**
- * Ci-крок text: делегує у наявний CLI правила (per-file режиму немає — `files` ігнорується).
+ * Крок text: делегує у наявний CLI правила (per-file режиму немає — `files` ігнорується).
  */
 import { runLintTextCli } from '../lint/lint.mjs'
 
 /**
  * @param {string[] | undefined} _files ігнорується (whole-repo аналіз)
+ * @param {string} [_cwd] корінь (ігнорується — CLI працює від process.cwd())
+ * @param {{ readOnly?: boolean }} [opts] readOnly → детект без авто-фіксу (нуль мутацій)
  * @returns {Promise<number>} exit code
  */
-export function lint(_files) {
-  return runLintTextCli()
+export function lint(_files, _cwd, opts = {}) {
+  return runLintTextCli({ readOnly: opts.readOnly === true })
 }

package/rules/text/lint/docs/lint.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/text/lint/lint.mjs
-  crc: 05f3f108
+  crc: bdaef0f8
 ---
 
 # `lint.mjs` — CLI-обгортка `lint-text`

package/rules/text/lint/docs/run-dotenv-linter.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/text/lint/run-dotenv-linter.mjs
-  crc: 8bb94af4
+  crc: 4719ac66
 ---
 
 # run-dotenv-linter.mjs

package/rules/text/lint/docs/run-shellcheck.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/rules/text/lint/run-shellcheck.mjs
-  crc: e6fa8c23
+  crc: 6b2daaa8
 ---
 
 # run-shellcheck.mjs

package/rules/text/lint/lint.mjs

@@ -95,28 +95,30 @@ function preflight(dep) {
 
 /**
  * Внутрішні кроки `lint-text` без локу.
+ * @param {boolean} [readOnly] true → лише детект без авто-фіксу (нуль мутацій — CI/pre-commit)
  * @returns {number} 0 — все OK, інакше — код першого кроку, що впав
  */
-function runLintTextSteps() {
+function runLintTextSteps(readOnly = false) {
   // Auto-install: throws on failure → propagates as exit 1 from runStandardLint
   ensureTool('shellcheck')
   ensureTool('dotenv-linter')
 
-  // patch is hint-only (system tool)
-  if (!preflight(PATCH_PREFLIGHT)) return 1
+  // patch потрібен лише для авто-фіксу shellcheck; у read-only пропускаємо preflight.
+  if (!readOnly && !preflight(PATCH_PREFLIGHT)) return 1
 
   const cspellCode = runLintStep('cspell', 'npx', ['cspell', '.'])
   if (cspellCode !== 0) return cspellCode
 
-  console.log('\n▶ shellcheck (авто-фікс + фінальна перевірка *.sh)')
-  const shellcheckCode = runShellcheckText()
+  console.log(`\n▶ shellcheck (${readOnly ? 'перевірка' : 'авто-фікс + фінальна перевірка'} *.sh)`)
+  const shellcheckCode = runShellcheckText(process.cwd(), readOnly)
   if (shellcheckCode !== 0) return shellcheckCode
 
-  console.log('\n▶ dotenv-linter (авто-фікс + фінальна перевірка .env*)')
-  const dotenvCode = runDotenvLinter()
+  console.log(`\n▶ dotenv-linter (${readOnly ? 'перевірка' : 'авто-фікс + фінальна перевірка'} .env*)`)
+  const dotenvCode = runDotenvLinter(process.cwd(), readOnly)
   if (dotenvCode !== 0) return dotenvCode
 
-  const markdownlintCode = runLintStep('markdownlint', 'bunx', ['markdownlint-cli2', '--fix', '**/*.md', '**/*.mdc'])
+  const mdArgs = readOnly ? ['markdownlint-cli2', '**/*.md', '**/*.mdc'] : ['markdownlint-cli2', '--fix', '**/*.md', '**/*.mdc']
+  const markdownlintCode = runLintStep('markdownlint', 'bunx', mdArgs)
   if (markdownlintCode !== 0) return markdownlintCode
 
   console.log('\n▶ v8r (schema-валідація json/json5/yaml/yml/toml)')
@@ -125,6 +127,8 @@ function runLintTextSteps() {
 
 /**
  * Публічна CLI-форма: серіалізує через `withLock('lint-text')` + дедуп за станом git-дерева.
+ * @param {{ readOnly?: boolean }} [opts] readOnly → детект без авто-фіксу
  * @returns {Promise<number>} код виходу
  */
-export const runLintTextCli = () => runStandardLint(import.meta.dirname, () => runLintTextSteps())
+export const runLintTextCli = (opts = {}) =>
+  runStandardLint(import.meta.dirname, () => runLintTextSteps(opts.readOnly === true))

package/rules/text/lint/run-dotenv-linter.mjs

@@ -52,9 +52,10 @@ function buildExcludeArgs() {
 /**
  * Запускає dotenv-linter з авто-фіксом і фінальною перевіркою.
  * @param {string} [cwd] робочий каталог (за замовчуванням `process.cwd()`)
+ * @param {boolean} [readOnly] true → пропустити авто-фікс (`fix`), лише `check` (нуль мутацій)
  * @returns {number} 0 — OK; 1 — інструмент відсутній або є залишкові порушення
  */
-export function runDotenvLinter(cwd = process.cwd()) {
+export function runDotenvLinter(cwd = process.cwd(), readOnly = false) {
   const root = resolve(cwd)
   const bin = resolveCmd('dotenv-linter')
   if (!bin) {
@@ -63,15 +64,17 @@ export function runDotenvLinter(cwd = process.cwd()) {
   }
 
   const exclude = buildExcludeArgs()
-  const fixRun = spawnSync(bin, ['fix', '-r', '--no-backup', '--quiet', ...exclude, '.'], {
-    cwd: root,
-    encoding: 'utf8',
-    env: process.env,
-    stdio: ['ignore', 'pipe', 'pipe']
-  })
-  if (fixRun.error) {
-    process.stderr.write(`${fixRun.error.message}\n`)
-    return 1
+  if (!readOnly) {
+    const fixRun = spawnSync(bin, ['fix', '-r', '--no-backup', '--quiet', ...exclude, '.'], {
+      cwd: root,
+      encoding: 'utf8',
+      env: process.env,
+      stdio: ['ignore', 'pipe', 'pipe']
+    })
+    if (fixRun.error) {
+      process.stderr.write(`${fixRun.error.message}\n`)
+      return 1
+    }
   }
 
   const checkRun = spawnSync(bin, ['check', '-r', '--quiet', ...exclude, '.'], {

package/rules/text/lint/run-shellcheck.mjs

@@ -96,17 +96,19 @@ export function listShellScriptPaths(cwd) {
 /**
  * Запускає shellcheck із авто-виправленнями і фінальною перевіркою.
  * @param {string} [cwd] робочий каталог (за замовчуванням `process.cwd()`)
+ * @param {boolean} [readOnly] true → пропустити авто-фікс (diff+patch), лише фінальна перевірка
  * @returns {number} 0 — OK; 1 — помилка середовища або залишкові зауваження shellcheck
  */
-export function runShellcheckText(cwd = process.cwd()) {
+export function runShellcheckText(cwd = process.cwd(), readOnly = false) {
   const root = resolve(cwd)
   const shellcheck = resolveCmd('shellcheck')
   if (!shellcheck) {
     printShellcheckInstallHints()
     return 1
   }
-  const patchBin = resolveCmd('patch')
-  if (!patchBin) {
+  // patch потрібен лише для авто-фіксу (diff+patch); у read-only його відсутність не блокує детект.
+  const patchBin = readOnly ? null : resolveCmd('patch')
+  if (!readOnly && !patchBin) {
     printPatchInstallHints()
     return 1
   }
@@ -116,9 +118,11 @@ export function runShellcheckText(cwd = process.cwd()) {
     return 0
   }
 
-  for (const rel of files) {
-    const fixCode = autofixOneFile(shellcheck, patchBin, root, rel)
-    if (fixCode !== 0) return fixCode
+  if (!readOnly) {
+    for (const rel of files) {
+      const fixCode = autofixOneFile(shellcheck, /** @type {string} */ (patchBin), root, rel)
+      if (fixCode !== 0) return fixCode
+    }
   }
 
   return runFinalShellcheck(shellcheck, files, root)

package/rules/text/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "lint": "ci" }
+{ "auto": "завжди", "lint": "per-file" }

package/scripts/docs/lint-cli.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/scripts/lint-cli.mjs
-  crc: d4a7562d
+  crc: 9e0a12b9
   score: 100
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/scripts/lib/rule-meta.mjs
-  crc: 4475d5ff
+  crc: fa5ca866
 ---
 
 # rule-meta.mjs

package/scripts/lib/rule-meta.mjs

@@ -48,16 +48,20 @@ export function parseRuleAutoSpec(value) {
   return null
 }
 
-/** Допустимі фази lint. */
-const LINT_PHASES = new Set(['quick', 'ci'])
+/** Допустимі значення `meta.json.lint` (вісь scope: чи детектор дробиться на changed-set). */
+const LINT_SCOPES = new Set(['per-file', 'full'])
 
 /**
- * Нормалізує значення `meta.json.lint` у фазу lint.
+ * Нормалізує значення `meta.json.lint` у scope детектора.
+ *  - `"per-file"` — детектор декомпозується на змінені файли (дельта vs origin);
+ *  - `"full"`     — нероздільно крос-файловий (лише `--full` / CI).
+ * Об'єктна форма `{scope, ci}` скасована: CI=`--read-only --full` ганяє все повністю,
+ * тож per-rule CI-override не потрібен (spec 2026-06-14-lint-rule-consolidation §3-А).
  * @param {unknown} value значення поля `lint`
- * @returns {'quick' | 'ci' | null} фаза або `null` (відсутнє/невалідне = не lint-крок)
+ * @returns {'per-file' | 'full' | null} scope або `null` (відсутнє/невалідне = не lint-крок)
  */
-export function parseRuleLintPhase(value) {
-  return typeof value === 'string' && LINT_PHASES.has(value) ? /** @type {'quick'|'ci'} */ (value) : null
+export function parseRuleLintSpec(value) {
+  return typeof value === 'string' && LINT_SCOPES.has(value) ? /** @type {'per-file'|'full'} */ (value) : null
 }
 
 /**

package/scripts/lint-cli.mjs

@@ -1,34 +1,74 @@
 /**
- * Оркестратор `n-cursor lint` (quick) / `n-cursor lint-ci` (full).
+ * Оркестратор `n-cursor lint` — дві ортогональні осі (spec 2026-06-14-lint-rule-consolidation
+ * + компаньйон 2026-06-14-lint-orchestrator-fix-readonly-unification):
+ *  - **scope** (`--full`): default = дельта vs origin (лише `per-file` правила);
+ *    `--full` = весь репо (`per-file` ∪ `full` правила);
+ *  - **behavior** (`--read-only`): default = fix; `--read-only` = лише детект без мутацій.
  *
- * Data-driven: сканує `rules/<id>/meta.json` за полем `lint` (`quick`|`ci`),
- * послідовно (заборона паралельного eslint) викликає `rules/<id>/js/lint.mjs`:
- *  - quick: `lint(changedFiles)` — лише змінені файли (git diff HEAD + untracked);
- *  - ci:    `lint(undefined)` — весь проєкт.
- * Порядок правил — алфавітний; ci-набір = quick ∪ ci. Fail-fast: перший ненульовий код спиняє.
+ * Data-driven: сканує `rules/<id>/meta.json` за полем `lint` (`per-file`|`full`),
+ * викликає `rules/<id>/js/lint.mjs` → `lint(files, cwd, { readOnly })`:
+ *  - default scope: `files` = змінені відносно origin (`collectChangedFilesSince`);
+ *  - `--full`:      `files = undefined` — весь проєкт.
+ * Порядок правил — алфавітний. Fail-fast: перший ненульовий код спиняє.
  */
 import { existsSync, readdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
 import { cwd as processCwd } from 'node:process'
 
-import { parseRuleLintPhase, readRuleMetaRaw } from './lib/rule-meta.mjs'
-import { collectChangedFiles } from './lib/changed-files.mjs'
+import { parseRuleLintSpec, readRuleMetaRaw } from './lib/rule-meta.mjs'
+import { collectChangedFilesSince, resolveChangedBase } from './lib/changed-files.mjs'
 
 const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 const RULES_DIR = join(PACKAGE_ROOT, 'rules')
+const N_CURSOR_BIN = join(PACKAGE_ROOT, 'bin', 'n-cursor.js')
 
 /**
- * Вибирає id правил для фази, алфавітно.
+ * Конформність-фаза lint (whole-repo: config/file/workflow conformance — те, що раніше робив `fix`).
+ * Per-file декомпозиції немає, тож виконується лише у `--full`.
+ *  - read-only: детект через `_fix-check` (per-rule `fix.mjs run()` = перевірка, без мутацій);
+ *  - fix: convergence-движок (check → Tier0 → omlx) через orchestrator.
+ * @param {string} cwd корінь
+ * @param {boolean} readOnly true → лише детект (нуль мутацій)
+ * @param {(s: string) => void} log логер
+ * @param {string[]} [filter] фільтр правил (порожній — усі)
+ * @returns {Promise<number>} 0 — чисто, 1 — порушення/помилка
+ */
+async function runConformance(cwd, readOnly, log, filter = []) {
+  if (!readOnly) {
+    const { runOrchestratorCli } = await import('./lib/fix/orchestrator.mjs')
+    return runOrchestratorCli(filter, cwd)
+  }
+  const r = spawnSync('bun', [N_CURSOR_BIN, '_fix-check', ...filter], { cwd, encoding: 'utf8', timeout: 600_000 })
+  let parsed = null
+  try {
+    parsed = JSON.parse((r.stdout ?? '').trim())
+  } catch {
+    parsed = null
+  }
+  if (!parsed) {
+    log('❌ lint: конформність — помилка перевірки (_fix-check не повернув JSON)\n')
+    return 1
+  }
+  const failed = parsed.rules.filter(/** @param {{ok:boolean}} x */ x => !x.ok)
+  if (failed.length === 0) return 0
+  log(`❌ lint: конформність — ${failed.length} порушень: ${failed.map(/** @param {{ruleId:string}} x */ x => x.ruleId).join(', ')}\n`)
+  for (const f of failed) if (f.output) log(`${f.output}\n`)
+  return 1
+}
+
+/**
+ * Вибирає id правил для контексту, алфавітно.
  * @param {Record<string, {lint?: unknown}>} metaById мапа id → meta-обʼєкт
- * @param {'quick'|'ci'} phase цільова фаза (quick → лише quick; ci → quick+ci)
+ * @param {boolean} full `false` → лише `per-file` правила; `true` → усі (`per-file` ∪ `full`)
  * @returns {string[]} відсортовані id
  */
-export function selectLintRules(metaById, phase) {
+export function selectLintRules(metaById, full) {
   const out = []
   for (const [id, raw] of Object.entries(metaById)) {
-    const p = parseRuleLintPhase(raw?.lint)
-    if (p === 'quick' || (phase === 'ci' && p === 'ci')) out.push(id)
+    const scope = parseRuleLintSpec(raw?.lint)
+    if (scope === 'per-file' || (full && scope === 'full')) out.push(id)
   }
   return out.toSorted((a, b) => a.localeCompare(b))
 }
@@ -52,22 +92,33 @@ function readAllMeta(rulesDir) {
 
 /**
  * Запускає lint-оркестрацію.
- * @param {{ ci?: boolean, cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ *   - `full` — весь репо (`true`) проти дельти vs origin (`false`, default);
+ *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default);
+ *   - `rules` — непорожній фільтр → лише конформність цих правил (без лінтер-скану; мапить `fix <rule>`).
  * @returns {Promise<number>} exit code
  */
 export async function runLint(opts = {}) {
-  const ci = opts.ci === true
+  const full = opts.full === true
+  const readOnly = opts.readOnly === true
+  const rules = Array.isArray(opts.rules) ? opts.rules : []
   const cwd = opts.cwd ?? processCwd()
   const rulesDir = opts.rulesDir ?? RULES_DIR
   const log = opts.log ?? (s => process.stdout.write(s))
 
-  const changed = ci ? undefined : collectChangedFiles(cwd)
-  if (!ci && changed.length === 0) {
-    log('\nℹ️  lint: немає змінених файлів — нічого перевіряти.\n')
+  // Rule-filter режим (напр. `lint changelog` із hk): лише конформність указаних правил, без лінтерів.
+  if (rules.length > 0) {
+    return runConformance(cwd, readOnly, log, rules)
+  }
+
+  // Default scope — дельта vs origin (merge-base main/origin/main); `--full` — весь репо.
+  const changed = full ? undefined : collectChangedFilesSince(resolveChangedBase(cwd), cwd)
+  if (!full && changed.length === 0) {
+    log('\nℹ️  lint: немає змінених файлів відносно origin — нічого перевіряти.\n')
     return 0
   }
 
-  const ids = selectLintRules(readAllMeta(rulesDir), ci ? 'ci' : 'quick')
+  const ids = selectLintRules(readAllMeta(rulesDir), full)
   for (const id of ids) {
     const lintPath = join(rulesDir, id, 'js', 'lint.mjs')
     if (!existsSync(lintPath)) {
@@ -75,8 +126,15 @@ export async function runLint(opts = {}) {
       continue
     }
     const mod = await import(lintPath)
-    const code = await mod.lint(changed, cwd)
+    const code = await mod.lint(changed, cwd, { readOnly })
     if (code !== 0) return code
   }
+
+  // Конформність-фаза (поглинула `fix`): whole-repo, лише у `--full`. Кастомний rulesDir
+  // (юніт-тести селектора) — реальний пакет недоступний, тож пропускаємо.
+  if (full && opts.rulesDir === undefined) {
+    const conformanceCode = await runConformance(cwd, readOnly, log)
+    if (conformanceCode !== 0) return conformanceCode
+  }
   return 0
 }

package/scripts/post-tool-use-fix.mjs

@@ -1,65 +1,19 @@
 /**
- * PostToolUse hook для Claude Code: точкова маршрутизація `npx \@nitra/cursor fix`
- * за типом зміненого файла. Запускається після кожного `Edit` / `Write` / `MultiEdit`;
- * замінює дорогий синхронний `Stop`-хук, що ганяв повний `fix` усіх правил на кожному
- * turn-і.
+ * PostToolUse hook для Claude Code: read-only детект конформності **всіх** активованих правил
+ * після редагування файлу. Запускається після кожного `Edit` / `Write` / `MultiEdit`.
  *
- * Контракт:
- * - stdin Claude Code: JSON із `tool_input.file_path` (відносний шлях зміненого файла);
- * - exit 0, якщо файл не має маршрут (PostToolUse не блокує turn у будь-якому випадку,
- *   але ми лишаємо exit-код прозорим — для діагностики);
- * - інакше spawn `npx --no \@nitra/cursor fix <rules…>` із передаванням exit-коду.
+ * Раніше хук маршрутизував змінений файл у релевантні правила й ганяв повний `fix` (автофікс
+ * + LLM) — дорого, тож звужували. Тепер хук — **детект** (нуль мутацій, нуль LLM), тож роутинг
+ * зайвий: один виклик `_fix-check` (per-rule `fix.mjs run()` = перевірка) по всіх правилах.
  *
- * Маршрути впорядковані від найбільш специфічного до загального; перший збіг — переможець.
- * `docs/adr/**\/*.md` свідомо повертає `[]`: ADR-нормалізація вже покривається async
- * Stop-hook'ом `normalize-decisions.sh` — повторний `fix adr` тут лише сповільнював би turn.
+ * Контракт:
+ * - stdin Claude Code: JSON із `tool_input.file_path`; якщо файлу немає (напр. Bash) — exit 0 (skip);
+ * - інакше spawn `_fix-check` (детект усіх правил), exit-код прозоро пробрасуємо (PostToolUse
+ *   не блокує turn, але код лишаємо інформативним: 1 — є порушення конформності).
  */
 import { spawn } from 'node:child_process'
 import { once } from 'node:events'
 
-import picomatch from 'picomatch'
-
-/**
- * @typedef {object} Route
- * @property {string} pattern picomatch glob (з підтримкою `**` і `{a,b}`)
- * @property {string[]} rules ID правил `npm/rules/<id>` (бо `fix.mjs` обов'язковий)
- */
-
-/** Порядок важливий: специфічні маршрути (`.github/workflows/*`, `**\/k8s/**`) — перед загальними. */
-/** @type {readonly Route[]} */
-const ROUTES = Object.freeze([
-  { pattern: 'docs/adr/**/*.md', rules: [] },
-  { pattern: '.github/workflows/*.{yml,yaml}', rules: ['ga'] },
-  { pattern: '**/k8s/**/*.{yaml,yml}', rules: ['k8s'] },
-  { pattern: '**/*.vue', rules: ['js-lint', 'style-lint', 'vue'] },
-  { pattern: '**/*.{mjs,js,cjs,ts,tsx,jsx}', rules: ['js-lint'] },
-  { pattern: '**/*.{css,scss,sass}', rules: ['style-lint'] },
-  { pattern: '**/*.rego', rules: ['rego'] },
-  { pattern: '{**/,}Dockerfile', rules: ['docker'] },
-  { pattern: '**/*.Dockerfile', rules: ['docker'] },
-  { pattern: '**/*.sh', rules: ['security'] },
-  { pattern: '{**/,}package.json', rules: ['npm-module', 'bun'] },
-  { pattern: '**/*.md', rules: ['text'] }
-])
-
-/**
- * Повертає список правил, які слід прогнати для зміненого `filePath`.
- * Перший збіг із `ROUTES` — переможець; невідомі шляхи / некоректні входи → `[]`.
- * @param {unknown} filePath відносний шлях зміненого файла зі stdin Claude Code
- * @returns {string[]} ID правил для `npx \@nitra/cursor fix`
- */
-export function routeFilePathToRules(filePath) {
-  if (typeof filePath !== 'string' || filePath === '') {
-    return []
-  }
-  for (const { pattern, rules } of ROUTES) {
-    if (picomatch.isMatch(filePath, pattern, { dot: true })) {
-      return [...rules]
-    }
-  }
-  return []
-}
-
 /**
  * Зчитує stdin до EOF як utf8 рядок. На TTY — повертає `''` одразу.
  * @returns {Promise<string>} вміст stdin
@@ -87,7 +41,7 @@ async function readStdin() {
  * @param {string} stdinJson сирий вміст stdin
  * @returns {string | null} відносний шлях або `null`
  */
-function extractFilePath(stdinJson) {
+export function extractFilePath(stdinJson) {
   if (!stdinJson) {
     return null
   }
@@ -103,27 +57,25 @@ function extractFilePath(stdinJson) {
 /**
  * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-fix`.
  * Параметри доступні для інʼєкції для тестів: `stdinJson` обходить read від `process.stdin`,
- * `spawnFn` — заміна `node:child_process.spawn` (повертає EventEmitter-сумісний об'єкт).
- * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів (ін'єкція stdin/spawn)
- * @returns {Promise<number>} exit code (0 — пропущено / fix ОК; інше — exit-код `fix`)
+ * `spawnFn` — заміна `node:child_process.spawn`.
+ * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів
+ * @returns {Promise<number>} exit code (0 — пропущено / конформність ОК; інше — є порушення)
  */
 export async function runPostToolUseFixCli(options = {}) {
   const stdinJson = options.stdinJson ?? (await readStdin())
   const filePath = extractFilePath(stdinJson)
+  // Тільки після редагування файлу (Edit/Write/MultiEdit мають file_path); Bash тощо — skip.
   if (filePath === null) {
     return 0
   }
-  const rules = routeFilePathToRules(filePath)
-  if (rules.length === 0) {
-    return 0
-  }
   const spawnFn = options.spawnFn ?? spawn
-  const child = spawnFn('npx', ['--no', '@nitra/cursor', 'fix', ...rules], { stdio: 'inherit' })
+  // Один read-only виклик: детект конформності всіх активованих правил, без роутингу.
+  const child = spawnFn('npx', ['--no', '@nitra/cursor', '_fix-check'], { stdio: 'inherit' })
   try {
     const [code] = await once(child, 'exit')
     return code ?? 1
   } catch (error) {
-    process.stderr.write(`post-tool-use-fix: не вдалося запустити npx @nitra/cursor fix — ${error.message}\n`)
+    process.stderr.write(`post-tool-use-fix: не вдалося запустити детект конформності — ${error.message}\n`)
     return 1
   }
 }

package/skills/fix/SKILL.md

@@ -1,23 +1,22 @@
 ---
 name: n-fix
 description: >-
-  Виправити проєкт відповідно до всіх правил в .cursor/rules/
+  DEPRECATED — використовуй /n-lint. fix злито в lint: `n-cursor lint` тепер і
+  детектить, і виправляє (конформність + лінтери) за один прохід.
 ---
 
-# n-fix — автоматичне виправлення проєкту
+# n-fix — DEPRECATED (делегат на /n-lint)
 
-## Scope
+Команду `n-cursor fix` **видалено**: рух-движок конформності (convergence-loop /
+check-gate / Tier0 / LLM) поглинуто в `lint` (спека
+`docs/specs/2026-06-14-lint-orchestrator-fix-readonly-unification-design.md`).
 
-Цей скіл відповідає **лише за структуру** проєкту: щоб `.cursor/rules/` + `npx @nitra/cursor fix` були задоволені (наявність конфігів, залежностей, скриптів, GitHub workflows, відсутність заборонених файлів). **Лінт-порушення у самому коді** (ESLint, oxlint, jscpd, cspell, knip, sonarjs, stylelint тощо) — **поза скоупом**; їх діагностує й виправляє **`/n-lint`** (`bun run lint`).
+**Використовуй `/n-lint`** замість цього скіла:
 
-## Workflow
+- `n-cursor lint` — дельта vs origin, **fix за замовчуванням** (лінтери на змінених файлах);
+- `n-cursor lint --full` — весь репо + **конформність** (колишній `fix`: конфіги/файли/воркфлоу
+  через convergence-движок);
+- `n-cursor lint --read-only [--full]` — лише детект, нуль мутацій (CI / pre-commit);
+- `n-cursor lint <rule>` — конформність одного правила (колишній `fix <rule>`).
 
-```bash
-n_cursor_npx fix
-```
-
-Exit 0 = чисто, 1 = є unresolved (перевір вивід — буде список правил що не закрились після 3 ітерацій).
-
-Якщо змінились залежності — `bun i`. Якщо змінились JS/TS файли — `oxfmt .`.
-
-Для конкретних правил: `n_cursor_npx fix bun ga`.
+Цей скіл лишено як тонкий делегат до наступного major; уся логіка — у `/n-lint`.

package/skills/lint/SKILL.md

@@ -91,18 +91,17 @@ bun run lint
 - Якщо тестів **немає** або вони **не покривають** блок, який змінюєш — **спочатку** додай/розшир тести, переконайся, що вони стабільно проходять, **потім** роби рефакторинг, **потім** знову прогони тести й **`bun run lint`**, щоб підтвердити, що функціональність коректна й лінт чистий.
 - Якщо після рефакторингу тести або лінт падають — **не** залишай «половинчастий» рефакторинг: відкотись або доведи зміни до зеленого стану.
 
-## Навантаження на macOS (багато процесів `eslint` / лаги)
+## Паралелізм і навантаження на macOS
 
-Часто це **не** «один ESLint розпаралелив себе всередині», а **кілька паралельних запусків** одного й того ж ланцюжка (**`bun run lint`**, **`bun run lint-js`**) у різних Bash-задачах агента (кілька shells). Кожен запуск = окремий процес **`eslint`** плюс **`oxlint`**, **`jscpd`** тощо — диск і CPU перегружаються.
+**Паралельно по різних файлах — дозволено.** Диз'юнктні набори (per-file `n-cursor lint` на змінених vs origin) не конфліктують: кожен процес обробляє свій підмножину файлів, тож гонки за тим самим корпусом немає.
 
-**Чому взагалі кілька `eslint`:** оркестратор (Claude Code, Cursor тощо) може **розпаралелити** роботу: кілька **субагентів** / **паралельних Bash-задач** / **фонових shell**, і кожен **сам** виконує **`/n-lint`** або запускає **`eslint`**. Тоді навантаження **множиться**: не один прогон лінту, а **N прогонів** одночасно.
+Проблема — не паралелізм як такий, а **кілька одночасних whole-tree прогонів того самого корпусу** (**`bun run lint`**, **`n-cursor lint --full`**) у різних Bash-задачах/shells: кожен повторно сканує **весь** репо (eslint + oxlint + jscpd + knip), і диск/CPU перевантажуються дублюванням важкого full-scan.
 
-### Що робити агенту під час виконання цього скілу (обов’язково)
+### Що робити агенту під час виконання цього скілу
 
-1. **Один** запуск **`bun run lint`** (або всі кроки **`lint`**, як у **`package.json`**) — у **одному** foreground shell, **без** `run_in_background` / фонових копій тієї ж команди.
-2. **Не** викликати **паралельні субагенти** (subagent, Task, «розбий на N паралельних завдань») лише заради лінту в одному репозиторії. Лінт не потребує шардінгу: один процес, послідовно.
-3. Якщо ти **батьок-сесія** й уже делегував дочірнім задачам **інші** кроки — **не** доручай дочірнім і **`bun run lint`**, залиш **лише** собі один **послідовний** прогон **після** змін у файлах, або **один** виклик цілого скілу на сесію.
-4. Якщо сесія/користувач уже запускає лінт — **не** дублювати; зачекати завершення або **не** стартувати лінт повторно в іншому shell.
+1. **Whole-tree** прогін (**`bun run lint`** / **`lint --full`**) — **один** за раз, у одному foreground shell; **не** запускати другий full-прогін того самого корпусу паралельно.
+2. **Per-file** лінт по диз'юнктних файлах (різні субагенти на різні файли) — **дозволено** й не потребує серіалізації.
+3. Якщо сесія/користувач уже запускає **whole-tree** лінт — не дублювати його; зачекати завершення.
 
 **Що можна змінити у проєкті (локально або в `package.json`)**