@nitra/cursor 12.11.2 → 12.11.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.11.3] - 2026-06-25
+
+### Changed
+
+- rm doc-aggregate; dep policy
+
 ## [12.11.2] - 2026-06-25
 
 ### Changed

package/bin/n-cursor.js

@@ -14,7 +14,6 @@
  *                                     весь репо (`per-file` ∪ `full`); `--read-only` = без мутацій/LLM (CI); позиційні
  *                                     (не-флаг) аргументи — фільтр правил конформності (мапить колишній `fix <rule>`).
  *                                     CI = `lint --read-only --full` (весь репо, нуль мутацій/LLM).
- *   `npx \@nitra/cursor doc-aggregate modules` — JSON-лістинг логічних модулів (межі за `package.json`) для Tier 2 скілу doc-aggregate
  *   `npx \@nitra/cursor skill list`     — скіли пакета без синку в проєкт
  *   `npx \@nitra/cursor skill taze`     — промпт на stdout
  *   `npx \@nitra/cursor skill cursor taze ["task"]` — Cursor CLI (`cursor-agent -p`)
@@ -1593,20 +1592,6 @@ try {
 
       break
     }
-    case 'doc-aggregate': {
-      // n-cursor doc-aggregate modules — детермінований лістинг логічних модулів
-      // (межі за package.json) для Tier 2 module-summary скілу doc-aggregate.
-      // Друкує JSON; module-summary і доменні доки пише скіл, диспатчачи субагентів.
-      const { runDocAggregateModulesCli } = await import('../skills/doc-aggregate/js/docgen-scan.mjs')
-      if (args[0] === 'modules') {
-        process.exitCode = await runDocAggregateModulesCli(args.slice(1))
-      } else {
-        console.error('Usage: npx @nitra/cursor doc-aggregate <modules> [--root <dir>]')
-        process.exitCode = 1
-      }
-
-      break
-    }
     case undefined:
     case '': {
       await runSync()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.11.2",
+  "version": "12.11.3",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/bun/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/bun/
 
 # npm/rules/bun
 
-| Файл                | Тип       |
-| ------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [main.mjs](main.md) | JS Module |

package/rules/bun/docs/main.md

@@ -3,24 +3,24 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/bun/main.mjs
 docgen:
-  crc: 762b6875
+  crc: a2cfc572
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  score: 90
 ---
 
-Модуль валідує дані, застосовуючи правила, визначені у конфігурації meta.json, та збирає посилання на MDC. При виклику публічної функції run він здійснює повний запуск правила, включаючи завантаження конфігурацій та застосування білих списків. Результат виконання повертається як код виходу процесу.
+## Огляд
+
+Модуль виконує перевірку відповідності коду встановленим політикам, використовуючи маркер повідомлень (bun.mdc). Він також аналізує ліцензії залежностей, спираючись на конфігурацію .licensee.json. Модуль надає функції для запуску перевірок (run) та лінтингу (lint).
 
 ## Поведінка
 
-1. Викликається функція `run` для виконання перевірки.
-2. Виконання перевірки включає застосування правил, обробку логіки, визначену в конфігурації `meta.json`, та збір посилань на MDC.
-3. Якщо код виконується як окремий інструмент (standalone), ініціюється повний запуск правила.
-4. Повний запуск правила включає завантаження конфігурацій, застосування білих списків та підбиття підсумків.
-5. Результат виконання повертається як код виходу процесу.
+run виконує перевірку коду, застосовуючи політики та посилання MDC.
+lint виконує перевірку ліцензій npm-залежностей, якщо існує файл .licensee.json у корені проєкту.
 
 ## Публічний API
 
-run — виконує основну логіку правила: застосовує перевірки до коду, аналізує відповідність політиці та перевіряє посилання на метадані.
+run — Основний вхідний пункт правила, який виконує перевірку: застосовує логіку, перевіряє відповідність політикам та згадки в (bun.mdc).
+lint — Інструмент для перевірки ліцензій npm-залежностей у всьому репозиторії, що активується через конфігурацію (.licensee.json).
 
 ## Гарантії поведінки
 

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

@@ -6,6 +6,7 @@ resource: npm/rules/bun/js/
 
 # npm/rules/bun/js
 
-| Файл                    | Тип       |
-| ----------------------- | --------- |
+| Файл | Тип |
+|---|---|
+| [fix-layout.mjs](fix-layout.md) | JS Module |
 | [layout.mjs](layout.md) | JS Module |

package/rules/bun/main.json

@@ -1 +1 @@
-{ "auto": { "glob": "package.json" } }
+{ "auto": { "glob": "package.json" }, "lint": "full" }

package/rules/bun/main.mjs

@@ -1,11 +1,17 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+import { createCheckReporter } from '../../scripts/lib/check-reporter.mjs'
+import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
 import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
- * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
- * (`meta.json` без `lint`), тож експорту `lint` тут немає.
- * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * JS-concerns → policy → mdc-refs (через runStandardRule). `lint()` — lint-поверхня
+ * (licensee — перевірка ліцензій npm-залежностей, лише у `--full`).
  * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
@@ -13,6 +19,50 @@ export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
 
+/**
+ * Перевірка ліцензій npm-залежностей через `licensee`. Opt-in: пропускається якщо
+ * `.licensee.json` відсутній у cwd (проєкт не налаштував allowlist). `bun x licensee`
+ * не потребує локальної установки — bunx завантажує пакет ad-hoc.
+ * @param {string} [cwd] корінь проєкту
+ * @returns {number} 0 — OK, 1 — порушення
+ */
+function runLicenseeSteps(cwd = process.cwd()) {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  if (!existsSync(join(cwd, '.licensee.json'))) {
+    pass('lint-bun: licensee — немає .licensee.json, перевірку ліцензій пропущено')
+    return reporter.getExitCode()
+  }
+
+  const bun = resolveCmd('bun')
+  if (!bun) {
+    fail('lint-bun: `bun` не знайдено в PATH (bun.mdc)')
+    return reporter.getExitCode()
+  }
+
+  const r = spawnSync(bun, ['x', 'licensee', '--production', '--quiet'], { cwd, stdio: 'inherit', shell: false })
+  if (r.status === 0) {
+    pass('lint-bun: licensee — ліцензії OK')
+  } else {
+    const code = typeof r.status === 'number' ? r.status : 1
+    fail(`lint-bun: licensee — порушення ліцензій (код ${code}, bun.mdc)`)
+  }
+  return reporter.getExitCode()
+}
+
+/**
+ * Оркестраторний адаптер `n-cursor lint bun`: licensee-перевірка ліцензій npm-залежностей.
+ * Whole-repo (ігнорує `_files`). Opt-in через `.licensee.json` у cwd.
+ * @param {string[] | undefined} _files ігнорується
+ * @param {string} [cwd] корінь
+ * @param {{ readOnly?: boolean }} [_opts] не використовується (licensee завжди read-only)
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files, cwd = process.cwd(), _opts = {}) {
+  return runStandardLint(import.meta.dirname, () => runLicenseeSteps(cwd))
+}
+
 if (isRunAsCli(import.meta.url)) {
   // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
   // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).

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

@@ -6,6 +6,7 @@ resource: npm/rules/changelog/js/
 
 # npm/rules/changelog/js
 
-| Файл                              | Тип       |
-| --------------------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [consistency.mjs](consistency.md) | JS Module |
+| [fix-consistency.mjs](fix-consistency.md) | JS Module |

package/rules/ci4/policy/vscode_extensions/docs/index.md

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

package/rules/ga/policy/vscode_extensions/docs/index.md

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

package/rules/graphql/policy/vscode_extensions/docs/index.md

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

package/rules/js/js/dep-policy.mdc

@@ -2,6 +2,25 @@
 
 `@e18e/eslint-plugin` окремо не додавай — він уже в залежностях `@nitra/eslint-config` (з **3.8.0**), oxlint підвантажує його з `node_modules`. Пакети `oxlint`/`eslint`/`jscpd`/`knip` теж не додавай у `devDependencies` без потреби монорепо — `bunx` тягне їх ad-hoc.
 
+### Заборона `ua-parser-js`
+
+Пакет **`ua-parser-js`** заборонений починаючи з версії **2.x**, де ліцензія змінилась з MIT на **AGPL-3.0** — несумісну з комерційним використанням у закритому SaaS. Замінити на **`bowser`** (MIT, ~6 KB gzip):
+
+```javascript title="❌ до"
+import { UAParser } from 'ua-parser-js'
+const parser = new UAParser(userAgent)
+const result = parser.getResult()
+const browserName = result.browser.name
+```
+
+```javascript title="✅ після"
+import Bowser from 'bowser'
+const browser = Bowser.getParser(userAgent)
+const browserName = browser.getBrowserName()
+```
+
+Bowser надає ті самі поля: `getBrowserName()`, `getOSName()`, `getPlatform().vendor`. Міграція займає кілька рядків; логіка не змінюється.
+
 ### Заборона `@nitra/as-integrations-fastify`
 
 Пакет **`@nitra/as-integrations-fastify`** заборонений у **`dependencies`**, **`peerDependencies`** та в import-specifier-ах. Це чистий републіш upstream, застряглий на peer `@apollo/server: "^4.0.0"`, тож на Apollo 5 `bun install` дає `warn: incorrect peer dependency`. Заміна — upstream **`@as-integrations/fastify`** (**`^3.1.0`**): peer `@apollo/server: "^4.0.0 || ^5.0.0"` + `fastify: "^5.3.0"`.

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

@@ -16,8 +16,17 @@ import {
 
 const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
 
-/** Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі. */
-const BANNED_SPECIFIERS = new Set(['@nitra/as-integrations-fastify'])
+/**
+ * Пакети, заборонені як 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).
@@ -73,11 +82,10 @@ export async function check(cwdParam = process.cwd()) {
     const source = await readFile(absPath, 'utf8')
     const specifiers = extractImportSpecifiers(source, absPath)
     for (const spec of specifiers) {
-      if (BANNED_SPECIFIERS.has(spec)) {
+      const hint = BANNED_SPECIFIERS.get(spec)
+      if (hint !== undefined) {
         const rel = relative(cwd, absPath)
-        reporter.fail(
-          `${rel}: заборонений import '${spec}' — використовуй @as-integrations/fastify (js.mdc dep-policy)`
-        )
+        reporter.fail(`${rel}: заборонений import '${spec}' — ${hint} (js.mdc dep-policy)`)
         violations += 1
       }
     }

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

@@ -6,10 +6,10 @@ resource: npm/rules/js/js/
 
 # npm/rules/js/js
 
-| Файл                                  | Тип       |
-| ------------------------------------- | --------- |
-| [check.mjs](check.md)                 | JS Module |
-| [dep-policy.mjs](dep-policy.md)       | JS Module |
+| Файл | Тип |
+|---|---|
+| [check.mjs](check.md) | JS Module |
+| [dep-policy.mjs](dep-policy.md) | JS Module |
 | [lint-findings.mjs](lint-findings.md) | JS Module |
-| [tooling.mjs](tooling.md)             | JS Module |
+| [tooling.mjs](tooling.md) | JS Module |
 | [utils_imports.mjs](utils_imports.md) | JS Module |

package/rules/js/policy/vscode_extensions/docs/index.md

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

package/rules/js-run/js/docs/index.md

@@ -6,6 +6,7 @@ resource: npm/rules/js-run/js/
 
 # npm/rules/js-run/js
 
-| Файл                      | Тип       |
-| ------------------------- | --------- |
+| Файл | Тип |
+|---|---|
+| [fix-runtime.mjs](fix-runtime.md) | JS Module |
 | [runtime.mjs](runtime.md) | JS Module |

package/rules/nginx-default-tpl/policy/vscode_extensions/docs/index.md

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

package/rules/python/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/python/
 
 # npm/rules/python
 
-| Файл                | Тип       |
-| ------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [main.mjs](main.md) | JS Module |

package/rules/python/docs/main.md

@@ -3,26 +3,28 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/main.mjs
 docgen:
-  crc: d8a3aa1f
+  crc: 7021a379
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
-Реалізує логіку запуску `lint-python` за правилом `python.mdc` на базі [uv](https://docs.astral.sh/uv/). Якщо `pyproject.toml` у корені відсутній, процес завершується з кодом виходу 0. Якщо файл присутній, але інструмент `uv` не знайдено в PATH, це розглядається як помилка. Обов'язкові кроки включають перевірку актуальності lock-файлу (`uv lock --check`) та синхронізацію середовища (`uv sync --frozen`). Опційні лінтери (`ruff`, `mypy`) запускаються лише за умови їх доступності через `uv run`. `ruff` виконується у режимі автоматичного виправлення (`--fix`) для мутації робочого дерева та для форматування. Цей підхід відповідає канону патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`).
+## Огляд
+
+Запускає `lint-python` за правилом `python.mdc` на базі [uv](https://docs.astral.sh/uv/). Якщо `pyproject.toml` відсутній у корені, вихід дорівнює 0 без запуску інструментів. Якщо `pyproject.toml` присутній, але `uv` не знайдено в PATH, це помилка (використовується лише `uv`, без Poetry). Обов'язково виконує `uv lock --check` для перевірки актуальності lock-файлу та `uv sync --frozen` для збірки середовища. Опціональні лінтери (`ruff`, `mypy`) запускаються лише якщо доступні через `uv run`. `ruff` виконується в режимі автоматичного виправлення (`ruff check --fix .`, `ruff format .`) та перевірки коду (`mypy .`). Це відповідає канону патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`).
 
 ## Поведінка
 
-run виконує стандартну перевірку для правила, використовуючи контекст прогону.
-runLintPythonSteps виконує послідовність кроків лінтування Python, перевіряючи наявність `pyproject.toml` та виконуючи команди `uv lock --check` та `uv sync --frozen`, а також запускаючи опціональні лінтери (`ruff`, `mypy`) через `uv run` на базі https://docs.astral.sh/uv/.
-runLintPython запускає послідовність кроків лінтування Python, серіалізуючи її через стандартний механізм перевірки.
-lint делегує виклик до `runLintPython`, забезпечуючи можливість запуску в режимі, що не мутує робоче дерево.
+run виконує стандартну перевірку для правила.
+runLintPythonSteps виконує послідовність кроків лінтування Python, включаючи перевірку `pyproject.toml`, виконання `uv lock --check` та `uv sync --frozen`, а також запуск опціональних лінтерів (`ruff`, `mypy`, `liccheck`) через `uv run` за умови їх доступності.
+runLintPython запускає послідовність кроків лінтування Python, використовуючи механізм стандартного лінтування.
+lint оркеструє запуск `runLintPython` для виконання лінтування Python.
 
 ## Публічний API
 
-run — Основна точка входу для виконання правил, яка перевіряє логіку застосування (JS-занепокложення $\rightarrow$ політика $\rightarrow$ mdc-посилання) та запускає перевірку коду (uv/ruff/mypy).
-runLintPythonSteps — Виконує внутрішні етапи перевірки Python-коду без збереження логу.
-runLintPython — Публічний інтерфейс для запуску перевірки Python-коду, який гарантує унікальність виконання через блокування та аналіз стану Git-дерева.
-lint — Адаптер, що керує запуском перевірки Python-коду, делегуючи цю роботу `runLintPython`.
+run — Основна точка входу для виконання правил, яка перевіряє аспекти застосування (JS-занепокложення $\rightarrow$ політика $\rightarrow$ mdc-посилання) та виконує лінтинг.
+runLintPythonSteps — Виконує внутрішні етапи лінтингу Python без збереження логів.
+runLintPython — Публічний інтерфейс командного рядка для запуску лінтингу Python, який синхронізується з станом Git-дерева.
+lint — Координатор, що викликає публічний інтерфейс для лінтингу Python.
 
 ## Гарантії поведінки
 

package/rules/python/main.mjs

@@ -118,6 +118,7 @@ export function runLintPythonSteps(cwd = process.cwd(), opts = {}) {
   if (!runOptionalUvTool('ruff', readOnly ? 'ruff format --check' : 'ruff format', ruffFormat))
     return reporter.getExitCode()
   if (!runOptionalUvTool('mypy', 'mypy', ['.'])) return reporter.getExitCode()
+  if (!runOptionalUvTool('liccheck', 'liccheck', [])) return reporter.getExitCode()
 
   return reporter.getExitCode()
 }

package/rules/rego/policy/vscode_extensions/docs/index.md

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

package/rules/rust/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/rust/
 
 # npm/rules/rust
 
-| Файл                | Тип       |
-| ------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [main.mjs](main.md) | JS Module |

package/rules/rust/docs/main.md

@@ -3,22 +3,24 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rust/main.mjs
 docgen:
-  crc: 93c44fd7
+  crc: cbe9e650
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Модуль надає інструменти для забезпечення якості коду Rust. Він дозволяє виконати перевірку коду на відповідність заданим Lint-правилам або запустити повну оркестрацію форматування та аналізу коду через `cargo`. Функціонал реалізується через публічні функції `run` та `lint`.
+## Огляд
+
+Модуль забезпечує виконання перевірки коду Rust на відповідність встановленим правилам. Він також надає функціонал для запуску повного процесу лінтингу, що включає форматування та аналіз коду.
 
 ## Поведінка
 
-run виконує перевірку коду Rust відповідно до політик.
-lint запускає оркестрацію перевірки коду Rust, використовуючи `cargo` для виконання `rustfmt` та `clippy`.
+run виконує перевірку коду Rust, застосовуючи політику, визначену в документації.
+lint запускає повний процес лінтингу Rust, включаючи форматування та аналіз, і повертає код виходу.
 
 ## Публічний API
 
-run — виконує основну логіку правила, включаючи перевірку аспектів застосування, логіки та посилань.
-lint — забезпечує точку входу для статичного аналізу коду Rust.
+run — точка входу для виконання правила, що перевіряє логіку, пов'язану з JS-зацікавленостями, політикою та посиланнями MDC.
+lint — точка входу для запуску лінтера Rust-коду.
 
 ## Гарантії поведінки
 

package/rules/rust/main.mjs

@@ -82,6 +82,17 @@ function runRustLint(cwd = process.cwd(), opts = {}) {
     pass,
     fail
   )
+
+  // cargo deny check licenses (opt-in): потрібен deny.toml + cargo-deny у PATH
+  if (existsSync(join(cwd, 'deny.toml'))) {
+    const hasDeny = spawnSync(cargo, ['deny', '--version'], { stdio: 'ignore', shell: false }).status === 0
+    if (hasDeny) {
+      runCargo('cargo deny check licenses', cargo, ['deny', 'check', 'licenses'], pass, fail)
+    } else {
+      pass('lint-rust: cargo deny — не встановлений (cargo install cargo-deny), перевірку ліцензій пропущено')
+    }
+  }
+
   return reporter.getExitCode()
 }
 

package/rules/rust/policy/vscode_extensions/docs/index.md

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

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

@@ -6,6 +6,7 @@ resource: npm/rules/style/js/
 
 # npm/rules/style/js
 
-| Файл                      | Тип       |
-| ------------------------- | --------- |
+| Файл | Тип |
+|---|---|
+| [fix-tooling.mjs](fix-tooling.md) | JS Module |
 | [tooling.mjs](tooling.md) | JS Module |

package/rules/style/policy/vscode_extensions/docs/index.md

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

package/rules/tauri/policy/vscode_extensions/docs/index.md

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

package/rules/text/policy/vscode_extensions/docs/index.md

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

package/scripts/lib/docs/index.md

@@ -6,39 +6,39 @@ resource: npm/scripts/lib/
 
 # npm/scripts/lib
 
-| Файл                                                                        | Тип       |
-| --------------------------------------------------------------------------- | --------- |
-| [assert-project-root.mjs](assert-project-root.md)                           | JS Module |
-| [changed-files.mjs](changed-files.md)                                       | JS Module |
-| [check-mdc-template-refs.mjs](check-mdc-template-refs.md)                   | JS Module |
-| [check-reporter.mjs](check-reporter.md)                                     | JS Module |
-| [diff-added-lines.mjs](diff-added-lines.md)                                 | JS Module |
+| Файл | Тип |
+|---|---|
+| [assert-project-root.mjs](assert-project-root.md) | JS Module |
+| [changed-files.mjs](changed-files.md) | JS Module |
+| [check-mdc-template-refs.mjs](check-mdc-template-refs.md) | JS Module |
+| [check-reporter.mjs](check-reporter.md) | JS Module |
+| [diff-added-lines.mjs](diff-added-lines.md) | JS Module |
 | [discover-check-rules-from-cursor.mjs](discover-check-rules-from-cursor.md) | JS Module |
-| [discover-checkable-rules.mjs](discover-checkable-rules.md)                 | JS Module |
-| [ensure-tool.mjs](ensure-tool.md)                                           | JS Module |
-| [generated-markdown.mjs](generated-markdown.md)                             | JS Module |
-| [gha-workflow.mjs](gha-workflow.md)                                         | JS Module |
-| [inline-template-links.mjs](inline-template-links.md)                       | JS Module |
-| [list-project-rules-mdc.mjs](list-project-rules-mdc.md)                     | JS Module |
-| [list-rule-ids.mjs](list-rule-ids.md)                                       | JS Module |
-| [load-cursor-config.mjs](load-cursor-config.md)                             | JS Module |
-| [mirror-parity.mjs](mirror-parity.md)                                       | JS Module |
-| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md)               | JS Module |
-| [resolve-target-files.mjs](resolve-target-files.md)                         | JS Module |
-| [root-notice.mjs](root-notice.md)                                           | JS Module |
-| [rule-meta-helpers.mjs](rule-meta-helpers.md)                               | JS Module |
-| [rule-meta.mjs](rule-meta.md)                                               | JS Module |
-| [rule-predicates.mjs](rule-predicates.md)                                   | JS Module |
-| [run-conftest-batch.mjs](run-conftest-batch.md)                             | JS Module |
-| [run-lint-step.mjs](run-lint-step.md)                                       | JS Module |
-| [run-lint.mjs](run-lint.md)                                                 | JS Module |
-| [run-rule-cli.mjs](run-rule-cli.md)                                         | JS Module |
-| [run-rule.mjs](run-rule.md)                                                 | JS Module |
-| [run-standard-lint.mjs](run-standard-lint.md)                               | JS Module |
-| [run-standard-rule.mjs](run-standard-rule.md)                               | JS Module |
-| [skill-meta.mjs](skill-meta.md)                                             | JS Module |
-| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md)                   | JS Module |
-| [template.mjs](template.md)                                                 | JS Module |
-| [timing-summary.mjs](timing-summary.md)                                     | JS Module |
-| [workspaces.mjs](workspaces.md)                                             | JS Module |
-| [worktree-notice.mjs](worktree-notice.md)                                   | JS Module |
+| [discover-checkable-rules.mjs](discover-checkable-rules.md) | JS Module |
+| [ensure-tool.mjs](ensure-tool.md) | JS Module |
+| [generated-markdown.mjs](generated-markdown.md) | JS Module |
+| [gha-workflow.mjs](gha-workflow.md) | JS Module |
+| [inline-template-links.mjs](inline-template-links.md) | JS Module |
+| [list-project-rules-mdc.mjs](list-project-rules-mdc.md) | JS Module |
+| [list-rule-ids.mjs](list-rule-ids.md) | JS Module |
+| [load-cursor-config.mjs](load-cursor-config.md) | JS Module |
+| [mirror-parity.mjs](mirror-parity.md) | JS Module |
+| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md) | JS Module |
+| [resolve-target-files.mjs](resolve-target-files.md) | JS Module |
+| [root-notice.mjs](root-notice.md) | JS Module |
+| [rule-meta-helpers.mjs](rule-meta-helpers.md) | JS Module |
+| [rule-meta.mjs](rule-meta.md) | JS Module |
+| [rule-predicates.mjs](rule-predicates.md) | JS Module |
+| [run-conftest-batch.mjs](run-conftest-batch.md) | JS Module |
+| [run-lint-step.mjs](run-lint-step.md) | JS Module |
+| [run-lint.mjs](run-lint.md) | JS Module |
+| [run-rule-cli.mjs](run-rule-cli.md) | JS Module |
+| [run-rule.mjs](run-rule.md) | JS Module |
+| [run-standard-lint.mjs](run-standard-lint.md) | JS Module |
+| [run-standard-rule.mjs](run-standard-rule.md) | JS Module |
+| [skill-meta.mjs](skill-meta.md) | JS Module |
+| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md) | JS Module |
+| [template.mjs](template.md) | JS Module |
+| [timing-summary.mjs](timing-summary.md) | JS Module |
+| [workspaces.mjs](workspaces.md) | JS Module |
+| [worktree-notice.mjs](worktree-notice.md) | JS Module |

package/scripts/lib/fix/docs/index.md

@@ -6,14 +6,16 @@ resource: npm/scripts/lib/fix/
 
 # npm/scripts/lib/fix
 
-| Файл                                                  | Тип       |
-| ----------------------------------------------------- | --------- |
-| [analyze-escalation.mjs](analyze-escalation.md)       | JS Module |
-| [escalation-log.mjs](escalation-log.md)               | JS Module |
-| [llm-fix-apply.mjs](llm-fix-apply.md)                 | JS Module |
-| [llm-lint-fix.mjs](llm-lint-fix.md)                   | JS Module |
-| [llm-worker.mjs](llm-worker.md)                       | JS Module |
-| [orchestrator.mjs](orchestrator.md)                   | JS Module |
+| Файл | Тип |
+|---|---|
+| [analyze-escalation.mjs](analyze-escalation.md) | JS Module |
+| [discover-t0-patterns.mjs](discover-t0-patterns.md) | JS Module |
+| [escalation-log.mjs](escalation-log.md) | JS Module |
+| [llm-fix-apply.mjs](llm-fix-apply.md) | JS Module |
+| [llm-lint-fix.mjs](llm-lint-fix.md) | JS Module |
+| [llm-worker.mjs](llm-worker.md) | JS Module |
+| [orchestrator.mjs](orchestrator.md) | JS Module |
 | [run-conformance-check.mjs](run-conformance-check.md) | JS Module |
-| [t0.mjs](t0.md)                                       | JS Module |
-| [verbose-block.mjs](verbose-block.md)                 | JS Module |
+| [t0.mjs](t0.md) | JS Module |
+| [verbose-block.mjs](verbose-block.md) | JS Module |
+| [vscode-ext-add.mjs](vscode-ext-add.md) | JS Module |

package/skills/doc-aggregate/SKILL.md

@@ -37,29 +37,19 @@ npx @nitra/cursor lint-doc-files --git
 
 ## Крок 1: Tier 2 — module-summary
 
-Зібрати список модулів:
+Зібрати список воркспейсів з кореневого `package.json`:
 
 ```bash
-npx @nitra/cursor doc-aggregate modules
+node -e "const p=JSON.parse(require('fs').readFileSync('package.json','utf8')); console.log(JSON.stringify(p.workspaces))"
 ```
 
-Команда друкує JSON-масив (усі шляхи абсолютні):
-
-```json
-[
-  {
-    "moduleRoot": "/abs/npm/rules/adr",
-    "relRoot": "npm/rules/adr",
-    "slug": "npm-rules-adr",
-    "docPath": "/abs/npm/rules/adr/docs/ARCHITECTURE.md",
-    "members": ["npm/rules/adr/index.mjs"],
-    "exists": false
-  }
-]
-```
+Для кожного воркспейсу `<ws>`:
+- `relRoot` = `<ws>` (напр. `npm`, `demo`)
+- `docPath` = `<ws>/docs/ARCHITECTURE.md`
+- `members` — кодові файли (`.mjs .ts .vue .py`, крім тестів) у `<ws>/`
 
-module-summary **завжди регенерується** (це агрегат — поле `exists` ігноруй). Розбий модулі
-на батчі по 5 і диспатч субагентів. Промпт кожного (підстав `relRoot`, `docPath`, `members`):
+module-summary **завжди регенерується**. Розбий воркспейси на батчі по 5 і диспатч субагентів.
+Промпт кожного (підстав `relRoot`, `docPath`, `members`):
 
 ```
 Напиши module-summary для одного логічного модуля.

package/skills/doc-aggregate/js/docs/index.md

@@ -9,4 +9,3 @@ resource: npm/skills/doc-aggregate/js/
 | Файл                                  | Тип       |
 | ------------------------------------- | --------- |
 | [docgen-ignore.mjs](docgen-ignore.md) | JS Module |
-| [docgen-scan.mjs](docgen-scan.md)     | JS Module |

package/skills/doc-aggregate/js/docgen-scan.mjs

@@ -1,195 +0,0 @@
-/** @see ./docs/docgen-scan.md */
-import { join, relative, dirname, extname, sep, isAbsolute, resolve } from 'node:path'
-import { existsSync, readdirSync, statSync } from 'node:fs'
-
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { isDocgenIgnored } from './docgen-ignore.mjs'
-
-/** Кодові розширення, для яких генеруємо документацію. */
-const SOURCE_EXTENSIONS = new Set(['.js', '.mjs', '.ts', '.vue', '.py'])
-
-/** `*.test.*`, `*.spec.*` — тести, документувати не треба. */
-const TEST_FILE_RE = /\.(?:test|spec)\.[^.]+$/u
-
-/**
- * Чи корінь має system-wide docs layout (зарезервований під repo docs/adr тощо).
- * @param {string} root абсолютний корінь обходу
- * @returns {boolean} true — корінь system-wide docs
- */
-function isSystemWideDocsRoot(root) {
-  return existsSync(join(root, 'docs', 'adr')) || existsSync(join(root, 'docs', 'explanation'))
-}
-
-/**
- * Чи є файл кодовим джерелом для документування.
- * @param {string} fileName базове ім'я файлу
- * @returns {boolean} true — документуємо
- */
-export function isSourceFile(fileName) {
-  if (fileName.endsWith('.d.ts')) return false
-  if (TEST_FILE_RE.test(fileName)) return false
-  return SOURCE_EXTENSIONS.has(extname(fileName))
-}
-
-/**
- * Рекурсивно збирає кодові файли проєкту (posix-шляхи від кореня).
- * @param {string} root абсолютний корінь обходу
- * @returns {string[]} sourcePath-и
- */
-export function scanSourceFiles(root) {
-  const results = []
-
-  /** @param {string} dir поточний каталог обходу */
-  function walk(dir) {
-    let entries
-    try {
-      entries = readdirSync(dir, { withFileTypes: true })
-    } catch {
-      return
-    }
-    for (const entry of entries) {
-      const fullPath = join(dir, entry.name)
-      const relPath = relative(root, fullPath)
-      if (entry.isDirectory()) {
-        if (isDocgenIgnored(relPath, 'dir')) continue
-        walk(fullPath)
-      } else if (entry.isFile() && isSourceFile(entry.name)) {
-        if (isSystemWideDocsRoot(root) && dirname(relPath) === '.') continue
-        const sourcePath = relPath.split(sep).join('/')
-        if (isDocgenIgnored(sourcePath)) continue
-        results.push(sourcePath)
-      }
-    }
-  }
-
-  walk(root)
-  return results
-}
-
-/**
- * Стабільний slug модуля з його відносного шляху (для лейблів/логів).
- * @param {string} root абсолютний корінь обходу
- * @param {string} moduleRoot абсолютний корінь модуля
- * @returns {string} slug: `npm/rules/adr` → `npm-rules-adr`, корінь → `root`
- */
-export function slugForModule(root, moduleRoot) {
-  const rel = relative(root, moduleRoot)
-  if (rel === '') return 'root'
-  return rel
-    .split(sep)
-    .join('-')
-    .replaceAll(/[^\w-]+/gu, '-')
-}
-
-/**
- * Знаходить корені модулів — теки з `package.json` (корінь завжди модуль).
- * @param {string} root абсолютний корінь обходу
- * @returns {string[]} абсолютні шляхи коренів модулів
- */
-export function findModuleRoots(root) {
-  const roots = [root]
-
-  /** @param {string} dir поточний каталог обходу */
-  function walk(dir) {
-    let entries
-    try {
-      entries = readdirSync(dir, { withFileTypes: true })
-    } catch {
-      return
-    }
-    for (const entry of entries) {
-      const fullPath = join(dir, entry.name)
-      const relPath = relative(root, fullPath)
-      if (entry.isDirectory()) {
-        if (isDocgenIgnored(relPath, 'dir')) continue
-        walk(fullPath)
-      } else if (entry.isFile() && entry.name === 'package.json' && dir !== root) {
-        roots.push(dir)
-      }
-    }
-  }
-
-  walk(root)
-  return roots
-}
-
-/**
- * Найближчий модуль-предок для файлу (найдовший збіг шляху).
- * @param {string} filePath абсолютний шлях до файлу
- * @param {string[]} moduleRoots абсолютні корені модулів
- * @returns {string|null} абсолютний корінь модуля або null
- */
-export function nearestModuleRoot(filePath, moduleRoots) {
-  let best = null
-  for (const moduleRoot of moduleRoots) {
-    const rel = relative(moduleRoot, filePath)
-    if (rel.startsWith('..') || isAbsolute(rel)) continue
-    if (best === null || moduleRoot.length > best.length) best = moduleRoot
-  }
-  return best
-}
-
-/**
- * Лістить логічні модулі проєкту з членами-файлами і docPath module-summary.
- * Модулі без кодових файлів пропускаються.
- * @param {string} root абсолютний корінь обходу
- * @returns {Array<{moduleRoot:string, relRoot:string, slug:string, docPath:string, members:string[], exists:boolean}>} модулі (members — sourcePath-и від root)
- */
-export function scanForModules(root) {
-  const files = scanSourceFiles(root)
-  const moduleRoots = findModuleRoots(root)
-  const byRoot = new Map()
-  for (const sourcePath of files) {
-    const moduleRoot = nearestModuleRoot(join(root, sourcePath), moduleRoots)
-    if (moduleRoot === null) continue
-    if (!byRoot.has(moduleRoot)) byRoot.set(moduleRoot, [])
-    byRoot.get(moduleRoot).push(sourcePath)
-  }
-
-  const results = []
-  for (const moduleRoot of moduleRoots) {
-    const members = byRoot.get(moduleRoot)
-    if (!members || members.length === 0) continue
-    const docPath = join(moduleRoot, 'docs', 'ARCHITECTURE.md')
-    results.push({
-      moduleRoot,
-      relRoot: relative(root, moduleRoot) || '.',
-      slug: slugForModule(root, moduleRoot),
-      docPath,
-      members: members.toSorted(),
-      exists: existsSync(docPath)
-    })
-  }
-  return results
-}
-
-/**
- * Парсить `--root <dir>`; default — cwd.
- * @param {string[]} argv аргументи після підкоманди
- * @returns {string} абсолютний корінь
- */
-export function resolveRoot(argv) {
-  const i = argv.indexOf('--root')
-  return i !== -1 && argv[i + 1] ? resolve(argv[i + 1]) : process.cwd()
-}
-
-/**
- * `doc-aggregate modules` — сканує модулі і друкує JSON-масив у stdout.
- * @param {string[]} argv аргументи після назви субкоманди
- * @returns {number} exit-код: 0 — успіх, 1 — корінь не існує
- */
-export function runDocAggregateModulesCli(argv) {
-  const root = resolveRoot(argv)
-  if (!existsSync(root) || !statSync(root).isDirectory()) {
-    console.error(`doc-aggregate modules: корінь не існує або не є директорією: ${root}`)
-    return 1
-  }
-  console.log(JSON.stringify(scanForModules(root), null, 2))
-  return 0
-}
-
-if (isRunAsCli(import.meta.url)) {
-  // Прямий запуск: `node skills/doc-aggregate/js/docgen-scan.mjs modules --root <dir>`
-  const [sub, ...rest] = process.argv.slice(2)
-  process.exitCode = runDocAggregateModulesCli(sub === 'modules' ? rest : process.argv.slice(2))
-}

package/skills/doc-aggregate/js/docs/docgen-scan.md

@@ -1,76 +0,0 @@
----
-type: JS Module
-title: docgen-scan.mjs
-resource: npm/skills/doc-aggregate/js/docgen-scan.mjs
-docgen:
-  crc: 193dd362
-  score: 100
----
-
-isSourceFile
-Перевіряє, чи є файл коду, який слугує джерелом для документування.
-
-scanSourceFiles
-Рекурсивно збирає кодові файли проєкту за позикс-шляхами від кореня.
-
-slugForModule
-Генерує стабільний slug модуля на основі його відносного шляху.
-
-findModuleRoots
-Знаходить абсолютні шляхи коренів модулів, використовуючи дані з package.json.
-
-nearestModuleRoot
-Визначає найближчий модуль-предок для заданого файлу серед усіх доступних коренів модулів.
-
-scanForModules
-Лістить логічні модулі, збираючи члени-файли та інформацію про наявність документації.
-
-resolveRoot
-Парсить аргументи для визначення абсолютної кореневої директорії.
-
-runDocAggregateModulesCli
-Сканує модулі та виводить масив JSON у stdout.
-
-## Поведінка
-
-isSourceFile
-Перевіряє, чи є файл кодовим джерелом для документування
-
-scanSourceFiles
-Рекурсивно збирає кодові файли проєкту по позикс-шляхах від кореня
-
-slugForModule
-Генерує стабільний slug модуля з його відносним шляхом
-
-findModuleRoots
-Знаходить абсолютні шляхи коренів модулів з файлами package.json
-
-nearestModuleRoot
-Знаходить найближчий модуль-предок для файлу серед наявних коренів модулів
-
-scanForModules
-Лістить логічні модулі, збираючи члени-файли та інформацію про наявність документації
-
-resolveRoot
-Парсить аргументи для визначення абсолютного кореня
-
-runDocAggregateModulesCli
-Сканує модулі та виводить JSON-масив у stdout
-
-## Публічний API
-
-- isSourceFile — визначає, чи є файл коду для документування.
-- scanSourceFiles — рекурсивно збирає файли коду проєкту (від кореня за POSIX-шляхом).
-- slugForModule — генерує стабільний slug модуля з його відносним шляхом (для лейблів/логів).
-- findModuleRoots — знаходить кореневі директорії модулів у `package.json` (корінь — це модуль).
-- nearestModuleRoot — визначає найближчий модуль-предок для файлу (найдовший збіг шляху).
-- scanForModules — лістить логічні модулі проєкту з членами-файлами та `docPath module-summary`. Пропускає модулі без кодових файлів.
-- resolveRoot — парсить аргумент `--root <dir>`; за замовчуванням використовує поточну директорію.
-- runDocAggregateModulesCli — виконує команду `doc-aggregate modules`, скануючи модулі та виводячи JSON-масив у stdout.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.