claudekit-cli 3.41.4-dev.34 → 3.41.4-dev.35

package/dist/index.js

@@ -60747,7 +60747,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.41.4-dev.34",
+    version: "3.41.4-dev.35",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -84026,6 +84026,199 @@ async function checkHookCommandPaths(projectDir) {
     }
   };
 }
+function extractHookScriptPath(cmd) {
+  if (!cmd)
+    return null;
+  const stripped = cmd.replace(/"/g, "");
+  const match = stripped.match(/\bnode\s+(\S*?\.claude[/\\]\S+?\.cjs)(?:\s|$)/);
+  if (!match)
+    return null;
+  return match[1];
+}
+function resolveHookScriptPath(scriptPath, projectDir) {
+  let resolved = scriptPath.replace(/\\/g, "/");
+  const home9 = homedir40();
+  resolved = resolved.replace(/^\$\{?HOME\}?/, home9);
+  resolved = resolved.replace(/^\$\{?CLAUDE_PROJECT_DIR\}?/, projectDir);
+  resolved = resolved.replace(/^%USERPROFILE%/, home9);
+  resolved = resolved.replace(/^%CLAUDE_PROJECT_DIR%/, projectDir);
+  resolved = resolved.replace(/^~\//, `${home9}/`);
+  if (resolved.startsWith(".claude/") || resolved === ".claude") {
+    resolved = join84(projectDir, resolved);
+  }
+  return resolve26(resolved);
+}
+function collectMissingHookReferences(settings, settingsFile, projectDir) {
+  if (!settings.hooks)
+    return [];
+  const findings = [];
+  const seen = new Set;
+  const consider = (eventName, command, matcher) => {
+    if (!command)
+      return;
+    const scriptPath = extractHookScriptPath(command);
+    if (!scriptPath)
+      return;
+    const resolvedPath = resolveHookScriptPath(scriptPath, projectDir);
+    if (existsSync53(resolvedPath))
+      return;
+    const key = `${settingsFile.path}::${eventName}::${matcher ?? ""}::${scriptPath}`;
+    if (seen.has(key))
+      return;
+    seen.add(key);
+    findings.push({
+      path: settingsFile.path,
+      label: settingsFile.label,
+      eventName,
+      matcher,
+      command,
+      scriptPath,
+      resolvedPath
+    });
+  };
+  for (const [eventName, entries] of Object.entries(settings.hooks)) {
+    for (const entry of entries) {
+      if ("command" in entry && typeof entry.command === "string") {
+        consider(eventName, entry.command, undefined);
+      }
+      if ("hooks" in entry && entry.hooks) {
+        const matcher = "matcher" in entry ? entry.matcher : undefined;
+        for (const hook of entry.hooks) {
+          consider(eventName, hook.command, matcher);
+        }
+      }
+    }
+  }
+  return findings;
+}
+async function pruneMissingHookReferencesInSettingsFile(settingsFile, projectDir) {
+  const settings = await SettingsMerger.readSettingsFile(settingsFile.path);
+  if (!settings?.hooks)
+    return 0;
+  let pruned = 0;
+  const hookFileMissing = (command) => {
+    if (!command)
+      return false;
+    const scriptPath = extractHookScriptPath(command);
+    if (!scriptPath)
+      return false;
+    return !existsSync53(resolveHookScriptPath(scriptPath, projectDir));
+  };
+  const hooksRecord = settings.hooks;
+  for (const [eventName, entries] of Object.entries(hooksRecord)) {
+    const filteredEntries = [];
+    for (const entry of entries) {
+      const e2 = entry;
+      if (typeof e2.command === "string") {
+        if (hookFileMissing(e2.command)) {
+          pruned++;
+          continue;
+        }
+        filteredEntries.push(entry);
+        continue;
+      }
+      if (Array.isArray(e2.hooks)) {
+        const keptHooks = e2.hooks.filter((h2) => {
+          if (hookFileMissing(h2.command)) {
+            pruned++;
+            return false;
+          }
+          return true;
+        });
+        if (keptHooks.length === 0) {
+          continue;
+        }
+        filteredEntries.push({ ...e2, hooks: keptHooks });
+        continue;
+      }
+      filteredEntries.push(entry);
+    }
+    if (filteredEntries.length === 0) {
+      delete hooksRecord[eventName];
+    } else {
+      hooksRecord[eventName] = filteredEntries;
+    }
+  }
+  if (Object.keys(hooksRecord).length === 0) {
+    delete settings.hooks;
+  }
+  if (pruned > 0) {
+    await SettingsMerger.writeSettingsFile(settingsFile.path, settings);
+  }
+  return pruned;
+}
+async function checkHookFileReferences(projectDir) {
+  const settingsFiles = getClaudeSettingsFiles(projectDir);
+  if (settingsFiles.length === 0) {
+    return {
+      id: "hook-file-references",
+      name: "Hook File References",
+      group: "claudekit",
+      priority: "critical",
+      status: "info",
+      message: "No Claude settings files",
+      autoFixable: false
+    };
+  }
+  const findings = [];
+  for (const settingsFile of settingsFiles) {
+    const settings = await SettingsMerger.readSettingsFile(settingsFile.path);
+    if (!settings)
+      continue;
+    findings.push(...collectMissingHookReferences(settings, settingsFile, projectDir));
+  }
+  if (findings.length === 0) {
+    return {
+      id: "hook-file-references",
+      name: "Hook File References",
+      group: "claudekit",
+      priority: "critical",
+      status: "pass",
+      message: "All referenced hook files exist",
+      autoFixable: false
+    };
+  }
+  const details = findings.slice(0, 8).map((f3) => {
+    const matcher = f3.matcher ? ` [${f3.matcher}]` : "";
+    return `${f3.label} :: ${f3.eventName}${matcher} :: missing ${f3.scriptPath}`;
+  }).join(`
+`);
+  return {
+    id: "hook-file-references",
+    name: "Hook File References",
+    group: "claudekit",
+    priority: "critical",
+    status: "fail",
+    message: `${findings.length} settings hook(s) reference missing file(s)`,
+    details,
+    suggestion: "Run: ck doctor --fix (prunes stale entries), then 'ck init' to restore hooks",
+    autoFixable: true,
+    fix: {
+      id: "fix-hook-file-references",
+      description: "Prune stale hook entries whose script files are missing",
+      execute: async () => {
+        try {
+          let pruned = 0;
+          for (const settingsFile of settingsFiles) {
+            pruned += await pruneMissingHookReferencesInSettingsFile(settingsFile, projectDir);
+          }
+          if (pruned === 0) {
+            return { success: true, message: "No stale hook entries needed pruning" };
+          }
+          return {
+            success: true,
+            message: `Pruned ${pruned} stale hook entry(ies). Run 'ck init' to restore hooks if needed.`
+          };
+        } catch (error) {
+          return {
+            success: false,
+            message: `Failed to prune stale hook entries: ${error}`
+          };
+        }
+      }
+    }
+  };
+}
 async function checkHookConfig(projectDir) {
   const projectConfigPath = join84(projectDir, ".claude", ".ck.json");
   const globalConfigPath = join84(PathResolver.getGlobalKitDir(), ".ck.json");
@@ -84527,6 +84720,8 @@ class ClaudekitChecker {
     results.push(await checkHookRuntime(this.projectDir));
     logger.verbose("ClaudekitChecker: Checking hook command paths");
     results.push(await checkHookCommandPaths(this.projectDir));
+    logger.verbose("ClaudekitChecker: Checking hook file references");
+    results.push(await checkHookFileReferences(this.projectDir));
     logger.verbose("ClaudekitChecker: Checking hook config");
     results.push(await checkHookConfig(this.projectDir));
     logger.verbose("ClaudekitChecker: Checking hook crash logs");
@@ -103376,7 +103571,7 @@ import { readFile as readFile58, readdir as readdir42, writeFile as writeFile32
 import { homedir as homedir44, platform as platform15 } from "node:os";
 import { extname as extname6, join as join137 } from "node:path";
 var IS_WINDOWS3 = platform15() === "win32";
-var HOME_PREFIX = IS_WINDOWS3 ? "%USERPROFILE%" : "$HOME";
+var HOME_PREFIX = "$HOME";
 function getHomeDirPrefix() {
   return HOME_PREFIX;
 }
@@ -103428,20 +103623,12 @@ function transformContent(content, options2 = {}) {
   const homePrefix = getHomeDirPrefix();
   const customGlobalClaudeDir = getCustomGlobalClaudeDir(options2.targetClaudeDir);
   const claudePath = getGlobalClaudePath(options2.targetClaudeDir);
-  if (IS_WINDOWS3) {
-    const homePathResult = replaceTracked(transformed, /\$HOME\/\.claude\//g, claudePath);
-    transformed = homePathResult.content;
-    changes += homePathResult.changes;
-    const braceHomePathResult = replaceTracked(transformed, /\$\{HOME\}\/\.claude\//g, claudePath);
-    transformed = braceHomePathResult.content;
-    changes += braceHomePathResult.changes;
-    const homePrefixResult = replaceTracked(transformed, /\$HOME(?=\/|\\)/g, homePrefix);
-    transformed = homePrefixResult.content;
-    changes += homePrefixResult.changes;
-    const braceHomePrefixResult = replaceTracked(transformed, /\$\{HOME\}(?=\/|\\)/g, homePrefix);
-    transformed = braceHomePrefixResult.content;
-    changes += braceHomePrefixResult.changes;
-  }
+  const userProfileClaudeResult = replaceTracked(transformed, /%USERPROFILE%[\\/]\.claude[\\/]/g, claudePath);
+  transformed = userProfileClaudeResult.content;
+  changes += userProfileClaudeResult.changes;
+  const userProfileStandaloneResult = replaceTracked(transformed, /%USERPROFILE%(?=[\\/])/g, homePrefix);
+  transformed = userProfileStandaloneResult.content;
+  changes += userProfileStandaloneResult.changes;
   const projectDirPathResult = replaceTracked(transformed, /\$CLAUDE_PROJECT_DIR\/\.claude\//g, claudePath);
   transformed = projectDirPathResult.content;
   changes += projectDirPathResult.changes;
@@ -103452,11 +103639,9 @@ function transformContent(content, options2 = {}) {
   const braceProjectDirPathResult = replaceTracked(transformed, /\$\{CLAUDE_PROJECT_DIR\}\/\.claude\//g, claudePath);
   transformed = braceProjectDirPathResult.content;
   changes += braceProjectDirPathResult.changes;
-  if (IS_WINDOWS3) {
-    const windowsProjectDirPathResult = replaceTracked(transformed, /%CLAUDE_PROJECT_DIR%\/\.claude\//g, claudePath);
-    transformed = windowsProjectDirPathResult.content;
-    changes += windowsProjectDirPathResult.changes;
-  }
+  const windowsProjectDirPathResult = replaceTracked(transformed, /%CLAUDE_PROJECT_DIR%[\\/]\.claude[\\/]/g, claudePath);
+  transformed = windowsProjectDirPathResult.content;
+  changes += windowsProjectDirPathResult.changes;
   const relativeClaudePathResult = replaceTracked(transformed, /\.\/\.claude\//g, claudePath);
   transformed = relativeClaudePathResult.content;
   changes += relativeClaudePathResult.changes;

package/package.json

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