@7n/rules 1.49.2 → 1.49.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.49.3] - 2026-07-26
+
+### Changed
+
+- `n-git-reconcile` починає bounded LLM-кроки на `min`, переходить на `max` лише після валідної відповіді з validation failure, захищає detached worktree за OID, порівнює tests із baseline `origin/main`, запускає doc-files/lint лише для змінених code directories, безпечно пропускає empty cherry-pick, ізолює nested `npx`, повертає non-zero для неповного triage і показує точний фазовий progress.
+
 ## [1.49.2] - 2026-07-26
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.49.2",
+  "version": "1.49.3",
   "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.2",
+    "@7n/llm-lib": "2.9.3",
     "@7n/mt": "^0.5.1",
     "@zed-industries/agent-client-protocol": "^0.4.5",
     "ajv": "^8.20.0",

package/skills/git-reconcile/SKILL.md

@@ -25,21 +25,51 @@ JS виконує `fetch`, inventory, patch-equivalence, дедуплікаці
 worktree/PR/stash, підготовку worktree від `origin/main`, cherry-pick або
 застосування stash, gates, commit, push, PR і фінальний звіт.
 
-LLM отримує лише два bounded-завдання:
+LLM отримує лише bounded-завдання:
 
 1. semantic triage кандидатів, які JS не може оцінити за Git-фактами;
 2. розв'язання змістових конфліктів і перевірку перенесеної поведінки у вже
    підготовленому worktree.
 
 LLM не видаляє refs, не створює worktree, не push-ить і не відкриває PR.
+LLM виконує лише narrow tests, потрібні під час правок; full repository tests,
+doc generation, lint і changelog gates запускає JS після cognitive кроку.
+Doc-files і unified lint отримують лише унікальні директорії зміненого коду,
+щоб repository-wide baseline та stale docs поза scope не забруднювали PR.
+
+Оркестратор показує чесний фазовий progress: inventory має elapsed time без
+вигаданого total, а `triage`, `PR` і `cleanup` — окремі точні bars за вже
+відомими batches/groups/sources. Поточний LLM-етап показує tier `min` або
+`max`. У non-TTY/CI замість перемальовування виводяться append-only рядки.
+
+Кожен LLM-крок починається на tier `min`. JS детерміновано перевіряє:
+
+- triage — повноту verdicts, schema, groups і commit OID;
+- worktree — відсутність conflict markers та `git diff --check`;
+- поведінку — repository test script відносно test baseline чистого
+  `origin/main` і changelog gate. Red baseline приймається лише для
+  розпізнаних Vitest failures, якщо після перенесення не додалось нових.
+- змінений код — scoped `doc-files` у fix-режимі та unified lint у
+  `--no-fix`, окремо для кожної code directory.
+
+Лише валідна відповідь runner, яка провалила validation, запускає повтор того
+самого bounded-завдання на `max` із точною причиною провалу. Infrastructure
+failure runner завершує крок одразу: повтор іншою моделлю не маскує проблему
+transport. Після провалу `max` джерело fail-closed лишається `kept` або
+`failed`, не потрапляє в cleanup, а неповний triage завершує команду non-zero.
 
 ## Інваріанти
 
 - База — тільки свіжий `origin/main`.
-- Живі worktree та гілки відкритих PR — protected.
+- Живі worktree, включно з detached HEAD за commit OID, та гілки відкритих
+  PR — protected.
 - Стара дата або великий divergence не означають, що зміна непотрібна.
-- `ours`/`theirs` не застосовуються всліпу: конфлікт розв'язується за
+- `ours`/`theirs` не застосовуються механічно: конфлікт розв'язується за
   поведінкою й підтверджується тестом.
+- Empty cherry-pick пропускається лише за активного `CHERRY_PICK_HEAD`,
+  відсутніх conflicts і порожнього staged diff.
+- Вкладені `npx` не успадковують package selector зовнішнього
+  `npm exec --package`.
 - За невизначеності джерело лишається `kept`; misleading ready PR не
   створюється.
 - Cleanup виконує лише JS і тільки після inventory/PR-фази: видаляє точні refs,
@@ -55,4 +85,5 @@ LLM не видаляє refs, не створює worktree, не push-ить і
 Оркестратор повертає для кожного джерела один verdict: `merged`,
 `patch-equivalent`, `open-pr`, `protected`, `pr-created`, `kept`,
 `drop-recommended` або `failed`. Для `pr-created` додає URL, перенесені коміти,
-конфлікти та виконані перевірки.
+конфлікти та виконані перевірки. Для cleanup ref звіт також містить точний OID,
+щоб видалення можна було аудіювати після завершення.

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

@@ -3,13 +3,45 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/skills/git-reconcile/js/orchestrate.mjs
 docgen:
-  crc: f9dd9d0d
+  crc: 09f8b69d
   model: openai-codex/gpt-5.4-mini
   tier: cloud-min
-  score: 55
-  issues: no-overview,short-behavior,best-of-2:retry-lost
+  score: 100
+  issues: judge-refine:kept-original,judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
 ---
 
+## Огляд
+
+Модуль узгоджує Git branches, worktree і stash зі свіжим `origin/main`.
+JS виконує inventory, validation, materialization, gates, PR і cleanup, а LLM
+отримує лише bounded semantic triage, conflict resolution та behavioral edits.
+
+## Поведінка
+
+- Збирає refs, worktree, open PR, patch-equivalent commits і stash. Detached
+  worktree захищає за checkout HEAD OID.
+- Ізолює вкладені `npx` від `npm_config_package` зовнішнього `npm exec`.
+- Показує inventory elapsed time та окремі progress bars для triage, PR і
+  cleanup; у non-TTY виводить append-only progress.
+- Перевіряє повноту triage, groups та commit OID. Infrastructure failure
+  runner завершує крок одразу; `max` запускається лише після валідної
+  відповіді, що не пройшла validation.
+- Створює worktree від `origin/main`, за потреби ставить frozen Bun
+  dependencies і фіксує test baseline до перенесення source.
+- Red baseline допускається лише для розпізнаних Vitest failures, якщо
+  post-change набір не містить нових failures. Нерозпізнаний output
+  fail-closed.
+- Зводить tracked+untracked code paths до унікальних директорій. Для кожної
+  запускає scoped `doc-files` fix та unified lint `--no-fix`, не скануючи
+  repository-wide baseline.
+- Empty cherry-pick пропускається лише за активного `CHERRY_PICK_HEAD`,
+  відсутніх conflicts і порожнього staged diff.
+- Після LLM edits JS сам виконує Git checks, repository tests і changelog
+  gate. LLM prompt дозволяє лише narrow tests.
+- Створює PR і лише після успіху точково прибирає перенесені або доведено
+  неактуальні refs/stash; cleanup refs у звіті мають точний OID.
+
 ## Публічний API
 
 - parseWorktrees — Парсить `git worktree list --porcelain` у branch→path.
@@ -22,12 +54,32 @@ checkout, крім оновлення remote refs через fetch --prune.
 не виконує shell-команди й повертає лише JSON-рішення.
 - 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.
+- skipEmptyCherryPick — Пропускає лише підтверджений empty cherry-pick: sequencer активний,
+конфліктів немає, staged diff порожній.
+- testFailureSignatures — Витягає стабільні Vitest failure identifiers без summary/timing.
+- acceptsTestOutcome — Дозволяє red baseline лише якщо після перенесення не з'явилось нових
+Vitest failures. Нерозпізнаний red output завжди fail-closed.
+- sourceDirectories — Зводить змінені code paths до найвужчих директорій для scoped gates.
+- captureBehaviorBaseline — Фіксує test baseline на чистому origin/main до перенесення source.
+- validateBehaviorState — Додає до Git-state validation test script із репозиторію і changelog gate.
+Саме ці докази вирішують, чи приймати min-результат або ескалювати на max.
+- cleanupSource — Видаляє точний source після Git-доказу неактуальності або успішного
+перенесення. Protected/open-PR refs не потрапляють у цей крок.
 - formatReport — Формує deterministic report.
 - runGitReconcileOrchestrator — JS-оркестратор: inventory → bounded LLM triage → deterministic PR pipeline.
-Нічого не видаляє; `drop` є лише рекомендацією у звіті.
 
 ## Гарантії поведінки
 
-- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
-- Кешує результати в межах одного прогону.
+- Shell interpolation не використовується: executable та arguments
+  передаються окремо.
+- Live worktree, open PR, `kept`, incomplete triage та failed source не
+  видаляються.
+- Stash видаляється точково за стабільним commit ID; `git stash clear` не
+  використовується.
+- Worktree із проваленим перенесенням зберігається для діагностики.
+- Progress не змішує фази з різною вартістю в удаваний global percentage.