@7n/rules 1.0.0

package/rules/js/dep-policy/docs/main.md

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js/dep-policy/main.mjs
+docgen:
+  crc: 12ae4636
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл сканує всі JS/TS-файли у поточному робочому каталозі, виключаючи конфігураційно визначені шляхи. Завдяки публічній функції main, він перевіряє відповідність усіх імпортів у коді політиці залежностей, визначеній у dep-policy.mdc. Ця **read-only** операція виявляє та фіксує будь-які імпорти, заборонені в dep-policy.mdc, надаючи підказки заміни з js.mdc. Механізм працює з fail-safe принципом, перехоплюючи помилки та не дозволяючи виняткам виходити назовні.
+
+## Поведінка
+
+Поведінка:
+
+1. Виконується функція main.
+2. Аналізуються всі JS/TS-файли у поточному робочому каталозі, виключаючи шляхи, визначені конфігурацією.
+3. Для кожного файлу витягуються всі імпорти (статичні, динамічні та виклики require).
+4. Знаходяться імпорти, які знаходяться у списку заборонених especifiers (dep-policy.mdc).
+5. Якщо знайдений імпорт заборонений, реєструється помилка, яка вказує на шлях до файлу, заборонений імпорт та підказку про його заміну (js.mdc).
+6. Після перевірки всіх файлів, якщо заборонених імпортів не знайдено, реєструється повідомлення про успішне завершення перевірки.
+
+## Публічний API
+
+main — перевіряє імпорти у файлах JavaScript та TypeScript на відповідність політиці залежностей.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/js/dep-policy/main.mjs

@@ -0,0 +1,99 @@
+/** @see ./docs/dep-policy.md */
+import { readFile } from 'node:fs/promises'
+import { relative } from 'node:path'
+
+import { parseSync } from 'oxc-parser'
+
+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 {
+  dynamicImportModule,
+  langFromPath,
+  requireCallModule,
+  walkAstWithAncestors
+} from '../../../scripts/utils/ast-scan-utils.mjs'
+
+const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
+
+/**
+ * Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі.
+ * Ключ — specifier, значення — підказка про заміну.
+ */
+const BANNED_SPECIFIERS = new Map([
+  ['@nitra/as-integrations-fastify', 'використовуй @as-integrations/fastify'],
+  [
+    'ua-parser-js',
+    'замінити на bowser (MIT, ~6 KB) — npm i bowser. ua-parser-js v2 змінив ліцензію на AGPL-3.0, несумісну з комерційним використанням'
+  ]
+])
+
+/**
+ * Витягає з джерела всі import-specifier'и (static + dynamic + require).
+ * @param {string} source текст файлу
+ * @param {string} filePath шлях до файлу (для вибору мови OXC-парсера)
+ * @returns {string[]} список specifier'ів
+ */
+function extractImportSpecifiers(source, filePath) {
+  /** @type {string[]} */
+  const result = []
+  let parsed
+  try {
+    parsed = parseSync(filePath, source, { lang: langFromPath(filePath) })
+  } catch {
+    return result
+  }
+  for (const imp of parsed?.module?.staticImports ?? []) {
+    if (typeof imp?.moduleRequest?.value === 'string') result.push(imp.moduleRequest.value)
+  }
+  const program = parsed?.program
+  if (program && typeof program === 'object') {
+    walkAstWithAncestors(program, [], node => {
+      const dyn = dynamicImportModule(node)
+      if (dyn !== null) result.push(dyn)
+      const req = requireCallModule(node)
+      if (req !== null) result.push(req)
+    })
+  }
+  return result
+}
+
+/**
+ * Сканує всі JS/TS-файли проєкту на заборонені import-specifier'и (dep-policy.mdc).
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} Результат лінту з переліком порушень.
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const cwd = ctx.cwd
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  const files = []
+  await walkDir(
+    cwd,
+    p => {
+      if (JS_SOURCE_RE.test(p)) files.push(p)
+    },
+    ignorePaths
+  )
+
+  let violations = 0
+  for (const absPath of files) {
+    const source = await readFile(absPath, 'utf8')
+    const specifiers = extractImportSpecifiers(source, absPath)
+    for (const spec of specifiers) {
+      const hint = BANNED_SPECIFIERS.get(spec)
+      if (hint !== undefined) {
+        const rel = relative(cwd, absPath)
+        reporter.fail(`${rel}: заборонений import '${spec}' — ${hint} (js.mdc dep-policy)`)
+        violations += 1
+      }
+    }
+  }
+
+  if (violations === 0) {
+    reporter.pass(`dep-policy: перевірено ${files.length} файлів — заборонених import-specifier'ів немає (js.mdc)`)
+  }
+
+  return reporter.result()
+}

package/rules/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/js
+resource: npm/rules/js/
+---
+
+# npm/rules/js
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/js/eslint/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "per-file",
+    "glob": ["**/*.{js,mjs,cjs,jsx,ts,tsx,vue}"]
+  }
+}

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

@@ -0,0 +1,32 @@
+---
+type: JS Module
+title: fix-eslint.mjs
+resource: npm/rules/js/eslint/fix-eslint.mjs
+docgen:
+  crc: e354d939
+---
+
+## Огляд
+
+T0-autofix для `js/eslint`: детермінований прогін лінтерів у fix-режимі
+(`oxlint --fix` + `eslint --fix`) по файлах, де детектор знайшов порушення. Виправляє лише
+авто-fixable правила; усе інше лишається детектору на повторну перевірку, а далі — LLM-ладдеру.
+Запис незворотний (поза rollback).
+
+## Поведінка
+
+- Збирає унікальні файли з порушень концерну, лишає лише js-сімейство (`.mjs/.cjs/.js/.jsx/.ts/.tsx/.vue`).
+- Послідовно застосовує `oxlint --fix` (CLI) і `eslint --fix` (через API з `outputFixes`).
+- До списку змінених потрапляють лише файли, чий вміст фактично змінився (порівняння до/після).
+
+## Публічний API
+
+- `patterns` — масив T0-патернів (`id` / `test` / `apply`), що його споживає центральний fix-pipeline.
+  Єдиний патерн `js-eslint-autofix` спрацьовує, якщо є порушення з прив'язкою до файлу.
+
+## Гарантії поведінки
+
+- Якщо серед порушень немає js-файлів — лінтери не запускаються, змін немає.
+- Повертаються лише фактично змінені файли; перед записом кожен реєструється через `recordWrite`.
+- Межа CI: модуль належить fix-фазі; у `--no-fix` (CI) не запускається — узгоджено із
+  забороною `oxlint --fix`/`eslint --fix` у CI.

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

@@ -0,0 +1,33 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js/eslint/main.mjs
+docgen:
+  crc: 11a1340b
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей файл надає публічний інтерфейс для валідації коду, використовуючи інструменти Oxlint та ESLint. Він дозволяє визначати набір JavaScript-файлів для аналізу через функцію `filterJsFiles` та виконувати сам процес лінтингу за допомогою функції `lint`. Компонент є read-only, оскільки не здійснює змін до файлової системи чи баз даних. У разі виявлення помилок, механізм забезпечує fail-safe режим, перехоплюючи їх та не викликаючи винятків назовні.
+
+## Поведінка
+
+Поведінка:
+filterJsFiles фільтрує список вказаних файлів, залишаючи лише ті, що відповідають розширенням JavaScript.
+lint запускає лінтинг для файлів. Якщо передаються файли, він аналізує їх на наявність порушень; якщо не передані, він виконує повний аналіз проекту.
+
+## Публічний API
+
+filterJsFiles — відбирає файли для подальшої обробки.
+lint — проводить статичний аналіз коду (пофайлово або по всьому проєкту).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+
+**warnIgnored: false.** ESLint конструюється з `warnIgnored: false` — файли з delta-списку, що матчать ignore-патерни `eslint.config.js` (наприклад, синковані `.pi/extensions/**` чи згенеровані `npm/types/**`), не рахуються порушеннями.

package/rules/js/eslint/fix-eslint.mjs

@@ -0,0 +1,77 @@
+/** @see ./docs/fix-eslint.md */
+
+/**
+ * T0-autofix для `js/eslint` — детермінований прогін лінтерів у fix-режимі
+ * (`oxlint --fix` + `eslint --fix`) на файлах, де детектор знайшов порушення.
+ * Виправляє лише авто-fixable правила; решта лишається детектору на re-check
+ * (далі — LLM-ладдер). Запис permanent (поза rollback).
+ *
+ * Межа CI: цей модуль — частина fix-фази (`lint` без `--no-fix`); сам по собі
+ * detector-шлях його не вантажить. У CI (`--no-fix`) fix не запускається —
+ * узгоджено із забороною `oxlint --fix`/`eslint --fix` у CI (js.mdc / lint_js_yml).
+ */
+import { spawnSync } from 'node:child_process'
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+
+import { ESLint } from 'eslint'
+
+import { filterJsFiles } from './main.mjs'
+
+/**
+ * Вміст файлу або null, якщо не читається (видалений/недоступний).
+ * @param {string} abs абсолютний шлях
+ * @returns {string|null} вміст або null
+ */
+function readOrNull(abs) {
+  try {
+    return readFileSync(abs, 'utf8')
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Прогін `oxlint --fix` + `eslint --fix` по списку js-файлів. Повертає абсолютні
+ * шляхи фактично змінених файлів (порівняння до/після).
+ * @param {string[]} jsFiles posix-relative js-файли
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи змінених файлів
+ */
+async function runLinterFix(jsFiles, cwd) {
+  const abs = jsFiles.map(f => resolve(cwd, f))
+  const before = new Map(abs.map(a => [a, readOrNull(a)]))
+
+  // oxlint --fix (CLI): авто-fixable oxc-правила.
+  spawnSync('bunx', ['oxlint', '--fix', ...jsFiles], { cwd, encoding: 'utf8' })
+
+  // eslint --fix (API): outputFixes пише виправлені файли на диск.
+  const eslint = new ESLint({ cwd, fix: true })
+  const results = await eslint.lintFiles(abs)
+  await ESLint.outputFixes(results)
+
+  /** @type {string[]} */
+  const touched = []
+  for (const a of abs) {
+    if (readOrNull(a) !== before.get(a)) touched.push(a)
+  }
+  return touched
+}
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'js-eslint-autofix',
+    test: violations => violations.some(v => v.file),
+    apply: async (violations, ctx) => {
+      const files = [...new Set(violations.map(v => v.file).filter(Boolean))]
+      const jsFiles = filterJsFiles(files)
+      if (jsFiles.length === 0) return { touchedFiles: [] }
+      const touchedFiles = await runLinterFix(jsFiles, ctx.cwd)
+      for (const a of touchedFiles) ctx.recordWrite?.(a)
+      return touchedFiles.length > 0
+        ? { touchedFiles, message: `oxlint/eslint --fix: ${touchedFiles.length} файл(ів)` }
+        : { touchedFiles: [] }
+    }
+  }
+]

package/rules/js/eslint/main.mjs

@@ -0,0 +1,99 @@
+/**
+ * lint-поверхня js/eslint: read-only detector (oxlint + eslint). Fix (oxlint --fix /
+ * eslint --fix) — окремий T0 `fix-eslint.mjs` (детермінований), не в detector-і.
+ */
+import { resolve, relative } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+import { ESLint } from 'eslint'
+
+import { addedLinesByFile } from '../../../scripts/lib/diff-added-lines.mjs'
+import { classifyFindings, eslintResultsToFindings, parseOxlint } from '../lint-findings/main.mjs'
+
+const JS_EXT_RE = /\.(?:mjs|cjs|js|jsx|ts|tsx|vue)$/u
+const JSON_MAX_BUFFER = 64 * 1024 * 1024
+
+/**
+ * @param {string[]} files список шляхів
+ * @returns {string[]} лише JS-подібні файли
+ */
+export function filterJsFiles(files) {
+  return files.filter(f => JS_EXT_RE.test(f))
+}
+
+/**
+ * @param {string[]} args аргументи запуску oxlint
+ * @param {string} cwd робочий каталог
+ * @returns {{ status: number, stdout: string }} код завершення й stdout процесу
+ */
+function runOxlintJson(args, cwd) {
+  const r = spawnSync('bunx', args, { cwd, encoding: 'utf8', maxBuffer: JSON_MAX_BUFFER })
+  return { status: typeof r.status === 'number' ? r.status : 1, stdout: r.stdout ?? '' }
+}
+
+/**
+ * Finding → LintViolation.
+ * @param {{ file: string, line: number, rule: string, message: string, tool: string }} f знахідка лінтера
+ * @param {string} cwd робочий каталог
+ * @param {'error'|'warn'} severity рівень порушення
+ * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintViolation} нормалізоване порушення
+ */
+function toViolation(f, cwd, severity) {
+  return /** @type {import('../../../scripts/lib/lint-surface/types.mjs').LintViolation} */ ({
+    reason: f.rule || `${f.tool}-error`,
+    message: `${f.message} (${f.tool})`,
+    file: relative(cwd, f.file).split('\\').join('/'),
+    severity,
+    data: { line: f.line, tool: f.tool }
+  })
+}
+
+/**
+ * Збирає findings (oxlint json + eslint read-only) по заданих файлах або всьому проєкту.
+ * @param {string[]|null} js null → весь проєкт
+ * @param {string} cwd робочий каталог
+ * @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 })
+  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 oxRes = runOxlintJson(oxArgs, cwd)
+  const ox = parseOxlint(oxRes.stdout)
+  if (ox === null && oxRes.status !== 0) {
+    throw new Error('oxlint завершився з помилкою (не lint-порушення) — json не розпарсено')
+  }
+  return [...(ox ?? []), ...es]
+}
+
+/**
+ * Detector js/eslint: per-file (classify introduced/pre-existing) або full-project.
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} перелік порушень
+ */
+export async function lint(ctx) {
+  const { cwd, files } = ctx
+
+  if (files === undefined) {
+    const findings = await collectFindings(null, cwd)
+    return { violations: findings.map(f => toViolation(f, cwd, 'error')) }
+  }
+
+  const js = filterJsFiles(files)
+  if (js.length === 0) return { violations: [] }
+
+  const findings = await collectFindings(js, cwd)
+  if (findings.length === 0) return { violations: [] }
+
+  // introduced (на доданих рядках) → error; pre-existing → warn.
+  const classified = classifyFindings(findings, addedLinesByFile(js, cwd), cwd)
+  return {
+    violations: [
+      ...classified.introduced.map(f => toViolation(f, cwd, 'error')),
+      ...classified.preExisting.map(f => toViolation(f, cwd, 'warn'))
+    ]
+  }
+}

package/rules/js/jscpd_config/concern.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "policy": {
+    "files": {
+      "single": ".jscpd.json",
+      "required": true
+    },
+    "missingMessage": ".jscpd.json не існує — створи з полями згідно js.mdc"
+  }
+}

package/rules/js/jscpd_config/jscpd_config.mdc

@@ -0,0 +1,14 @@
+## Rego-gate `.jscpd.json`
+
+Rego-пакет: `js_lint.jscpd`
+
+Цільовий файл: `.jscpd.json` у корені проєкту.
+
+Що перевіряється:
+
+- `gitignore` — точна відповідність (`true`)
+- `exitCode` — точна відповідність (`1`)
+- `reporters` — subset-of: масив має містити всі елементи з канону (`["console"]`)
+- `minLines` — число, значення >= канонічного порогу (`25`); більше дозволено
+
+Канон-snippet: [.jscpd.json.snippet.json](./template/.jscpd.json.snippet.json)

package/rules/js/jscpd_config/jscpd_config.rego

@@ -0,0 +1,44 @@
+# Перевірка `.jscpd.json` (js.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/.jscpd.json.snippet.json.
+# Особливості:
+#  - `reporters` — subset-of (масив string)
+#  - `minLines` — >= expected (semantic: дозволяється більше, не менше)
+#  - `gitignore`/`exitCode` — exact match
+package js.jscpd_config
+
+import rego.v1
+
+# Top-level scalar leafs (exact match) для gitignore + exitCode.
+deny contains msg if {
+	some key, expected_value in data.template.snippet
+	key != "minLines"
+	not is_array(expected_value)
+	actual := object.get(input, key, null)
+	actual != expected_value
+	msg := sprintf(".jscpd.json має містити \"%s\": %v (js.mdc)", [key, expected_value])
+}
+
+# Array subset-of для reporters.
+deny contains msg if {
+	some field, expected_values in data.template.snippet
+	is_array(expected_values)
+	actual_set := {v | some v in object.get(input, field, [])}
+	some required in expected_values
+	not required in actual_set
+	msg := sprintf(".jscpd.json має містити \"%s\": [\"%s\"] (js.mdc)", [field, required])
+}
+
+# minLines: must be number and >= expected.
+deny contains msg if {
+	expected := data.template.snippet.minLines
+	actual := object.get(input, "minLines", null)
+	not is_valid_min_lines(actual, expected)
+	msg := sprintf(".jscpd.json має містити \"minLines\" як число >= %d (js.mdc)", [expected])
+}
+
+is_valid_min_lines(actual, expected) if {
+	is_number(actual)
+	actual >= expected
+}

package/rules/js/jscpd_config/template/.jscpd.json.snippet.json

@@ -0,0 +1,7 @@
+{
+  "gitignore": true,
+  "exitCode": 1,
+  "reporters": ["console"],
+  "minLines": 25,
+  "ignore": [".claude/worktrees/**", "**/dist/**", "**/CHANGELOG.md"]
+}

package/rules/js/jscpd_duplicates/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "structural",
+  "lint": {
+    "scope": "full"
+  }
+}

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

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js/jscpd_duplicates/main.mjs
+docgen:
+  crc: 8480cba8
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Публічна функція `lint` аналізує вихідний код у вказаному кореневому каталозі, використовуючи `jscpd`, щоб виявляти дублікати та інші порушення стилю і логіки коду. Функція повертає код виходу, який інформує про успішне завершення аналізу чи виявлення проблем.
+
+## Поведінка
+
+1. Викликається функція `lint`, яка ініціює перевірку коду у вказаному кореневому каталозі з метою виявлення дублікатів.
+2. Процес аналізу виконується за допомогою `jscpd` у середовищі `bunx`.
+3. Функція повертає код завершення процесу: 0 у разі успішного виконання (без знайдених проблем) або інше число, що вказує на помилки.
+
+## Публічний API
+
+lint — виявляє дублікати коду за допомогою `bunx jscpd` у файлах JavaScript/JSCPD.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/js/jscpd_duplicates/main.mjs

@@ -0,0 +1,70 @@
+/**
+ * lint-поверхня js/jscpd_duplicates: read-only detector дублікатів коду (`jscpd`).
+ * Кожен клон → одне порушення (anchored на `firstFile`), із посиланням на `secondFile`
+ * у `data`. JSON-звіт пишеться у системний tmp (поза репо) — дерево не мутується.
+ */
+import { spawnSync } from 'node:child_process'
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+/**
+ * @typedef {{ name: string, start: number, end: number }} JscpdFileRef
+ * @typedef {{ firstFile: JscpdFileRef, secondFile: JscpdFileRef, lines: number, format: string }} JscpdClone
+ */
+
+/**
+ * Один клон → LintViolation.
+ * @param {JscpdClone} clone дубльований фрагмент
+ * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintViolation} нормалізоване порушення
+ */
+function cloneToViolation(clone) {
+  const a = clone.firstFile
+  const b = clone.secondFile
+  const aLoc = `${a.name}:${a.start}-${a.end}`
+  const bLoc = `${b.name}:${b.start}-${b.end}`
+  return /** @type {import('../../../scripts/lib/lint-surface/types.mjs').LintViolation} */ ({
+    reason: 'duplicate-clone',
+    message: `jscpd: дубльований фрагмент (${clone.lines} рядків, ${clone.format}) ${aLoc} ↔ ${bLoc}`,
+    file: a.name,
+    data: {
+      line: a.start,
+      lines: clone.lines,
+      format: clone.format,
+      first: { file: a.name, start: a.start, end: a.end },
+      second: { file: b.name, start: b.start, end: b.end }
+    }
+  })
+}
+
+/**
+ * Detector js/jscpd_duplicates: дублікати коду через `jscpd` (read-only).
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
+ * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} перелік порушень
+ */
+export function lint(ctx) {
+  const cwd = ctx.cwd
+  const outDir = mkdtempSync(join(tmpdir(), 'jscpd-'))
+  try {
+    const r = spawnSync('bunx', ['jscpd', '.', '--reporters', 'json', '--output', outDir, '--silent'], {
+      cwd,
+      encoding: 'utf8'
+    })
+    let report
+    try {
+      report = JSON.parse(readFileSync(join(outDir, 'jscpd-report.json'), 'utf8'))
+    } catch {
+      // jscpd не зміг сформувати звіт (інструмент відсутній / краш) — пропускаємо
+      const detail = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim().slice(0, 500)
+      const suffix = detail ? `: ${detail}` : ''
+      return {
+        violations: [],
+        diagnostics: [{ level: 'warn', message: `jscpd: не вдалося прочитати JSON-звіт${suffix}` }]
+      }
+    }
+    const clones = Array.isArray(report.duplicates) ? report.duplicates : []
+    return { violations: clones.map(clone => cloneToViolation(clone)) }
+  } finally {
+    rmSync(outDir, { recursive: true, force: true })
+  }
+}

package/rules/js/knip/concern.json

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

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

@@ -0,0 +1,32 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js/knip/main.mjs
+docgen:
+  crc: e44b88a8
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Аналізує проєкт на предмет невикористаних залежностей та експортів. Виконує операцію лише для читання, не змінюючи файлову систему чи базу даних. Публічна функція `lint` надає звіт про виявлені проблеми, який визначається за кодом виходу.
+
+## Поведінка
+
+1. Викликається функція `lint`.
+2. Система аналізує проект на предмет невикористаних залежностей та експортів.
+3. На основі збору виявлених проблем, система генерує звіт.
+4. Якщо знайдено хоча б одну проблему, функція повертає значення 1; інакше — 0.
+
+## Публічний API
+
+Я розумію завдання. Мені потрібно перетворити технічний опис на лаконічну, поведінкову документацію українською мовою у форматі маркерів, дотримуючись усіх зазначених обмежень.
+
+Будь ласка, надайте список, який потрібно переписати.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).