@nitra/cursor 5.1.0 → 5.2.1

package/skills/docgen/js/docs/docgen-ignore.md

@@ -1,24 +0,0 @@
-# docgen-ignore.mjs
-
-## Огляд
-
-Цей файл містить список глобальних файлів, які `docgen` ігнорує під час генерації документації. Він використовується для визначення, які файли не потрібно аналізувати, забезпечуючи ефективність процесу генерації та запобігаючи включенню нерелевантної інформації. Цей список є основою для predicate, який scanner використовує для визначення, чи потрібно читати певний файл.
-
-## Поведінка
-
-DOCGEN_IGNORE_GLOBS: визначає список глобів, які `docgen` ігнорує.
-isDocgenIgnored: перевіряє, чи шлях має бути пропущений `docgen`, використовуючи глоби.
-
-## Публічний API
-
-- DOCGEN_IGNORE_GLOBS — Список glob-ів, які ігнорує `docgen`.
-- isDocgenIgnored — Перевіряє, чи потрібно пропустити шлях під час генерації документації.
-
-## Гарантії поведінки
-
-- `DOCGEN_IGNORE_GLOBS` завжди ігнорує певний набір шляхів.
-- `isDocgenIgnored` повертає `true` якщо шлях ігнорується.
-- Шляхи `.git` та `node_modules` завжди ігноруються.
-- Файл є read-only.
-- У разі невдачі повертає `false` або `null`.
-- Результат прогону кешується для подальшого використання.

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

@@ -1,24 +0,0 @@
-# docgen-prompts.mjs
-
-## Огляд
-
-Цей файл містить опис коду для конвеєра docgen. Він визначає точкові промпти для кожної секції коду, що генерується. Це дозволяє ефективно генерувати документацію на основі коду.
-
-## Поведінка
-
-Напиши вміст секції «Поведінка»: для кожної публічної функції — один короткий пункт «що вона робить». Якщо у фактах є свідомі пропуски шляхів — згадай їх там, де доречно (не вигадуй інших «не перевіряє»). НЕ пиши аргументи функцій у дужках, без regex. Без заголовка.
-
-## Публічний API
-
-- STYLE — Підготовка документації на першому етапі генерації: створення факт-листа та коду, а потім генерація точкових промптів для кожної секції.
-- v2 — Мінімальний контекст секції: код розміщується лише в `Поведінку`. `Огляд` містить лише заголовок, `API` – список експортів, `Гарантії` – маркери. Це дозволяє один раз обробити інсульт коду, а не секцію за секцією.
-- sectionMessages — Набори повідомлень для кожної секції з мінімальним контекстом. Код розміщується лише в `Поведінку`, решта – на факт-листи.
-- oneShotMessages — База повідомлень для порівняння.
-- oneShotPromptText — Текст user-промпту для one-shot (для резервного копіювання в хмарі через Anthropic SDK).
-
-## Гарантії поведінки
-
-- `docgen-конвеєр` кешує результати генерації промптів для кожної секції.
-- `Огляд` містить лише заголовок секції.
-- `API` містить лише список експортів секції.
-- `Гарантії` містять лише маркери.

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

@@ -1,48 +0,0 @@
-# docgen-scan.mjs
-
-## Огляд
-
-`docgen scanner` обходить проєкт, щоб створити JSON-список кодових файлів, розташованих у теці `docs/` поряд із джерелом. Цей список використовується іншими скілами для генерації документації. Інструмент забезпечує детермінований обхід проєкту та відстежує наявність файлів, не використовуючи мережеві ресурси чи LLM.
-
-## Поведінка
-
-- `isSourceFile`: Перевіряє, чи файл є джерелом коду, враховуючи розширення та тестові файли.
-- `docPathForSource`: Генерує шлях до файлу документації для заданого джерела, враховуючи відносні шляхи.
-- `scanForDocgen`: Рекурсивно обходить дерево проєкту, визначаючи кодові файли, які потрібно документувати, та їх відповідні шляхи до документації.
-- `slugForModule`: Генерує унікальний slug для модуля на основі його відносного шляху.
-- `findModuleRoots`: Знаходить абсолютні шляхи коренів модулів проєкту.
-- `nearestModuleRoot`: Знаходить найближчий модуль-предок для заданого файлу.
-- `scanForModules`: Лістить модулі проєкту, визначаючи їхні члени (sourcePath-и) та шляхи до документації.
-- `resolveRoot`: Визначає абсолютний корінь проєкту на основі аргументів командного рядка.
-- `runDocgenScanCli`: Запускає сканування docgen як CLI, виводить JSON-масив у stdout та повертає код виходу.
-- `runDocgenModulesCli`: Запускає сканування модулів docgen як CLI, виводить JSON-масив у stdout та повертає код виходу.
-
-## Публічний API
-
-- isSourceFile — Визначає, чи є файл кодовим джерелом для створення документації.
-- docPathForSource — Генерує шлях до md-файлу, пов'язаний з кодовим файлом.
-- scanForDocgen — Рекурсивно обстежує структуру проєкту, виявляючи файли для документування.
-- slugForModule — Створює унікальний ідентифікатор (slug) для модуля на основі його шляху.
-- findModuleRoots — Знаходить корені модулів, визначаючи директорії з файлом `package.json`.
-- nearestModuleRoot — Визначає найближчий модуль-предок для заданого файлу.
-- scanForModules — Створює список логічних модулів проєкту, включаючи файли та інформацію про них.
-- resolveRoot — Встановлює базову директорію для сканування, використовуючи аргумент командного рядка або поточну директорію.
-- runDocgenScanCli — Запускає сканування для виявлення файлів документації та виводить результат у форматі JSON.
-- runDocgenModulesCli — Запускає сканування модулів та виводить результат у форматі JSON.
-
-## Гарантії поведінки
-
-- `isSourceFile` повертає `true`, якщо вказаний шлях до файлу є джерелом коду.
-- `isSourceFile` повертає `false` в іншому випадку.
-- `docPathForSource` повертає шлях до відповідної папки `docs/` для вказаного джерела.
-- `scanForDocgen` повертає JSON-список шляхів до кодових файлів, які потрібно обробити.
-- `scanForDocgen` встановлює прапор `exists` у випадку, якщо файл або папка вже існують.
-- `slugForModule` повертає унікальний URL-шлях для модуля.
-- `findModuleRoots` повертає список кореневих модулів проєкту.
-- `nearestModuleRoot` повертає найближчий кореневий модуль до вказаного шляху.
-- `scanForModules` повертає список модулів проєкту.
-- `resolveRoot` повертає кореневу папку проєкту.
-- `runDocgenScanCli` запускає процес сканування для `docgen`.
-- `runDocgenModulesCli` запускає процес сканування для модулів.
-- У разі невдачі повертається `false` та `null`.
--