@nitra/cursor 12.8.5 → 12.8.7

package/scripts/lib/docs/worktree-notice.md

@@ -3,24 +3,26 @@ type: JS Module
 title: worktree-notice.mjs
 resource: npm/scripts/lib/worktree-notice.mjs
 docgen:
-  crc: 1f7d5e0d
+  crc: b4358793
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Цей файл вшиває worktree-інструкцію у синкнутий `SKILL.md` (рішення D2 зі spec). Коли `meta.json.worktree === true`, скіл вставляє/замінює ідемпотентний ре-синкнутий блок, що містить маркери WORKTREE_START та WORKTREE_END, забезпечуючи виконання скілу в окремому git-worktree та запобігаючи паралелізації. Функція `injectWorktreeNotice` керує наявністю або відсутністю цього блоку в `SKILL.md` на основі конфігурації.
+## Огляд
+
+Управляє вставкою інструкцій для виконання команд у ізольованому git-worktree у синкнутий `SKILL.md` (рішення D2 зі spec). Коли `main.json.worktree === true`, інструкції вставляються між маркерами `WORKTREE_START` та `WORKTREE_END`. Це забезпечує ре-синк ідемпотентність: наявний блок замінюється, а при `main.json.worktree === false` — видаляється. Механізм адаптований для агента, який читає `SKILL.md`.
 
 ## Поведінка
 
-WORKTREE_START — Маркер початку блоку інструкцій для роботи в окремому git-worktree.
-WORKTREE_END — Маркер кінця блоку інструкцій для роботи в окремому git-worktree.
-injectWorktreeNotice — Вставляє, оновлює або видаляє блок інструкцій для роботи в worktree у вмісті SKILL.md залежно від булевого значення.
+WORKTREE_START: Позначає початок блоку інструкцій для роботи в окремому git-worktree.
+WORKTREE_END: Позначає кінець блоку інструкцій для роботи в окремому git-worktree.
+injectWorktreeNotice: Вставляє, оновлює або видаляє блок інструкцій для роботи в worktree у вмісті SKILL.md залежно від булевого значення.
 
 ## Публічний API
 
-WORKTREE_START — Позначає початок секції, що описує робоче дерево.
-WORKTREE_END — Позначає кінець секції, що описує робоче дерево.
-injectWorktreeNotice — Вставляє, змінює або видаляє блок інформації про робоче дерево у файлі `SKILL.md`.
+WORKTREE_START — Позначає початок блоку, що описує робоче дерево.
+WORKTREE_END — Позначає кінець блоку, що описує робоче дерево.
+injectWorktreeNotice — Додає, змінює або видаляє блок робочого дерева у файлі `SKILL.md`.
 
 ## Гарантії поведінки
 

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/index.md

@@ -6,18 +6,18 @@ resource: npm/scripts/utils/
 
 # npm/scripts/utils
 
-| Файл | Тип |
-|---|---|
-| [ast-scan-utils.mjs](ast-scan-utils.md) | JS Module |
+| Файл                                                        | Тип       |
+| ----------------------------------------------------------- | --------- |
+| [ast-scan-utils.mjs](ast-scan-utils.md)                     | JS Module |
 | [ensure-gitignore-entries.mjs](ensure-gitignore-entries.md) | JS Module |
-| [find-package-json-paths.mjs](find-package-json-paths.md) | JS Module |
-| [lock-cache-dir.mjs](lock-cache-dir.md) | JS Module |
-| [pass.mjs](pass.md) | JS Module |
-| [resolve-cargo-manifest.mjs](resolve-cargo-manifest.md) | JS Module |
-| [resolve-cmd.mjs](resolve-cmd.md) | JS Module |
-| [resolve-js-root.mjs](resolve-js-root.md) | JS Module |
-| [test-helpers.mjs](test-helpers.md) | JS Module |
-| [walk-cache.mjs](walk-cache.md) | JS Module |
-| [walkDir.mjs](walkDir.md) | JS Module |
-| [with-lock.mjs](with-lock.md) | JS Module |
-| [worktree-fingerprint.mjs](worktree-fingerprint.md) | JS Module |
+| [find-package-json-paths.mjs](find-package-json-paths.md)   | JS Module |
+| [lock-cache-dir.mjs](lock-cache-dir.md)                     | JS Module |
+| [pass.mjs](pass.md)                                         | JS Module |
+| [resolve-cargo-manifest.mjs](resolve-cargo-manifest.md)     | JS Module |
+| [resolve-cmd.mjs](resolve-cmd.md)                           | JS Module |
+| [resolve-js-root.mjs](resolve-js-root.md)                   | JS Module |
+| [test-helpers.mjs](test-helpers.md)                         | JS Module |
+| [walk-cache.mjs](walk-cache.md)                             | JS Module |
+| [walkDir.mjs](walkDir.md)                                   | JS Module |
+| [with-lock.mjs](with-lock.md)                               | JS Module |
+| [worktree-fingerprint.mjs](worktree-fingerprint.md)         | JS Module |