@nitra/cursor 12.2.0 → 12.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.3.0] - 2026-06-19
+
+### Added
+
+- lint --full: резюме викликів моделей у stdout (локальна / cloud-min / cloud-avg) через reportRunStats/summarizeCalls
+
 ## [12.2.0] - 2026-06-19
 
 ### Changed

package/package.json

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

package/rules/lint/js/docs/orchestrate.md

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/rules/lint/js/orchestrate.mjs
 docgen:
-  crc: f4eb439d
+  crc: 0f1d717c
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
@@ -16,7 +16,7 @@ docgen:
 selectLintRules вибирає і сортує ідентифікатори правил на основі їхнього обсягу дії (`per-file` або `full`) та прапорця `--full`.
 runLint запускає оркестрацію лінтування: або виконує перевірку конформності для заданих правил, або ітерує по алфавітно відсортованих правилах (`runPerFileRules`), запускаючи лінтер для змінених файлів (за замовчуванням), або виконує перевірку конформності всього репозиторію при використанні прапорця `--full`.
 **Fail-fast — лише в `--read-only`** (CI/детект): перший ненульовий код спиняє. У fix-режимі (default) ненульовий код per-file правила НЕ спиняє — проганяються всі правила й виконується крок виправлення (конформність-драбина), а повертається найгірший код.
-У режимі `--full` без `--read-only` після конформність-фази (`runFullConformancePhase`) викликається escalation-аналітика (`analyze-escalation.mjs`): фіксує зсув escalation-логу до фази, після — аналізує записи саме цього прогону. Аналіз не впливає на exit-код lint.
+У режимі `--full` без `--read-only` після конформність-фази (`runFullConformancePhase`) друкується резюме викликів моделей за прогін (`reportRunStats`: локальна / cloud-min / cloud-avg) і викликається escalation-аналітика (`analyze-escalation.mjs`): фіксує зсув escalation-логу до фази, після — аналізує записи саме цього прогону. Жодне з цього не впливає на exit-код lint.
 
 ## Публічний API
 

package/rules/lint/js/orchestrate.mjs

@@ -122,10 +122,15 @@ async function runPerFileRules(ids, ctx) {
  * @returns {Promise<number>} код конформності
  */
 async function runFullConformancePhase(cwd, readOnly, log) {
-  const { escalationLogSize, maybeAnalyzeEscalation } = await import('../../../scripts/lib/fix/analyze-escalation.mjs')
+  const { escalationLogSize, maybeAnalyzeEscalation, reportRunStats } = await import(
+    '../../../scripts/lib/fix/analyze-escalation.mjs'
+  )
   const escOffset = readOnly ? 0 : escalationLogSize()
   const conformanceCode = await runConformance(cwd, readOnly, log)
-  if (!readOnly) maybeAnalyzeEscalation(cwd, escOffset, log)
+  if (!readOnly) {
+    reportRunStats(escOffset, log) // резюме викликів моделей (локальна / cloud-min / cloud-avg)
+    maybeAnalyzeEscalation(cwd, escOffset, log)
+  }
   return conformanceCode
 }
 

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

@@ -107,6 +107,41 @@ export function readEscalationRecords(path, sinceOffset = 0) {
   return out
 }
 
+/** Маркер skip-запису avg-рунга (кеп вичерпано) — НЕ фактичний виклик моделі. */
+const AVG_SKIP_MARKER = 'cloud-avg cap reached'
+
+/**
+ * Рахує фактичні виклики моделей за тирами (skip-записи avg-кепу не рахуються).
+ * @param {object[]} records записи рунгів
+ * @returns {{ local: number, cloudMin: number, cloudAvg: number }} лічильники викликів
+ */
+export function summarizeCalls(records) {
+  const stats = { local: 0, cloudMin: 0, cloudAvg: 0 }
+  for (const r of records) {
+    if (r.callError === AVG_SKIP_MARKER) continue
+    if (r.tier === 'cloud-avg') stats.cloudAvg++
+    else if (r.tier === 'cloud-min') stats.cloudMin++
+    else if (typeof r.tier === 'string' && r.tier.startsWith('local')) stats.local++
+  }
+  return stats
+}
+
+/**
+ * Друкує резюме викликів моделей за цей прогін (локальна / cloud-min / cloud-avg).
+ * No-op, якщо викликів не було. Читає записи від `sinceOffset`.
+ * @param {number} sinceOffset байтовий зсув логу перед прогоном
+ * @param {(s: string) => void} log логер
+ * @returns {void}
+ */
+export function reportRunStats(sinceOffset, log) {
+  const { local, cloudMin, cloudAvg } = summarizeCalls(readEscalationRecords(escalationLogPath(), sinceOffset))
+  if (local + cloudMin + cloudAvg === 0) return
+  log(
+    `\n📊 LLM-виклики fix-конформності (цей прогін): ` +
+      `локальна ${local} · cloud-min ${cloudMin} · cloud-avg ${cloudAvg}\n`
+  )
+}
+
 /**
  * Стискає запис до полів, важливих для аналізу (без ts/ms-шуму).
  * @param {object} r сирий запис рунга

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

@@ -3,7 +3,7 @@ type: JS Module
 title: analyze-escalation.mjs
 resource: npm/scripts/lib/fix/analyze-escalation.mjs
 docgen:
-  crc: f802e47f
+  crc: 5a586df6
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
@@ -16,6 +16,8 @@ docgen:
 
 ## Публічний API
 
+- `summarizeCalls(records)` — лічильники фактичних викликів за тирами `{ local, cloudMin, cloudAvg }` (skip-записи avg-кепу не рахуються).
+- `reportRunStats(sinceOffset, log)` — друкує резюме викликів моделей за прогін (no-op, якщо викликів не було).
 - `analysisEnabled()` — чи дозволено авто-аналіз (kill-switch `N_CURSOR_FIX_ANALYZE`).
 - `escalationLogSize(path?)` — розмір логу в байтах (since-offset).
 - `readEscalationRecords(path, sinceOffset?)` — записи від зсуву.