@7n/rules 1.49.12 → 1.49.14

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.49.14] - 2026-07-27
+
+### Changed
+
+- release: @7n/rules@1.49.9
+
+## [1.49.13] - 2026-07-26
+
+### Fixed
+
+- Виправлено фактичний шлях worktree, setup failure і spawnSync-діагностику в git-reconcile
+- pass coverage mutation verdict feedback to the next ladder rung
+
 ## [1.49.12] - 2026-07-26
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.49.12",
+  "version": "1.49.14",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",
@@ -65,7 +65,7 @@
     "rename-yaml-extensions": "bun ./bin/n-rules.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@7n/llm-lib": "2.9.7",
+    "@7n/llm-lib": "2.9.8",
     "@7n/mt": "^0.5.1",
     "@zed-industries/agent-client-protocol": "^0.4.5",
     "ajv": "^8.20.0",

package/rules/release/docs/index.md

@@ -4,10 +4,7 @@ title: npm/rules/release
 resource: npm/rules/release/
 ---
 
-# npm/rules/release
-
 | Файл                      | Тип       |
 | ------------------------- | --------- |
 | [change.mjs](change.md)   | JS Module |
-| [main.mjs](main.md)       | JS Module |
 | [release.mjs](release.md) | JS Module |

package/rules/release/docs/release.md

@@ -3,7 +3,7 @@ type: JS Module
 title: release.mjs
 resource: npm/rules/release/release.mjs
 docgen:
-  crc: 8042a5fb
+  crc: 496b51f4
   model: openai-codex/gpt-5.4-mini
   tier: cloud-min
   score: 100
@@ -12,18 +12,22 @@ docgen:
 
 ## Огляд
 
-Файл агрегує per-workspace change-файли у version-bump і `CHANGELOG`, комітить, ставить тег `<name>@<version>` та видаляє використані change-файли. Запускається у CI на `main` за дизайном `n-rules-release-design`, варіант A, і сам нічого не публікує. Публічні функції: `release`, `runReleaseCli`.
+`release` агрегує per-workspace change-файли у version-bump і CHANGELOG, комітить результат, ставить тег `<name>@<version>` та видаляє використані change-файли. Запускається у CI на `main` за `n-rules-release-design`, варіант A, і сам нічого не публікує.
+
+`runReleaseCli` — CLI wrapper для запуску релізного процесу. Він потрібен, щоб ініціювати `release` із командного рядка.
 
 ## Поведінка
 
-`release` бере корінь репозиторію та дату, читає `package.json` як джерело workspace-метаданих і далі проходить по кожному workspace у порядку, заданому маніфестом. Для кожного workspace він збирає зміни, оновлює версію, дописує відповідний блок до CHANGELOG і прибирає використані change-файли; якщо для workspace немає релевантних змін, він не входить до списку релізу. Після цього `release` синхронізує точний runtime-пін `@7n/rules` із одночасно випущеним `@7n/llm-lib`, щоб transport не лишався на старій транзитивній версії, а потім формує коміт, анотовані теги `<name>@<version>` і, за увімкненого push, доводить release-коміт до апстріму з ретраями на випадок паралельних push у ту саму гілку. Поверненням є лише перелік фактично зрелізованих пакетів; самі артефакти публікації тут не виконуються.
+`release` послідовно обходить workspaces, збирає change-файли з їхніх директорій, визначає новий bump, оновлює версію в маніфесті, дописує секцію в CHANGELOG і прибирає використані change-файли. Якщо для пакета немає явних change-файлів, але є коміти, він все одно формує релізний запис на основі цього джерела змін.
+
+Результат `release` — список фактично релізнутих workspace-ів із новими версіями; цей список далі йде в commit-back і створення анотованих тегів `\<name>@\<version>`. Якщо релізу для workspace нема, він не потрапляє до вихідного списку й не отримує тег.
 
-`runReleaseCli` є тонкою CLI-обгорткою над `release`: запускає той самий потік з дефолтними параметрами, а в тестах дозволяє підмінити корінь, дату, git-раннер і режим push. Якщо release завершується без помилки, CLI повертає успішний exit-код; якщо ні — не приховує збій.
+`runReleaseCli` лише запускає `release` і передає в GitHub Actions перелік workspace-ів, для яких справді з’явилася нова версія.
 
 ## Публічний API
 
-- release — агрегує per-workspace change-файли у version-bump і CHANGELOG, створює commit, ставить тег `<name>@<version>` та видаляє use-up change-файли; спирається на налаштування з package.json.
-- runReleaseCli — CLI-entry для запуску `release`, щоб виконати той самий release-сценарій з командного рядка без окремого ручного складання кроків.
+- release — агрегує per-workspace change-файли у version-bump і CHANGELOG, комітить зміни, ставить тег `<name>@<version>` та видаляє use-up change-файли; спирається на package.json.
+- runReleaseCli — CLI-entry point для ручного запуску `release` без окремої релізної логіки.
 
 ## Гарантії поведінки
 

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

@@ -90,6 +90,7 @@ export async function fixWorker(violations, ctx, deps = {}) {
   const touchedFiles = []
   /** @type {Array<{provider: string, hook: string, files: string[], error: string}>} */
   const failed = []
+  let feedback = null
   const deferred = []
   /**
    * Викликає опційний fix-hook провайдера, збирає touchedFiles; виняток хука не
@@ -104,6 +105,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 ?? []))
+      if (res?.feedback?.previousError) feedback = res.feedback
       deferred.push(...(res?.deferred ?? []))
       for (const failure of res?.failed ?? []) {
         const error = failure?.error ?? 'невідома причина'
@@ -135,5 +137,5 @@ export async function fixWorker(violations, ctx, deps = {}) {
     }
   }
 
-  return { touchedFiles, failed, deferred }
+  return { touchedFiles, failed, deferred, feedback }
 }

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

@@ -454,6 +454,10 @@ async function runRung(rung, worker, violations, feedback, rungDeps) {
 
   const vetoed = after.length === 0 && !error && (collateralAll.length > 0 || brokenTest !== null)
   const touchedFiles = workerResult?.touchedFiles ?? []
+  // Provider може повернути quality-verdict без worker exception (наприклад,
+  // generated coverage test зелений у Vitest, але не вбив target mutant). Це
+  // не змінює retry policy; лише дає наступному ladder rung-у конкретний feedback.
+  const workerFeedback = workerResult?.feedback?.previousError ?? null
 
   if (after.length === 0 && !error && !vetoed) {
     log(`  ✅ ${rung.tier} (${rung.model}): ${ruleId}/${concernName}\n`)
@@ -501,7 +505,7 @@ async function runRung(rung, worker, violations, feedback, rungDeps) {
     outcome: {
       action: decideAfterFailure(rung, error),
       violations: after.length > 0 ? after : violations,
-      feedback: { previousModel: rung.model, previousError: error ?? silentFailureNote }
+      feedback: { previousModel: rung.model, previousError: error ?? workerFeedback ?? silentFailureNote }
     }
   }
 }

package/skills/git-reconcile/js/docs/orchestrate.md

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/skills/git-reconcile/js/orchestrate.mjs
 docgen:
-  crc: c3233b69
+  crc: 6e9cb156
   model: openai-codex/gpt-5.5
   tier: cloud-avg
   score: 100
@@ -21,7 +21,7 @@ docgen:
 
 Для review-кандидатів `buildTriagePrompt` формує обмежене завдання для LLM: модель отримує вже пораховані Git-факти й має повернути лише JSON-рішення. `callRunner` викликає обраний runner, `parseDecisionEnvelope` дістає структуровану відповідь, а `validateTriageOutcome` приймає тільки повний і узгоджений набір рішень для поточного batch. `callWithValidatedFallback` спершу пробує дешевший рівень, а дорожчий використовує лише після конкретного validation failure.
 
-Під час матеріалізації рішення source переноситься у керований worktree. `branchSlug` забезпечує передбачувані rescue-гілки, а `ensureLocalWorktreeExclude` не дає службовим worktree забруднювати root `git status`. Якщо cherry-pick стає порожнім, `skipEmptyCherryPick` дозволяє skip лише для доведеного semantic no-op, а `finishCherryPick` завершує активний перенос без прийняття неперевіреного Git-стану. `hasChangesFromBase` відсікає PR без реального tree diff.
+Під час матеріалізації рішення source переноситься у керований worktree. `branchSlug` забезпечує передбачувані rescue-гілки без крайового дефіса після скорочення, а `ensureLocalWorktreeExclude` не дає службовим worktree забруднювати root `git status`. Після `@7n/mt` actual checkout визначається через `git worktree list --porcelain`, тому collision sanitized-каталогу не веде до реконструйованого cwd. Setup failure повертається як `failed` лише для цієї PR-групи з branch, фактичним worktree та `spawnSync`-діагностикою; source і forensic checkout не очищуються. Якщо cherry-pick стає порожнім, `skipEmptyCherryPick` дозволяє skip лише для доведеного semantic no-op, а `finishCherryPick` завершує активний перенос без прийняття неперевіреного Git-стану. `hasChangesFromBase` відсікає PR без реального tree diff.
 
 Behavior-gates будуються навколо baseline: `captureBehaviorBaseline` фіксує стан чистої `origin/<baseBranch>` із repository Git policy, а `captureCachedBehaviorBaseline` перевикористовує цей результат у межах одного прогону для однакової бази. `validateBehaviorState` перевіряє Git-консистентність, scoped lint/docs і test outcome; правила запуску тестів і скриптів беруться з `package.json`. `testFailureSignatures` нормалізує failures, а `acceptsTestOutcome` дозволяє red baseline тільки без нових failures. Якщо валідація падає через типовий formatting, CSpell, docs або changelog-дефект, `remediateBehaviorState` запускає canonical fixers перед ескалацією LLM.
 
@@ -31,58 +31,42 @@ Behavior-gates будуються навколо baseline: `captureBehaviorBasel
 
 ## Публічний API
 
-- createPhaseProgress — Створює ANSI-free snapshot progress для однієї фази. Однаковий append-only
-формат у TTY/CI не засмічує captured output cursor-control кодами, а
-heartbeat показує elapsed time довгих LLM-етапів.
+- createPhaseProgress — Створює ANSI-free snapshot progress для однієї фази.
 - parseWorktrees — Парсить `git worktree list --porcelain` у branch→path.
-- dedupeRefs — Дедуплікує local/remote refs одного commit: remote має пріоритет, але
-worktree-protection локального ref переноситься у запис.
+- dedupeRefs — Дедуплікує local/remote refs одного commit.
 - conflictFiles — Витягає конфліктні файли з `git merge-tree`.
-- inventoryRepository — Збирає детермінований Git inventory. Нічого не видаляє і не змінює у
-checkout, крім оновлення remote refs через fetch --prune.
-- buildTriagePrompt — Формує bounded semantic-triage prompt. Git-факти вже пораховані JS; модель
-не виконує shell-команди й повертає лише JSON-рішення.
+- inventoryRepository — Збирає детермінований Git inventory.
+- buildTriagePrompt — Формує bounded semantic-triage prompt.
 - parseDecisionEnvelope — Витягає JSON object із чистої або fenced відповіді.
 - callRunner — Викликає вибраний LLM runner для одного bounded-завдання.
-- callWithValidatedFallback — Виконує bounded LLM-крок через min, валідовує результат JS-функцією і
-викликає max лише після конкретного провалу.
-- validateTriageOutcome — Структурно перевіряє triage-рішення: рівно один verdict на candidate,
-валідні actions/groups і лише відомі commit OID.
-- branchSlug — Перетворює довільний title/ref на branch slug.
-- ensureLocalWorktreeExclude — Додає `.worktrees/` до локального Git exclude без tracked-змін у consumer.
-Це не замінює repository Vitest excludes, але не лишає root checkout dirty
-через керовані або forensic worktree.
-- skipEmptyCherryPick — Пропускає лише підтверджений empty cherry-pick: sequencer активний,
-конфліктів немає, staged diff порожній.
-- finishCherryPick — Завершує активний cherry-pick: semantic no-op пропускає, непорожній
-продовжує. Відсутній sequencer не потребує дії.
-- hasChangesFromBase — Перевіряє реальний tree diff, а не лише кількість commits ahead.
-- testFailureSignatures — Витягає стабільні Vitest failure identifiers без summary/timing.
-- acceptsTestOutcome — Дозволяє red baseline лише якщо після перенесення не з'явилось нових
-Vitest failures. Нерозпізнаний red output завжди fail-closed.
-- sourceDirectories — Зводить змінені code paths до найвужчих директорій для scoped gates.
-- changedNonCodeDirectories — Повертає директорії non-code змін для фінального domain lint.
-- remediateBehaviorState — Запускає canonical fixers у worktree до ескалації min→max. Це прибирає
-formatting/CSpell/doc/changelog дефекти без повторного behavioral LLM.
-- captureBehaviorBaseline — Фіксує test baseline на чистій policy base branch до перенесення source.
-- captureCachedBehaviorBaseline — Повторно використовує test baseline однієї policy base branch між PR-групами.
-Залежності все одно встановлюються в кожному окремому worktree.
-- validateBehaviorState — Додає до Git-state validation test script із репозиторію і changelog gate.
-Саме ці докази вирішують, чи приймати min-результат або ескалювати на max.
-- validateFinalProjectGates — Фінальний domain gate охоплює non-code зміни, зокрема workflows, dependency
-manifests і правила. Code directories уже пройшли scoped lint і tests.
-- cleanupSource — Видаляє точний source після Git-доказу неактуальності або успішного
-перенесення. Protected/open-PR refs не потрапляють у цей крок.
+- callWithValidatedFallback — Виконує min, валідує результат і викликає max лише після validation failure.
+- validateTriageOutcome — Структурно перевіряє triage-рішення.
+- branchSlug — Перетворює title/ref на валідний короткий branch slug.
+- ensureLocalWorktreeExclude — Додає `.worktrees/` до локального Git exclude без tracked-змін.
+- skipEmptyCherryPick — Пропускає лише підтверджений empty cherry-pick.
+- finishCherryPick — Завершує активний cherry-pick.
+- hasChangesFromBase — Перевіряє реальний tree diff, а не commits ahead.
+- testFailureSignatures — Витягає стабільні Vitest failure identifiers.
+- acceptsTestOutcome — Дозволяє red baseline лише без нових failures.
+- sourceDirectories — Зводить code paths до найвужчих директорій для scoped gates.
+- changedNonCodeDirectories — Повертає директорії non-code змін для domain lint.
+- remediateBehaviorState — Запускає canonical fixers перед behavioral max fallback.
+- captureBehaviorBaseline — Фіксує test baseline на чистій policy base branch.
+- captureCachedBehaviorBaseline — Кешує test baseline між PR-групами.
+- validateBehaviorState — Додає Git-state validation, tests і changelog gate.
+- validateFinalProjectGates — Перевіряє фінальні non-code domain gates.
+- cleanupSource — Видаляє тільки доказово безпечний точний source.
 - formatReport — Формує deterministic report.
-- runWithConcurrency — Виконує async jobs із bounded concurrency та стабільним порядком output.
+- runWithConcurrency — Виконує async jobs із bounded concurrency та стабільним output.
 - normalizePrConcurrency — Нормалізує bounded concurrency PR-фази.
-- runGitReconcileOrchestrator — JS-оркестратор: inventory → bounded LLM triage → deterministic PR pipeline.
+- runGitReconcileOrchestrator — Координує inventory, triage, PR і cleanup.
 
 ## Гарантії поведінки
 
 - Progress є append-only та не містить ANSI cursor-control sequences.
 - Не більше чотирьох PR-груп виконуються одночасно; типовий ліміт — три.
 - Canonical fixers мають пріоритет перед behavioral `max` fallback.
-- Cleanup починається лише після завершення всіх PR jobs і не видаляє
-  protected/open-PR/failed sources.
+- Cleanup починається лише після завершення всіх PR jobs і не видаляє protected/open-PR/failed sources.
+- `spawnSync.error`, зокрема `ENOENT`, не губиться в command diagnostics.
+- Setup failure зберігає forensic worktree і не зупиняє незалежні PR-групи.
 - Test baseline кешується за OID policy base branch у межах одного прогону.

package/skills/git-reconcile/js/orchestrate.mjs

@@ -138,7 +138,7 @@ export function createPhaseProgress(args) {
  * @param {string} cwd робочий каталог
  * @param {typeof spawnSync} spawnFn інжект для тестів
  * @param {{ allowFailure?: boolean, input?: string }} [options] режим помилки та stdin
- * @returns {{ status: number, stdout: string, stderr: string }} результат
+ * @returns {{ status: number, stdout: string, stderr: string, error: string }} результат
  */
 function run(command, args, cwd, spawnFn, options = {}) {
   const childEnv = { ...env, GIT_EDITOR: 'true' }
@@ -153,11 +153,12 @@ function run(command, args, cwd, spawnFn, options = {}) {
   const normalized = {
     status: result.status ?? 1,
     stdout: result.stdout ?? '',
-    stderr: result.stderr ?? ''
+    stderr: result.stderr ?? '',
+    error: result.error ? `${result.error.name ?? 'Error'}${result.error.code ? ` ${result.error.code}` : ''}: ${result.error.message}` : ''
   }
   if (!options.allowFailure && normalized.status !== 0) {
     throw new Error(
-      `${command} ${args.join(' ')} → exit ${normalized.status}: ${normalized.stderr || normalized.stdout}`
+      `${command} ${args.join(' ')} → exit ${normalized.status}: ${normalized.stderr || normalized.stdout || normalized.error}`
     )
   }
   return normalized
@@ -666,6 +667,7 @@ export function branchSlug(value) {
     .replaceAll(/[^a-z0-9]+/g, '-')
     .replaceAll(/^-|-$/g, '')
     .slice(0, 40)
+    .replaceAll(/^-|-$/g, '')
   return slug || 'change'
 }
 
@@ -706,12 +708,22 @@ function chooseBranch(title, cwd, spawnFn) {
 function createReconcileWorktree(title, source, cwd, spawnFn) {
   const baseRef = policyBaseRef(cwd)
   const branch = chooseBranch(title, cwd, spawnFn)
-  run('npx', ['@7n/mt', 'worktree', 'create', branch, `git-reconcile: ${source}`], cwd, spawnFn)
-  const worktreeCwd = join(cwd, '.worktrees', branch.replaceAll('/', '-'))
-  git(['switch', '--detach', baseRef], worktreeCwd, spawnFn)
-  git(['branch', '-f', branch, baseRef], worktreeCwd, spawnFn)
-  git(['switch', branch], worktreeCwd, spawnFn)
-  return { branch, cwd: worktreeCwd }
+  let worktreeCwd
+  try {
+    run('npx', ['@7n/mt', 'worktree', 'create', branch, `git-reconcile: ${source}`], cwd, spawnFn)
+    const worktrees = parseWorktrees(git(['worktree', 'list', '--porcelain'], cwd, spawnFn).stdout)
+    worktreeCwd = worktrees.get(`refs/heads/${branch}`)
+    if (!worktreeCwd) throw new Error(`@7n/mt не зареєстрував worktree для ${branch}`)
+    git(['switch', '--detach', baseRef], worktreeCwd, spawnFn)
+    git(['branch', '-f', branch, baseRef], worktreeCwd, spawnFn)
+    git(['switch', branch], worktreeCwd, spawnFn)
+    return { branch, cwd: worktreeCwd }
+  } catch (error) {
+    const setupError = error instanceof Error ? error : new Error(String(error))
+    setupError.branch = branch
+    if (worktreeCwd) setupError.worktree = worktreeCwd
+    throw setupError
+  }
 }
 
 /**
@@ -1225,11 +1237,12 @@ async function createPullRequest(args) {
     return { status: 'kept', error: 'LLM не вибрала жодного валідного commit oid' }
   }
 
-  onProgress('worktree')
-  const worktree = createReconcileWorktree(group.title, source, rootCwd, spawnFn)
+  let worktree
   let createdPr
-  log(`🌿 ${source} → ${worktree.branch}`)
   try {
+    onProgress('worktree')
+    worktree = createReconcileWorktree(group.title, source, rootCwd, spawnFn)
+    log(`🌿 ${source} → ${worktree.branch}`)
     const sourceMayChangeCode = (candidate.changedFiles ?? []).some(path => SOURCE_CODE_RE.test(path))
     let baseline = null
     if (sourceMayChangeCode) {
@@ -1318,11 +1331,12 @@ async function createPullRequest(args) {
     removeReconcileWorktree(worktree, rootCwd, spawnFn)
     return { status: 'pr-created', url: createdPr, branch: worktree.branch }
   } catch (error) {
+    const setup = /** @type {{branch?:string,worktree?:string}} */ (error)
     return {
       status: 'failed',
       error: error instanceof Error ? error.message : String(error),
-      branch: worktree.branch,
-      worktree: worktree.cwd,
+      branch: worktree?.branch ?? setup.branch,
+      worktree: worktree?.cwd ?? setup.worktree,
       ...(createdPr && { url: createdPr })
     }
   }