@7n/rules 1.48.1 → 1.49.0

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` є лише рекомендацією у звіті.
+
+## Гарантії поведінки
+
+- Власних операцій запису (ФС/БД) у файлі немає; виклики імпортованих модулів можуть писати.
+- Кешує результати в межах одного прогону.