@7n/rules-lang-js 0.3.1 → 0.4.0

package/rules/js/lint-findings/main.mjs

@@ -0,0 +1,125 @@
+/** @see ./docs/lint-findings.md */
+import { isAbsolute, relative } from 'node:path'
+
+import { isIntroducedLine } from '@7n/rules/scripts/lib/diff-added-lines.mjs'
+
+/**
+ * @param {string} jsonText вивід `oxlint --format=json`
+ * @returns {{ file: string, line: number, rule: string, message: string, tool: string }[] | null} findings,
+ *   або `null` якщо json непарсабельний (краш/обрізаний вивід інструмента — НЕ «чисто»)
+ */
+export function parseOxlint(jsonText) {
+  let data
+  try {
+    data = JSON.parse(jsonText)
+  } catch {
+    return null
+  }
+  const diags = Array.isArray(data?.diagnostics) ? data.diagnostics : []
+  return diags
+    .filter(d => d?.filename)
+    .map(d => ({
+      file: d.filename,
+      line: d.labels?.[0]?.span?.line ?? 0,
+      rule: d.code ?? '',
+      message: d.message ?? '',
+      tool: 'oxlint'
+    }))
+}
+
+/**
+ * @param {string} jsonText вивід `eslint --format=json`
+ * @returns {{ file: string, line: number, rule: string, message: string, tool: string }[] | null} findings,
+ *   або `null` якщо json непарсабельний (краш/обрізаний вивід інструмента — НЕ «чисто»)
+ */
+export function parseEslint(jsonText) {
+  let data
+  try {
+    data = JSON.parse(jsonText)
+  } catch {
+    return null
+  }
+  const results = Array.isArray(data) ? data : []
+  const out = []
+  for (const r of results) {
+    for (const m of r?.messages ?? []) {
+      out.push({
+        file: r.filePath,
+        line: m.line ?? 0,
+        rule: m.ruleId ?? '(syntax)',
+        message: m.message ?? '',
+        tool: 'eslint'
+      })
+    }
+  }
+  return out.filter(f => f.file)
+}
+
+/**
+ * Конвертує результати ESLint programmatic API у нормалізовані findings.
+ * @param {import('eslint').ESLint.LintResult[]} results результати `eslint.lintFiles()`
+ * @returns {{ file: string, line: number, rule: string, message: string, tool: string }[]} findings
+ */
+export function eslintResultsToFindings(results) {
+  const out = []
+  for (const r of results) {
+    for (const m of r.messages) {
+      out.push({
+        file: r.filePath,
+        line: m.line ?? 0,
+        rule: m.ruleId ?? '(syntax)',
+        message: m.message ?? '',
+        tool: 'eslint'
+      })
+    }
+  }
+  return out.filter(f => f.file)
+}
+
+/**
+ * Розділяє findings на introduced / pre-existing за доданими рядками.
+ * @param {{ file: string, line: number }[]} findings нормалізовані findings
+ * @param {Map<string, Set<number> | string>} addedLines з `addedLinesByFile`
+ * @param {string} [cwd] корінь (для нормалізації абсолютних шляхів у relative)
+ * @returns {{ introduced: object[], preExisting: object[] }} класифікація
+ */
+export function classifyFindings(findings, addedLines, cwd = process.cwd()) {
+  const introduced = []
+  const preExisting = []
+  for (const f of findings) {
+    const rel = isAbsolute(f.file) ? relative(cwd, f.file) : f.file
+    if (isIntroducedLine(addedLines, rel, f.line)) introduced.push(f)
+    else preExisting.push(f)
+  }
+  return { introduced, preExisting }
+}
+
+/**
+ * Рядок одного finding: `<rel>:<line>  <rule>  <message>`.
+ * @param {{ file: string, line: number, rule: string, message: string }} f finding
+ * @param {string} cwd корінь
+ * @returns {string} рядок
+ */
+function formatFinding(f, cwd) {
+  const rel = isAbsolute(f.file) ? relative(cwd, f.file) : f.file
+  return `     ${rel}:${f.line}  ${f.rule}  ${f.message}`
+}
+
+/**
+ * Згрупований звіт: 🆕 introduced (виправ) + 🗄 pre-existing (борг файлу).
+ * @param {{ introduced: object[], preExisting: object[] }} classified результат `classifyFindings`
+ * @param {string} [cwd] корінь
+ * @returns {string} текст звіту
+ */
+export function renderFindings({ introduced, preExisting }, cwd = process.cwd()) {
+  const lines = []
+  if (introduced.length > 0) {
+    lines.push(`  🆕 introduced (${introduced.length}) — внесено цією зміною, виправ:`)
+    for (const f of introduced) lines.push(formatFinding(f, cwd))
+  }
+  if (preExisting.length > 0) {
+    lines.push(`  🗄 pre-existing (${preExisting.length}) — борг файлу, не з цієї зміни:`)
+    for (const f of preExisting) lines.push(formatFinding(f, cwd))
+  }
+  return lines.join('\n')
+}

package/rules/js/main.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] } }

package/rules/js/main.mdc

@@ -0,0 +1,18 @@
+---
+description: Перевірка JavaScript коду
+globs: "**/{.oxlintrc.json,eslint.config.js,.jscpd.json,knip.json,package.json},**/*.{js,mjs,cjs,jsx,ts,tsx}"
+alwaysApply: false
+version: '1.31'
+---
+
+**oxlint**, **ESLint**, **jscpd**, **knip**. Запуск — **`n-rules lint js`** (локально; у CI — `--no-fix`, без **`--fix`** для oxlint/eslint). Без **prettier** і **@nitra/prettier-config**.
+
+`eslint.config.js` — flat config з `getConfig` (`@nitra/eslint-config`). Аргументи `node: [...]`/`vue: [...]` мають відповідати воркспейс-типам репо (`workspaces` root `package.json`; vue-воркспейс = Vue-залежність у deps або `.vue` файли) — інакше `.vue` файли не парсяться. Відсутній конфіг створюється (scaffold), наявний — зазнає хірургічного merge (fix не перезаписує файл цілком).
+
+## Швидкий gate через conftest
+
+Rego-пакети — запускаються `npx @7n/rules lint js` або `conftest`:
+
+- [.jscpd.json.snippet.json](./jscpd_config/template/.jscpd.json.snippet.json)
+- [extensions.json.snippet.json](./vscode_extensions/template/extensions.json.snippet.json)
+- [package.json.snippet.json](./package_json/template/package.json.snippet.json)

package/rules/js/package_json/concern.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "policy": {
+    "files": {
+      "single": "package.json"
+    }
+  }
+}

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

@@ -0,0 +1,25 @@
+---
+type: JS Module
+title: fix-package_json.mjs
+resource: plugins/lang-js/rules/js/package_json/fix-package_json.mjs
+docgen:
+  crc: e7e3caa7
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` забезпечує перевірку й звірку `package.json` з очікуваним шаблоном цього проєкту. Модуль читає `package.json` як основний конфіг, на який спирається код, і використовується для оцінки відповідності структури та вмісту файла вимогам проєкту. Робота read-only: змін у файловій системі чи базі даних не вносить.
+
+## Поведінка
+
+1. `patterns` надає набір правил, які приводять `package.json` до очікуваного шаблону для цього проєкту.
+2. Кожне правило орієнтується на конфігурацію `package.json` і застосовується до нього як до цільового файлу.
+3. `patterns` використовується як публічна точка входу для перевірки й вирівнювання структури `package.json` без змін у файловій системі чи базі даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/js/package_json/docs/index.md

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

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

@@ -0,0 +1,3 @@
+import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
+
+export const patterns = [createTemplateFixPattern({ id: 'js-package_json-template', targetPath: 'package.json' })]

package/rules/js/package_json/package_json.mdc

@@ -0,0 +1,15 @@
+## Rego-gate `package.json`
+
+Rego-пакет: `js_lint.package_json`
+
+Цільовий файл: `package.json` (корінь і workspace-пакети).
+
+Що перевіряється:
+
+- `"type"` — точна відповідність `"module"` (з канон-snippet)
+- `scripts.lint-js` — нормалізована точна відповідність (collapse whitespace)
+- `engines.node` — semver-парсинг: major >= 24 (inverse, без template)
+- `engines.bun` — semver-парсинг: >= 1.3 (inverse, без template)
+- `devDependencies["@nitra/eslint-config"]` — наявність ключа + semver >= порогу зі snippet (`^3.10.0`); `workspace:*` завжди проходить
+
+Канон-snippet: [package.json.snippet.json](./template/package.json.snippet.json)

package/rules/js/package_json/package_json.rego

@@ -0,0 +1,142 @@
+# Перевірка `package.json` (js.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/package.json.snippet.json
+# (canonical `type` + `scripts.lint-js` + `devDependencies.@nitra/eslint-config` як мін-поріг).
+#
+# Мінімальна версія `@nitra/eslint-config` — ЄДИНЕ джерело в snippet
+# (`devDependencies.@nitra/eslint-config`); rego лише парсить поріг і робить semver-порівняння.
+#
+# Логіка, що ЛИШАЄТЬСЯ у rego (inverse, без template-значення):
+#  - `engines.node` >= 24, `engines.bun` >= 1.3 (semver range parsing).
+package js.package_json
+
+import rego.v1
+
+# ── deny: top-level scalar leafs (type) ─────────────────────────────────
+
+banned_fastify_pkg := "@nitra/as-integrations-fastify"
+
+deny contains msg if {
+	some key, expected_value in data.template.snippet
+	not is_object(expected_value)
+	actual := object.get(input, key, null)
+	actual != expected_value
+	msg := sprintf("package.json: \"%s\" має бути %q (js.mdc)", [key, expected_value])
+}
+
+# ── deny: scripts (nested) — exact match із normalize ──────────────────
+
+deny contains msg if {
+	some script_name, expected in data.template.snippet.scripts
+	actual := object.get(object.get(input, "scripts", {}), script_name, "")
+	normalize_script(actual) != expected
+	msg := sprintf("package.json: scripts.%s має бути %q (js.mdc)", [script_name, expected])
+}
+
+# ── deny: engines.node >= 24 (inverse, у rego) ──────────────────────────
+
+deny contains msg if {
+	engines := object.get(input, "engines", {})
+	not engines_node_meets(object.get(engines, "node", ""))
+	msg := "package.json: engines.node має бути >= 24 (js.mdc)"
+}
+
+deny contains msg if {
+	engines := object.get(input, "engines", {})
+	not engines_bun_meets(object.get(engines, "bun", ""))
+	msg := "package.json: engines.bun має бути >= 1.3 (js.mdc)"
+}
+
+# ── deny: @nitra/eslint-config >= snippet-поріг ─────────────────────────
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	not "@nitra/eslint-config" in object.keys(dev)
+	msg := "package.json: відсутній @nitra/eslint-config у devDependencies (js.mdc)"
+}
+
+deny contains msg if {
+	range := object.get(object.get(input, "devDependencies", {}), "@nitra/eslint-config", "")
+	range != ""
+	not eslint_config_meets_min(range)
+	msg := sprintf("package.json: @nitra/eslint-config має бути >= %s (зараз %q) (js.mdc)", [eslint_min_display, range])
+}
+
+# ── deny: @nitra/as-integrations-fastify заборонений (dep-policy.mdc) ───
+
+deny contains msg if {
+	deps := object.get(input, "dependencies", {})
+	banned_fastify_pkg in object.keys(deps)
+	msg := sprintf("package.json: dependencies.%s заборонений — використовуй @as-integrations/fastify (js.mdc dep-policy)", [banned_fastify_pkg])
+}
+
+deny contains msg if {
+	deps := object.get(input, "peerDependencies", {})
+	banned_fastify_pkg in object.keys(deps)
+	msg := sprintf("package.json: peerDependencies.%s заборонений — використовуй @as-integrations/fastify (js.mdc dep-policy)", [banned_fastify_pkg])
+}
+
+# ── helpers ──────────────────────────────────────────────────────────────
+
+# Канонічний мін-поріг `@nitra/eslint-config` із snippet (напр. "^3.10.0").
+eslint_min_range := object.get(object.get(data.template.snippet, "devDependencies", {}), "@nitra/eslint-config", "")
+
+# Поріг для повідомлення без діапазонних префіксів (напр. "3.10.0").
+eslint_min_display := trim_left(eslint_min_range, "^~>=v ")
+
+normalize_script(s) := regex.replace(trim_space(s), `\s+`, " ")
+
+engines_node_meets(spec) if {
+	major := first_major(spec)
+	major >= 24
+}
+
+engines_bun_meets(spec) if {
+	parts := split_to_numbers(spec)
+	count(parts) >= 2
+	parts[0] > 1
+}
+
+engines_bun_meets(spec) if {
+	parts := split_to_numbers(spec)
+	count(parts) >= 2
+	parts[0] == 1
+	parts[1] >= 3
+}
+
+eslint_config_meets_min(range) if startswith(trim_space(range), "workspace:")
+
+eslint_config_meets_min(range) if {
+	actual := split_to_numbers(range)
+	count(actual) >= 3
+	min_parts := split_to_numbers(eslint_min_range)
+	count(min_parts) >= 3
+	semver_gte(actual, min_parts)
+}
+
+# actual >= min_parts за major.minor.patch (лексикографічно).
+semver_gte(a, b) if a[0] > b[0]
+
+semver_gte(a, b) if {
+	a[0] == b[0]
+	a[1] > b[1]
+}
+
+semver_gte(a, b) if {
+	a[0] == b[0]
+	a[1] == b[1]
+	a[2] >= b[2]
+}
+
+first_major(spec) := major if {
+	parts := split_to_numbers(spec)
+	count(parts) >= 1
+	major := parts[0]
+}
+
+split_to_numbers(spec) := nums if {
+	tokens := regex.split(`\D+`, spec)
+	non_empty := [t | some t in tokens; t != ""]
+	nums := [n | some t in non_empty; n := to_number(t)]
+}

package/rules/js/package_json/template/package.json.snippet.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "devDependencies": {
+    "@nitra/eslint-config": "^3.10.0"
+  }
+}

package/rules/js/tooling/concern.json

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

package/rules/js/tooling/data/tooling/knip-canonical.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "entry": [
+    ".pi/extensions/**/*.ts",
+    "eslint.config.{js,mjs,cjs}",
+    "stylelint.config.{js,cjs,mjs}",
+    "oxlint.config.{js,mjs}",
+    "jscpd.config.{js,mjs}",
+    "markdownlint-cli2.config.{js,mjs,cjs,jsonc}",
+    ".markdownlint-cli2.{jsonc,cjs,mjs}",
+    "commitlint.config.{js,cjs,mjs}"
+  ],
+  "project": ["**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts}"],
+  "ignore": ["**/__fixtures__/**"],
+  "ignoreDependencies": ["@nitra/cspell-dict", "/@cspell\\/dict-.+/", "graphql"],
+  "ignoreBinaries": [
+    "actionlint",
+    "cspell",
+    "eslint",
+    "git-ai",
+    "jscpd",
+    "markdownlint-cli2",
+    "oxfmt",
+    "oxlint",
+    "shellcheck",
+    "uvx",
+    "v8r",
+    "zizmor"
+  ]
+}