@7n/rules 1.90.1 → 1.91.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [1.91.0] - 2026-08-11
+
+### Changed
+
+- Native-контур фіксу доведений на багатофайловому порушенні живою локальною
+моделлю. Зміни, кожна з яких — наслідок конкретного прогону, а не здогаду:
+
+- **Схема інструмента `edit` сплощена** до одного фрагмента за виклик
+  (`path`/`old_text`/`new_text`) замість масиву обʼєктів. Діагностика сирого
+  tool-call-у показала, що 26B-модель плутає вкладеність і закриває `]`
+  замість `}` — виклик виходив структурно невалідний. Після сплощення той
+  самий прогін закрився з першого рунга й без жодного провалу парсера.
+- **`verify_max` за паритетом із `run-fix.mjs`**: локальній моделі одна
+  спроба виправитись, хмарній дві (було 2 для всіх).
+- **`max_tokens` винесений у запит** (`N_LLM_FIX_MAX_TOKENS`) замість
+  константи: значення, що рятує слабку модель від розгону, обрізає
+  багатофайловий фікс на моделі з великим контекстом.
+- **Стеля ходів керується `N_LLM_FIX_TURN_CEILING`**.
+- **Звіт показує вартість кожної спроби** — скільки ходів і викликів
+  інструментів. Без цього тюнінг стелі був би ворожінням: саме ці числа
+  показали, що падає не бюджет, а генерація.
+- Схема `self_check` більше не порожній обʼєкт — одне необовʼязкове поле
+  замість `{"properties": {}}` як захист від strict-провайдерів.
+
+## [1.90.2] - 2026-08-11
+
+### Fixed
+
+- fix(lint): per-file glob doc-files виводиться з doc-files.extensions contributions — зміна .rs запускає концерн у delta-режимі й PostToolUse hook (новий опційний lint.extensionsSlot у concern.json; статичний glob — fallback, доповнений rs)
+
 ## [1.90.1] - 2026-08-10
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.90.1",
+  "version": "1.91.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",
@@ -66,7 +66,7 @@
     "rename-yaml-extensions": "bun ./bin/n-rules.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@7n/llm-lib": "3.2.2",
+    "@7n/llm-lib": "3.3.0",
     "ajv": "^8.20.0",
     "cli-progress": "^3.12.0",
     "github-actionlint": "^1.7.12",
@@ -83,9 +83,9 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
-    "@7n/rules-darwin-arm64": "1.90.1",
-    "@7n/rules-linux-x64": "1.90.1",
-    "@7n/rules-win32-x64": "1.90.1",
+    "@7n/rules-darwin-arm64": "1.91.0",
+    "@7n/rules-linux-x64": "1.91.0",
+    "@7n/rules-win32-x64": "1.91.0",
     "@earendil-works/pi-ai": "0.80.10",
     "@earendil-works/pi-coding-agent": "0.80.10"
   },

package/rules/doc-files/check/concern.json

@@ -2,6 +2,7 @@
   "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
   "lint": {
     "scope": "per-file",
-    "glob": ["**/*.{js,mjs,ts,vue,py}"]
+    "glob": ["**/*.{js,mjs,ts,vue,py,rs}"],
+    "extensionsSlot": "doc-files.extensions"
   }
 }

package/schemas/concern.json

@@ -165,6 +165,11 @@
             }
           ],
           "description": "per-file: фільтр delta-файлів; full: delta-тригер."
+        },
+        "extensionsSlot": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Ім'я slot-а з extension-map contributions (value: мапа '.ext' → мітка, напр. doc-files.extensions). Ефективний glob концерну виводиться з розширень усіх активних contributions цього slot-а (`**/*.{…}`), тож lang-плагіни розширюють delta-тригер без правки concern.json. Статичний `glob` лишається fallback-ом, коли жодний активний плагін не декларує розширень (плагіни не встановлені)."
         }
       }
     },

package/scripts/lib/concern-meta.mjs

@@ -10,6 +10,9 @@ import { join } from 'node:path'
  * @typedef {object} LintSurface
  * @property {'per-file'|'full'} scope область лінту: per-file чи повний прогін.
  * @property {string[]} glob масив glob-ів (нормалізований з string|string[]); порожній якщо не задано
+ * @property {string|undefined} extensionsSlot slot із extension-map contributions (напр.
+ *   `doc-files.extensions`) — ефективний glob виводиться з розширень активних плагінів
+ *   (резолвиться у run-detectors, де відомий cwd); статичний `glob` — fallback без contributions
  */
 
 /**
@@ -68,7 +71,8 @@ function parseLintSurface(rawLint) {
   } else if (typeof rawGlob === 'string') {
     glob = [rawGlob]
   }
-  return { scope, glob }
+  const extensionsSlot = typeof rawLint.extensionsSlot === 'string' ? rawLint.extensionsSlot : undefined
+  return { scope, glob, extensionsSlot }
 }
 
 /**

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

@@ -3,16 +3,23 @@ type: JS Module
 title: concern-meta.mjs
 resource: npm/scripts/lib/concern-meta.mjs
 docgen:
-  crc: d452f9b7
-  model: omlx/gemma-4-e2b-it-4bit
+  crc: 877433c9
+  model: omlx/gemma-4-26b-a4b-it
   tier: local-min
-  score: 80
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
 Парсер і нормалізатор `concern.json`. Єдине місце де читається і валідується схема concern-а.
 
+## Поведінка
+
+`readConcernMeta` повертає нормалізовані дані з `concern.json` або `null`, якщо файл відсутній, не є об'єктом або не відповідає мінімальним вимогам до структури (наприклад, через невалідний scope лінту). Якщо конфіг не містить жодної активної поверхні (lint, policy або check), він вважається невалідним.
+
+`listConcerns` повертає відсортований за алфавітом масив об'єктів, що відповідають вимогам `concern.json`. Підкаталоги, які не містять валідного конфігу, ігноруються та не потрапляють у результат.
+
 ## Публічний API
 
 - readConcernMeta — Читає і нормалізує `concern.json` з каталогу.
@@ -22,7 +29,7 @@ docgen:
 
 ## Сценарії використання
 
-- `npm/scripts/lib/tests/concern-meta.test.mjs` (concern-meta — policy.engine derivation; concern-meta — lint surface) — явний engine:; legacy check:; legacy без engine/check (Rego) → engine:; lint scope/glob нормалізується (string → array); skipLocalTier: true нормалізується, дефолт — false; ще 2
+- `npm/scripts/lib/tests/concern-meta.test.mjs` (concern-meta — policy.engine derivation; concern-meta — lint surface) — явний engine:; legacy check:; legacy без engine/check (Rego) → engine:; lint scope/glob нормалізується (string → array); extensionsSlot проходить у LintSurface; не-string ігнорується; ще 3
 
 ## Гарантії поведінки
 

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

@@ -3,10 +3,11 @@ type: JS Module
 title: run-detectors.mjs
 resource: npm/scripts/lib/lint-surface/run-detectors.mjs
 docgen:
-  crc: 838c79de
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  crc: a057f918
+  model: omlx/gemma-4-26b-a4b-it
   tier: local-min
-  score: 95
+  score: 70
+  judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
@@ -17,14 +18,6 @@ Discovery → scope-selection → `lint(ctx)` per concern → нормалізо
 Без мутацій, без LLM. Fix-pipeline (T0 + ladder) обгортає цей модуль і споживає
 його violations; сам detect ніколи не пише в дерево.
 
-## Поведінка
-
-DEFAULT_RULES_DIR надає вбудований корінь для пошуку правил у випадках, коли користувач не вказує явний каталог.
-buildDetectPlan створює впорядкований план прогону, що є спільним джерелом для як detection-only, так і fix-pipeline.
-loadEnabledLintRules повертає зібрані концерни та набір активних правил, що є вихідними даними для споживачів поза detection/fix-конвеєром.
-computeActiveDomains визначає, які домени стають активними для заданого файлового набору, де домен вважається активним, якщо хоча б один його per-file concern тригериться на цих файлах.
-detectAll запускає detection-only прохід і повертає всі зібрані порушення, код виходу та список виконаних елементів плану.
-
 ## Публічний API
 
 - DEFAULT_RULES_DIR — Цей файл: npm/scripts/lib/lint-surface/run-detectors.mjs → PACKAGE_ROOT = npm (4 dirname угору).
@@ -44,7 +37,7 @@ concern тригериться на цих файлах (та сама табл
 
 ## Сценарії використання
 
-- `npm/scripts/lib/lint-surface/tests/run-detectors.test.mjs` (detectAll — exit codes; detectAll — scoping) — clean → exit 0; violations → exit 1, ruleId/concernId домішані з ctx; detector кидає → exit 2; невалідний violation (без reason) → exit 2; absolute file-path відхиляється → exit 2; ще 16
+- `npm/scripts/lib/lint-surface/tests/run-detectors.test.mjs` (detectAll — exit codes; detectAll — scoping) — clean → exit 0; violations → exit 1, ruleId/concernId домішані з ctx; detector кидає → exit 2; невалідний violation (без reason) → exit 2; absolute file-path відхиляється → exit 2; ще 19
 
 ## Гарантії поведінки
 

package/scripts/lib/lint-surface/run-detectors.mjs

@@ -17,7 +17,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 import { listConcerns } from '../concern-meta.mjs'
 import { collectChangedFilesSince, resolveChangedBase } from '../changed-files.mjs'
 import { loadNative } from '../native.mjs'
-import { getActiveCapabilities, resolveRulesDirs } from '../plugin-slots.mjs'
+import { getActiveCapabilities, getSlotContributions, resolveRulesDirs, resolveSlotGraph } from '../plugin-slots.mjs'
 import { readNRulesConfigLite, isRuleEnabled } from '../read-n-rules-config-lite.mjs'
 import { evaluateAppliesNode, readRuleApplies } from '../rule-applies.mjs'
 import { isSerialLane } from './blocking-inventory.mjs'
@@ -284,6 +284,71 @@ async function enabledRuleIds(byRule, cwd, rulesDirs) {
   return Object.keys(byRule).filter(id => isRuleEnabled(config, id))
 }
 
+/**
+ * Розширення (без крапки) з extension-map contributions slot-а — злиття `value`-мап
+ * (`'.rs' → 'Rust Module'`) усіх активних contributions версії 1.
+ * @param {ReturnType<typeof resolveSlotGraph>} graph slot graph від {@link resolveSlotGraph}.
+ * @param {string} slot ім'я slot-а (напр. `doc-files.extensions`).
+ * @returns {string[]} відсортовані розширення без крапки (порожньо — жодних contributions).
+ */
+function slotExtensions(graph, slot) {
+  /** @type {Set<string>} */
+  const exts = new Set()
+  for (const c of getSlotContributions(graph, slot, [1])) {
+    if (!c.value || typeof c.value !== 'object' || Array.isArray(c.value)) continue
+    for (const ext of Object.keys(c.value)) {
+      if (ext.startsWith('.') && ext.length > 1) exts.add(ext.slice(1))
+    }
+  }
+  return [...exts].toSorted()
+}
+
+/**
+ * Підставляє concern-ам із `lint.extensionsSlot` ефективний glob, виведений з
+ * extension-map contributions активних плагінів (напр. `doc-files.extensions@1`:
+ * lang-js дає js/mjs/ts/vue, lang-rust — rs) — щоб delta-режим і PostToolUse hook
+ * запускали concern на файлах УСІХ плагінних мов, а не лише зі статичного glob-а
+ * (раніше зміна `.rs` не запускала doc-files, хоча повний скан його бачив).
+ * Без жодної contribution (плагіни не встановлені в node_modules) статичний glob
+ * лишається fallback-ом — concern далі тригериться і його diagnostics можуть
+ * повідомити про недоступні плагіни.
+ * @param {Record<string, ConcernMeta[]>} byRule concerns згруповані за rule-id.
+ * @param {string} cwd корінь репозиторію, який лінтиться.
+ * @returns {Promise<Record<string, ConcernMeta[]>>} concerns із виведеними glob-ами.
+ */
+async function resolveSlotGlobs(byRule, cwd) {
+  const needsResolve = Object.values(byRule).some(concerns => concerns.some(c => c.lint.extensionsSlot !== undefined))
+  if (!needsResolve) return byRule
+  const config = await readNRulesConfigLite(cwd)
+  const graph = resolveSlotGraph(cwd, { plugins: config.plugins }, { allowInstall: false, quiet: true })
+  /** @type {Record<string, ConcernMeta[]>} */
+  const out = {}
+  for (const [ruleId, concerns] of Object.entries(byRule)) {
+    out[ruleId] = concerns.map(c => {
+      if (c.lint.extensionsSlot === undefined) return c
+      const exts = slotExtensions(graph, c.lint.extensionsSlot)
+      if (exts.length === 0) return c
+      const glob = exts.length === 1 ? [`**/*.${exts[0]}`] : [`**/*.{${exts.join(',')}}`]
+      return { ...c, lint: { ...c.lint, glob } }
+    })
+  }
+  return out
+}
+
+/**
+ * Спільний discovery-конвеєр detect/fix/ci-plan: rules-каталоги (ядро + плагіни) →
+ * concerns за rule-id → capability-фільтр → rule-applies-гейт → резолюція
+ * slot-derived glob-ів ({@link resolveSlotGlobs}).
+ * @param {{ rulesDir?: string, rulesDirs?: string[], capabilities?: Iterable<string>, cwd: string }} opts опції прогону.
+ * @returns {Promise<{ rulesDirs: string[], byRule: Record<string, ConcernMeta[]> }>} rules-каталоги і застосовні concerns.
+ */
+async function discoverConcernsByRule(opts) {
+  const rulesDirs = await effectiveRulesDirs(opts)
+  const capable = await filterByCapabilities(await readLintConcernsByRuleMulti(rulesDirs), opts)
+  const byRule = await resolveSlotGlobs(await filterByRuleApplies(capable, opts.cwd), opts.cwd)
+  return { rulesDirs, byRule }
+}
+
 /**
  * @typedef {{ entry: LintEntry, files: string[]|undefined }} PlanItem
  */
@@ -337,9 +402,7 @@ function fromPlanItems(items, byRule) {
  * @returns {Promise<PlanItem[]>} впорядкований план прогону.
  */
 export async function buildDetectPlan(opts) {
-  const rulesDirs = await effectiveRulesDirs(opts)
-  const capable = await filterByCapabilities(await readLintConcernsByRuleMulti(rulesDirs), opts)
-  const byRule = await filterByRuleApplies(capable, opts.cwd)
+  const { rulesDirs, byRule } = await discoverConcernsByRule(opts)
   return buildPlan({
     byRule,
     full: opts.full === true,
@@ -360,9 +423,7 @@ export async function buildDetectPlan(opts) {
  * @returns {Promise<{ byRule: Record<string, ConcernMeta[]>, enabledSet: Set<string> }>} concerns і активні правила.
  */
 export async function loadEnabledLintRules(opts) {
-  const rulesDirs = await effectiveRulesDirs(opts)
-  const capable = await filterByCapabilities(await readLintConcernsByRuleMulti(rulesDirs), opts)
-  const byRule = await filterByRuleApplies(capable, opts.cwd)
+  const { rulesDirs, byRule } = await discoverConcernsByRule(opts)
   const enabledSet = new Set(await enabledRuleIds(byRule, opts.cwd, rulesDirs))
   return { byRule, enabledSet }
 }
@@ -747,9 +808,7 @@ export async function detectAll(opts) {
   const verbose = opts.verbose === true
   const baseLog = opts.log ?? (s => process.stdout.write(s))
 
-  const rulesDirs = await effectiveRulesDirs(opts)
-  const capable = await filterByCapabilities(await readLintConcernsByRuleMulti(rulesDirs), opts)
-  const byRule = await filterByRuleApplies(capable, cwd)
+  const { rulesDirs, byRule } = await discoverConcernsByRule(opts)
   const plan = await buildPlan({
     byRule,
     full,