@nitra/cursor 3.24.0 → 3.25.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [3.25.1] - 2026-06-06
+
+### Fixed
+
+- coverage --fix: додано permissionMode:'bypassPermissions' у claude-agent-sdk query — без нього headless-агент не отримував дозволу на Edit/Bash і не редагував файли (крутився, палив токени, нічого не писав). Тепер автономний coverage --fix реально дописує тести й ганяє bun test
+
+## [3.25.0] - 2026-06-06
+
+### Added
+
+- fix: прапорець `n-cursor fix --json` друкує компактний {total, failed, rules:[{ruleId, ok, output}]} у stdout (per-rule захоплення замість stdio inherit; у json-режимі пропускається ensureHkInstall, щоб stdout лишався чистим JSON). Скіл n-fix більше не парсить термінальний вивід — працює лише з rules[].ok:false. Дефолтна поведінка без прапорця незмінна
+
 ## [3.24.0] - 2026-06-05
 
 ### Added

package/bin/n-cursor.js

@@ -1230,11 +1230,17 @@ function logRemovedManagedItems(title, basePath, names) {
  * На рівні `runFixCommand` локу нема: різні набори правил можуть прогресувати незалежно,
  * а однакові правила серіалізуються в spawn'ах нижче.
  * @param {string[]} requestedRules імена правил; порожній масив — discovery з `.cursor/rules/`
+ * @param {{json?: boolean}} [opts] json — друкувати компактний JSON `{total, failed, rules:[{ruleId, ok, output}]}`
+ *   замість per-rule stdio + timing (для скілу n-fix: агент читає лише впалі правила, не парсить текст)
  * @returns {Promise<void>}
  */
-async function runFixCommand(requestedRules) {
+async function runFixCommand(requestedRules, opts = {}) {
+  const json = opts.json === true
+  // json-режим — діагностичний read-only вивід для скілу: пропускаємо встановлення
+  // git-hook (`ensureHkInstall` друкує «Installed hk hook…» у stdout і забруднив би
+  // чистий JSON; сам pre-commit hook для діагностики не потрібен).
   const hkBin = ensureTool('hk')
-  ensureHkInstall(hkBin)
+  if (!json) ensureHkInstall(hkBin)
   ensureTool('conftest')
 
   const available = await listRuleIds(BUNDLED_RULES_DIR)
@@ -1261,6 +1267,10 @@ async function runFixCommand(requestedRules) {
     }
     idsToRun = discoverCheckRulesFromCursorRules(available, mdcFiles)
     if (idsToRun.length === 0) {
+      if (json) {
+        process.stdout.write(`${JSON.stringify({ total: 0, failed: 0, rules: [] })}\n`)
+        return
+      }
       console.log(
         `\n🔍 ${PACKAGE_NAME} fix — у ${RULES_DIR}/ немає правил з programmatic перевіркою ` +
           `(відповідного fix.mjs у пакеті). Нічого не запущено.\n`
@@ -1272,16 +1282,29 @@ async function runFixCommand(requestedRules) {
   let totalFailed = 0
   /** @type {{ id: string, ms: number, ok: boolean }[]} */
   const timings = []
+  /** @type {{ ruleId: string, ok: boolean, output: string }[]} */
+  const ruleResults = []
   for (const id of idsToRun) {
     const fixPath = join(BUNDLED_RULES_DIR, id, 'fix.mjs')
     const startedAt = Date.now()
-    const result = spawnSync('bun', [fixPath], { stdio: 'inherit' })
+    // json-режим: захоплюємо stdout/stderr правила у структуру (а не inherit у термінал),
+    // щоб віддати агенту згруповано {ruleId, ok, output} і він читав лише впалі.
+    const result = json
+      ? spawnSync('bun', [fixPath], { encoding: 'utf8' })
+      : spawnSync('bun', [fixPath], { stdio: 'inherit' })
     const ok = result.status === 0
     timings.push({ id: `fix-${id}`, ms: Date.now() - startedAt, ok })
+    if (json) {
+      ruleResults.push({ ruleId: id, ok, output: `${result.stdout ?? ''}${result.stderr ?? ''}`.trim() })
+    }
     if (!ok) totalFailed++
   }
 
-  process.stdout.write(formatTimingSummary('Fix timing', timings))
+  if (json) {
+    process.stdout.write(`${JSON.stringify({ total: idsToRun.length, failed: totalFailed, rules: ruleResults })}\n`)
+  } else {
+    process.stdout.write(formatTimingSummary('Fix timing', timings))
+  }
 
   if (totalFailed > 0) {
     throw new Error(`${totalFailed} з ${idsToRun.length} правил мають проблеми`)
@@ -1573,7 +1596,11 @@ try {
   await ensureNitraCursorInRootDevDependencies(cwd())
   switch (command) {
     case 'fix': {
-      await runFixCommand(args)
+      // --json: компактний {total, failed, rules:[{ruleId, ok, output}]} у stdout для скілу n-fix.
+      await runFixCommand(
+        args.filter(a => a !== '--json'),
+        { json: args.includes('--json') }
+      )
 
       break
     }
@@ -1582,7 +1609,10 @@ try {
       console.warn(
         `⚠️  Команда \`check\` deprecated — використовуйте \`fix\` (\`npx ${PACKAGE_NAME} fix [<rule>...]\`)`
       )
-      await runFixCommand(args)
+      await runFixCommand(
+        args.filter(a => a !== '--json'),
+        { json: args.includes('--json') }
+      )
 
       break
     }

package/package.json

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

package/scripts/coverage-fix.mjs

@@ -39,7 +39,12 @@ export async function fixSurvivedMutants(survived, projectRoot) {
     options: {
       cwd: projectRoot,
       maxTurns: 20,
-      allowedTools: ['Read', 'Edit', 'Bash']
+      allowedTools: ['Read', 'Edit', 'Bash'],
+      // Без permissionMode headless-агент SDK не отримує дозволу на запис/Bash —
+      // він крутиться, палить токени, але НЕ редагує файли (підтверджено пробом).
+      // `bypassPermissions` потрібен, бо агент і пише тести (Edit), і ганяє `bun test` (Bash);
+      // `acceptEdits` авто-підтверджує лише edits, а Bash лишився б заблокованим.
+      permissionMode: 'bypassPermissions'
     }
   })) {
     if (msg.type === 'text') process.stdout.write(msg.text)

package/skills/fix/SKILL.md

@@ -12,13 +12,13 @@ description: >-
 
 ## Workflow
 
-1. **Діагностика** — запусти перевірку через retry-обгортку `n_cursor_npx` (визначена у worktree-preflight, крок 0.1: переживає транзитну CDN-гонку щойно опублікованої версії, а реальний `❌` від `fix` віддає одразу). За замовчуванням — лише правила з `.cursor/rules/*.mdc`, для яких у пакеті є programmatic check; повний набір — явні аргументи: `n_cursor_npx fix bun ga …`:
+1. **Діагностика** — запусти перевірку через retry-обгортку `n_cursor_npx` (визначена у worktree-preflight, крок 0.1: переживає транзитну CDN-гонку щойно опублікованої версії, а реальний `❌` від `fix` віддає одразу). Прапорець `--json` дає **структурований** результат у stdout, щоб не парсити термінальний текст. За замовчуванням — лише правила з `.cursor/rules/*.mdc`, для яких у пакеті є programmatic check; повний набір — явні аргументи: `n_cursor_npx fix bun ga --json`:
 
 ```bash
-n_cursor_npx fix
+n_cursor_npx fix --json
 ```
 
-2. **Аналіз** — зчитай вивід, знайди всі `❌` та визнач які правила порушено
+2. **Аналіз** — розбери JSON `{ total, failed, rules: [{ ruleId, ok, output }] }`. Працюй **лише** з елементами `ok:false`; їх `output` містить готові `❌`-повідомлення правила (не парси stdout вручну, не визначай правила з тексту). Якщо `failed === 0` — нічого виправляти.
 
 3. **Виправлення** — для кожного `❌` відкрий відповідне правило з `.cursor/rules/` і виправ:
    - Створи відсутні конфігураційні файли (`.cspell.json`, `.oxfmtrc.json`, `eslint.config.js`, тощо)
@@ -40,10 +40,10 @@ bun i
 oxfmt .
 ```
 
-6. **Верифікація** — перевір що все виправлено (та сама retry-обгортка `n_cursor_npx`):
+6. **Верифікація** — перевір що все виправлено (та сама retry-обгортка `n_cursor_npx`); чекаєш `failed === 0`:
 
 ```bash
-n_cursor_npx fix
+n_cursor_npx fix --json
 ```
 
-7. **Результат** — всі `❌` від `npx @nitra/cursor fix` мають стати `✅`. Якщо залишились `❌` — повтори кроки 3-6. Лінт-помилки від `bun run lint` тут **не виправляй** — вони на скіл `/n-lint`.
+7. **Результат** — `failed` має стати `0` (усі правила `ok:true`). Якщо лишились `ok:false` — повтори кроки 3-6. Лінт-помилки від `bun run lint` тут **не виправляй** — вони на скіл `/n-lint`.