oh-my-customcode 1.1.106 → 2.0.0

package/dist/cli/index.js

@@ -335,7 +335,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "1.1.106",
+    version: "2.0.0",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {
@@ -14556,8 +14556,6 @@ var en_default = {
       selfUpdateReexec: "↻ Re-executing with updated CLI (v{{version}})...",
       reexecArgvMissing: "⚠ Cannot re-exec: process.argv[1] is empty — continuing without re-exec",
       allProjectSkippedSource: "  ℹ Skipped: {{name}} (source project cannot self-update)",
-      rtkMissing: "[RTK] RTK is not installed. Attempting installation...",
-      rtkInstalled: "[RTK] ✓ RTK installed — 60-90% token savings activated",
       codexMissing: "[Codex] Codex CLI is not installed. Attempting installation...",
       codexInstalled: "[Codex] ✓ Codex CLI installed"
     },
@@ -14660,10 +14658,6 @@ var en_default = {
           pass: "Framework is up to date (v{{version}})",
           warn: "Framework is outdated: installed v{{installed}}, latest v{{latest}} ({{behind}} version(s) behind). Run 'omcustom update' to sync."
         },
-        rtk: {
-          pass: "RTK installed",
-          warn: "RTK not installed — token savings unavailable"
-        },
         codex: {
           pass: "Codex CLI installed",
           warn: "Codex CLI not installed — AI-assisted development unavailable"
@@ -14736,10 +14730,6 @@ var en_default = {
     }
   },
   install: {
-    rtk_installing: "Installing RTK...",
-    rtk_success: "RTK installed successfully",
-    rtk_already: "RTK already installed",
-    rtk_install_failed: "RTK installation failed",
     codex_installing: "Installing Codex CLI...",
     codex_success: "Codex CLI installed successfully",
     codex_already: "Codex CLI already installed",
@@ -14980,8 +14970,6 @@ var ko_default = {
       selfUpdateReexec: "↻ 새 CLI(v{{version}})로 재실행 중...",
       reexecArgvMissing: "⚠ 재실행 불가: process.argv[1]이 비어있습니다 — 재실행 없이 계속합니다",
       allProjectSkippedSource: "  ℹ 스킵: {{name}} (소스 프로젝트는 자체 업데이트할 수 없음)",
-      rtkMissing: "[RTK] RTK가 설치되지 않았습니다. 설치를 시도합니다...",
-      rtkInstalled: "[RTK] ✓ RTK 설치 완료 — 토큰 60-90% 절감 활성화",
       codexMissing: "[Codex] Codex CLI가 설치되지 않았습니다. 설치를 시도합니다...",
       codexInstalled: "[Codex] ✓ Codex CLI 설치 완료"
     },
@@ -15084,10 +15072,6 @@ var ko_default = {
           pass: "프레임워크가 최신 상태입니다 (v{{version}})",
           warn: "프레임워크가 구버전입니다: 설치됨 v{{installed}}, 최신 v{{latest}} ({{behind}}개 버전 뒤처짐). 'omcustom update'를 실행하여 동기화하세요."
         },
-        rtk: {
-          pass: "RTK 설치됨",
-          warn: "RTK 미설치 — 토큰 절감 불가"
-        },
         codex: {
           pass: "Codex CLI 설치됨",
           warn: "Codex CLI 미설치 — AI 개발 지원 불가"
@@ -15160,10 +15144,6 @@ var ko_default = {
     }
   },
   install: {
-    rtk_installing: "RTK 설치 중...",
-    rtk_success: "RTK 설치 완료",
-    rtk_already: "RTK 이미 설치됨",
-    rtk_install_failed: "RTK 설치 실패",
     codex_installing: "Codex CLI 설치 중...",
     codex_success: "Codex CLI 설치 완료",
     codex_already: "Codex CLI 이미 설치됨",
@@ -15834,18 +15814,10 @@ var MESSAGES = {
     "codex.installing_npm": "Installing Codex CLI via npm...",
     "codex.install_failed": "Failed to install Codex CLI: {{error}}",
     "codex.unsupported_os": "Codex CLI auto-install is not supported on {{os}}",
-    "rtk.already_installed": "RTK is already installed",
-    "rtk.installing_brew": "Installing RTK via Homebrew...",
-    "rtk.installing_curl": "Installing RTK via install script...",
-    "rtk.install_failed": "Failed to install RTK: {{error}}",
-    "rtk.unsupported_os": "RTK auto-install is not supported on {{os}}",
     "mcp.ontology_rag_configured": "ontology-rag MCP server configured successfully",
     "install.codex_installing": "Installing Codex CLI...",
     "install.codex_success": "Codex CLI installed successfully",
     "install.codex_already": "Codex CLI is already installed",
-    "install.rtk_installing": "Installing RTK...",
-    "install.rtk_success": "RTK installed successfully",
-    "install.rtk_already": "RTK is already installed",
     "install.preserved": "Preserved {{files}} file(s) and {{dirs}} directory(ies) from the existing installation",
     "install.restored": "Restored {{files}} file(s) and {{dirs}} directory(ies) after installation",
     "install.backup_failed": "Failed to back up {{path}}: {{error}}",
@@ -15857,7 +15829,6 @@ var MESSAGES = {
     "preserve.restore_failed": "Failed to restore file {{file}}: {{error}}",
     "preserve_files.invalid_path": "Ignored invalid preserve_files entry from {{source}}: {{path}} ({{reason}})",
     "update.codex_missing": "Codex CLI is not installed",
-    "update.rtk_missing": "RTK is not installed",
     "update.self_update_skipped": "Skipped update: source project cannot update itself",
     "update.deprecated_file_invalid_path": "Skipped deprecated file with invalid path: {{path}} ({{reason}})",
     "update.deprecated_file_removed": "Removed deprecated file: {{path}} ({{reason}})",
@@ -15956,18 +15927,10 @@ var MESSAGES = {
     "codex.installing_npm": "npm으로 Codex CLI를 설치합니다...",
     "codex.install_failed": "Codex CLI 설치에 실패했습니다: {{error}}",
     "codex.unsupported_os": "{{os}}에서는 Codex CLI 자동 설치를 지원하지 않습니다",
-    "rtk.already_installed": "RTK가 이미 설치되어 있습니다",
-    "rtk.installing_brew": "Homebrew로 RTK를 설치합니다...",
-    "rtk.installing_curl": "설치 스크립트로 RTK를 설치합니다...",
-    "rtk.install_failed": "RTK 설치에 실패했습니다: {{error}}",
-    "rtk.unsupported_os": "{{os}}에서는 RTK 자동 설치를 지원하지 않습니다",
     "mcp.ontology_rag_configured": "ontology-rag MCP 서버 구성을 완료했습니다",
     "install.codex_installing": "Codex CLI를 설치합니다...",
     "install.codex_success": "Codex CLI를 설치했습니다",
     "install.codex_already": "Codex CLI가 이미 설치되어 있습니다",
-    "install.rtk_installing": "RTK를 설치합니다...",
-    "install.rtk_success": "RTK를 설치했습니다",
-    "install.rtk_already": "RTK가 이미 설치되어 있습니다",
     "install.preserved": "기존 설치에서 파일 {{files}}개와 디렉토리 {{dirs}}개를 보존했습니다",
     "install.restored": "설치 후 파일 {{files}}개와 디렉토리 {{dirs}}개를 복원했습니다",
     "install.backup_failed": "{{path}} 백업에 실패했습니다: {{error}}",
@@ -15979,7 +15942,6 @@ var MESSAGES = {
     "preserve.restore_failed": "파일 {{file}} 복원에 실패했습니다: {{error}}",
     "preserve_files.invalid_path": "{{source}}의 유효하지 않은 preserve_files 항목을 무시했습니다: {{path}} ({{reason}})",
     "update.codex_missing": "Codex CLI가 설치되어 있지 않습니다",
-    "update.rtk_missing": "RTK가 설치되어 있지 않습니다",
     "update.self_update_skipped": "업데이트를 건너뜁니다: 소스 프로젝트는 스스로 업데이트할 수 없습니다",
     "update.deprecated_file_invalid_path": "경로가 유효하지 않아 지원 중단 파일을 건너뜁니다: {{path}} ({{reason}})",
     "update.deprecated_file_removed": "지원 중단 파일을 삭제했습니다: {{path}} ({{reason}})",
@@ -16570,8 +16532,23 @@ function sortFilesByPath(files) {
   const sorted = Object.keys(files).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
   return Object.fromEntries(sorted.map((key) => [key, files[key]]));
 }
+var RETIRED_RTK_PATHS = [
+  ".claude/skills/rtk-exec/SKILL.md",
+  ".claude/skills/rtk-exec/scripts/rtk-wrapper.cjs",
+  ".claude/hooks/scripts/rtk-intercept.sh"
+];
+function getRetiredPaths(options) {
+  const retiredPaths = new Set([...RETIRED_RTK_PATHS, ...options.retiredPaths ?? []]);
+  for (const path of retiredPaths) {
+    if (typeof path !== "string" || /[\\:*?[\]{}\0]/.test(path) || path.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) {
+      throw new Error("retiredPaths must contain exact canonical relative file paths");
+    }
+  }
+  return retiredPaths;
+}
 async function generateLockfile(targetDir, generatorVersion, templateVersion, options = {}) {
   const files = {};
+  const retiredPaths = getRetiredPaths(options);
   const gitVisible = options.excludeGitIgnored ? await listGitVisiblePaths(targetDir) : null;
   const componentRoots = COMPONENT_PATHS.map(([prefix]) => join7(targetDir, prefix));
   for (const componentRoot of componentRoots) {
@@ -16580,7 +16557,7 @@ async function generateLockfile(targetDir, generatorVersion, templateVersion, op
       debug("lockfile.component_dir_missing", { path: componentRoot });
       continue;
     }
-    const allFiles = await collectFiles(componentRoot, targetDir, false);
+    const allFiles = (await collectFiles(componentRoot, targetDir, false)).filter((absolutePath) => !retiredPaths.has(relative2(targetDir, absolutePath).replace(/\\/g, "/")));
     for (const absolutePath of allFiles) {
       const relativePath = relative2(targetDir, absolutePath).replace(/\\/g, "/");
       if (gitVisible !== null && !isGitVisible(gitVisible, relativePath)) {
@@ -16686,72 +16663,6 @@ function diffLockfiles(base, current) {
   return { added, removed, modified, unchanged };
 }
 
-// src/core/rtk-installer.ts
-import { execSync as execSync4 } from "node:child_process";
-import { platform as platform2 } from "node:os";
-var defaultDeps2 = {
-  exec: execSync4,
-  getPlatform: platform2
-};
-function isRtkInstalled(deps = defaultDeps2) {
-  try {
-    deps.exec("which rtk", { stdio: "pipe", timeout: 3000 });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function getRtkVersion(deps = defaultDeps2) {
-  try {
-    return deps.exec("rtk --version", { encoding: "utf-8", stdio: "pipe", timeout: 3000 }).trim();
-  } catch {
-    return null;
-  }
-}
-function installRtk(deps = defaultDeps2) {
-  if (process.env.CI || false || false) {
-    return false;
-  }
-  if (isRtkInstalled(deps)) {
-    info("rtk.already_installed");
-    return true;
-  }
-  const os = deps.getPlatform();
-  try {
-    if (os === "darwin") {
-      try {
-        info("rtk.installing_brew");
-        deps.exec("brew install rtk-ai/tap/rtk", {
-          stdio: "inherit",
-          timeout: 120000
-        });
-        return true;
-      } catch {
-        info("rtk.installing_curl");
-        deps.exec("curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh", {
-          stdio: "inherit",
-          timeout: 120000
-        });
-        return isRtkInstalled(deps);
-      }
-    } else if (os === "linux") {
-      info("rtk.installing_curl");
-      deps.exec("curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh", {
-        stdio: "inherit",
-        timeout: 120000
-      });
-      return isRtkInstalled(deps);
-    } else {
-      warn("rtk.unsupported_os", { os });
-      return false;
-    }
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    warn("rtk.install_failed", { error: message });
-    return false;
-  }
-}
-
 // src/cli/doctor.ts
 async function pathExists(targetPath) {
   try {
@@ -17051,23 +16962,6 @@ async function checkHooks(targetDir, rootDir = ".claude") {
     fixable: false
   };
 }
-async function checkRtk() {
-  if (!isRtkInstalled()) {
-    return {
-      name: "RTK",
-      status: "warn",
-      message: "RTK not installed — token savings unavailable (brew install rtk-ai/tap/rtk)",
-      fixable: true
-    };
-  }
-  const version = getRtkVersion();
-  return {
-    name: "RTK",
-    status: "pass",
-    message: `RTK OK (${version ?? "unknown version"})`,
-    fixable: false
-  };
-}
 async function checkCodex() {
   if (!isCodexInstalled()) {
     return {
@@ -17188,7 +17082,6 @@ async function fixSingleIssue(check, targetDir, rootDir = ".claude") {
       const fixedCount = await fixBrokenSymlinks(targetDir, fullPaths);
       return fixedCount > 0;
     },
-    RTK: async () => Promise.resolve(installRtk()),
     Codex: async () => Promise.resolve(installCodex())
   };
   const fixer = fixMap[check.name];
@@ -17338,7 +17231,6 @@ async function runAllChecks(targetDir, layout, packageVersion, includeUpdates) {
     checkHooks(targetDir, layout.rootDir),
     checkContexts(targetDir, layout.rootDir),
     checkCustomComponents(targetDir, layout.rootDir),
-    checkRtk(),
     checkCodex()
   ]);
   const frameworkCheck = await checkFrameworkDrift(targetDir, packageVersion);
@@ -17427,6 +17319,7 @@ var LEGACY_OMCUSTOM_DESCRIPTIONS = [
 ];
 var STANDALONE_SCRIPT_COMMAND = /^(?:bash )?(?:"(?:\$\{CLAUDE_PROJECT_DIR:-\.\}\/|\.\/)?\.claude\/hooks\/((?:scripts\/)?[A-Za-z0-9._-]+\.sh)"|(?:\.\/)?\.claude\/hooks\/((?:scripts\/)?[A-Za-z0-9._-]+\.sh))$/;
 var SCRIPT_REFERENCE = /\.claude\/hooks\/((?:scripts\/)?[A-Za-z0-9._-]+\.sh)/g;
+var RETIRED_RTK_DESCRIPTION = "RTK auto-intercept — transparently rewrites CLI commands through RTK proxy when available (R013 advisory)";
 function matcherKey(group) {
   return typeof group.matcher === "string" ? group.matcher : "";
 }
@@ -17488,15 +17381,52 @@ function isOwnedCommand(hook, owned) {
   const script = match?.[1] ?? match?.[2];
   return script !== undefined && owned.scripts.has(script);
 }
-function userResidual(group, owned, ownership) {
+function isRetiredRtkCommand(hook, event, matcher) {
+  if (event !== "PreToolUse" || matcher !== "Bash" || !isRecord(hook) || hook.type !== "command" || typeof hook.command !== "string") {
+    return false;
+  }
+  const match = STANDALONE_SCRIPT_COMMAND.exec(hook.command);
+  return (match?.[1] ?? match?.[2]) === "scripts/rtk-intercept.sh";
+}
+function retireRtkGroup(group, event) {
   if (!isRecord(group) || !Array.isArray(group.hooks)) {
     return [group];
   }
+  const remaining = group.hooks.filter((hook) => !isRetiredRtkCommand(hook, event, matcherKey(group)));
+  if (remaining.length === group.hooks.length) {
+    return [group];
+  }
+  return remaining.length === 0 ? [] : [{ ...group, hooks: remaining }];
+}
+function retireRtkHookBlocks(existing) {
+  if (!isRecord(existing)) {
+    return existing;
+  }
+  const updates = {};
+  for (const [event, value] of Object.entries(existing)) {
+    if (!Array.isArray(value)) {
+      continue;
+    }
+    const residual = value.flatMap((group) => retireRtkGroup(group, event));
+    if (residual.length !== value.length || residual.some((group, index) => group !== value[index])) {
+      updates[event] = residual;
+    }
+  }
+  return Object.keys(updates).length === 0 ? existing : { ...existing, ...updates };
+}
+function userResidual(group, event, owned, ownership) {
+  if (!isRecord(group) || !Array.isArray(group.hooks)) {
+    return [group];
+  }
+  const matcher = matcherKey(group);
+  if (group.description === RETIRED_RTK_DESCRIPTION) {
+    return retireRtkGroup(group, event);
+  }
   if (typeof group.description === "string" && ownership.descriptions.has(group.description)) {
     return [];
   }
-  const ownedForMatcher = owned?.get(matcherKey(group));
-  const remaining = group.hooks.filter((hook) => !isOwnedCommand(hook, ownedForMatcher));
+  const ownedForMatcher = owned?.get(matcher);
+  const remaining = group.hooks.filter((hook) => !isRetiredRtkCommand(hook, event, matcher) && !isOwnedCommand(hook, ownedForMatcher));
   if (remaining.length === group.hooks.length) {
     return [group];
   }
@@ -17519,7 +17449,7 @@ function mergeHookBlocks(existing, generated) {
       continue;
     }
     const owned = ownership.events.get(event);
-    const residual = value.flatMap((group) => userResidual(group, owned, ownership));
+    const residual = value.flatMap((group) => userResidual(group, event, owned, ownership));
     if (residual.length === 0) {
       continue;
     }
@@ -18790,19 +18720,6 @@ async function updateInstallConfig(targetDir, options, installedComponents) {
   config.installedComponents = installedComponents;
   await saveConfig(targetDir, config);
 }
-function installRtkIfNeeded(result) {
-  if (!isRtkInstalled()) {
-    info("install.rtk_installing");
-    const rtkInstalled = installRtk();
-    if (rtkInstalled) {
-      info("install.rtk_success");
-    } else {
-      result.warnings.push("RTK installation failed — install manually: brew install rtk-ai/tap/rtk");
-    }
-  } else {
-    info("install.rtk_already");
-  }
-}
 function installCodexIfNeeded(result) {
   if (!isCodexInstalled()) {
     info("install.codex_installing");
@@ -18857,7 +18774,6 @@ async function install(options) {
     } else {
       info("install.lockfile_generated", { files: String(lockfileResult.fileCount) });
     }
-    installRtkIfNeeded(result);
     installCodexIfNeeded(result);
     result.success = true;
     success("install.success");
@@ -19089,7 +19005,7 @@ async function generateMCPConfig(targetDir) {
 
 // src/core/ontology-rag-setup.ts
 init_fs();
-import { execSync as execSync5 } from "node:child_process";
+import { execSync as execSync4 } from "node:child_process";
 import { join as join11 } from "node:path";
 var MIN_PYTHON_MINOR = 10;
 var DETECTION_TIMEOUT_MS = 3000;
@@ -19102,7 +19018,7 @@ function parsePythonVersion(output) {
 }
 function checkPython3() {
   try {
-    const output = execSync5("python3 --version 2>&1", {
+    const output = execSync4("python3 --version 2>&1", {
       stdio: "pipe",
       timeout: DETECTION_TIMEOUT_MS
     }).toString().trim();
@@ -19119,21 +19035,21 @@ function checkPython3() {
 }
 function checkUvAvailableForSetup() {
   try {
-    execSync5("uv --version", { stdio: "pipe", timeout: DETECTION_TIMEOUT_MS });
+    execSync4("uv --version", { stdio: "pipe", timeout: DETECTION_TIMEOUT_MS });
     return true;
   } catch {
     return false;
   }
 }
 function createVenvWithUv(targetDir) {
-  execSync5("uv venv --python 3.12 .venv", {
+  execSync4("uv venv --python 3.12 .venv", {
     cwd: targetDir,
     stdio: "pipe",
     timeout: INSTALL_TIMEOUT_MS
   });
 }
 function createVenvWithPython3(targetDir) {
-  execSync5("python3 -m venv .venv", {
+  execSync4("python3 -m venv .venv", {
     cwd: targetDir,
     stdio: "pipe",
     timeout: INSTALL_TIMEOUT_MS
@@ -19143,13 +19059,13 @@ function installOntologyRagEditable(targetDir, useUv) {
   const packageRoot = getPackageRoot();
   const ontologyPkgPath = join11(packageRoot, "packages", "ontology-rag");
   if (useUv) {
-    execSync5(`uv pip install --python .venv/bin/python -e "${ontologyPkgPath}"`, {
+    execSync4(`uv pip install --python .venv/bin/python -e "${ontologyPkgPath}"`, {
       cwd: targetDir,
       stdio: "pipe",
       timeout: INSTALL_TIMEOUT_MS
     });
   } else {
-    execSync5(`.venv/bin/pip install -e "${ontologyPkgPath}"`, {
+    execSync4(`.venv/bin/pip install -e "${ontologyPkgPath}"`, {
       cwd: targetDir,
       stdio: "pipe",
       timeout: INSTALL_TIMEOUT_MS
@@ -21742,7 +21658,8 @@ import { constants as osConstants } from "node:os";
 
 // src/core/updater.ts
 init_package();
-import { join as join19 } from "node:path";
+import { lstat, realpath as realpath2, unlink as unlink2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute5, join as join19, relative as relative4, resolve as resolve5, sep as sep4 } from "node:path";
 init_fs();
 
 // src/core/entry-merger.ts
@@ -21869,6 +21786,86 @@ ${MANAGED_END}`;
 
 // src/core/updater.ts
 var CUSTOMIZATION_MANIFEST_FILE = ".omcustom-customizations.json";
+var RETIRED_RTK_FILES = [
+  { path: ".claude/skills/rtk-exec/SKILL.md", component: "skills" },
+  { path: ".claude/skills/rtk-exec/scripts/rtk-wrapper.cjs", component: "skills" },
+  { path: ".claude/hooks/scripts/rtk-intercept.sh", component: "hooks" }
+];
+function getRtkRetirement(result) {
+  result.rtkRetirement ??= {
+    removed: [],
+    wouldRemove: [],
+    preserved: [],
+    settingsChanged: [],
+    wouldChangeSettings: [],
+    settingsConflicts: []
+  };
+  return result.rtkRetirement;
+}
+async function validateRtkTarget(targetDir, path) {
+  const validation = validatePreserveFilePath(path, targetDir);
+  if (!validation.valid)
+    throw new Error("path escapes project");
+  const fullPath = resolve5(targetDir, path);
+  const fileStat = await lstat(fullPath);
+  if (!fileStat.isFile() || fileStat.isSymbolicLink())
+    throw new Error("not a regular owned file");
+  const root = await realpath2(targetDir);
+  const resolvedFile = await realpath2(fullPath);
+  const within = relative4(root, resolvedFile);
+  if (within === "" || within === ".." || within.startsWith(`..${sep4}`) || isAbsolute5(within)) {
+    throw new Error("resolved path escapes project");
+  }
+}
+function isRtkPathPreserved(path, config, customizations) {
+  const paths = [
+    ...config.preserveFiles ?? [],
+    ...customizations?.preserveFiles ?? [],
+    ...customizations?.modifiedFiles ?? [],
+    ...(config.customComponents ?? []).map((component) => component.path)
+  ];
+  return paths.some((preserved) => path === preserved || path.startsWith(`${preserved}/`));
+}
+async function retireRtkFile(path, options, lockfile, result, preserved) {
+  const retirement = getRtkRetirement(result);
+  try {
+    await validateRtkTarget(options.targetDir, path);
+    if (preserved)
+      throw new Error("explicitly preserved");
+    if (retirement.settingsConflicts.length > 0)
+      throw new Error("settings retirement conflict");
+    const entry = lockfile?.files[path];
+    if (!entry || typeof entry.templateHash !== "string" || !/^[a-f0-9]{64}$/.test(entry.templateHash)) {
+      throw new Error("missing or invalid old ownership");
+    }
+    const fullPath = join19(options.targetDir, path);
+    if (await computeFileHash(fullPath) !== entry.templateHash)
+      throw new Error("user-modified file");
+    if (options.dryRun) {
+      retirement.wouldRemove.push(path);
+      return;
+    }
+    await validateRtkTarget(options.targetDir, path);
+    await unlink2(fullPath);
+    retirement.removed.push(path);
+    result.removedDeprecatedFiles.push(path);
+  } catch (err) {
+    if (err.code === "ENOENT")
+      return;
+    const reason = err instanceof Error ? err.message : "unreadable ownership or file";
+    retirement.preserved.push({ path, reason });
+    result.preservedFiles.push(path);
+    result.warnings.push(`RTK retirement preserved ${path}: ${reason}`);
+  }
+}
+async function retireRtkFiles(options, lockfile, result, config, customizations) {
+  const fullUpdate = !options.components || options.components.length === 0;
+  const files = RETIRED_RTK_FILES.filter((file) => fullUpdate || options.components?.includes(file.component));
+  for (const file of files) {
+    await retireRtkFile(file.path, options, lockfile, result, isRtkPathPreserved(file.path, config, customizations));
+  }
+  return RETIRED_RTK_FILES.map((file) => file.path);
+}
 function createUpdateResult() {
   return {
     success: false,
@@ -22056,32 +22053,52 @@ async function backfillStatusLineRefreshInterval(targetDir, options) {
     });
   }
 }
-async function migrateHookCommandsInSettingsLocal(targetDir, options) {
-  if (options.dryRun) {
-    return;
+async function migrateHookCommandsInSettingsLocal(targetDir, options, result) {
+  for (const name of ["settings.json", "settings.local.json"]) {
+    await migrateRtkSettingsFile(targetDir, options, result, name);
   }
+}
+async function migrateRtkSettingsFile(targetDir, options, result, name) {
   const layout = getProviderLayout();
-  const settingsPath = join19(targetDir, layout.rootDir, "settings.local.json");
-  if (!await fileExists(settingsPath)) {
-    return;
-  }
+  const path = `${layout.rootDir}/${name}`;
+  const settingsPath = join19(targetDir, path);
+  const retirement = getRtkRetirement(result);
   try {
+    await validateRtkTarget(targetDir, path);
     const raw = await readTextFile(settingsPath);
     const bom = raw.startsWith("\uFEFF") ? "\uFEFF" : "";
     const parsed = JSON.parse(bom ? raw.slice(bom.length) : raw);
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      throw new Error("unknown settings shape");
+    }
+    const current = parsed;
+    const hooks = retireRtkHookBlocks(current.hooks);
+    const retired = hooks !== current.hooks;
+    const input = retired ? { ...current, hooks } : current;
+    const { settings, rewritten } = name === "settings.local.json" ? migrateHookCommands(input) : { settings: input, rewritten: 0 };
+    if (JSON.stringify(settings.hooks)?.includes("rtk-intercept.sh")) {
+      retirement.settingsConflicts.push(path);
+      result.warnings.push(`RTK retirement retained user or unknown wiring in ${path}`);
+    }
+    if (!retired && rewritten === 0) {
       return;
     }
-    const { settings, rewritten } = migrateHookCommands(parsed);
-    if (rewritten === 0) {
+    if (options.dryRun) {
+      retirement.wouldChangeSettings.push(path);
       return;
     }
     const trailingNewline = raw.endsWith(`
 `) ? `
 ` : "";
+    await validateRtkTarget(targetDir, path);
     await writeTextFile(settingsPath, `${bom}${JSON.stringify(settings, null, 2)}${trailingNewline}`);
+    retirement.settingsChanged.push(path);
     info("update.hook_commands_migrated", { count: String(rewritten) });
-  } catch {
+  } catch (err) {
+    if (err.code === "ENOENT")
+      return;
+    retirement.settingsConflicts.push(path);
+    result.warnings.push(`RTK retirement could not safely migrate ${path}`);
     warn("update.hook_commands_migration_failed", {
       path: settingsPath
     });
@@ -22101,7 +22118,7 @@ async function runFullUpdatePostProcessing(options, result, config, customizatio
     }
   }
   if (isFullUpdate || options.components?.includes("hooks")) {
-    await migrateHookCommandsInSettingsLocal(options.targetDir, options);
+    await migrateHookCommandsInSettingsLocal(options.targetDir, options, result);
   }
   if (!options.dryRun) {
     config.version = result.newVersion;
@@ -22128,24 +22145,16 @@ function compareSemver2(a, b) {
   }
   return 0;
 }
-function checkAndInstallRtkAfterUpdate() {
-  if (!isRtkInstalled()) {
-    warn("update.rtk_missing");
-    console.log(i18n.t("cli.update.rtkMissing"));
-    const rtkInstalled = installRtk();
-    if (rtkInstalled) {
-      console.log(i18n.t("cli.update.rtkInstalled"));
-    }
-  }
-}
 async function updateProjectRegistry(targetDir, newVersion) {
   try {
     await Promise.resolve().then(() => init_registry());
     await registerProject(targetDir, newVersion);
   } catch {}
 }
-async function regenerateLockfile(targetDir, result) {
-  const lockfileResult = await generateAndWriteLockfileForDir(targetDir);
+async function regenerateLockfile(options, result, retiredPaths) {
+  if (options.dryRun)
+    return;
+  const lockfileResult = await generateAndWriteLockfileForDir(options.targetDir, { retiredPaths });
   if (lockfileResult.warning) {
     result.warnings.push(lockfileResult.warning);
     warn("update.lockfile_failed", { error: lockfileResult.warning });
@@ -22202,7 +22211,7 @@ async function update(options) {
       result.skippedComponents = options.components || getAllUpdateComponents();
       return result;
     }
-    await handleBackupIfRequested(options.targetDir, !!options.backup, result);
+    await handleBackupIfRequested(options.targetDir, !!options.backup && !options.dryRun, result);
     const manifestCustomizations = await resolveManifestCustomizations(options, options.targetDir);
     const configPreserveFiles = resolveConfigPreserveFiles(options, config);
     const customizations = resolveCustomizations(manifestCustomizations, configPreserveFiles, options.targetDir);
@@ -22210,9 +22219,10 @@ async function update(options) {
     const components = options.components || getAllUpdateComponents();
     await updateAllComponents(options.targetDir, components, updateCheck, customizations, options, result, config, lockfile);
     await runFullUpdatePostProcessing(options, result, config, customizations);
-    await regenerateLockfile(options.targetDir, result);
-    checkAndInstallRtkAfterUpdate();
-    checkAndInstallCodexAfterUpdate();
+    const retiredPaths = await retireRtkFiles(options, lockfile, result, config, customizations);
+    await regenerateLockfile(options, result, retiredPaths);
+    if (!options.dryRun)
+      checkAndInstallCodexAfterUpdate();
     if (result.success && !options.dryRun) {
       await updateProjectRegistry(options.targetDir, result.newVersion);
     }