@nitra/cursor 12.15.0 → 12.16.0

package/rules/rust/docs/main.md

@@ -3,25 +3,25 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rust/main.mjs
 docgen:
-  crc: bbddef51
+  crc: 93dfaee0
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль надає інструменти для забезпечення якості коду на Rust. Він дозволяє виконати перевірку стилю за допомогою функції `lint` або запустити повну оркестрацію, що включає форматування та аналіз, за допомогою функції `run`. (rust.mdc)
+Модуль надає функції `run` та `lint` для аналізу коду на Rust. Функція `lint` виконує стандартну перевірку коду. Функція `run` запускає повну оркестрацію, яка включає форматування за допомогою `rustfmt` та статичний аналіз за допомогою `clippy` через `cargo` (rust.mdc).
 
 ## Поведінка
 
 run виконує стандартну перевірку для Rust-коду.
 
-lint запускає оркестрацію перевірки Rust-коду, включаючи форматування та аналіз.
+lint запускає оркестрацію перевірки Rust-коду, виконуючи `rustfmt` та `clippy` через `cargo`.
 
 ## Публічний API
 
-run — виконує основну перевірку, що включає перевірку логіки, пов'язаної з JS, політики та посиланнями MDC (rust.mdc).
-lint — забезпечує фіксацію та виконання перевірок стилю коду (аналогічно cargo fmt/clippy) для `n-cursor lint rust`.
+run — виконує основну логіку: перевіряє відповідність вимогам (JS-занепокложення $\rightarrow$ політика $\rightarrow$ mdc-посилання) (rust.mdc).
+lint — забезпечує оркестрацію для статичного аналізу коду Rust.
 
 ## Гарантії поведінки
 

package/rules/text/js/cspell-fix.mjs

@@ -20,7 +20,7 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { callLlm, preflightLocalModel } from '../../../lib/llm.mjs'
+import { runOneShot } from '../../../lib/pi-one-shot.mjs'
 
 /** Слово у рядку cspell: `<file>:<line>:<col> - Unknown word (xxx)`. */
 const UNKNOWN_WORD_RE = /Unknown word \(([^)]+)\)/u
@@ -114,10 +114,10 @@ export function appendWordsToDict(cwd, words) {
  * cspell-крок lint-text: класифікація → словник (нова схема).
  * @param {string} [cwd] корінь
  * @param {boolean} [readOnly] true → лише детект (нуль мутацій)
- * @param {boolean} [llmFix] opt-in omlx-класифікація (з `meta.json: llmFix:true`); без нього — лише детект
- * @returns {number} 0 — чисто; 1 — лишились знахідки / помилка середовища
+ * @param {boolean} [llmFix] opt-in LLM-класифікація (з `meta.json: llmFix:true`); без нього — лише детект
+ * @returns {Promise<number>} 0 — чисто; 1 — лишились знахідки / помилка середовища
  */
-export function runCspellText(cwd = process.cwd(), readOnly = false, llmFix = false) {
+export async function runCspellText(cwd = process.cwd(), readOnly = false, llmFix = false) {
   const bin = resolveCmd('npx')
   if (!bin) {
     process.stderr.write('❌ npx не знайдено в PATH (cspell).\n')
@@ -133,9 +133,8 @@ export function runCspellText(cwd = process.cwd(), readOnly = false, llmFix = fa
 
   // Fix-режим: класифікація знахідок (bounded JSON-вихід), валідні → у словник.
   const model = fixModel()
-  const problem = preflightLocalModel(model)
-  if (problem) {
-    process.stdout.write(`⚠️  cspell: класифікацію пропущено (${problem})\n`)
+  if (!model) {
+    process.stdout.write('⚠️  cspell: класифікацію пропущено (локальну модель не задано)\n')
     process.stdout.write(first.out)
     return first.code
   }
@@ -148,19 +147,19 @@ export function runCspellText(cwd = process.cwd(), readOnly = false, llmFix = fa
     )
   }
 
-  let text
-  try {
-    text = callLlm([{ role: 'user', content: classifyPrompt(batch) }], model, {
-      caller: 'cspell-classify',
-      maxTokens: 4000
-    })
-  } catch (error) {
-    process.stdout.write(`⚠️  cspell: omlx-класифікація впала (${error.message}) — без авто-словника\n`)
+  const res = await runOneShot({
+    messages: [{ role: 'user', content: classifyPrompt(batch) }],
+    modelSpec: model,
+    caller: 'cspell-classify',
+    cwd
+  })
+  if (res.error) {
+    process.stdout.write(`⚠️  cspell: LLM-класифікація впала (${res.error}) — без авто-словника\n`)
     process.stdout.write(first.out)
     return first.code
   }
 
-  const parsed = parseClassify(text)
+  const parsed = parseClassify(res.content)
   if (!parsed) {
     process.stdout.write('⚠️  cspell: не вдалося розпарсити класифікацію — без авто-словника\n')
     process.stdout.write(first.out)

package/rules/text/js/docs/cspell-fix.md

@@ -3,24 +3,31 @@ type: JS Module
 title: cspell-fix.mjs
 resource: npm/rules/text/js/cspell-fix.mjs
 docgen:
-  crc: e00c233e
+  crc: 3469ac34
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  score: 95
 ---
 
-Модуль інтегрує cspell у ланцюжку lint-text для класифікації невідомих слів згідно зі схемою docs/specs/2026-06-15-opportunistic-llm-fix-tier.md. Він виявляє невідомі слова, класифікує їх за допомогою LLM у межах omlx-класифікації. Валідні слова автоматично дописуються до `.cspell.json#words` (відповідно до конфігурацій .cspell.json та meta.json). Невалідні знахідки залишаються для ручного рев'ю. Процес є read-only (нуль мутацій), оскільки fix-режим не переписує файли, а лише класифікує знахідки. Після дописування словника виконується re-detect. Гейт-механізм гарантує, що cspell поверне ненульовий код, якщо нерозкласифіковані або потенційні одруки залишилися.
+## Огляд
+
+Огляд: Цей модуль інтегрує `cspell` у ланцюжок `lint-text` для забезпечення термінологічної коректності у тексті, використовуючи схему `omlx-класифікації`. Він ідентифікує неозначені слова, класифікує їх за допомогою LLM та автоматично доповнює словник `.cspell.json` валідними термінами, залишаючи потенційні помилки для ручного рев'ю.
+
+Поведінка:
+unknownWords витягує унікальні неозначені слова з виводу інструмента `cspell`.
+appendWordsToDict додає визначені як валідні слова до конфігураційного файлу `.cspell.json`, оновлюючи його в алфавітному порядку.
+runCspellText запускає процес класифікації неозначених слів, спочатку визначаючи їх, а потім, за умови увімкненого LLM-класифікатора, відправляючи їх на перевірку та додаючи валідні слова до словника, після чого повторно перевіряє код.
 
 ## Поведінка
 
-unknownWords витягує унікальні «Unknown word» з виводу cspell.
-appendWordsToDict дописує класифіковані валідні слова у `.cspell.json#words`, сортуючи та усуваючи дублікати.
-runCspellText запускає cspell, класифікує знахідки за допомогою LLM (якщо `llmFix` встановлено), дописує валідні слова у словник та повторно запускає cspell для перевірки, повертаючи код виходу.
+unknownWords витягує унікальні неозначені слова з виводу інструмента `cspell`.
+appendWordsToDict додає визначені як валідні слова до конфігураційного файлу `.cspell.json`, оновлюючи його в алфавітному порядку.
+runCspellText запускає процес класифікації неозначених слів, спочатку визначаючи їх, а потім, за умови увімкненого LLM-класифікатора, відправляючи їх на перевірку та додаючи валідні слова до словника, після чого повторно перевіряє код.
 
 ## Публічний API
 
-unknownWords — Збирає унікальні слова, які не були знайдені у cspell.
-appendWordsToDict — Додає зібрані слова до словника `.cspell.json` у відсортованому та унікальному вигляді.
-runCspellText — Виконує перевірку тексту за допомогою cspell для формування словника за новою схемою.
+unknownWords — Збирає унікальні слова, які `cspell` виявив як незнайомі у виводі.
+appendWordsToDict — Додає зібрані слова до словника `.cspell.json#words`, забезпечуючи унікальність та сортування.
+runCspellText — Виконує лінтування тексту з `cspell`: класифікує слова та оновлює словник з новою схемою.
 
 ## Гарантії поведінки
 

package/rules/text/main.mjs

@@ -110,9 +110,9 @@ function preflight(dep) {
  * Внутрішні кроки `lint-text` без локу.
  * @param {boolean} [readOnly] true → лише детект без авто-фіксу (нуль мутацій — CI/pre-commit)
  * @param {boolean} [llmFix] opt-in omlx-класифікація cspell (інші кроки фіксяться детерміновано за readOnly)
- * @returns {number} 0 — все OK, інакше — код першого кроку, що впав
+ * @returns {Promise<number>} 0 — все OK, інакше — код першого кроку, що впав
  */
-function runLintTextSteps(readOnly = false, llmFix = false) {
+async function runLintTextSteps(readOnly = false, llmFix = false) {
   // Auto-install: throws on failure → propagates as exit 1 from runStandardLint
   ensureTool('shellcheck')
   ensureTool('dotenv-linter')
@@ -120,8 +120,8 @@ function runLintTextSteps(readOnly = false, llmFix = false) {
   // patch потрібен лише для авто-фіксу shellcheck; у read-only пропускаємо preflight.
   if (!readOnly && !preflight(PATCH_PREFLIGHT)) return 1
 
-  console.log(`\n▶ cspell (${!readOnly && llmFix ? 'omlx-класифікація + словник + перевірка' : 'перевірка'})`)
-  const cspellCode = runCspellText(process.cwd(), readOnly, llmFix)
+  console.log(`\n▶ cspell (${!readOnly && llmFix ? 'LLM-класифікація + словник + перевірка' : 'перевірка'})`)
+  const cspellCode = await runCspellText(process.cwd(), readOnly, llmFix)
   if (cspellCode !== 0) return cspellCode
 
   console.log(`\n▶ shellcheck (${readOnly ? 'перевірка' : 'авто-фікс + фінальна перевірка'} *.sh)`)

package/schemas/skill-meta.json

@@ -17,6 +17,14 @@
     "worktree": {
       "type": "boolean",
       "description": "true — виконувати скіл в окремому git-worktree, один інстанс за раз (без паралельного запуску); false — у worktree не виконується."
+    },
+    "requireRoot": {
+      "type": "boolean",
+      "description": "true — скіл мутує CWD без worktree-ізоляції і має стартувати з кореня репо. Для worktree:true поле зайве (корінь гарантує worktree)."
+    },
+    "tier": {
+      "description": "Тира моделі для агентного виконання скіла через pi-runner. За відсутності — \"max\" (відкриті скіли потребують сильної моделі).",
+      "enum": ["min", "avg", "max"]
     }
   }
 }

package/scripts/docs/skills-cli.md

@@ -3,40 +3,36 @@ type: JS Module
 title: skills-cli.mjs
 resource: npm/scripts/skills-cli.mjs
 docgen:
-  crc: 85da573a
+  crc: e2d5fac6
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-Файл надає інструменти для запуску скілів пакета `@nitra/cursor` без синку правил у проєкт. Він зчитує інструкції скілів з файлів `SKILL.md` та збирає контекст з `package.json`, `tsconfig.json` та `.n-cursor.json` для формування промпту. Зібраний промпт делегується в `cursor-agent` або `claude` для виконання необхідних дій.
+## Огляд
 
-## Поведінка
-
-normalizeSkillId
-Перетворює ім'я скілу на ідентифікатор, видаляючи префікс n-
-
-listSkillIds
-Отримує відсортований список ідентифікаторів скілів, що мають файл SKILL.md
+Цей модуль забезпечує керування функціоналом скілів пакета `@nitra/cursor`. Він каталогізує доступні скіли на основі наявності файлу `SKILL.md` у відповідному пакеті. Для виконання скілу збирається контекст, що включає інструкції скілу та інформацію з конфігураційних файлів проєкту: `package.json`, `tsconfig.json`, `.n-cursor.json` та `main.json`. Система дозволяє або вивести список доступних скілів (`npx @nitra/cursor skill list`), або ініціювати виконання обраного скілу (наприклад, `npx @nitra/cursor skill pi taze`), з можливістю передачі додаткових аргументів. Пріоритетним механізмом виконання є інтеграція з вбудованим pi-агентом, тоді як для забезпечення сумісності підтримуються застарілі виклики через зовнішні CLI (`cursor`, `claude`).
 
-buildSkillPrompt
-Створює промпт, збираючи інструкцію скілу та контекст поточного проєкту з файлів package.json, tsconfig.json та .n-cursor.json
-
-resolveBundledPackageRoot
-Визначає абсолютний шлях до кореня пакета з урахуванням модуля
+## Поведінка
 
-runSkillsCli
-Запускає CLI для виконання скілів, збираючи промпт та контекст проєкту, та делегує виконання в `cursor-agent` або `claude`
+Поведінка
+normalizeSkillId знімає префікс `n-` з імені скілу для приведення його до стандартного ID.
+listSkillIds отримує відсортований список ID скілів, які мають файл `SKILL.md` у вказаній директорії скілів.
+buildSkillPrompt збирає комплексний промпт для виконання скілу, об'єднуючи інструкцію скілу з конфігураційними файлами проєкту, такими як `package.json`, `tsconfig.json` та `.n-cursor.json`.
+resolveBundledPackageRoot визначає абсолютний шлях до кореня пакету `@nitra/cursor`, використовуючи інформацію про поточний модуль.
+runSkillsCli виконує логіку командного інтерфейсу для керування скілами: може вивести список доступних скілів, зібрати промпт для скілу або ініціювати його виконання через вбудований pi-агент, використовуючи зовнішні CLI як резервний варіант.
 
 ## Публічний API
 
-normalizeSkillId — перетворює ідентифікатор навички.
-listSkillIds — отримує список ідентифікаторів навичок.
-buildSkillPrompt — створює запит для навички.
-resolveBundledPackageRoot — визначає основний каталог пакета.
-runSkillsCli — запускає клієнт для навичок.
+- normalizeSkillId — знімає префікс `n-` з імені скілу, приводячи його до id каталогу в пакеті.
+- listSkillIds — повертає відсортований список id скілів, що мають `SKILL.md`.
+- buildSkillPrompt — збирає промпт виконання: інструкція скілу + контекст проєкту (`package.json`, `tsconfig.json`, `.n-cursor.json`); кидає, якщо скіл невідомий.
+- resolveBundledPackageRoot — абсолютний шлях до кореня встановленого пакета `@nitra/cursor`.
+- runSkillsCli — асинхронний entrypoint підкоманди `skill`: `list`, друк промпта на stdout, або виконання через `pi` (рекомендовано), `cursor`/`claude` (deprecated). Повертає exit-код.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.
+- Сам модуль лише читає файли й збирає промпт; **виконання** делегується агенту: `pi` (вбудований, мутує дерево, запускає bash) або зовнішнім `cursor`/`claude` CLI.
+- Тира моделі для `pi`-runner береться з `main.json.tier` скіла (дефолт `max`).
+- `cursor`/`claude` — deprecated: друкують попередження й лишаються як fallback, доки не налаштовано pi-модель.

package/scripts/docs/update-blue-oak.md

@@ -3,25 +3,25 @@ type: JS Module
 title: update-blue-oak.mjs
 resource: npm/scripts/update-blue-oak.mjs
 docgen:
-  crc: f818f73b
+  crc: dac30fed
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 95
 ---
 
 ## Огляд
 
-Оновлює вбудований список ліцензій Blue Oak Council, отримуючи дані з https://blueoakcouncil.org/list.json. Витягує SPDX-ідентифікатори ліцензій рівнів Model, Gold, Silver та Bronze і зберігає їх у npm/data/blue-oak.json. Цей процес запускається вручну у середовищі @nitra/cursor командою bun npm/scripts/update-blue-oak.mjs. Оновлення відбувається рідко, але нові permissive ліцензії з'являються раз на кілька місяців. Lead-рівень (найгірший, GPL-compatible) навмисно виключений.
+Оновлює вбудований список ліцензій Blue Oak Council, звертаючись до мережі за даними з https://blueoakcouncil.org/list.json. Цей процес створює або оновлює файл npm/data/blue-oak.json, який містить SPDX-ідентифікатори ліцензій рівнів Model, Gold, Silver та Bronze. Запуск здійснюється вручну у `@nitra/cursor` за допомогою команди `bun npm/scripts/update-blue-oak.mjs`. Оновлення необхідне при апгрейді @nitra/cursor, оскільки нові permissive ліцензії з'являються рідко. Lead-рівень (найгірший, GPL-compatible) навмисно виключений.
 
 ## Поведінка
 
 1. Завантажує дані з https://blueoakcouncil.org/list.json.
-2. Перевіряє успішність отримання даних. У разі невдачі зупиняє виконання.
-3. Парсить отриманий JSON-відповідь.
+2. Перевіряє успішність отримання даних. У разі невдачі припиняє виконання.
+3. Парсить отримані дані.
 4. Ітерує по рейтингах у даних.
-5. Для кожного рейтингу перевіряє, чи належить він до рівнів Model, Gold, Silver або Bronze.
-6. Якщо рейтинг відповідає критеріям, витягує всі SPDX-ідентифікатори ліцензій, пов'язані з цим рейтингом, та додає їх до списку.
-7. Формує об'єкт, що містить версію даних та зібраний список SPDX-ідентифікаторів.
-8. Зберігає цей об'єкт у файл blue-oak.json у каталозі data.
+5. Вибирає лише рейтинги Model, Gold, Silver та Bronze.
+6. Збирає всі SPDX-ідентифікатори ліцензій, що належать до обраних рейтингів.
+7. Формує об'єкт, що містить версію та список зібраних SPDX-ідентифікаторів.
+8. Зберігає цей об'єкт у файл npm/data/blue-oak.json.
 
 ## Гарантії поведінки
 

package/scripts/lib/adr/docs/normalize-cli.md

@@ -3,29 +3,12 @@ type: JS Module
 title: normalize-cli.mjs
 resource: npm/scripts/lib/adr/normalize-cli.mjs
 docgen:
-  crc: 63a18347
+  crc: 222bfca4
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 90
+  score: 55
+  issues: no-overview,short-behavior,best-of-2:retry-lost
 ---
 
-Цей файл є CLI-обгорткою для локального нормалізатора ADR. Він зчитує шляхи до чернеток (`--batch <file>`) та список чистих ADR (`--clean <file>`), використовуючи директорію ADR (`--adr-dir <dir>`) для резолву шляхів. Обгортка запускає `normalizePipeline`, яка генерує JSON-контракт у форматі `{ "operations": [...] }` та виводить його у stdout для подальшого парсингу bash-скриптом. Прогрес та помилки записуються у stderr. Поведінка нормалізатора може бути змінена через змінні середовища: `ADR_NORMALIZE_ALLOW_CLOUD` контролює можливість хмарної ескалації, а `ADR_NORMALIZE_VOTES` визначає кількість голосів self-consistency для чистих ADR.
-
-## Поведінка
-
-1. Викликати runAdrNormalizeLocalCli.
-2. Зчитувати список шляхів до чернеток батчу з файлу, вказаного через аргумент `--batch`.
-3. Зчитувати список імен чистих ADR (кандидатів до злиття) з файлу, вказаного через аргумент `--clean`, якщо він наданий.
-4. Визначати директорію ADR, використовуючи аргумент `--adr-dir` або за замовчуванням `cwd/docs/adr`.
-5. Зчитувати вміст кожної чернетки батчу, резолвя шляхи відносно `--adr-dir`.
-6. Зчитувати значення змінних середовища `ADR_NORMALIZE_ALLOW_CLOUD` та `ADR_NORMALIZE_VOTES`.
-7. Викликати внутрішній механізм нормалізації, передаючи зібрані чернетки, список чистих ADR, та конфігурацію, отриману з змінних середовища.
-8. Виводити інформацію про прогрес та статистику в stderr.
-9. Виводити JSON-об'єкт, що містить операції, у stdout.
-
-## Публічний API
-
-runAdrNormalizeLocalCli — запускає субкоманду, виводячи JSON операцій у стандартний вивід та прогрес у стандартний помилковий вивід.
-
 ## Гарантії поведінки
 
 - Read-only: не виконує операцій запису (ФС/БД).

package/scripts/lib/adr/docs/normalize-pipeline.md

@@ -3,42 +3,12 @@ type: JS Module
 title: normalize-pipeline.mjs
 resource: npm/scripts/lib/adr/normalize-pipeline.mjs
 docgen:
-  crc: 9f2d42d3
+  crc: 8e9ca76f
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
+  score: 55
+  issues: no-overview,short-behavior,best-of-2:retry-lost
 ---
 
-Файл реалізує локально-орієнтований конвеєр для нормалізації чернеток архітектурних рішень (ADR). Він працює за принципом інверсії керування: JavaScript оркеструє процес, а LLM відповідає лише на вузькі, верифіковані запитання, будучи заточеним під малу локальну модель (omlx/gemma-4b). LLM використовується лише для бінарного судження схожості між записами (наприклад, через `edge-judge`) та витягування змісту секцій у JSON (через `gen-MADR`). Конвеєр збирає, валідує та складає повний MADR-каркас, використовуючи кластеризацію (`cluster` та `union-find`) та проходить через `validation gate`, повертаючи результат у вигляді операцій для застосування.
-
-## Поведінка
-
-tokenize: Токенізує назву або слаг, видаляючи стоп-слова та розширюючи його на значущі токени.
-jaccard: Обчислює коефіцієнт Jaccard між двома множинами токенів.
-draftTitle: Витягує заголовок з тіла чернетки, використовуючи ADR-шаблон або перший не-MADR заголовок.
-isNoDecision: Детерміновано визначає, чи рішення в чернетці явно не прийняте.
-buildEdges: Будує кандидати-ребра між чернетками та між чернетками і чистими ADR-файлами на основі лексичної схожості.
-validateMadr: Перевіряє згенерований MADR-текст на відповідність вимогам OKF та структурним елементам.
-madrDate: Детерміновано визначає ISO-дату для поля **Date:**, використовуючи дані з чернетки або імені файлу.
-normalizeSections: Нормалізує сирий JSON-вивід LLM у строгу структуру секцій MADR, толерантно до дрібних відхилень моделі.
-assembleMadr: Збирає канонічний MADR-markdown, використовуючи заголовок, дату та нормалізований контент секцій.
-genMadr: Витягує зміст архітектурного рішення з чернетки у JSON, а потім збирає його у валідний MADR-текст.
-normalizePipeline: Виконує повний конвеєр нормалізації, кластеризуючи чернетки та генеруючи операції для застосування.
-
-## Публічний API
-
-tokenize — Розбиває назву чи слаг на значущі слова, ігноруючи стоп-слова.
-jaccard — Вимірює схожість двох наборів слів.
-draftTitle — Витягує заголовок з чернетки, надаючи пріоритет заголовку ADR.
-isNoDecision — Визначає, чи не було прийнято рішення у чернетці, щоб уникнути створення зайвих ADR.
-buildEdges — Створює потенційні зв'язки між елементами на основі схожості слів.
-validateMadr — Перевіряє якість згенерованого документа ADR.
-madrDate — Формує стандартизовану дату для документа, використовуючи метадані або ім'я файлу.
-normalizeSections — Приводить неструктурований вивід генеративної моделі до чіткого формату секцій.
-assembleMadr — Збирає повний, стандартизований документ ADR, використовуючи фіксовані шаблони.
-genMadr — Створює чернетку документа ADR на основі вхідних даних.
-normalizePipeline — Виконує повний потік обробки даних, повертаючи результати та статистику.
-
 ## Гарантії поведінки
 
 - (специфічних машинно-виведених гарантій немає)

package/scripts/lib/adr/normalize-cli.mjs

@@ -43,7 +43,7 @@ const readLines = (file) =>
  * @param {string[]} argv аргументи після назви команди
  * @returns {number} exit-code (0 — успіх, 1 — помилка вводу)
  */
-export function runAdrNormalizeLocalCli(argv) {
+export async function runAdrNormalizeLocalCli(argv) {
   const args = parseArgs(argv)
   const adrDir = args['adr-dir'] ?? join(process.cwd(), 'docs/adr')
   if (!args.batch) {
@@ -61,7 +61,7 @@ export function runAdrNormalizeLocalCli(argv) {
   const allowCloud = env.ADR_NORMALIZE_ALLOW_CLOUD === '1'
   const votes = Number(env.ADR_NORMALIZE_VOTES) || 2
 
-  const { operations, stats, trace } = normalizePipeline(drafts, cleanList, {
+  const { operations, stats, trace } = await normalizePipeline(drafts, cleanList, {
     allowCloud,
     votes,
     onProgress: (m) => console.error(`adr-normalize-local: ${m}`)