@nitra/cursor 1.11.14 → 1.11.16

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

@@ -145,7 +145,33 @@ if ! printf '%s' "$RESPONSE_TRIMMED" | grep -q '^## '; then
 fi
 
 TS=$(date +%Y%m%d-%H%M%S)
-OUT="$ADR_DIR/$TS-${SESSION_ID:0:8}.md"
+
+# Slug із першого `## [ADR|Runbook|Knowledge] <heading>`-рядка відповіді.
+# Логіка локальна (без додаткового LLM-виклику): використовуємо вже згенерований heading.
+# Конвенція кебаб-slug-у — як у normalize-decisions.sh:171: малі літери, дозволено цифри, дефіс,
+# кирилиця; англомовні технічні терміни лишаються англійською без транслітерації.
+HEADING=$(printf '%s' "$RESPONSE_TRIMMED" \
+  | awk '/^## (\[?(ADR|Runbook|Knowledge)\]?)/{ sub(/^## /,""); sub(/^\[?(ADR|Runbook|Knowledge)\]?[[:space:]]*:?[[:space:]]*/,""); print; exit }')
+SLUG=$(printf '%s' "$HEADING" \
+  | tr '[:upper:]' '[:lower:]' \
+  | sed -E 's/[`«»"]//g; s/[ /,.:;()—–]+/-/g; s/[^a-zа-яёіїєґ0-9-]//g; s/-+/-/g; s/^-//; s/-$//' \
+  | cut -c1-60 \
+  | sed -E 's/-$//')
+
+if [[ -z "$SLUG" ]]; then
+  # Fallback на старий формат, якщо heading не спарсився
+  OUT="$ADR_DIR/$TS-${SESSION_ID:0:8}.md"
+else
+  # Колізії: <timestamp>-<slug>-<n>.md (n=2,3,...), як у normalize-decisions.sh:244-257
+  BASE="$ADR_DIR/$TS-$SLUG.md"
+  OUT="$BASE"
+  n=2
+  while [[ -e "$OUT" ]]; do
+    OUT="$ADR_DIR/$TS-$SLUG-$n.md"
+    n=$((n+1))
+  done
+fi
+
 {
   printf -- '---\nsession: %s\ncaptured: %s\ntranscript: %s\n---\n\n' \
     "$SESSION_ID" "$(date -Iseconds)" "$TRANSCRIPT_PATH"

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.11.16] - 2026-05-16
+
+### Changed
+
+- **`npm/rules/adr/adr.mdc`**, **`npm/scripts/auto-rules.mjs`**, **`npm/rules/adr/auto.md`** — правило `adr` тепер **увімкнене за замовчуванням** (`addRule('adr')` без умови, поруч з `addRule('text')`; `auto.md` = `завжди`). Раніше — opt-in вручну через `"adr"` у `rules`. Щоб вимкнути для конкретного репо — `"adr"` у `disable-rules`. Текст правила і JSDoc у `sync-claude-config.mjs` оновлено відповідно. Існуючі `.n-cursor.json` із явним `"adr"` у `rules` лишаються валідними (`mergeConfigWithAutoDetected` дедуплікує).
+- **Мотивація:** ADR/Runbook/Knowledge capture виявився корисним для всіх проєктів команди, а не лише тих, де його свідомо ввімкнули; opt-out зручніший за opt-in, бо інтегрує hooks у новий репо з коробки.
+
+## [1.11.15] - 2026-05-16
+
+### Changed
+
+- **`npm/.claude-template/hooks/capture-decisions.sh`** (+`.claude/hooks/capture-decisions.sh` синк) — Stop-hook тепер генерує **slug-name** для чернетки замість session-hash суфікса. Раніше: `<timestamp>-<session-id[0:8]>.md` (наприклад `20260516-090349-e513a1f0.md`). Тепер: `<timestamp>-<slug>.md` (наприклад `20260516-090349-структура-директорій-правила-fix-lint-policy.md`). **Slug береться з вже згенерованого LLM-заголовка** першого `## [ADR|Runbook|Knowledge] <heading>` блоку — без додаткового LLM-виклику, та сама вартість Stop-hook. Конвенція slug-у синхронізована з `normalize-decisions.sh:171`: малі літери, цифри, дефіс, кирилиця; англомовні технічні терміни лишаються англійською (`fix`, `lint`, `policy` — не транслітеруються). Колізії в межах однієї секунди — суфікс `-2`, `-3`, …, як у `normalize-decisions.sh:244-257`. Fallback на старий `<timestamp>-<session-id[0:8]>.md` якщо heading не спарсився (response без `## ADR|Runbook|Knowledge` префікса).
+- **Мотивація:** після прогону `normalize-decisions.sh` нові чернетки створювалися з абстрактними session-hash іменами і знову вимагали LLM-`rewrite`-операцію щоб отримати читабельний slug. Тепер capture одразу пише читабельний slug → наступна нормалізація обмежується лише `delete`/`merge-into` для дублікатів (rename-операції стають рідкісними).
+
 ## [1.11.14] - 2026-05-16
 
 ### Removed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.11.14",
+  "version": "1.11.16",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -52,5 +52,8 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
+  },
+  "devDependencies": {
+    "@nitra/cursor": "^1.11.16"
   }
 }

package/rules/adr/adr.mdc

@@ -4,9 +4,9 @@ alwaysApply: true
 version: '2.0'
 ---
 
-Правило вмикається **вручну** — додай `"adr"` у масив `rules` файлу `.n-cursor.json`. У `auto-rules.md` його немає, бо корисність залежить від робочого процесу команди (не кожен проєкт хоче літати ADR-чернеткам у `docs/`).
+Правило увімкнене **за замовчуванням** (як [[text]]) — `npx @nitra/cursor` сам додає `"adr"` у `rules` файлу `.n-cursor.json`. Щоб вимкнути для конкретного репо (не кожен проєкт хоче літати ADR-чернеткам у `docs/`), додай `"adr"` у `disable-rules`.
 
-Коли правило увімкнене, **`npx @nitra/cursor`** автоматично:
+Коли правило увімкнене (за замовчуванням), **`npx @nitra/cursor`** автоматично:
 
 - копіює канонічний bash-скрипт у **`.claude/hooks/capture-decisions.sh`** (executable, повністю керується пакетом — на кожен sync перезаписується);
 - копіює канонічний bash-скрипт у **`.claude/hooks/normalize-decisions.sh`** (батч-нормалізація чернеток через LLM);

package/rules/adr/auto.md

@@ -0,0 +1 @@
+завжди

package/scripts/auto-rules.mjs

@@ -27,6 +27,7 @@ import { contentForVueImportScan } from './utils/vue-forbidden-imports.mjs'
 /** Порядок автододавання правил відповідно до `rules/<rule>/auto.md`. */
 export const AUTO_RULE_ORDER = Object.freeze([
   'abie',
+  'adr',
   'bun',
   'capacitor',
   'changelog',
@@ -657,6 +658,7 @@ export async function detectAutoRules({
       addRule(item.id)
     }
   }
+  addRule('adr')
   addRule('text')
   if (facts.hasVueSource) {
     addRule('vue')

package/scripts/sync-claude-config.mjs

@@ -12,8 +12,9 @@
  * - `.claude/commands/n-check.md` — fully owned slash-команда.
  * - `.claude/hooks/capture-decisions.sh` — fully owned bash-скрипт ADR capture Stop-hook;
  *   копіюється з `.claude-template/hooks/`, лише коли в `.n-cursor.json` `rules`
- *   присутнє `adr` (правило вмикається вручну). Якщо правила немає, керована
- *   ADR-група в hooks так само автоматично прибирається з settings.json.
+ *   присутнє `adr` (правило увімкнене за замовчуванням; вимикається через
+ *   `disable-rules: ["adr"]`). Якщо правила немає, керована ADR-група в hooks
+ *   так само автоматично прибирається з settings.json.
  * - `.claude/hooks/normalize-decisions.sh` — fully owned bash-скрипт ADR normalize
  *   Stop-hook (батч-нормалізація чернеток); умови — ті самі, що для `capture`.
  *