@7n/rules 1.18.0 → 1.18.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.18.1] - 2026-07-18
+
+### Fixed
+
+- `resolveChangedBase` стійкий до stale-ref: merge-base рахується для обох кандидатів (`origin/main` і локальна `main`) і береться новіший (descendant) — у git-worktree застрягла локальна `main` більше не дає застарілу базу з фантомними «зміненими» файлами давно влитих PR (T0-фіксер створював фейкові change-фрагменти для незачеплених воркспейсів); фолбек на єдиний доступний ref офлайн/без remote збережено
+
 ## [1.18.0] - 2026-07-18
 
 ### Changed

package/package.json

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

package/scripts/lib/changed-files.mjs

@@ -47,21 +47,32 @@ function dropWorktreeCheckouts(paths) {
 
 /**
  * Визначає git base для scoped-перевірок без зовнішнього runtime-стану.
- * Пріоритет: локальна `main`, потім `origin/main`; якщо обидві відсутні,
- * повертає null і caller порівнює лише робоче дерево з HEAD.
- * Явний `baseRef` (CI: `--base origin/main` після fetch) вимикає каскад —
+ * Кандидати — `origin/main` і локальна `main`: рахуємо merge-base з HEAD для обох
+ * і беремо **новіший** (descendant) з двох. Це захищає від stale-ref з будь-якого
+ * боку: у git-worktree локальна `main` закріплена за іншим деревом і часто відстає
+ * (застаріла база → фантомні «змінені» файли з давно влитих PR), а без свіжого
+ * fetch може відставати вже `origin/main`. Якщо доступний лише один ref (офлайн,
+ * без remote) — його merge-base; якщо жодного — null, і caller порівнює лише
+ * робоче дерево з HEAD. Повернений sha завжди досяжний (це merge-base існуючого
+ * ref), тож fail-closed перевірка в `collectChangedFilesSince` не спрацює хибно.
+ * Явний `baseRef` (CI: `--base origin/main` після fetch) вимикає вибір —
  * merge-base рахується лише проти нього.
  * @param {string} [cwd] корінь репо
- * @param {string|null} [baseRef] явний ref бази замість каскаду main→origin/main
+ * @param {string|null} [baseRef] явний ref бази замість вибору origin/main|main
  * @returns {string|null} merge-base commit або null
  */
 export function resolveChangedBase(cwd = process.cwd(), baseRef = null) {
-  for (const ref of baseRef ? [baseRef] : ['main', 'origin/main']) {
+  const mergeBaseWith = ref => {
     const result = spawnSync('git', ['merge-base', 'HEAD', ref], { cwd, encoding: 'utf8' })
-    const base = result.status === 0 && !result.error ? result.stdout.trim() : ''
-    if (base) return base
+    return result.status === 0 && !result.error ? result.stdout.trim() : ''
   }
-  return null
+  if (baseRef) return mergeBaseWith(baseRef) || null
+  const [primary, secondary] = ['origin/main', 'main'].map(ref => mergeBaseWith(ref)).filter(Boolean)
+  if (!primary || !secondary || primary === secondary) return primary ?? null
+  // Обидва ref-и дали різні merge-base: новіший — той, що є нащадком іншого.
+  // Якщо гілки merge-base розійшлися (екзотика), лишаємо пріоритет origin/main.
+  const ancestry = spawnSync('git', ['merge-base', '--is-ancestor', primary, secondary], { cwd })
+  return ancestry.status === 0 && !ancestry.error ? secondary : primary
 }
 
 /**

package/scripts/lib/docs/changed-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: changed-files.mjs
 resource: npm/scripts/lib/changed-files.mjs
 docgen:
-  crc: 254d852a
+  crc: 1c7d9027
   score: 100
 ---
 
@@ -19,8 +19,9 @@ collectChangedFilesSince Збирає змінені та незакомічен
 
 - collectChangedFiles: Збирає список змінених та невідстежених файлів з робочого дерева відносно робочого дерева.
 - resolveChangedBase: Визначає базовий комміт для обмежених перевірок без використання зовнішнього стану.
-  - Пріоритет: локальна `main`, потім `origin/main`; явний другий аргумент `baseRef` (CI: `--base origin/main`) вимикає каскад — merge-base рахується лише проти нього.
-  - Якщо ref-и відсутні, повертає null, і викликаючий порівнює лише робоче дерево з HEAD.
+  - Кандидати — `origin/main` і локальна `main`: merge-base з HEAD рахується для обох, береться новіший (descendant). Це захищає від stale-ref: у git-worktree локальна `main` часто відстає, без свіжого fetch може відставати `origin/main`.
+  - Явний другий аргумент `baseRef` (CI: `--base origin/main`) вимикає вибір — merge-base рахується лише проти нього.
+  - Якщо доступний лише один ref (офлайн/без remote) — його merge-base; якщо ref-и відсутні, повертає null, і викликаючий порівнює лише робоче дерево з HEAD.
 - collectChangedFilesSince: Збирає список змінених та невідстежених файлів відносно базового комміту.
 - git diff <base>: Порівнює комміт `base` з поточним робочим деревом (включаючи закомічені та незакомічені модифікації).
   - Якщо `base` відсутній, використовується `collectChangedFiles`.