@7n/rules 1.49.10 → 1.49.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.49.11] - 2026-07-26
+
+### Fixed
+
+- Додано окремий 180-секундний cloud budget для survived-mutant coverage batch і deferred решти batch-ів
+
 ## [1.49.10] - 2026-07-26
 
 ### Fixed

package/package.json

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

package/rules/test/coverage/concern.json

@@ -2,6 +2,7 @@
   "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
   "fixability": "code",
   "skipLocalTier": true,
+  "cloudTimeoutMs": 180000,
   "lint": {
     "scope": "per-file",
     "glob": ["**/*.{js,mjs,cjs,jsx,ts,tsx,vue}"]

package/rules/test/coverage/fix-worker.mjs

@@ -18,8 +18,9 @@
  * (assert порту вимагає лише detect/collect/collectPerFile). Хуки отримують
  * FixContext-поля (model/tier/timeoutMs/recordWrite/chain/signal/feedback);
  * recordWrite прокидається до кожного місця запису (rollback-контракт ladder-а).
- * Дедлайн: DEADLINE_FRACTION від ctx.timeoutMs гейтить СТАРТ наступного хука
- * (як js/eslint fix-worker); залишок бюджету передається хуку як timeoutMs.
+ * Coverage-specific cloud rung дає survived-mutant agent batch повний budget:
+ * outer runner backstop лишається ×1.25. Один survived batch стартує за rung;
+ * решта є deferred telemetry, а не timeout/no-op failure.
  * Власних retry-циклів немає — success визначає canonical re-detect runner-а.
  * @typedef {import('../../../scripts/lib/lint-surface/types.mjs').FixWorkerFn} FixWorkerFn
  * @typedef {import('../../../scripts/lib/lint-surface/types.mjs').FixContext} FixContext
@@ -27,8 +28,8 @@
  */
 import { resolveProviders } from './main.mjs'
 
-/** Частка ctx.timeoutMs, після якої не стартує наступний хук (запас до backstop ×1.25). */
-const DEADLINE_FRACTION = 0.8
+/** Один survived-mutant agent batch за coverage rung. */
+const SURVIVED_BATCHES_PER_RUNG = 1
 
 /** `.vue`-файли → generateStories, решта → generateTests. */
 const VUE_FILE_RE = /\.vue$/
@@ -59,7 +60,7 @@ export function groupViolations(violations) {
  */
 function hookCtx(ctx, deadlineAt) {
   const remaining = deadlineAt ? Math.max(1000, deadlineAt - Date.now()) : ctx.timeoutMs
-  const workerDeadlineMs = ctx.timeoutMs ? Math.round(ctx.timeoutMs * DEADLINE_FRACTION) : null
+  const workerDeadlineMs = ctx.timeoutMs ?? null
   return {
     ...ctx,
     timeoutMs: remaining,
@@ -68,7 +69,8 @@ function hookCtx(ctx, deadlineAt) {
     coverageTimeout: {
       requestedMs: ctx.timeoutMs ?? null,
       workerDeadlineMs,
-      effectiveHookTimeoutMs: remaining ?? null
+      effectiveHookTimeoutMs: remaining ?? null,
+      survivedBatchesPerRung: SURVIVED_BATCHES_PER_RUNG
     }
   }
 }
@@ -76,7 +78,7 @@ function hookCtx(ctx, deadlineAt) {
 /** @type {FixWorkerFn} */
 export async function fixWorker(violations, ctx, deps = {}) {
   // Дедлайн фіксується ДО резолву провайдерів — їх завантаження теж у бюджеті рунга.
-  const deadlineAt = ctx.timeoutMs ? Date.now() + Math.round(ctx.timeoutMs * DEADLINE_FRACTION) : null
+  const deadlineAt = ctx.timeoutMs ? Date.now() + ctx.timeoutMs : null
   const expired = () => deadlineAt !== null && Date.now() >= deadlineAt
 
   const providers = await (deps.resolveProviders ?? resolveProviders)(ctx.cwd)
@@ -88,6 +90,7 @@ export async function fixWorker(violations, ctx, deps = {}) {
   const touchedFiles = []
   /** @type {Array<{provider: string, hook: string, files: string[], error: string}>} */
   const failed = []
+  const deferred = []
   /**
    * Викликає опційний fix-hook провайдера, збирає touchedFiles; виняток хука не
    * валить решту хуків/провайдерів — success визначає canonical re-detect.
@@ -101,6 +104,7 @@ export async function fixWorker(violations, ctx, deps = {}) {
     try {
       const res = await provider[hook]({ ...args, cwd: ctx.cwd, ctx: hookCtx(ctx, deadlineAt) })
       touchedFiles.push(...(res?.touchedFiles ?? []))
+      deferred.push(...(res?.deferred ?? []))
       for (const failure of res?.failed ?? []) {
         const error = failure?.error ?? 'невідома причина'
         const files = failure?.files ?? []
@@ -115,9 +119,14 @@ export async function fixWorker(violations, ctx, deps = {}) {
   }
 
   for (const provider of providers) {
+    // Survived mutants мають власний cloud budget: не витрачаємо його на інші
+    // LLM hooks перед єдиним агентним batch-ем цього rung-а.
+    if (survived.length > 0) {
+      await runHook(provider, 'fixSurvived', { survived })
+      continue
+    }
     if (jsFiles.length > 0) await runHook(provider, 'generateTests', { files: jsFiles })
     if (vueFiles.length > 0) await runHook(provider, 'generateStories', { files: vueFiles })
-    if (survived.length > 0) await runHook(provider, 'fixSurvived', { survived })
     // Після генерації: тести, що впали (зокрема щойно згенеровані), чиняться
     // окремим хуком — свіжий vitest-прогін усередині провайдера. Без жодної
     // роботи вище (порожній профіль violations) хук не стартує.
@@ -126,5 +135,5 @@ export async function fixWorker(violations, ctx, deps = {}) {
     }
   }
 
-  return { touchedFiles, failed }
+  return { touchedFiles, failed, deferred }
 }

package/schemas/concern.json

@@ -23,6 +23,11 @@
       "type": "boolean",
       "description": "Дефолт `false` (поле можна опускати). `true` пропускає local-min/local-min-retry rung-и LLM-ladder-а для цього concern-а — перша спроба одразу йде на cloud-min. Для concern-ів, де local-tier (слабка локальна модель, короткий бюджет) емпірично майже завжди лише витрачає час rung-а без результату, перш ніж ladder однаково ескалює далі."
     },
+    "cloudTimeoutMs": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Опційний budget одного cloud rung-а лише для цього concern-а. Замінює timeout cloud-min/cloud-avg у ladder, не змінюючи глобальний `N_CLOUD_FIX_TIMEOUT_MS` або інші concern-и."
+    },
     "check": {
       "type": "boolean",
       "const": true,

package/scripts/lib/concern-meta.mjs

@@ -38,6 +38,8 @@ import { join } from 'node:path'
  *   ladder-а — ladder одразу стартує з cloud-min. Для concern-ів, де local-tier емпірично не встигає
  *   дати результат у межах свого бюджету (напр. js/eslint — 0/12 успіхів у реальному прогоні, лише
  *   витрачений час).
+ * @property {number|undefined} cloudTimeoutMs опційний budget cloud rung-а concern-а;
+ *   не змінює глобальні timeout-и ladder-а чи інші concern-и.
  */
 
 /**
@@ -131,7 +133,8 @@ export async function readConcernMeta(concernDir, name) {
     lint,
     requiresCapability,
     fixability: parseFixability(raw.fixability),
-    skipLocalTier: raw.skipLocalTier === true
+    skipLocalTier: raw.skipLocalTier === true,
+    cloudTimeoutMs: Number.isInteger(raw.cloudTimeoutMs) && raw.cloudTimeoutMs > 0 ? raw.cloudTimeoutMs : undefined
   }
 }
 

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

@@ -610,7 +610,9 @@ function noteT0Phase(t0, chainExtra, touchedAbs) {
 }
 
 /**
- * Ladder concern-а: повний, або без local-tier rung-ів (`concern.skipLocalTier`) —
+ * Ladder concern-а: повний, або без local-tier rung-ів (`concern.skipLocalTier`).
+ * Concern може замінити cloud budget своїм `cloudTimeoutMs`; глобальний ladder та
+ * всі інші concern-и лишаються без змін.
  * concern-и, де local-min/local-min-retry емпірично не встигають дати результат
  * у межах свого бюджету (concern-meta.mjs).
  * @param {Rung[]} ladder Повний ladder pipeline-у.
@@ -618,7 +620,10 @@ function noteT0Phase(t0, chainExtra, touchedAbs) {
  * @returns {Rung[]} Ladder, застосовний до цього concern-а.
  */
 function selectLadder(ladder, concern) {
-  return concern.skipLocalTier ? ladder.filter(rung => !rung.local) : ladder
+  const selected = concern.skipLocalTier ? ladder.filter(rung => !rung.local) : ladder
+  return concern.cloudTimeoutMs
+    ? selected.map(rung => (rung.local ? rung : { ...rung, timeoutMs: concern.cloudTimeoutMs }))
+    : selected
 }
 
 /**