@7n/rules 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.5.0] - 2026-07-15
+
+### Added
+
+- Нове правило `local-ai` (auto: завжди): інтеграція rtk (Rust Token Killer) для стискання виводу CLI-команд агентів. Sync вставляє fail-open PreToolUse hook у `.claude/settings.json` (`rtk hook claude`), preToolUse у `.cursor/hooks.json` (`rtk hook cursor`) та vendored pi-extension `.pi/extensions/rtk.ts`; від користувача потрібен лише `brew install rtk-ai/tap/rtk`. Вимкнення — `disable-rules: ["local-ai"]`.
+- Механізм плагінів: поле `plugins` у .n-rules.json + автодетект CI-провайдера (файли CI → repository.url) з авто-встановленням devDependency; multi-dir завантаження правил (ядро + плагіни, merge концернів), маніфест плагіна `n-rules` (capabilities/handlers); правило `ga` винесено у @7n/rules-ci-github
+- tauri/release: change-файл — обовʼязковий крок вирішення задачі (як lint/doc-files), не post-hoc фікс на сигнал `changelog/presence`.
+
+### Changed
+
+- docs(adr): merge pending ADR normalization batch
+
 ## [1.4.1] - 2026-07-15
 
 ### Fixed

package/bin/n-rules.js

@@ -83,6 +83,7 @@ import { injectWorktreeNotice } from '../scripts/lib/worktree-notice.mjs'
 import { injectRootNotice } from '../scripts/lib/root-notice.mjs'
 import { listProjectRulesMdcFiles } from '../scripts/lib/list-project-rules-mdc.mjs'
 import { ensureNRulesInRootDevDependencies } from '../scripts/ensure-n-rules-dev-dependencies.mjs'
+import { resolvePluginList, resolveRulesDirs } from '../scripts/lib/resolve-plugins.mjs'
 import { assertCwdIsProjectRoot } from '../scripts/lib/assert-project-root.mjs'
 import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
 import { syncGitignoreWorktree } from '../scripts/lib/sync-gitignore-worktree.mjs'
@@ -253,6 +254,33 @@ async function readRootPackageJsonSafe() {
   }
 }
 
+/**
+ * Агрегує імена правил по rules-каталогах (ядро перше, перший власник виграє)
+ * і будує мапу `ruleId → rulesDir` для копіювання mdc.
+ * @param {string[]} rulesDirs упорядковані rules-каталоги (ядро + плагіни)
+ * @returns {Promise<{ names: string[], sources: Map<string, string> }>} імена правил і їх джерела
+ */
+async function aggregateRuleSources(rulesDirs) {
+  /** @type {Map<string, string>} */
+  const sources = new Map()
+  for (const [i, dir] of rulesDirs.entries()) {
+    let names
+    if (i === 0) {
+      names = await discoverBundledRuleNames(dir) // ядро: відсутність каталогу — фатальна помилка
+    } else {
+      try {
+        names = await discoverBundledRuleNames(dir)
+      } catch {
+        continue // плагін без валідного rules/ — уже повідомлено у resolve-plugins
+      }
+    }
+    for (const name of names) {
+      if (!sources.has(name)) sources.set(name, dir)
+    }
+  }
+  return { names: sources.keys().toArray(), sources }
+}
+
 /**
  * Зчитує конфіг .n-rules.json з поточної директорії
  * @param {{ bundledRulesDir?: string, bundledSkillsDir?: string }} [paths] каталоги з пакету-джерела (після `bun i` — зазвичай `node_modules/@7n/rules`)
@@ -263,7 +291,22 @@ async function readConfig(paths = {}) {
   const bundledSkillsDir = paths.bundledSkillsDir ?? BUNDLED_SKILLS_DIR
   await migrateLegacyConfigIfNeeded()
   const configPath = join(cwd(), CONFIG_FILE)
-  const availableRules = await discoverBundledRuleNames(bundledRulesDir)
+
+  /** @type {Record<string, unknown> | null} */
+  let rawConfig = null
+  if (existsSync(configPath)) {
+    try {
+      rawConfig = JSON.parse(await readFile(configPath, 'utf8'))
+    } catch {
+      throw new Error(`Невірний JSON у файлі ${CONFIG_FILE}`)
+    }
+  }
+
+  // Плагіни: явне поле plugins конфігу або автодетект; sync-контекст — з установкою devDep.
+  // Результат детекту записуємо у конфіг (нижче), щоб hook/lint не залежали від детекту й мережі.
+  const detectedPlugins = Array.isArray(rawConfig?.plugins) ? null : resolvePluginList(cwd(), rawConfig)
+  const rulesDirs = resolveRulesDirs(cwd(), rawConfig, bundledRulesDir).map(d => d.rulesDir)
+  const { names: availableRules } = await aggregateRuleSources(rulesDirs)
   const availableSkills = await discoverBundledSkillNames(bundledSkillsDir)
 
   /**
@@ -291,7 +334,8 @@ async function readConfig(paths = {}) {
       root: cwd(),
       availableRules,
       packageJsonParsed: rootPkg,
-      disableRules
+      disableRules,
+      rulesDirs
     })
     // Skills залежать від ефективного списку правил, який буде у конфізі після merge:
     // вже існуючі (опт-ін вручну) + auto-detected, мінус `disable-rules`. Без цього
@@ -335,15 +379,20 @@ async function readConfig(paths = {}) {
     if (merged['disable-skills']?.length) {
       normalized['disable-skills'] = merged['disable-skills']
     }
+    if (!('plugins' in parsedConfig) && detectedPlugins && detectedPlugins.length > 0) {
+      normalized.plugins = detectedPlugins
+      console.log(`🔌 Автодетект плагінів: ${detectedPlugins.join(', ')} — записано у ${CONFIG_FILE}\n`)
+    }
     return sortConfigIdArrays(normalized)
   }
 
-  if (!existsSync(configPath)) {
+  if (rawConfig === null) {
     const rootPkg = await readRootPackageJsonSafe()
     const autoDetectedRules = await detectAutoRules({
       root: cwd(),
       availableRules,
-      packageJsonParsed: rootPkg
+      packageJsonParsed: rootPkg,
+      rulesDirs
     })
     const autoDetectedSkills = detectAutoSkills({
       availableSkills,
@@ -352,7 +401,8 @@ async function readConfig(paths = {}) {
     const defaultConfig = sortConfigIdArrays({
       $schema: CONFIG_SCHEMA_URL,
       rules: autoDetectedRules.rules,
-      skills: autoDetectedSkills.skills
+      skills: autoDetectedSkills.skills,
+      ...(detectedPlugins && detectedPlugins.length > 0 && { plugins: detectedPlugins })
     })
     await writeFile(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, 'utf8')
     console.log(
@@ -360,14 +410,7 @@ async function readConfig(paths = {}) {
     )
     return defaultConfig
   }
-  const raw = await readFile(configPath, 'utf8')
-  /** @type {Record<string, unknown>} */
-  let config
-  try {
-    config = JSON.parse(raw)
-  } catch {
-    throw new Error(`Невірний JSON у файлі ${CONFIG_FILE}`)
-  }
+  const config = rawConfig
   logRuleMigrationsIfAny(config)
   const normalized = await normalizeConfigWithAutoRules(config)
   if (JSON.stringify(normalized) !== JSON.stringify(config)) {
@@ -1197,11 +1240,12 @@ async function captureOutput(action) {
 /**
  * Копіює керовані `.mdc` файли з пакету до `.cursor/rules`.
  * @param {string[]} rules список rules з конфігу
- * @param {string} bundledRulesDir каталог `rules` пакету-джерела
+ * @param {string} bundledRulesDir каталог `rules` пакету-джерела (fallback для правил без явного джерела)
  * @param {string} rulesDir абсолютний шлях до `.cursor/rules`
+ * @param {Map<string, string>} [ruleSources] мапа `ruleId → rulesDir` власника правила (ядро/плагін)
  * @returns {Promise<{ successCount: number, failCount: number }>} статистика копіювання
  */
-async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir) {
+async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources = new Map()) {
   let successCount = 0
   let failCount = 0
   for (const rule of rules) {
@@ -1209,7 +1253,8 @@ async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir) {
     const destPath = join(rulesDir, fileName)
     try {
       process.stdout.write(`  ⬇  ${rule} → ${RULES_DIR}/${fileName} ... `)
-      const content = await readBundledRuleContent(rule, bundledRulesDir)
+      const sourceDir = ruleSources.get(normalizeRuleName(rule)) ?? bundledRulesDir
+      const content = await readBundledRuleContent(rule, sourceDir)
       await writeFile(destPath, content, 'utf8')
       console.log(`✅`)
       successCount++
@@ -1359,8 +1404,11 @@ async function runSync() {
 
   const rulesDir = join(cwd(), RULES_DIR)
   await mkdir(rulesDir, { recursive: true })
+  // Джерела правил: ядро + rules/ плагінів (резолв кешований після readConfig).
+  const allRulesDirs = resolveRulesDirs(projectRoot, config, bundledRulesDir).map(d => d.rulesDir)
+  const { sources: ruleSources } = await aggregateRuleSources(allRulesDirs)
   const { successCount, failCount } = await captureOutput(async () => {
-    const stats = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir)
+    const stats = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir, ruleSources)
     return { ...stats, fail: stats.failCount }
   })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",
@@ -48,6 +48,13 @@
   ],
   "type": "module",
   "types": "./types/bin/n-rules.d.ts",
+  "exports": {
+    ".": "./bin/n-rules.js",
+    "./package.json": "./package.json",
+    "./scripts/*": "./scripts/*",
+    "./schemas/*": "./schemas/*",
+    "./rules/*": "./rules/*"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
@@ -58,6 +65,7 @@
   "dependencies": {
     "@7n/mt": "^0.5.1",
     "@7n/llm-lib": "^2.0.0",
+    "@zed-industries/agent-client-protocol": "^0.4.5",
     "ajv": "^8.20.0",
     "cli-progress": "^3.12.0",
     "eslint": "^10.4.1",
@@ -76,6 +84,8 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
+    "@agentclientprotocol/claude-agent-acp": "^0.59.0",
+    "@agentclientprotocol/codex-acp": "^1.1.2",
     "@earendil-works/pi-ai": "0.80.2",
     "@earendil-works/pi-coding-agent": "0.80.2"
   },

package/rules/abie/clean_merged_ignore_branches/concern.json

@@ -4,5 +4,8 @@
     "files": {
       "single": ".github/workflows/clean-merged-branch.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/docker/lint_docker_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-docker.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/js/lint_js_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-js.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/k8s/lint_k8s_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-k8s.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/npm-module/npm_publish_yml/concern.json

@@ -6,5 +6,8 @@
       "single": ".github/workflows/npm-publish.yml"
     },
     "check": "template"
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/php/lint_php_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-php.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/python/lint_python_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-python.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/rust/lint_rust_yml/concern.json

@@ -7,5 +7,8 @@
       "required": true
     },
     "missingMessage": ".github/workflows/lint-rust.yml не існує — створи з канонічним вмістом (rust.mdc)"
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/rust/toolchain_cache/concern.json

@@ -1,5 +1,14 @@
 {
   "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
   "fixability": "config",
-  "lint": { "scope": "full", "glob": [".github/workflows/*.yml", ".github/workflows/*.yaml"] }
+  "lint": {
+    "scope": "full",
+    "glob": [
+      ".github/workflows/*.yml",
+      ".github/workflows/*.yaml"
+    ]
+  },
+  "requires": {
+    "capability": "ci:github"
+  }
 }

package/rules/security/lint_security_yml/concern.json

@@ -7,5 +7,8 @@
       "required": true
     },
     "missingMessage": ".github/workflows/lint-security.yml не знайдено — створи за каноном security.mdc"
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/style/lint_style_yml/concern.json

@@ -5,5 +5,8 @@
     "files": {
       "single": ".github/workflows/lint-style.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/rules/tauri/main.mdc

@@ -2,7 +2,7 @@
 description: Tauri
 globs: "**/src-tauri/**,**/tauri.conf.json"
 alwaysApply: false
-version: '1.8'
+version: '1.9'
 ---
 
 Правило встановлює канонічні вимоги для Tauri-проєктів: виявлення маркерів у монорепо, VS Code-розширення, налаштування mutation-testing для platform bridge, компіляційну ізоляцію agent/LLM-логіки від app-shell, реалізацію Tool Surface поверх Tauri+Rust, реліз-flow через change-файли (тег → DMG/updater-артефакти), автооновлення через спільний `useUpdater()` з `@7n/tauri-components` та верифікацію застосунку LLM-агентом через `tauri-plugin-mcp-bridge`.

package/rules/tauri/release/release.mdc

@@ -4,6 +4,21 @@
 
 Канон складається з двох workflow-файлів і відповідного `tauri.conf.json`-конфігу; референс — `.github/workflows/{changelog-release,release}.yml` та `src-tauri/tauri.conf.json` чотирьох production Tauri-репо, де цей flow вже впроваджено.
 
+### Change-файл — крок вирішення задачі, а не post-hoc lint-фікс
+
+Change-файл (`<app>/.changes/<ts>.md`) створюється **одразу під час вирішення задачі**, що
+чіпає код Tauri-workspace — той самий момент, що lint і doc-files, а не окремий крок після
+сигналу `changeset-missing` від delta-lint concern `changelog/presence`. Без нього мердж у
+`main` не тригерить `changelog-release.yml` (тригер — `paths: [app/.changes/**]`), і зміна
+осідає в репозиторії без релізу, доки хтось не помітить і не докомітить change-файл окремо.
+
+Команда: `npx @7n/n ch --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<опис>"`
+(інтерактивно — `npx @7n/n ch`). Повна модель (база порівняння, формат CHANGELOG,
+post-release-інваріант) — у `n-changelog.mdc` і `release/main.mdc`.
+
+`changelog/presence` лишається gate-запобіжником на випадок, якщо крок пропущено (delta-lint
+у CI/hook), а не первинним механізмом створення change-файлу.
+
 ### `changelog-release.yml` — бамп версії з change-файлів
 
 Тригериться на push у `main` за наявності change-файлів і на ручний dispatch:

package/rules/text/lint_text/concern.json

@@ -4,5 +4,8 @@
     "files": {
       "single": ".github/workflows/lint-text.yml"
     }
+  },
+  "requires": {
+    "capability": "ci:github"
   }
 }

package/schemas/concern.json

@@ -12,7 +12,11 @@
     },
     "fixability": {
       "type": "string",
-      "enum": ["code", "config", "structural"],
+      "enum": [
+        "code",
+        "config",
+        "structural"
+      ],
       "description": "Маршрутизація fix-движка. Усі мітки виконують детерміновану фазу T0; різниця — що після неї. `code` (дефолт, поле можна опускати) — джерельні порушення, які LLM може осмислено переписати → повна pi-agent-ladder (local→cloud) до чистого re-detect. `config` — canon/settings/tooling конфіг з єдиною правильною формою (jscpd/oxfmtrc/tooling/package_json/*_yml): фікс детермінований (T0/regen з канону), LLM лише вгадав би невалідне → після T0 fail-fast без ladder. `structural` — дублікати/розташування/структура (jscpd_duplicates/test-location/package-structure): авто-правка ризикована й потребує людського розсуду → після T0 fail-fast без ladder. config vs structural різняться мотивом пропуску (детермінований канон vs надто ризиковано) — для телеметрії й майбутнього routing."
     },
     "check": {
@@ -27,7 +31,10 @@
       "properties": {
         "engine": {
           "type": "string",
-          "enum": ["rego", "template"],
+          "enum": [
+            "rego",
+            "template"
+          ],
           "description": "rego → .rego через conftest; template → generic deep-subset. Канонічна заміна поля `check`."
         },
         "namespace": {
@@ -39,21 +46,40 @@
             {
               "type": "object",
               "additionalProperties": false,
-              "required": ["single"],
+              "required": [
+                "single"
+              ],
               "properties": {
-                "single": { "type": "string", "minLength": 1 },
-                "required": { "type": "boolean" }
+                "single": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "required": {
+                  "type": "boolean"
+                }
               }
             },
             {
               "type": "object",
               "additionalProperties": false,
-              "required": ["walkGlob"],
+              "required": [
+                "walkGlob"
+              ],
               "properties": {
                 "walkGlob": {
                   "oneOf": [
-                    { "type": "string", "minLength": 1 },
-                    { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "array",
+                      "minItems": 1,
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    }
                   ]
                 }
               }
@@ -61,12 +87,24 @@
             {
               "type": "object",
               "additionalProperties": false,
-              "required": ["glob"],
+              "required": [
+                "glob"
+              ],
               "properties": {
                 "glob": {
                   "oneOf": [
-                    { "type": "string", "minLength": 1 },
-                    { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "array",
+                      "minItems": 1,
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    }
                   ]
                 }
               }
@@ -75,7 +113,9 @@
         },
         "check": {
           "type": "string",
-          "enum": ["template"],
+          "enum": [
+            "template"
+          ],
           "description": "template → generic deep-subset без .rego; без поля → Rego mode."
         },
         "missingMessage": {
@@ -87,22 +127,52 @@
     "lint": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["scope"],
+      "required": [
+        "scope"
+      ],
       "description": "Lint поверхня. main.mjs має експортувати lint(changed, cwd, opts).",
       "properties": {
         "scope": {
           "type": "string",
-          "enum": ["per-file", "full"],
+          "enum": [
+            "per-file",
+            "full"
+          ],
           "description": "per-file: delta-режим; full: крос-файловий."
         },
         "glob": {
           "oneOf": [
-            { "type": "string", "minLength": 1 },
-            { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
           ],
           "description": "per-file: фільтр delta-файлів; full: delta-тригер."
         }
       }
+    },
+    "requires": {
+      "type": "object",
+      "description": "Гейт активації: концерн виконується лише коли задекларована capability доступна (її надає встановлений плагін через блок n-rules.capabilities у своєму package.json). Приклад: {\"capability\": \"ci:github\"} — концерн вимагає GitHub Actions і спить у репозиторіях без плагіна @7n/rules-ci-github.",
+      "additionalProperties": false,
+      "required": [
+        "capability"
+      ],
+      "properties": {
+        "capability": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9:-]*$",
+          "description": "Ім'я capability (конвенція <тип>:<назва>, напр. ci:github, ci:azure, lang:rust)"
+        }
+      }
     }
   }
 }

package/schemas/n-rules.json

@@ -27,6 +27,14 @@
         "minLength": 1
       }
     },
+    "plugins": {
+      "type": "array",
+      "description": "npm-пакети-плагіни з додатковими правилами (rules/<id>/ за контрактом ядра). Якщо поле відсутнє — CLI автоматично визначає CI-провайдера (файли CI, потім repository.url) і дописує сюди результат. Порожній масив — плагіни вимкнено.",
+      "items": {
+        "type": "string",
+        "pattern": "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$"
+      }
+    },
     "disable-rules": {
       "type": "array",
       "description": "Список rule id (без префікса n-), які не потрібно автододавати в `.n-rules.json` під час запуску CLI.",
@@ -61,5 +69,7 @@
       "default": true
     }
   },
-  "required": ["rules"]
+  "required": [
+    "rules"
+  ]
 }