@7n/rules 1.7.3 → 1.7.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [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
+
+- lint не бачить worktree-чекаутів (.worktrees/, .claude/worktrees/): виключені у walkDir, delta-списку змінених файлів і js/eslint (ESLint+oxlint)
+
 ## [1.7.3] - 2026-07-16
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "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: 2d36631f
+  crc: 0d2a5e02
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99
@@ -32,4 +32,4 @@ lint — проводить статичний аналіз коду (пофай
 
 **warnIgnored: false.** ESLint конструюється з `warnIgnored: false` — файли з delta-списку, що матчать ignore-патерни `eslint.config.js` (наприклад, синковані `.pi/extensions/**` чи згенеровані `npm/types/**`), не рахуються порушеннями.
 
-**Діагностика крашу oxlint.** Якщо oxlint завершився помилкою і json не розпарсено, у повідомлення DetectorError включаються exit-код і хвости stderr/stdout — інакше на CI причина (відсутній jsPlugin, конфіг, OOM) невидима.
+**Worktree-чекаути ігноруються.** Обидва інструменти виключають `.worktrees/**` і `.claude/worktrees/**` (копії репо від сесійних git-worktree, яких споживацький конфіг зазвичай не виключає): ESLint — через global ignores у `overrideConfig`, oxlint — через `--ignore-pattern`. Діє і у full-режимі, і для явно переданих файлів.

package/rules/js/eslint/main.mjs

@@ -8,6 +8,7 @@ import { spawnSync } from 'node:child_process'
 import { ESLint } from 'eslint'
 
 import { addedLinesByFile } from '../../../scripts/lib/diff-added-lines.mjs'
+import { WORKTREE_CHECKOUT_GLOBS } from '../../../scripts/utils/walkDir.mjs'
 import { classifyFindings, eslintResultsToFindings, parseOxlint } from '../lint-findings/main.mjs'
 
 const JS_EXT_RE = /\.(?:mjs|cjs|js|jsx|ts|tsx|vue)$/u
@@ -55,12 +56,18 @@ function toViolation(f, cwd, severity) {
  * @returns {Promise<Array<{ file: string, line: number, rule: string, message: string, tool: string }>>} зібрані знахідки oxlint+eslint
  */
 async function collectFindings(js, cwd) {
-  // warnIgnored:false — файли з delta, що матчать ignore-патерни конфігу, не є порушеннями
-  const eslint = new ESLint({ cwd, warnIgnored: false })
+  // warnIgnored:false — файли з delta, що матчать ignore-патерни конфігу, не є порушеннями.
+  // overrideConfig лише з ignores → global ignores: worktree-чекаути (.worktrees/,
+  // .claude/worktrees/) — копії репо, споживацький eslint-конфіг їх не виключає.
+  const eslint = new ESLint({ cwd, warnIgnored: false, overrideConfig: { ignores: WORKTREE_CHECKOUT_GLOBS } })
   const esResults = await eslint.lintFiles(js === null ? [cwd] : js.map(f => resolve(cwd, f)))
   const es = eslintResultsToFindings(esResults)
 
-  const oxArgs = js === null ? ['oxlint', '--format=json'] : ['oxlint', '--format=json', ...js]
+  const worktreeIgnoreArgs = WORKTREE_CHECKOUT_GLOBS.map(g => `--ignore-pattern=${g}`)
+  const oxArgs =
+    js === null
+      ? ['oxlint', '--format=json', ...worktreeIgnoreArgs]
+      : ['oxlint', '--format=json', ...worktreeIgnoreArgs, ...js]
   const oxRes = runOxlintJson(oxArgs, cwd)
   const ox = parseOxlint(oxRes.stdout)
   if (ox === null && oxRes.status !== 0) {

package/scripts/docs/sync-claude-config.md

@@ -3,7 +3,7 @@ type: JS Module
 title: sync-claude-config.mjs
 resource: npm/scripts/sync-claude-config.mjs
 docgen:
-  crc: 177ad3ea
+  crc: 1ae220d3
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 85
 ---

package/scripts/lib/changed-files.mjs

@@ -7,6 +7,8 @@
  */
 import { spawnSync } from 'node:child_process'
 
+import { isWorktreeCheckoutPath } from '../utils/walkDir.mjs'
+
 /**
  * @param {string[]} args аргументи git
  * @param {string} cwd корінь
@@ -29,7 +31,18 @@ function gitLines(args, cwd) {
 export function collectChangedFiles(cwd = process.cwd()) {
   const modified = gitLines(['diff', 'HEAD', '--name-only', '--diff-filter=ACMR'], cwd)
   const untracked = gitLines(['ls-files', '--others', '--exclude-standard'], cwd)
-  return [...new Set([...modified, ...untracked])]
+  return dropWorktreeCheckouts([...new Set([...modified, ...untracked])])
+}
+
+/**
+ * Прибирає шляхи всередині worktree-чекаутів (`.worktrees/`, `.claude/worktrees/`):
+ * це повні копії репо (сесійні worktree Claude/агентів), а не робочий код, і в
+ * споживацьких репо вони можуть бути не gitignored — git тоді віддає їх як untracked.
+ * @param {string[]} paths relative-posix шляхи
+ * @returns {string[]} шляхи без worktree-чекаутів
+ */
+function dropWorktreeCheckouts(paths) {
+  return paths.filter(p => !isWorktreeCheckoutPath(p))
 }
 
 /**
@@ -79,5 +92,5 @@ export function collectChangedFilesSince(base, cwd = process.cwd()) {
   }
   const changed = gitLines(['diff', base, '--name-only', '--diff-filter=ACMR'], cwd)
   const untracked = gitLines(['ls-files', '--others', '--exclude-standard'], cwd)
-  return [...new Set([...changed, ...untracked])]
+  return dropWorktreeCheckouts([...new Set([...changed, ...untracked])])
 }

package/scripts/lib/docs/changed-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: changed-files.mjs
 resource: npm/scripts/lib/changed-files.mjs
 docgen:
-  crc: 792d3942
+  crc: 483db255
   score: 100
 ---
 
@@ -27,6 +27,8 @@ collectChangedFilesSince Збирає змінені та незакомічен
 
 ## Гарантії поведінки
 
+- Обидва збирачі відкидають шляхи всередині worktree-чекаутів (`.worktrees/`, `.claude/worktrees/`): це повні копії репо (сесійні git-worktree Claude/агентів), а не робочий код; у споживацьких репо вони можуть бути не gitignored і інакше потрапляли б у delta-список як untracked.
+
 - Read-only: файл не виконує операцій запису у файлову систему.
 - За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
 - Не звертається до мережі.

package/scripts/utils/docs/walkDir.md

@@ -3,29 +3,31 @@ type: JS Module
 title: walkDir.mjs
 resource: npm/scripts/utils/walkDir.mjs
 docgen:
-  crc: f205f003
+  crc: 6f26e08f
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Публічна функція `walkDir` здійснює рекурсивний пошук файлів у вказаному каталозі. Вона обходить файлову систему, ігноруючи каталоги `.git` та `node_modules`. Знаходячи кожен файл, вона передає його повний шлях у колбек для подальшої обробки. Компонент є read-only, тобто не виконує записів у файлову систему чи бази даних. При роботі з файловою системою він перехоплює помилки, забезпечуючи безпечну роботу без викидання винятків.
+Публічна функція `walkDir` здійснює рекурсивний пошук файлів у вказаному каталозі. Вона обходить файлову систему, ігноруючи каталоги `.git`, `node_modules` та worktree-чекаути (`.worktrees/`, `.claude/worktrees/` — повні копії репо від сесійних git-worktree Claude/агентів). Знаходячи кожен файл, вона передає його повний шлях у колбек для подальшої обробки. Компонент є read-only, тобто не виконує записів у файлову систему чи бази даних. При роботі з файловою системою він перехоплює помилки, забезпечуючи безпечну роботу без викидання винятків.
 
 ## Поведінка
 
 1. Викликається функція walkDir для початку рекурсивного обходу каталогу.
 2. Система розшифровує вхідний шлях до кореня обходу.
 3. Система формує додаткові правила ігнорування на основі наданих шляхів.
-4. Система завжди ігнорує каталоги .git та node_modules.
+4. Система завжди ігнорує каталоги .git, node_modules і worktree-чекаути (.worktrees/, .claude/worktrees/) на будь-якій глибині.
 5. Система виконує пошук усіх файлів у каталозі, застосовуючи правила ігнорування, включаючи ті, що визначені в .gitignore.
 6. У разі виникнення помилки під час пошуку, процес обходу припиняється без генерації винятку.
 7. Для кожного знайденого файлу система викликає наданий колбек, передаючи йому повний абсолютний шлях до цього файлу.
 
 ## Публічний API
 
-walkDir — рекурсивно переглядає файли та папки, ігноруючи ті, що вказані у файлі `.gitignore`.
+- walkDir — рекурсивно переглядає файли та папки, ігноруючи ті, що вказані у файлі `.gitignore`.
+- isWorktreeCheckoutPath — предикат для відносного posix-шляху: чи лежить він усередині worktree-чекаута (`.worktrees/` або `.claude/worktrees/`). Для фільтрації git-списків, що не проходять через walkDir (наприклад, delta-список змінених файлів).
+- ALWAYS_IGNORE, WORKTREE_CHECKOUT_GLOBS — експортовані glob-константи безумовних пропусків обходу.
 
 ## Гарантії поведінки
 
 - Read-only: не виконує операцій запису (ФС/БД).
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- Свідомо пропускає шляхи: `.git`, `node_modules`.
+- Свідомо пропускає шляхи: `.git`, `node_modules`, `.worktrees/`, `.claude/worktrees/`.

package/scripts/utils/walkDir.mjs

@@ -2,9 +2,26 @@
 import { join, relative, resolve, sep } from 'node:path'
 import { globby } from 'globby'
 
+// Сесійні git-worktree чекаути (Claude/агенти): повні копії репо, не робочий код.
+// Споживацькі репо часто не мають цих шляхів у .gitignore, тож без safety net
+// lint-обхід бачив би дубль усього дерева.
+export const WORKTREE_CHECKOUT_GLOBS = ['**/.worktrees/**', '**/.claude/worktrees/**']
+
 // .git ніколи не потрапляє в .gitignore — пропускаємо завжди.
 // node_modules — safety net: проєкт може не мати .gitignore або запускатись поза git-репо.
-export const ALWAYS_IGNORE = ['.git/**', 'node_modules/**']
+export const ALWAYS_IGNORE = ['.git/**', 'node_modules/**', ...WORKTREE_CHECKOUT_GLOBS]
+
+const WORKTREE_CHECKOUT_RE = /(?:^|\/)(?:\.worktrees|\.claude\/worktrees)\//u
+
+/**
+ * Чи лежить відносний posix-шлях усередині worktree-чекаута (`.worktrees/` або
+ * `.claude/worktrees/`). Для фільтрації git-списків, що не проходять через walkDir.
+ * @param {string} relPath відносний posix-шлях від кореня репо.
+ * @returns {boolean} true, якщо шлях у worktree-чекауті.
+ */
+export function isWorktreeCheckoutPath(relPath) {
+  return WORKTREE_CHECKOUT_RE.test(relPath)
+}
 
 /**
  * Прибирає всі кінцеві `/` без regex-бектрекінгу.