@7n/test 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.12.1] - 2026-07-04
+
+### Changed
+
+- test(core): моки node:fs під vitest-shim і актуалізація shouldDedup-очікування
+
 ## [0.12.0] - 2026-07-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",

package/src/docs/fix-tests.md

@@ -3,30 +3,33 @@ type: JS Module
 title: fix-tests.mjs
 resource: npm/src/fix-tests.mjs
 docgen:
-  crc: f198a4b3
+  crc: f82de3c4
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
+  tier: local-min-retry
+  score: 90
+  issues: internal-name:callText,judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
 ## Огляд
 
-Цей модуль виявляє падаючі юніт-тести, запускаючи `vitest run --reporter=json` для збору помилок з конфігураційного файлу `results.json`. Подалі, він ітерує через виявлені файли, використовуючи текстовий режим pi SDK для отримання виправленого коду, який записується напряму, повторюючи спроби до досягнення `MAX_FIX_ATTEMPTS`. Процес реалізований з механізмом перехоплення помилок (`fail-safe`), щоб не кидати винятків.
+Виявляє падаючі unit-тести та автоматично їх виправляє з використанням pi SDK (text mode). Процес починається з запуску `vitest run --reporter=json` за допомогою `getFailingTests`, що створює перелік файлів з помилками. Потім функція `fixFailingTests` для кожного файлу читає його вміст та вміст відповідного source-файлу. Використовуючи `callText`, інструмент отримує виправлений код, який потім записується напряму через `writeFileSync` у тест-файл, що усуває проблеми точного матчу рядків, характерні для Edit-інструментів. Всі операції спираються на конфігурацію, описану в `results.json`.
 
 ## Поведінка
 
 Поведінка:
-getFailingTests виявляє падаючі юніт-тести, запускаючи vitest у JSON-режимі та повертаючи список цих файлів разом з повідомленнями про помилки.
-buildFixTestsPrompt створює деталізований текстовий промпт, що містить поточний вміст падаючих тест-файлів та відповідні вихідні файли, для інструмента LLM.
-fixFailingTests ітерує через падаючі тести, отримує виправлення від LLM за допомогою текстового режиму pi SDK та записує оновлений код напряму у відповідні файли, повторюючи спроби до MAX_FIX_ATTEMPTS.
+getFailingTests запускає vitest у JSON-режимі та повертає список падаючих тест-файлів з повідомленнями про помилки.
+buildFixTestsPrompt створює повний текстовий промпт для LLM, що містить вміст падаючих тест-файлів та їхні помилки.
+buildFixTestsBatch розподіляє падаючі тест-файли на батчі для LLM, враховуючи обмеження промпту.
+fixFailingTests ітерує по падаючих тестах, викликаючи LLM для виправлень та записує виправлений код безпосередньо у файли.
 
 ## Публічний API
 
-- getFailingTests — Виконує тестування за допомогою Vitest у форматі JSON і повертає файли тестів з помилками, що не пройшли.
-- buildFixTestsPrompt — Створює спеціальне повідомлення (prompt) для виправлення одного файлу, що не пройшов тест, включаючи вміст поточного файлу.
-- fixFailingTests — Знаходить та виправляє помилкові тести, використовуючи текстовий режим SDK pi та пряме записування файлів.
+getFailingTests — Виконує тестування у JSON-форматі та надає список файлів із проваленими тестами разом із повідомленнями про помилки.
+buildFixTestsPrompt — Створює запит для ШІ з вмістом одного файлу із проваленим тестом, щоб ШІ міг відновити його, не звертаючись до файлової системи.
+buildFixTestsBatch — Групує файли для виправлення відповідно до заданого обсягу. Менші файли потрапляють у основну групу, а більші — у резерв на подальший прохід. Файл, який сам по собі перевищує обсяг, завжди отримує окремий запит з обрізанням.
+fixFailingTests — Визначає та виправляє провалених тестів, використовуючи можливості pi SDK для роботи з текстом та прямий запис у файли. Якщо всі тести вже проходять, він повертається одразу з кількістю 0.
 
 ## Гарантії поведінки
 
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- (специфічних машинно-виведених гарантій немає)

package/src/docs/gen-tests.md

@@ -3,7 +3,7 @@ type: JS Module
 title: gen-tests.mjs
 resource: npm/src/gen-tests.mjs
 docgen:
-  crc: 531f870e
+  crc: 0d24dc95
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/src/fix-tests.mjs

@@ -352,7 +352,9 @@ export async function fixFailingTests(dir, opts = {}) {
 
     const batch = buildFixTestsBatch(eligible, dir)
     if (batch.deferred.length) {
-      console.log(`  📦 батч: ${batch.included.length} файлів, відкладено на наступний прохід: ${batch.deferred.length}`)
+      console.log(
+        `  📦 батч: ${batch.included.length} файлів, відкладено на наступний прохід: ${batch.deferred.length}`
+      )
     }
     for (const file of batch.included) attempts.set(file, (attempts.get(file) ?? 0) + 1)
     prevDeferred = new Set(batch.deferred)
@@ -376,7 +378,11 @@ export async function fixFailingTests(dir, opts = {}) {
     }
 
     const includedSet = new Set(batch.included)
-    writeFixedFiles(fixed, eligible.filter(f => includedSet.has(f.file)), dir)
+    writeFixedFiles(
+      fixed,
+      eligible.filter(f => includedSet.has(f.file)),
+      dir
+    )
 
     remaining = await getFailingTests(dir)
   }

package/src/gen-tests.mjs

@@ -1182,7 +1182,9 @@ export async function generateTests(files, dir, opts = {}) {
 
   const callTextFn = opts.callText ?? callText
   const localModel = resolveLocalModel(opts)
-  const localFn = localModel ? (prompt, opts = {}) => callTextFn(prompt, { ...opts, model: localModel, cwd: dir }) : null
+  const localFn = localModel
+    ? (prompt, opts = {}) => callTextFn(prompt, { ...opts, model: localModel, cwd: dir })
+    : null
 
   const mode = localFn ? `per-export (local:${localModel} + cloud)` : 'single-file (cloud)'
   console.log(`\n🤖 Генерую тести для ${files.length} файлів [${mode}]...\n`)

package/src/lib/docs/index.md

@@ -10,5 +10,6 @@ resource: npm/src/lib/
 | ------------------------------------- | --------- |
 | [ast-analyze.mjs](ast-analyze.md)     | JS Module |
 | [pi-client.mjs](pi-client.md)         | JS Module |
+| [prompt-budget.mjs](prompt-budget.md) | JS Module |
 | [runtime-probe.mjs](runtime-probe.md) | JS Module |
 | [vitest-shim.mjs](vitest-shim.md)     | JS Module |

package/src/lib/docs/pi-client.md

@@ -3,7 +3,7 @@ type: JS Module
 title: pi-client.mjs
 resource: npm/src/lib/pi-client.mjs
 docgen:
-  crc: 0aa22b9a
+  crc: e7f3471e
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/src/lib/docs/prompt-budget.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: prompt-budget.mjs
+resource: npm/src/lib/prompt-budget.mjs
+docgen:
+  crc: 010265bd
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Слугує єдиною точкою правди для визначення ліміту символів промпту та стелі відповіді (`maxTokens`) залежно від типу задачі (наприклад, `gen-tests`, `fix-tests`). Це механізм захисту від надмірного розширення промпту. Надає функції для внутрішнього обрізання тексту (`fitToBudget`), що виключає низькопріоритетні частини промпту, щоб він вмістився у встановлений ліміт, а також для ефективного групування цілих одиниць вмісту (`packBatch`) для подальшої пакетної обробки.
+
+## Поведінка
+
+Поведінка
+budgetFor повертає встановлений ліміт символів для промпту та максимальну кількість токенів для заданого типу LLM-задачі.
+capText обрізає вхідний текст до заданого максимального розміру, зберігаючи його структуру з головною та хвостовою частинами, розділеними маркером.
+fitToBudget збирає частини промпту, обрізаючи або відкидаючи нижчопріоритетні частини доти, доки сумарний обсяг не вкладеться у заданий ліміт символів, при цьому найвищий пріоритет завжди захищено.
+packBatch групує одиниці (файли) у батчи, сортуючи їх за розміром, щоб вмістити якомога більше у межах заданого бюджету; одиниці, що не вмістилися, відкладаються для наступного проходу.
+
+## Публічний API
+
+budgetFor — надає бюджет, необхідний для певної категорії завдання.
+capText — безпечно укорочує текст, зберігаючи його початок, маркер та кінець.
+fitToBudget — розміщує блоки у межах заданого бюджету: спочатку зменшує вміст, а потім відкидає найнижчі за пріоритетом, поки обсяг не втиснеться. Найважливіший елемент завжди залишається повним.
+packBatch — згруповує файли для обробки: спочатку обирає найменші для оптимізації кількості виправлень за один раз. Якщо елемент занадто великий, він відкладається для окремої обробки, де застосовується жорсткіше обрізання.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/lib/prompt-budget.mjs

@@ -96,7 +96,13 @@ export function fitToBudget(chunks, maxChars) {
     dropped.push(`${part.label} (видалено)`)
   }
 
-  return { text: parts.filter(p => p.kept).map(p => p.out).join('\n'), dropped }
+  return {
+    text: parts
+      .filter(p => p.kept)
+      .map(p => p.out)
+      .join('\n'),
+    dropped
+  }
 }
 
 /**