@7n/rules 1.17.0 → 1.17.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.17.2] - 2026-07-18
+
+### Fixed
+
+- run-fix.mjs: rollback перед перекиданням DetectorError з canonical re-detect — раніше worker/LLM-пошкоджений файл (напр. невалідний YAML) лишався на диску, бо виняток абортував прогін до звичайного snapshot.rollback()
+
+## [1.17.1] - 2026-07-18
+
+### Fixed
+
+- lint: `--base <ref>` тепер діє і в чистому delta-режимі (без `--path`) — раніше явна база застосовувалась лише до перетину path ∩ дельта
+
 ## [1.17.0] - 2026-07-18
 
 ### Changed

package/bin/n-rules.js

@@ -1802,7 +1802,8 @@ try {
           verbose: args.includes('--verbose'),
           files: pathFiles,
           pathMode,
-          repoWide
+          repoWide,
+          baseRef
         }
         const noFix = args.includes('--no-fix')
         // Глобальна черга full-прогонів (spec 2026-07-03): одночасно виконується один

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/scripts/lib/lint-surface/docs/run-detectors.md

@@ -3,7 +3,7 @@ type: JS Module
 title: run-detectors.mjs
 resource: npm/scripts/lib/lint-surface/run-detectors.mjs
 docgen:
-  crc: 37567fc8
+  crc: 128fe3b7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/scripts/lib/lint-surface/docs/run-fix.md

@@ -3,7 +3,7 @@ type: JS Module
 title: run-fix.mjs
 resource: npm/scripts/lib/lint-surface/run-fix.mjs
 docgen:
-  crc: 0a7a2c75
+  crc: c4235855
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 
@@ -22,6 +22,7 @@ Evidence-гейт рунга (Фаза A1 run-harness, спека 2026-07-11):
 Durable-write-и (issue nitra/cursor#16): worker отримує у `FixContext` поруч із `recordWrite` опційний `recordDurableWrite` — для записів, кожен з яких є самодостатнім кінцевим станом (doc-files: дока зі свіжим CRC). Такі файли переживають rollback провального rung-а і не входять у collateral-veto: частковий прогрес великого батчу не стирається, canonical re-detect наступного rung-а/прогону рахує лише те, що реально лишилось.
 MT-tail (Фаза B, спека 2026-07-11): коли лишився невиправлений хвіст (worst=1), `renderRemaining` повертає зібрані порушення, і вони матеріалізуються у вузли MT-графа через `materializeTail` (mt-tail.mjs). Єдиний гейт — onboarded-репо (наявність `.mt.json`); fail-open: MT недоступний або будь-яка помилка → лог, lint не падає.
 Distillation-телеметрія (Фаза C, §13 pi-migration): успішний agentic-рунг (canonical clean, без veto, з реальними правками у worker telemetry) пише запис `oldText→newText` у глобальний стор (`recordFixTelemetry`, `~/.n-rules/telemetry/<rule>/open/`) — корпус для маховика дистиляції T0. Best-effort; T0/ручні фікси не пишуться.
+Rollback на провалі re-detect-а: якщо canonical re-detect усередині rung-а сам кидає виняток (worker/LLM лишив файл синтаксично невалідним — детектор/conftest не може його розпарсити), `runRung` спершу відкочує `snapshot` до S1, і лише потім перекидає виняток далі — без цього зіпсований проміжний стан worker-а лишався б на диску назавжди (виняток абортує весь прогін до звичайного rollback-коду).
 
 ## Публічний API
 

package/scripts/lib/lint-surface/run-detectors.mjs

@@ -197,6 +197,7 @@ export async function buildDetectPlan(opts) {
     explicitFiles: Array.isArray(opts.files) ? opts.files : null,
     pathMode: opts.pathMode === true,
     repoWide: opts.repoWide === true,
+    baseRef: typeof opts.baseRef === 'string' ? opts.baseRef : null,
     cwd: opts.cwd
   })
 }
@@ -375,10 +376,20 @@ export function computeActiveDomains(byRule, enabledSet, changed) {
  * @param {string[]|null} args.explicitFiles явний перелік файлів або null.
  * @param {boolean} [args.pathMode] `--path`-дельта: лише per-file concerns.
  * @param {boolean} [args.repoWide] `--repo-wide`: лише full-scope concerns, whole-repo.
+ * @param {string|null} [args.baseRef] явна база дельти (`--base <ref>`) замість каскаду main→origin/main.
  * @param {string} args.cwd робоча директорія прогону.
  * @returns {Promise<PlanItem[]>} впорядкований план прогону.
  */
-async function buildPlan({ byRule, full, rules, explicitFiles, pathMode = false, repoWide = false, cwd }) {
+async function buildPlan({
+  byRule,
+  full,
+  rules,
+  explicitFiles,
+  pathMode = false,
+  repoWide = false,
+  baseRef = null,
+  cwd
+}) {
   // scoped + --path: per-file concerns названих правил × перетин path ∩ дельта
   if (rules.length > 0 && explicitFiles !== null) return buildScopedDeltaPlan(byRule, rules, explicitFiles)
   // scoped: усі lint-concerns названих правил, whole-repo
@@ -394,7 +405,7 @@ async function buildPlan({ byRule, full, rules, explicitFiles, pathMode = false,
   if (full && explicitFiles === null) return buildFullPlan(byRule, enabledSet)
 
   // delta / explicit-files; path-режим виключає full-scope concerns
-  const changed = explicitFiles ?? (await collectChangedFilesSince(await resolveChangedBase(cwd), cwd))
+  const changed = explicitFiles ?? (await collectChangedFilesSince(await resolveChangedBase(cwd, baseRef), cwd))
   return buildDeltaPlan(byRule, enabledSet, changed, { perFileOnly: pathMode })
 }
 
@@ -554,6 +565,7 @@ export async function detectAll(opts) {
     explicitFiles,
     pathMode: opts.pathMode === true,
     repoWide: opts.repoWide === true,
+    baseRef: typeof opts.baseRef === 'string' ? opts.baseRef : null,
     cwd
   })
 

package/scripts/lib/lint-surface/run-fix.mjs

@@ -238,12 +238,17 @@ async function runRung(rung, worker, violations, feedback, rungDeps) {
     error = workerError.message
   }
 
-  // Canonical re-detect = джерело правди.
+  // Canonical re-detect = джерело правди. Якщо він сам кидає (напр. worker лишив файл
+  // синтаксично невалідним — LLM зламав YAML-структуру, детектор/conftest не може його
+  // розпарсити) — rollback МАЄ спрацювати перед перекиданням винятку далі. Без цього
+  // зіпсований проміжний стан worker-а лишався б на диску назавжди: виняток з re-detect
+  // абортує весь прогін, і код нижче (snapshot.rollback() для звичайного «не чисто»)
+  // ніколи не виконується.
   let after
   try {
     after = await reDetect(item, cwd, progress, verbose)
   } catch (detectError) {
-    if (detectError instanceof DetectorError) throw detectError
+    snapshot.rollback()
     throw detectError
   }