@7n/rules 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.20.0] - 2026-07-18
+
+### Changed
+
+- Автодетект `@7n/rules-lang-rust` покриває монорепо: сигнал Cargo.toml шукається не лише в корені, а й у підтеках до 3 рівнів (обмежений BFS повз приховані/node_modules/target — дешево для hot-path hook) — Tauri-кейс `app/src-tauri/Cargo.toml` вмикає плагін без ручного `.n-rules.json`. Python лишається кореневим (uv-провайдер v1 обробляє тільки кореневий pyproject.toml)
+
+## [1.19.1] - 2026-07-18
+
+### Changed
+
+- експортовано `parseNRulesCmd` і `relevantDomains` з `scripts/lib/lint-surface/ci-plan.mjs` — спільні хелпери для fix-хендлерів автоміграції service-канону (ci-azure, ci-github), усунуто jscpd-дублікат
+
 ## [1.19.0] - 2026-07-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/scripts/lib/docs/resolve-plugins.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-plugins.mjs
 resource: npm/scripts/lib/resolve-plugins.mjs
 docgen:
-  crc: d1bfa8f2
+  crc: ab45e0ca
 ---
 
 Резолв плагінів @7n/rules: визначає, які пакети-плагіни активні у проєкті, де їхні `rules/`-каталоги, які capabilities вони надають і які handlers надають.

package/scripts/lib/lint-surface/ci-plan.mjs

@@ -14,7 +14,8 @@
  * `--base`-ref) — warning і ВСІ домени true (запускаємо більше, ніколи не
  * скіпаємо мовчки).
  */
-import { appendFileSync } from 'node:fs'
+import { appendFileSync, existsSync, statSync } from 'node:fs'
+import { resolve } from 'node:path'
 import { env } from 'node:process'
 
 import picomatch from 'picomatch'
@@ -29,6 +30,59 @@ const TEST_FILE_GLOBS = ['**/*.test.*', '**/*.spec.*', '**/test_*.py', '**/*_tes
 /** Зарезервовані ключі outputs — домен із таким ключем був би колізією. */
 const RESERVED_OUTPUT_KEYS = new Set(['any', 'has_tests', 'domains'])
 
+const WS_RE = /\s+/u
+
+/**
+ * Розбирає команду `n-rules lint …`/`n-rules ci plan …` токенами (без regex —
+ * стійко до багаторядкових script-ів і без бектрекінгу). Спільне для
+ * fix-хендлерів автоміграції service-канону (ci-azure, ci-github).
+ * @param {string} cmd повний текст команди кроку.
+ * @param {string} marker підрядок-початок (`n-rules lint` | `n-rules ci plan`).
+ * @returns {{ domain: string|null, path: string|null }|null} розбір або null, якщо маркера немає.
+ */
+export function parseNRulesCmd(cmd, marker) {
+  const at = cmd.indexOf(marker)
+  if (at === -1) return null
+  const tokens = cmd
+    .slice(at + marker.length)
+    .split(WS_RE)
+    .filter(Boolean)
+  let domain = null
+  let path = null
+  for (let i = 0; i < tokens.length; i++) {
+    const t = tokens[i]
+    if (t === '--path') {
+      path = tokens[i + 1] ?? null
+      i++
+      continue
+    }
+    if (!t.startsWith('-') && domain === null && path === null) domain = t
+  }
+  return { domain, path }
+}
+
+/**
+ * Релевантні домени сервісу: enabled-правила, чиї per-file glob-и матчать
+ * бодай один файл піддерева (та сама таблиця, що `ci plan` по не-дельті).
+ * Спільне для fix-хендлерів автоміграції service-канону (ci-azure, ci-github).
+ * @param {string} cwd корінь consumer-репо.
+ * @param {string} servicePath каталог сервісу.
+ * @returns {Promise<string[]>} відсортовані rule-id.
+ */
+export async function relevantDomains(cwd, servicePath) {
+  const abs = resolve(cwd, servicePath)
+  if (!existsSync(abs) || !statSync(abs).isDirectory()) return []
+  const files = await collectPathScopedFiles(cwd, servicePath)
+  const { byRule, enabledSet } = await loadEnabledLintRules({ cwd })
+  const active = computeActiveDomains(byRule, enabledSet, files)
+  return active
+    .entries()
+    .filter(([, st]) => st.triggered)
+    .map(([id]) => id)
+    .toArray()
+    .toSorted((a, b) => a.localeCompare(b))
+}
+
 /**
  * Rule-id → ключ output-змінної: `-` → `_` (GA/Azure не люблять дефіси в
  * іменах змінних; `npm-module` → `npm_module`). Експортовано для fix-хендлерів

package/scripts/lib/lint-surface/docs/ci-plan.md

@@ -3,7 +3,7 @@ type: JS Module
 title: ci-plan.mjs
 resource: npm/scripts/lib/lint-surface/ci-plan.mjs
 docgen:
-  crc: ce7f2a96
+  crc: 7df6d5b8
   model: openai-codex/gpt-5.4-mini
   score: 90
   issues: internal-name:computeActiveDomains,judge:inaccurate:0.99

package/scripts/lib/resolve-plugins.mjs

@@ -28,12 +28,55 @@ export const KNOWN_CI_PLUGINS = Object.freeze({
   azure: '@7n/rules-ci-azure'
 })
 
-/** Відомі мовні плагіни: файловий сигнал екосистеми в корені репо → npm-пакет. */
+/**
+ * Відомі мовні плагіни: файловий сигнал екосистеми → npm-пакет. `maxDepth` —
+ * до якої глибини шукати сигнал: python — лише корінь (uv-провайдер v1
+ * обробляє тільки кореневий pyproject.toml); rust — до 3 рівнів, бо в
+ * монорепо Cargo.toml часто вкладений (Tauri `app/src-tauri/Cargo.toml`),
+ * а провайдер обробляє всі знайдені маніфести.
+ */
 export const KNOWN_LANG_PLUGINS = Object.freeze({
-  python: { signal: 'pyproject.toml', pkg: '@7n/rules-lang-python' },
-  rust: { signal: 'Cargo.toml', pkg: '@7n/rules-lang-rust' }
+  python: { signal: 'pyproject.toml', pkg: '@7n/rules-lang-python', maxDepth: 0 },
+  rust: { signal: 'Cargo.toml', pkg: '@7n/rules-lang-rust', maxDepth: 3 }
 })
 
+/** Теки, у які неглибокий скан мовних сигналів не заходить (плюс усі приховані). */
+const LANG_SCAN_SKIP_DIRS = new Set(['node_modules', 'target', 'dist', 'coverage', 'build', 'vendor'])
+
+/**
+ * Чи є файл-сигнал у корені або підтеках до `maxDepth` рівнів — обмежений
+ * BFS-обхід (пропускає приховані теки, node_modules, target тощо), щоб
+ * лишатись дешевим на hot-path (hook викликається на кожен файл).
+ * @param {string} projectRoot корінь репозиторію
+ * @param {string} signal ім'я файлу-сигналу (напр. `Cargo.toml`)
+ * @param {number} maxDepth 0 — лише корінь; N — до N рівнів підтек
+ * @returns {boolean} true — сигнал знайдено
+ */
+function hasLangSignal(projectRoot, signal, maxDepth) {
+  let level = [projectRoot]
+  for (let depth = 0; depth <= maxDepth && level.length > 0; depth++) {
+    if (level.some(dir => existsSync(join(dir, signal)))) return true
+    if (depth < maxDepth) level = level.flatMap(listScannableSubdirs)
+  }
+  return false
+}
+
+/**
+ * Видимі підтеки для неглибокого скану (без прихованих і службових).
+ * @param {string} dir тека
+ * @returns {string[]} абсолютні шляхи підтек (порожньо, якщо нечитабельна)
+ */
+function listScannableSubdirs(dir) {
+  try {
+    return readdirSync(dir, { withFileTypes: true })
+      .filter(entry => entry.isDirectory() && !entry.name.startsWith('.') && !LANG_SCAN_SKIP_DIRS.has(entry.name))
+      .map(entry => join(dir, entry.name))
+  } catch {
+    /* нечитабельна тека — пропускаємо гілку */
+    return []
+  }
+}
+
 const WORKFLOW_YML_RE = /\.ya?ml$/u
 const GITHUB_URL_RE = /github\.com/iu
 const AZURE_URL_RE = /dev\.azure\.com|visualstudio\.com/iu
@@ -97,14 +140,14 @@ function detectCiPlugins(projectRoot) {
 /**
  * Автодетект плагінів за станом репозиторію: CI-плагіни (файлові сигнали з
  * fallback на `repository.url`) + мовні плагіни (лише файлові сигнали —
- * маніфест екосистеми в корені — pyproject.toml, кореневий Cargo.toml; URL-fallback для мов безглуздий).
+ * маніфест екосистеми в корені або, для rust, у підтеках до 3 рівнів; URL-fallback для мов безглуздий).
  * @param {string} projectRoot корінь репозиторію
  * @returns {string[]} npm-імена плагінів
  */
 export function detectPluginsFromRepo(projectRoot) {
   const out = detectCiPlugins(projectRoot)
-  for (const { signal, pkg } of Object.values(KNOWN_LANG_PLUGINS)) {
-    if (existsSync(join(projectRoot, signal))) out.push(pkg)
+  for (const { signal, pkg, maxDepth } of Object.values(KNOWN_LANG_PLUGINS)) {
+    if (hasLangSignal(projectRoot, signal, maxDepth)) out.push(pkg)
   }
   return out
 }