claudekit-cli 4.5.0-dev.6 → 4.5.0-dev.7

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "4.5.0-dev.6",
-	"generatedAt": "2026-06-27T14:02:00.674Z",
+	"version": "4.5.0-dev.7",
+	"generatedAt": "2026-06-29T17:20:27.008Z",
 	"commands": {
 		"agents": {
 			"name": "agents",

package/dist/index.js

@@ -52475,11 +52475,56 @@ function getRulesSourcePath(globalOnly = false) {
     return globalPath;
   return findExistingProjectLayoutPath(process.cwd(), "rules") ?? globalPath;
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isClaudeKitPluginEnabled(settings) {
+  if (!isRecord2(settings))
+    return false;
+  const enabledPlugins = settings.enabledPlugins;
+  if (Array.isArray(enabledPlugins)) {
+    return enabledPlugins.includes("ck@claudekit");
+  }
+  return isRecord2(enabledPlugins) && enabledPlugins["ck@claudekit"] === true;
+}
+function readJsonSafe2(filePath) {
+  try {
+    return JSON.parse(readFileSync7(filePath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function resolveConfiguredClaudeKitPluginSourceSubpath(relativePath) {
+  const claudeDir3 = join42(homedir23(), ".claude");
+  const settings = readJsonSafe2(join42(claudeDir3, "settings.json"));
+  if (!isClaudeKitPluginEnabled(settings) || !isRecord2(settings))
+    return null;
+  const marketplaces = settings.extraKnownMarketplaces;
+  const claudekit = isRecord2(marketplaces) ? marketplaces.claudekit : null;
+  const source = isRecord2(claudekit) ? claudekit.source : null;
+  const sourcePath = isRecord2(source) && typeof source.path === "string" ? source.path : null;
+  if (!sourcePath)
+    return null;
+  const candidates = [join42(sourcePath, ".claude", relativePath), join42(sourcePath, relativePath)];
+  return candidates.find((candidate) => existsSync24(candidate)) ?? null;
+}
+function hasAdjacentSettings(sourceDir) {
+  return existsSync24(join42(dirname12(sourceDir), "settings.json"));
+}
+function resolveClaudeKitPluginHooksSourcePath() {
+  const candidates = [
+    resolveConfiguredClaudeKitPluginSourceSubpath("hooks"),
+    resolveInstalledPluginCacheSubpath("hooks", join42(homedir23(), ".claude"))
+  ].filter((path4) => typeof path4 === "string");
+  return candidates.find((candidate) => hasAdjacentSettings(candidate)) ?? null;
+}
 function getHooksSourcePath(globalOnly = false) {
   const globalPath = join42(homedir23(), ".claude", "hooks");
+  const pluginPath = resolveClaudeKitPluginHooksSourcePath();
+  const globalCandidate = pluginPath ?? globalPath;
   if (globalOnly)
-    return globalPath;
-  return findExistingProjectLayoutPath(process.cwd(), "hooks") ?? globalPath;
+    return globalCandidate;
+  return findExistingProjectLayoutPath(process.cwd(), "hooks") ?? globalCandidate;
 }
 async function discoverConfig(sourcePath) {
   const path4 = sourcePath ?? getConfigSourcePath();
@@ -52725,6 +52770,7 @@ async function discoverPortableFiles(dir, baseDir, options2) {
 }
 var HOOK_EXTENSIONS, SHELL_HOOK_EXTENSIONS, HOOK_ASSET_EXTENSIONS, HOOK_DEPENDENCY_SKIP_SEGMENTS, HOOKS_SKIP_DIR_NAMES, HOOKS_COMPANION_DOTFILES;
 var init_config_discovery = __esm(() => {
+  init_install_mode_detector();
   init_kit_layout();
   init_hook_migration_compatibility();
   HOOK_EXTENSIONS = new Set([".js", ".cjs", ".mjs", ".ts"]);
@@ -55317,13 +55363,25 @@ var init_gemini_hook_event_map = __esm(() => {
 });
 
 // src/commands/portable/hooks-settings-merger.ts
-import { existsSync as existsSync27 } from "node:fs";
+import { existsSync as existsSync27, readFileSync as readFileSync8 } from "node:fs";
 import { mkdir as mkdir13, readFile as readFile22, rename as rename8, rm as rm6, writeFile as writeFile13 } from "node:fs/promises";
 import { homedir as homedir26 } from "node:os";
-import { basename as basename14, dirname as dirname16, extname as extname4, join as join45, resolve as resolve20 } from "node:path";
+import { basename as basename14, dirname as dirname16, extname as extname4, isAbsolute as isAbsolute6, join as join45, resolve as resolve20 } from "node:path";
+function resolveSettingsPath(pathValue, isGlobal) {
+  if (isGlobal || isAbsolute6(pathValue))
+    return pathValue;
+  return join45(process.cwd(), pathValue);
+}
 function isCodexWrappableHookPath(filePath) {
   return hookAssetBasename(filePath) !== "node-hook-runner.sh" && CODEX_WRAPPABLE_HOOK_EXTENSIONS.has(extname4(filePath).toLowerCase());
 }
+function collectSourceHookDirs(sourceHooksDirOverride, providerSourceHooksDir) {
+  const dirs = [sourceHooksDirOverride, providerSourceHooksDir].filter((value) => typeof value === "string" && value.length > 0);
+  return Array.from(new Set(dirs));
+}
+function rewriteHookPathsFromSourceDirs(hooks, sourceHooksDirs, targetHooksDir) {
+  return sourceHooksDirs.reduce((currentHooks, sourceHooksDir) => rewriteHookPaths(currentHooks, sourceHooksDir, targetHooksDir), hooks);
+}
 function validateHooksSectionShape(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return "hooks must be a non-null object";
@@ -55523,8 +55581,9 @@ function pruneIncompatibleHookRegistrations(hooks, options2) {
       const keptHooks = group.hooks.filter((entry) => {
         const refs = extractHookReferencesFromCommand(entry.command);
         const targetOwned = commandTargetsHookDir(entry.command, targetHooksDir);
+        const foreignCkOwned = commandTargetsForeignCkHookDir(entry.command, targetHooksDir);
         const incompatible = !isCodexSupportedHookEvent(event) || refs.some((ref) => isExcludedHookAsset(ref));
-        if (targetOwned && incompatible) {
+        if (foreignCkOwned || targetOwned && incompatible) {
           hooksPruned += 1;
           return false;
         }
@@ -55569,10 +55628,44 @@ function commandTargetsHookDir(command, targetHooksDir) {
   const normalizedDir = targetHooksDir.replace(/\\/g, "/").replace(/\/+$/, "");
   return normalizedCommand.includes(`${normalizedDir}/`) || normalizedCommand.includes("$HOME/.codex/hooks/") || normalizedCommand.includes("~/.codex/hooks/");
 }
+function commandTargetsForeignCkHookDir(command, targetHooksDir) {
+  const normalizedCommand = command.replace(/\\/g, "/");
+  const normalizedDir = targetHooksDir.replace(/\\/g, "/").replace(/\/+$/, "");
+  const targetTokens = [
+    `${normalizedDir}/`,
+    "$HOME/.codex/hooks/",
+    "~/.codex/hooks/",
+    ".codex/hooks/"
+  ];
+  if (targetTokens.some((token) => normalizedCommand.includes(token)))
+    return false;
+  return normalizedCommand.includes("$HOME/.claude/hooks/") || normalizedCommand.includes("~/.claude/hooks/") || normalizedCommand.includes(".claude/hooks/");
+}
 function isCkManagedHookPath(absPath) {
   const normalized = absPath.replace(/\\/g, "/");
   return normalized.includes("/.claude/hooks/") || normalized.includes("/.codex/hooks/") || normalized.includes("/.gemini/hooks/");
 }
+function readCodexWrapperOriginalHookPath(wrapperPath) {
+  try {
+    const content = readFileSync8(wrapperPath, "utf8");
+    const match = content.match(/const\s+ORIGINAL_HOOK\s*=\s*("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
+    if (!match)
+      return null;
+    const literal = match[1];
+    if (literal.startsWith('"')) {
+      return JSON.parse(literal);
+    }
+    return literal.slice(1, -1).replace(/\\'/g, "'").replace(/\\\\/g, "\\");
+  } catch {
+    return null;
+  }
+}
+function codexWrapperReferencesMissingOriginal(wrapperPath) {
+  const originalPath = readCodexWrapperOriginalHookPath(wrapperPath);
+  if (!originalPath || !isCkManagedHookPath(originalPath))
+    return false;
+  return !existsSync27(originalPath);
+}
 function extractAbsolutePaths(command) {
   const matches = [];
   const pathPattern = /(?:^|[\s"'(])(\/[^\s"'()]+)/g;
@@ -55593,7 +55686,7 @@ function pruneStaleFileHooks(existing) {
         const ckPaths = paths.filter(isCkManagedHookPath);
         if (ckPaths.length === 0)
           return true;
-        return ckPaths.some((p) => existsSync27(p));
+        return ckPaths.some((p) => existsSync27(p) && !codexWrapperReferencesMissingOriginal(p));
       });
       if (survivingHooks.length > 0) {
         prunedGroups.push({ ...group, hooks: survivingHooks });
@@ -55658,7 +55751,7 @@ async function migrateHooksSettings(options2) {
       targetSettingsPath: null
     };
   }
-  const sourceSettingsPath = isGlobal ? sourceConfig.settingsJsonPath?.globalPath : sourceConfig.settingsJsonPath?.projectPath;
+  const sourceSettingsPath = options2.sourceSettingsPath ?? (isGlobal ? sourceConfig.settingsJsonPath?.globalPath : sourceConfig.settingsJsonPath?.projectPath);
   const targetSettingsPath = isGlobal ? targetConfig.settingsJsonPath?.globalPath : targetConfig.settingsJsonPath?.projectPath;
   if (!sourceSettingsPath) {
     return {
@@ -55682,7 +55775,7 @@ async function migrateHooksSettings(options2) {
       targetSettingsPath: null
     };
   }
-  const resolvedSourcePath = isGlobal ? sourceSettingsPath : join45(process.cwd(), sourceSettingsPath);
+  const resolvedSourcePath = resolveSettingsPath(sourceSettingsPath, isGlobal);
   const resolvedTargetPath = isGlobal ? targetSettingsPath : join45(process.cwd(), targetSettingsPath);
   const sourceHooksResult = await inspectHooksSettings(resolvedSourcePath);
   if (sourceHooksResult.status === "missing-file") {
@@ -55730,14 +55823,15 @@ async function migrateHooksSettings(options2) {
       targetSettingsPath: resolvedTargetPath
     };
   }
-  const sourceHooksDir = isGlobal ? sourceConfig.hooks?.globalPath ?? "" : sourceConfig.hooks?.projectPath ?? "";
+  const providerSourceHooksDir = isGlobal ? sourceConfig.hooks?.globalPath ?? "" : sourceConfig.hooks?.projectPath ?? "";
+  const sourceHooksDirs = collectSourceHookDirs(options2.sourceHooksDir, providerSourceHooksDir);
   const targetHooksDir = isGlobal ? targetConfig.hooks?.globalPath ?? "" : targetConfig.hooks?.projectPath ?? "";
   const warnings = [];
   const filtered = filterToInstalledHooks(sourceHooks, installedHookFiles, {
     targetProvider,
     warnings
   });
-  const rewritten = rewriteHookPaths(filtered, sourceHooksDir, targetHooksDir);
+  const rewritten = rewriteHookPathsFromSourceDirs(filtered, sourceHooksDirs, targetHooksDir);
   const eventMapped = mapHookEventsForProvider(rewritten, targetProvider);
   let hooksRegistered = 0;
   for (const groups of Object.values(eventMapped)) {
@@ -55815,7 +55909,7 @@ async function migrateHooksSettingsForCodex(options2) {
     };
   }
   const capabilities = await detectCodexCapabilities();
-  const sourceSettingsPath = isGlobal ? sourceConfig.settingsJsonPath.globalPath : sourceConfig.settingsJsonPath.projectPath;
+  const sourceSettingsPath = options2.sourceSettingsPath ?? (isGlobal ? sourceConfig.settingsJsonPath.globalPath : sourceConfig.settingsJsonPath.projectPath);
   const targetSettingsPath = isGlobal ? codexConfig.settingsJsonPath?.globalPath ?? null : codexConfig.settingsJsonPath?.projectPath ?? null;
   if (!targetSettingsPath) {
     return {
@@ -55828,7 +55922,7 @@ async function migrateHooksSettingsForCodex(options2) {
       targetSettingsPath: null
     };
   }
-  const resolvedSourcePath = isGlobal ? sourceSettingsPath : join45(process.cwd(), sourceSettingsPath);
+  const resolvedSourcePath = resolveSettingsPath(sourceSettingsPath, isGlobal);
   const resolvedTargetPath = isGlobal ? targetSettingsPath : join45(process.cwd(), targetSettingsPath);
   const projectDir = isGlobal ? undefined : process.cwd();
   const sourceHooksResult = await inspectHooksSettings(resolvedSourcePath);
@@ -55875,7 +55969,9 @@ async function migrateHooksSettingsForCodex(options2) {
     warnings
   });
   const targetHooksDir = isGlobal ? codexConfig.hooks?.globalPath ?? "" : codexConfig.hooks?.projectPath ?? "";
-  const sourceHooksDir = isGlobal ? sourceConfig.hooks?.globalPath ?? "" : sourceConfig.hooks?.projectPath ?? "";
+  const providerSourceHooksDir = isGlobal ? sourceConfig.hooks?.globalPath ?? "" : sourceConfig.hooks?.projectPath ?? "";
+  const sourceHooksDir = options2.sourceHooksDir ?? providerSourceHooksDir;
+  const sourceHookCommandDirs = collectSourceHookDirs(options2.sourceHooksDir, providerSourceHooksDir);
   const wrapperPaths = [];
   const commandSubstitutions = new Map;
   if (installedHookAbsolutePaths && installedHookAbsolutePaths.length > 0 && targetHooksDir) {
@@ -55891,11 +55987,11 @@ async function migrateHooksSettingsForCodex(options2) {
           addKey(join45(targetHooksDir, base));
           addKey(`./${join45(targetHooksDir, base)}`);
         }
-        if (sourceHooksDir) {
-          const sourceAbs = join45(resolve20(sourceHooksDir), base);
+        for (const commandSourceHooksDir of sourceHookCommandDirs) {
+          const sourceAbs = join45(resolve20(commandSourceHooksDir), base);
           addKey(sourceAbs);
-          addKey(join45(sourceHooksDir, base));
-          addKey(`./${join45(sourceHooksDir, base)}`);
+          addKey(join45(commandSourceHooksDir, base));
+          addKey(`./${join45(commandSourceHooksDir, base)}`);
           if (sourceAbs.startsWith("/private/")) {
             addKey(sourceAbs.slice("/private".length));
           } else if (sourceAbs.startsWith("/var/")) {
@@ -55905,7 +56001,8 @@ async function migrateHooksSettingsForCodex(options2) {
       }
     }
   }
-  if (!sourceHooksDir) {
+  const pathRewriteSourceDir = providerSourceHooksDir || sourceHooksDir;
+  if (!pathRewriteSourceDir) {
     const convertedNoRewrite = convertClaudeHooksToCodex(filtered, capabilities);
     let hooksRegisteredNoRewrite = 0;
     for (const groups of Object.values(convertedNoRewrite)) {
@@ -55944,7 +56041,7 @@ async function migrateHooksSettingsForCodex(options2) {
   }
   const effectiveTargetDir = targetHooksDir || sourceHooksDir;
   const converted = convertClaudeHooksToCodex(filtered, capabilities, {
-    sourceDir: sourceHooksDir,
+    sourceDir: pathRewriteSourceDir,
     targetDir: effectiveTargetDir,
     commandSubstitutions: commandSubstitutions.size > 0 ? commandSubstitutions : undefined,
     projectDir
@@ -56055,7 +56152,7 @@ var init_generated_context_hooks = __esm(() => {
 // src/commands/portable/migrated-hook-settings-cleanup.ts
 import { existsSync as existsSync28, realpathSync } from "node:fs";
 import { readFile as readFile23, rename as rename9, rm as rm7, unlink as unlink7, writeFile as writeFile14 } from "node:fs/promises";
-import { basename as basename16, isAbsolute as isAbsolute6, relative as relative10, resolve as resolve21 } from "node:path";
+import { basename as basename16, isAbsolute as isAbsolute7, relative as relative10, resolve as resolve21 } from "node:path";
 async function pruneSettingsHooks(settingsPath, hooksDir) {
   const filesToRemove = new Set;
   const warnings = [];
@@ -56138,7 +56235,7 @@ function hookFilesFromCommand(command, hooksDir) {
     const name = basename16(cleaned);
     if (!name || !isGeneratedContextHookName(name))
       continue;
-    if (isAbsolute6(cleaned) && isPathWithin(cleaned, hooksDir))
+    if (isAbsolute7(cleaned) && isPathWithin(cleaned, hooksDir))
       files.add(resolve21(cleaned));
     else if (referencesHooksDir(cleaned, hooksDir) || cleaned.includes(".claude/hooks/")) {
       files.add(resolve21(hooksDir, name));
@@ -56153,7 +56250,7 @@ function referencesHooksDir(command, hooksDir) {
 }
 function isPathWithin(filePath, parentDir) {
   const rel = relative10(resolvePathForContainment(parentDir), resolvePathForContainment(filePath));
-  return rel === "" || !!rel && !rel.startsWith("..") && !isAbsolute6(rel);
+  return rel === "" || !!rel && !rel.startsWith("..") && !isAbsolute7(rel);
 }
 function resolvePathForContainment(pathValue) {
   try {
@@ -56186,7 +56283,7 @@ __export(exports_migrated_hooks_cleanup, {
   isGeneratedContextHookName: () => isGeneratedContextHookName,
   cleanupMigratedHooksForProviders: () => cleanupMigratedHooksForProviders
 });
-import { isAbsolute as isAbsolute7, resolve as resolve22 } from "node:path";
+import { isAbsolute as isAbsolute8, resolve as resolve22 } from "node:path";
 async function cleanupMigratedHooksForProviders(providerIds, options2) {
   const uniqueProviders = Array.from(new Set(providerIds));
   const results = [];
@@ -56240,7 +56337,7 @@ async function cleanupMigratedHooksForProvider(provider, options2) {
 function resolveProviderPath(pathValue) {
   if (!pathValue)
     return null;
-  return isAbsolute7(pathValue) ? pathValue : resolve22(process.cwd(), pathValue);
+  return isAbsolute8(pathValue) ? pathValue : resolve22(process.cwd(), pathValue);
 }
 var init_migrated_hooks_cleanup = __esm(() => {
   init_generated_context_hooks();
@@ -59296,10 +59393,10 @@ var init_migration_routes = __esm(() => {
 });
 
 // src/domains/plan-parser/plan-metadata.ts
-import { readFileSync as readFileSync8, statSync as statSync7 } from "node:fs";
+import { readFileSync as readFileSync9, statSync as statSync7 } from "node:fs";
 function readMatter(filePath) {
   try {
-    return import_gray_matter6.default(readFileSync8(filePath, "utf8")).data;
+    return import_gray_matter6.default(readFileSync9(filePath, "utf8")).data;
   } catch {
     return {};
   }
@@ -59406,7 +59503,7 @@ var init_plan_metadata = __esm(() => {
 });
 
 // src/domains/plan-parser/plan-table-parser.ts
-import { readFileSync as readFileSync9 } from "node:fs";
+import { readFileSync as readFileSync10 } from "node:fs";
 import { dirname as dirname18, resolve as resolve24 } from "node:path";
 function normalizeStatus(raw) {
   const s = raw.toLowerCase().trim();
@@ -59771,7 +59868,7 @@ function parsePhasesFromBody(body, dir, options2) {
   return parseFormat6(normalizedBody, dir, options2);
 }
 function parsePlanFile(planFilePath, options2) {
-  const content = readFileSync9(planFilePath, "utf8");
+  const content = readFileSync10(planFilePath, "utf8");
   const dir = dirname18(planFilePath);
   const { data: frontmatter, content: body } = import_gray_matter7.default(content, {
     engines: { javascript: { parse: () => ({}) } }
@@ -59919,13 +60016,13 @@ var init_plan_scanner = () => {};
 
 // src/domains/plan-parser/plan-scope.ts
 import { homedir as homedir29 } from "node:os";
-import { isAbsolute as isAbsolute8, join as join50, relative as relative12, resolve as resolve25 } from "node:path";
+import { isAbsolute as isAbsolute9, join as join50, relative as relative12, resolve as resolve25 } from "node:path";
 function resolveConfiguredDir(configuredPath, baseDir) {
   const trimmed = configuredPath?.trim();
   if (!trimmed) {
     return join50(baseDir, DEFAULT_PLANS_DIRNAME);
   }
-  return isAbsolute8(trimmed) ? resolve25(trimmed) : resolve25(baseDir, trimmed);
+  return isAbsolute9(trimmed) ? resolve25(trimmed) : resolve25(baseDir, trimmed);
 }
 function resolveProjectPlansDir(projectRoot, config) {
   return resolveConfiguredDir(config?.paths?.plans, projectRoot);
@@ -59940,7 +60037,7 @@ function isWithinDir(targetPath, baseDir) {
   const resolvedTarget = resolve25(targetPath);
   const resolvedBase = resolve25(baseDir);
   const relativePath = relative12(resolvedBase, resolvedTarget);
-  return relativePath === "" || !relativePath.startsWith("..") && relativePath !== ".." && !isAbsolute8(relativePath);
+  return relativePath === "" || !relativePath.startsWith("..") && relativePath !== ".." && !isAbsolute9(relativePath);
 }
 function inferPlanScopeForDir(planDir, config) {
   return isWithinDir(planDir, resolveGlobalPlansDir(config)) ? "global" : "project";
@@ -59949,7 +60046,7 @@ function parsePlanReference(reference, defaultScope) {
   const trimmed = reference.trim();
   const normalizePlanId = (rawPlanId) => {
     const planId = rawPlanId.trim();
-    const valid = planId.length > 0 && !isAbsolute8(planId) && !planId.includes("/") && !planId.includes("\\") && PLAN_ID_PATTERN.test(planId);
+    const valid = planId.length > 0 && !isAbsolute9(planId) && !planId.includes("/") && !planId.includes("\\") && PLAN_ID_PATTERN.test(planId);
     return { planId, valid };
   };
   if (trimmed.startsWith(GLOBAL_PLAN_PREFIX)) {
@@ -60067,10 +60164,10 @@ var init_timeline_builder = __esm(() => {
 });
 
 // src/domains/plan-parser/plan-validator.ts
-import { existsSync as existsSync34, readFileSync as readFileSync10 } from "node:fs";
+import { existsSync as existsSync34, readFileSync as readFileSync11 } from "node:fs";
 import { basename as basename18, dirname as dirname19 } from "node:path";
 function validatePlanFile(filePath, strict = false) {
-  const rawContent = readFileSync10(filePath, "utf8");
+  const rawContent = readFileSync11(filePath, "utf8");
   const content = rawContent.replace(/\r\n/g, `
 `);
   const dir = dirname19(filePath);
@@ -60137,7 +60234,7 @@ var init_plan_validator = __esm(() => {
 
 // src/domains/plan-parser/plan-writer.ts
 import { execSync } from "node:child_process";
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync11, writeFileSync as writeFileSync3 } from "node:fs";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync12, writeFileSync as writeFileSync3 } from "node:fs";
 import { existsSync as existsSync35 } from "node:fs";
 import { basename as basename19, dirname as dirname20, join as join52 } from "node:path";
 function phaseNameToFilename(id, name) {
@@ -60310,7 +60407,7 @@ function isCanonicalFormat(content) {
   return /^\|\s*phase\s*\|\s*name\s*\|\s*status\s*\|/im.test(content);
 }
 function updatePhaseStatus(planFile, phaseId, newStatus) {
-  const raw = readFileSync11(planFile, "utf8").replace(/\r\n/g, `
+  const raw = readFileSync12(planFile, "utf8").replace(/\r\n/g, `
 `);
   if (!isCanonicalFormat(raw)) {
     console.error("[!] plan.md is not in canonical format — skipping status update");
@@ -60372,7 +60469,7 @@ function phaseNameFilenameFromTableRow(body, phaseId, planDir) {
   return null;
 }
 function updatePhaseFileFrontmatter(phaseFile, newStatus) {
-  const raw = readFileSync11(phaseFile, "utf8");
+  const raw = readFileSync12(phaseFile, "utf8");
   const { data: frontmatter, content: body } = import_gray_matter9.default(raw, {
     engines: { javascript: { parse: () => ({}) } }
   });
@@ -60380,7 +60477,7 @@ function updatePhaseFileFrontmatter(phaseFile, newStatus) {
   writeFileSync3(phaseFile, import_gray_matter9.default.stringify(body, updated), "utf8");
 }
 function addPhase(planFile, name, afterId) {
-  const raw = readFileSync11(planFile, "utf8").replace(/\r\n/g, `
+  const raw = readFileSync12(planFile, "utf8").replace(/\r\n/g, `
 `);
   if (!isCanonicalFormat(raw)) {
     console.error("[!] plan.md is not in canonical format — cannot add phase");
@@ -60725,12 +60822,12 @@ var init_plan_types = __esm(() => {
 import {
   existsSync as existsSync36,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   renameSync,
   unlinkSync,
   writeFileSync as writeFileSync4
 } from "node:fs";
-import { dirname as dirname22, isAbsolute as isAbsolute9, join as join53, parse as parse2, relative as relative13, resolve as resolve26 } from "node:path";
+import { dirname as dirname22, isAbsolute as isAbsolute10, join as join53, parse as parse2, relative as relative13, resolve as resolve26 } from "node:path";
 function createEmptyRegistry() {
   return {
     version: 1,
@@ -60756,7 +60853,7 @@ function migrateFromProjectLocal(cwd2, globalPath) {
     return;
   }
   try {
-    const oldData = JSON.parse(readFileSync12(oldPath, "utf8"));
+    const oldData = JSON.parse(readFileSync13(oldPath, "utf8"));
     if (oldData && typeof oldData === "object" && Array.isArray(oldData.plans)) {
       const migrated = {
         version: 1,
@@ -60785,7 +60882,7 @@ function migrateFromProjectLocal(cwd2, globalPath) {
   }
 }
 function normalizeRegistryDir(cwd2, dir) {
-  const absoluteDir = isAbsolute9(dir) ? dir : resolve26(cwd2, dir);
+  const absoluteDir = isAbsolute10(dir) ? dir : resolve26(cwd2, dir);
   const relativeDir = relative13(cwd2, absoluteDir) || dir;
   return relativeDir.replace(/\\/g, "/");
 }
@@ -60807,7 +60904,7 @@ function readRegistry(cwd2 = process.cwd()) {
     return createEmptyRegistry();
   }
   try {
-    const parsed = PlansRegistrySchema.safeParse(JSON.parse(readFileSync12(globalPath, "utf8")));
+    const parsed = PlansRegistrySchema.safeParse(JSON.parse(readFileSync13(globalPath, "utf8")));
     return parsed.success ? parsed.data : createEmptyRegistry();
   } catch {
     return createEmptyRegistry();
@@ -60820,7 +60917,7 @@ function writeRegistry(registry, cwd2 = process.cwd()) {
   mkdirSync3(dirname22(globalPath), { recursive: true });
   if (existsSync36(globalPath)) {
     try {
-      writeFileSync4(`${globalPath}.bak`, readFileSync12(globalPath));
+      writeFileSync4(`${globalPath}.bak`, readFileSync13(globalPath));
     } catch {}
   }
   const tempPath = `${globalPath}.tmp-${process.pid}-${Date.now()}`;
@@ -61202,7 +61299,7 @@ var init_p_limit = __esm(() => {
 });
 
 // src/domains/web-server/routes/plan-routes.ts
-import { existsSync as existsSync37, readFileSync as readFileSync13, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync37, readFileSync as readFileSync14, realpathSync as realpathSync2 } from "node:fs";
 import { homedir as homedir30 } from "node:os";
 import { basename as basename20, dirname as dirname24, join as join55, relative as relative14, resolve as resolve27, sep as sep8 } from "node:path";
 function sanitizeError(err) {
@@ -61251,7 +61348,7 @@ function getGlobalPlanRoot() {
     if (!existsSync37(configPath)) {
       value = resolveGlobalPlansDir();
     } else {
-      const raw = JSON.parse(readFileSync13(configPath, "utf8"));
+      const raw = JSON.parse(readFileSync14(configPath, "utf8"));
       const parsed = CkConfigSchema.parse(normalizeCkConfigInput(raw));
       value = resolveGlobalPlansDir(parsed);
     }
@@ -61581,7 +61678,7 @@ function registerPlanRoutes(app) {
       return;
     }
     try {
-      const raw = readFileSync13(file, "utf8");
+      const raw = readFileSync14(file, "utf8");
       const parsed = import_gray_matter10.default(raw);
       res.json({
         file: relative14(process.cwd(), file),
@@ -63153,12 +63250,12 @@ function getCliVersion3() {
     if (process.env.npm_package_version) {
       return process.env.npm_package_version;
     }
-    const { readFileSync: readFileSync14 } = __require("node:fs");
+    const { readFileSync: readFileSync15 } = __require("node:fs");
     const { dirname: dirname27, join: joinPath } = __require("node:path");
     const { fileURLToPath: fileURLToPath2 } = __require("node:url");
     const __dirname3 = dirname27(fileURLToPath2(import.meta.url));
     const pkgPath = joinPath(__dirname3, "../../../package.json");
-    const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
     return pkg.version || "unknown";
   } catch {
     return "unknown";
@@ -64421,7 +64518,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "4.5.0-dev.6",
+    version: "4.5.0-dev.7",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -64923,7 +65020,7 @@ var init_package_manager_runner = __esm(() => {
 // src/domains/installation/merger/zombie-wirings-pruner.ts
 import { existsSync as existsSync45, readdirSync as readdirSync8 } from "node:fs";
 import { homedir as homedir39 } from "node:os";
-import { basename as basename23, dirname as dirname28, isAbsolute as isAbsolute10, resolve as resolve32, sep as sep10 } from "node:path";
+import { basename as basename23, dirname as dirname28, isAbsolute as isAbsolute11, resolve as resolve32, sep as sep10 } from "node:path";
 function pruneZombieEngineerWirings(settings, hookDir, preserveCommands = new Set) {
   const pruned = [];
   const normalizedPreserveCommands = new Set(Array.from(preserveCommands).map((command) => normalizeCommand(command)));
@@ -65021,7 +65118,7 @@ function extractHookFilePath(command, hookDir) {
     const bashMatch = command.match(/^bash\s+["']([^"']+\.sh)["']/);
     if (bashMatch) {
       const rawPath = bashMatch[1].replace(/\\/g, "/");
-      const resolved = isAbsolute10(rawPath) || /^[A-Za-z]:[\\/]/.test(rawPath) ? rawPath : resolve32(hookDir, rawPath);
+      const resolved = isAbsolute11(rawPath) || /^[A-Za-z]:[\\/]/.test(rawPath) ? rawPath : resolve32(hookDir, rawPath);
       return process.platform === "win32" ? resolved.replace(/\//g, sep10) : resolved;
     }
     return null;
@@ -65043,7 +65140,7 @@ function extractHookFilePath(command, hookDir) {
       return process.platform === "win32" ? resolved.replace(/\//g, sep10) : resolved;
     }
     const tildeResolved = rawArg.replace(/^~(?=\/)/, home5);
-    if (isAbsolute10(tildeResolved) || /^[A-Za-z]:[\\/]/.test(tildeResolved)) {
+    if (isAbsolute11(tildeResolved) || /^[A-Za-z]:[\\/]/.test(tildeResolved)) {
       return process.platform === "win32" ? tildeResolved.replace(/\//g, sep10) : tildeResolved;
     }
     return resolve32(hookDir, tildeResolved);
@@ -65057,7 +65154,7 @@ function extractHookFilePath(command, hookDir) {
       return process.platform === "win32" ? resolved.replace(/\//g, sep10) : resolved;
     }
     const tildeResolved = rawArg.replace(/^~(?=\/)/, home5);
-    if (isAbsolute10(tildeResolved) || /^[A-Za-z]:[\\/]/.test(tildeResolved)) {
+    if (isAbsolute11(tildeResolved) || /^[A-Za-z]:[\\/]/.test(tildeResolved)) {
       return process.platform === "win32" ? tildeResolved.replace(/\//g, sep10) : tildeResolved;
     }
     return resolve32(hookDir, tildeResolved);
@@ -65080,7 +65177,7 @@ var init_shared2 = __esm(() => {
 
 // src/domains/health-checks/checkers/hook-health-checker.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync46, readFileSync as readFileSync14, readdirSync as readdirSync9, statSync as statSync10, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync46, readFileSync as readFileSync15, readdirSync as readdirSync9, statSync as statSync10, writeFileSync as writeFileSync5 } from "node:fs";
 import { readdir as readdir17 } from "node:fs/promises";
 import { homedir as homedir40, tmpdir } from "node:os";
 import { dirname as dirname29, join as join65, resolve as resolve33, sep as sep11 } from "node:path";
@@ -65120,7 +65217,7 @@ function readManagedHookNamesForClaudeDir(claudeDir3) {
   if (!existsSync46(manifestPath))
     return new Set;
   try {
-    const data = JSON.parse(readFileSync14(manifestPath, "utf-8"));
+    const data = JSON.parse(readFileSync15(manifestPath, "utf-8"));
     if (!Array.isArray(data.managedHooks))
       return new Set;
     return new Set(data.managedHooks.filter((name) => typeof name === "string"));
@@ -65591,7 +65688,7 @@ async function checkHookDeps(projectDir) {
       const filePath = join65(hooksDir, file);
       if (!isPathWithin2(filePath, hooksDir))
         continue;
-      const content = readFileSync14(filePath, "utf-8");
+      const content = readFileSync15(filePath, "utf-8");
       for (let match = requireRegex.exec(content);match !== null; match = requireRegex.exec(content)) {
         const depPath = match[1];
         if (depPath.startsWith("node:") || isNodeBuiltin(depPath)) {
@@ -66140,7 +66237,7 @@ async function checkHookConfig(projectDir) {
     };
   }
   try {
-    const configContent = readFileSync14(configPath, "utf-8");
+    const configContent = readFileSync15(configPath, "utf-8");
     const config = JSON.parse(configContent);
     if (!config.hooks || typeof config.hooks !== "object") {
       return {
@@ -66276,7 +66373,7 @@ async function checkHookLogs(projectDir) {
         }
       };
     }
-    const logContent = readFileSync14(logPath, "utf-8");
+    const logContent = readFileSync15(logPath, "utf-8");
     const lines = logContent.trim().split(`
 `).filter(Boolean);
     const now = Date.now();
@@ -75127,7 +75224,7 @@ var init_npm_package_manager = __esm(() => {
 });
 
 // src/services/package-installer/install-error-handler.ts
-import { existsSync as existsSync62, readFileSync as readFileSync19, unlinkSync as unlinkSync3 } from "node:fs";
+import { existsSync as existsSync62, readFileSync as readFileSync20, unlinkSync as unlinkSync3 } from "node:fs";
 import { join as join92 } from "node:path";
 function parseNameReason(str2) {
   const colonIndex = str2.indexOf(":");
@@ -75198,7 +75295,7 @@ function displayInstallErrors(skillsDir2) {
   }
   let summary;
   try {
-    summary = JSON.parse(readFileSync19(summaryPath, "utf-8"));
+    summary = JSON.parse(readFileSync20(summaryPath, "utf-8"));
   } catch (parseError) {
     logger.error("Failed to parse error summary. File may be corrupted.");
     logger.debug(`Parse error: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
@@ -78326,7 +78423,7 @@ var init_content_validator = __esm(() => {
 
 // src/commands/content/phases/context-cache-manager.ts
 import { createHash as createHash9 } from "node:crypto";
-import { existsSync as existsSync83, mkdirSync as mkdirSync7, readFileSync as readFileSync22, readdirSync as readdirSync14, statSync as statSync15 } from "node:fs";
+import { existsSync as existsSync83, mkdirSync as mkdirSync7, readFileSync as readFileSync23, readdirSync as readdirSync14, statSync as statSync15 } from "node:fs";
 import { rename as rename16, writeFile as writeFile43 } from "node:fs/promises";
 import { homedir as homedir54 } from "node:os";
 import { basename as basename34, join as join167 } from "node:path";
@@ -78335,7 +78432,7 @@ function getCachedContext(repoPath) {
   if (!existsSync83(cachePath))
     return null;
   try {
-    const raw2 = readFileSync22(cachePath, "utf-8");
+    const raw2 = readFileSync23(cachePath, "utf-8");
     const cache5 = JSON.parse(raw2);
     const age = Date.now() - new Date(cache5.createdAt).getTime();
     if (age >= CACHE_TTL_MS5)
@@ -78583,7 +78680,7 @@ function extractContentFromResponse(response) {
 
 // src/commands/content/phases/docs-summarizer.ts
 import { execSync as execSync7 } from "node:child_process";
-import { existsSync as existsSync84, readFileSync as readFileSync23, readdirSync as readdirSync15 } from "node:fs";
+import { existsSync as existsSync84, readFileSync as readFileSync24, readdirSync as readdirSync15 } from "node:fs";
 import { join as join168 } from "node:path";
 async function summarizeProjectDocs(repoPath, contentLogger) {
   const rawContent = collectRawDocs(repoPath);
@@ -78632,7 +78729,7 @@ function collectRawDocs(repoPath) {
       return "";
     if (totalChars >= MAX_RAW_CONTENT_CHARS)
       return "";
-    const content = readFileSync23(filePath, "utf-8");
+    const content = readFileSync24(filePath, "utf-8");
     const capped = content.slice(0, Math.min(maxChars, MAX_RAW_CONTENT_CHARS - totalChars));
     totalChars += capped.length;
     return capped;
@@ -79126,7 +79223,7 @@ var init_sqlite_client = __esm(() => {
 
 // src/commands/content/phases/db-manager.ts
 import { existsSync as existsSync87, mkdirSync as mkdirSync10 } from "node:fs";
-import { dirname as dirname55 } from "node:path";
+import { dirname as dirname56 } from "node:path";
 function initDatabase(dbPath) {
   ensureParentDir(dbPath);
   const db = openDatabase(dbPath);
@@ -79147,7 +79244,7 @@ function runRetentionCleanup(db, retentionDays = 90) {
   db.prepare("DELETE FROM git_events WHERE processed = 1 AND created_at < ?").run(cutoff);
 }
 function ensureParentDir(dbPath) {
-  const dir = dirname55(dbPath);
+  const dir = dirname56(dbPath);
   if (dir && !existsSync87(dir)) {
     mkdirSync10(dir, { recursive: true });
   }
@@ -79313,7 +79410,7 @@ function isNoiseCommit(title, author) {
 
 // src/commands/content/phases/change-detector.ts
 import { execSync as execSync10, spawnSync as spawnSync9 } from "node:child_process";
-import { existsSync as existsSync88, readFileSync as readFileSync24, readdirSync as readdirSync17, statSync as statSync17 } from "node:fs";
+import { existsSync as existsSync88, readFileSync as readFileSync25, readdirSync as readdirSync17, statSync as statSync17 } from "node:fs";
 import { join as join171 } from "node:path";
 function detectCommits(repo, since) {
   try {
@@ -79440,7 +79537,7 @@ function detectCompletedPlans(repo, since) {
         const stat26 = statSync17(planFile);
         if (stat26.mtimeMs < sinceMs)
           continue;
-        const content = readFileSync24(planFile, "utf-8");
+        const content = readFileSync25(planFile, "utf-8");
         const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
         if (!frontmatterMatch)
           continue;
@@ -80205,7 +80302,7 @@ async function loadContentConfig(projectDir) {
 }
 async function saveContentConfig(projectDir, config) {
   const configPath = join173(projectDir, CK_CONFIG_FILE2);
-  const json = await readJsonSafe4(configPath);
+  const json = await readJsonSafe5(configPath);
   json.content = { ...json.content, ...config };
   await atomicWrite3(configPath, json);
 }
@@ -80230,14 +80327,14 @@ async function saveContentState(projectDir, state) {
     }
   }
   ContentStateSchema.parse(state);
-  const json = await readJsonSafe4(configPath);
+  const json = await readJsonSafe5(configPath);
   if (!json.content || typeof json.content !== "object") {
     json.content = {};
   }
   json.content.state = state;
   await atomicWrite3(configPath, json);
 }
-async function readJsonSafe4(filePath) {
+async function readJsonSafe5(filePath) {
   try {
     const raw2 = await readFile72(filePath, "utf-8");
     return JSON.parse(raw2);
@@ -80712,7 +80809,7 @@ __export(exports_content_subcommands, {
   logsContent: () => logsContent,
   approveContentCmd: () => approveContentCmd
 });
-import { existsSync as existsSync91, readFileSync as readFileSync25, unlinkSync as unlinkSync6 } from "node:fs";
+import { existsSync as existsSync91, readFileSync as readFileSync26, unlinkSync as unlinkSync6 } from "node:fs";
 import { homedir as homedir58 } from "node:os";
 import { join as join175 } from "node:path";
 function isDaemonRunning() {
@@ -80720,7 +80817,7 @@ function isDaemonRunning() {
   if (!existsSync91(lockFile))
     return { running: false, pid: null };
   try {
-    const pidStr = readFileSync25(lockFile, "utf-8").trim();
+    const pidStr = readFileSync26(lockFile, "utf-8").trim();
     const pid = Number.parseInt(pidStr, 10);
     if (Number.isNaN(pid)) {
       unlinkSync6(lockFile);
@@ -80754,7 +80851,7 @@ async function stopContent() {
     return;
   }
   try {
-    const pidStr = readFileSync25(lockFile, "utf-8").trim();
+    const pidStr = readFileSync26(lockFile, "utf-8").trim();
     const pid = Number.parseInt(pidStr, 10);
     if (!Number.isNaN(pid)) {
       process.kill(pid, "SIGTERM");
@@ -80802,7 +80899,7 @@ async function logsContent(options2) {
       process.exit(0);
     });
   } else {
-    const content = readFileSync25(logPath, "utf-8");
+    const content = readFileSync26(logPath, "utf-8");
     console.log(content);
   }
 }
@@ -88177,7 +88274,7 @@ import { promisify as promisify14 } from "node:util";
 // src/domains/github/gh-cli-utils.ts
 init_environment();
 init_logger();
-import { readFileSync as readFileSync15 } from "node:fs";
+import { readFileSync as readFileSync16 } from "node:fs";
 var MIN_GH_CLI_VERSION = "2.20.0";
 var GH_COMMAND_TIMEOUT_MS = 1e4;
 function compareVersions6(a3, b3) {
@@ -88198,7 +88295,7 @@ function isWSL2() {
   if (process.platform !== "linux")
     return false;
   try {
-    const release = readFileSync15("/proc/version", "utf-8").toLowerCase();
+    const release = readFileSync16("/proc/version", "utf-8").toLowerCase();
     return release.includes("microsoft") || release.includes("wsl");
   } catch (error) {
     logger.debug(`WSL detection skipped: ${error instanceof Error ? error.message : "unknown error"}`);
@@ -89027,7 +89124,7 @@ function checkClaudeMdFile(path7, name, id) {
   }
 }
 // src/domains/health-checks/checkers/active-plan-checker.ts
-import { existsSync as existsSync53, readFileSync as readFileSync17 } from "node:fs";
+import { existsSync as existsSync53, readFileSync as readFileSync18 } from "node:fs";
 import { join as join74 } from "node:path";
 function checkActivePlan(projectDir) {
   const activePlanPath = join74(projectDir, ".claude", "active-plan");
@@ -89043,7 +89140,7 @@ function checkActivePlan(projectDir) {
     };
   }
   try {
-    const targetPath = readFileSync17(activePlanPath, "utf-8").trim();
+    const targetPath = readFileSync18(activePlanPath, "utf-8").trim();
     const fullPath = join74(projectDir, targetPath);
     if (!existsSync53(fullPath)) {
       return {
@@ -91584,7 +91681,7 @@ class AutoHealer {
 }
 // src/domains/health-checks/report-generator.ts
 import { execSync as execSync4, spawnSync as spawnSync6 } from "node:child_process";
-import { readFileSync as readFileSync18, unlinkSync as unlinkSync2, writeFileSync as writeFileSync6 } from "node:fs";
+import { readFileSync as readFileSync19, unlinkSync as unlinkSync2, writeFileSync as writeFileSync6 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { dirname as dirname33, join as join88 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
@@ -91595,7 +91692,7 @@ function getCliVersion4() {
   try {
     const __dirname4 = dirname33(fileURLToPath4(import.meta.url));
     const pkgPath = join88(__dirname4, "../../../package.json");
-    const pkg = JSON.parse(readFileSync18(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync19(pkgPath, "utf-8"));
     return pkg.version || "unknown";
   } catch (err) {
     logger.debug(`Failed to read CLI version: ${err}`);
@@ -92075,7 +92172,7 @@ init_config_version_checker();
 
 // src/domains/sync/sync-engine.ts
 import { lstat as lstat6, readFile as readFile48, readlink as readlink2, realpath as realpath8, stat as stat14 } from "node:fs/promises";
-import { isAbsolute as isAbsolute11, join as join89, normalize as normalize8, relative as relative18 } from "node:path";
+import { isAbsolute as isAbsolute12, join as join89, normalize as normalize8, relative as relative18 } from "node:path";
 
 // src/services/file-operations/ownership-checker.ts
 init_metadata_migration();
@@ -93290,10 +93387,10 @@ async function validateSymlinkChain(path8, basePath, maxDepth = MAX_SYMLINK_DEPT
       if (!stats.isSymbolicLink())
         break;
       const target = await readlink2(current);
-      const resolvedTarget = isAbsolute11(target) ? target : join89(current, "..", target);
+      const resolvedTarget = isAbsolute12(target) ? target : join89(current, "..", target);
       const normalizedTarget = normalize8(resolvedTarget);
       const rel = relative18(basePath, normalizedTarget);
-      if (rel.startsWith("..") || isAbsolute11(rel)) {
+      if (rel.startsWith("..") || isAbsolute12(rel)) {
         throw new Error(`Symlink chain escapes base directory at depth ${depth}: ${path8}`);
       }
       current = normalizedTarget;
@@ -93320,7 +93417,7 @@ async function validateSyncPath(basePath, filePath) {
     throw new Error(`Path too long: ${filePath.slice(0, 50)}...`);
   }
   const normalized = normalize8(filePath);
-  if (isAbsolute11(normalized)) {
+  if (isAbsolute12(normalized)) {
     throw new Error(`Absolute paths not allowed: ${filePath}`);
   }
   if (normalized.startsWith("..") || normalized.includes("/../")) {
@@ -93328,7 +93425,7 @@ async function validateSyncPath(basePath, filePath) {
   }
   const fullPath = join89(basePath, normalized);
   const rel = relative18(basePath, fullPath);
-  if (rel.startsWith("..") || isAbsolute11(rel)) {
+  if (rel.startsWith("..") || isAbsolute12(rel)) {
     throw new Error(`Path escapes base directory: ${filePath}`);
   }
   await validateSymlinkChain(fullPath, basePath);
@@ -93336,7 +93433,7 @@ async function validateSyncPath(basePath, filePath) {
     const resolvedBase = await realpath8(basePath);
     const resolvedFull = await realpath8(fullPath);
     const resolvedRel = relative18(resolvedBase, resolvedFull);
-    if (resolvedRel.startsWith("..") || isAbsolute11(resolvedRel)) {
+    if (resolvedRel.startsWith("..") || isAbsolute12(resolvedRel)) {
       throw new Error(`Symlink escapes base directory: ${filePath}`);
     }
   } catch (error) {
@@ -93346,7 +93443,7 @@ async function validateSyncPath(basePath, filePath) {
         const resolvedBase = await realpath8(basePath);
         const resolvedParent = await realpath8(parentPath);
         const resolvedRel = relative18(resolvedBase, resolvedParent);
-        if (resolvedRel.startsWith("..") || isAbsolute11(resolvedRel)) {
+        if (resolvedRel.startsWith("..") || isAbsolute12(resolvedRel)) {
           throw new Error(`Parent symlink escapes base directory: ${filePath}`);
         }
       } catch (parentError) {
@@ -99195,11 +99292,11 @@ var modeFix = (mode, isDir2, portable) => {
 
 // node_modules/tar/dist/esm/strip-absolute-path.js
 import { win32 as win322 } from "node:path";
-var { isAbsolute: isAbsolute12, parse: parse5 } = win322;
+var { isAbsolute: isAbsolute13, parse: parse5 } = win322;
 var stripAbsolutePath = (path8) => {
   let r2 = "";
   let parsed = parse5(path8);
-  while (isAbsolute12(path8) || parsed.root) {
+  while (isAbsolute13(path8) || parsed.root) {
     const root = path8.charAt(0) === "/" && path8.slice(0, 4) !== "//?/" ? "/" : parsed.root;
     path8 = path8.slice(root.length);
     r2 += root;
@@ -109028,12 +109125,12 @@ async function handlePostInstall(ctx) {
 }
 // src/commands/init/phases/plugin-install-handler.ts
 init_codex_plugin_installer();
-import { cpSync as cpSync2, existsSync as existsSync69, mkdirSync as mkdirSync6, readFileSync as readFileSync21, rmSync as rmSync4, writeFileSync as writeFileSync8 } from "node:fs";
+import { cpSync as cpSync2, existsSync as existsSync69, mkdirSync as mkdirSync6, readFileSync as readFileSync22, rmSync as rmSync4, writeFileSync as writeFileSync8 } from "node:fs";
 import { join as join136 } from "node:path";
 
 // src/domains/installation/plugin/migrate-legacy-to-plugin.ts
 init_install_mode_detector();
-import { cpSync, existsSync as existsSync68, mkdirSync as mkdirSync5, readFileSync as readFileSync20, rmSync as rmSync3, writeFileSync as writeFileSync7 } from "node:fs";
+import { cpSync, existsSync as existsSync68, mkdirSync as mkdirSync5, readFileSync as readFileSync21, rmSync as rmSync3, writeFileSync as writeFileSync7 } from "node:fs";
 import { dirname as dirname43, join as join135 } from "node:path";
 
 // src/domains/installation/plugin/plugin-installer.ts
@@ -109200,7 +109297,7 @@ function base(action, modeBefore, pluginVerified) {
 }
 var PLUGIN_SUPPLIED_LEGACY_PREFIXES2 = ["agents/", "skills/"];
 function defaultLegacyRemover(claudeDir3, backupDir) {
-  const meta = readJsonSafe2(join135(claudeDir3, "metadata.json"));
+  const meta = readJsonSafe3(join135(claudeDir3, "metadata.json"));
   const files = collectTrackedFiles2(meta);
   const removed = [];
   for (const file of files) {
@@ -109224,22 +109321,22 @@ function isPluginSuppliedLegacyPath(pathValue) {
   return PLUGIN_SUPPLIED_LEGACY_PREFIXES2.some((prefix) => normalized.startsWith(prefix));
 }
 function collectTrackedFiles2(meta) {
-  if (!isRecord2(meta))
+  if (!isRecord3(meta))
     return [];
   const out = [];
   const push2 = (arr) => {
     if (!Array.isArray(arr))
       return;
     for (const f3 of arr) {
-      if (isRecord2(f3) && typeof f3.path === "string") {
+      if (isRecord3(f3) && typeof f3.path === "string") {
         const ownership = f3.ownership === "user" || f3.ownership === "ck-modified" ? f3.ownership : "ck";
         out.push({ path: f3.path, ownership });
       }
     }
   };
-  if (isRecord2(meta.kits)) {
+  if (isRecord3(meta.kits)) {
     const engineer = meta.kits[ENGINEER_KIT_KEY];
-    if (isRecord2(engineer))
+    if (isRecord3(engineer))
       push2(engineer.files);
   } else {
     push2(meta.files);
@@ -109248,21 +109345,21 @@ function collectTrackedFiles2(meta) {
 }
 function writeReceipt(claudeDir3, receipt) {
   const receiptPath = join135(claudeDir3, ".ck-migration-log.json");
-  const existing = readJsonSafe2(receiptPath);
+  const existing = readJsonSafe3(receiptPath);
   const history = Array.isArray(existing) ? existing : [];
   history.push(receipt);
   writeFileSync7(receiptPath, `${JSON.stringify(history, null, 2)}
 `, "utf-8");
   return receiptPath;
 }
-function readJsonSafe2(filePath) {
+function readJsonSafe3(filePath) {
   try {
-    return JSON.parse(readFileSync20(filePath, "utf-8"));
+    return JSON.parse(readFileSync21(filePath, "utf-8"));
   } catch {
     return null;
   }
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -109335,7 +109432,7 @@ function ensureCodexPluginManifest(pluginRoot) {
   const manifestPath = join136(pluginRoot, ".codex-plugin", "plugin.json");
   if (existsSync69(manifestPath))
     return;
-  const claudeManifest = readJsonSafe3(join136(pluginRoot, ".claude-plugin", "plugin.json"));
+  const claudeManifest = readJsonSafe4(join136(pluginRoot, ".claude-plugin", "plugin.json"));
   const manifest = pruneUndefined({
     name: stringField(claudeManifest, "name") ?? "ck",
     version: stringField(claudeManifest, "version") ?? "0.0.0",
@@ -109360,10 +109457,10 @@ function ensureCodexPluginManifest(pluginRoot) {
   writeFileSync8(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf-8");
 }
-function readJsonSafe3(filePath) {
+function readJsonSafe4(filePath) {
   try {
-    const parsed = JSON.parse(readFileSync21(filePath, "utf-8"));
-    return isRecord3(parsed) ? parsed : null;
+    const parsed = JSON.parse(readFileSync22(filePath, "utf-8"));
+    return isRecord4(parsed) ? parsed : null;
   } catch {
     return null;
   }
@@ -109374,7 +109471,7 @@ function stringField(source, key) {
 }
 function authorField(source) {
   const author = source?.author;
-  if (isRecord3(author) && typeof author.name === "string" && author.name.trim() !== "") {
+  if (isRecord4(author) && typeof author.name === "string" && author.name.trim() !== "") {
     return { name: author.name };
   }
   return { name: "ClaudeKit" };
@@ -109382,7 +109479,7 @@ function authorField(source) {
 function pruneUndefined(value) {
   return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function logPluginResult(result) {
@@ -111495,7 +111592,7 @@ var import_picocolors30 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync71 } from "node:fs";
 import { readFile as readFile67, rm as rm18, unlink as unlink14 } from "node:fs/promises";
 import { homedir as homedir52 } from "node:os";
-import { basename as basename30, join as join148, resolve as resolve48 } from "node:path";
+import { basename as basename30, dirname as dirname49, join as join148, resolve as resolve48 } from "node:path";
 init_logger();
 
 // src/ui/ck-cli-design/next-steps-footer.ts
@@ -113011,6 +113108,24 @@ function createSkippedPathMigrationCleanupResult2(action) {
     skipReason: "Legacy path cleanup skipped because no successful replacement write was recorded"
   };
 }
+function resolveHookTargetPath(item, provider, global3) {
+  const pathConfig = providers[provider].hooks;
+  if (!pathConfig)
+    return null;
+  const basePath = global3 ? pathConfig.globalPath : pathConfig.projectPath;
+  if (!basePath)
+    return null;
+  const converted = convertItem(item, pathConfig.format, provider, { global: global3 });
+  if (converted.error)
+    return null;
+  const targetPath = pathConfig.writeStrategy === "single-file" ? basePath : join148(basePath, converted.filename);
+  const resolvedTarget = resolve48(targetPath).replace(/\\/g, "/");
+  const resolvedBase = resolve48(basePath).replace(/\\/g, "/").replace(/\/+$/, "");
+  if (resolvedTarget !== resolvedBase && !resolvedTarget.startsWith(`${resolvedBase}/`)) {
+    return null;
+  }
+  return targetPath;
+}
 async function processMetadataDeletions(skillSourcePath, installGlobally) {
   if (!skillSourcePath)
     return;
@@ -113418,23 +113533,31 @@ async function migrateCommand(options2) {
     }
     const progressSink = createMigrateProgressSink(writeTasks.length + plannedDeleteActions.length);
     const writtenPaths = new Set;
+    const recordHookTargetForSettings = (provider, global3, targetPath) => {
+      if (targetPath.length === 0 || !existsSync71(targetPath))
+        return;
+      const resolvedPath = resolve48(targetPath);
+      const entry = successfulHookFiles.get(provider) ?? {
+        files: [],
+        global: global3
+      };
+      const hookFile = basename30(targetPath);
+      if (!entry.files.includes(hookFile))
+        entry.files.push(hookFile);
+      successfulHookFiles.set(provider, entry);
+      const absExisting = successfulHookAbsPaths.get(provider) ?? [];
+      if (!absExisting.includes(resolvedPath)) {
+        absExisting.push(resolvedPath);
+        successfulHookAbsPaths.set(provider, absExisting);
+      }
+    };
     const recordSuccessfulWrites = (task, taskResults) => {
-      for (const result of taskResults.filter((entry) => entry.success && !entry.skipped)) {
-        if (result.path.length > 0) {
+      for (const result of taskResults.filter((entry) => entry.success)) {
+        if (!result.skipped && result.path.length > 0) {
           writtenPaths.add(resolve48(result.path));
         }
         if (task.type === "hooks") {
-          const existing = successfulHookFiles.get(task.provider) ?? {
-            files: [],
-            global: task.global
-          };
-          existing.files.push(basename30(result.path));
-          successfulHookFiles.set(task.provider, existing);
-          if (result.path.length > 0) {
-            const absExisting = successfulHookAbsPaths.get(task.provider) ?? [];
-            absExisting.push(resolve48(result.path));
-            successfulHookAbsPaths.set(task.provider, absExisting);
-          }
+          recordHookTargetForSettings(task.provider, task.global, result.path);
         }
       }
     };
@@ -113469,6 +113592,18 @@ async function migrateCommand(options2) {
       recordSuccessfulWrites(task, taskResults);
       progressSink.tick(progressLabelForType(task.type));
     }
+    if (hooksSource && effectiveHookItems.length > 0) {
+      for (const provider of selectedProviders) {
+        if (!getProvidersSupporting("hooks").includes(provider))
+          continue;
+        const global3 = resolvePortableTypeGlobal(provider, "hooks", installGlobally);
+        for (const item of effectiveHookItems) {
+          const targetPath = resolveHookTargetPath(item, provider, global3);
+          if (targetPath)
+            recordHookTargetForSettings(provider, global3, targetPath);
+        }
+      }
+    }
     if (selectedProviders.includes("opencode")) {
       try {
         const result = await ensureOpenCodeModel({
@@ -113518,12 +113653,15 @@ async function migrateCommand(options2) {
     for (const [hooksProvider, entry] of successfulHookFiles) {
       if (entry.files.length === 0)
         continue;
+      const sourceSettingsPath = hooksSource ? join148(dirname49(hooksSource), "settings.json") : undefined;
       const mergeResult = await migrateHooksSettings({
         sourceProvider: "claude-code",
         targetProvider: hooksProvider,
         installedHookFiles: entry.files,
         installedHookAbsolutePaths: successfulHookAbsPaths.get(hooksProvider),
-        global: entry.global
+        global: entry.global,
+        sourceSettingsPath,
+        sourceHooksDir: hooksSource ?? undefined
       });
       appendMigrationWarningMessages(postProgressWarnings, mergeResult.warnings);
       if (mergeResult.success && mergeResult.hooksRegistered > 0) {
@@ -114170,7 +114308,7 @@ Please use only one download method.`);
 // src/commands/plan/plan-command.ts
 init_output_manager();
 import { existsSync as existsSync74, statSync as statSync13 } from "node:fs";
-import { dirname as dirname52, isAbsolute as isAbsolute14, join as join153, parse as parse7, resolve as resolve53 } from "node:path";
+import { dirname as dirname53, isAbsolute as isAbsolute15, join as join153, parse as parse7, resolve as resolve53 } from "node:path";
 
 // src/commands/plan/plan-read-handlers.ts
 init_config();
@@ -114180,18 +114318,18 @@ init_logger();
 init_output_manager();
 var import_picocolors32 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync73, statSync as statSync12 } from "node:fs";
-import { basename as basename31, dirname as dirname50, join as join152, relative as relative32, resolve as resolve51 } from "node:path";
+import { basename as basename31, dirname as dirname51, join as join152, relative as relative32, resolve as resolve51 } from "node:path";
 
 // src/commands/plan/plan-dependencies.ts
 init_config();
 init_plan_parser();
 init_plans_registry();
 import { existsSync as existsSync72 } from "node:fs";
-import { dirname as dirname49, join as join151 } from "node:path";
+import { dirname as dirname50, join as join151 } from "node:path";
 async function resolvePlanDependencies(references, currentPlanFile, options2 = {}) {
   if (references.length === 0)
     return [];
-  const currentPlanDir = dirname49(currentPlanFile);
+  const currentPlanDir = dirname50(currentPlanFile);
   const projectRoot = findProjectRoot(currentPlanDir);
   const config = options2.preloadedConfig ?? (await CkConfigManager.loadFull(projectRoot)).config;
   const defaultScope = inferPlanScopeForDir(currentPlanDir, config);
@@ -114238,14 +114376,14 @@ init_config();
 init_plan_parser();
 init_plan_scope();
 init_plans_registry();
-import { isAbsolute as isAbsolute13, resolve as resolve50 } from "node:path";
+import { isAbsolute as isAbsolute14, resolve as resolve50 } from "node:path";
 async function getGlobalPlansDirFromCwd() {
   const projectRoot = findProjectRoot(process.cwd());
   const { config } = await CkConfigManager.loadFull(projectRoot);
   return resolveGlobalPlansDir(config);
 }
 function resolveTargetFromBase(target, baseDir) {
-  const resolvedTarget = isAbsolute13(target) ? resolve50(target) : resolve50(baseDir, target);
+  const resolvedTarget = isAbsolute14(target) ? resolve50(target) : resolve50(baseDir, target);
   return isWithinDir(resolvedTarget, baseDir) ? resolvedTarget : null;
 }
 
@@ -114278,7 +114416,7 @@ async function handleParse(target, options2) {
     console.log(JSON.stringify({ file: relative32(process.cwd(), planFile), frontmatter, phases }, null, 2));
     return;
   }
-  const title = typeof frontmatter.title === "string" ? frontmatter.title : basename31(dirname50(planFile));
+  const title = typeof frontmatter.title === "string" ? frontmatter.title : basename31(dirname51(planFile));
   console.log();
   console.log(import_picocolors32.default.bold(`  Plan: ${title}`));
   console.log(`  File: ${planFile}`);
@@ -114389,7 +114527,7 @@ async function handleStatus(target, options2) {
         const blockedBy2 = await resolvePlanDependencies(s.blockedBy, pf, { preloadedConfig });
         const blocks2 = await resolvePlanDependencies(s.blocks, pf, { preloadedConfig });
         const bar = progressBar(s.completed, s.totalPhases);
-        const title2 = s.title ?? basename31(dirname50(pf));
+        const title2 = s.title ?? basename31(dirname51(pf));
         console.log(`  ${import_picocolors32.default.bold(title2)}`);
         console.log(`  ${bar}`);
         if (s.inProgress > 0)
@@ -114408,7 +114546,7 @@ async function handleStatus(target, options2) {
         }
         console.log();
       } catch {
-        console.log(`  [X] Failed to read: ${basename31(dirname50(pf))}`);
+        console.log(`  [X] Failed to read: ${basename31(dirname51(pf))}`);
         console.log();
       }
     }
@@ -114435,7 +114573,7 @@ async function handleStatus(target, options2) {
     console.log(JSON.stringify({ ...summary, dependencyStatus: { blockedBy, blocks } }, null, 2));
     return;
   }
-  const title = summary.title ?? basename31(dirname50(planFile));
+  const title = summary.title ?? basename31(dirname51(planFile));
   console.log();
   console.log(import_picocolors32.default.bold(`  ${title}`));
   if (summary.status)
@@ -114498,7 +114636,7 @@ async function handleKanban(target, options2) {
     process.exitCode = 1;
     return;
   }
-  const route = `/plans?dir=${encodeURIComponent(dirname50(dirname50(planFile)))}&view=kanban`;
+  const route = `/plans?dir=${encodeURIComponent(dirname51(dirname51(planFile)))}&view=kanban`;
   const url = `http://localhost:${server.port}${route}`;
   console.log();
   console.log(import_picocolors32.default.bold("  ClaudeKit Dashboard — Plans"));
@@ -114533,7 +114671,7 @@ init_plan_parser();
 init_plans_registry();
 init_output_manager();
 var import_picocolors33 = __toESM(require_picocolors(), 1);
-import { basename as basename32, dirname as dirname51, relative as relative33, resolve as resolve52 } from "node:path";
+import { basename as basename32, dirname as dirname52, relative as relative33, resolve as resolve52 } from "node:path";
 function quoteReadTarget(filePath) {
   return `"${filePath.replace(/\\/g, "/").replace(/"/g, "\\\"")}"`;
 }
@@ -114647,7 +114785,7 @@ async function handleCheck(target, options2) {
     process.exitCode = 1;
     return;
   }
-  const planDir = dirname51(planFile);
+  const planDir = dirname52(planFile);
   let planStatus = "pending";
   try {
     const projectRoot = findProjectRoot(planDir);
@@ -114696,7 +114834,7 @@ async function handleUncheck(target, options2) {
     process.exitCode = 1;
     return;
   }
-  const planDir = dirname51(planFile);
+  const planDir = dirname52(planFile);
   try {
     const projectRoot = findProjectRoot(planDir);
     const summary = buildPlanSummary(planFile);
@@ -114735,7 +114873,7 @@ async function handleAddPhase(target, options2) {
   try {
     const result = addPhase(planFile, target, options2.after);
     try {
-      const planDir = dirname51(planFile);
+      const planDir = dirname52(planFile);
       const projectRoot = findProjectRoot(planDir);
       updateRegistryAddPhase({
         planDir,
@@ -114763,7 +114901,7 @@ function resolveTargetPath(target, baseDir) {
   if (!baseDir) {
     return resolve53(target);
   }
-  if (isAbsolute14(target)) {
+  if (isAbsolute15(target)) {
     return resolve53(target);
   }
   const cwdCandidate = resolve53(target);
@@ -114789,7 +114927,7 @@ function resolvePlanFile(target, baseDir) {
       const candidate = join153(dir, "plan.md");
       if (existsSync74(candidate))
         return candidate;
-      dir = dirname52(dir);
+      dir = dirname53(dir);
     }
   }
   return null;
@@ -116100,7 +116238,7 @@ var import_fs_extra44 = __toESM(require_lib(), 1);
 // src/commands/uninstall/analysis-handler.ts
 init_metadata_migration();
 import { readdirSync as readdirSync12, rmSync as rmSync7 } from "node:fs";
-import { dirname as dirname53, join as join157 } from "node:path";
+import { dirname as dirname54, join as join157 } from "node:path";
 init_logger();
 init_safe_prompts();
 var import_fs_extra42 = __toESM(require_lib(), 1);
@@ -116122,7 +116260,7 @@ function classifyFileByOwnership(ownership, forceOverwrite, deleteReason) {
 }
 async function cleanupEmptyDirectories3(filePath, installationRoot) {
   let cleaned = 0;
-  let currentDir = dirname53(filePath);
+  let currentDir = dirname54(filePath);
   while (currentDir !== installationRoot && currentDir.startsWith(installationRoot)) {
     try {
       const entries = readdirSync12(currentDir);
@@ -116130,7 +116268,7 @@ async function cleanupEmptyDirectories3(filePath, installationRoot) {
         rmSync7(currentDir, { recursive: true });
         cleaned++;
         logger.debug(`Removed empty directory: ${currentDir}`);
-        currentDir = dirname53(currentDir);
+        currentDir = dirname54(currentDir);
       } else {
         break;
       }
@@ -118258,7 +118396,7 @@ init_file_io();
 init_logger();
 import { existsSync as existsSync78 } from "node:fs";
 import { mkdir as mkdir41, readFile as readFile71 } from "node:fs/promises";
-import { dirname as dirname54 } from "node:path";
+import { dirname as dirname55 } from "node:path";
 var PROCESSED_ISSUES_CAP = 500;
 async function readCkJson(projectDir) {
   const configPath = CkConfigManager.getProjectConfigPath(projectDir);
@@ -118288,7 +118426,7 @@ async function loadWatchState(projectDir) {
 }
 async function saveWatchState(projectDir, state) {
   const configPath = CkConfigManager.getProjectConfigPath(projectDir);
-  const configDir = dirname54(configPath);
+  const configDir = dirname55(configPath);
   if (!existsSync78(configDir)) {
     await mkdir41(configDir, { recursive: true });
   }
@@ -118962,7 +119100,7 @@ function registerCommands(cli) {
 // src/cli/version-display.ts
 init_package();
 init_config_version_checker();
-import { existsSync as existsSync94, readFileSync as readFileSync26 } from "node:fs";
+import { existsSync as existsSync94, readFileSync as readFileSync27 } from "node:fs";
 import { join as join178 } from "node:path";
 
 // src/domains/versioning/version-checker.ts
@@ -119302,7 +119440,7 @@ async function displayVersion() {
   const isLocalSameAsGlobal = localMetadataPath === globalMetadataPath;
   if (!isLocalSameAsGlobal && existsSync94(localMetadataPath)) {
     try {
-      const rawMetadata = JSON.parse(readFileSync26(localMetadataPath, "utf-8"));
+      const rawMetadata = JSON.parse(readFileSync27(localMetadataPath, "utf-8"));
       const metadata = MetadataSchema.parse(rawMetadata);
       const kitsDisplay = formatInstalledKits(metadata);
       if (kitsDisplay) {
@@ -119316,7 +119454,7 @@ async function displayVersion() {
   }
   if (existsSync94(globalMetadataPath)) {
     try {
-      const rawMetadata = JSON.parse(readFileSync26(globalMetadataPath, "utf-8"));
+      const rawMetadata = JSON.parse(readFileSync27(globalMetadataPath, "utf-8"));
       const metadata = MetadataSchema.parse(rawMetadata);
       const kitsDisplay = formatInstalledKits(metadata);
       if (kitsDisplay) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "4.5.0-dev.6",
+	"version": "4.5.0-dev.7",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {