@7n/rules 1.7.4 → 1.7.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.7.6] - 2026-07-16
+
+### Fixed
+
+- Прибрано борг self-lint: `CLAUDE.md`-генератор вставляв список без порожнього рядка перед ним (MD032); дедуплікація `collectCapabilityPermissionIds` (tauri/tool_surface ↔ tauri/updater) та скелета "обхід тестових файлів" (test/no-console-store-restore ↔ test/vitest-api-conventions, винесено у test/lib/collect-test-file-offenders.mjs)
+
+## [1.7.5] - 2026-07-16
+
+### Fixed
+
+- npm: підняти нижню межу @7n/llm-lib до ^2.7.0 (skills-cli.mjs імпортує ./acp, доданий лише у 2.7.0 — старіші 2.x без цього subpath ламали npx @7n/rules з ERR_PACKAGE_PATH_NOT_EXPORTED)
+
 ## [1.7.4] - 2026-07-16
 
 ### Fixed

package/bin/n-rules.js

@@ -819,7 +819,7 @@ async function syncClaudeMd(ignore) {
   const lines = [`<!-- Цей файл генерується автоматично через \`npx ${PACKAGE_NAME}\`. Не редагуй вручну. -->`, '']
 
   if (Array.isArray(ignore) && ignore.length > 0) {
-    lines.push('## Захищені директорії', '', 'Ніколи не змінюй, не видаляй і не створюй файли у цих директоріях:')
+    lines.push('## Захищені директорії', '', 'Ніколи не змінюй, не видаляй і не створюй файли у цих директоріях:', '')
     for (const dir of ignore) {
       let d = dir
       while (d.endsWith('/')) d = d.slice(0, -1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.7.4",
+  "version": "1.7.6",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",
@@ -63,7 +63,7 @@
     "rename-yaml-extensions": "bun ./bin/n-rules.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@7n/llm-lib": "^2.0.0",
+    "@7n/llm-lib": "^2.7.0",
     "@7n/mt": "^0.5.1",
     "@zed-industries/agent-client-protocol": "^0.4.5",
     "ajv": "^8.20.0",

package/rules/js/eslint/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/js/eslint/main.mjs
 docgen:
-  crc: 0d2a5e02
+  crc: fa1753b7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/tauri/tool_surface/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/tool_surface/main.mjs
 docgen:
-  crc: 87b28b8d
+  crc: 35ae08a5
 ---
 
 ## Огляд

package/rules/tauri/tool_surface/main.mjs

@@ -6,7 +6,7 @@ import { join } from 'node:path'
 import { globby } from 'globby'
 
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { findTauriAppWorkspaces, groupCargoDepsBySection } from '../updater/main.mjs'
+import { collectCapabilityPermissionIds, findTauriAppWorkspaces, groupCargoDepsBySection } from '../updater/main.mjs'
 
 /** JS торкається плагіна, але crate відсутній у `src-tauri/Cargo.toml`. */
 export const PLUGIN_DEP_MISSING = 'tool-surface-plugin-dep-missing'
@@ -43,32 +43,6 @@ async function collectPluginUsages(srcDir) {
   return slugs
 }
 
-/**
- * Збирає всі permission-ідентифікатори з `capabilities/*.json` workspace-каталогу.
- * @param {string} capDir абсолютний шлях до каталогу capabilities
- * @returns {Promise<Set<string>>} множина permission-ідентифікаторів
- */
-async function collectCapabilityPermissionIds(capDir) {
-  const ids = new Set()
-  if (!existsSync(capDir)) return ids
-
-  const files = await globby('*.json', { cwd: capDir, onlyFiles: true, gitignore: false })
-  for (const file of files) {
-    let cap
-    try {
-      cap = JSON.parse(await readFile(join(capDir, file), 'utf8'))
-    } catch {
-      continue
-    }
-    const perms = Array.isArray(cap.permissions) ? cap.permissions : []
-    for (const p of perms) {
-      const id = typeof p === 'string' ? p : p?.identifier
-      if (id) ids.add(id)
-    }
-  }
-  return ids
-}
-
 /**
  * Перевіряє один workspace: кожен Tauri-плагін, якого JS торкається через
  * wrapper-пакет `@tauri-apps/plugin-*` чи прямий `invoke('plugin:...')`, має бути

package/rules/tauri/updater/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/updater/main.mjs
 docgen:
-  crc: f85675d3
+  crc: d08660a5
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98

package/rules/tauri/updater/main.mjs

@@ -256,9 +256,10 @@ async function checkLibRs(ws, cwd, reporter) {
  * @param {string} capDir абсолютний шлях до каталогу capabilities
  * @returns {Promise<Set<string>>} множина permission-ідентифікаторів
  */
-async function collectCapabilityPermissionIds(capDir) {
-  const files = await globby('*.json', { cwd: capDir, onlyFiles: true, gitignore: false })
+export async function collectCapabilityPermissionIds(capDir) {
   const ids = new Set()
+  if (!existsSync(capDir)) return ids
+  const files = await globby('*.json', { cwd: capDir, onlyFiles: true, gitignore: false })
   for (const file of files) {
     let cap
     try {

package/rules/test/lib/collect-test-file-offenders.mjs

@@ -0,0 +1,49 @@
+/** @see ../docs/collect-test-file-offenders.md */
+import { readFile } from 'node:fs/promises'
+import { basename, relative } from 'node:path'
+
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+/**
+ * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} `true` для `.test.{mjs,js}` файлів
+ */
+export function isTestFile(absPath) {
+  const name = basename(absPath)
+  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
+}
+
+/**
+ * Обходить репо (поважаючи `.n-rules.json:ignore`), збирає `*.test.{mjs,js}` файли
+ * і прогонить кожен через `findOffenders(body)` — спільний скелет для per-file
+ * regex/parse-based test-конвенцій (напр. `no-console-store-restore`, `vitest-api-conventions`).
+ * @param {string} cwd корінь репозиторію
+ * @param {(body: string) => Array<{line: number}>} findOffenders детектор порушень у тілі файлу
+ * @returns {Promise<{ testFiles: string[], offenders: Array<{file: string, line: number}> }>} усі тестові файли й знайдені порушення (з relative-шляхом)
+ */
+export async function collectTestFileOffenders(cwd, findOffenders) {
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const testFiles = []
+  await walkDir(
+    cwd,
+    absPath => {
+      if (isTestFile(absPath)) testFiles.push(absPath)
+    },
+    ignorePaths
+  )
+
+  /** @type {Array<{file: string, line: number}>} */
+  const offenders = []
+  for (const absPath of testFiles) {
+    const body = await readFile(absPath, 'utf8')
+    for (const o of findOffenders(body)) {
+      offenders.push({ file: relative(cwd, absPath), ...o })
+    }
+  }
+
+  return { testFiles, offenders }
+}

package/rules/test/lib/docs/collect-test-file-offenders.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: collect-test-file-offenders.mjs
+resource: npm/rules/test/lib/collect-test-file-offenders.mjs
+docgen:
+  crc: d1c3db48
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл знаходить JS-тести `*.test.mjs` і `*.test.js` у репозиторії з урахуванням `.n-rules.json` та повертає для кожного з них відносні шляхи до offenders. Це дає змогу окремо перевіряти, які саме тестові файли виходять за межі правил проєкту, без додаткового парсингу чи нормалізації результату.
+
+## Поведінка
+
+- `isTestFile` — визначає, чи шлях належить до JS-тесту `*.test.mjs` або `*.test.js`.
+- `collectTestFileOffenders` — знаходить усі тестові файли в репозиторії з урахуванням `.n-rules.json` та збирає для них знайдені порушення з відносними шляхами.
+
+## Публічний API
+
+- isTestFile — Розпізнає JS-файли з тестовою назвою `*.test.mjs` або `*.test.js`.
+- collectTestFileOffenders — Обходить репозиторій з урахуванням `.n-rules.json:ignore`, знаходить `*.test.{mjs,js}` і проганяє кожен файл через `findOffenders` для спільних test-конвенцій на кшталт `no-console-store-restore` і `vitest-api-conventions`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/lib/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/test/lib
+resource: npm/rules/test/lib/
+---
+
+| Файл                                                              | Тип       |
+| ----------------------------------------------------------------- | --------- |
+| [collect-test-file-offenders.mjs](collect-test-file-offenders.md) | JS Module |

package/rules/test/no-console-store-restore/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/test/no-console-store-restore/main.mjs
 docgen:
-  crc: 7b2c0909
+  crc: 5a1ab9dd
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/test/no-console-store-restore/main.mjs

@@ -1,10 +1,6 @@
 /** @see ./docs/no-console-store-restore.md */
-import { readFile } from 'node:fs/promises'
-import { basename, relative } from 'node:path'
-
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { collectTestFileOffenders } from '../lib/collect-test-file-offenders.mjs'
 
 /**
  * Ловить пряме присвоєння `console.<method> = …` у `*.test.{js,mjs}`.
@@ -14,16 +10,6 @@ import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 const CONSOLE_ASSIGN_RE =
   /\bconsole\.(?:log|error|warn|info|debug|dir|table|trace|group|groupEnd|time|timeEnd)\s*=(?!=)/u
 
-/**
- * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
- * @param {string} absPath абсолютний шлях
- * @returns {boolean} `true` для `.test.{mjs,js}` файлів
- */
-function isTestFile(absPath) {
-  const name = basename(absPath)
-  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
-}
-
 /**
  * Знаходить рядки з прямим присвоєнням `console.<method> = …`.
  * @param {string} body вміст файлу
@@ -51,26 +37,7 @@ export async function lint(ctx) {
   const { pass, fail } = reporter
 
   const cwd = ctx.cwd
-  const ignorePaths = await loadCursorIgnorePaths(cwd)
-
-  /** @type {string[]} */
-  const testFiles = []
-  await walkDir(
-    cwd,
-    absPath => {
-      if (isTestFile(absPath)) testFiles.push(absPath)
-    },
-    ignorePaths
-  )
-
-  /** @type {Array<{file: string, line: number}>} */
-  const offenders = []
-  for (const absPath of testFiles) {
-    const body = await readFile(absPath, 'utf8')
-    for (const o of findOffenders(body)) {
-      offenders.push({ file: relative(cwd, absPath), ...o })
-    }
-  }
+  const { testFiles, offenders } = await collectTestFileOffenders(cwd, findOffenders)
 
   if (offenders.length === 0) {
     pass(`Жоден з ${testFiles.length} тестових файлів не присвоює console.<method> = … (test.mdc)`)

package/rules/test/vitest-api-conventions/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/test/vitest-api-conventions/main.mjs
 docgen:
-  crc: 4ef8e575
+  crc: 806e74e3
 ---
 
 ## Огляд

package/rules/test/vitest-api-conventions/main.mjs

@@ -1,10 +1,6 @@
 /** @see ./docs/main.md */
-import { readFile } from 'node:fs/promises'
-import { basename, relative } from 'node:path'
-
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { collectTestFileOffenders } from '../lib/collect-test-file-offenders.mjs'
 
 /**
  * `expect(x).toBe({…})` / `expect(x).toBe([…])` — `toBe` — це `Object.is`
@@ -23,16 +19,6 @@ const QUOTE_CHARS = new Set(['"', "'", '`'])
 /** Мапа закриваючої дужки на парну дужку, яка її відкриває — для перевірки балансу стеку. */
 const CLOSE_TO_OPEN = { '}': '{', ']': '[' }
 
-/**
- * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
- * @param {string} absPath абсолютний шлях
- * @returns {boolean} `true` для `.test.{mjs,js}` файлів
- */
-function isTestFile(absPath) {
-  const name = basename(absPath)
-  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
-}
-
 /**
  * Пропускає пробіли/переноси рядків, повертає індекс першого не-whitespace символу.
  * @param {string} body вміст файлу
@@ -148,26 +134,7 @@ export async function lint(ctx) {
   const { pass, fail } = reporter
 
   const cwd = ctx.cwd
-  const ignorePaths = await loadCursorIgnorePaths(cwd)
-
-  /** @type {string[]} */
-  const testFiles = []
-  await walkDir(
-    cwd,
-    absPath => {
-      if (isTestFile(absPath)) testFiles.push(absPath)
-    },
-    ignorePaths
-  )
-
-  /** @type {Array<{file: string, line: number}>} */
-  const offenders = []
-  for (const absPath of testFiles) {
-    const body = await readFile(absPath, 'utf8')
-    for (const o of findOffenders(body)) {
-      offenders.push({ file: relative(cwd, absPath), ...o })
-    }
-  }
+  const { testFiles, offenders } = await collectTestFileOffenders(cwd, findOffenders)
 
   if (offenders.length === 0) {
     pass(`Жоден з ${testFiles.length} тестових файлів не викликає toBe(...) з об'єктним/масивним літералом (test.mdc)`)