@nitra/cursor 10.3.0 → 11.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [11.0.0] - 2026-06-15
+
+### Removed
+
+- CLI: прибрано надлишкові точки входу заради мінімальної поверхні. `lint-ci` видалено — це був чистий аліас `lint --read-only --full` (CI лишається тим самим прапор-комбо). Deprecated-аліас `doc-files <sub>` (`scan|check|gen|stamp`) видалено — 0 живих callerів (hook давно на `lint-doc-files`, скіл на `lint-doc-files`/`fix-doc-files`). Заодно полагоджено застарілу документацію точок входу в `bin/n-cursor.js` (мертві згадки `fix`, опис `lint` → data-driven по `meta.json:lint`) і схему `rule-meta.json` (enum `quick|ci` → `per-file|full`, відповідає реальним значенням і `parseRuleLintSpec`).
+
 ## [10.3.0] - 2026-06-15
 
 ### Added

package/package.json

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

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

@@ -1,7 +1,8 @@
 ---
 docgen:
   source: npm/rules/doc-files/js/docgen-extract.mjs
-  crc: e790ff64
+  crc: a0680e77
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
@@ -9,31 +10,32 @@ docgen:
 
 ## Огляд
 
-Файл витягує факти про конфігурацію та структуру проекту. Визначає мову та заголовок файлу. Витягує публічні експорти та імпорти з різних джерел. Витягує внутрішні та локальні символи. Документація перевіряє наявність операцій запису, обробки помилок, повернення хибних значень при невдачах, мережевих викликів, механізмів кешування та пропуск певних шляхів.
+Витягує структурований факт-лист з вмісту файлів, аналізуючи їх залежно від мови. Для Rust витягує модульний опис, публічні експорти, локальні символи та класифікує імпорти й поведінкові маркери. Для JavaScript/TypeScript/MJS витягує опис, експортовані елементи з JSDoc, класифікує імпорти та визначає поведінкові маркери. При аналізі ігноруються директорії: .github, .git, node_modules, base/, ua/, .firebase. Звертається до мережі та кешує дані протягом одного прогону.
 
 ## Поведінка
 
-1. Витягується факт про файл.
-2. Визначається мова файлу.
-3. Витягується заголовок файлу.
-4. Витягуються публічні експорти.
-5. Витягуються імпорти, класифіковані за джерелом.
-6. Витягуються внутрішні символи, імпортовані з внутрішніх модулів.
-7. Витягуються локальні символи, неекспортовані функції.
-8. Визначаються евристичні маркери.
-    * readOnly: перевірка на наявність операцій запису.
-    * catchesErrors: перевірка на наявність обробки помилок.
-    * returnsFalsyOnFail: перевірка на повернення хибних значень при невдачах.
-    * network: перевірка на наявність мережевих викликів.
-    * caches: перевірка на наявність механізмів кешування.
-    * skips: пропуск шляхів .github, .git, node_modules, base/, ua/, .firebase.
+1. Витягує факт-лист з вмісту файлу.
+2. Визначає мову файлу за розширенням.
+3. Якщо мова — Rust, виконує аналіз Rust-коду:
+    а. Витягує модульний опис з `//!`.
+    б. Визначає публічні експорти (структури, функції, енуми) на основі `pub` префікса або експозиційних атрибутів.
+    в. Визначає локальні (приватні) символи, які не є публічними.
+    г. Класифікує імпорти (`std`, зовнішні, внутрішні).
+    д. Визначає поведінкові маркери (readOnly, network, caches тощо) на основі специфічних Rust-конструкцій.
+4. Якщо мова — JavaScript/TypeScript/MJS, виконує аналіз JS-коду:
+    а. Витягує загальний опис файлу з верхнього блоку коментарів.
+    б. Витягує експортовані функції та класи разом із їхніми JSDoc-описами.
+    в. Класифікує імпорти на стандартні бібліотеки, NPM-пакети та внутрішні модулі.
+    г. Визначає локальні (неекспортовані) функції та класи.
+    д. Визначає поведінкові маркери (readOnly, network, caches тощо) на основі евристик.
+5. При аналізі JS-коду, свідомо ігнорує шляхи: .github, .git, node_modules, base/, ua/, .firebase.
+6. Повертає структуру фактів, що містить метадані про файл.
 
 ## Публічний API
 
-extractFacts — код файлу перетворює на список фактів
+extractFacts — витягує факти з вмісту файлу.
 
 ## Гарантії поведінки
 
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
 - Кешує результати в межах одного прогону.
 - Свідомо пропускає шляхи: `.github`, `.git`, `node_modules`, `base/`, `ua/`, `.firebase`.

package/rules/doc-files/js/docs/docgen-judge-measure.md

@@ -0,0 +1,30 @@
+---
+docgen:
+  source: npm/rules/doc-files/js/docgen-judge-measure.mjs
+  crc: b40b626c
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+# docgen-judge-measure.mjs
+
+## Огляд
+
+Файл аналізує вміст визначеного списку файлів, створюючи технічну документацію на основі вихідного коду. Процес спирається на конфігурацію, визначену в report.json. Для кожного файлу відбувається кешування результатів у межах прогону. Якість згенерованої документації оцінюється хмарною моделлю шляхом порівняння з пороговими значеннями, заданими в report.json. Результати аналізу агрегуються, обчислюється відсоток хибнопозитивних спрацювань та зберігаються у report.json.
+
+## Поведінка
+
+1. Зчитує список файлів для аналізу.
+2. Для кожного файлу зчитує його вміст.
+3. Генерує технічну документацію для файлу, використовуючи кеш за вмістом вихідного коду.
+4. Якщо документація згенерована, перевіряє її якість за встановленим порогом.
+5. Якщо якість документації відповідає порогу, передає вміст вихідного коду та згенеровану документацію для оцінки.
+6. Оцінює документацію за допомогою сильної хмарної моделі, використовуючи кеш за вмістом вихідного коду та документації.
+7. Збирає результати для кожного файлу.
+8. Агрегує результати, обчислюючи відсоток хибнопозитивних спрацювань (false-positive rate) серед документів, які пройшли порогову перевірку та були оцінені.
+9. Зберігає повний звіт у файл `report.json` у директорії кешу.
+10. Виводить консольний звіт про результати вимірювання.
+
+## Гарантії поведінки
+
+- Кешує результати в межах одного прогону.

package/rules/doc-files/js/docs/docgen-prompts.md

@@ -1,7 +1,8 @@
 ---
 docgen:
   source: npm/rules/doc-files/js/docgen-prompts.mjs
-  crc: 72ac304f
+  crc: 28c9e818
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
@@ -9,31 +10,29 @@ docgen:
 
 ## Огляд
 
-Файл надає інструкції для створення лаконічної поведінкової документації українською мовою. Він містить інструменти для формування, перевірки та виправлення тексту документації, а також для визначення гарантій щодо роботи файлу
+Генерує технічну документацію на основі коду. Створює компоненти документації, такі як огляд (`overviewMessages`), повідомлення для секцій (`sectionMessages`), повідомлення для критики (`criticMessages`), повідомлення для уточнення (`refineMessages`) та гарантії, отримані з маркерів (`guaranteesFromMarkers`), застосовуючи заданий стиль (`STYLE`).
 
 ## Поведінка
 
-Поведінка:
-- STYLE: Надає інструкцію для генерації лаконічної поведінкової документації українською мовою.
-- sectionMessages: Генерує секційні промпти для різних частин документації.
-- overviewMessages: Формує текст для узагальнення ролі та призначення файлу.
-- criticMessages: Створює запити для перевірки чорновиків документації на наявність дефектів.
-- refineMessages: Переписує та виправляє чорновки документації відповідно до критики.
-- guaranteesFromMarkers: Формує список гарантій щодо поведінки файлу на основі маркерів.
-- oneShotMessages: Створює універсальний запит для генерації повної документації.
+STYLE: Пише лаконічну поведінкову документацію до коду українською мовою, використовуючи чистий Markdown.
+sectionMessages: Генерує набір промптів для різних секцій документації, використовуючи метадані файлу та вміст коду.
+overviewMessages: Створює узагальнений огляд файлу, базуючись на вже згенерованій секції «Поведінка».
+criticMessages: Перевіряє чорнетку секції на відповідність технічним критеріям, виявляючи дефекти.
+refineMessages: Переписує чорнетку секції, виправляючи дефекти, виявлені критиком.
+guaranteesFromMarkers: Формує список гарантій поведінки, виходячи з машинно-виведених маркерів файлу.
+oneShotMessages: Генерує базовий промпт для генерації повної документації за один виклик.
 
 ## Публічний API
 
-STYLE — Формулює стиль файлу.
-sectionMessages — Збирає повідомлення з мінімальним контекстом для кожної секції.
-overviewMessages — Надає узагальнення поведінки файлу.
-criticMessages — Виявляє дефекти в чорнетці секції.
-refineMessages — Виправляє чорнетку, усуваючи виявлені дефекти.
-guaranteesFromMarkers — Створює детермінований шаблон гарантій поведінки з фактів.
+STYLE — Визначає загальний стиль та намір файлу.
+sectionMessages — Містить мінімально необхідний контекст для кожної секції.
+overviewMessages — Генерує узагальнений огляд на основі вже визначеної поведінки.
+criticMessages — Виявляє конкретні недоліки у чорновому тексті секції, повертаючи список проблем або відсутність проблем.
+refineMessages — Переписує чорновий текст, виправляючи виявлені недоліки.
+guaranteesFromMarkers — Створює чіткий шаблон секції «Гарантії поведінки» на основі фактів.
+oneShotMessages — Надає приклади для порівняння.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Кешує результати в межах одного прогону.
-- Не звертається до мережі.