@nitra/cursor 1.13.63 → 1.13.64

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.64] - 2026-05-20
+
+### Added
+
+- **`sync-claude-config`**: при увімкненому правилі `adr` `npx @nitra/cursor` дописує в кореневий `.gitignore` канонічний фрагмент `rules/adr/fix/hooks/template/.gitignore.snippet` (`.claude/hooks/*.log`, `.normalize-state`, `.normalize.lock`) — логи ADR Stop-hook більше не потрапляють у git status.
+
+### Changed
+
+- Правило **`adr`**: посилання на канон `.gitignore.snippet` і згадка автоматичного дописування під час sync.
+- **`.gitignore.snippet`**: додано базові рядки `node_modules/`, `dist/`, `*.secret` (як у кореневому `.gitignore` пакета).
+
 ## [1.13.63] - 2026-05-20
 
 ### Fixed

package/bin/n-cursor.js

@@ -1274,6 +1274,7 @@ async function runSync() {
     if (result.commands.length > 0) parts.push(`${result.commands.length} slash-commands`)
     if (result.adrHook) parts.push('.claude/hooks/capture-decisions.sh')
     if (result.adrNormalizeHook) parts.push('.claude/hooks/normalize-decisions.sh')
+    if (result.gitignoreAdr) parts.push('.gitignore (adr fragment)')
     if (parts.length > 0) {
       console.log(`🤖 Claude-конфіг: ${parts.join(', ')}`)
     }

package/package.json

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

package/rules/adr/adr.mdc

@@ -95,7 +95,7 @@ docs/adr/
 └── hooks.json                 # Cursor Agent stop-hooks для тих самих скриптів
 ```
 
-`.gitignore` повинен містити рядки, що покривають **`.claude/hooks/*.log`** і службові файли normalize (`.claude/hooks/.normalize-*`).
+`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене): [.gitignore.snippet](./fix/hooks/template/.gitignore.snippet).
 
 ## Stop-hook у `.claude/settings.json`
 

package/rules/adr/fix/hooks/template/.gitignore.snippet

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+*.secret
+
+# @nitra/cursor (adr) — локальні артефакти Stop-hook, не коміти
+.claude/hooks/*.log
+.claude/hooks/.normalize-state
+.claude/hooks/.normalize.lock

package/rules/changelog/fix/consistency/check.mjs

@@ -158,13 +158,11 @@ async function resolveChangelogComparisonPoint(branch) {
   }
 
   if (branch === 'main') {
-    const originMainSha = (await gitOrNull(['rev-parse', '--verify', '--quiet', 'origin/main']))?.trim()
-    const headSha = (await gitOrNull(['rev-parse', 'HEAD']))?.trim()
-    if (
-      originMainSha &&
-      headSha &&
-      (originMainSha === headSha || (await isGitAncestor('origin/main', 'HEAD')))
-    ) {
+    const originMainRaw = await gitOrNull(['rev-parse', '--verify', '--quiet', 'origin/main'])
+    const originMainSha = originMainRaw?.trim()
+    const headRaw = await gitOrNull(['rev-parse', 'HEAD'])
+    const headSha = headRaw?.trim()
+    if (originMainSha && headSha && (originMainSha === headSha || (await isGitAncestor('origin/main', 'HEAD')))) {
       return { ref: 'origin/main', label: 'main' }
     }
     const parent = await gitOrNull(['rev-parse', '--verify', '--quiet', 'HEAD~1'])

package/scripts/sync-claude-config.mjs

@@ -18,6 +18,10 @@
  *   Stop-hook (батч-нормалізація чернеток); умови — ті самі, що для `capture`.
  * - `.cursor/hooks.json` — **merge**: користувацькі hooks зберігаються; ADR stop
  *   entries додаються, коли правило `adr` увімкнене, і видаляються, коли вимкнене.
+ * - `.gitignore` — **merge** (лише з `adr`): дописує відсутні рядки з канонічного
+ *   фрагмента `rules/adr/fix/hooks/template/.gitignore.snippet` (`node_modules/`, `dist/`,
+ *   `*.secret`, логи capture/normalize, `.normalize-state`, `.normalize.lock`); існуючі
+ *   рядки не перезаписуються.
  *
  * Опт-аут — `claude-config: false` у `.n-cursor.json`.
  */
@@ -51,6 +55,10 @@ const CURSOR_HOOKS_FILE = `${CURSOR_DIR}/hooks.json`
 const ADR_HOOK_SCRIPT_NAME = 'capture-decisions.sh'
 const ADR_NORMALIZE_HOOK_SCRIPT_NAME = 'normalize-decisions.sh'
 const TEMPLATE_DIR_NAME = '.claude-template'
+/** Відносний шлях до канонічного фрагмента `.gitignore` для ADR Stop-hook'ів у tarball пакета. */
+export const ADR_GITIGNORE_SNIPPET_REL = 'rules/adr/fix/hooks/template/.gitignore.snippet'
+const GITIGNORE_FILE = '.gitignore'
+const EOL_RE = /\r?\n/u
 
 /** Канонічна група hooks для ADR capture Stop-hook'а — додається в settings, коли `adr` у `rules`. */
 const ADR_STOP_HOOK_GROUP = Object.freeze({
@@ -387,6 +395,60 @@ export function syncAdrNormalizeHookScript(projectRoot, templateDir) {
   return syncHookScript(projectRoot, templateDir, ADR_NORMALIZE_HOOK_SCRIPT_NAME)
 }
 
+/**
+ * Повертає змістовні (не коментар, не порожній) рядки з text-фрагмента `.gitignore`.
+ * @param {string} raw вміст snippet-файлу
+ * @returns {string[]} нормалізовані рядки патернів
+ */
+function parseGitignoreFragmentLines(raw) {
+  return raw
+    .split(EOL_RE)
+    .map(l => l.trim())
+    .filter(l => l !== '' && !l.startsWith('#'))
+}
+
+/**
+ * Дописує в кореневий `.gitignore` проєкту відсутні рядки з канонічного ADR-фрагмента.
+ * @param {string} projectRoot корінь проєкту-споживача
+ * @param {string} bundledPackageRoot корінь установленого `@nitra/cursor`
+ * @returns {Promise<{ written: boolean, path: string }>} чи змінено файл і відносний шлях
+ */
+export async function syncGitignoreAdrFragment(projectRoot, bundledPackageRoot) {
+  const snippetPath = join(bundledPackageRoot, ADR_GITIGNORE_SNIPPET_REL)
+  if (!existsSync(snippetPath)) {
+    return { written: false, path: '' }
+  }
+  const fragment = await readFile(snippetPath, 'utf8')
+  const required = parseGitignoreFragmentLines(fragment)
+  if (required.length === 0) {
+    return { written: false, path: '' }
+  }
+
+  const destPath = join(projectRoot, GITIGNORE_FILE)
+  const existing = existsSync(destPath) ? await readFile(destPath, 'utf8') : ''
+  const existingLines = new Set(
+    existing
+      .split(EOL_RE)
+      .map(l => l.trim())
+      .filter(l => l !== '' && !l.startsWith('#'))
+  )
+  const missing = required.filter(l => !existingLines.has(l))
+  if (missing.length === 0) {
+    return { written: false, path: GITIGNORE_FILE }
+  }
+
+  const sectionHeader = '# @nitra/cursor (adr) — локальні артефакти Stop-hook, не коміти'
+  const hasHeader = existing.split(EOL_RE).some(l => l.trim() === sectionHeader)
+  const block = hasHeader ? missing.join('\n') : [sectionHeader, ...missing].join('\n')
+  let prefix = ''
+  if (existing.length > 0) {
+    prefix = existing.endsWith('\n') ? existing : `${existing}\n`
+  }
+  const next = `${prefix}${block}\n`
+  await writeFile(destPath, next, 'utf8')
+  return { written: true, path: GITIGNORE_FILE }
+}
+
 /**
  * Копіює всі slash-команди з `templateDir/commands/` у `.claude/commands/`.
  * Команди ідентифікуються тим, що вони лежать у темплейті — не перетинаються
@@ -422,7 +484,7 @@ export async function syncClaudeCommands(projectRoot, templateDir) {
  * @param {string} options.bundledPackageRoot корінь установленого `@nitra/cursor`
  * @param {boolean} options.enabled чи увімкнено sync (з `.n-cursor.json` `claude-config`)
  * @param {string[]} [options.rules] список увімкнених правил із `.n-cursor.json` — впливає на ADR Stop-hook (`adr`)
- * @returns {Promise<{ settings: boolean, cursorHooks: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean }>} прапорці записів settings/Cursor hooks/ADR-hook(s) та список записаних slash-команд
+ * @returns {Promise<{ settings: boolean, cursorHooks: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean, gitignoreAdr: boolean }>} прапорці записів settings/Cursor hooks/ADR-hook(s)/`.gitignore` та список slash-команд
  */
 export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enabled, rules = [] }) {
   if (!enabled) {
@@ -431,7 +493,8 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
       cursorHooks: false,
       commands: [],
       adrHook: false,
-      adrNormalizeHook: false
+      adrNormalizeHook: false,
+      gitignoreAdr: false
     }
   }
   const templateDir = join(bundledPackageRoot, TEMPLATE_DIR_NAME)
@@ -441,7 +504,8 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
       cursorHooks: false,
       commands: [],
       adrHook: false,
-      adrNormalizeHook: false
+      adrNormalizeHook: false,
+      gitignoreAdr: false
     }
   }
   const includeAdrHook = Array.isArray(rules) && rules.includes('adr')
@@ -449,6 +513,9 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
   const adrNormalizeHook = includeAdrHook
     ? await syncAdrNormalizeHookScript(projectRoot, templateDir)
     : { written: false, path: '' }
+  const gitignoreAdr = includeAdrHook
+    ? await syncGitignoreAdrFragment(projectRoot, bundledPackageRoot)
+    : { written: false, path: '' }
   const settings = await syncClaudeSettings(projectRoot, templateDir, { includeAdrHook })
   const cursorHooks = await syncCursorHooksConfig(projectRoot, { includeAdrHook })
   const commands = await syncClaudeCommands(projectRoot, templateDir)
@@ -457,6 +524,7 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
     cursorHooks: cursorHooks.written,
     commands,
     adrHook: adrHook.written,
-    adrNormalizeHook: adrNormalizeHook.written
+    adrNormalizeHook: adrNormalizeHook.written,
+    gitignoreAdr: gitignoreAdr.written
   }
 }

package/skills/lint/SKILL.md

@@ -44,13 +44,13 @@ bun run lint
 
 **Конфіги і коментарі, які потребують зупинки** (неповний список — будь-який аналог):
 
-| Інструмент | Типові файли / зміни |
-| --- | --- |
-| **jscpd** | `.jscpd.json` → `ignore`, `minLines` |
-| **cspell** | `.cspell.json` → `words`, `ignorePaths`; `.cspellignore` |
-| **knip** | `knip.json` → `ignore`, `ignoreDependencies`, `ignoreBinaries`, `entry` |
+| Інструмент          | Типові файли / зміни                                                                                            |
+| ------------------- | --------------------------------------------------------------------------------------------------------------- |
+| **jscpd**           | `.jscpd.json` → `ignore`, `minLines`                                                                            |
+| **cspell**          | `.cspell.json` → `words`, `ignorePaths`; `.cspellignore`                                                        |
+| **knip**            | `knip.json` → `ignore`, `ignoreDependencies`, `ignoreBinaries`, `entry`                                         |
 | **oxlint / ESLint** | `.oxlintrc.json` → `ignorePatterns`; `eslint.config.js` → `ignores`; `eslint-disable` / `oxlint-disable` у коді |
-| **інше** | `.v8rignore`, `.stylelintignore`, `.trufflehog-exclude`, розширення `ignores` у workflow-конфігах |
+| **інше**            | `.v8rignore`, `.stylelintignore`, `.trufflehog-exclude`, розширення `ignores` у workflow-конфігах               |
 
 Політика узгоджена з **`.cursor/rules/`** (зокрема **n-js-lint**, **n-text**): виняток допустимий лише з **обґрунтованою** причиною, не як заміна рефакторингу для справжніх клонів / дублікатів.
 
@@ -64,12 +64,12 @@ bun run lint
 
 **Варіанти відповіді** (мінімум такі; `allow_multiple: false`):
 
-| id | label (українською) | Дія агента |
-| --- | --- | --- |
-| `refactor` | **Рефакторинг коду** — усунути дублікат / помилку в коді (рекомендовано за замовчуванням) | Рефакторинг; конфіг **не** чіпати |
-| `ignore-once` | **Точковий виняток у конфігу** — додати ignore/words/minLines з обґрунтуванням у коментарі PR/відповіді | Після вибору — мінімальна зміна конфігу + 1 речення **чому** це не рефакторинг |
-| `skip` | **Залишити як є** — не чіпати ні код, ні конфіг зараз | Не змінювати; у фінальному резюме — що лишилось червоним |
-| `explain` | **Потрібні деталі** — поясни варіанти глибше | Розгорнути порівняння refactor vs ignore; **знову** запитати той самий набір варіантів |
+| id            | label (українською)                                                                                     | Дія агента                                                                             |
+| ------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `refactor`    | **Рефакторинг коду** — усунути дублікат / помилку в коді (рекомендовано за замовчуванням)               | Рефакторинг; конфіг **не** чіпати                                                      |
+| `ignore-once` | **Точковий виняток у конфігу** — додати ignore/words/minLines з обґрунтуванням у коментарі PR/відповіді | Після вибору — мінімальна зміна конфігу + 1 речення **чому** це не рефакторинг         |
+| `skip`        | **Залишити як є** — не чіпати ні код, ні конфіг зараз                                                   | Не змінювати; у фінальному резюме — що лишилось червоним                               |
+| `explain`     | **Потрібні деталі** — поясни варіанти глибше                                                            | Розгорнути порівняння refactor vs ignore; **знову** запитати той самий набір варіантів |
 
 Якщо користувач обрав **`ignore-once`** — у відповіді після зміни зафіксуй: який ключ конфігу змінено, який glob/слово додано, чому рефакторинг був недоречний (генерований код, формальний шаблон, легітимний термін без перекладу тощо).