@7n/rules 1.21.0 → 1.23.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.23.0] - 2026-07-18
+
+### Changed
+
+- Фаза 4a spec lang-plugins-extraction: doc-files отримав мовний extension-point — розширення (`.rs` → 'Rust Module', `.py` → 'Python Module') декларуються в маніфесті плагіна (`contributes.docFiles.extensions`, синхронно для hot-path hook), екстрактори фактів/юнітів — handler-модулем (`contributes.handlers['doc-files']`, вантажиться лише на шляху генерації). Rust-екстрактори (extractFactsRust + units-rs) виїхали в `@7n/rules-lang-rust`; ядро документує js/mjs/ts/vue вбудовано, .rs/.py — за активним lang-плагіном
+
+## [1.22.0] - 2026-07-18
+
+### Added
+
+- taze: по завершенню переносить зміни з автоствореного worktree назад у вихідне дерево (untracked) і прибирає worktree
+
+### Changed
+
+- taze: worktree-only гейт сам створює .worktrees/branch-taze і продовжує там замість throw-and-stop
+
 ## [1.21.0] - 2026-07-18
 
 ### Changed

package/package.json

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

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/check/main.mjs
 docgen:
-  crc: 715702d3
+  crc: 2af6c6b9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

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

@@ -25,7 +25,7 @@ function sourceForDoc(cwd, docRel) {
     return null
   }
   for (const e of entries) {
-    if (!e.isFile() || !isSourceFile(e.name)) continue
+    if (!e.isFile() || !isSourceFile(e.name, cwd)) continue
     if (basename(e.name, extname(e.name)) !== stem) continue
     const rel = srcDir === '.' ? e.name : `${srcDir}/${e.name}`
     if (isDocCandidate(cwd, rel)) return rel

package/rules/doc-files/docgen-crc/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/docgen-crc/main.mjs
 docgen:
-  crc: bc1835c9
+  crc: c10183ef
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

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

@@ -3,6 +3,7 @@ import { existsSync, readFileSync } from 'node:fs'
 import { basename, extname } from 'node:path'
 import { crc32 as zlibCrc32 } from 'node:zlib'
 import { env } from 'node:process'
+import { pluginDocFilesExtensions } from '../docgen-scan/lang-extensions.mjs'
 
 /** Поріг degraded: дока зі `score` нижче вважається неякісною. */
 export const QUALITY_THRESHOLD = Number(env.N_CURSOR_DOC_FILES_THRESHOLD ?? 70) || 70
@@ -66,24 +67,24 @@ export function parseDocFrontmatter(md) {
 /** Максимум кодів issues у frontmatter — це маркер, а не повний лог. */
 const MAX_ISSUE_CODES = 8
 
-/** OKF type для розширення файлу. */
+/** OKF type для вбудованих розширень; мовні (`.rs`, `.py`) декларують lang-плагіни. */
 const EXT_TYPES = {
   '.js': 'JS Module',
   '.mjs': 'JS Module',
   '.cjs': 'JS Module',
   '.ts': 'TS Module',
-  '.vue': 'Vue Component',
-  '.py': 'Python Module',
-  '.rs': 'Rust Module'
+  '.vue': 'Vue Component'
 }
 
 /**
- * OKF `type` для файлу-джерела за розширенням.
+ * OKF `type` для файлу-джерела за розширенням (вбудовані + декларації
+ * активних lang-плагінів).
  * @param {string} sourcePath відносний шлях джерела
  * @returns {string} тип концепту
  */
 function typeForSource(sourcePath) {
-  return EXT_TYPES[extname(sourcePath).toLowerCase()] ?? 'Source File'
+  const ext = extname(sourcePath).toLowerCase()
+  return EXT_TYPES[ext] ?? pluginDocFilesExtensions(process.cwd())[ext] ?? 'Source File'
 }
 
 /**

package/rules/doc-files/docgen-extract/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/docgen-extract/main.mjs
 docgen:
-  crc: 39c43eb9
+  crc: a9332a80
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

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

@@ -241,201 +241,6 @@ function extractMarkers(src) {
     skips: [...skips]
   }
 }
-
-// ── Rust-екстрактор ──────────────────────────────────────────────────────────
-
-// pub fn / pub struct / pub enum / pub trait (та fn із exposure-атрибутом)
-// матчаться у два кроки по trim-нутому рядку — прості регекспи без бектрекінгу:
-// спершу опційний pub(...)-префікс, потім сама декларація
-const RS_PUB_PREFIX_RE = /^pub(?:\([^)]*\))?\s+/
-const RS_ITEM_DECL_RE = /^(?:async\s+)?(?:unsafe\s+)?(fn|struct|enum|trait|type)\s+(\w+)/
-
-// fn-декларація у trim-нутому рядку одразу після exposure-атрибута
-const RS_FN_AFTER_ATTR_RE = /^(?:pub\s+)?(?:async\s+)?(?:unsafe\s+)?fn\s+/
-
-// Будь-яка fn-декларація без pub (для приватних localSymbols)
-const RS_PRIVATE_FN_RE = /^[ \t]*(?:async\s+)?(?:unsafe\s+)?fn\s+(\w+)/
-
-// Exposure-атрибути (#[tauri::command] тощо)
-const RS_EXPOSURE_ATTR_RE = /#\[(?:tauri::command|wasm_bindgen|uniffi::export|pyo3::pyfunction|napi)/gm
-
-// use crate::module::{A, B}  або  use std::..;
-const RS_USE_RE = /^[ \t]*use\s+([\w:]+(?:::\{[^}]+\})?(?:::\*)?(?:::\w+)?)\s*;/gm
-
-// Файловий запис: fs::write / File::create / remove_file / create_dir / write_all
-const RS_WRITE_RE = /fs::write|File::create|remove_file|create_dir|BufWriter::new|OpenOptions[^;]*\.write\s*\(\s*true/
-
-// Raw-SQL запис через sqlx-подібні макро/виклики (query!/query/execute) — DML-
-// keyword одразу після відкриваючої лапки рядкового літералу (той самий
-// мінімальний тег+вміст сигнал, що й для JS tagged-template, SQL_TAGGED_MUTATION_RE)
-const RS_SQL_WRITE_RE = /\b(?:query!?|execute)\s*\(\s*"\s*(?:UPDATE|INSERT|MERGE\s+INTO|DELETE\s+FROM|UPSERT)\b/i
-
-// Обробка помилок (але не просто `?`): прості маркери; випадок
-// «match … з Err(-гілкою» — віконним обходом рядків у rsHasMatchWithErrArm
-const RS_CATCH_SIMPLE_RES = [/\.unwrap_or(?:_else|_default)?/, /if\s+let\s+Err\s*\(/, /\.map_err\s*\(/, /\.ok\s*\(\)/]
-const RS_MATCH_KW_RE = /\bmatch\s/
-const RS_ERR_ARM_RE = /\bErr\s*\(/
-
-// Функції, що повертають Result або Option
-const RS_RESULT_RE = /->\s*(?:Result|Option)\s*</
-
-// Мережа
-const RS_NETWORK_RE = /reqwest|hyper::|TcpStream|UdpSocket|tokio::net/
-
-// Кешування
-const RS_CACHE_RE = /\bcache\b|\bCache\b|lazy_static!|OnceCell|OnceLock|DashMap/i
-
-/**
- * Чи містить джерело `match`-вираз із `Err(`-гілкою неподалік (вікно 12 рядків).
- * Замінює бектрекінг-вразливу регулярку детермінованим обходом рядків.
- * @param {string[]} srcLines рядки файлу
- * @returns {boolean} true, якщо за `match` слідує `Err(`
- */
-function rsHasMatchWithErrArm(srcLines) {
-  for (let i = 0; i < srcLines.length; i++) {
-    if (!RS_MATCH_KW_RE.test(srcLines[i])) continue
-    const end = Math.min(i + 12, srcLines.length)
-    for (let j = i; j < end; j++) if (RS_ERR_ARM_RE.test(srcLines[j])) return true
-  }
-  return false
-}
-
-/**
- * Видобуває `///` doc-рядки перед рядком `lineIdx` (назад через `#[...]` та пусті рядки).
- * @param {string[]} lines рядки файлу
- * @param {number} lineIdx індекс рядка декларації
- * @returns {string} опис або ''
- */
-function rsDocBefore(lines, lineIdx) {
-  const doc = []
-  for (let i = lineIdx - 1; i >= 0; i--) {
-    const t = lines[i].trim()
-    if (t.startsWith('///')) doc.unshift(t.slice(3).trim())
-    else if (t.startsWith('#[') || t.startsWith('#![') || t === '') {
-      /* skip */
-    } else break
-  }
-  return doc.join(' ').trim()
-}
-
-/**
- * Витягує module-level doc (`//!`) із голови `.rs` файлу.
- * @param {string} src вміст файлу
- * @returns {string} злитий header-текст
- */
-function rsExtractHeader(src) {
-  const headerLines = []
-  for (const line of src.split('\n')) {
-    const t = line.trim()
-    if (t.startsWith('//!')) headerLines.push(t.slice(3).trim())
-    else if (t === '' || t.startsWith('//')) continue
-    else break
-  }
-  return headerLines.join(' ').trim()
-}
-
-/**
- * Обчислює номери рядків із `fn`, які стають фактично `pub` через exposure-атрибути.
- * @param {string} src вміст файлу
- * @param {string[]} srcLines рядки файлу
- * @returns {Set<number>} індекси exposure-exposed fn-рядків
- */
-function rsExposedLineSet(src, srcLines) {
-  const exposedLineSet = new Set()
-  for (const m of src.matchAll(RS_EXPOSURE_ATTR_RE)) {
-    // Знаходимо, який рядок містить цей атрибут
-    let pos = 0
-    for (let li = 0; li < srcLines.length; li++) {
-      if (pos + srcLines[li].length >= m.index) {
-        // Шукаємо наступний не-атрибутний рядок з fn
-        for (let nli = li + 1; nli < Math.min(li + 5, srcLines.length); nli++) {
-          const t = srcLines[nli].trim()
-          if (t.startsWith('#[') || t === '') continue
-          if (RS_FN_AFTER_ATTR_RE.test(t)) exposedLineSet.add(nli)
-          break
-        }
-        break
-      }
-      pos += srcLines[li].length + 1
-    }
-  }
-  return exposedLineSet
-}
-
-/**
- * Збирає публічні items (`pub` + exposure-exposed) `.rs` файлу.
- * @param {string[]} srcLines рядки файлу
- * @param {Set<number>} exposedLineSet індекси exposure-exposed fn-рядків
- * @returns {Array<{name:string, kind:string, desc:string}>} перелік exports
- */
-function rsCollectExports(srcLines, exposedLineSet) {
-  const exports = []
-  for (let li = 0; li < srcLines.length; li++) {
-    const trimmed = srcLines[li].trimStart()
-    const pubM = trimmed.match(RS_PUB_PREFIX_RE)
-    const m = (pubM ? trimmed.slice(pubM[0].length) : trimmed).match(RS_ITEM_DECL_RE)
-    if (m) {
-      const isPub = Boolean(pubM) || exposedLineSet.has(li)
-      if (isPub) {
-        const desc = rsDocBefore(srcLines, li)
-        exports.push({ name: m[2], kind: m[1], desc })
-      }
-    }
-  }
-  return exports
-}
-
-/**
- * Класифікує `use`-рядки `.rs` файлу на std / external / internal.
- * @param {string} src вміст файлу
- * @returns {{stdlib:string[], external:string[], internal:string[]}} згруповані imports
- */
-function rsExtractImports(src) {
-  const stdlib = new Set()
-  const external = new Set()
-  for (const m of src.matchAll(RS_USE_RE)) {
-    const path = m[1]
-    const root = path.split('::', 1)[0]
-    if (root === 'std' || root === 'core' || root === 'alloc') stdlib.add(path)
-    else external.add(path)
-  }
-  return { stdlib: [...stdlib], external: [...external], internal: [] }
-}
-
-/**
- * Витягує факт-лист для `.rs` файлу.
- * @param {string} src вміст файлу
- * @param {string} relPath відносний шлях
- * @returns {object} факт-лист без `unsupported`
- */
-function extractFactsRust(src, relPath) {
-  const header = rsExtractHeader(src)
-  const srcLines = src.split('\n')
-  const exposedLineSet = rsExposedLineSet(src, srcLines)
-  const exports = rsCollectExports(srcLines, exposedLineSet)
-
-  // localSymbols — приватні fn (не pub і не exposed) — не документуємо як публічний API
-  const localSymbols = []
-  for (const line of srcLines) {
-    const m = line.match(RS_PRIVATE_FN_RE)
-    if (m && exports.every(e => e.name !== m[1])) localSymbols.push(m[1])
-  }
-
-  const imports = rsExtractImports(src)
-
-  // markers
-  const markers = {
-    readOnly: !RS_WRITE_RE.test(src) && !RS_SQL_WRITE_RE.test(src),
-    catchesErrors: RS_CATCH_SIMPLE_RES.some(re => re.test(src)) || rsHasMatchWithErrArm(srcLines),
-    returnsFalsyOnFail: RS_RESULT_RE.test(src),
-    network: RS_NETWORK_RE.test(src),
-    caches: RS_CACHE_RE.test(src),
-    skips: []
-  }
-
-  return { relPath, lang: 'rs', header, exports, imports, internalSymbols: [], localSymbols, markers }
-}
-
 /**
  * Головний екстрактор: код файлу → факт-лист.
  * @param {string} src вміст файлу
@@ -444,7 +249,6 @@ function extractFactsRust(src, relPath) {
  */
 export function extractFacts(src, relPath) {
   const lang = relPath.split('.').pop()
-  if (lang === 'rs') return extractFactsRust(src, relPath)
   if (!['js', 'mjs', 'ts'].includes(lang)) {
     return { relPath, lang, unsupported: true, header: '', exports: [], imports: {}, markers: {} }
   }

package/rules/doc-files/docgen-gen/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/docgen-gen/main.mjs
 docgen:
-  crc: 344e711f
+  crc: 358294dc
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

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

@@ -7,6 +7,7 @@ import { runOneShot } from '@7n/llm-lib/one-shot'
 import { startChain } from '@7n/llm-lib/chain'
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
 import { docPathForSource } from '../docgen-scan/main.mjs'
+import { loadDocFilesExtractors } from '../docgen-scan/lang-extensions.mjs'
 import { extractFacts } from '../docgen-extract/main.mjs'
 import { extractAnchors, anchorTokens } from '../docgen-extract-anchors/main.mjs'
 import { QUALITY_THRESHOLD } from '../docgen-crc/main.mjs'
@@ -506,7 +507,11 @@ export async function generateDoc(
       `docgen pre-send guard: джерело ~${estTokens} токенів > бюджет ${budget} (0.5× контексту) — Prompt too long, skip`
     )
   }
-  const facts = extractFacts(src, file)
+  // Мовний екстрактор з lang-плагіна (напр. `.rs` у @7n/rules-lang-rust) має
+  // пріоритет; вбудований extractFacts покриває JS-екосистему, решта — whole-file.
+  const langExtractors = await loadDocFilesExtractors(process.cwd())
+  const ext = `.${file.split('.').pop()}`.toLowerCase()
+  const facts = langExtractors.get(ext)?.extractFacts?.(src, file) ?? extractFacts(src, file)
   const t0 = Date.now()
   llmMeter = { calls: 0, ms: 0 }
   const chain = chainFactory({ kind: 'doc-generate', unit: facts.relPath, cwd: process.cwd() })

package/rules/doc-files/docgen-scan/docs/index.md

@@ -0,0 +1,10 @@
+---
+type: Directory Index
+title: npm/rules/doc-files/docgen-scan
+resource: npm/rules/doc-files/docgen-scan/
+---
+
+| Файл                                      | Тип       |
+| ----------------------------------------- | --------- |
+| [lang-extensions.mjs](lang-extensions.md) | JS Module |
+| [main.mjs](main.md)                       | JS Module |

package/rules/doc-files/docgen-scan/docs/lang-extensions.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: lang-extensions.mjs
+resource: npm/rules/doc-files/docgen-scan/lang-extensions.mjs
+docgen:
+  crc: 3c5bc28b
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Збирає з активних плагінів у репозиторії мапу розширень doc-files і мовні екстрактори для них, щоб інші частини системи могли підготувати обробку файла за доступними плагінними можливостями. `pluginDocFilesExtensions` формує перелік підтримуваних doc-files розширень, `loadDocFilesExtractors` підтягує екстрактори мов із плагінів, а `clearDocFilesLangCache` скидає кеш у межах прогону. Спирається на `.n-rules.json` і `.n-cursor.json` як джерело конфігурації активних плагінів та їхніх правил. Працює fail-safe: биті handler-модулі мовчки пропускає, не кидає винятків назовні, кешує стан у межах прогону.
+
+## Поведінка
+
+- `pluginDocFilesExtensions` — повертає мапу розширень doc-files, які декларують активні плагіни в репозиторії, з урахуванням кешу для поточного прогону.
+- `loadDocFilesExtractors` — завантажує мовні екстрактори з handler-модулів плагінів для doc-files і повертає їх за розширеннями; биті модулі мовчки пропускає, тож для таких файлів далі можливий whole-file шлях.
+- `clearDocFilesLangCache` — скидає внутрішній кеш мовних розширень і екстракторів, щоб наступний прогін прочитав актуальний стан заново.
+
+## Публічний API
+
+- pluginDocFilesExtensions — збирає з активних плагінів карту розширень для doc-files і тримає її в процесному кеші; порожній результат означає, що жоден плагін не оголосив підтримку.
+- loadDocFilesExtractors — підвантажує мовні extractors із plugin handler-модулів для extension-point `doc-files`; якщо модуль зламаний, його тихо пропускає і далі обробляє файл цілком.
+- clearDocFilesLangCache — очищає кеші, щоб тести починали з чистого стану.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Кешує результати в межах одного прогону.

package/rules/doc-files/docgen-scan/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/docgen-scan/main.mjs
 docgen:
-  crc: 6b2177db
+  crc: 66000db2
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/doc-files/docgen-scan/lang-extensions.mjs

@@ -0,0 +1,89 @@
+/** @see ./docs/lang-extensions.md */
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+import { getDocFilesExtensions, getHandlers } from '../../../scripts/lib/resolve-plugins.mjs'
+
+/**
+ * Мовні розширення doc-files від плагінів (фаза 4 spec lang-plugins-extraction).
+ *
+ * Розширення (`.rs` → 'Rust Module') декларуються в МАНІФЕСТІ плагіна
+ * (`n-rules.contributes.docFiles.extensions`) — hot-path (hook на кожен файл)
+ * читає їх синхронно без динамічного import. Екстрактори фактів/юнітів —
+ * у handler-модулі (`contributes.handlers['doc-files']`), вантажаться лише
+ * на асинхронному шляху генерації.
+ */
+
+/** Кеш ініціалізації на процес: cwd → мапа розширення → тип-мітка. */
+const EXT_CACHE = new Map()
+/** Кеш завантажених екстракторів: cwd → мапа розширення → модуль-екстрактор. */
+const EXTRACTOR_CACHE = new Map()
+
+/**
+ * Синхронно читає `plugins` з `.n-rules.json` (легка версія: лише це поле,
+ * без merge/схем — той самий контракт, що `readNRulesConfigLite`, але sync
+ * для hot-path).
+ * @param {string} cwd корінь репозиторію
+ * @returns {{ plugins?: string[] }} конфіг-стаб для resolvePlugins
+ */
+function readPluginsConfigSync(cwd) {
+  for (const name of ['.n-rules.json', '.n-cursor.json']) {
+    const p = join(cwd, name)
+    if (!existsSync(p)) continue
+    try {
+      const parsed = JSON.parse(readFileSync(p, 'utf8'))
+      return { plugins: parsed.plugins }
+    } catch {
+      return {}
+    }
+  }
+  return {}
+}
+
+/**
+ * Мапа doc-files-розширень від плагінів для репо (`.rs` → 'Rust Module', …),
+ * з кешем на процес. Порожня мапа — жодний активний плагін їх не декларує.
+ * @param {string} cwd корінь репозиторію
+ * @returns {Record<string, string>} розширення → тип-мітка
+ */
+export function pluginDocFilesExtensions(cwd) {
+  const cached = EXT_CACHE.get(cwd)
+  if (cached) return cached
+  const out = getDocFilesExtensions(cwd, readPluginsConfigSync(cwd))
+  EXT_CACHE.set(cwd, out)
+  return out
+}
+
+/**
+ * Асинхронно вантажить мовні екстрактори з handler-модулів плагінів
+ * (extension-point `doc-files`): default-експорт
+ * `{ id, extensions: string[], extractFacts?, extractUnits? }`.
+ * Битий модуль — мовчазний пропуск (генерація тоді йде whole-file шляхом).
+ * @param {string} cwd корінь репозиторію
+ * @returns {Promise<Map<string, { id: string, extractFacts?: (src: string, relPath: string) => object, extractUnits?: (src: string, relPath: string) => Array<object>|null }>>} розширення → екстрактор
+ */
+export async function loadDocFilesExtractors(cwd) {
+  const cached = EXTRACTOR_CACHE.get(cwd)
+  if (cached) return cached
+  const map = new Map()
+  for (const handler of getHandlers(cwd, readPluginsConfigSync(cwd), 'doc-files')) {
+    try {
+      // eslint-disable-next-line no-unsanitized/method
+      const mod = await import(pathToFileURL(handler.modulePath).href)
+      const extractor = mod.default
+      if (!extractor || typeof extractor !== 'object' || !Array.isArray(extractor.extensions)) continue
+      for (const ext of extractor.extensions) map.set(ext, extractor)
+    } catch {
+      /* битий handler — пропускаємо, доки згенеруються whole-file шляхом */
+    }
+  }
+  EXTRACTOR_CACHE.set(cwd, map)
+  return map
+}
+
+/** Скидає кеші (для тестів). */
+export function clearDocFilesLangCache() {
+  EXT_CACHE.clear()
+  EXTRACTOR_CACHE.clear()
+}

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

@@ -5,9 +5,14 @@ import { execFileSync } from 'node:child_process'
 
 import { isDocgenIgnored } from '../docgen-ignore/main.mjs'
 import { parseDocFrontmatter, readDocCrc, staleness } from '../docgen-crc/main.mjs'
+import { pluginDocFilesExtensions } from './lang-extensions.mjs'
 
-/** Кодові розширення, для яких генеруємо документацію. */
-const SOURCE_EXTENSIONS = new Set(['.js', '.mjs', '.ts', '.vue', '.py', '.rs'])
+/**
+ * Вбудовані кодові розширення, для яких генеруємо документацію. Мовні
+ * розширення поза JS-екосистемою (`.rs`, `.py`) декларують lang-плагіни
+ * (`n-rules.contributes.docFiles.extensions`) — див. lang-extensions.mjs.
+ */
+const SOURCE_EXTENSIONS = new Set(['.js', '.mjs', '.ts', '.vue'])
 
 /** `*.test.*`, `*.spec.*`, `*.stories.*` — тести й Storybook CSF-файли, документувати не треба. */
 const TEST_FILE_RE = /\.(?:test|spec|stories)\.[^.]+$/u
@@ -24,14 +29,18 @@ function isSystemWideDocsRoot(root) {
 }
 
 /**
- * Чи є файл кодовим джерелом для документування.
+ * Чи є файл кодовим джерелом для документування. З `root` — враховує і
+ * розширення активних lang-плагінів; без нього — лише вбудовані JS-екосистемні.
  * @param {string} fileName базове ім'я файлу
+ * @param {string} [root] корінь репозиторію (для плагінних розширень)
  * @returns {boolean} true — документуємо; false — пропускаємо
  */
-export function isSourceFile(fileName) {
+export function isSourceFile(fileName, root) {
   if (fileName.endsWith('.d.ts')) return false
   if (TEST_FILE_RE.test(fileName)) return false
-  return SOURCE_EXTENSIONS.has(extname(fileName))
+  const ext = extname(fileName)
+  if (SOURCE_EXTENSIONS.has(ext)) return true
+  return root !== undefined && ext in pluginDocFilesExtensions(root)
 }
 
 /**
@@ -55,7 +64,7 @@ export function docPathForSource(sourcePath) {
  */
 export function isDocCandidate(root, relPath) {
   const fileName = posix.basename(relPath)
-  if (!isSourceFile(fileName)) return false
+  if (!isSourceFile(fileName, root)) return false
   if (isSystemWideDocsRoot(root) && posix.dirname(relPath) === '.') return false
   return !isDocgenIgnored(relPath)
 }
@@ -203,7 +212,7 @@ export function scanForDocFiles(root) {
       if (entry.isDirectory()) {
         if (isDocgenIgnored(relPath, 'dir')) continue
         walk(fullPath)
-      } else if (entry.isFile() && isSourceFile(entry.name)) {
+      } else if (entry.isFile() && isSourceFile(entry.name, root)) {
         if (isSystemWideDocsRoot(root) && dirname(relPath) === '.') continue
         const sourcePath = relPath.split(sep).join('/')
         if (isDocgenIgnored(sourcePath)) continue

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

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/units/main.mjs
 docgen:
-  crc: b304d152
+  crc: 8acdefc1
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

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

@@ -1,13 +1,13 @@
 /** @see ./docs/units.md */
 
 import { extractUnitsJs } from '../units-js/main.mjs'
-import { extractUnitsRs } from '../units-rs/main.mjs'
 
 const JS_EXT = new Set(['js', 'mjs', 'ts', 'jsx', 'tsx', 'cts', 'mts'])
 
 /**
  * Мовно-агностичний фасад юніт-шару. Диспатчить за розширенням:
- * js/mjs/ts → oxc AST; rs → regex+brace-counting; vue/py → null (whole-file шлях).
+ * 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, якщо мова ще не підтримана / файл не парситься
@@ -15,6 +15,5 @@ const JS_EXT = new Set(['js', 'mjs', 'ts', 'jsx', 'tsx', 'cts', 'mts'])
 export function extractUnits(src, relPath) {
   const ext = (relPath.split('.').pop() || '').toLowerCase()
   if (JS_EXT.has(ext)) return extractUnitsJs(src, relPath)
-  if (ext === 'rs') return extractUnitsRs(src, relPath)
   return null
 }

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: 17248373
+  crc: 0d197e39
 ---
 
 Резолв плагінів @7n/rules: визначає, які пакети-плагіни активні у проєкті, де їхні `rules/`-каталоги, які capabilities вони надають і які handlers надають.