@nitra/cursor 1.27.1 → 1.27.3

package/CHANGELOG.md

@@ -4,11 +4,33 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.27.3] - 2026-05-26
+
+### Fixed
+
+- **`js-lint` coverage provider `detect()`**: у workspace-проєктах (типовий bun monorepo з hoisted node_modules і `npm-module` правилом, що забороняє devDeps у published workspace-у) перевіряємо `vitest` як у JS-root `package.json`, так і у кореневому. Раніше `detect()` повертав false у monorepo, де vitest коректно живе у кореневому `devDependencies` — `n-cursor coverage` мовчки виходив із «0 провайдерів».
+
+### Changed
+
+- **Dogfooding-міграція cursor → vitest**: 100 `*.test.mjs` файлів у `npm/` перенесено з `bun:test` на `vitest`; `npm/stryker.config.mjs` оновлено до canonical baseline (vitest-runner + perTest + incremental); додано `npm/vitest.config.js`; кореневий `package.json#devDependencies` отримав `vitest`, `@vitest/coverage-v8`, `@stryker-mutator/vitest-runner`. Node-сумісність: `Bun.file().text()` → `readFile(..., 'utf8')`, `Bun.spawn` → `spawnSync`, `import.meta.dir` → `dirname(fileURLToPath(import.meta.url))`, EventEmitter duck-typing → `new EventEmitter()` (node-у `events.once` приймає лише EventEmitter інстанси).
+- **`npm/rules/vue/vue.mdc` v2.4**: секцію «Тестування» приведено у відповідність із новим canon-ом (`test.mdc` v2.4 → Vitest+happy-dom). Замість прямого заперечення Vitest у Vue-проєктах рекомендується frontend-варіант `vitest.config.js` з `environment: 'happy-dom'`.
+
+## [1.27.2] - 2026-05-26
+
+### Changed
+
+- **`package.json#dependencies`**: `@anthropic-ai/claude-code` (^1.0.0) → `@anthropic-ai/claude-agent-sdk` (^0.3.0). У claude-code v2.x пакет реструктуризовано в CLI-only (бінарі через optionalDependencies, без `sdk.mjs`); SDK з функцією `query` винесли в окремий пакет `@anthropic-ai/claude-agent-sdk`. Сигнатура `query({ prompt, options })` і поля `options.cwd/maxTurns/allowedTools` зберігаються.
+- **`scripts/coverage-fix.mjs`**: дзеркальна заміна імпорту `@anthropic-ai/claude-code` → `@anthropic-ai/claude-agent-sdk`. Тіло споживача без змін.
+
+### Fixed
+
+- **ADR Stop-hook у Node v26 / Zed**: `capture-decisions.sh` спавнить bare `claude -p` як subprocess. PATH у Zed Claude Agent-сесіях має `node_modules/.bin` попереду `/opt/homebrew/bin`, тож резолвив локальний `@anthropic-ai/claude-code@1.0.128`, який краш-падає на старті під Node 26 (`TypeError: Cannot read properties of undefined (reading 'prototype')` у bundled google-auth-library коді, який припускає, що `require('stream')` повертає клас зі `.prototype`). Хук фіксував `empty response from LLM CLI` і виходив без створення чернетки. Після зняття v1-залежності з канона `node_modules/.bin/claude` shadow зникає, subprocess резолвить системний `claude` (homebrew або інший global) — той працює під Node 26 без правок.
+
 ## [1.27.1] - 2026-05-26
 
 ### Changed
 
-- Додано workspace-level `vitest.config.js` baseline і follow-up правки для Vitest/Stryker coverage-концернів після переходу тестового правила на Vitest runner.
+- Стилістичні правки бенчмарк-артефактів `benchmarks/runner-comparison/` (форматування таблиць, code blocks) після ручного `bun run lint` у dev-репо. Без змін у поведінці rules чи правила `test`.
 
 ## [1.27.0] - 2026-05-26
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.27.1",
+  "version": "1.27.3",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -44,13 +44,14 @@
   "type": "module",
   "types": "./types/bin/n-cursor.d.ts",
   "scripts": {
-    "test": "bun test --parallel",
-    "test:coverage": "bun test --parallel --coverage --timeout 15000 scripts/tests/ rules/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "start": "bun ./bin/n-cursor.js",
     "rename-yaml-extensions": "bun ./bin/n-cursor.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@anthropic-ai/claude-code": "^1.0.0",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.0",
     "@anthropic-ai/sdk": "^0.54.0",
     "oxc-parser": "^0.128.0",
     "picomatch": "^4.0.4",

package/rules/js-lint/coverage/coverage.mjs

@@ -22,15 +22,18 @@ const VITEST_HINT =
 /**
  * Чи у пакеті встановлено vitest (через dependencies або devDependencies).
  * @param {{dependencies?: Record<string,string>, devDependencies?: Record<string,string>}} pkg package.json
- * @returns {boolean}
+ * @returns {boolean} true, якщо `vitest` декларовано хоча б в одному dep-section
  */
 function hasVitestDep(pkg) {
   return Boolean(pkg.devDependencies?.vitest) || Boolean(pkg.dependencies?.vitest)
 }
 
 /**
- * Чи провайдер застосовний у поточному cwd. Активується, коли у JS-root знайдено
- * `vitest` як залежність — інакше silent skip із hint у stderr (одноразово).
+ * Чи провайдер застосовний у поточному cwd. Активується, коли `vitest`
+ * декларовано у JS-root АБО у кореневому `package.json` (workspace-проєкт із
+ * hoisted node_modules — типовий патерн bun monorepo, де npm-module rule
+ * забороняє devDeps у published workspace-у, тож вони живуть у корені).
+ * Інакше silent skip із hint у stderr (одноразово).
  * @param {string} cwd корінь проєкту
  * @returns {Promise<boolean>} true, якщо проєкт сумісний з vitest-based coverage
  */
@@ -40,14 +43,19 @@ export async function detect(cwd) {
   const pkgPath = join(jsRoot, 'package.json')
   if (!existsSync(pkgPath)) return false
   const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  if (!hasVitestDep(pkg)) {
-    if (!detect._hinted) {
-      console.error(VITEST_HINT)
-      detect._hinted = true
+  if (hasVitestDep(pkg)) return true
+  if (jsRoot !== cwd) {
+    const rootPkgPath = join(cwd, 'package.json')
+    if (existsSync(rootPkgPath)) {
+      const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+      if (hasVitestDep(rootPkg)) return true
     }
-    return false
   }
-  return true
+  if (!detect._hinted) {
+    console.error(VITEST_HINT)
+    detect._hinted = true
+  }
+  return false
 }
 
 /**

package/rules/vue/vue.mdc

@@ -1,6 +1,6 @@
 ---
 description: Vue
-version: '1.9'
+version: '2.0'
 globs: "**/*.vue"
 alwaysApply: false
 ---
@@ -104,21 +104,25 @@ const additionalInstructions = `
 
 ### Тестування
 
-- **Unit:** **Bun Test Runner** (`bun test`) — використовуй його замість **Vitest**. API сумісне (`describe` / `it` / `expect` з `bun:test`), моки через `mock` і `mock.module`. У `package.json` тримай `"test": "bun test <шляхи>"`; не додавай `vitest`, `vitest.config.*` і пов’язані залежності.
-- **Component / DOM:** **Vue Test Utils** + **Bun Test Runner** з **happy-dom** як DOM-середовищем. Підключення — через `@happy-dom/global-registrator` у preload-файлі та `bunfig.toml`:
+- **Unit + Component / DOM:** **Vitest** (`vitest`) + **Vue Test Utils** з **happy-dom** як DOM-середовищем. Це канон, узгоджений з `test.mdc` (Stryker з vitest-runner + `perTest`-аналіз покриття). `vitest.config.js` реюзає `vite.config.js` через `mergeConfig` і перемикає `environment` на `'happy-dom'`:
 
-```toml title="bunfig.toml"
-[test]
-preload = ["./test/happy-dom.preload.js"]
-```
+```js title="vitest.config.js"
+import { defineConfig, mergeConfig } from 'vitest/config'
+import viteConfig from './vite.config.js'
 
-```js title="test/happy-dom.preload.js"
-import { GlobalRegistrator } from '@happy-dom/global-registrator'
-GlobalRegistrator.register()
+export default mergeConfig(viteConfig, defineConfig({
+  test: {
+    include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}'],
+    environment: 'happy-dom',
+    coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] }
+  }
+}))
 ```
 
 `jsdom` не використовуй — happy-dom швидший і достатній для типових Vue-компонентних тестів.
 
+У `package.json#scripts` тримай `"test": "vitest run"`; vitest devDeps (`vitest`, `@vitest/coverage-v8`, `@stryker-mutator/vitest-runner`) — у кореневому `devDependencies` (npm-module rule забороняє devDeps у published workspace-у).
+
 - **E2E:** **Playwright** змістовні сценарії користувацьких потоків.
 
 ### Інструменти (узгоджено з Vite і цим правилом)

package/scripts/coverage-fix.mjs

@@ -4,7 +4,7 @@
  * (file, line, оригінальний код, вижилий варіант, тип мутації) і самостійно
  * знаходить або створює відповідні test-файли.
  *
- * Залежить від `@anthropic-ai/claude-code` (dependencies у npm/package.json).
+ * Залежить від `@anthropic-ai/claude-agent-sdk` (dependencies у npm/package.json).
  */
 import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
@@ -30,9 +30,9 @@ export async function fixSurvivedMutants(survived, projectRoot) {
   const prompt = await buildFixPrompt(survived, projectRoot)
   console.log(`\n🤖 coverage --fix: запускаю агента для ${totalMutants} вижилих мутантів...\n`)
 
-  // Dynamic import: @anthropic-ai/claude-code завантажується лише при --fix,
+  // Dynamic import: @anthropic-ai/claude-agent-sdk завантажується лише при --fix,
   // щоб не гальмувати звичайний coverage-прогін за відсутності пакету.
-  const { query } = await import('@anthropic-ai/claude-code')
+  const { query } = await import('@anthropic-ai/claude-agent-sdk')
 
   for await (const msg of query({
     prompt,