@7n/rules 1.49.24 → 1.49.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.49.25] - 2026-07-27
+
+### Fixed
+
+- Збережено --path scope у doc-files fixer
+
 ## [1.49.24] - 2026-07-27
 
 ### Changed

package/package.json

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

package/rules/doc-files/check/docs/fix-worker.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-worker.mjs
 resource: npm/rules/doc-files/check/fix-worker.mjs
 docgen:
-  crc: 452ab360
+  crc: 444c817d
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98
@@ -18,7 +18,7 @@ docgen:
 ## Поведінка
 
 1. Викликається `fixWorker`.
-2. Скануються файли для визначення застарілих документів (рукописні доки без docgen-frontmatter — не цілі).
+2. З порушень, знайдених detector-ом, відновлюються повні цілі застарілих документів; fixer не робить нового повного обходу checkout. Тому hook і `lint doc-files --path` генерують docs лише для власного explicit scope (рукописні доки без docgen-frontmatter — не цілі).
 3. Якщо знайдені застарілі документи, кожна цільова дока реєструється durable через `ctx.recordDurableWrite` (fallback — `ctx.recordWrite`), а потім запускається генерація батчу через `runGenerationBatch`.
 4. Батч отримує м'який дедлайн — 80% від `ctx.timeoutMs` рунга: генерація сама зупиняється до backstop-таймауту, повертає частковий прогрес штатно й не лишає фонового батчу поверх наступного rung-а. Дедлайн діє і всередині файлу: `generateDoc` ріже per-call LLM-таймаути під залишок бюджету, тож навіть перший файл, що не вкладається у рунг, обривається сам (transient), а не по backstop-таймеру runner-а.
 5. Фільтруються порушення, що стосуються сирітських документів (вихідні файли видалені); pre-image кожного реєструється у `ctx.recordWrite`.

package/rules/doc-files/check/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/check/main.mjs
 docgen:
-  crc: dd3f8c2a
+  crc: b5921123
 ---
 
 ## Огляд
@@ -12,7 +12,7 @@ Lint-детектор doc-files: знаходить застарілі файл
 
 ## Поведінка
 
-`lint(ctx)` збирає застарілі доки через `collectStale` (для конкретного набору змінених файлів або, якщо файлів не передано, повним скануванням дерева) і додає для кожної окреме порушення з причиною (`missing`/`crc-mismatch`/`degraded`) та шляхом джерела. Окремо сканує `docs/`-теки на сирітські доки (`scanOrphanedDocs`) — джерело яких більше не існує.
+`lint(ctx)` збирає застарілі доки через `collectStale` (для конкретного набору змінених файлів або, якщо файлів не передано, повним скануванням дерева) і додає для кожної окреме порушення з причиною (`missing`/`crc-mismatch`/`degraded`) та шляхом джерела. Сирітські доки (`scanOrphanedDocs`) перевіряються лише за повного repo-wide скану: explicit files від hook або `--path` не мають безпечної межі для такого обходу, тому не можуть зачіпати docs поза своїм scope.
 
 Реверс-мапінг: якщо серед змінених файлів трапляється сама `.md`-дока (а не її джерело), `sourceForDoc` шукає відповідний вихідний файл поруч (той самий basename, легальне розширення) і саме його передає далі в перевірку застарілості — так зміна доки теж тригерить звірку CRC її джерела.
 

package/rules/doc-files/check/fix-worker.mjs

@@ -24,16 +24,19 @@ const DEADLINE_FRACTION = 0.8
 /** @type {FixWorkerFn} */
 export async function fixWorker(violations, ctx) {
   const { cwd } = ctx
-  const { scanForDocFiles } = await import('../docgen-scan/main.mjs')
+  const { describeFile } = await import('../docgen-scan/main.mjs')
   const { runGenerationBatch, purgeOrphanedDocs } = await import('../docgen-files-batch/main.mjs')
 
   /** @type {string[]} */
   const touchedFiles = []
   const recordDoc = ctx.recordDurableWrite ?? ctx.recordWrite
 
-  // Re-scan дає повні target-обʼєкти {sourcePath, docPath, reason, …}, що їх потребує
-  // runGenerationBatch (violation несе лише file+docPath).
-  const stale = scanForDocFiles(cwd).filter(f => f.stale)
+  // Відновлюємо повні target-обʼєкти лише для порушень detector-а. Повний re-scan
+  // тут ігнорував би explicit files від hook/`lint --path` і генерував би docs
+  // для всього checkout.
+  const stale = [...new Set(violations.filter(v => v.reason !== 'orphaned-doc' && v.file).map(v => v.file))]
+    .map(sourcePath => describeFile(cwd, sourcePath))
+    .filter(f => f.stale)
   if (stale.length > 0) {
     for (const f of stale) {
       const docAbs = join(cwd, f.docPath)

package/rules/doc-files/check/main.mjs

@@ -86,14 +86,19 @@ export function lint(ctx) {
       })
     )
   }
-  for (const orphan of scanOrphanedDocs(cwd)) {
-    violations.push(
-      /** @type {Partial<import('../../../scripts/lib/lint-surface/types.mjs').LintViolation>} */ ({
-        reason: 'orphaned-doc',
-        message: `сирітський док (source видалено): ${orphan}`,
-        file: orphan
-      })
-    )
+  // Явний files-набір (hook/--path) не містить межі дерева для безпечного
+  // orphan-скану. Повний скан тут порушив би scope і міг би видалити доки поза
+  // сервісом, тому orphan-cleanup лишається лише repo-wide прогоном.
+  if (files === undefined) {
+    for (const orphan of scanOrphanedDocs(cwd)) {
+      violations.push(
+        /** @type {Partial<import('../../../scripts/lib/lint-surface/types.mjs').LintViolation>} */ ({
+          reason: 'orphaned-doc',
+          message: `сирітський док (source видалено): ${orphan}`,
+          file: orphan
+        })
+      )
+    }
   }
 
   const unavailable = unavailableDocFilesPlugins(cwd)