@nitra/cursor 12.8.4 → 12.8.6

package/scripts/lib/rule-meta.mjs

@@ -1,7 +1,7 @@
 /**
- * Парсер метаданих правила з `npm/rules/<id>/meta.json` (data-driven автодетект).
+ * Парсер метаданих правила з `npm/rules/<id>/main.json` (data-driven автодетект).
  *
- * `meta.json.auto` має один із чотирьох видів:
+ * `main.json.auto` має один із чотирьох видів:
  *  - `"завжди"`                       → always-on;
  *  - `["rule", …]`                    → активується, коли всі правила-залежності виявлені;
  *  - `{ "glob": "<pat>" | [<pat>] }`  → наявність файлів/каталогів за glob (OR);
@@ -20,7 +20,7 @@ export const RULE_ALWAYS = 'завжди'
  */
 
 /**
- * Нормалізує значення `meta.json.auto` у дискриміновану форму.
+ * Нормалізує значення `main.json.auto` у дискриміновану форму.
  * @param {unknown} value значення поля `auto`
  * @returns {RuleAutoSpec | null} `null` — формат не розпізнано (= opt-in)
  */
@@ -48,11 +48,11 @@ export function parseRuleAutoSpec(value) {
   return null
 }
 
-/** Допустимі значення `meta.json.lint` (вісь scope: чи детектор дробиться на changed-set). */
+/** Допустимі значення `main.json.lint` (вісь scope: чи детектор дробиться на changed-set). */
 const LINT_SCOPES = new Set(['per-file', 'full'])
 
 /**
- * Нормалізує значення `meta.json.lint` у scope детектора.
+ * Нормалізує значення `main.json.lint` у scope детектора.
  *  - `"per-file"` — детектор декомпозується на змінені файли (дельта vs origin);
  *  - `"full"`     — нероздільно крос-файловий (лише `--full` / CI).
  * Об'єктна форма `{scope, ci}` скасована: CI=`--read-only --full` ганяє все повністю,
@@ -65,7 +65,7 @@ export function parseRuleLintSpec(value) {
 }
 
 /**
- * Читає й парсить `meta.json` одного правила.
+ * Читає й парсить `main.json` одного правила.
  * @param {string} ruleDir абсолютний шлях до каталогу правила
  * @returns {Record<string, unknown> | null} обʼєкт або `null` (немає файлу / невалідний JSON / не-обʼєкт)
  */

package/scripts/lib/skill-meta.mjs

@@ -1,7 +1,7 @@
 /**
- * Спільний парсер метаданих скіла з `npm/skills/<id>/meta.json`.
+ * Спільний парсер метаданих скіла з `npm/skills/<id>/main.json`.
  *
- * `meta.json` — єдине джерело правди для скіла замість колишнього `auto.md`:
+ * `main.json` — єдине джерело правди для скіла замість колишнього `auto.md`:
  *  - `auto` — умова автоактивації (`"завжди"` | масив id правил), опційне;
  *  - `worktree` — boolean: чи виконувати скіл в окремому git-worktree (один інстанс);
  *  - `requireRoot` — boolean, опційне: чи скіл вимагає запуску з кореня репо.
@@ -24,8 +24,8 @@ export const SKILL_ALWAYS = 'завжди'
  */
 
 /**
- * Перетворює значення поля `auto` з `meta.json` у `SkillAutoSpec`.
- * @param {unknown} value значення `meta.json.auto`
+ * Перетворює значення поля `auto` з `main.json` у `SkillAutoSpec`.
+ * @param {unknown} value значення `main.json.auto`
  * @returns {SkillAutoSpec | null} `null` — формат не розпізнано (= opt-in)
  */
 export function parseSkillAutoSpec(value) {
@@ -43,7 +43,7 @@ export function parseSkillAutoSpec(value) {
 /**
  * Чи вимагає скіл запуску з кореня репо («активовано root-захист»). Єдина похідна
  * ознака: `worktree:true` (корінь гарантує worktree) АБО явний `requireRoot:true`.
- * @param {Record<string, unknown> | null} meta розпарсений `meta.json` (або null)
+ * @param {Record<string, unknown> | null} meta розпарсений `main.json` (або null)
  * @returns {boolean} true — скіл мутує проєкт і має стартувати з кореня
  */
 export function skillRequiresRoot(meta) {
@@ -51,7 +51,7 @@ export function skillRequiresRoot(meta) {
 }
 
 /**
- * Читає й парсить `meta.json` одного скіла.
+ * Читає й парсить `main.json` одного скіла.
  * @param {string} skillDir абсолютний шлях до каталогу скіла
  * @returns {Record<string, unknown> | null} розпарсений обʼєкт або `null` (немає файлу / невалідний JSON / не-обʼєкт)
  */

package/scripts/lib/worktree-notice.mjs

@@ -1,7 +1,7 @@
 /**
  * Вшивання worktree-інструкції у синкнутий `SKILL.md` (рішення D2 зі spec).
  *
- * Коли `meta.json.worktree === true`, скіл має виконуватись в окремому git-worktree
+ * Коли `main.json.worktree === true`, скіл має виконуватись в окремому git-worktree
  * і не паралелитись. Підказка адресована агенту, який читає `SKILL.md`, тож
  * вставляється в текст між стабільними маркерами — ре-синк ідемпотентний:
  * наявний блок замінюється, при `worktree:false` — видаляється.
@@ -159,7 +159,7 @@ function buildBlock(content) {
 /**
  * Вставляє / оновлює / видаляє worktree-блок у вмісті `SKILL.md`.
  * @param {string} content вміст `SKILL.md`
- * @param {boolean} enabled чи має бути блок (значення `meta.json.worktree`)
+ * @param {boolean} enabled чи має бути блок (значення `main.json.worktree`)
  * @returns {string} оновлений вміст (ідемпотентно)
  */
 export function injectWorktreeNotice(content, enabled) {

package/scripts/utils/docs/resolve-js-root.md

@@ -10,17 +10,17 @@ docgen:
 
 ## Огляд
 
-Визначає корінь JS-коду для проєктів, використовуючи `package.json` та `.n-cursor.json` як конфігураційні файли. Функція `resolveJsRoot` знаходить перший workspace (з підтримкою glob-патернів типу `cf/*`) для workspace-проєктів або корінь поточної директорії для single-package. Функція `resolveAllJsRoots` знаходить усі відповідні шляхи. Код свідомо ігнорує шляхи `.git` та `node_modules`. Ця утиліта є спільною для coverage-провайдера JS та test-концерну stryker_config (DRY).
+Визначає корінь JS-коду в проєкті, відповідно до логіки для workspace-projects (перший workspace з підтримкою glob-патернів `cf/*`) або single-package (корінь cwd). Ця утиліта є спільною для coverage-провайдера JS та test-концерну `stryker_config` (DRY). Публічні функції дозволяють отримати один або повний список шляхів до всіх JS-коренів, при цьому свідомо виключаються каталоги `.git` та `node_modules`. Код спирається на конфігураційні файли `package.json` та `.n-cursor.json`.
 
 ## Поведінка
 
-resolveJsRoot повертає абсолютний шлях до першого JS-кореня проєкту, якщо він існує, або null, якщо кореневий package.json відсутній.
-resolveAllJsRoots повертає масив абсолютних шляхів до всіх JS-коренів проєкту, враховуючи визначення `workspaces` у кореневому package.json, ігноруючи каталоги `.git` та `node_modules`.
+resolveJsRoot повертає абсолютний шлях до першого JS-кореня проєкту. Якщо кореневий `package.json` відсутній, повертає null.
+resolveAllJsRoots повертає масив абсолютних шляхів до всіх JS-коренів проєкту. Ігнорує каталоги `.git` та `node_modules`.
 
 ## Публічний API
 
 resolveJsRoot — знаходить кореневий каталог JavaScript-проєкту.
-resolveAllJsRoots — повертає шляхи до коренів усіх JavaScript-проєктів у робочому просторі.
+resolveAllJsRoots — повертає всі каталоги JavaScript-проєктів у робочому просторі.
 
 ## Гарантії поведінки
 

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {}
+export {};