@nitra/cursor 1.13.67 → 1.13.69

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

@@ -165,6 +165,8 @@ PROMPT_HEADER=$(cat <<'EOF'
   ]
 }
 
+Принцип вибору операції: уникай дрібних дублів. Перш ніж обрати `rewrite`, звір тему драфта з clean-списком і з рештою драфтів цього батча. Якщо рішення по суті вже зафіксоване — у наявному clean-ADR або в драфті, який ти переписуєш через `rewrite`, — і драфт лише уточнює / доповнює / виправляє / продовжує його, обери `merge-into`, а не `rewrite`. `rewrite` (новий файл) виправданий лише для справді самостійного, нового рішення. Краще один повний наскрізний ADR, ніж кілька майже однакових файлів.
+
 Правила:
 
 1. `delete` — драфт тривіальний / повністю покритий іншим існуючим clean-ADR-ом / порожній. Поясни короткою причиною українською.
@@ -180,14 +182,17 @@ PROMPT_HEADER=$(cat <<'EOF'
    - У `## More Information` перенеси файли, команди, публічні API, конфіги й transcript facts. Якщо нема — `Додаткової інформації в transcript не зафіксовано.`
    - `slug` — kebab-case українською (наприклад `ланцюжок-запуску-abie`, `npm-publish-flow`). Без розширення `.md`. Літери малі, дозволено цифри, дефіс, кирилиця. Якщо тема технічна англійською (назва пакету, ключове слово) — лиши англійською без транслітерації.
 
-3. `merge-into` — драфт повторює тему вже існуючого clean-файлу зі списку нижче. `target` — точна назва файлу зі списку (з `.md`). `additions` — лише новий зміст, який варто дописати в кінець target-файлу під підзаголовком `## Update YYYY-MM-DD` (date з `captured` драфта). Якщо нічого нового додати — використовуй `delete`.
+3. `merge-into` — рішення драфта НЕ самостійне: воно лише уточнює, доповнює, виправляє або продовжує рішення, яке вже зафіксоване або (а) в clean-файлі зі списку нижче, або (б) у драфті цього ж батча, який ти переписуєш через `rewrite`. `target`:
+   - для (а) — точна назва clean-файлу зі списку (з `.md`);
+   - для (б) — `<slug>.md`, де `<slug>` дорівнює полю `slug` тієї `rewrite`-операції (timestamp-префікс скрипт додасть сам — не дописуй його).
+   `additions` — лише новий зміст, який варто дописати в кінець target-файлу під підзаголовком `## Update YYYY-MM-DD` (date з `captured` драфта). Якщо нічого нового додати — використовуй `delete`.
 
 Жорсткі обмеження:
 
 - Поверни валідний JSON, нічого крім нього. Жодних code-fence, жодних коментарів.
 - Кожен файл з вхідного списку має зʼявитися у `operations` рівно один раз.
 - Слаги не повторювати між операціями того самого батча. Якщо дві чернетки про одну тему — одна `rewrite`, інша `merge-into target: <slug>.md` з тим самим slug-ом.
-- Не вигадуй target, якого нема у списку clean-файлів.
+- `target` у `merge-into` — це або файл зі списку clean-файлів, або `<slug>.md` rewrite-операції цього ж батча. Іншого target не вигадуй.
 - Не вигадуй альтернативи, decision drivers, наслідки, людей або зовнішній контекст. Якщо даних бракує — явно напиши, що transcript цього не містить.
 
 Вхідні драфти і clean-список — нижче.
@@ -278,7 +283,22 @@ resolve_unique_slug_path() {
 APPLIED=0
 SKIPPED=0
 
-jq -c '.operations[]' "$RESPONSE_CLEAN_FILE" | while IFS= read -r op_json; do
+# Apply operations in two ordered groups — delete/rewrite first, merge-into
+# last — so a merge-into can target a clean file that a rewrite of the same
+# batch only just created. Looping over a file (not a pipe) keeps the loop in
+# the main shell, so APPLIED/SKIPPED survive to the final summary line.
+OPS_FILE="$TMP_DIR/ops.jsonl"
+{
+  jq -c '.operations[] | select(.op != "merge-into")' "$RESPONSE_CLEAN_FILE"
+  jq -c '.operations[] | select(.op == "merge-into")' "$RESPONSE_CLEAN_FILE"
+} > "$OPS_FILE"
+
+# slug → created clean-file path: written by rewrite ops, read by merge-into
+# ops (one tab-separated "slug<TAB>path" line per rewrite).
+SLUG_MAP="$TMP_DIR/slug-map.txt"
+: > "$SLUG_MAP"
+
+while IFS= read -r op_json; do
   OP=$(printf '%s' "$op_json" | jq -r '.op // empty')
   FILE=$(printf '%s' "$op_json" | jq -r '.file // empty')
   SRC_PATH="$ADR_DIR/$FILE"
@@ -349,6 +369,9 @@ jq -c '.operations[]' "$RESPONSE_CLEAN_FILE" | while IFS= read -r op_json; do
       DEST_PATH=$(resolve_unique_slug_path "$DEST_SLUG")
       printf '%s\n' "$CONTENT" > "$DEST_PATH"
       rm -- "$SRC_PATH"
+      # Record bare slug → final path so a same-batch merge-into can target
+      # this freshly created file by `<slug>.md` despite the timestamp prefix.
+      printf '%s\t%s\n' "$SLUG" "$DEST_PATH" >> "$SLUG_MAP"
       log "rewrite: $FILE → $(basename "$DEST_PATH")"
       APPLIED=$(( APPLIED + 1 ))
       ;;
@@ -367,7 +390,32 @@ jq -c '.operations[]' "$RESPONSE_CLEAN_FILE" | while IFS= read -r op_json; do
           continue
           ;;
       esac
+      # Resolve the target clean file. The LLM gives a bare `<slug>.md`, but the
+      # real file usually carries a `YYYYMMDD-HHMMSS-` prefix. Try, in order:
+      #   1. exact name in docs/adr/,
+      #   2. a rewrite of this batch that produced that slug (SLUG_MAP),
+      #   3. a unique existing clean file whose name ends with `-<slug>.md`.
       TARGET_PATH="$ADR_DIR/$TARGET"
+      if [ ! -f "$TARGET_PATH" ]; then
+        TSLUG="${TARGET%.md}"
+        MAPPED=$(awk -F'\t' -v s="$TSLUG" '$1 == s { print $2; exit }' "$SLUG_MAP")
+        if [ -z "$MAPPED" ]; then
+          SUFFIX_HITS=0
+          for cf in "$ADR_DIR"/*-"$TSLUG".md; do
+            [ -f "$cf" ] || continue
+            MAPPED="$cf"
+            SUFFIX_HITS=$(( SUFFIX_HITS + 1 ))
+          done
+          if [ "$SUFFIX_HITS" -gt 1 ]; then
+            log "skip merge-into: target '$TARGET' ambiguous ($SUFFIX_HITS matches)"
+            SKIPPED=$(( SKIPPED + 1 ))
+            continue
+          fi
+        fi
+        if [ -n "$MAPPED" ]; then
+          TARGET_PATH="$MAPPED"
+        fi
+      fi
       if [ ! -f "$TARGET_PATH" ]; then
         log "skip merge-into: target '$TARGET' missing"
         SKIPPED=$(( SKIPPED + 1 ))
@@ -380,7 +428,7 @@ jq -c '.operations[]' "$RESPONSE_CLEAN_FILE" | while IFS= read -r op_json; do
       fi
       printf '\n%s\n' "$ADDITIONS" >> "$TARGET_PATH"
       rm -- "$SRC_PATH"
-      log "merge-into: $FILE → $TARGET"
+      log "merge-into: $FILE → $(basename "$TARGET_PATH")"
       APPLIED=$(( APPLIED + 1 ))
       ;;
     *)
@@ -388,6 +436,6 @@ jq -c '.operations[]' "$RESPONSE_CLEAN_FILE" | while IFS= read -r op_json; do
       SKIPPED=$(( SKIPPED + 1 ))
       ;;
   esac
-done
+done < "$OPS_FILE"
 
-log "done"
+log "done (applied $APPLIED, skipped $SKIPPED)"

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.69] - 2026-05-21
+
+### Changed
+
+- **CLI `check` без аргументів** більше не парсить `AGENTS.md` — список правил для прогону будується з **`*.mdc` у `.cursor/rules/`** (той самий дисковий індекс, що для `AGENTS.md` / `CLAUDE.md`): `n-bun.mdc` → `check bun`, ручні `conftest.mdc` тощо — за наявності programmatic check у пакеті. Явний `check bun ga` без змін. Зачеплено: [discover-check-rules-from-cursor.mjs](scripts/utils/discover-check-rules-from-cursor.mjs), [n-cursor.js](bin/n-cursor.js), [fix/SKILL.md](skills/fix/SKILL.md).
+
+## [1.13.68] - 2026-05-21
+
+### Changed
+
+- ADR-хук **`normalize-decisions.sh`**: нормалізація тепер активніше повторно використовує наявні ADR замість створення нових файлів. У промпт додано принцип вибору операції — перш ніж `rewrite` (новий файл), агент звіряє тему драфта з clean-списком і рештою драфтів батча; якщо рішення по суті вже зафіксоване і драфт лише уточнює/доповнює/виправляє його — обирає `merge-into`. Правило `merge-into` тепер явно дозволяє `target` двох видів: clean-файл зі списку або `<slug>.md` `rewrite`-операції цього ж батча; суперечливе обмеження «не вигадуй target поза clean-списком» узгоджено з цим. Зачеплено: [normalize-decisions.sh](.claude-template/hooks/normalize-decisions.sh).
+
+### Fixed
+
+- ADR-хук **`normalize-decisions.sh`**: `merge-into` більше не падає в `skip … target missing`, коли драфт треба влити в clean-ADR, який створює `rewrite` того самого батча, або в наявний clean-ADR, на який LLM послався голим `<slug>.md` без timestamp-префікса. Операції тепер застосовуються двома впорядкованими групами (спершу `delete`/`rewrite`, потім `merge-into`), а `target` резолвиться за трьома кроками: точна назва → slug-мапа rewrite-ів цього батча → єдиний наявний clean-файл із суфіксом `-<slug>.md`. Цикл застосування переведено з pipe на читання з файлу — лічильники `applied`/`skipped` виживають і потрапляють у фінальний рядок логу `done (applied N, skipped M)`. Зачеплено: [normalize-decisions.sh](.claude-template/hooks/normalize-decisions.sh).
+
 ## [1.13.67] - 2026-05-21
 
 ### Changed

package/bin/n-cursor.js

@@ -5,9 +5,9 @@
  *
  * Використання:
  *   `npx \@nitra/cursor`             — завантажити cursor-правила
- *   `npx \@nitra/cursor check`       — перевірити правила, перелічені в AGENTS.md (якщо є check-*.mjs);
+ *   `npx \@nitra/cursor check`       — перевірити правила з `.cursor/rules/*.mdc`, для яких у пакеті є check/policy;
  *                                     якщо в корені вже є `.n-cursor.json`, спочатку зчитується конфіг і за потреби дописується `$schema`
- *   `npx \@nitra/cursor check bun`   — перевірити лише вказані правила (ігнорує AGENTS.md)
+ *   `npx \@nitra/cursor check bun`   — перевірити лише вказані правила (ігнорує `.cursor/rules/`)
  *   `npx \@nitra/cursor rename-yaml-extensions` — k8s `*.yml` → `*.yaml`, `.github` `*.yaml` → `*.yml` (опції: `--dry-run`, `--root=…`; див. bin/rename-yaml-extensions.mjs)
  *   `npx \@nitra/cursor stop-hook`   — точка входу Stop hook Claude Code (читає stdin, виходить 0 при `stop_hook_active`,
  *                                     інакше викликає `check`); прописується автоматично в `.claude/settings.json`
@@ -78,6 +78,7 @@ import {
 } from '../scripts/auto-rules.mjs'
 import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { runStopHookCli } from '../scripts/claude-stop-hook.mjs'
+import { discoverCheckRulesFromCursorRules } from '../scripts/utils/discover-check-rules-from-cursor.mjs'
 import { discoverCheckableRules } from '../scripts/utils/discover-checkable-rules.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { runLintDocker } from '../rules/docker/lint/lint.mjs'
@@ -978,57 +979,10 @@ function discoverCheckScripts() {
 }
 
 /**
- * Перетворює базове ім'я .mdc у .cursor/rules на id скрипта check-<id>.mjs
- * @param {string} mdcBasename наприклад n-bun.mdc або script.mdc
- * @returns {string} id без суфікса .mdc та без префікса n- для керованих правил
- */
-function mdcBasenameToCheckId(mdcBasename) {
-  const base = basename(mdcBasename)
-  const withoutExt = base.endsWith('.mdc') ? base.slice(0, -'.mdc'.length) : base
-  return withoutExt.startsWith(RULE_PREFIX) ? withoutExt.slice(RULE_PREFIX.length) : withoutExt
-}
-
-/**
- * Зчитує AGENTS.md і повертає унікальні id перевірок у порядку згадування, лише ті що є в available
- * @param {string[]} available імена з discoverCheckScripts()
- * @returns {Promise<string[]>} унікальні id перевірок у порядку згадування в AGENTS.md
- */
-async function discoverCheckRulesFromAgentsMd(available) {
-  const agentsPath = join(cwd(), AGENTS_FILE)
-  if (!existsSync(agentsPath)) {
-    throw new Error(
-      `Немає ${AGENTS_FILE}. Запустіть \`npx ${PACKAGE_NAME}\` або вкажіть правила: \`npx ${PACKAGE_NAME} check bun ga\``
-    )
-  }
-  const text = await readFile(agentsPath, 'utf8')
-  const re = /\.cursor\/rules\/([^\s#`>]+\.mdc)/g
-  const raw = []
-  let m
-  while ((m = re.exec(text)) !== null) {
-    raw.push(m[1])
-  }
-  if (raw.length === 0) {
-    throw new Error(
-      `У ${AGENTS_FILE} немає посилань \`.cursor/rules/….mdc\`. Оновіть файл (\`npx ${PACKAGE_NAME}\`) або передайте правила явно.`
-    )
-  }
-  const seen = new Set()
-  const ordered = []
-  for (const pathFragment of raw) {
-    const id = mdcBasenameToCheckId(pathFragment)
-    if (available.includes(id) && !seen.has(id)) {
-      seen.add(id)
-      ordered.push(id)
-    }
-  }
-  return ordered
-}
-
-/**
- * Запускає перевірки: без аргументів — за списком у AGENTS.md; з аргументами — лише вказані правила.
+ * Запускає перевірки: без аргументів — за `*.mdc` у `.cursor/rules/`; з аргументами — лише вказані правила.
  * Делегує оркестрацію concern-ів (JS-checks + policy через `runConftestBatch`) у `runRule`;
  * сам `runChecks` відповідає лише за фільтр id, агрегацію exit-кодів і shared walk-cache на прогон.
- * @param {string[]} requestedRules імена правил; порожній масив — брати з AGENTS.md
+ * @param {string[]} requestedRules імена правил; порожній масив — брати з `.cursor/rules/*.mdc`
  * @returns {Promise<void>}
  */
 async function runChecks(requestedRules) {
@@ -1054,10 +1008,16 @@ async function runChecks(requestedRules) {
   if (requestedRules.length > 0) {
     idsToCheck = requestedRules
   } else {
-    idsToCheck = await discoverCheckRulesFromAgentsMd(available)
+    const mdcFiles = await listProjectRulesMdcFiles()
+    if (mdcFiles.length === 0) {
+      throw new Error(
+        `Немає файлів *.mdc у ${RULES_DIR}/. Запустіть \`npx ${PACKAGE_NAME}\` або вкажіть правила: \`npx ${PACKAGE_NAME} check bun ga\``
+      )
+    }
+    idsToCheck = discoverCheckRulesFromCursorRules(available, mdcFiles)
     if (idsToCheck.length === 0) {
       console.log(
-        `\n🔍 ${PACKAGE_NAME} check — у ${AGENTS_FILE} немає правил з programmatic перевіркою ` +
+        `\n🔍 ${PACKAGE_NAME} check — у ${RULES_DIR}/ немає правил з programmatic перевіркою ` +
           `(відповідного check-*.mjs або policy/<name>/target.json у пакеті). Нічого не запущено.\n`
       )
       return

package/package.json

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

package/scripts/utils/discover-check-rules-from-cursor.mjs

@@ -0,0 +1,40 @@
+/**
+ * Визначає список id правил для `npx @nitra/cursor check` без аргументів:
+ * зчитує базові імена `*.mdc` у `.cursor/rules/` і залишає лише ті id,
+ * для яких у пакеті є programmatic перевірка (JS-концерн або policy з target.json).
+ */
+
+/** Префікс керованих правил пакета у `.cursor/rules/`. */
+export const MANAGED_RULE_FILE_PREFIX = 'n-'
+
+/**
+ * Перетворює базове ім'я `.mdc` у id правила для `check <id>`.
+ * @param {string} mdcBasename наприклад `n-bun.mdc` або `my-rule.mdc`
+ * @returns {string} id без `.mdc`; для `n-*` — без префікса `n-`
+ */
+export function mdcBasenameToCheckId(mdcBasename) {
+  const base = mdcBasename.includes('/') ? mdcBasename.slice(mdcBasename.lastIndexOf('/') + 1) : mdcBasename
+  const withoutExt = base.endsWith('.mdc') ? base.slice(0, -'.mdc'.length) : base
+  return withoutExt.startsWith(MANAGED_RULE_FILE_PREFIX)
+    ? withoutExt.slice(MANAGED_RULE_FILE_PREFIX.length)
+    : withoutExt
+}
+
+/**
+ * Будує впорядкований список id перевірок за файлами правил на диску.
+ * @param {string[]} available id з `discoverCheckableRules` (алфавітний порядок пакета)
+ * @param {string[]} mdcBasenames відсортовані імена `*.mdc` з `.cursor/rules/`
+ * @returns {string[]} унікальні id у порядку `mdcBasenames`, лише присутні в `available`
+ */
+export function discoverCheckRulesFromCursorRules(available, mdcBasenames) {
+  const seen = new Set()
+  const ordered = []
+  for (const basename of mdcBasenames) {
+    const id = mdcBasenameToCheckId(basename)
+    if (available.includes(id) && !seen.has(id)) {
+      seen.add(id)
+      ordered.push(id)
+    }
+  }
+  return ordered
+}

package/skills/fix/SKILL.md

@@ -12,7 +12,7 @@ description: >-
 
 ## Workflow
 
-1. **Діагностика** — запусти перевірку (за замовчуванням лише правила з `AGENTS.md`, для яких є `check-*.mjs`; повний набір — явні аргументи: `npx @nitra/cursor check bun ga …`):
+1. **Діагностика** — запусти перевірку (за замовчуванням лише правила з `.cursor/rules/*.mdc`, для яких у пакеті є programmatic check; повний набір — явні аргументи: `npx @nitra/cursor check bun ga …`):
 
 ```bash
 npx @nitra/cursor check