@nitra/cursor 12.16.1 → 12.16.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.16.2] - 2026-06-27
+
+### Changed
+
+- feat(orchestrator): skip non-actionable violation (не годувати агента tool-crash); feat(pi-agent-fix): логувати вхід LLM у trace (violation + розмір промпта)
+
 ## [12.16.1] - 2026-06-26
 
 ### Changed

package/lib/pi-agent-fix.mjs

@@ -213,12 +213,11 @@ export async function runPiAgentFix(ruleId, violation, cwd, opts = {}) {
     }
   })
 
+  const fixPrompt = buildFixPrompt({ ruleId, violation, ruleText, feedback })
   const startedAt = clock()
   let error = null
   try {
-    await withTimeout(session.prompt(buildFixPrompt({ ruleId, violation, ruleText, feedback })), timeoutMs, () =>
-      session.abort?.()
-    )
+    await withTimeout(session.prompt(fixPrompt), timeoutMs, () => session.abort?.())
   } catch (e) {
     error = e.message
   }
@@ -244,9 +243,17 @@ export async function runPiAgentFix(ruleId, violation, cwd, opts = {}) {
     rung: tier,
     model: modelSpec,
     cwd,
+    // ВХІД LLM (щоб «що подали» було видно у trace, без розкопок escalation-log):
+    // violation — обрізаний (може бути великим); promptChars — повний розмір промпта.
+    violation: typeof violation === 'string' ? violation.slice(0, 4000) : null,
+    violationChars: typeof violation === 'string' ? violation.length : 0,
+    promptChars: fixPrompt.length,
+    // вихід:
     turnCount,
     toolCallCount,
+    touchedFiles,
     backstopHit,
+    wallMs: clock() - startedAt,
     error
   })
   return { applied: touchedFiles.length > 0, touchedFiles, telemetry, error, rollback: guard.rollback }

package/package.json

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

package/scripts/lib/fix/orchestrator.mjs

@@ -51,6 +51,19 @@ export function classifyFixError(error) {
   return 'quality'
 }
 
+/**
+ * Чи violation придатний для LLM-фіксу: містить хоч одне actionable `❌`-порушення
+ * (формат конформ-чека `❌ <file>: <інструкція>`). Без жодного ❌ — це не список
+ * фіксабельних порушень, а шум/збій тула (Usage, «лок взято», порожньо). Годувати
+ * таким агента = марні turns/timeout (вимір 7n-test: doc-files surface-ив Usage
+ * downstream-тула → агент флоундерив 4 рунги). Тоді LLM-фікс пропускаємо.
+ * @param {string|null|undefined} output violation-вивід правила
+ * @returns {boolean} true — є що фіксити
+ */
+export function hasActionableViolation(output) {
+  return /❌/u.test(output ?? '')
+}
+
 /**
  * Будує драбину ескалації за наявними тирами (спека 2026-06-19-fix-escalation-cascade):
  *  1. `local-min`       — `N_LOCAL_MIN_MODEL`, перший прохід;
@@ -124,6 +137,27 @@ export async function escalateRule(rule, cwd, deps) {
   const skipModels = new Set()
   let avgUsed = 0
 
+  // §2-профілактика: violation без actionable ❌ (tool-crash/Usage/шум) → не годуємо
+  // агента (інакше флоундерить рунги до timeout). Рапортуємо як non-actionable, не фіксимо.
+  if (!hasActionableViolation(rule.output)) {
+    record({
+      rung: -1,
+      tier: 'skip',
+      model: '',
+      withFeedback: false,
+      callOk: false,
+      callError: 'non-actionable violation (нема ❌ — ймовірно check-error/tool-crash)',
+      recheckOk: false,
+      remainingViolation: rule.output,
+      diagnosis: null,
+      ms: 0
+    })
+    log(
+      `  ⏭️  ${rule.ruleId}: LLM-фікс пропущено — у violation немає ❌-порушень (check-error/tool-crash, не фіксабельне)`
+    )
+    return { resolved: false, avgUsed: 0 }
+  }
+
   for (const [idx, rung] of ladder.entries()) {
     if (skipModels.has(rung.model)) continue