@nitra/cursor 1.8.201 → 1.8.203

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.203] - 2026-05-07
+
+### Changed
+
+- `check-k8s.mjs` (автоконверт `image-replace` patches → `images:`): тепер працює і для `patches[i].patch` із **кількома** ops, а не лише з одинокою image-replace op. Сканує всі ops у патчі, конвертує **кожну** `op: replace` на `/spec/template/spec/containers/<N>/image` (target `kind: Deployment`) у запис `images:`; якщо всі ops патча конвертовано — `patches[i]` видаляється повністю; інакше inline `patch:` переписується через `parseDocument` без конвертованих ops зі збереженням block-literal scalar (`|-`) і вихідного порядку решти ops. Реалізовано через нові функції `tryParseJson6902Array` (≥ 1 op, замість `tryParseSingleJson6902Array`) і `rewriteInlinePatchWithoutOps`; `imageReplaceDeploymentPatchInfo` повертає `{ deployName, totalOps, ops: [{ containerIndex, newImage, opIndex }] }` (раніше — одиничний `{ deployName, containerIndex, newImage }` лише за `length === 1`); `applyConversionsToDoc` групує конвертації по індексу патча й вирізає ops або сам патч за потреби. Сортування решти ops після видалення лишається поза цією зміною — за нього відповідає окрема перевірка `kustomizationInlinePatchOpsSortedViolation`.
+- `mdc/k8s.mdc` (v1.26 → v1.27): уточнено крок 1 авто-перевірки в розділі «Зміна image — через `images:`, не через `patches[]`» — тепер описує і випадок, коли в `patches[i].patch` лишаються не-image ops (їх зберігає, у вихідному порядку, без коментарів).
+- `check-js-lint.mjs` + `mdc/js-lint.mdc` (v1.16 → v1.17): мінімум `@nitra/eslint-config` піднято з `^3.8.0` до `^3.9.2`. Обґрунтування: з 3.9.2 у `getConfig` вбудовано ignore для `**/adr/**`, тож ADR-документи не валідуються ESLint, і консьюмерам не треба додавати цей glob у `eslint.config.js` локально. `nitraEslintConfigMeetsMinVersion` тепер повертає `false` для діапазонів `^3.8.x`–`^3.9.1`; `workspace:*` лишається ok без змін. Pass/fail-повідомлення `checkPackageJsonLintDeps` оновлено під новий мінімум; `for...in`-бан з 3.8.0 згадується як накопичена відмінність. Тести `nitraEslintConfigMeetsMinVersion` розширено: `^3.9.2`/`^3.9.10`/`^3.10.0`/`^4.0.0` — ok; `^3.9.1`/`^3.8.0`/`^3.6.12`/`^3.4.3` — ні.
+- `bin/n-cursor.js` (`reexecIfPackageVersionChanged` + `spawnSync`-виклик): `process.env.NITRA_CURSOR_REEXEC` і `...process.env` замінено на `env.NITRA_CURSOR_REEXEC` і `...env` з `node:process` (`import { cwd, env } from 'node:process'`). Підстава: правило `js-run.mdc` забороняє прямий `process.env.*` у Node-коді; `NITRA_CURSOR_REEXEC` — опційна змінна (виставляється лише при re-exec), тож імпорт `env` з `node:process` (а не з `@nitra/check-env`) — канонічна форма для опційних. Поведінка не змінена; раніше `npm/scripts/check-js-run.mjs` помилявся на `bin/n-cursor.js:1136` (правило `process-env`), тепер intergation-test `check-* на реальному репозиторії` проходить.
+
+### Added
+
+- `tests/check-k8s-images.test.mjs`: нова форма `imageReplaceDeploymentPatchInfo` (`ops`/`totalOps`/`opIndex`); e2e-тести на multi-op patch (image + `add nodeSelector`), три не-image ops + image у hasura-стилі (`add containers/-` + `add volumes` + `replace nodeSelector`), multi-image patch (containers/0 + containers/1 → обидва конвертовано, патч видаляється), mixed patch з digest у одному з image-values (звичайний tag конвертовано, digest op лишається у патчі) і одиничний digest-image (повертає `errors`, патч на диску не змінюється).
+
+## [1.8.202] - 2026-05-07
+
+### Added
+
+- `bin/n-cursor.js`: новий хелпер `reexecIfPackageVersionChanged(effectivePackageRoot)` і його виклик у `runSync` одразу після `upgradeNitraCursorToLatestAndBunInstall`. Якщо self-upgrade встановив у `node_modules/@nitra/cursor` версію, відмінну від тієї, з якої стартував поточний процес (типово — npx-кеш), CLI спавнить `process.execPath <newBin> <args…>` через `spawnSync` (`stdio: 'inherit'`), додає в env `NITRA_CURSOR_REEXEC=1` і завершується з exit-кодом дочірнього процесу. Обґрунтування: ES-модулі (`RULE_MIGRATIONS`, `detectAutoRulesAndSkills`, списки правил) уже завантажені у V8 і нова логіка з-під свіжо встановленого пакета без re-exec невидима для поточного запуску — `import()` не вирішує цього, бо процес виконується з `bin/` у npx-кеші, а не з `node_modules/`. Захист від нескінченного циклу — раннє повернення при `process.env.NITRA_CURSOR_REEXEC === '1'`; додатково нічого не робить, якщо `effectivePackageRoot === BUNDLED_PACKAGE_ROOT` (реального апгрейду не сталося), якщо `version` не вдалося прочитати з обох `package.json`, або якщо у новому корені відсутній `bin/n-cursor.js`. `runChecks` свідомо не патчиться — він не виконує self-upgrade, тож версія процесу і пакета там завжди узгоджені. Імпорт `spawnSync` із `node:child_process` — єдина нова зовнішня залежність.
+
 ## [1.8.201] - 2026-05-07
 
 ### Changed

package/bin/n-cursor.js

@@ -49,10 +49,11 @@
  * `node_modules/@nitra/cursor`, якщо пакет з’явився після встановлення.
  */
 
+import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { mkdir, readdir, readFile, rename, rm, unlink, writeFile } from 'node:fs/promises'
 import { basename, dirname, join } from 'node:path'
-import { cwd } from 'node:process'
+import { cwd, env } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
 import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
@@ -1122,6 +1123,46 @@ async function readBundledVersionAt(packageRoot) {
   }
 }
 
+/**
+ * Якщо `upgradeNitraCursorToLatestAndBunInstall` встановив у `node_modules/@nitra/cursor` версію,
+ * відмінну від тієї, з якої стартував поточний процес (наприклад, з npx-кешу), запускає бінар нової
+ * версії через `spawnSync` і завершує поточний процес із успадкованим exit-кодом. Re-exec потрібен,
+ * бо ES-модулі вже завантажені у V8 (RULE_MIGRATIONS, detectAutoRulesAndSkills тощо) і нова логіка
+ * без повної заміни процесу не підхопиться. Захист від нескінченного циклу — env `NITRA_CURSOR_REEXEC=1`.
+ * @param {string} effectivePackageRoot шлях, повернутий `upgradeNitraCursorToLatestAndBunInstall`
+ * @returns {Promise<void>} повертається лише якщо re-exec не потрібен (інакше викликає `process.exit`)
+ */
+async function reexecIfPackageVersionChanged(effectivePackageRoot) {
+  if (env.NITRA_CURSOR_REEXEC === '1') {
+    return
+  }
+  if (effectivePackageRoot === BUNDLED_PACKAGE_ROOT) {
+    return
+  }
+  const currentVersion = await readBundledVersionAt(BUNDLED_PACKAGE_ROOT)
+  const installedVersion = await readBundledVersionAt(effectivePackageRoot)
+  if (!currentVersion || !installedVersion || currentVersion === installedVersion) {
+    return
+  }
+  const newBinPath = join(effectivePackageRoot, 'bin', 'n-cursor.js')
+  if (!existsSync(newBinPath)) {
+    return
+  }
+  console.log(
+    `🔁 Перезапуск ${PACKAGE_NAME}: процес стартував на ${currentVersion}, ` +
+      `після self-upgrade встановлено ${installedVersion}.\n` +
+      `   Re-exec свіжого бінаря, щоб підхопити нову логіку (RULE_MIGRATIONS, auto-detect тощо).\n`
+  )
+  const result = spawnSync(process.execPath, [newBinPath, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: { ...env, NITRA_CURSOR_REEXEC: '1' }
+  })
+  if (result.error) {
+    throw result.error
+  }
+  process.exit(typeof result.status === 'number' ? result.status : 1)
+}
+
 /**
  * Копіює правила з каталогу `mdc/` установленого пакету та синхронізує `.cursor/rules`
  * @returns {Promise<void>}
@@ -1134,6 +1175,8 @@ async function runSync() {
     upgradeNitraCursorToLatestAndBunInstall(projectRoot, BUNDLED_PACKAGE_ROOT)
   )
 
+  await reexecIfPackageVersionChanged(effectivePackageRoot)
+
   const bundledMdcDir = join(effectivePackageRoot, 'mdc')
   const bundledSkillsDir = join(effectivePackageRoot, 'skills')
   const bundledAgentsTemplatePath = join(effectivePackageRoot, AGENTS_TEMPLATE_FILE)

package/mdc/js-lint.mdc

@@ -1,10 +1,10 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.16'
+version: '1.17'
 ---
 
-**oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config` мінімум `^3.8.0`** (з цієї версії правило `no-restricted-syntax` забороняє `for...in`; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
+**oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config` мінімум `^3.9.2`** (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
 
 ```json title=".vscode/extensions.json"
 {
@@ -25,7 +25,7 @@ version: '1.16'
     "lint-js": "bunx oxlint --fix && bunx eslint --fix . && bunx jscpd ."
   },
   "devDependencies": {
-    "@nitra/eslint-config": "^3.8.0"
+    "@nitra/eslint-config": "^3.9.2"
   }
 }
 ```

package/mdc/k8s.mdc

@@ -1,6 +1,6 @@
 ---
 description: K8s YAML — $schema (yaml-language-server); lint-k8s (kubeconform, kubescape); check-k8s
-version: '1.26'
+version: '1.27'
 globs: "**/k8s/**/*.yaml"
 alwaysApply: false
 ---
@@ -318,7 +318,7 @@ images:
 
 **`check k8s` автоматично** для кожного `kustomization.yaml`:
 
-1. конвертує JSON6902-патч `op: replace` на `/spec/template/spec/containers/<N>/image` (target `kind: Deployment`) у запис `images:` (резолвить оригінальний image у base через `resources:` / `bases` / `components` / `crds`); якщо в `patches[]` залишається лише ця операція — патч прибирається повністю;
+1. конвертує кожну JSON6902-операцію `op: replace` на `/spec/template/spec/containers/<N>/image` (target `kind: Deployment`) у запис `images:` (резолвить оригінальний image у base через `resources:` / `bases` / `components` / `crds`). Якщо у `patches[i].patch` після конвертації не залишилось ops — патч прибирається повністю; інакше у `patches[i].patch` залишаються лише не-image ops у вихідному порядку;
 2. чистить існуючий блок `images:` — зрізає `:tag` з `name` і видаляє `newTag`, який збігається з відрізаним тегом.
 
 ## Ingress → Gateway API (GKE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.201",
+  "version": "1.8.203",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/check-js-lint.mjs

@@ -4,8 +4,9 @@
  * Канонічний `lint-js`, flat ESLint з getConfig і ignore для auto-imports, рекомендації VSCode,
  * `.oxlintrc.json` має збігатися з каноном oxlint у пакеті (`npm/scripts/utils/oxlint-canonical.json`):
  * plugins, jsPlugins, categories, усі правила з канону (додаткові записи в `rules` дозволені), settings, env,
- * globals, ignorePatterns. `@nitra/eslint-config` у devDependencies мінімум **3.8.0** (з цієї версії
- * правило `no-restricted-syntax` для `ForInStatement` забороняє `for...in`; також тягне транзитивний
+ * globals, ignorePatterns. `@nitra/eslint-config` у devDependencies мінімум **3.9.2** (з 3.8.0 правило
+ * `no-restricted-syntax` для `ForInStatement` забороняє `for...in`; з 3.9.2 у `getConfig` вбудовано
+ * ignore для ADR-каталогів — локально цей glob додавати не потрібно; також тягне транзитивний
  * `@e18e/eslint-plugin` для oxlint), `.jscpd.json` (gitignore, exitCode, reporters, minLines), workflow
  * `lint-js.yml` (checkout@v6, setup-bun-deps, bunx без --fix), без prettier, `engines.node` >= 24,
  * `engines.bun` >= 1.3, `"type": "module"` у кореневому і всіх workspace `package.json`. Дубль перевірки JS у `lint.yml` — заборонено.
@@ -54,10 +55,11 @@ export function isCanonicalLintJs(script) {
 }
 
 /**
- * Чи діапазон `@nitra/eslint-config` у `package.json` задовольняє мінімум `>= 3.8.0`
- * (заборона `for...in` через `no-restricted-syntax` + транзитивний `@e18e/eslint-plugin` для oxlint).
+ * Чи діапазон `@nitra/eslint-config` у `package.json` задовольняє мінімум `>= 3.9.2`
+ * (заборона `for...in` через `no-restricted-syntax` з 3.8.0 + вбудований ignore для ADR-каталогів
+ * у `getConfig` з 3.9.2 + транзитивний `@e18e/eslint-plugin` для oxlint).
  * @param {unknown} versionSpec значення `devDependencies['@nitra/eslint-config']`
- * @returns {boolean} true для `workspace:*` або першої semver у рядку >= 3.8.0
+ * @returns {boolean} true для `workspace:*` або першої semver у рядку >= 3.9.2
  */
 export function nitraEslintConfigMeetsMinVersion(versionSpec) {
   const s = String(versionSpec).trim()
@@ -72,7 +74,7 @@ export function nitraEslintConfigMeetsMinVersion(versionSpec) {
   if ([major, minor, patch].some(n => Number.isNaN(n))) {
     return false
   }
-  return major > 3 || (major === 3 && minor >= 8 && patch >= 0)
+  return major > 3 || (major === 3 && (minor > 9 || (minor === 9 && patch >= 2)))
 }
 
 /**
@@ -269,11 +271,11 @@ function checkPackageJsonLintDeps(pkg, passFn, failFn) {
     passFn('@nitra/eslint-config є в devDependencies')
     if (nitraEslintConfigMeetsMinVersion(nitraEslint)) {
       passFn(
-        '@nitra/eslint-config: мінімум 3.8.0 (no-restricted-syntax для ForInStatement + @e18e/eslint-plugin транзитивно, js-lint.mdc)'
+        '@nitra/eslint-config: мінімум 3.9.2 (no-restricted-syntax для ForInStatement з 3.8.0 + вбудований ignore "**/adr/**" з 3.9.2 + @e18e/eslint-plugin транзитивно, js-lint.mdc)'
       )
     } else {
       failFn(
-        '@nitra/eslint-config: онови до мінімум "^3.8.0" — з цієї версії правило no-restricted-syntax забороняє for...in (плюс транзитивний @e18e/eslint-plugin для oxlint, js-lint.mdc)'
+        '@nitra/eslint-config: онови до мінімум "^3.9.2" — з 3.9.2 у getConfig вбудовано ignore для "**/adr/**" (ADR-документи не валідуються), плюс транзитивний @e18e/eslint-plugin для oxlint і заборона for...in з 3.8.0 (js-lint.mdc)'
       )
     }
   } else {

package/scripts/check-k8s.mjs

@@ -5626,10 +5626,14 @@ function applyNameStripTag(originalLine, parsed) {
 const KUSTOMIZATION_DEPLOYMENT_CONTAINER_IMAGE_PATH_RE = /^\/spec\/template\/spec\/containers\/(\d+)\/image$/u
 
 /**
- * Якщо `patchObj` — JSON6902 з єдиною операцією `replace` на шляху image-контейнера у `Deployment`,
- * повертає `{ deployName, containerIndex, newImage }`. Інакше null.
+ * Якщо `patchObj` — JSON6902 для `kind: Deployment`, повертає всі image-replace ops
+ * у його `patch:` разом із `opIndex` (позиція в масиві ops) і `totalOps` (загальна довжина).
  * @param {unknown} patchObj елемент масиву `patches[]`
- * @returns {{ deployName: string, containerIndex: number, newImage: string } | null} інформація про патч або null, якщо це не очікувана JSON6902-операція
+ * @returns {{
+ *   deployName: string,
+ *   totalOps: number,
+ *   ops: Array<{ containerIndex: number, newImage: string, opIndex: number }>
+ * } | null} інформація про image-replace ops у патчі або null
  */
 export function imageReplaceDeploymentPatchInfo(patchObj) {
   const pr = asPlainObject(patchObj)
@@ -5638,20 +5642,21 @@ export function imageReplaceDeploymentPatchInfo(patchObj) {
   if (deployName === null) return null
   if (typeof pr.patch !== 'string') return null
 
-  const parsedArr = tryParseSingleJson6902Array(pr.patch)
+  const parsedArr = tryParseJson6902Array(pr.patch)
   if (parsedArr === null) return null
-  const op = asPlainObject(parsedArr[0])
-  if (op === null) return null
 
-  const containerIndex = singleImageReplaceContainerIndex(op)
-  if (containerIndex === null) return null
-  if (typeof op.value !== 'string' || op.value.trim() === '') return null
-
-  return {
-    deployName,
-    containerIndex,
-    newImage: op.value.trim()
+  /** @type {Array<{ containerIndex: number, newImage: string, opIndex: number }>} */
+  const ops = []
+  for (let i = 0; i < parsedArr.length; i++) {
+    const op = asPlainObject(parsedArr[i])
+    if (op === null) continue
+    const containerIndex = singleImageReplaceContainerIndex(op)
+    if (containerIndex === null) continue
+    if (typeof op.value !== 'string' || op.value.trim() === '') continue
+    ops.push({ containerIndex, newImage: op.value.trim(), opIndex: i })
   }
+  if (ops.length === 0) return null
+  return { deployName, totalOps: parsedArr.length, ops }
 }
 
 /**
@@ -5679,11 +5684,11 @@ function deploymentTargetName(target) {
 }
 
 /**
- * Парсить `patch`-рядок як YAML-масив з рівно однією операцією JSON6902.
+ * Парсить `patch`-рядок як YAML-масив JSON6902-операцій (≥ 1 елемент).
  * @param {string} patch текст YAML-масиву JSON6902-операцій
- * @returns {unknown[] | null} масив однієї операції або null
+ * @returns {unknown[] | null} масив операцій або null
  */
-function tryParseSingleJson6902Array(patch) {
+function tryParseJson6902Array(patch) {
   let parsedArr
   try {
     for (const d of parseAllDocuments(patch.trim())) {
@@ -5697,7 +5702,7 @@ function tryParseSingleJson6902Array(patch) {
   } catch {
     return null
   }
-  return Array.isArray(parsedArr) && parsedArr.length === 1 ? parsedArr : null
+  return Array.isArray(parsedArr) && parsedArr.length >= 1 ? parsedArr : null
 }
 
 /**
@@ -5880,11 +5885,17 @@ export async function convertImagePatchesToImagesInKustomization(kustAbs, rootNo
 
 /**
  * Парсить kustomization.yaml як Document і повертає його разом зі списком кандидатів-патчів
- * (`patches[i]` що відповідає `image-replace` для Deployment). Повертає null, якщо документ не
- * розпарсився, не є Kustomization або не має масиву `patches:`.
+ * (по одному кандидату на кожну image-replace op у `patches[i].patch` — патч може містити кілька).
+ * Повертає null, якщо документ не розпарсився, не є Kustomization або не має масиву `patches:`.
  * @param {string} raw текст файлу
- * @returns {{ doc: ReturnType<typeof parseDocument>, candidates: Array<{ index: number, info: { deployName: string, containerIndex: number, newImage: string } }> } | null}
- *   document і список кандидатів, або null
+ * @returns {{
+ *   doc: ReturnType<typeof parseDocument>,
+ *   candidates: Array<{
+ *     index: number,
+ *     totalOps: number,
+ *     info: { deployName: string, containerIndex: number, newImage: string, opIndex: number }
+ *   }>
+ * } | null} document і список кандидатів, або null
  */
 function parseKustomizationWithPatches(raw) {
   let doc
@@ -5901,11 +5912,23 @@ function parseKustomizationWithPatches(raw) {
   if (typeof rec.apiVersion !== 'string' || !rec.apiVersion.startsWith(KUSTOMIZE_CONFIG_API_PREFIX)) return null
   if (!Array.isArray(rec.patches)) return null
 
-  /** @type {Array<{ index: number, info: { deployName: string, containerIndex: number, newImage: string } }>} */
+  /** @type {Array<{ index: number, totalOps: number, info: { deployName: string, containerIndex: number, newImage: string, opIndex: number } }>} */
   const candidates = []
   for (const [i, p] of rec.patches.entries()) {
     const info = imageReplaceDeploymentPatchInfo(p)
-    if (info !== null) candidates.push({ index: i, info })
+    if (info === null) continue
+    for (const op of info.ops) {
+      candidates.push({
+        index: i,
+        totalOps: info.totalOps,
+        info: {
+          deployName: info.deployName,
+          containerIndex: op.containerIndex,
+          newImage: op.newImage,
+          opIndex: op.opIndex
+        }
+      })
+    }
   }
   return { doc, candidates }
 }
@@ -5915,17 +5938,17 @@ function parseKustomizationWithPatches(raw) {
  * (або повідомлення про помилку, чому конвертація неможлива).
  * @param {string} kustAbs абсолютний шлях до kustomization.yaml
  * @param {string} rootNorm нормалізований корінь репо
- * @param {Array<{ index: number, info: { deployName: string, containerIndex: number, newImage: string } }>} candidates кандидати з `patches[]`
- * @returns {Promise<{ conversions: Array<{ index: number, name: string, newName: string, newTag: string | null }>, errors: string[] }>}
+ * @param {Array<{ index: number, totalOps: number, info: { deployName: string, containerIndex: number, newImage: string, opIndex: number } }>} candidates кандидати з `patches[]`
+ * @returns {Promise<{ conversions: Array<{ index: number, opIndex: number, totalOps: number, name: string, newName: string, newTag: string | null }>, errors: string[] }>}
  *   результати конвертації та зібрані нефатальні помилки
  */
 async function buildPatchToImageConversions(kustAbs, rootNorm, candidates) {
-  /** @type {Array<{ index: number, name: string, newName: string, newTag: string | null }>} */
+  /** @type {Array<{ index: number, opIndex: number, totalOps: number, name: string, newName: string, newTag: string | null }>} */
   const conversions = []
   /** @type {string[]} */
   const errors = []
 
-  for (const { index, info } of candidates) {
+  for (const { index, totalOps, info } of candidates) {
     const baseImage = await walkKustomizationForDeploymentImage(
       kustAbs,
       rootNorm,
@@ -5934,7 +5957,7 @@ async function buildPatchToImageConversions(kustAbs, rootNorm, candidates) {
       new Set()
     )
     const conversion = buildConversionForCandidate(index, info, baseImage, errors)
-    if (conversion !== null) conversions.push(conversion)
+    if (conversion !== null) conversions.push({ ...conversion, opIndex: info.opIndex, totalOps })
   }
 
   return { conversions, errors }
@@ -5944,7 +5967,7 @@ async function buildPatchToImageConversions(kustAbs, rootNorm, candidates) {
  * Будує одну конвертацію `patches[index]` → `images[]` запис з відповідним `newTag`.
  * Якщо щось не так (немає baseImage, digest у base/new) — додає текст у `errors` і повертає null.
  * @param {number} index індекс патча в `patches[]`
- * @param {{ deployName: string, containerIndex: number, newImage: string }} info результат `imageReplaceDeploymentPatchInfo`
+ * @param {{ deployName: string, containerIndex: number, newImage: string, opIndex: number }} info один із записів `imageReplaceDeploymentPatchInfo().ops` (плюс `deployName` патча)
  * @param {string | null} baseImage знайдений базовий image або null
  * @param {string[]} errors буфер нефатальних помилок (мутується)
  * @returns {{ index: number, name: string, newName: string, newTag: string | null } | null} запис конвертації або null
@@ -5975,19 +5998,43 @@ function buildConversionForCandidate(index, info, baseImage, errors) {
 }
 
 /**
- * Видаляє конвертовані елементи з `patches:` (за потреби — і сам ключ) і дописує `images:`.
+ * Застосовує конвертації до Document: для кожного `patches[i]` або видаляє патч цілком (коли всі
+ * його ops конвертовано), або переписує inline `patch:`, лишаючи решту ops без коментарів.
+ * Допише `images:` з усіма конвертованими записами.
  * @param {ReturnType<typeof parseDocument>} doc документ kustomization.yaml
- * @param {Array<{ index: number, name: string, newName: string, newTag: string | null }>} conversions конвертації
+ * @param {Array<{ index: number, opIndex: number, totalOps: number, name: string, newName: string, newTag: string | null }>} conversions конвертації
  * @returns {boolean} true, якщо мутації відбулися (документ можна серіалізувати)
  */
 function applyConversionsToDoc(doc, conversions) {
   const patchesNode = doc.get('patches', true)
   if (!isSeq(patchesNode)) return false
 
-  const removeIdx = new Set(conversions.map(c => c.index))
-  for (let i = patchesNode.items.length - 1; i >= 0; i--) {
-    if (removeIdx.has(i)) patchesNode.delete(i)
+  /** @type {Map<number, { totalOps: number, opIdx: number[] }>} */
+  const byPatch = new Map()
+  for (const c of conversions) {
+    const slot = byPatch.get(c.index) ?? { totalOps: c.totalOps, opIdx: [] }
+    slot.opIdx.push(c.opIndex)
+    byPatch.set(c.index, slot)
+  }
+
+  const sortedIdx = [...byPatch.keys()].sort((a, b) => b - a)
+  for (const i of sortedIdx) {
+    const slot = byPatch.get(i)
+    if (slot === undefined) continue
+    const { totalOps, opIdx } = slot
+    if (opIdx.length === totalOps) {
+      patchesNode.delete(i)
+      continue
+    }
+    const patchEntry = patchesNode.get(i, true)
+    if (patchEntry === undefined || patchEntry === null) continue
+    const patchScalar = patchEntry.get('patch', true)
+    if (patchScalar === undefined || patchScalar === null || typeof patchScalar.value !== 'string') continue
+    const rewritten = rewriteInlinePatchWithoutOps(patchScalar.value, opIdx)
+    if (rewritten === null) continue
+    patchScalar.value = rewritten
   }
+
   if (patchesNode.items.length === 0) {
     doc.delete('patches')
   }
@@ -6004,6 +6051,35 @@ function applyConversionsToDoc(doc, conversions) {
   return true
 }
 
+/**
+ * Видаляє ops за списком індексів з inline `patch:` (текст YAML-масиву JSON6902-ops)
+ * і повертає переписаний текст. Зберігає block-style. Повертає null, якщо не вдалося розпарсити
+ * або після видалення не лишилось ops.
+ * @param {string} patchText текст YAML-масиву ops (literal block scalar)
+ * @param {number[]} opIndices індекси ops, які треба видалити
+ * @returns {string | null} переписаний текст або null
+ */
+function rewriteInlinePatchWithoutOps(patchText, opIndices) {
+  let inner
+  try {
+    inner = parseDocument(patchText)
+  } catch {
+    return null
+  }
+  if (inner.errors.length > 0) return null
+  const seq = inner.contents
+  if (!isSeq(seq)) return null
+
+  const toRemove = [...new Set(opIndices)].sort((a, b) => b - a)
+  for (const i of toRemove) {
+    if (i < 0 || i >= seq.items.length) return null
+    seq.delete(i)
+  }
+  if (seq.items.length === 0) return null
+  seq.flow = false
+  return inner.toString().replace(/\n+$/u, '')
+}
+
 /**
  * Прохід для всіх `kustomization.yaml`: конвертує image-replace patches у `images:`,
  * потім чистить `images:` (зрізає теги в `name`, видаляє надлишкові `newTag`).