feat(plugins): фаза 5b lang-плагінів — doc-files JS-специфіка у @7n/rules-lang-js, ядро без вбудованих кодових розширень (#143)

- @7n/rules-lang-js: маніфест декларує docFiles.extensions (js/mjs/ts/vue + OKF-типи) і handler doc-files; extractFacts (факт-лист js/mjs/ts) та extractUnits (oxc AST юніт-шар) переїхали з ядра
- ядро: docgen-scan/docgen-crc/docgen-gen читають розширення, типи й екстрактори лише з активних lang-плагінів; SOURCE_EXTENSIONS/EXT_TYPES/units-js/docgen-extract/units-фасад видалені
- без активного lang-плагіна скан не бачить джерел (graceful тиша); тести doc-files — фейковий lang-js через installFakeLangJsPlugin

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: vitaliytv

.claude/commands/n-doc-files.md

@@ -1,6 +1,6 @@
 ---
 description: >-
-  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (розширення декларують lang-плагіни: js/mjs/ts/vue — lang-js, rs/py — lang-rust/lang-python) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
 ---
 
 # n-doc-files

.claude/commands/n-taze.md

@@ -1,6 +1,6 @@
 ---
 description: >-
-  Оновлення версій модулів проекту (bun/npm і, якщо є Cargo.toml, Rust-крейти через cargo-edit) з аналізом major-змін і автоматичним рефакторингом несумісного коду
+  Оновлення версій модулів проекту до останніх (усі екосистеми — JS/npm, Rust, Python тощо — через активні lang-плагіни) з аналізом major-змін і автоматичним рефакторингом несумісного коду
 ---
 
 # n-taze

.cursor/skills/n-doc-files/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: doc-files
 description: >-
-  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (розширення декларують lang-плагіни: js/mjs/ts/vue — lang-js, rs/py — lang-rust/lang-python) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
 version: '1.0'
 ---
 
@@ -95,6 +95,6 @@ preflight). Degraded — не помилка: дока існує, CRC свіж
 
 - Не комітити автоматично — користувач вирішує, коли комітити згенеровану доку.
 - Scanner ігнорує `node_modules`, `dist`, `.git`, `__pycache__`, `coverage`, `.cursor`, `.claude`,
-  усі теки `docs/`, а також `*.test.*` / `*.spec.*` / `*.stories.*` / `*.d.ts`. Кореневий repo `docs/` —
+  усі теки `docs/`, а також `*.test.*` / `*.spec.*` / `*.d.ts`. Кореневий repo `docs/` —
   system-wide only: file-level docs туди не пишуться. Список glob-ів — `docgen-ignore.mjs`.
 - Агрегуюча документація (module-summary, доменні доки) — окремий скіл `doc-aggregate`, за запитом.

.pi/skills/n-doc-files/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: n-doc-files
 description: >-
-  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+  Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (розширення декларують lang-плагіни: js/mjs/ts/vue — lang-js, rs/py — lang-rust/lang-python) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
 ---
 
 # n-doc-files

.pi/skills/n-taze/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: n-taze
 description: >-
-  Оновлення версій модулів проекту (bun/npm і, якщо є Cargo.toml, Rust-крейти через cargo-edit) з аналізом major-змін і автоматичним рефакторингом несумісного коду
+  Оновлення версій модулів проекту до останніх (усі екосистеми — JS/npm, Rust, Python тощо — через активні lang-плагіни) з аналізом major-змін і автоматичним рефакторингом несумісного коду
 ---
 
 # n-taze

AGENTS.md

@@ -38,11 +38,11 @@ The primary development rules are stored in the Cursor rules directory:
 - `.cursor/skills/mdc-check/SKILL.md` — Проаналізувати правило в npm/mdc: максимум перевірюваної логіки й деталей — у check-{id}.mjs з зрозумілими коментарями/JSDoc; у .mdc залишати людинозрозумілий зміст без дублювання алгоритму перевірки
 - `.cursor/skills/n-adr-normalize/SKILL.md` — Ручний запуск ADR-нормалізації — обхід порогу й min-interval, прогон одного батчу чернеток через LLM, перегляд результату через git diff
 - `.cursor/skills/n-brainstorming/SKILL.md` — Фасилітація структурованої генерації ідей для будь-якої теми — продуктові фічі, архітектурні рішення, бізнес-стратегія, назви, маркетинг, вирішення проблем. ОБОВ'ЯЗКОВО використовуй цей skill, коли користувач каже "давай побрейнштормимо", "накидай ідей", "хочу подумати над X", "які є варіанти для...", просить допомогти придумати щось з нуля, або коли задача явно на стадії "ще не зрозуміло що робити" (на відміну від "вже зрозуміло що робити, допоможи зробити"). Не використовуй для чистого уточнення вимог до вже визначеної фічі (це просто уточнюючі питання, без техніки генерації) і не використовуй, якщо користувач вже приніс готове рішення і просить його реалізувати.
-- `.cursor/skills/n-doc-files/SKILL.md` — Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+- `.cursor/skills/n-doc-files/SKILL.md` — Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (розширення декларують lang-плагіни: js/mjs/ts/vue — lang-js, rs/py — lang-rust/lang-python) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
 - `.cursor/skills/n-lint/SKILL.md` — Запустити дельта-лінт (npx @7n/rules lint) по змінених файлах vs origin, виправити порушення й підтвердити чистий вихід
 - `.cursor/skills/n-llm-patch/SKILL.md` — Підготовка самодостатнього текстового промпта для іншого Claude/Cursor-агента — read-only аналіз CWD без жодних змін у поточному репо
 - `.cursor/skills/n-publish-telegram/SKILL.md` — Підготовка матеріалу з поточного контексту для публікації в Telegram-каналі команди
-- `.cursor/skills/n-taze/SKILL.md` — Оновлення версій модулів проекту (bun/npm і, якщо є Cargo.toml, Rust-крейти через cargo-edit) з аналізом major-змін і автоматичним рефакторингом несумісного коду
+- `.cursor/skills/n-taze/SKILL.md` — Оновлення версій модулів проекту до останніх (усі екосистеми — JS/npm, Rust, Python тощо — через активні lang-плагіни) з аналізом major-змін і автоматичним рефакторингом несумісного коду
 
 ## Commands
 

CLAUDE.md

@@ -5,6 +5,7 @@
 Ніколи не змінюй, не видаляй і не створюй файли у цих директоріях:
 
 - `.claude/worktrees/`
+- `npm/schemas/vendor/`
 
 @.cursor/rules/conftest.mdc
 @.cursor/rules/dev-dep.mdc
@@ -51,13 +52,13 @@
   Команда: `/n-adr-normalize`
 - `.cursor/skills/n-brainstorming/SKILL.md` — Фасилітація структурованої генерації ідей для будь-якої теми — продуктові фічі, архітектурні рішення, бізнес-стратегія, назви, маркетинг, вирішення проблем. ОБОВ'ЯЗКОВО використовуй цей skill, коли користувач каже "давай побрейнштормимо", "накидай ідей", "хочу подумати над X", "які є варіанти для...", просить допомогти придумати щось з нуля, або коли задача явно на стадії "ще не зрозуміло що робити" (на відміну від "вже зрозуміло що робити, допоможи зробити"). Не використовуй для чистого уточнення вимог до вже визначеної фічі (це просто уточнюючі питання, без техніки генерації) і не використовуй, якщо користувач вже приніс готове рішення і просить його реалізувати.
   Команда: `/n-brainstorming`
-- `.cursor/skills/n-doc-files/SKILL.md` — Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+- `.cursor/skills/n-doc-files/SKILL.md` — Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (розширення декларують lang-плагіни: js/mjs/ts/vue — lang-js, rs/py — lang-rust/lang-python) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
   Команда: `/n-doc-files`
 - `.cursor/skills/n-lint/SKILL.md` — Запустити дельта-лінт (npx @7n/rules lint) по змінених файлах vs origin, виправити порушення й підтвердити чистий вихід
   Команда: `/n-lint`
 - `.cursor/skills/n-llm-patch/SKILL.md` — Підготовка самодостатнього текстового промпта для іншого Claude/Cursor-агента — read-only аналіз CWD без жодних змін у поточному репо
   Команда: `/n-llm-patch`
 - `.cursor/skills/n-publish-telegram/SKILL.md` — Підготовка матеріалу з поточного контексту для публікації в Telegram-каналі команди
   Команда: `/n-publish-telegram`
-- `.cursor/skills/n-taze/SKILL.md` — Оновлення версій модулів проекту (bun/npm і, якщо є Cargo.toml, Rust-крейти через cargo-edit) з аналізом major-змін і автоматичним рефакторингом несумісного коду
+- `.cursor/skills/n-taze/SKILL.md` — Оновлення версій модулів проекту до останніх (усі екосистеми — JS/npm, Rust, Python тощо — через активні lang-плагіни) з аналізом major-змін і автоматичним рефакторингом несумісного коду
   Команда: `/n-taze`

npm/.changes/260719-0948.md

@@ -0,0 +1,5 @@
+---
+bump: minor
+section: Changed
+---
+doc-files: ядро без вбудованих кодових розширень (фаза 5b spec lang-plugins-extraction) — перелік розширень, OKF-типи та мовні екстрактори (факти/юніти) приходять лише з декларацій активних lang-плагінів (contributes.docFiles.extensions + handler doc-files); JS-специфіка (extractFacts, units-js, мапа типів js/mjs/ts/vue) переїхала у @7n/rules-lang-js; без активного lang-плагіна скан не бачить джерел (graceful тиша)

npm/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: c10183ef
+  crc: 8976f6f8
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

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

@@ -67,24 +67,17 @@ export function parseDocFrontmatter(md) {
 /** Максимум кодів issues у frontmatter — це маркер, а не повний лог. */
 const MAX_ISSUE_CODES = 8
 
-/** OKF type для вбудованих розширень; мовні (`.rs`, `.py`) декларують lang-плагіни. */
-const EXT_TYPES = {
-  '.js': 'JS Module',
-  '.mjs': 'JS Module',
-  '.cjs': 'JS Module',
-  '.ts': 'TS Module',
-  '.vue': 'Vue Component'
-}
-
 /**
- * OKF `type` для файлу-джерела за розширенням (вбудовані + декларації
- * активних lang-плагінів).
+ * OKF `type` для файлу-джерела за розширенням — лише з декларацій активних
+ * lang-плагінів (`contributes.docFiles.extensions`: js/mjs/ts/vue — lang-js,
+ * `.rs`/`.py` — lang-rust/lang-python); вбудованих типів у ядрі немає
+ * (фаза 5b spec lang-plugins-extraction). Невідоме розширення → 'Source File'.
  * @param {string} sourcePath відносний шлях джерела
  * @returns {string} тип концепту
  */
 function typeForSource(sourcePath) {
   const ext = extname(sourcePath).toLowerCase()
-  return EXT_TYPES[ext] ?? pluginDocFilesExtensions(process.cwd())[ext] ?? 'Source File'
+  return pluginDocFilesExtensions(process.cwd())[ext] ?? 'Source File'
 }
 
 /**