@7n/rules 1.26.0 → 1.28.0

package/rules/doc-files/docgen-extract/main.mjs

@@ -1,275 +0,0 @@
-/** @see ./docs/docgen-extract.md */
-
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { readFileSync } from 'node:fs'
-
-const BUILTIN_MODULES = new Set([
-  'fs',
-  'path',
-  'crypto',
-  'os',
-  'util',
-  'stream',
-  'events',
-  'http',
-  'https',
-  'url',
-  'child_process',
-  'process',
-  'assert',
-  'buffer',
-  'zlib',
-  'readline'
-])
-
-const JSDOC_OPEN_RE = /^\s*\/\*\*?/
-const JSDOC_CLOSE_RE = /\*\/\s*$/
-const STAR_PREFIX_RE = /^\s*\*?\s?/
-const PARAM_LINE_RE = /^@param[ \t]{1,8}(?:\{[^}]{0,200}\}[ \t]{1,8})?\[?([\w.]{1,80})\]?[ \t]{0,8}(.{0,400})$/
-const RETURNS_LINE_RE = /^@returns?[ \t]{1,8}(?:\{[^}]{0,200}\}[ \t]{1,8})?(.{0,400})$/
-const FILE_HEADER_RE = /^\s*\/\*\*([\s\S]*?)\*\//
-const PRECEDING_JSDOC_RE = /\/\*\*(?:(?!\*\/)[\s\S])*\*\/\s*$/
-const EXPORT_DECL_RE = /export\s+(?:async\s+)?(function|const|class)\s+(\w+)/g
-// Top-level function/class декларації (колонка 0) — для R6: службові функції,
-// які не експортуються, не мають протікати у Поведінку/API як «публічні».
-const TOP_FN_DECL_RE = /^(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function\*?|class)\s+(\w+)/gm
-const IMPORT_FROM_RE = /^import[ \t]{1,8}[\s\S]{0,300}?from\s{1,8}['"]([^'"]+)['"]/gm
-const NODE_PREFIX_RE = /^node:/
-const INTERNAL_IMPORT_RE = /import[ \t]{1,8}([^'"]{0,300}?)from[ \t]{1,8}['"]\.[^'"]{1,300}['"]/g
-const NAMED_BRACES_RE = /\{([^}]{1,400})\}/
-const IDENT_RE = /^[\w$]{1,80}$/
-const IMPORT_AS_RE = /[ \t]{1,8}as[ \t]{1,8}.{0,200}/
-const WRITE_FS_RE = /\b(writeFile|mkdir|rmdir|unlink|appendFile|createWriteStream|rm\()/
-const CATCH_RE = /catch\s*\(/
-const TRY_RE = /\btry\s*\{/
-// Falsy-return як «fail-safe» — лише коли воно в catch/error-гілці (інакше це
-// звичайний guard `if (!x) return null`, не обробка помилки). Уникає over-claim.
-const FALSY_RETURN_RE = /catch[\s\S]{0,400}?return\s+(false|null|''|"")/
-// Мережа: окрім явного fetch/http, ловимо абстраговані клієнти (graphql/db/rpc/
-// octokit/.request/.query). Хибний false-negative тут = небезпечна гарантія
-// «без мережі», тож свідомо схиляємось до over-detection (м'якший бік помилки).
-const NETWORK_RE =
-  /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
-// Будь-який `throw` назовні → НЕ можна гарантувати «fail-safe / без винятків».
-const THROW_RE = /\bthrow\s/
-// Запис у БД / зовнішню мутацію → НЕ read-only (навіть якщо нема ФС-запису).
-// Розбито на кілька простіших патернів (та сама семантика через OR у `isMutation`),
-// щоб уникнути надмірної складності одного великого regex.
-const MUTATION_CALL_RE = /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]/
-const MUTATION_NAME_RE = /[Mm]utation\b|\bmut[A-Z]\w*/
-const MUTATION_METHOD_RE = /\.(save|create|update|delete|insert|destroy|mutate)\(/
-// Raw-SQL tagged-template виклики (напр. `pgWrite\`UPDATE ...\``) — DML-ключове
-// слово стоїть на початку тіла шаблону, не перед `(`, тож JS-орієнтовані
-// патерни вище його не ловлять. Сигнал мінімальний, але навмисний: тег-функція
-// (ідентифікатор впритул перед `` ` ``) + DML-keyword одразу після відкриття —
-// уникає false positive на звичайних рядках/коментарях, де немає теg-виклику.
-const SQL_TAGGED_MUTATION_RE = /\b\w+`\s*(?:UPDATE|INSERT|MERGE\s+INTO|DELETE\s+FROM|UPSERT)\b/i
-/**
- * @param {string} src вміст файлу
- * @returns {boolean} чи є ознаки мутації БД / зовнішнього стану
- */
-const isMutation = src =>
-  MUTATION_CALL_RE.test(src) ||
-  MUTATION_NAME_RE.test(src) ||
-  MUTATION_METHOD_RE.test(src) ||
-  SQL_TAGGED_MUTATION_RE.test(src)
-// Кеш — лише за ІМЕНОВАНИМ маркером (`cache`/`Cache`/`memoize`), не за будь-яким
-// `new Map()`: акумулятор (напр. `byPath = new Map()`) — не кеш, а хибна гарантія
-// «Кешує результати» гірша за пропуск (фабрикація > мовчання).
-const CACHE_RE = /cache|memoi[sz]e/i
-
-/**
- * Прибирає `/** *​/`-обрамлення й `*`-префікси, повертає чистий текст рядками.
- * @param {string} raw сирий JSDoc-блок з обрамленням
- * @returns {string} очищений текст без обрамлення й префіксів
- */
-function cleanJsDoc(raw) {
-  return raw
-    .replace(JSDOC_OPEN_RE, '')
-    .replace(JSDOC_CLOSE_RE, '')
-    .split('\n')
-    .map(l => l.replace(STAR_PREFIX_RE, '').trimEnd())
-    .join('\n')
-    .trim()
-}
-
-/**
- * Опис (без @-тегів) + параметри з `@param` як «name — опис».
- * @param {string} raw сирий JSDoc-блок
- * @returns {{desc:string, params:Array<{name:string, desc:string}>, ret:string}} розпарсений опис, параметри й опис повернення
- */
-function parseJsDoc(raw) {
-  const text = cleanJsDoc(raw)
-  const lines = text.split('\n')
-  const descLines = []
-  const params = []
-  let ret = ''
-  for (const l of lines) {
-    const pm = l.match(PARAM_LINE_RE)
-    if (pm) {
-      const desc = pm[2].trim()
-      // «опис.» — JSDoc-заглушка без сенсу; не тягнемо її як факт
-      params.push({ name: pm[1], desc: desc === 'опис.' ? '' : desc })
-      continue
-    }
-    const rm = l.match(RETURNS_LINE_RE)
-    if (rm) {
-      ret = rm[1].trim()
-      continue
-    }
-    if (l.startsWith('@')) continue
-    descLines.push(l)
-  }
-  return { desc: descLines.join('\n').trim(), params, ret }
-}
-
-/**
- * Провідний блок-коментар файлу (намір), якщо він перед першим import/кодом.
- * @param {string} src вміст файлу
- * @returns {string} текст header-коментаря або порожній рядок
- */
-function extractFileHeader(src) {
-  const m = src.match(FILE_HEADER_RE)
-  if (!m) return ''
-  // має бути на самому початку (до import/код)
-  if (src.slice(0, m.index).trim() !== '') return ''
-  return parseJsDoc(m[0]).desc
-}
-
-/**
- * Блок-коментар, що стоїть ВПРИТУЛ перед позицією (лише пробіли між ними).
- * `(?:(?!\*​/)[\s\S])*` гарантує, що тіло не містить `*​/`, тож захоплюється рівно один
- * найближчий блок — без жадібного «перестрибування» через імпорти/код.
- * @param {string} prefix вміст файлу до позиції експорту
- * @returns {string|null} JSDoc-блок або null якщо немає
- */
-function precedingJsDoc(prefix) {
-  const m = prefix.match(PRECEDING_JSDOC_RE)
-  return m ? m[0] : null
-}
-
-/**
- * Експорти + JSDoc, що безпосередньо передує кожному.
- * @param {string} src вміст файлу
- * @returns {Array<object>} список експортів із метаданими
- */
-function extractExports(src) {
-  const out = []
-  for (const m of src.matchAll(EXPORT_DECL_RE)) {
-    const [, kind, name] = m
-    const jsdocRaw = precedingJsDoc(src.slice(0, m.index))
-    out.push({ name, kind, ...(jsdocRaw ? parseJsDoc(jsdocRaw) : { desc: '', params: [], ret: '' }) })
-  }
-  return out
-}
-
-/**
- * Імпорти, класифіковані на stdlib / npm / internal.
- * @param {string} src вміст файлу
- * @returns {{stdlib:Array<string>, npm:Array<string>, internal:Array<string>}} розкласифіковані шляхи імпортів
- */
-function extractImports(src) {
-  const internal = new Set(),
-    npm = new Set(),
-    stdlib = new Set()
-  for (const m of src.matchAll(IMPORT_FROM_RE)) {
-    const s = m[1]
-    if (s.startsWith('node:') || BUILTIN_MODULES.has(s.split('/', 1)[0])) stdlib.add(s.replace(NODE_PREFIX_RE, ''))
-    else if (s.startsWith('.') || s.startsWith('/')) internal.add(s)
-    else npm.add(s)
-  }
-  return { stdlib: [...stdlib], npm: [...npm], internal: [...internal] }
-}
-
-/**
- * Імена символів, імпортованих із внутрішніх модулів — їх модель не має згадувати.
- * @param {string} src вміст файлу
- * @returns {Array<string>} список імен внутрішніх символів
- */
-function extractInternalSymbols(src) {
-  const out = new Set()
-  for (const m of src.matchAll(INTERNAL_IMPORT_RE)) {
-    const clause = m[1]
-    const named = clause.match(NAMED_BRACES_RE)
-    if (named) {
-      for (const n of named[1].split(',')) {
-        const name = n.replace(IMPORT_AS_RE, '').trim()
-        if (name) out.add(name)
-      }
-    }
-    const defName = clause.replace(NAMED_BRACES_RE, '').replaceAll(',', ' ').trim().split(' ', 1)[0]
-    if (defName && IDENT_RE.test(defName)) out.add(defName)
-  }
-  return [...out]
-}
-
-/**
- * Імена top-level функцій/класів, які НЕ експортуються (службові помічники).
- * Модель не має подавати їх як «публічні функції» у Поведінці/API (R6).
- * Const-стрілки свідомо не ловимо — менше false-positive на змістовних константах.
- * @param {string} src вміст файлу
- * @returns {Array<string>} список імен неекспортованих функцій/класів
- */
-function extractLocalSymbols(src) {
-  const exported = new Set(Array.from(src.matchAll(EXPORT_DECL_RE), m => m[2]))
-  const out = new Set()
-  for (const m of src.matchAll(TOP_FN_DECL_RE)) {
-    if (!exported.has(m[1])) out.add(m[1])
-  }
-  return [...out]
-}
-
-/**
- * Поведінкові маркери — евристики регулярками.
- * @param {string} src вміст файлу
- * @returns {object} набір прапорців-евристик
- */
-function extractMarkers(src) {
-  // помітні «пропуски»: dir/segment-літерали у фільтрах
-  const skips = new Set()
-  for (const lit of ['.github', '.git', 'node_modules', 'base/', 'ua/', '.firebase']) {
-    if (src.includes(`'${lit}`) || src.includes(`"${lit}`) || src.includes(`/${lit}`)) skips.add(lit)
-  }
-  return {
-    // «Фабрикація > мовчання»: прапорець true лише за high-confidence; інакше
-    // guaranteesFromMarkers/factsSummary його ОПУСКАЮТЬ (не стверджують протилежне).
-    readOnly: !WRITE_FS_RE.test(src) && !isMutation(src), // ні ФС-запису, ні DB-мутацій
-    catchesErrors: (CATCH_RE.test(src) || TRY_RE.test(src)) && !THROW_RE.test(src), // fail-safe лише якщо НЕ кидає
-    returnsFalsyOnFail: FALSY_RETURN_RE.test(src) && !THROW_RE.test(src),
-    network: NETWORK_RE.test(src),
-    caches: CACHE_RE.test(src),
-    skips: [...skips]
-  }
-}
-/**
- * Головний екстрактор: код файлу → факт-лист.
- * @param {string} src вміст файлу
- * @param {string} relPath шлях (для контексту/мови екстрактора)
- * @returns {{relPath:string, lang:string, header:string, exports:Array, imports:object, markers:object}} структура фактів про файл
- */
-export function extractFacts(src, relPath) {
-  const lang = relPath.split('.').pop()
-  if (!['js', 'mjs', 'ts'].includes(lang)) {
-    return { relPath, lang, unsupported: true, header: '', exports: [], imports: {}, markers: {} }
-  }
-  return {
-    relPath,
-    lang,
-    header: extractFileHeader(src),
-    exports: extractExports(src),
-    imports: extractImports(src),
-    internalSymbols: extractInternalSymbols(src),
-    localSymbols: extractLocalSymbols(src),
-    markers: extractMarkers(src)
-  }
-}
-
-// CLI для інспекції: node docgen-extract.mjs <file>
-if (isRunAsCli(import.meta.url)) {
-  const file = process.argv[2]
-  if (!file) {
-    throw new Error('Usage: node docgen-extract.mjs <file>')
-  }
-  const facts = extractFacts(readFileSync(file, 'utf8'), file)
-  console.log(JSON.stringify(facts, null, 2))
-}

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

@@ -1,3 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json"
-}

package/rules/doc-files/units/docs/main.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/doc-files/units/main.mjs
-docgen:
-  crc: 8acdefc1
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей файл забезпечує аналіз вмісту файлів різного мовного формату для вилучення інформації про юніти. Він обробляє вміст, визначаючи відповідний метод вилучення для JavaScript-подібних або Rust-файлів. Публічна функція `extractUnits` виконує механізм вилучення юнітних даних з коду.
-
-## Поведінка
-
-1. Метод `extractUnits` приймає вміст файлу та його відносний шлях.
-2. Визначається розширення файлу за його відносним шляхом.
-3. Якщо розширення відповідає JavaScript-подібним мовам (js, mjs, ts, jsx, tsx, cts, mts), викликається відповідна функція для вилучення юнітів на основі AST.
-4. Якщо розширення 'rs', викликається відповідна функція для вилучення юнітів шляхом парсингу за допомогою регулярних виразів та підрахунку блоків.
-5. Якщо розширення не підтримується або файл не може бути проаналізований, метод повертає null.
-
-## Публічний API
-
-- extractUnits — Витягує одиниці виміру, визначаючи метод аналізу на основі розширення файлу (від AST для JS/TS до простого пошуку для Vue/Py).
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/doc-files/units/main.mjs

@@ -1,19 +0,0 @@
-/** @see ./docs/units.md */
-
-import { extractUnitsJs } from '../units-js/main.mjs'
-
-const JS_EXT = new Set(['js', 'mjs', 'ts', 'jsx', 'tsx', 'cts', 'mts'])
-
-/**
- * Мовно-агностичний фасад юніт-шару. Диспатчить за розширенням:
- * js/mjs/ts → oxc AST; інші мови (rs — lang-плагін, extension-point
- * `doc-files`.extractUnits; vue/py) → null (whole-file шлях).
- * @param {string} src вміст файлу
- * @param {string} relPath шлях файлу
- * @returns {Array<object>|null} юніти або null, якщо мова ще не підтримана / файл не парситься
- */
-export function extractUnits(src, relPath) {
-  const ext = (relPath.split('.').pop() || '').toLowerCase()
-  if (JS_EXT.has(ext)) return extractUnitsJs(src, relPath)
-  return null
-}

package/rules/doc-files/units-js/concern.json

@@ -1,3 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json"
-}

package/rules/doc-files/units-js/docs/main.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/doc-files/units-js/main.mjs
-docgen:
-  crc: 395188f4
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Будь ласка, надайте секцію «overview», яку необхідно переписати.
-
-## Поведінка
-
-1. Функція extractUnitsJs аналізує вміст файлу, щоб виявити ідентифіковані юніти (функції, класи, const-функції).
-2. Вона визначає, які юніти є експортованими та обробляє їх для включення до списку.
-3. Для кожного знайденого юніту вона витягує відповідний опис з JSDoc, що передує його оголошенню.
-4. Зібрана інформація про юніт включає його назву, тип (функція, клас, const), прапор експорту, діапазон у вихідному коді та повний вихідний код.
-5. Система виявляє всі виклики інших юнітів у тілі коду кожного юніта.
-6. В результаті повертається список об'єктів, де кожен об'єкт описує один юніт, і в якому вказано лише посилання на інші виявлені юніти.
-
-## Публічний API
-
-extractUnitsJs — знаходить та витягує на верхньому рівні логічні блоки (функції/класи/константи) з файлів JavaScript/TypeScript, які є частиною юніт-шару. Включає інформацію про експорт та взаємодії з іншими юнітами.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/doc-files/units-js/main.mjs

@@ -1,141 +0,0 @@
-/** @see ./docs/units-js.md */
-
-import { parseProgramOrNull, walkAstWithAncestors } from '../../../scripts/utils/ast-scan-utils.mjs'
-
-// JSDoc-блок, що стоїть впритул перед позицією (лише пробіли між ними).
-const JSDOC_BEFORE_RE = /\/\*\*(?:(?!\*\/)[\s\S])*\*\/\s*$/
-const JSDOC_OPEN_RE = /^\s*\/\*\*?/
-const JSDOC_CLOSE_RE = /\*\/\s*$/
-const STAR_PREFIX_RE = /^\s*\*?\s?/
-
-/**
- * Очищає JSDoc від обрамлення `/** *​/` і `*`-префіксів.
- * @param {string} raw сирий блок або порожній рядок
- * @returns {string} текст опису без тегів-обрамлення
- */
-function cleanDoc(raw) {
-  if (!raw) return ''
-  return raw
-    .replace(JSDOC_OPEN_RE, '')
-    .replace(JSDOC_CLOSE_RE, '')
-    .split('\n')
-    .map(l => l.replace(STAR_PREFIX_RE, '').trimEnd())
-    .join('\n')
-    .trim()
-}
-
-/**
- * JSDoc, що передує позиції `start` у джерелі (або порожній рядок).
- * @param {string} src вміст файлу
- * @param {number} start зміщення початку декларації
- * @returns {string} очищений опис
- */
-function precedingDoc(src, start) {
-  const m = src.slice(0, start).match(JSDOC_BEFORE_RE)
-  return cleanDoc(m ? m[0] : '')
-}
-
-/**
- * Імʼя функції, що викликається (проста Identifier або `obj.method`).
- * @param {Record<string, unknown>} node CallExpression
- * @returns {string|null} імʼя callee або null
- */
-function calleeName(node) {
-  const c = node.callee
-  if (!c || typeof c !== 'object') return null
-  if (c.type === 'Identifier') return c.name
-  if (c.type === 'MemberExpression' && !c.computed && c.property?.type === 'Identifier') return c.property.name
-  return null
-}
-
-/**
- * Множина імен, що викликаються у тілі вузла (сирі callee — фільтрація на ребра
- * call-graph робиться у `extractUnitsJs` після збору всіх імен юнітів).
- * @param {unknown} node AST-вузол юніта
- * @returns {Set<string>} імена викликів
- */
-function collectCalls(node) {
-  const names = new Set()
-  walkAstWithAncestors(node, [], n => {
-    if (n.type !== 'CallExpression') {
-      return
-    }
-
-    const name = calleeName(n)
-    if (name) names.add(name)
-  })
-  return names
-}
-
-/**
- * Будує юніт із декларації, додає у `units`. Розпізнає function/class та
- * const-функції (`const x = () => {}` / `function expression`).
- * @param {Record<string, unknown>} decl декларація (function/class/variable)
- * @param {boolean} exported чи експортується
- * @param {number} docStart зміщення для пошуку JSDoc (зовнішній export-вузол)
- * @param {string} src вміст файлу
- * @param {Array<object>} units акумулятор
- * @returns {void}
- */
-function pushUnits(decl, exported, docStart, src, units) {
-  if (!decl || typeof decl !== 'object') return
-  const doc = precedingDoc(src, docStart)
-  if (decl.type === 'FunctionDeclaration' || decl.type === 'ClassDeclaration') {
-    const name = decl.id?.name
-    if (!name) return
-    units.push({
-      name,
-      kind: decl.type === 'ClassDeclaration' ? 'class' : 'function',
-      exported,
-      span: { start: decl.start, end: decl.end },
-      body: src.slice(decl.start, decl.end),
-      calls: collectCalls(decl),
-      doc
-    })
-    return
-  }
-  if (decl.type === 'VariableDeclaration') {
-    for (const d of decl.declarations ?? []) {
-      const init = d.init
-      const isFn = init && (init.type === 'ArrowFunctionExpression' || init.type === 'FunctionExpression')
-      if (!isFn || d.id?.type !== 'Identifier') continue
-      units.push({
-        name: d.id.name,
-        kind: 'const',
-        exported,
-        span: { start: init.start, end: init.end },
-        body: src.slice(init.start, init.end),
-        calls: collectCalls(init),
-        doc
-      })
-    }
-  }
-}
-
-/**
- * Юніт-шар для js/mjs/ts: top-level функції/класи/const-функції з тілом, JSDoc,
- * прапором експорту і ребрами call-graph (виклики ІНШИХ юнітів у тілі).
- * @param {string} src вміст файлу
- * @param {string} [relPath] шлях (для вибору мови oxc)
- * @returns {Array<{name:string, kind:string, exported:boolean, span:{start:number,end:number}, body:string, calls:string[], doc:string}>|null} юніти або null, якщо файл не парситься
- */
-export function extractUnitsJs(src, relPath = 'scan.ts') {
-  const program = parseProgramOrNull(src, relPath)
-  if (!program || !Array.isArray(program.body)) return null
-
-  const units = []
-  for (const node of program.body) {
-    const isExport =
-      (node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration') && node.declaration
-    if (isExport) {
-      pushUnits(node.declaration, true, node.start, src, units)
-    } else {
-      pushUnits(node, false, node.start, src, units)
-    }
-  }
-
-  // Ребра call-graph: лишаємо тільки виклики інших внутрішніх юнітів
-  const names = new Set(units.map(u => u.name))
-  for (const u of units) u.calls = [...u.calls].filter(n => names.has(n) && n !== u.name)
-  return units
-}

package/rules/js/check/check.mdc

@@ -1,26 +0,0 @@
-## `for...in` заборонено — рефакторити на `for...of`
-
-Конструкція `for (const k in obj)` обходить успадковані ключі прототипу, тому майже завжди тягне `Object.hasOwn(obj, k)`-guard. Заборонена у `@nitra/eslint-config` через `no-restricted-syntax` для `ForInStatement` (з версії **3.8.0**). У каноні oxlint (`guard-for-in: "deny"` у [oxlint-canonical.json](../tooling/data/tooling/oxlint-canonical.json)) лишається `guard-for-in` як часткова страховка (oxlint не підтримує `no-restricted-syntax`) — `checkOxlintRc` у `check/main.mjs` звіряє `.oxlintrc.json` проєкту з цим каноном.
-
-Замість цього обходь масив напряму, а об'єкт — через `Object.entries` / `Object.keys` / `Object.values`. У такому коді guard за `Object.hasOwn` стає непотрібним і має зникнути разом із `for...in`.
-
-```javascript title="❌ до"
-for (const k in obj) {
-  if (!Object.hasOwn(obj, k)) continue
-  use(k, obj[k])
-}
-
-for (const i in arr) {
-  use(arr[i])
-}
-```
-
-```javascript title="✅ після"
-for (const [k, v] of Object.entries(obj)) {
-  use(k, v)
-}
-
-for (const item of arr) {
-  use(item)
-}
-```

package/rules/js/check/concern.json

@@ -1,19 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "lint": {
-    "scope": "full",
-    "glob": [
-      "eslint.config.js",
-      "eslint.config.mjs",
-      "**/package.json",
-      ".oxlintrc.json",
-      ".github/workflows/lint-js.yml",
-      ".github/workflows/lint.yml",
-      "knip.json",
-      ".eslintrc",
-      ".eslintrc.js",
-      ".eslintrc.json",
-      ".eslintrc.yml"
-    ]
-  }
-}

package/rules/js/check/docs/eslint-config.md

@@ -1,56 +0,0 @@
----
-type: JS Module
-title: eslint-config.mjs
-resource: npm/rules/js/check/eslint-config.mjs
-docgen:
-  crc: 6626a862
-  model: manual
----
-
-## Огляд
-
-Детекція воркспейс-типів (node/vue) репозиторію і чистий (read-only) планувальник
-scaffold/merge для `eslint.config.js` consumer-репо. Спільне джерело правди для
-detector-а `main.mjs` (перевірка, що кожен vue-воркспейс присутній у `vue: [...]`
-аргументах `getConfig`) і T0-фіксера `fix-check.mjs` (детерміноване створення або
-хірургічне оновлення конфігу — без повного перезапису файлу).
-
-## Поведінка
-
-- Тип воркспейсу визначається за root `package.json`: записи `workspaces`
-  (glob-и типу `packages/*` розгортаються у наявні директорії); воркспейс — vue,
-  якщо його `package.json` має `vue`/`nuxt` у deps або в ньому є хоч один `.vue`
-  файл (`node_modules`/`dist` ігноруються). Без `workspaces` класифікується сам
-  корінь як `.`.
-- Merge наявного конфігу — хірургічний: додає відсутній `**/auto-imports.d.ts`
-  у перший `ignores: [...]`, вставляє відсутні vue-воркспейси у `vue: [...]`
-  (або нову властивість одразу після `getConfig({`), вилучає ці ж воркспейси з
-  `node: [...]`. Кастомні ignores, overrides і коментарі не змінюються.
-- Fail-safe: якщо структура конфігу не розпізнається (немає `getConfig({`),
-  файл не чіпається — порушення лишається для ручного розгляду.
-
-## Публічний API
-
-- `detectWorkspaceTypes(cwd)` → `{ node: string[], vue: string[] }` — директорії
-  за типами.
-- `parseVueList(raw)` → нормалізовані записи `vue: [...]` з тексту конфігу.
-- `renderEslintConfigScaffold(types)` → повний шаблон `eslint.config.js`
-  (лише непорожні типи).
-- `mergeEslintConfig(raw, types)` → новий вміст (`=== raw`, якщо merge
-  неможливий чи не потрібен).
-- `planEslintConfigFix(cwd)` → `{ path, content, message } | null` — ідемпотентний
-  план для T0 (`null` на виправленому дереві).
-- Константи reason-ів: `ESLINT_CONFIG_MISSING`, `ESLINT_CONFIG_IGNORES`,
-  `ESLINT_CONFIG_VUE_WORKSPACE`; `AUTO_IMPORTS_IGNORE`.
-
-## Де використовується
-
-- `npm/rules/js/check/main.mjs` — detector (reason-и порушень, перевірка
-  vue-воркспейсів).
-- `npm/rules/js/check/fix-check.mjs` — T0-фіксер (виконання плану).
-
-## Гарантії поведінки
-
-- Read-only: модуль лише читає ФС і повертає план; запис виконує викликач.
-- Ідемпотентність: повторний `planEslintConfigFix` на виправленому дереві → `null`.
-- Биті/відсутні JSON-файли не кидають виняток (повертається `null`-об'єкт).

package/rules/js/check/docs/fix-check.md

@@ -1,48 +0,0 @@
----
-type: JS Module
-title: fix-check.mjs
-resource: npm/rules/js/check/fix-check.mjs
-docgen:
-  crc: 48182147
-  model: manual
----
-
-## Огляд
-
-T0-autofix для `js/check`: два детерміновані патерни, обидва без LLM.
-
-- `js-check-eslint-config` — scaffold/merge `eslint.config.js` за планом
-  `planEslintConfigFix` (детекція воркспейс-типів node/vue). Раніше ці
-  порушення йшли у LLM-ладдер, який переписував конфіг цілком і вгадував типи
-  (інцидент: у vue-монорепо записано `getConfig({ node: ['npm'] })` — eslint
-  перестав обробляти .vue файли).
-- `js-check-oxlintrc` — scaffold/merge `.oxlintrc.json` за планом
-  `planOxlintrcFix` (`../tooling/main.mjs`). Раніше ці порушення теж йшли у
-  LLM-ладдер: 15 КБ канону дешева модель не відтворює byte-perfect (verify
-  fail), а дорожча не встигає за один rung-таймаут.
-
-## Поведінка
-
-- `js-check-eslint-config` тригериться на reason-и `eslint-config-missing` /
-  `eslint-config-ignores` / `eslint-config-vue-workspace`. `apply` перераховує
-  план із поточного стану диска (ідемпотентно): відсутній конфіг —
-  створюється з детектованими типами; наявний — зазнає хірургічного merge, без
-  повного перезапису. Якщо план порожній (`null`) — жодних змін
-  (`touchedFiles: []`).
-- `js-check-oxlintrc` тригериться на reason-и `oxlintrc-missing` /
-  `oxlintrc-drift` (`OXLINTRC_MISSING` / `OXLINTRC_DRIFT` з `../tooling/main.mjs`).
-  `apply` читає наявний `.oxlintrc.json` (`null`, якщо відсутній або невалідний
-  JSON) і канон, будує злитий обʼєкт через `planOxlintrcFix` і перезаписує
-  файл цілком (JSON, 2-space, з кінцевим переносом рядка).
-- Решта порушень `js/check` (engines, workflows) — поза цим T0, стандартний
-  шлях (ladder/manual).
-- Обидва патерни викликають `ctx.recordWrite` перед записом (pre-image для
-  central rollback).
-
-## Гарантії поведінки
-
-- `js-check-eslint-config` записує лише `eslint.config.js`/`eslint.config.mjs`
-  у корені репо; наявний конфіг ніколи не перезаписується цілком — тільки
-  точкові вставки/заміни.
-- `js-check-oxlintrc` записує лише `.oxlintrc.json` у корені репо; результат
-  завжди проходить `verifyOxlintRcAgainstCanonical` без ручного втручання.