@nitra/cursor 5.4.0 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [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

@@ -1686,12 +1686,14 @@ try {
       break
     }
     case 'lint': {
-      process.exitCode = await runLint({ ci: false })
+      // Дві ортогональні осі: --full (scope: весь репо vs дельта vs origin) × --read-only (behavior).
+      process.exitCode = await runLint({ full: args.includes('--full'), readOnly: args.includes('--read-only') })
 
       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
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "5.4.0",
+  "version": "6.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,38 @@
 /**
- * Оркестратор `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 { 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')
 
 /**
- * Вибирає id правил для фази, алфавітно.
+ * Вибирає 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 +56,26 @@ function readAllMeta(rulesDir) {
 
 /**
  * Запускає lint-оркестрацію.
- * @param {{ ci?: boolean, cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ * @param {{ full?: boolean, readOnly?: boolean, cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ *   - `full` — весь репо (`true`) проти дельти vs origin (`false`, default);
+ *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default).
  * @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 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')
+  // 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,7 +83,7 @@ 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
   }
   return 0