@nitra/cursor 5.3.3 → 5.4.0

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

@@ -1,32 +0,0 @@
----
-docgen:
-  source: npm/skills/doc-files/js/docgen-prompts.mjs
-  crc: c454d2a6
----
-
-# docgen-prompts
-
-## Огляд
-
-Промптовий шар local-only конвеєра файлових док: будує messages-набори для секційної генерації, критики й переписування, а секцію «Гарантії поведінки» формує детерміновано без LLM. Весь стиль документа (українська, поведінковість, заборона сигнатур) зашитий у спільний system-блок.
-
-## Поведінка
-
-1. Для кожної секції збирається мінімальний контекст: «Огляд» — лише людиночитний витяг фактів (без коду), «Поведінка» — єдина секція з повним кодом файлу у вікні, «Публічний API» — лише список експортів з їхніми описами. Анкори (URL, константи, маркери, приклади) додаються окремим блоком, коли вони є.
-2. Факт-лист перекладається в негативні й позитивні твердження для моделі: свідомі пропуски шляхів, read-only, перехоплення помилок, явне «Кешування: НЕМАЄ — не згадуй кеш» — щоб відсікти типові галюцинації ще в промпті.
-3. Критик отримує чорнетку секції і закритий список критеріїв дефектів (generic-фрази, пропущені анкори, граматика, підзаголовки, скопійовані сигнатури, вигадані факти); відповідь — список проблем або `NONE`. Переписувач отримує чорнетку разом зі списком проблем і повертає лише оновлений текст.
-4. «Гарантії поведінки» складаються шаблоном з маркерів факт-листа (read-only, fail-safe, кешування, пропуски шляхів, відсутність мережі) — нуль запитів і нуль generic-фраз; за відсутності маркерів — твердження про детермінованість.
-
-## Публічний API
-
-- `sectionMessages` — секційні набори messages з мінімальним контекстом під кожну секцію.
-- `criticMessages` / `refineMessages` — пара критика й переписувача для одного циклу уточнення секції.
-- `guaranteesFromMarkers` — детермінований текст секції гарантій з маркерів.
-- `oneShotMessages` — один запит на весь документ для нестандартних структур файлів.
-- `STYLE` — спільний system-блок стилю.
-
-## Гарантії поведінки
-
-- Код файлу потрапляє лише у промпт секції «Поведінка» й у one-shot — решта секцій працюють на факт-листі.
-- Формування промптів детерміноване: однакові факти й код → однакові messages.
-- Не звертається до мережі й не виконує LLM-викликів — лише будує тексти.

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

@@ -1,25 +0,0 @@
----
-docgen:
-  source: npm/skills/doc-files/js/docgen-scan.mjs
-  crc: b517ab25
----
-
-# docgen-scan
-
-## Огляд
-
-Сканер кодових файлів і детектор стану файлових док: які джерела підлягають документуванню, де лежить їхня дока, що застаріло, що degraded. Працює і як бібліотека для batch-генерації, і як CLI (`doc-files scan` / `doc-files check`) для хуків.
-
-## Поведінка
-
-1. Рекурсивний обхід від кореня збирає кодові файли (`js`/`mjs`/`ts`/`vue`/`py`), пропускаючи тести, оголошення типів, ignore-дерева і теки `docs/`; для кореня з system-wide docs-layout файлові доки на верхньому рівні не плануються.
-2. Для кожного джерела обчислюється шлях доки (`<dir>/docs/<stem>.md`) і стан застарілості за контрольною сумою.
-3. `check` працює в режимах: `--hook` — один файл зі stdin-payload редакторського хука; `--git` — змінені відносно HEAD джерела як Stop-гейт із порогом великого прогону (`--max`, дефолт `50` або `N_CURSOR_DOC_FILES_GATE_MAX`: більше застарілих — попередження без блоку); явні шляхи — точкова перевірка.
-4. Застарілі доки → exit-код `2` зі списком і підказкою перегенерації; усе свіже або великий прогін — `0`.
-5. `check --degraded` — інформаційний звіт (exit `0`): свіжі за сумою доки з оцінкою нижче порогу, з кодами проблем і підказкою про `gen --retry-degraded`. Degraded — видимий борг, не гейт.
-
-## Гарантії поведінки
-
-- Сканер read-only: жодних записів у дерево.
-- Рішення «застаріла/свіжа» детерміноване і залежить лише від вмісту джерела й frontmatter доки.
-- Stop-гейт ніколи не блокує масовий перший прогін понад поріг — захист від нескінченного блокування задач.

package/skills/doc-files/js/docs/units-rs.md

@@ -1,35 +0,0 @@
----
-docgen:
-  source: npm/skills/doc-files/js/units-rs.mjs
-  crc: 11099381
-  score: 100
----
-
-# units-rs.mjs
-
-## Огляд
-
-Файл аналізує рядки для визначення структури та елементів модуля. Він ітерує по рядках для визначення глибини, обробляє рядкові літерали для визначення зміщення, змінює глибину при зустрічі відкриваючої чи закриваючої фігу, видаляє відкриті блоки зі стека, перевіряє наявність атрибутів експонування, визначає декларації на верхньому рівні чи в модулях, а також витягує тіло функції та збирає виклики інших юнітів у тілі функції.
-
-## Поведінка
-
-1. Скан файлу по рядках.
-2. Ітерація по рядках для визначення глибини.
-3. Обробка рядкових літералів для визначення зміщення.
-4. Зміна глибини при зустрічі відкриваючої фігу.
-5. Зміна глибини при зустрічі закриваючої фігу.
-6. Видалення відкритих блоків з стека.
-7. Перевірка наявності атрибутів експонування.
-8. Визначення декларацій на верхньому рівні або в модулях.
-9. Визначення публічних функцій, структур, перерахувань, трейтів, типів.
-10. Витягування тіла функції через пошук закриваючої фігу.
-11. Збір викликів інших юнітів у тілі функції.
-
-## Публічний API
-
-extractUnitsRs — Визначає top-level і impl-методи через підрахунок дужок по рядках. Обмеження: рядкові літерали з `{`/`}` всередині `{}` можуть дати хибну глибину.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.