@nitra/cursor 12.17.0 → 12.18.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [12.18.0] - 2026-06-28
+
+### Changed
+
+- Видалено escalation-лог та його тести, оптимізовано pi-agent-fix та orchestrator
+
+### Fixed
+
+- CLI lint: не відкидати перший позиційний rule-аргумент, коли `--cwd` не передано
+
 ## [12.17.0] - 2026-06-27
 
 ### Changed

package/bin/n-cursor.js

@@ -1518,7 +1518,7 @@ try {
       // прогнати лише конформність цих правил, без лінтер-скану (мапить колишній `fix <rule>`).
       const cwdIdx = args.indexOf('--cwd')
       const cwdArg = cwdIdx !== -1 ? resolve(args[cwdIdx + 1]) : undefined
-      const rules = args.filter((a, i) => !a.startsWith('-') && i !== cwdIdx + 1)
+      const rules = args.filter((a, i) => !a.startsWith('-') && !(cwdIdx !== -1 && i === cwdIdx + 1))
       process.exitCode = await runLint({
         full: args.includes('--full'),
         readOnly: args.includes('--read-only'),

package/lib/docs/pi-agent-fix.md

@@ -3,7 +3,7 @@ type: JS Module
 title: pi-agent-fix.mjs
 resource: npm/lib/pi-agent-fix.mjs
 docgen:
-  crc: 4cf083e2
+  crc: 3e849981
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---

package/lib/pi-agent-fix.mjs

@@ -243,7 +243,7 @@ export async function runPiAgentFix(ruleId, violation, cwd, opts = {}) {
     rung: tier,
     model: modelSpec,
     cwd,
-    // ВХІД LLM (щоб «що подали» було видно у trace, без розкопок escalation-log):
+    // ВХІД LLM (щоб «що подали» було видно прямо у trace):
     // violation — обрізаний (може бути великим); promptChars — повний розмір промпта.
     violation: typeof violation === 'string' ? violation.slice(0, 4000) : null,
     violationChars: typeof violation === 'string' ? violation.length : 0,

package/package.json

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

package/rules/js/js/data/tooling/oxlint-canonical.json

@@ -12,7 +12,7 @@
     "e18e/prefer-nullish-coalescing": "deny",
     "e18e/prefer-spread-syntax": "deny",
     "e18e/prefer-url-canparse": "deny",
-    "e18e/ban-dependencies": "deny",
+    "e18e/ban-dependencies": ["deny", { "allowed": ["globby"] }],
     "e18e/prefer-array-from-map": "deny",
     "e18e/prefer-timer-args": "deny",
     "e18e/prefer-static-regex": "deny",

package/scripts/lib/fix/docs/index.md

@@ -9,7 +9,6 @@ resource: npm/scripts/lib/fix/
 | Файл                                                  | Тип       |
 | ----------------------------------------------------- | --------- |
 | [discover-t0-patterns.mjs](discover-t0-patterns.md)   | JS Module |
-| [escalation-log.mjs](escalation-log.md)               | JS Module |
 | [llm-fix-apply.mjs](llm-fix-apply.md)                 | JS Module |
 | [llm-lint-fix.mjs](llm-lint-fix.md)                   | JS Module |
 | [llm-worker.mjs](llm-worker.md)                       | JS Module |

package/scripts/lib/fix/docs/orchestrator.md

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrator.mjs
 resource: npm/scripts/lib/fix/orchestrator.mjs
 docgen:
-  crc: 49146418
+  crc: c16c34f7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---

package/scripts/lib/fix/orchestrator.mjs

@@ -3,7 +3,6 @@
 import { env } from 'node:process'
 import { runConformanceCheck } from './run-conformance-check.mjs'
 import { runT0AutoCli } from './t0.mjs'
-import { logEscalation } from './escalation-log.mjs'
 import { runPiAgentFix } from '../../../lib/pi-agent-fix.mjs'
 import { recordFixTelemetry } from '../../../lib/pi-telemetry-store.mjs'
 import { CLOUD_AVG, CLOUD_MIN, LOCAL_MIN } from '../../../lib/pi-model-tiers.mjs'
@@ -112,7 +111,7 @@ function decideAfterFailure(rung, error) {
 /**
  * Проводить ОДНЕ правило по драбині ескалації до першого зеленого re-check.
  * Кожен рунг: виклик worker (з feedback від попереднього) → re-check цього правила →
- * запис у escalation-лог («чи допомогло» + diagnosis). Достроковий вихід — `decideAfterFailure`
+ * persist у глобальний telemetry-стор (`recordFixTelemetry`). Достроковий вихід — `decideAfterFailure`
  * (обрив на no-key, пропуск моделі на systemic) і вичерпаний avg-кеп (залогувати, не мовчки).
  * @param {{ ruleId: string, output: string }} rule провальне правило з violation-output
  * @param {string} cwd корінь проєкту
@@ -121,16 +120,13 @@ function decideAfterFailure(rung, error) {
  *   worker: { runFix: (ruleId: string, violation: string, cwd: string, opts: object) => Promise<object> },
  *   check: (rules: string[], cwd: string) => Promise<{rules: Array<{ruleId:string,ok:boolean,output:string}>}>,
  *   avgBudget: number,
- *   clock?: () => number,
  *   log?: (s: string) => void
- * }} deps інжектовані залежності (worker/check/clock — для тестів)
+ * }} deps інжектовані залежності (worker/check — для тестів)
  * @returns {Promise<{ resolved: boolean, avgUsed: number }>} чи закрито правило і скільки avg-викликів витрачено
  */
 export async function escalateRule(rule, cwd, deps) {
   const { ladder, worker, check, avgBudget } = deps
-  const clock = deps.clock ?? (() => Date.now())
   const log = deps.log ?? (s => console.log(s))
-  const record = base => logEscalation({ ts: new Date(clock()).toISOString(), ruleId: rule.ruleId, ...base })
 
   let feedback = null
   let currentViolation = rule.output
@@ -140,43 +136,20 @@ export async function escalateRule(rule, cwd, deps) {
   // §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()) {
+  for (const rung of ladder) {
     if (skipModels.has(rung.model)) continue
 
-    const common = { rung: idx, tier: rung.tier, model: rung.model, withFeedback: rung.feedback }
     if (rung.isAvg && avgBudget - avgUsed <= 0) {
-      record({
-        ...common,
-        callOk: false,
-        callError: 'cloud-avg cap reached',
-        recheckOk: false,
-        remainingViolation: currentViolation,
-        diagnosis: null,
-        ms: 0
-      })
       log(`  ⏭️  ${rule.ruleId}: ${rung.tier} пропущено (avg-кеп вичерпано)`)
       continue
     }
 
-    const startedAt = clock()
     // self_check (advisory §4+5) — той самий verdict-helper, що й зовнішній re-check.
     const selfCheck = async () => {
       const r = await check([rule.ruleId], cwd)
@@ -207,16 +180,6 @@ export async function escalateRule(rule, cwd, deps) {
       })
     }
 
-    record({
-      ...common,
-      callOk: !res.error,
-      callError: res.error ?? null,
-      recheckOk,
-      remainingViolation: remaining,
-      diagnosis: res.telemetry ? `turns=${res.telemetry.turnCount} tools=${res.telemetry.toolCallCount}` : null,
-      ms: clock() - startedAt
-    })
-
     if (recheckOk) {
       log(`  ✅ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}`)
       return { resolved: true, avgUsed }

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {}
+export {};

package/scripts/lib/fix/docs/escalation-log.md

@@ -1,28 +0,0 @@
----
-type: JS Module
-title: escalation-log.mjs
-resource: npm/scripts/lib/fix/escalation-log.mjs
-docgen:
-  crc: 91898427
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-## Огляд
-
-Файл створює append-only JSONL-лог ескалації конформність-фіксу (спека 2026-06-19-fix-escalation-cascade-design). Він фіксує кожен запис на рунг драбини, що включає деталі використаної моделі (`model`), подання зворотного зв'язку (`withFeedback`), результат виклику (`callOk`/`callError`), оцінку, чи допомогло це усунути порушення (`recheckOk`), залишковий `violation` та самоаналіз моделі (`diagnosis`). Цей лог доповнює always-on wire-trace (`lib/pi-trace.mjs`) і формує логіку для join за полем `caller` (`fix:<rule>:<rung>`). Запис відбувається за певним шільною: або через kill-switch `N_CURSOR_FIX_ESCALATION_LOG`, або за явним шляхом, дефолтно у `<cwd>/.n-cursor/fix-escalation.jsonl`.
-
-## Поведінка
-
-Поведінка:
-escalationLogPath визначає шлях до файлу журналу ескалації конформності. Якщо встановлено змінну середовища N_CURSOR_FIX_ESCALATION_LOG, використовується цей шлях; інакше, за замовчуванням, це .n-cursor/fix-escalation.jsonl у поточній робочій директорії.
-logEscalation записує один запис про рунг у JSONL-лог, якщо шлях до логу визначено. Запис містить метадані про спробу фіксування, результати виклику та аналіз. Помилки під час запису логу ігноруються.
-
-## Публічний API
-
-escalationLogPath — вказує на місце зберігання логу ескалацій, якщо функція не вимкнена.
-logEscalation — записує один подію виконання в спеціальний лог у форматі JSONL, ігноруючи внутрішні помилки запису.
-
-## Гарантії поведінки
-
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/scripts/lib/fix/escalation-log.mjs

@@ -1,92 +0,0 @@
-/**
- * Append-only JSONL-лог ескалації конформність-фіксу (спека
- * 2026-06-19-fix-escalation-cascade-design). Один запис **на рунг драбини** —
- * фіксує `model`, `withFeedback`, чи виклик удався (`callOk`/`callError`), чи
- * правило стало зеленим після цього рунга (`recheckOk` = «чи допомогло»),
- * залишковий violation і `diagnosis` (само-аналіз моделі «чому не вдалося»).
- *
- * Це доповнення до always-on wire-trace (`lib/pi-trace.mjs`): trace знає
- * `messages`/`reasoning`/`usage` кожного виклику, але **не** знає результату
- * re-check — а саме «чи допомогло» й потрібне для пост-аналізу драбини. Join із
- * trace — за полем `caller` (`fix:<rule>:<rung>`), яке цей модуль і формує.
- *
- * Шлях — дзеркало `tracePath()`: `N_CURSOR_FIX_ESCALATION_LOG` (kill-switch
- * `0|false|off|no` → не писати; інакше явний шлях) → дефолт
- * `<cwd>/.n-cursor/fix-escalation.jsonl`.
- */
-import { appendFileSync, mkdirSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { cwd, env } from 'node:process'
-
-/** Значення `N_CURSOR_FIX_ESCALATION_LOG`, що вимикають лог повністю. */
-const KILL_VALUES = new Set(['0', 'false', 'off', 'no'])
-
-/** Межа обрізки `remainingViolation`/`diagnosis` у записі (символів). */
-const MAX_FIELD_CHARS = 2000
-
-/**
- * Шлях активного escalation-логу або `null`, якщо вимкнено kill-switch-ем.
- * @returns {string|null} шлях до .jsonl або null
- */
-export function escalationLogPath() {
-  const override = env.N_CURSOR_FIX_ESCALATION_LOG
-  if (override !== undefined) {
-    if (KILL_VALUES.has(override.toLowerCase())) return null
-    if (override) return override
-  }
-  return join(cwd(), '.n-cursor', 'fix-escalation.jsonl')
-}
-
-/**
- * Обрізає рядок до `MAX_FIELD_CHARS` (null/undefined → null).
- * @param {string|null|undefined} s вхід
- * @returns {string|null} обрізаний рядок або null
- */
-function cap(s) {
-  if (s === null || s === undefined) return null
-  return s.length > MAX_FIELD_CHARS ? s.slice(0, MAX_FIELD_CHARS) : s
-}
-
-/**
- * Дописує один запис рунга у JSONL-лог (no-op, якщо вимкнено). Помилки запису
- * ковтаються — лог діагностичний, не має валити сам фікс.
- * @param {object} rec запис рунга
- * @param {string} rec.ts ISO-час завершення рунга
- * @param {string} rec.ruleId id правила
- * @param {number} rec.rung індекс рунга драбини (0-based)
- * @param {string} rec.tier мітка тиру (`local-min`|`local-min-retry`|`cloud-min`|`cloud-avg`)
- * @param {string} rec.model model-id (порожній → pi-дефолт)
- * @param {boolean} rec.withFeedback чи передавався feedback попереднього рунга
- * @param {boolean} rec.callOk чи виклик моделі+apply удався
- * @param {string|null} rec.callError помилка виклику (null, якщо callOk)
- * @param {boolean} rec.recheckOk чи правило стало зеленим після рунга («чи допомогло»)
- * @param {string|null} rec.remainingViolation залишковий violation (null, якщо recheckOk)
- * @param {string|null} rec.diagnosis само-аналіз моделі «чому попередній рунг не вдався»
- * @param {number} rec.ms тривалість рунга (мс)
- * @returns {void}
- */
-export function logEscalation(rec) {
-  const path = escalationLogPath()
-  if (!path) return
-  const line =
-    JSON.stringify({
-      ts: rec.ts,
-      ruleId: rec.ruleId,
-      rung: rec.rung,
-      tier: rec.tier,
-      model: rec.model,
-      withFeedback: rec.withFeedback,
-      callOk: rec.callOk,
-      callError: cap(rec.callError),
-      recheckOk: rec.recheckOk,
-      remainingViolation: rec.recheckOk ? null : cap(rec.remainingViolation),
-      diagnosis: cap(rec.diagnosis),
-      ms: rec.ms
-    }) + '\n'
-  try {
-    mkdirSync(dirname(path), { recursive: true })
-    appendFileSync(path, line, 'utf8')
-  } catch {
-    /* лог діагностичний — ковтаємо помилки запису */
-  }
-}