[vitaliytv]

Summary

• Відкриває клас exec-tool fix у wasm-міграції (реєстр §2.63, поправка §2.51): фіксер, який виконує зовнішній процес, що сам мутує файли на диску.
• Рішення власника — host-diff: run_wasm_concern_fix (crates/rules-napi/src/lib.rs) сам знімає знімок файлів повного glob-у концерну ДО й ПІСЛЯ виклику fix() і синтезує Write/Delete-edits із різниці (diff_snapshot_edits) — без зміни WIT, гість нічого не декларує (fail-open інакше не був би виявлений).
• Пілот — python/ruff (fix_ruff, crates/plugin-lang-python/src/lib.rs): точний порт fix-ruff.mjs (uv run --frozen ruff check --fix . + ruff format .), повертає порожній план — синтез повністю на хості. JS-канон НЕ видалено (парність, не заміна).

§2.51 — перевірка розбору (за проханням автора задачі)

Обидва пункти §2.51 підтверджено НЕ структурними блокерами:

• Перешкода 1 (продакшн-міст не доносить файлів) — уже знята PR feat(rules-napi): дельта запиту у fix-контурі — рішення (б) відкритого питання #517 #519/§2.53 (delta_files).
• Перешкода 2 (rollback-контракт) — хибна засновка. T0-фаза (fixConcernCore/runT0Phase, npm/scripts/lib/lint-surface/run-fix.mjs) передає lintCtx без recordWrite для ВСІХ T0-фіксерів (декларативних теж) — модульний доккомент прямо документує «T0 — permanent, поза rollback». Справжня перешкода була вужчою: FixPlan::edits лишався порожнім, попри реальну мутацію диска — саме це ламало wasmFixPattern-гейт (edits.length > 0) і guestFix-пріоритет, не rollback.

Деталі, код-цитати й повний розбір — реєстр docs/plans/2026-08-05-open-questions-register.md §2.63.

Скоуп діфу — свідомий вибір

Знімок бере весь glob концерну (contribution.glob, напр. **/*.py), а НЕ лише request.files/delta_files. ruff check --fix . мутує весь cwd, не обмежується дельтою запиту — скоуп «лише дельта» був би дешевшим, але тихо пропустив би мутації поза нею (принцип проекту: «гучно й повільніше, ніж тихо й швидше»). Ціна: подвійне читання glob-у на кожен fix()-виклик, для ВСІХ wasm-концернів (інфраструктура спільна). Межа: якщо концерн не задекларований у describe().concerns, діф пропускається (без регресії, без нового захисту).

Test plan

• cargo test -p rules-napi — 13/13 (без регресій)
• cargo test -p plugin-lang-python — 69/69 (без регресій)
• Новий npm/scripts/lib/lint-surface/tests/wasm-fix-exec-tool-python-ruff.test.mjs (3 активних + 1 чесно пропущений — немає uv/ruff у CI-середовищі):
  • runWasmConcernFix напряму (РЕАЛЬНИЙ napi-міст) на фейковому uv — план непорожній, несе write-edit саме на цільовий файл;
  • python/doc_comments (декларативний) — регресія: host-diff нічого не додає;
  • runFixPipeline (повний продакшн-конвеєр) — лічильник спавнів фейкового uv = точно 5, доводить відсутність double-run;
  • живий смок на справжньому uv/ruff (skip з console.warn, якщо тулів немає).
• Червоність доведена дією: тести 1 і 3 запущені на коді ДО фіксу (git stash + перезбірка гостя) — обидва падали (plan.edits.length === 0, code !== 0); після stash pop — зелені.
• Регресія wasm-fix-контуру: wasm-plugin-parity.test.mjs (267), wasm-plugin-parity-python.test.mjs, wasm-fix-e2e.test.mjs, fix-delta-files.test.mjs, run-fix.test.mjs — 231 додатково, усі проходять без змін (декларативні фіксери типу js/doc_comments поводяться байт-у-байт як раніше).
• cargo build --workspace --release — чисто.

🤖 Generated with Claude Code