@nitra/cursor 11.4.0 → 12.0.0

package/.claude-template/hooks/normalize-decisions.sh

@@ -53,6 +53,15 @@ draft_transcript_path() {
   ' "$1" 2>/dev/null
 }
 
+# Витягає поле `captured:` з YAML frontmatter ADR-чернетки.
+draft_captured_date() {
+  awk '
+    NR==1 && /^---$/ { fm=1; next }
+    fm && /^---$/    { exit }
+    fm && /^captured: / { sub(/^captured: /, ""); print; exit }
+  ' "$1" 2>/dev/null
+}
+
 # Skip if repo is mid-rebase / mid-merge — editing files now would tangle the user.
 if [ -d "$PROJECT_ROOT/.git" ]; then
   for marker in MERGE_HEAD CHERRY_PICK_HEAD REVERT_HEAD rebase-apply rebase-merge; do
@@ -224,9 +233,13 @@ PROMPT_HEADER=$(cat <<'EOF'
 
 1. `delete` — драфт тривіальний / повністю покритий іншим існуючим clean-ADR-ом / порожній. Поясни короткою причиною українською.
 
-2. `rewrite` — драфт має самостійну цінність як decision record. Повертай у `content` повний фінальний вміст файлу у форматі MADR 4.0.0 minimal:
-   - Без YAML frontmatter (жодного `session:`, `captured:`, `transcript:`).
-   - Заголовок `# <Title>` українською.
+2. `rewrite` — драфт має самостійну цінність як decision record. Повертай у `content` повний фінальний вміст файлу у форматі MADR 4.0.0 minimal з OKF v0.1 frontmatter:
+   - YAML frontmatter OKF v0.1 на початку файлу (без `#` заголовка після — `title:` вже є у frontmatter):
+     ---
+     type: ADR
+     title: <заголовок без "ADR:" prefix, лапки якщо є двокрапка чи спецсимвол>
+     description: <одне речення — суть рішення>
+     ---
    - Один рядок `**Status:** Accepted` і один рядок `**Date:** YYYY-MM-DD` — дату беремо з поля `captured:` оригінальної чернетки (перші 10 символів ISO-дати).
    - Далі секції з точними MADR headings англійською: `## Context and Problem Statement`, `## Considered Options`, `## Decision Outcome`, `### Consequences`, `## More Information`.
    - У `## Considered Options` перелічуй лише варіанти, які є в драфті/transcript. Якщо альтернатив не було, додай bullet `Інші варіанти в transcript не обговорювалися.`
@@ -454,6 +467,24 @@ while IFS= read -r op_json; do
           ;;
       esac
       DEST_PATH=$(resolve_unique_slug_path "$DEST_SLUG")
+      # OKF fallback: if LLM omitted the type: ADR frontmatter, prepend minimal one.
+      OKF_HAS_TYPE=$(printf '%s\n' "$CONTENT" | awk '
+        /^---$/ && !fm { fm=1; next }
+        fm && /^---$/  { exit }
+        fm && /^type:/ { print "yes"; exit }
+      ')
+      if [ "$OKF_HAS_TYPE" != "yes" ]; then
+        DRAFT_TITLE=$(printf '%s\n' "$CONTENT" | awk '/^# / { sub(/^# (ADR: )?/, ""); print; exit }')
+        [ -z "$DRAFT_TITLE" ] && DRAFT_TITLE="$SLUG"
+        DRAFT_TITLE_YAML=$(printf '%s' "$DRAFT_TITLE" | sed 's/\\/\\\\/g; s/"/\\"/g')
+        CONTENT="---
+type: ADR
+title: \"${DRAFT_TITLE_YAML}\"
+---
+
+${CONTENT}"
+        log "okf-fallback: prepended OKF frontmatter for $FILE"
+      fi
       printf '%s\n' "$CONTENT" > "$DEST_PATH"
       rm -- "$SRC_PATH"
       # Record bare slug → final path so a same-batch merge-into can target

package/.pi-template/extensions/n-cursor-adr/docs/index.md

@@ -1,14 +1,12 @@
 ---
+type: TS Module
+title: index.ts
+resource: npm/.pi-template/extensions/n-cursor-adr/index.ts
 docgen:
-  source: npm/.pi-template/extensions/n-cursor-adr/index.ts
   crc: 3233716f
   score: 100
 ---
 
-# index.ts
-
-## Огляд
-
 Файл збирає записи сесії, серіалізує їх у формат JSONL, записує у тимчасову директорію, а потім ініціює виконання скриптів хуків capture та normalize.
 
 ## Поведінка

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.0.0] - 2026-06-18
+
+### Removed
+
+- worktree: керування git-worktree винесено у `@7n/mt` (`mt worktree`), cursor на нього спирається (спека docs/specs/2026-06-16-worktree-lifecycle-to-mt.md). **Breaking:** прибрано команду `n-cursor worktree` (`worktree-cli.mjs`/`lib/worktree.mjs` + тести) і скіл `worktree`. Worktree-only-конвенція лишається: інжектований preflight-снипет (`worktree-notice.mjs`) і правило `worktree.mdc` тепер кличуть `mt worktree create` (ефемерний — `remove` прибирає й гілку); bootstrap спрощено до `bun install` (ETARGET-retry-обгортка прибрана — `mt` бінарник, не npx-резолв). Додано залежність `@7n/mt@^0.5.0` (платформні бінарники тягне транзитивно). `.worktrees/` лишається gitignored; інвентар тепер у `.worktrees/.meta/`.
+
+## [11.4.1] - 2026-06-16
+
+### Fixed
+
+- release: commit-back більше не «вдається» мовчки за відхиленого push — результат `git push` тепер ЯВНО перевіряється (раніше тихий runGit повертав null, а реліз рапортував успіх, через що npm міг піти попереду git). За non-fast-forward (паралельний push у ту саму гілку) release-коміт автоматично rebase-иться на свіжий upstream, теги пересуваються на новий HEAD і push повторюється (до 5 спроб); без upstream або при rebase-конфлікті — кидаємо помилку (exit 1), тож CI-публікація не відбувається без приземленого commit-back.
+
 ## [11.4.0] - 2026-06-15
 
 ### Changed

package/bin/n-cursor.js

@@ -108,7 +108,6 @@ import { syncGitignoreWorktree } from '../scripts/lib/sync-gitignore-worktree.mj
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
 import { runSkillsCli } from '../scripts/skills-cli.mjs'
-import { runWorktreeCli } from '../scripts/worktree-cli.mjs'
 import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
 import { runLint } from '../rules/lint/js/orchestrate.mjs'
 
@@ -1472,7 +1471,7 @@ async function runSync() {
 /**
  * Команди, що мутують проєкт у CWD і вимагають кореня репо. `undefined`/`''` —
  * дефолтний sync; `check` — deprecated-alias `fix`. Решта (read-only `trace`,
- * `--root`-команди `lint-doc-files`/`fix-doc-files`/`doc-files`/`doc-aggregate`/`rename-yaml-extensions`, `worktree`,
+ * `--root`-команди `lint-doc-files`/`fix-doc-files`/`doc-files`/`doc-aggregate`/`rename-yaml-extensions`,
  * sub-лінтери) гард не зачіпає.
  */
 const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'lint', 'coverage', 'change', 'release'])
@@ -1635,11 +1634,6 @@ try {
 
       break
     }
-    case 'worktree': {
-      process.exitCode = await runWorktreeCli(args)
-
-      break
-    }
     case 'trace': {
       // n-cursor trace — наскрізна простежуваність (spec §5.4/§7): граф
       // ADR↔spec↔plan↔change за front-matter + флаг розривів. exit 1 на розрив.
@@ -1703,7 +1697,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-fix, adr-normalize-local, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, change, release, skill, worktree, trace, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-fix, adr-normalize-local, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, change, release, skill, trace, doc-aggregate`
       )
       process.exitCode = 1
     }

package/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm
+resource: npm/
+---
+
+# npm
+
+| Файл | Тип |
+|---|---|
+| [stryker.config.mjs](stryker.config.md) | JS Module |
+| [vitest.config.js](vitest.config.md) | JS Module |

package/docs/stryker.config.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: stryker.config.mjs
+resource: npm/stryker.config.mjs
 docgen:
-  source: npm/stryker.config.mjs
   crc: b8c7377b
 ---
 
-# stryker.config.mjs
-
-## Огляд
-
 Цей файл містить дані про користувачів системи. Він використовується для зберігання інформації, необхідної для аутентифікації та авторизації користувачів, а також для управління їхніми правами доступу. Файл забезпечує централізоване місце для зберігання даних про користувачів, що спрощує управління обліковими записами.
 
 ## Поведінка

package/docs/vitest.config.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: vitest.config.js
+resource: npm/vitest.config.js
 docgen:
-  source: npm/vitest.config.js
   crc: d4917e1f
 ---
 
-# vitest.config.js
-
-## Огляд
-
 Цей файл містить код, який обробляє дані та генерує звіт. Він використовується для аналізу інформації та створення структурованого представлення результатів. Це ключовий компонент системи для забезпечення звітності та підтримки прийняття рішень.
 
 ## Поведінка

package/lib/docs/index.md

@@ -0,0 +1,14 @@
+---
+type: Directory Index
+title: npm/lib
+resource: npm/lib/
+---
+
+# npm/lib
+
+| Файл | Тип |
+|---|---|
+| [llm.mjs](llm.md) | JS Module |
+| [models.mjs](models.md) | JS Module |
+| [omlx-trace.mjs](omlx-trace.md) | JS Module |
+| [omlx.mjs](omlx.md) | JS Module |

package/lib/docs/llm.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: llm.mjs
+resource: npm/lib/llm.mjs
 docgen:
-  source: npm/lib/llm.mjs
-  crc: a70a8328
+  crc: 7b27f689
   score: 100
 ---
 
-# llm.mjs
-
-## Огляд
-
 Файл надає механізми для виклику великих мовних моделей. Маршрутизація вибору транспортного каналу залежить від префікса ідентифікатора моделі згідно з конвенцією `npm/lib/models.mjs`. Виклик LLM виконує виклик з визначеною маршрутизацією та запис трасування. Перевірка стану omlx сервера визначає доступність моделі.
 
 ## Поведінка

package/lib/docs/models.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: models.mjs
+resource: npm/lib/models.mjs
 docgen:
-  source: npm/lib/models.mjs
   crc: 181e2bf9
   score: 100
 ---
 
-# models.mjs
-
-## Огляд
-
 Файл визначає глобальну класифікацію моделей для pi. Конфігурація встановлюється через змінні середовища (наприклад, `N_LOCAL_MIN_MODEL`) та використовується для визначення, який провайдер буде викликаний. Кожен скіл посилається на потрібний тир, який використовується для вибору моделі.
 
 ## Поведінка

package/lib/docs/omlx-trace.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: omlx-trace.mjs
+resource: npm/lib/omlx-trace.mjs
 docgen:
-  source: npm/lib/omlx-trace.mjs
   crc: 3ff568d5
   score: 100
 ---
 
-# omlx-trace.mjs
-
-## Огляд
-
 Модуль збирає трасу викликів LLM, фіксуючи думки моделі та спостережуваний слід. Траса записується у локальний файл для ротації та готується для подальшої батч-агрегації. Дизайн-специфікація: docs/specs/2026-06-10-omlx-wire-trace-capture-design.md.
 
 ## Поведінка

package/lib/docs/omlx.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: omlx.mjs
+resource: npm/lib/omlx.mjs
 docgen:
-  source: npm/lib/omlx.mjs
-  crc: 0073bdfd
+  crc: 9a14ddbe
   score: 90
 ---
 
-# omlx.mjs
-
-## Огляд
-
 Файл забезпечує комунікацію з локальним omlx-сервером для отримання відповідей. Він маршрутизує запити, використовуючи конвенцію префікса для визначення, чи слід використовувати прямий HTTP виклик до omlx, чи CLI. Функції надають інструменти для роботи з API ключами та викликів до inference-сервера.
 
 ## Поведінка

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "11.4.0",
+  "version": "12.0.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -53,6 +53,7 @@
     "rename-yaml-extensions": "bun ./bin/n-cursor.js rename-yaml-extensions"
   },
   "dependencies": {
+    "@7n/mt": "^0.5.0",
     "oxc-parser": "^0.128.0",
     "picomatch": "^4.0.4",
     "smol-toml": "^1.6.1",

package/rules/abie/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/abie/fix.mjs
 docgen:
-  source: npm/rules/abie/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Запуск правила приймає контекст прогону, застосовує JS-занепокоєні та політику, генерує посилання MDC та повертає результат прогону.
 
 Виконання у режимі CLI виконує повний еквівалент команди `npx @nitra/cursor fix <id>` та повертає код виходу.

package/rules/abie/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/abie
+resource: npm/rules/abie/
+---
+
+# npm/rules/abie
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/abie/js/docs/applies.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: applies.mjs
+resource: npm/rules/abie/js/applies.mjs
 docgen:
-  source: npm/rules/abie/js/applies.mjs
   crc: f5b6777a
 ---
 
-# applies.mjs
-
-## Огляд
-
 Файл надає інструменти для валідації даних. Він використовується для порівняння об'єкта чи значення з визначеним правилом або набором критеріїв.
 
 ## Поведінка

package/rules/abie/js/docs/env_dns.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: env_dns.mjs
+resource: npm/rules/abie/js/env_dns.mjs
 docgen:
-  source: npm/rules/abie/js/env_dns.mjs
   crc: f2aff16b
   score: 100
 ---
 
-# env_dns.mjs
-
-## Огляд
-
 Функція check виконує перевірку відповідності вхідних даних визначеному контракту. Вона забезпечує ізоляцію логіки перевірки, перевіряючи виконання необхідних умов перед подальшою обробкою. Результати перевірки передаються через маркер (abie.mdc). Функція гарантує, що помилки не будуть прокидані назовні.
 
 ## Поведінка

package/rules/abie/js/docs/firebase_hosting.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: firebase_hosting.mjs
+resource: npm/rules/abie/js/firebase_hosting.mjs
 docgen:
-  source: npm/rules/abie/js/firebase_hosting.mjs
   crc: 3b2459a8
 ---
 
-# firebase_hosting.mjs
-
-## Огляд
-
 Функція `check` надає механізм валідації стану об'єктів проти визначеного контракту. Використовується для внутрішньої перевірки коректності даних без ініціювання зовнішніх операцій. Функція працює у режимі fail-safe, перехоплюючи помилки для забезпечення стабільності системи (abie.mdc).
 
 ## Поведінка

package/rules/abie/js/docs/hc_pairing.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: hc_pairing.mjs
+resource: npm/rules/abie/js/hc_pairing.mjs
 docgen:
-  source: npm/rules/abie/js/hc_pairing.mjs
   crc: 5627bda6
   score: 100
 ---
 
-# hc_pairing.mjs
-
-## Огляд
-
 Модуль забезпечує валідацію даних відповідно до визначеного контракту. Функція check є публічною і є Read-only. Модуль гарантує внутрішню цілісність стану системи через механізм fail-safe, який запобігає виходу з ладу при помилках. Робота модуля стосується даних, визначених у (abie.mdc).
 
 ## Поведінка

package/rules/abie/js/docs/index.md

@@ -0,0 +1,16 @@
+---
+type: Directory Index
+title: npm/rules/abie/js
+resource: npm/rules/abie/js/
+---
+
+# npm/rules/abie/js
+
+| Файл | Тип |
+|---|---|
+| [applies.mjs](applies.md) | JS Module |
+| [env_dns.mjs](env_dns.md) | JS Module |
+| [firebase_hosting.mjs](firebase_hosting.md) | JS Module |
+| [hc_pairing.mjs](hc_pairing.md) | JS Module |
+| [ua_http_route.mjs](ua_http_route.md) | JS Module |
+| [ua_node_selector.mjs](ua_node_selector.md) | JS Module |

package/rules/abie/js/docs/ua_http_route.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: ua_http_route.mjs
+resource: npm/rules/abie/js/ua_http_route.mjs
 docgen:
-  source: npm/rules/abie/js/ua_http_route.mjs
   crc: d86624c8
   score: 100
 ---
 
-# ua_http_route.mjs
-
-## Огляд
-
 Файл надає публічний інструмент `check` для перевірки внутрішнього стану даних. Функція працює у режимі fail-safe, перехоплюючи помилки виконання на рівні системи, щоб запобігти аварійним зупинкам. Функція використовує кешування даних у межах поточного прогону.
 
 ## Поведінка

package/rules/abie/js/docs/ua_node_selector.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: ua_node_selector.mjs
+resource: npm/rules/abie/js/ua_node_selector.mjs
 docgen:
-  source: npm/rules/abie/js/ua_node_selector.mjs
   crc: 6cde9837
   score: 100
 ---
 
-# ua_node_selector.mjs
-
-## Огляд
-
 Модуль надає публічну функцію `check` для валідації поточного стану вхідних даних. Функція виконує перевірку відповідності даних визначеним критеріям. Результат перевірки повертається у вигляді булевого значення. (abie.mdc)
 
 ## Поведінка

package/rules/abie/lib/docs/enabled.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: enabled.mjs
+resource: npm/rules/abie/lib/enabled.mjs
 docgen:
-  source: npm/rules/abie/lib/enabled.mjs
   crc: 6b02ea18
 ---
 
-# enabled.mjs
-
-## Огляд
-
 Файл керує активацією правил на рівні гейта. Він визначає, чи повинні виконуватися конфігураційні правила, викликаючи функцію `isAbieRuleEnabled` для перевірки наявності маркера `abie` у файлі `.n-cursor.json:rules`. Цей механізм використовується для фільтрації виконання правил, запобігаючи їх активації при відсутності необхідного прапорця.
 
 ## Поведінка

package/rules/abie/lib/docs/env-dns.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: env-dns.mjs
+resource: npm/rules/abie/lib/env-dns.mjs
 docgen:
-  source: npm/rules/abie/lib/env-dns.mjs
   crc: 91aa8ee4
 ---
 
-# env-dns.mjs
-
-## Огляд
-
 Файл перевіряє конфігураційні файли середовища (`*.dev.env`, `*.ua.env`) на відповідність внутрішніх URL-адрес ідентифікатору GKE-кластера. Функція `validateAbieEnvInternalUrls` сканує URL-адреси формату `http://<svc>.<ns>.<dns>` та вимагає, щоб компонент `<dns>` відповідав необхідному префіксу DNS, визначеному для відповідного кластера (`abie-dev.internal` або `abie-ua.internal`).
 
 ## Поведінка

package/rules/abie/lib/docs/hc-yaml.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: hc-yaml.mjs
+resource: npm/rules/abie/lib/hc-yaml.mjs
 docgen:
-  source: npm/rules/abie/lib/hc-yaml.mjs
   crc: e9aba7c8
 ---
 
-# hc-yaml.mjs
-
-## Огляд
-
 Файл виконує структурну валідацію конфігурації `modeline` у файлах `hc.yaml`. Функція `validateAbieHcModeline` перевіряє відповідність конфігурації визначеному контракту. Валідація проводиться порівнянням конфігурації з визначеною схемою, доступною за посиланням https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json. Цей процес забезпечує коректність конфігурації для ідентифікації (abie.mdc). Експортована константа ABIE_HC_SCHEMA_URL використовується для посилання на цю схему.
 
 ## Поведінка

package/rules/abie/lib/docs/http-route.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: http-route.mjs
+resource: npm/rules/abie/lib/http-route.mjs
 docgen:
-  source: npm/rules/abie/lib/http-route.mjs
   crc: 3ec544d6
 ---
 
-# http-route.mjs
-
-## Огляд
-
 Файл надає інструмент для порівняльного аналізу конфігурації HTTP-маршрутів. Він виконує порівняння кількості `backendRefs` для сервісів `auth-run-hl` та `file-link-hl` у базових маніфестах пакета з кількістю патчів, визначеною в оверлеях. Цей механізм використовується для синхронізації кількості патчів у верхньому рівні з фактичною кількістю посилань у базі. (abie.mdc)
 
 ## Поведінка

package/rules/abie/lib/docs/index.md

@@ -0,0 +1,18 @@
+---
+type: Directory Index
+title: npm/rules/abie/lib
+resource: npm/rules/abie/lib/
+---
+
+# npm/rules/abie/lib
+
+| Файл | Тип |
+|---|---|
+| [enabled.mjs](enabled.md) | JS Module |
+| [env-dns.mjs](env-dns.md) | JS Module |
+| [hc-yaml.mjs](hc-yaml.md) | JS Module |
+| [http-route.mjs](http-route.md) | JS Module |
+| [k8s-tree.mjs](k8s-tree.md) | JS Module |
+| [kustomization-patches.mjs](kustomization-patches.md) | JS Module |
+| [overlay-paths.mjs](overlay-paths.md) | JS Module |
+| [yaml.mjs](yaml.md) | JS Module |

package/rules/abie/lib/docs/k8s-tree.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: k8s-tree.mjs
+resource: npm/rules/abie/lib/k8s-tree.mjs
 docgen:
-  source: npm/rules/abie/lib/k8s-tree.mjs
   crc: 077f3478
 ---
 
-# k8s-tree
-
-## Огляд
-
 Модуль обходить дерево репозиторію й постачає правилу `abie` два набори даних про Kubernetes-маніфести: усі YAML-файли під сегментом `k8s/` та каталоги, що містять `Deployment`. Результати кешуються на час одного прогону (module-level singleton), тож кілька перевірок у межах однієї сесії перевикористовують єдиний обхід замість повторного I/O.
 
 ## Поведінка

package/rules/abie/lib/docs/kustomization-patches.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: kustomization-patches.mjs
+resource: npm/rules/abie/lib/kustomization-patches.mjs
 docgen:
-  source: npm/rules/abie/lib/kustomization-patches.mjs
   crc: 1dd36b33
 ---
 
-# kustomization-patches.mjs
-
-## Огляд
-
 Модуль розпізнає inline JSON6902-патчі всередині `kustomization.yaml` для abie ua-overlay і перевіряє, що вони відповідають вимогам правила `abie.mdc`. Обслуговує два сценарії: патч `nodeSelector` на `Deployment` (закріплення подів на не-preemptible вузлах) і патчі `HTTPRoute` (домени, namespace для `parentRefs` і `backendRefs`). Тіло `patch:` у YAML — це рядок із вкладеним JSON6902, тому розпізнавання спирається на пошук характерних підрядків (`path: …`, `value: …`), а не на повторний парсинг.
 
 ## Поведінка

package/rules/abie/lib/docs/overlay-paths.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: overlay-paths.mjs
+resource: npm/rules/abie/lib/overlay-paths.mjs
 docgen:
-  source: npm/rules/abie/lib/overlay-paths.mjs
   crc: 752f7012
 ---
 
-# overlay-paths
-
-## Огляд
-
 Набір path-хелперів для перевірок правила abie, що працює з k8s-структурою пакетів монорепо. Розрізняє base-шар пакета та `ua/` overlay, виводить каталог пакета зі шляху overlay і визначає, які додаткові вимоги (HTTPRoute, Deployment) застосовуються до конкретного overlay. Усі хелпери — чисті обчислення над шляхами без побічних ефектів, окрім перевірок наявності файлів `vite.config.*` на диску.
 
 ## Поведінка

package/rules/abie/lib/docs/yaml.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: yaml.mjs
+resource: npm/rules/abie/lib/yaml.mjs
 docgen:
-  source: npm/rules/abie/lib/yaml.mjs
   crc: 1b50e492
 ---
 
-# yaml.mjs
-
-## Огляд
-
 Спільний набір YAML-хелперів для перевірок правила `abie`. Інкапсулює читання й розбір YAML-файлів Kubernetes-маніфестів так, щоб усі abie-перевірки розбирали вміст однаково: з прибиранням BOM, ігноруванням службового modeline-рядка `# yaml-language-server: $schema=` і fail-safe-поведінкою при пошкоджених файлах.
 
 ## Поведінка

package/rules/adr/adr.mdc

@@ -6,7 +6,7 @@ version: '2.2'
 
 ## MADR v4 і дві фази
 
-ADR живуть у єдиному каталозі **`docs/adr/`**. Clean ADR-и мають формат **MADR v4.0.0 minimal** з точними section headings англійською:
+ADR живуть у єдиному каталозі **`docs/adr/`**. Clean ADR-и мають формат **MADR v4.0.0 minimal** з **OKF v0.1 frontmatter** і точними section headings англійською:
 
 - `## Context and Problem Statement`
 - `## Considered Options`
@@ -19,7 +19,7 @@ ADR живуть у єдиному каталозі **`docs/adr/`**. Clean ADR-
 Є два стани файлу, які відрізняються YAML frontmatter:
 
 - **Draft** — файл з frontmatter `session: …`, `captured: …`, `transcript: …` та timestamp-іменем `YYMMDD-HHMM-<sid>.md`. Пише `capture-decisions.sh` після кожної сесії.
-- **Clean** — файл без frontmatter, з kebab-case-іменем. `normalize-decisions.sh` зберігає timestamp-префікс чернетки → `YYMMDD-HHMM-<slug>.md` (наприклад `260518-0928-ланцюжок-запуску-abie.md`); створений руками clean-файл може мати просто `<slug>.md`.
+- **Clean** — файл з OKF v0.1 frontmatter (`type: ADR`, `title:`, `description:`) і kebab-case-іменем. Заголовок `#` у тілі не потрібен — `title:` у frontmatter вже є заголовком. `normalize-decisions.sh` зберігає timestamp-префікс чернетки → `YYMMDD-HHMM-<slug>.md` (наприклад `260518-0928-ланцюжок-запуску-abie.md`); створений руками clean-файл може мати просто `<slug>.md`.
 
 `normalize-decisions.sh` ніколи не чіпає clean-файли — крім випадку `merge-into`, коли дописує `## Update YYYY-MM-DD` в кінець наявного clean-файлу.