@nitra/cursor 12.8.5 → 12.8.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.8.6] - 2026-06-22
+
+### Changed
+
+- ✨ feat(rules/abie): http_route_base.mdc + активація + ua-домени у ua_http_route.mdc
+
 ## [12.8.5] - 2026-06-22
 
 ### Changed

package/bin/n-cursor.js

@@ -630,16 +630,16 @@ function buildClaudeLintParallelismSectionLines() {
 }
 
 /**
- * Рендерить секцію для CLAUDE.md: скіли з `meta.json.worktree === true` запускаються
+ * Рендерить секцію для CLAUDE.md: скіли з `main.json.worktree === true` запускаються
  * лише в окремому git-worktree (дублює fail-fast банер `SKILL.md` як завжди-читане правило).
  * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
  */
 function buildClaudeWorktreeEnforcementSectionLines() {
   return [
     '',
-    '## Worktree-only skills (`meta.json` → `worktree: true`)',
+    '## Worktree-only skills (`main.json` → `worktree: true`)',
     '',
-    'Скіл із **`worktree: true`** у `meta.json` запускається **виключно** в окремому git-worktree (`.worktrees/<current-branch>-<suffix>/`) — **не** в основному дереві й **не** паралельно. Перший крок такого скіла (блок `n-cursor:worktree:start` у його `SKILL.md`) — **preflight**: якщо `git rev-parse --show-toplevel` не вказує під `.worktrees/`, **STOP** і не питай користувача про назву гілки; створи worktree від поточної гілки готовим snippet з `SKILL.md` за конвенцією `<current-branch>-<suffix>` і без shell expansion (без command substitution, variable expansion чи backticks). Чисте робоче дерево — **не** привід пропустити preflight.',
+    'Скіл із **`worktree: true`** у `main.json` запускається **виключно** в окремому git-worktree (`.worktrees/<current-branch>-<suffix>/`) — **не** в основному дереві й **не** паралельно. Перший крок такого скіла (блок `n-cursor:worktree:start` у його `SKILL.md`) — **preflight**: якщо `git rev-parse --show-toplevel` не вказує під `.worktrees/`, **STOP** і не питай користувача про назву гілки; створи worktree від поточної гілки готовим snippet з `SKILL.md` за конвенцією `<current-branch>-<suffix>` і без shell expansion (без command substitution, variable expansion чи backticks). Чисте робоче дерево — **не** привід пропустити preflight.',
     ''
   ]
 }
@@ -795,10 +795,10 @@ async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
         const rootOnly = !worktree && meta?.requireRoot === true
         const entries = await readdir(srcDir, { withFileTypes: true })
         for (const entry of entries) {
-          // Лише top-level файли скіла. `meta.json` — метадані (не для споживача);
+          // Лише top-level файли скіла. `main.json` — метадані (не для споживача);
           // підкаталоги (`js/` — скіл-специфічний код) виконуються з пакета через
           // `npx`, у проєкт не копіюються (як `npm/rules/<id>/js/`). Див. scripts.mdc.
-          if (!entry.isFile() || entry.name === 'meta.json') continue
+          if (!entry.isFile() || entry.name === 'main.json') continue
           let content = await readFile(join(srcDir, entry.name), 'utf8')
           if (entry.name === 'SKILL.md') {
             content = injectWorktreeNotice(content, worktree)

package/package.json

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

package/rules/abie/js/http_route_base.mdc

@@ -0,0 +1,25 @@
+## k8s: **HTTPRoute** у base-шарі — домени `aiml.live`
+
+У **HTTPRoute** під шляхом **`…/k8s/.../base/...`** (сегмент `base` у path) усі значення **`spec.hostnames`** мають належати до домену **`aiml.live`**: точна відповідність **`aiml.live`**, wildcard **`*.aiml.live`** або будь-який піддомен (**`api.aiml.live`**, **`app.aiml.live`** тощо). Перевірка — case-insensitive.
+
+Rego-пакет: **`abie.http_route_base`** (`policy/http_route_base/`). Цільові файли: `…/k8s/.../base/.../*.yaml` типу HTTPRoute.
+
+```yaml title="…/k8s/base/hr.yaml"
+apiVersion: gateway.networking.k8s.io/v1
+kind: HTTPRoute
+metadata:
+  name: my-app
+spec:
+  hostnames:
+    - "my-app.aiml.live"   # ✓ піддомен aiml.live
+  parentRefs:
+    - name: gateway
+```
+
+Недозволені в base-шарі (але коректні для ua-overlay — `abie.app`, `vybeerai.com.ua`):
+
+```yaml
+  hostnames:
+    - "abie.app"            # ✗ ua-домен, не base
+    - "vybeerai.com.ua"     # ✗ ua-домен, не base
+```

package/rules/abie/js/ua_http_route.mdc

@@ -1,6 +1,6 @@
 ## k8s: overlay **HTTPRoute** (**ua**)
 
-За наявності **Deployment** під **k8s** і наявності **Vite** (**`vite.config.js`**, **`vite.config.mjs`** або **`vite.config.ts`** у каталозі пакета) у **`ua/kustomization.yaml`** цього пакета потрібні **inline JSON6902** у **`patches`**: **target** **`kind: HTTPRoute`**, **непорожній `name`** (як у маніфесті маршруту). Мають бути зміни **`/spec/hostnames`** (домени abie — у скрипті) та **`/spec/parentRefs/0/namespace`** (**`ua`**, також дозволені префікси **`ua-*`**, наприклад **`ua-b2b`**). Як обирати **`op`** (**add** / **replace** тощо) у patch — **k8s.mdc** (розділ про JSON patch у kustomization).
+За наявності **Deployment** під **k8s** і наявності **Vite** (**`vite.config.js`**, **`vite.config.mjs`** або **`vite.config.ts`** у каталозі пакета) у **`ua/kustomization.yaml`** цього пакета потрібні **inline JSON6902** у **`patches`**: **target** **`kind: HTTPRoute`**, **непорожній `name`** (як у маніфесті маршруту). Мають бути зміни **`/spec/hostnames`** (хоча б один з доменів: **`abie.app`**, **`vybeerai.com.ua`**, **`*.abie.app`**, **`*.vybeerai.com.ua`**) та **`/spec/parentRefs/0/namespace`** (**`ua`**, також дозволені префікси **`ua-*`**, наприклад **`ua-b2b`**). Як обирати **`op`** (**add** / **replace** тощо) у patch — **k8s.mdc** (розділ про JSON patch у kustomization).
 
 ### HTTPRoute: спільні сервіси **`auth-run-hl`**, **`file-link-hl`**
 

package/rules/abie/main.mdc

@@ -6,8 +6,20 @@ version: '1.22'
 
 Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua**)), гілки **dev**, **ua** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
 
+## Активація
+
+Правило активується через **`.n-cursor.json`** у корені репозиторію:
+
+```json
+{ "rules": ["abie"] }
+```
+
+Без цього запису `@nitra/cursor` пропускає всі abie-перевірки (JS-концерни та rego-полісі).
+
 [k8s-hc-yaml](./js/hc_pairing.mdc)
 
+[k8s-http-route-base](./js/http_route_base.mdc)
+
 [k8s-http-route-ua](./js/ua_http_route.mdc)
 
 [k8s-nodeselector](./js/ua_node_selector.mdc)

package/scripts/auto-rules.mjs

@@ -1,7 +1,7 @@
 /**
- * Автовизначення правил для `.n-cursor.json` за meta-даними з `npm/rules/<id>/meta.json`.
+ * Автовизначення правил для `.n-cursor.json` за meta-даними з `npm/rules/<id>/main.json`.
  *
- * Основна роль: `discoverRuleAutoActivation` читає `npm/rules/<id>/meta.json`, виводить
+ * Основна роль: `discoverRuleAutoActivation` читає `npm/rules/<id>/main.json`, виводить
  * `AUTO_RULE_ORDER` (алфавітно) і `AUTO_RULE_DEPENDENCIES` з meta, а потім для кожного правила
  * обчислює spec активації через `specMatches`: `always` — безумовно; `glob` — перевірка
  * файлів через `globToRegex`; `predicate` — незводимий предикат із реєстру `RULE_PREDICATES`
@@ -11,7 +11,7 @@
  *
  * Враховує винятки `disable-rules`: елементи зі списку не додаються автоматично.
  *
- * Автодетект скілів — у `./auto-skills.mjs` (умови — у `npm/skills/<skill>/meta.json`).
+ * Автодетект скілів — у `./auto-skills.mjs` (умови — у `npm/skills/<skill>/main.json`).
  * `mergeConfigWithAutoDetected` нижче приймає вже виявлені rules і skills і вливає
  * їх у конфіг із поправкою на legacy-id (`migrateRuleIds`).
  */
@@ -45,7 +45,7 @@ const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 const RULES_DIR = join(PACKAGE_ROOT, 'rules')
 
 /**
- * Скан `npm/rules/<id>/meta.json` → мапа id → RuleAutoSpec (лише правила з розпізнаним auto).
+ * Скан `npm/rules/<id>/main.json` → мапа id → RuleAutoSpec (лише правила з розпізнаним auto).
  * @param {string} [rulesDir] override для тестів
  * @returns {Record<string, import('./lib/rule-meta.mjs').RuleAutoSpec>} мапа автоактивації
  */
@@ -205,7 +205,7 @@ async function processFileEntry(absPath, root, facts) {
  * Обходить дерево проєкту, збираючи content-факти для предикатів автоувімкнення.
  *
  * `hasRegoFile` і `hasTempoDir` лишаються для зворотної сумісності з прямими читачами
- * фактів (тести, зовнішній код); саме автоувімкнення тепер data-driven через meta.json.
+ * фактів (тести, зовнішній код); саме автоувімкнення тепер data-driven через main.json.
  * @param {string} root абсолютний шлях кореня репозиторію
  * @returns {Promise<{
  *   hasBunSqlImport: boolean,
@@ -350,7 +350,7 @@ function specMatches(spec, ctx) {
 }
 
 /**
- * Визначає авто-правила згідно з `rules/<rule>/meta.json`.
+ * Визначає авто-правила згідно з `rules/<rule>/main.json`.
  * @param {object} params параметри аналізу
  * @param {string} params.root абсолютний шлях до кореня репозиторію
  * @param {string[]} params.availableRules перелік доступних правил з пакету

package/scripts/auto-skills.mjs

@@ -1,7 +1,7 @@
 /**
- * Автовизначення skills для `.n-cursor.json` за умовами з `npm/skills/<skill>/meta.json`.
+ * Автовизначення skills для `.n-cursor.json` за умовами з `npm/skills/<skill>/main.json`.
  *
- * `meta.json` — джерело правди (а не hardcoded мапа). Підтримуються три варіанти:
+ * `main.json` — джерело правди (а не hardcoded мапа). Підтримуються три варіанти:
  *
  *  - `auto: "завжди"` — скіл активується незалежно від інших правил
  *    (приклади: `fix`, `lint`, `llm-patch`, `publish-telegram`).
@@ -26,7 +26,7 @@ const SKILLS_DIR = join(PACKAGE_ROOT, 'skills')
  */
 
 /**
- * Сканує `npm/skills/<id>/meta.json`. Скіли без `meta.json` або без розпізнаного
+ * Сканує `npm/skills/<id>/main.json`. Скіли без `main.json` або без розпізнаного
  * `auto` не потрапляють у результат — їх вмикають лише вручну в конфізі.
  * @param {string} [skillsDir] override для тестів
  * @returns {Record<string, SkillAutoSpec>} мапа `skillId → spec`

package/scripts/docs/auto-rules.md

@@ -3,48 +3,34 @@ type: JS Module
 title: auto-rules.mjs
 resource: npm/scripts/auto-rules.mjs
 docgen:
-  crc: d50b922f
+  crc: ba75c709
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
-Файл читає метадані з `npm/rules/<id>/meta.json` для автоматичного визначення порядку та залежностей правил. Він обчислює spec активації для кожного правила, використовуючи дані з `RULE_PREDICATES` з `lib/rule-predicates.mjs`, визначає активні правила, обчислює залежності та об'єднує конфігурацію з виявленими правилами та поправками на legacy-id. Код спирається на конфіги `.n-cursor.json`, `meta.json` та `package.json`.
+## Огляд
 
-## Поведінка
-
-discoverRuleAutoActivation
-Читає meta-дані з файлів npm/rules/<id>/meta.json для визначення автоактивації правил.
-
-AUTO_RULE_ORDER
-Повертає алфавітний порядок для правил.
+Автоматично визначає правила та скіли для конфігурації `.n-cursor.json`, скануючи мета-дані з `npm/rules/<id>/main.json` та аналізуючи структуру проєкту, зокрема `package.json`. Система виводить `AUTO_RULE_ORDER` (алфавітно) та `AUTO_RULE_DEPENDENCIES` для кожного правила. Для кожного правила обчислюється специфікація активації (`specMatches`), яка може бути безумовною (`always`), заснованою на шаблонах файлів (`glob`), або предикатною. Процес враховує винятки (`disable-rules`) та виконує транзитивне розгортання залежностей. Збираються контент-факти (GQL, bun-sql, hasura) для точного застосування правил. Також відбувається автоматичне виявлення скілів з `./auto-skills.mjs`, після чого всі виявлені правила та скіли зливаються у конфіг, враховуючи міграцію ID.
 
-AUTO_RULE_DEPENDENCIES
-Повертає граф залежностей між правилами.
-
-collectAutoRuleFacts
-Збирає контент-факти для предикатів, включаючи сканування GQL, Bun SQL та налаштувань Hasura.
-
-detectAutoRules
-Визначає активні правила на основі spec, перевіряючи їх проти згенерованих фактів.
+## Поведінка
 
-mergeConfigWithAutoDetected
-Доповнює конфігурацію, додаючи визначені автоправила та налаштування, з урахуванням legacy-ID; за наявності `availableRules`/`availableSkills` ще й відсіює з `rules`/`skills` неактуальні id, яких немає у пакеті (повертає їх у полі `pruned`).
+discoverRuleAutoActivation сканує директорію `rules` та виявляє мета-дані для автоматичного визначення правил.
+AUTO_RULE_ORDER надає стабільний алфавітний порядок для всіх правил, виявлених під час автоматичного визначення.
+AUTO_RULE_DEPENDENCIES визначає транзитивні залежності між правилами, виявленими під час автоматичного визначення.
+collectAutoRuleFacts обходить дерево проєкту, збираючи контент-факти про наявність певних структур (наприклад, GQL, Hasura, Rego).
+detectAutoRules визначає список правил, які мають бути активні, на основі мета-даних правил та зібраних контент-фактів, враховуючи виключення.
+mergeConfigWithAutoDetected об'єднує конфігурацію користувача з результатами автоматичного визначення правил та скілів, прибираючи з конфігу ті елементи, яких більше немає у пакеті.
 
 ## Публічний API
 
-discoverRuleAutoActivation — Скан `npm/rules/<id>/meta.json` → мапа id → RuleAutoSpec (лише правила з розпізнаним auto).
-AUTO_RULE_ORDER — Стабільний алфавітний порядок (замість хардкод-масиву).
-AUTO_RULE_DEPENDENCIES — Граф залежностей із meta (Type C) — замість хардкод-константи.
-collectAutoRuleFacts — Обходить дерево проєкту, збираючи content-факти для предикатів автоувімкнення.
-hasRegoFile — Флаг наявності файлу Rego.
-hasTempoDir — Флаг наявності директорії Tempo.
-hasBunSqlImport — Булеве значення про імпорт BunSQL.
-hasGqlTaggedTemplates — Булеве значення про наявність GQL-тегів.
-hasHasuraConfig — Булеве значення про конфігурацію Hasura.
+discoverRuleAutoActivation — Зчитує `main.json` для кожного правила у `npm/rules/<id>/` та створює список правил, які можуть активуватися автоматично.
+AUTO_RULE_ORDER — Визначає порядок застосування автоматичних правил за алфавітом.
+AUTO_RULE_DEPENDENCIES — Створює граф залежностей між автоматичними правилами, використовуючи метадані.
+collectAutoRuleFacts — Сканує структуру проєкту та збирає факти про вміст, необхідні для визначення, які автоматичні правила активувати.
+detectAutoRules — Визначає, які автоматичні правила доступні на основі файлу `main.json` кожного правила.
+mergeConfigWithAutoDetected — Обновлює конфігурацію, додаючи автоматично виявлені правила, і очищає список доступних правил/навичок від тих, що більше не існують у пакеті, фіксуючи видалені ID у полі `pruned`.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
 - Свідомо пропускає шляхи: `.git`, `node_modules`.
-- Не звертається до мережі.

package/scripts/docs/auto-skills.md

@@ -3,175 +3,30 @@ type: JS Module
 title: auto-skills.mjs
 resource: npm/scripts/auto-skills.mjs
 docgen:
-  crc: 44328898
+  crc: 374d78b5
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Модуль `npm/scripts/auto-skills.mjs` відповідає за **автовизначення (auto-activation) скілів** для файлу конфігурації `.n-cursor.json`. Він сканує директорію `npm/skills/` і для кожного скілу читає його `meta.json`, щоб визначити, чи має скіл активуватися автоматично — завжди або лише за наявності певних виявлених auto-правил (rules).
+## Огляд
 
-Ключова ідея модуля: **`meta.json` — єдине джерело правди**. У коді немає жорстко прописаної мапи відповідностей між скілами та правилами; усе зчитується з метаданих скіла. Раніше використовувався hardcoded `AUTO_SKILL_ORDER`, тепер він обчислюється динамічно — експорт залишено для зворотної сумісності.
+Визначає, які скіли мають автоматично активуватися, скануючи `npm/skills/` та аналізуючи `main.json` кожного скілу. Логіка активації базується на конфігурації скілу: скіл може активуватися завжди (`auto: "завжди"`), якщо всі перелічені правила виявлені (`auto: ["rule", …]`), або бути opt-in, якщо поле `auto` відсутнє у `main.json`. Це забезпечує, що визначення автоматичної активації скілів є детермінованим, оскільки `main.json` є джерелом правди. Результати сканування використовуються для встановлення `AUTO_SKILL_ORDER` та `AUTO_SKILL_RULE_DEPENDENCIES`, що впливає на роботу з `.n-cursor.json`.
 
-Підтримуються три формати поля `auto` у `meta.json`:
+## Поведінка
 
-- `auto: "завжди"` — скіл активується незавжди, незалежно від інших правил. Приклади за коментарями у файлі: `fix`, `lint`, `llm-patch`, `publish-telegram`.
-- `auto: ["rule", …]` — скіл активується, якщо **усі** перелічені правила вже виявлено auto-rules-модулем. Приклади за коментарями: `adr-normalize` залежить від `["adr"]`, `taze` — від `["bun"]`.
-- поле `auto` відсутнє або формат не розпізнано — скіл лише opt-in (тільки через `.n-cursor.json:skills`).
+discoverSkillAutoActivation сканує директорію `npm/skills/` і визначає специфікації автоматичної активації скілів на основі вмісту `main.json` кожного скілу.
+AUTO_SKILL_ORDER надає стабільний алфавітний порядок усіх скілів, які мають визначену автоматичну активацію.
+AUTO_SKILL_RULE_DEPENDENCIES надає мапу скілів, які залежать від певних правил, для забезпечення зворотної сумісності.
+detectAutoSkills визначає, які скіли мають бути автоматично активовані, порівнюючи доступні скіли з виявленими правилами та специфікаціями активації.
 
-Сканування `npm/skills/` виконується **синхронно під час завантаження модуля**: це дає детермінізм результату і узгоджується з sync-API сусіднього модуля `auto-rules.mjs`. Результат кешується на час життя процесу (`SKILL_AUTO_ACTIVATION`).
+## Публічний API
 
-## Експорти / API
+discoverSkillAutoActivation — Знаходить скіли, які мають файл `main.json` у відповідній директорії, і які мають автоматичну активацію.
+AUTO_SKILL_ORDER — Забезпечує фіксований алфавітний порядок скілів, що автоматично активуються, для підтримки старої версії.
+AUTO_SKILL_RULE_DEPENDENCIES — Створює список скілів, що автоматично активуються і мають визначені правила залежностей.
+detectAutoSkills — Виявляє скіли, які мають автоматичну активацію на основі вмісту файлу `auto.md` у директорії скілу.
 
-Модуль експортує:
+## Гарантії поведінки
 
-| Символ                                                                 | Тип                                           | Призначення                                                              |
-| ---------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------ |
-| `discoverSkillAutoActivation(skillsDir?)`                              | function                                      | Сканує директорію зі скілами та повертає мапу `skillId → SkillAutoSpec`. |
-| `AUTO_SKILL_ORDER`                                                     | `readonly string[]` (frozen)                  | Стабільний алфавітний список id скілів, які мають авто-активацію.        |
-| `AUTO_SKILL_RULE_DEPENDENCIES`                                         | `Readonly<Record<string, readonly string[]>>` | Лише ті скіли, у яких `auto: [rule, …]` — мапа `skillId → rules[]`.      |
-| `detectAutoSkills({ availableSkills, detectedRules, disableSkills? })` | function                                      | Обчислює фінальний список авто-скілів за станом середовища.              |
-
-Тип `SkillAutoSpec` (визначається JSDoc-typedef):
-
-```js
-/** @typedef {{ always: true } | { rules: readonly string[] }} SkillAutoSpec */
-```
-
-Тобто кожен скіл, що пройшов парсинг, або має `always: true`, або несе масив `rules`.
-
-## Функції
-
-### `discoverSkillAutoActivation(skillsDir = SKILLS_DIR)`
-
-**Сигнатура:**
-
-```js
-function discoverSkillAutoActivation(skillsDir?: string): Record<string, SkillAutoSpec>
-```
-
-**Параметри:**
-
-- `skillsDir` _(string, optional)_ — шлях до директорії зі скілами. За замовчуванням — `SKILLS_DIR = join(PACKAGE_ROOT, 'skills')`, де `PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))` (тобто корінь npm-пакету). Параметр існує для override у тестах.
-
-**Повертає:** `Record<string, SkillAutoSpec>` — мапа `skillId (== ім'я піддиректорії) → spec`.
-
-**Поведінка:**
-
-1. Якщо `skillsDir` не існує — повертається порожній обʼєкт `{}`.
-2. Інакше викликається `readdirSync(skillsDir, { withFileTypes: true })`.
-3. Для кожного запису:
-   - пропускаються файли (не директорії) та все, що починається з `.` (наприклад, приховані).
-   - читається `meta.json` через `readSkillMetaRaw(...)`; якщо raw-обʼєкт відсутній (`null`/`undefined`) — скіл пропускається.
-   - поле `raw.auto` пропускається через `parseSkillAutoSpec(...)`; якщо розпізнано — записується в `out[entry.name]`.
-4. Скіли без розпізнаного `auto` **не потрапляють у результат** — вони можуть бути ввімкнені лише вручну через `.n-cursor.json:skills`.
-
-**Side effects:** sync I/O — `existsSync`, `readdirSync`, читання `meta.json` усередині `readSkillMetaRaw`. Інших побічних ефектів немає.
-
-### `detectAutoSkills({ availableSkills, detectedRules, disableSkills })`
-
-**Сигнатура:**
-
-```js
-function detectAutoSkills(params: {
-  availableSkills: string[],
-  detectedRules: string[],
-  disableSkills?: string[],
-}): { skills: string[] }
-```
-
-**Параметри:**
-
-- `availableSkills` _(string[])_ — перелік id скілів, доступних у поточній збірці пакету (без префіксу `n-`). Будь-який скіл, який є в `SKILL_AUTO_ACTIVATION`, але відсутній у `availableSkills`, **не активується**.
-- `detectedRules` _(string[])_ — id правил, що їх виявив auto-rules-крок; використовується як множина "виявлених" залежностей для специфікацій `{ rules: [...] }`.
-- `disableSkills` _(string[], optional)_ — список id скілів із `.n-cursor.json` із прапором `disable-skills`. За замовчуванням — заморожений пустий масив `DEFAULT_DISABLED_LIST`.
-
-**Повертає:** `{ skills: string[] }` — список id активованих скілів у **стабільному алфавітному порядку** (через `AUTO_SKILL_ORDER.filter(...)`).
-
-**Алгоритм:**
-
-1. Нормалізує `availableSkills` у `Set` (lowercase, trim).
-2. Будує `Set` із `disableSkills` та `detectedRules`.
-3. Для кожної пари `[skillId, spec]` у `SKILL_AUTO_ACTIVATION`:
-   - якщо скіл не входить у `normalizedSkills` або входить у `disableSkillsSet` — пропуск.
-   - якщо `spec` має `always: true` **або** усі `spec.rules` присутні в `detectedRulesSet` — скіл додається до результуючого `detected`.
-4. Фінальний список будується через `AUTO_SKILL_ORDER.filter(id => detected.has(id))`, що гарантує детермінований алфавітний порядок та фільтрацію тільки тих id, які реально мають spec.
-
-**Side effects:** немає — функція чиста. Використовує тільки заздалегідь обчислений `SKILL_AUTO_ACTIVATION` і `AUTO_SKILL_ORDER`.
-
-## Внутрішні константи модуля
-
-- `PACKAGE_ROOT` — корінь npm-пакету: `dirname(dirname(fileURLToPath(import.meta.url)))`. Тобто два рівні вгору від `npm/scripts/auto-skills.mjs` → `npm/`.
-- `SKILLS_DIR` — `join(PACKAGE_ROOT, 'skills')`, тобто `npm/skills/`.
-- `SKILL_AUTO_ACTIVATION` — результат `discoverSkillAutoActivation()` під час імпорту модуля; кеш на час процесу.
-- `AUTO_SKILL_ORDER` — `Object.freeze(Object.keys(SKILL_AUTO_ACTIVATION).toSorted(localeCompare))`. Заморожений алфавітний список усіх скілів з auto-spec.
-- `AUTO_SKILL_RULE_DEPENDENCIES` — `Object.freeze(Object.fromEntries(...))`: похідна view, де лишаються тільки записи зі spec-формою `{ rules }`. Призначена для зворотної сумісності й для автодоку.
-- `DEFAULT_DISABLED_LIST` — `Object.freeze([])`, дефолтне значення для параметра `disableSkills`.
-
-## Залежності
-
-**Node.js стандартні модулі:**
-
-- `node:fs` — `existsSync`, `readdirSync` (синхронне сканування директорії).
-- `node:path` — `dirname`, `join`.
-- `node:url` — `fileURLToPath` (для отримання абсолютного шляху модуля з `import.meta.url`).
-
-**Локальні модулі:**
-
-- `./lib/skill-meta.mjs` — імпортуються:
-  - `readSkillMetaRaw(skillPath)` — читає сирий обʼєкт `meta.json` за шляхом до директорії скілу.
-  - `parseSkillAutoSpec(raw.auto)` — нормалізує значення `auto` у `SkillAutoSpec` (`{ always: true }`, `{ rules: [...] }` або `null`).
-
-**Файлова система (рантайм-залежності):**
-
-- Очікується наявність директорії `npm/skills/` із піддиректоріями `<skillId>/meta.json`. Відсутність директорії оброблена коректно (повертається `{}`).
-
-## Потік виконання / Використання
-
-### Завантаження модуля (init phase)
-
-1. `PACKAGE_ROOT` і `SKILLS_DIR` обчислюються на основі `import.meta.url`.
-2. Викликається `discoverSkillAutoActivation()` — це **синхронне** I/O під час імпорту: читається `npm/skills/`, з кожної піддиректорії — `meta.json`. Результат зберігається у `SKILL_AUTO_ACTIVATION`.
-3. `AUTO_SKILL_ORDER` і `AUTO_SKILL_RULE_DEPENDENCIES` похідні від цього кешу — обчислюються одноразово і заморожуються.
-
-### Виклик `detectAutoSkills` (runtime)
-
-Зазвичай викликається на етапі генерації / валідації `.n-cursor.json`. Послідовність:
-
-1. Зовнішній код визначає `availableSkills` (зі стану пакету / маніфесту) та `detectedRules` (через сусідній auto-rules pipeline).
-2. Опціонально передає `disableSkills` із конфігу користувача.
-3. Функція повертає `{ skills: [...] }` — фінальний відсортований список id, готовий до запису у конфіг.
-
-### Приклад використання
-
-```js
-import { detectAutoSkills, AUTO_SKILL_ORDER, AUTO_SKILL_RULE_DEPENDENCIES } from './auto-skills.mjs'
-
-const { skills } = detectAutoSkills({
-  availableSkills: ['fix', 'lint', 'adr-normalize', 'taze', 'publish-telegram'],
-  detectedRules: ['adr', 'bun'],
-  disableSkills: ['publish-telegram']
-})
-
-// skills буде у стабільному алфавітному порядку:
-// напр. ['adr-normalize', 'fix', 'lint', 'taze']
-// (publish-telegram вимкнено через disableSkills)
-```
-
-### Контракти й інваріанти
-
-- **Детермінізм:** порядок результату повністю визначається `AUTO_SKILL_ORDER`, який є `localeCompare`-сортованим snapshot-ом на момент імпорту.
-- **Безпека до відсутніх скілів:** скіли, доступні у `SKILL_AUTO_ACTIVATION`, але не присутні у `availableSkills`, ніколи не активуються.
-- **Кеш:** перечитати `npm/skills/` без перезавантаження модуля неможливо — функція `discoverSkillAutoActivation` тут лише для прямого виклику з тестів (передаючи інший `skillsDir`).
-- **Опт-аут:** `disableSkills` має пріоритет над `auto`-активацією.
-
-## Rebuild Test
-
-Уявімо, що файл загублено. За цим описом його можна відновити так:
-
-1. ESM-модуль із Node-імпортами `existsSync, readdirSync` із `node:fs`, `dirname, join` із `node:path`, `fileURLToPath` із `node:url`.
-2. Імпорт `parseSkillAutoSpec, readSkillMetaRaw` із `./lib/skill-meta.mjs`.
-3. Константи `PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))`, `SKILLS_DIR = join(PACKAGE_ROOT, 'skills')`.
-4. Експортована функція `discoverSkillAutoActivation(skillsDir = SKILLS_DIR)`: якщо `!existsSync(skillsDir)` → `{}`; інакше readdirSync з `withFileTypes`, ітерувати, пропускати не-директорії та `name.startsWith('.')`, читати `readSkillMetaRaw(join(skillsDir, entry.name))`, пропускати falsy, парсити `parseSkillAutoSpec(raw.auto)`, додавати в `out[entry.name]` тільки якщо парсер повернув spec.
-5. Константа модуля `SKILL_AUTO_ACTIVATION = discoverSkillAutoActivation()`.
-6. Експорт `AUTO_SKILL_ORDER = Object.freeze(Object.keys(SKILL_AUTO_ACTIVATION).toSorted((a,b) => a.localeCompare(b)))`.
-7. Експорт `AUTO_SKILL_RULE_DEPENDENCIES = Object.freeze(Object.fromEntries(Object.entries(SKILL_AUTO_ACTIVATION).filter(([, spec]) => 'rules' in spec).map(([id, spec]) => [id, spec.rules])))`.
-8. Константа `DEFAULT_DISABLED_LIST = Object.freeze([])`.
-9. Експортована функція `detectAutoSkills({ availableSkills, detectedRules, disableSkills = DEFAULT_DISABLED_LIST })`: побудувати `normalizedSkills = new Set(availableSkills.map(s => s.trim().toLowerCase()))`, `disableSkillsSet`, `detectedRulesSet`; пройти `Object.entries(SKILL_AUTO_ACTIVATION)`, пропустити коли скіл не у `normalizedSkills` або у `disableSkillsSet`, інакше додати до `detected` якщо `'always' in spec` або `spec.rules.every(d => detectedRulesSet.has(d))`; повернути `{ skills: AUTO_SKILL_ORDER.filter(id => detected.has(id)) }`.
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

package/scripts/lib/docs/mirror-parity.md

@@ -3,31 +3,31 @@ type: JS Module
 title: mirror-parity.mjs
 resource: npm/scripts/lib/mirror-parity.mjs
 docgen:
-  crc: 5e366df1
+  crc: 093ff2bb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
 ## Огляд
 
-Модуль порівнює вміст дзеркал правил (`.cursor/rules/n-<id>.mdc`) з канонічними версіями (`npm/rules/<id>/<id>.mdc`), які містять застосовані трансформації (трансформ, що застосовує `readBundledRuleContent` $\to$ `inlineTemplateLinks`). Він визначає список керованих дзеркал, формує очікуваний вміст для кожного дзеркала та виявляє дрейф — відхилення фактичного вмісту від очікуваного.
+Модуль забезпечує паритет дзеркал правил, порівнюючи вміст `.cursor/rules/n-<id>.mdc` з канонічним вмістом `npm/rules/<id>/<id>.mdc`. Він визначає, які дзеркала відстежувати, формує очікуваний вміст цих дзеркал після застосування шаблонів (трансформу, що застосовує `readBundledRuleContent` $\rightarrow$ `inlineTemplateLinks`), та виявляє дрейф, що виникає, коли канонічний `.mdc` змінюється без регенерації дзеркала.
 
 ## Поведінка
 
 listManagedMirrors
-Визначає список керованих дзеркал правил, які мають відповідне канонічне джерело у `npm/rules`.
+Визначає список керованих дзеркал правил, що мають канонічне джерело у `npm/rules`.
 
 expectedMirrorContent
 Формує очікуваний вміст дзеркала, застосовуючи трансформації до канонічного файлу.
 
 findMirrorDrift
-Виявляє ідентифікатори дзеркал, чий фактичний вміст відрізняється від очікуваного вмісту, отриманого з канону.
+Виявляє ідентифікатори дзеркал, чий фактичний вміст відрізняється від очікуваного.
 
 ## Публічний API
 
-listManagedMirrors — перераховує керовані дзеркала, які мають визначене канонічне джерело.
-expectedMirrorContent — визначає бажаний вміст дзеркала, використовуючи канон із вбудованими шаблонами.
-findMirrorDrift — знаходить ідентифікатори дзеркал, у яких фактичний вміст відрізняється від очікуваного.
+listManagedMirrors — перераховує керовані дзеркала, які мають визначене основне джерело.
+expectedMirrorContent — визначає бажаний вміст дзеркала, використовуючи шаблонне заміщення даних.
+findMirrorDrift — знаходить ідентифікатори дзеркал, чий фактичний вміст відрізняється від очікуваного.
 
 ## Гарантії поведінки
 

package/scripts/lib/docs/rule-meta.md

@@ -3,30 +3,30 @@ type: JS Module
 title: rule-meta.mjs
 resource: npm/scripts/lib/rule-meta.mjs
 docgen:
-  crc: 36aea8cb
+  crc: 8eca71d2
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Парсер інтерпретує метадані правил, що знаходяться у `npm/rules/<id>/meta.json`. Він реалізує data-driven логіку для визначення умов активації кожного детектора. Специфікації активації (`auto`) нормалізуються на основі вмісту `meta.json`, підтримуючи чотири типи: константа `RULE_ALWAYS` ("завжди"), залежності від інших правил, шаблони за допомогою `glob`, або незводимі предикати. Парсер не виконує операцій запису у файлову систему чи бази даних і забезпечує безпечну роботу, перехоплюючи помилки.
+Файл зчитує метадані правил з `npm/rules/<id>/main.json`. Він нормалізує специфікації активації (`auto`) та області застосування (`lint`). Специфікація `main.json.auto` може мати чотири форми: константу `RULE_ALWAYS` ("завжди"), масив залежних правил, об'єкт з шаблоном `glob` або об'єкт з предикатом. Це забезпечує механізм для визначення умов активації правила на основі конфігурації `main.json`.
 
 ## Поведінка
 
-RULE_ALWAYS — константа, що позначає безумовну активацію правила.
-parseRuleAutoSpec — Нормалізує значення поля `auto` з метаданих правила у дискриміновану специфікацію активації.
-parseRuleLintSpec — Нормалізує значення поля `lint` з метаданих правила у специфікацію області застосування детектора.
-readRuleMetaRaw — Читає та парсить вміст `main.json` з каталогу правила, повертаючи його як об'єкт або `null` у разі помилки чи відсутності файлу.
+RULE_ALWAYS — Константа, що позначає безумовну активацію правила.
+parseRuleAutoSpec — Нормалізує значення поля `auto` з `main.json` у дискриміновану специфікацію активації правила.
+parseRuleLintSpec — Нормалізує значення поля `lint` з `main.json` у специфікацію області застосування детектора.
+readRuleMetaRaw — Зчитує та парсить вміст `main.json` з каталогу правила, повертаючи його як об'єкт або `null` у разі помилки чи відсутності файлу.
 
 ## Публічний API
 
-RULE_ALWAYS — константа, що вказує на безумовну активацію.
-parseRuleAutoSpec — перетворює налаштування автоматичного визначення правил з `meta.json` у структурований формат.
-parseRuleLintSpec — перетворює налаштування лінтування з `meta.json` у визначення області дії детектора.
-"per-file" — визначає, що детектор працює з окремими зміненими файлами (порівняння змін з оригіналом).
-"full" — вказує на повний, нероздільний аналіз між усіма файлами (активується лише при використанні прапорця `--full` або в CI).
-readRuleMetaRaw — зчитує та обробляє метадані одного правила з файлу `meta.json`.
+RULE_ALWAYS — позначка для безумовної активації.
+parseRuleAutoSpec — перетворює налаштування автоматичного визначення правил з `main.json` у структурований формат.
+parseRuleLintSpec — перетворює налаштування лінтера з `main.json` у визначення області дії детектора.
+"per-file" — визначає, що детектор аналізує зміни на рівні окремих файлів (порівнює відмінності з оригіналом).
+"full" — визначає, що детектор аналізує весь проєкт одночасно (активується лише при використанні прапорця `--full` або в CI).
+readRuleMetaRaw — зчитує та розбирає метадані одного правила з `main.json`.
 
 ## Гарантії поведінки
 

package/scripts/lib/docs/skill-meta.md

@@ -3,28 +3,28 @@ type: JS Module
 title: skill-meta.mjs
 resource: npm/scripts/lib/skill-meta.mjs
 docgen:
-  crc: c0918db5
+  crc: c1757867
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Спільний парсер метаданих скіла, що зчитує дані з `npm/skills/<id>/meta.json`. Він є єдиним джерелом правди для конфігурації скілів, визначаючи умови автоактивації (через поле `auto`, де `SKILL_ALWAYS` означає "завжди"), чи виконувати скіл в окремому git-worktree (`worktree`), та чи вимагає скіл запуску з кореня репозиторію (`requireRoot`). Модуль надає механізми для парсингу цих метаданих, перевірки вимог до кореня та читання сирих даних. Він працює в режимі fail-safe, перехоплюючи помилки та повертаючи порожнє значення замість винятків.
+Спільний парсер метаданих скіла, що зчитує інформацію з `main.json`. Цей файл є єдиним джерелом правди для скіла. Модуль дозволяє визначати умови автоактивації скіла (через поле `auto`), вказувати, чи виконувати скіл в окремому git-worktree (`worktree`), та чи вимагає він запуску з кореня репозиторію (`requireRoot`). Надає константу `SKILL_ALWAYS` для безумовної активації. Хелпер використовується іншими компонентами для уникнення дублювання парсингу. Функції забезпечують перехоплення помилок (fail-safe), повертаючи порожнє значення замість винятків.
 
 ## Поведінка
 
 SKILL_ALWAYS — надає літерал для безумовної автоактивації скіла.
-parseSkillAutoSpec — перетворює значення поля `auto` з метаданих скіла у специфікацію автоактивації.
-skillRequiresRoot — визначає, чи вимагає скіл запуску з кореня репозиторію, виходячи з метаданих.
-readSkillMetaRaw — читає та парсить файл `main.json` у каталозі скіла, повертаючи його вміст або `null` у разі помилки.
+parseSkillAutoSpec — перетворює значення поля `auto` з `main.json` у специфікацію автоактивації.
+skillRequiresRoot — визначає, чи вимагає скіл запуску з кореня репозиторію, базуючись на метаданих.
+readSkillMetaRaw — читає та парсить файл `main.json` для заданого каталогу скіла.
 
 ## Публічний API
 
-SKILL_ALWAYS — маркер, що вказує на безумовну активацію
-parseSkillAutoSpec — витягує налаштування автоматичного запуску з `meta.json`
-skillRequiresRoot — визначає, чи потрібен запуск скіла з кореня репозиторію
-readSkillMetaRaw — зчитує та обробляє метадані окремого скіла з `meta.json`
+SKILL_ALWAYS — позначка для безумовної активації.
+parseSkillAutoSpec — витягує налаштування автоматичного запуску з `main.json` у структуру `SkillAutoSpec`.
+skillRequiresRoot — визначає, чи потрібен запуск скіла з кореня репозиторію (активує захист від запуску з інших місць).
+readSkillMetaRaw — зчитує та розбирає метадані одного скіла з `main.json`.
 
 ## Гарантії поведінки
 

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) {