@7n/rules 1.48.2 → 1.49.0

package/scripts/utils/docs/glob-compat.md

@@ -3,29 +3,35 @@ type: JS Module
 title: glob-compat.mjs
 resource: npm/scripts/utils/glob-compat.mjs
 docgen:
-  crc: a226a048
-  model: manual
-  tier: manual
+  crc: 0c6af731
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
   score: 100
+  issues: judge-refine:kept-original,judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Runtime-нейтральний glob-обхід для коду, що виконується і під Bun, і під Node. Потрібен, бо hook запускається через `npx` → Node, де глобал `Bun` не визначений (top-level `new Bun.Glob(...)` зривав import модуля-детектора), а прямий `node:fs/promises#glob` не працює на self-hosted Linux Bun 1.3.14, де Node-compat шим не надає export `glob`. Реалізація вибирається за середовищем виконання: `Bun.Glob` під Bun, `node:fs/promises#glob` під Node (гарантовано за `engines: node >=25`).
+Файл забезпечує runtime-нейтральний glob-обхід для коду, що має працювати і під Bun, і під Node. Це потрібно, щоб імпорт модуля не падав у hook-сценаріях, які запускаються через `npx` у Node, де глобал `Bun` не визначений і top-level `new Bun.Glob` ламає завантаження модуля. Вибір механізму обходу відбувається за середовищем виконання: `Bun.Glob` під Bun, `node:fs/promises#glob` під Node (`node >=25`). Публічні точки файлу — `resolveGlobScan` і `hasIgnoredPathSegment`; друга відсікає шляхи через службові теки перед подальшою обробкою.
 
-## Публічний API
+## Поведінка
+
+`resolveGlobScan` уніфікує результат сканування glob перед подальшою ітерацією: якщо `Bun.Glob.scan` повертає Promise, він дочікується розв’язання, якщо вже повертає async-iterable — передає його далі без змін. Це прибирає різницю між середовищами виконання й дозволяє наступним крокам працювати з одним форматом даних.
 
-- `scanGlob(pattern, cwd)` — async-генератор: ітерує відносні (до `cwd`) шляхи файлів, що відповідають glob-патерну (наприклад, `cf/*/package.json`).
-- `hasIgnoredPathSegment(relPath, ignoredDirs)` — чи містить відносний шлях сегмент зі службових тек (наприклад, `node_modules`), які glob-обхід має ігнорувати; еквівалент ignore-патернів `**/<dir>/**` по кожній теці з `ignoredDirs`. Розділювачі `\` нормалізуються до `/`.
+`hasIgnoredPathSegment` застосовує спільне правило відсікання службових тек до відносних шляхів, щоб результати glob-обходу не потрапляли в обробку, якщо шлях проходить через одну з ігнорованих тек. Перевірка працює по сегментах шляху, тож однаковий результат дає і для Unix-, і для Windows-розділювачів.
 
-## Де використовується
+Разом ці функції формують потік: сканування дає сирі збіги, `resolveGlobScan` стабілізує форму їх повернення, а `hasIgnoredPathSegment` відсікає небажані шляхи до передачі результатів далі. Поведінка узгоджується з очікуваннями, закладеними в `package.json`.
+
+## Публічний API
 
-- `npm/scripts/lib/workspaces.mjs` — розгортання workspace-патернів із `*`.
-- `npm/scripts/utils/resolve-js-root.mjs` — резолв JS-roots за workspace-патернами.
-- `npm/rules/changelog/lib/package-manifest.mjs` — пошук `pyproject.toml` по репо.
-- `npm/rules/tauri/core_test_isolation/main.mjs` — glob-члени `[workspace] members` і обхід `**/*.rs`.
+- resolveGlobScan — Розрізняє дві форми повернення `Bun.Glob#scan()`: async-iterable напряму
+(macOS) або Promise, що резолвиться в async-iterable (спостережено на
+self-hosted Linux Bun 1.3.14 — `yield*` на Promise падає з "is not async
+iterable", бо в Promise немає ні `Symbol.asyncIterator`, ні `Symbol.iterator`).
+- hasIgnoredPathSegment — Чи містить відносний шлях сегмент зі службових тек, які glob-обхід має ігнорувати.
+Еквівалент колишніх ignore-патернів `**\/<dir>/**` по кожній теці з `ignoredDirs`.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
-- Не фільтрує результати сам: ігнорування службових тек — відповідальність викликача (через `hasIgnoredPathSegment` або власні перевірки).
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.

package/scripts/utils/glob-compat.mjs

@@ -8,15 +8,30 @@
  * Node (engines: node >=25).
  */
 
+/**
+ * Розрізняє дві форми повернення `Bun.Glob#scan()`: async-iterable напряму
+ * (macOS) або Promise, що резолвиться в async-iterable (спостережено на
+ * self-hosted Linux Bun 1.3.14 — `yield*` на Promise падає з "is not async
+ * iterable", бо в Promise немає ні `Symbol.asyncIterator`, ні `Symbol.iterator`).
+ * @param {unknown} scanned повернення `Bun.Glob#scan()`
+ * @returns {Promise<unknown>} async-iterable шляхів (резолвлений, якщо `scanned` — Promise)
+ */
+export async function resolveGlobScan(scanned) {
+  return typeof (/** @type {{ then?: unknown }} */ (scanned).then) === 'function' ? await scanned : scanned
+}
+
 /**
  * Ітерує відносні шляхи файлів за glob-патерном.
  * @param {string} pattern glob-патерн (наприклад, `cf/*\/package.json`)
  * @param {string} cwd корінь обходу
+ * @param {{ bun?: { Glob: new (pattern: string) => { scan(opts: { cwd: string }): unknown } } }} [opts] `bun` —
+ *   ін'єкція `Bun`-подібної реалізації для тестів (типово — глобал `Bun`).
  * @yields {string} кожен відносний шлях збігу
  */
-export async function* scanGlob(pattern, cwd) {
-  if (typeof Bun !== 'undefined') {
-    yield* new Bun.Glob(pattern).scan({ cwd })
+export async function* scanGlob(pattern, cwd, opts = {}) {
+  const bun = opts.bun ?? (typeof Bun === 'undefined' ? undefined : Bun)
+  if (bun !== undefined) {
+    yield* await resolveGlobScan(new bun.Glob(pattern).scan({ cwd }))
     return
   }
   const { glob } = await import('node:fs/promises')

package/skills/git-reconcile/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: n-git-reconcile
+description: >-
+  JS-оркестрований аналіз git-гілок, worktree та stash відносно актуального
+  origin/main: детерміновано відсіює merged і patch-equivalent refs, передає
+  LLM лише semantic triage та conflict resolution, а корисні зміни переносить
+  у перевірені PR. Використовуй, коли просять розібрати, консолідувати,
+  підготувати PR або безпечно почистити старі Git refs і stash.
+---
+
+# n-git-reconcile — узгодження Git-графа
+
+Запускай через JS-оркестратор:
+
+```bash
+npx @7n/rules skill pi git-reconcile
+```
+
+`cursor` і `codex` підтримуються замість `pi`. Без раннера команда лише друкує
+цей skill як промпт і не виконує reconciliation.
+
+## Розподіл відповідальності
+
+JS виконує `fetch`, inventory, patch-equivalence, дедуплікацію refs, збір
+worktree/PR/stash, підготовку worktree від `origin/main`, cherry-pick або
+застосування stash, gates, commit, push, PR і фінальний звіт.
+
+LLM отримує лише два bounded-завдання:
+
+1. semantic triage кандидатів, які JS не може оцінити за Git-фактами;
+2. розв'язання змістових конфліктів і перевірку перенесеної поведінки у вже
+   підготовленому worktree.
+
+LLM не видаляє refs, не створює worktree, не push-ить і не відкриває PR.
+
+## Інваріанти
+
+- База — тільки свіжий `origin/main`.
+- Живі worktree та гілки відкритих PR — protected.
+- Стара дата або великий divergence не означають, що зміна непотрібна.
+- `ours`/`theirs` не застосовуються всліпу: конфлікт розв'язується за
+  поведінкою й підтверджується тестом.
+- За невизначеності джерело лишається `kept`; misleading ready PR не
+  створюється.
+- Cleanup виконує лише JS і тільки після inventory/PR-фази: видаляє точні refs,
+  уже merged/patch-equivalent, явно класифіковані як `drop` або повністю
+  перенесені в успішний PR.
+- Live worktree, open PR, `kept` і будь-яке джерело з проваленим перенесенням
+  не видаляються.
+- `git stash clear` заборонено; stash видаляється лише по одному після
+  підтвердженого перенесення і явного cleanup-запиту.
+
+## Результат
+
+Оркестратор повертає для кожного джерела один verdict: `merged`,
+`patch-equivalent`, `open-pr`, `protected`, `pr-created`, `kept`,
+`drop-recommended` або `failed`. Для `pr-created` додає URL, перенесені коміти,
+конфлікти та виконані перевірки.

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

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/skills/git-reconcile/js
+resource: npm/skills/git-reconcile/js/
+---
+
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
+| [orchestrate.mjs](orchestrate.md) | JS Module |

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

@@ -0,0 +1,33 @@
+---
+type: JS Module
+title: orchestrate.mjs
+resource: npm/skills/git-reconcile/js/orchestrate.mjs
+docgen:
+  crc: f9dd9d0d
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 55
+  issues: no-overview,short-behavior,best-of-2:retry-lost
+---
+
+## Публічний API
+
+- parseWorktrees — Парсить `git worktree list --porcelain` у branch→path.
+- dedupeRefs — Дедуплікує local/remote refs одного commit: remote має пріоритет, але
+worktree-protection локального ref переноситься у запис.
+- conflictFiles — Витягає конфліктні файли з `git merge-tree`.
+- inventoryRepository — Збирає детермінований Git inventory. Нічого не видаляє і не змінює у
+checkout, крім оновлення remote refs через fetch --prune.
+- buildTriagePrompt — Формує bounded semantic-triage prompt. Git-факти вже пораховані JS; модель
+не виконує shell-команди й повертає лише JSON-рішення.
+- parseDecisionEnvelope — Витягає JSON object із чистої або fenced відповіді.
+- callRunner — Викликає вибраний LLM runner для одного bounded-завдання.
+- branchSlug — Перетворює довільний title/ref на branch slug.
+- formatReport — Формує deterministic report.
+- runGitReconcileOrchestrator — JS-оркестратор: inventory → bounded LLM triage → deterministic PR pipeline.
+Нічого не видаляє; `drop` є лише рекомендацією у звіті.
+
+## Гарантії поведінки
+
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
+- Кешує результати в межах одного прогону.