claudekit-cli 4.3.1-dev.10 → 4.3.1-dev.12

package/bin/postinstall-self-heal.cjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const MAX_SETTINGS_BYTES = 5 * 1024 * 1024;
+
+function isLegacyDescriptiveNamePrompt(entry) {
+	if (!entry || entry.type !== "prompt" || typeof entry.prompt !== "string") return false;
+
+	const prompt = entry.prompt;
+	const lowerPrompt = prompt.toLowerCase();
+	const isOriginalLegacyPrompt =
+		prompt.includes("Use kebab-case file naming") &&
+		prompt.includes("self-documenting") &&
+		prompt.includes("Grep, Glob, Search");
+	const isDescriptiveNameKebabPrompt =
+		lowerPrompt.includes("descriptive-name") &&
+		lowerPrompt.includes("kebab-case") &&
+		(lowerPrompt.includes("file") || lowerPrompt.includes("filename"));
+
+	return isOriginalLegacyPrompt || isDescriptiveNameKebabPrompt;
+}
+
+function pruneHooks(settings) {
+	if (!settings || typeof settings !== "object" || !settings.hooks) return 0;
+
+	let pruned = 0;
+	for (const [eventName, entries] of Object.entries(settings.hooks)) {
+		if (!Array.isArray(entries)) continue;
+
+		const keptEntries = [];
+		for (const entry of entries) {
+			if (isLegacyDescriptiveNamePrompt(entry)) {
+				pruned++;
+				continue;
+			}
+
+			if (Array.isArray(entry?.hooks)) {
+				const keptHooks = entry.hooks.filter((hook) => {
+					if (isLegacyDescriptiveNamePrompt(hook)) {
+						pruned++;
+						return false;
+					}
+					return true;
+				});
+				if (keptHooks.length > 0) keptEntries.push({ ...entry, hooks: keptHooks });
+				continue;
+			}
+
+			keptEntries.push(entry);
+		}
+
+		if (keptEntries.length === 0) {
+			delete settings.hooks[eventName];
+		} else {
+			settings.hooks[eventName] = keptEntries;
+		}
+	}
+
+	if (Object.keys(settings.hooks).length === 0) settings.hooks = undefined;
+	return pruned;
+}
+
+function pruneSettingsFile(filePath) {
+	try {
+		if (!filePath || !fs.existsSync(filePath)) return 0;
+		const stat = fs.statSync(filePath);
+		if (!stat.isFile() || stat.size > MAX_SETTINGS_BYTES) return 0;
+
+		const settings = JSON.parse(fs.readFileSync(filePath, "utf8"));
+		const pruned = pruneHooks(settings);
+		if (pruned > 0) {
+			fs.writeFileSync(filePath, `${JSON.stringify(settings, null, 2)}\n`);
+		}
+		return pruned;
+	} catch {
+		return 0;
+	}
+}
+
+function getHomeDir() {
+	return process.env.CK_TEST_HOME || os.homedir();
+}
+
+function addIfSettingsFile(files, filePath) {
+	if (!filePath) return;
+	const base = path.basename(filePath);
+	if (
+		base === "settings.json" ||
+		base === "settings.local.json" ||
+		base.endsWith(".settings.json")
+	) {
+		files.add(path.resolve(filePath));
+	}
+}
+
+function collectCandidateSettingsFiles() {
+	const files = new Set();
+	const initCwd = process.env.INIT_CWD;
+	if (initCwd && path.isAbsolute(initCwd)) {
+		addIfSettingsFile(files, path.join(initCwd, ".claude", "settings.json"));
+		addIfSettingsFile(files, path.join(initCwd, ".claude", "settings.local.json"));
+	}
+
+	const homeDir = getHomeDir();
+	const globalClaudeDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, ".claude");
+	addIfSettingsFile(files, path.join(globalClaudeDir, "settings.json"));
+	addIfSettingsFile(files, path.join(globalClaudeDir, "settings.local.json"));
+
+	const ccsDir = process.env.CK_TEST_CCS_DIR || path.join(homeDir, ".ccs");
+	try {
+		for (const dirent of fs.readdirSync(ccsDir, { withFileTypes: true })) {
+			if (dirent.isFile()) addIfSettingsFile(files, path.join(ccsDir, dirent.name));
+		}
+	} catch {
+		// Optional compatibility directory; skip when absent or unreadable.
+	}
+
+	return [...files];
+}
+
+function main() {
+	let pruned = 0;
+	for (const filePath of collectCandidateSettingsFiles()) {
+		pruned += pruneSettingsFile(filePath);
+	}
+
+	if (pruned > 0 && process.env.CK_POSTINSTALL_DEBUG === "1") {
+		console.warn(`[claudekit-cli] Pruned ${pruned} legacy hook prompt(s)`);
+	}
+}
+
+main();
+
+module.exports = {
+	collectCandidateSettingsFiles,
+	isLegacyDescriptiveNamePrompt,
+	pruneHooks,
+	pruneSettingsFile,
+};

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "4.3.1-dev.10",
-	"generatedAt": "2026-05-21T01:08:27.917Z",
+	"version": "4.3.1-dev.12",
+	"generatedAt": "2026-05-21T01:53:05.956Z",
 	"commands": {
 		"agents": {
 			"name": "agents",

package/dist/index.js

@@ -63357,7 +63357,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "4.3.1-dev.10",
+    version: "4.3.1-dev.12",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -63373,6 +63373,7 @@ var init_package = __esm(() => {
     },
     files: [
       "bin/ck.js",
+      "bin/postinstall-self-heal.cjs",
       "dist/index.js",
       "dist/ui/",
       "cli-manifest.json"
@@ -63404,6 +63405,7 @@ var init_package = __esm(() => {
       "ci:local": "bash scripts/ci-local.sh",
       "install:hooks": "./.githooks/install.sh",
       prepare: `node -e "try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}"`,
+      postinstall: "node bin/postinstall-self-heal.cjs",
       "help:check-parity": "bun run scripts/check-help-parity.ts",
       "manifest:generate": "bun run scripts/generate-cli-manifest.ts",
       "docs:generate": "bun run scripts/generate-cli-reference.ts",
@@ -63903,7 +63905,10 @@ function isLegacyDescriptiveNamePrompt(entry) {
   const prompt = entry.prompt;
   if (entry.type !== "prompt" || typeof prompt !== "string")
     return false;
-  return prompt.includes("Use kebab-case file naming") && prompt.includes("self-documenting") && prompt.includes("Grep, Glob, Search");
+  const lowerPrompt = prompt.toLowerCase();
+  const isOriginalLegacyPrompt = prompt.includes("Use kebab-case file naming") && prompt.includes("self-documenting") && prompt.includes("Grep, Glob, Search");
+  const isDescriptiveNameKebabPrompt = lowerPrompt.includes("descriptive-name") && lowerPrompt.includes("kebab-case") && (lowerPrompt.includes("file") || lowerPrompt.includes("filename"));
+  return isOriginalLegacyPrompt || isDescriptiveNameKebabPrompt;
 }
 function extractHookFilePath(command, hookDir) {
   if (!command)
@@ -63986,7 +63991,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 existsSync45, readFileSync as readFileSync12, statSync as statSync9, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync45, readFileSync as readFileSync12, readdirSync as readdirSync8, statSync as statSync9, writeFileSync as writeFileSync5 } from "node:fs";
 import { readdir as readdir17 } from "node:fs/promises";
 import { homedir as homedir41, tmpdir } from "node:os";
 import { join as join64, resolve as resolve33 } from "node:path";
@@ -64023,6 +64028,7 @@ function getCanonicalGlobalCommandRoot() {
 }
 function getClaudeSettingsFiles(projectDir) {
   const globalClaudeDir = PathResolver.getGlobalKitDir();
+  const ccsSettingsDir = join64(process.env.CK_TEST_HOME ?? homedir41(), ".ccs");
   const candidates = [
     {
       path: resolve33(projectDir, ".claude", "settings.json"),
@@ -64045,6 +64051,17 @@ function getClaudeSettingsFiles(projectDir) {
       root: getCanonicalGlobalCommandRoot()
     }
   ];
+  try {
+    for (const dirent of readdirSync8(ccsSettingsDir, { withFileTypes: true })) {
+      if (!dirent.isFile() || !dirent.name.endsWith(".settings.json"))
+        continue;
+      candidates.push({
+        path: resolve33(ccsSettingsDir, dirent.name),
+        label: `.ccs/${dirent.name}`,
+        root: "$HOME"
+      });
+    }
+  } catch {}
   return candidates.filter((candidate) => existsSync45(candidate.path));
 }
 function isAlreadyCanonical(cmd) {
@@ -76416,7 +76433,7 @@ var init_content_validator = __esm(() => {
 
 // src/commands/content/phases/context-cache-manager.ts
 import { createHash as createHash9 } from "node:crypto";
-import { existsSync as existsSync79, mkdirSync as mkdirSync5, readFileSync as readFileSync18, readdirSync as readdirSync12, statSync as statSync14 } from "node:fs";
+import { existsSync as existsSync79, mkdirSync as mkdirSync5, readFileSync as readFileSync18, readdirSync as readdirSync13, statSync as statSync14 } from "node:fs";
 import { rename as rename16, writeFile as writeFile40 } from "node:fs/promises";
 import { homedir as homedir55 } from "node:os";
 import { basename as basename34, join as join160 } from "node:path";
@@ -76465,7 +76482,7 @@ function getDocSourcePaths(repoPath) {
   const docsDir = join160(repoPath, "docs");
   if (existsSync79(docsDir)) {
     try {
-      const files = readdirSync12(docsDir);
+      const files = readdirSync13(docsDir);
       for (const f3 of files) {
         if (f3.endsWith(".md"))
           paths.push(join160(docsDir, f3));
@@ -76478,7 +76495,7 @@ function getDocSourcePaths(repoPath) {
   const stylesDir = join160(repoPath, "assets", "writing-styles");
   if (existsSync79(stylesDir)) {
     try {
-      const files = readdirSync12(stylesDir);
+      const files = readdirSync13(stylesDir);
       for (const f3 of files) {
         paths.push(join160(stylesDir, f3));
       }
@@ -76673,7 +76690,7 @@ function extractContentFromResponse(response) {
 
 // src/commands/content/phases/docs-summarizer.ts
 import { execSync as execSync7 } from "node:child_process";
-import { existsSync as existsSync80, readFileSync as readFileSync19, readdirSync as readdirSync13 } from "node:fs";
+import { existsSync as existsSync80, readFileSync as readFileSync19, readdirSync as readdirSync14 } from "node:fs";
 import { join as join161 } from "node:path";
 async function summarizeProjectDocs(repoPath, contentLogger) {
   const rawContent = collectRawDocs(repoPath);
@@ -76731,7 +76748,7 @@ function collectRawDocs(repoPath) {
   const docsDir = join161(repoPath, "docs");
   if (existsSync80(docsDir)) {
     try {
-      const files = readdirSync13(docsDir).filter((f3) => f3.endsWith(".md")).sort();
+      const files = readdirSync14(docsDir).filter((f3) => f3.endsWith(".md")).sort();
       for (const f3 of files) {
         const content = readCapped(join161(docsDir, f3), 5000);
         if (content) {
@@ -76755,7 +76772,7 @@ ${content}`);
   const stylesDir = join161(repoPath, "assets", "writing-styles");
   if (existsSync80(stylesDir)) {
     try {
-      const files = readdirSync13(stylesDir).slice(0, 3);
+      const files = readdirSync14(stylesDir).slice(0, 3);
       styles3 = files.map((f3) => readCapped(join161(stylesDir, f3), 1000)).filter(Boolean).join(`
 
 `);
@@ -76946,7 +76963,7 @@ IMPORTANT: Generate the image and output the path as JSON: {"imagePath": "/path/
 
 // src/commands/content/phases/photo-generator.ts
 import { execSync as execSync8 } from "node:child_process";
-import { existsSync as existsSync81, mkdirSync as mkdirSync6, readdirSync as readdirSync14 } from "node:fs";
+import { existsSync as existsSync81, mkdirSync as mkdirSync6, readdirSync as readdirSync15 } from "node:fs";
 import { homedir as homedir56 } from "node:os";
 import { join as join162 } from "node:path";
 async function generatePhoto(_content, context, config, platform18, contentId, contentLogger) {
@@ -76971,7 +76988,7 @@ async function generatePhoto(_content, context, config, platform18, contentId, c
         return { path: imagePath, ...dimensions, format: "png" };
       }
     }
-    const files = readdirSync14(mediaDir);
+    const files = readdirSync15(mediaDir);
     const imageFile = files.find((f3) => /\.(png|jpg|jpeg|webp)$/i.test(f3));
     if (imageFile) {
       const ext2 = imageFile.split(".").pop() ?? "png";
@@ -77358,7 +77375,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 existsSync84, readFileSync as readFileSync20, readdirSync as readdirSync15, statSync as statSync16 } from "node:fs";
+import { existsSync as existsSync84, readFileSync as readFileSync20, readdirSync as readdirSync16, statSync as statSync16 } from "node:fs";
 import { join as join164 } from "node:path";
 function detectCommits(repo, since) {
   try {
@@ -77474,7 +77491,7 @@ function detectCompletedPlans(repo, since) {
   const sinceMs = new Date(since).getTime();
   const events = [];
   try {
-    const entries = readdirSync15(plansDir, { withFileTypes: true });
+    const entries = readdirSync16(plansDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
@@ -77555,7 +77572,7 @@ function classifyCommit(event) {
 
 // src/commands/content/phases/repo-discoverer.ts
 import { execSync as execSync11 } from "node:child_process";
-import { readdirSync as readdirSync16 } from "node:fs";
+import { readdirSync as readdirSync17 } from "node:fs";
 import { join as join165 } from "node:path";
 function discoverRepos2(cwd2) {
   const repos = [];
@@ -77565,7 +77582,7 @@ function discoverRepos2(cwd2) {
       repos.push(info);
   }
   try {
-    const entries = readdirSync16(cwd2, { withFileTypes: true });
+    const entries = readdirSync17(cwd2, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory() || entry.name.startsWith("."))
         continue;
@@ -100779,7 +100796,7 @@ async function handleDownload(ctx) {
 import { join as join120 } from "node:path";
 
 // src/domains/installation/deletion-handler.ts
-import { existsSync as existsSync65, lstatSync as lstatSync3, readdirSync as readdirSync8, rmSync as rmSync2, rmdirSync, unlinkSync as unlinkSync4 } from "node:fs";
+import { existsSync as existsSync65, lstatSync as lstatSync3, readdirSync as readdirSync9, rmSync as rmSync2, rmdirSync, unlinkSync as unlinkSync4 } from "node:fs";
 import { dirname as dirname35, join as join106, relative as relative21, resolve as resolve41, sep as sep12 } from "node:path";
 
 // src/services/file-operations/manifest/manifest-reader.ts
@@ -100973,7 +100990,7 @@ function collectFilesRecursively(dir, baseDir) {
   if (!existsSync65(dir))
     return results;
   try {
-    const entries = readdirSync8(dir, { withFileTypes: true });
+    const entries = readdirSync9(dir, { withFileTypes: true });
     for (const entry of entries) {
       const fullPath = join106(dir, entry.name);
       const relativePath = relative21(baseDir, fullPath);
@@ -101011,7 +101028,7 @@ function cleanupEmptyDirectories(filePath, claudeDir3) {
   while (currentDir !== normalizedClaudeDir && currentDir.startsWith(normalizedClaudeDir) && iterations < MAX_CLEANUP_ITERATIONS) {
     iterations++;
     try {
-      const entries = readdirSync8(currentDir);
+      const entries = readdirSync9(currentDir);
       if (entries.length === 0) {
         rmdirSync(currentDir);
         logger.debug(`Removed empty directory: ${currentDir}`);
@@ -106747,7 +106764,7 @@ async function runPreflightChecks() {
 
 // src/domains/installation/fresh-installer.ts
 init_metadata_migration();
-import { existsSync as existsSync67, readdirSync as readdirSync9, rmSync as rmSync3, rmdirSync as rmdirSync2, unlinkSync as unlinkSync5 } from "node:fs";
+import { existsSync as existsSync67, readdirSync as readdirSync10, rmSync as rmSync3, rmdirSync as rmdirSync2, unlinkSync as unlinkSync5 } from "node:fs";
 import { basename as basename28, dirname as dirname39, join as join132, resolve as resolve45 } from "node:path";
 init_logger();
 init_safe_spinner();
@@ -106804,7 +106821,7 @@ function cleanupEmptyDirectories2(filePath, claudeDir3) {
   let currentDir = resolve45(dirname39(filePath));
   while (currentDir !== normalizedClaudeDir && currentDir.startsWith(normalizedClaudeDir)) {
     try {
-      const entries = readdirSync9(currentDir);
+      const entries = readdirSync10(currentDir);
       if (entries.length === 0) {
         rmdirSync2(currentDir);
         logger.debug(`Removed empty directory: ${currentDir}`);
@@ -108487,6 +108504,19 @@ async function repairMissingHookFileReferencesAfterInit(ctx) {
     logger.debug(`Hook file reference repair skipped after init: ${error instanceof Error ? error.message : "unknown"}`);
   }
 }
+async function repairLegacyHookPromptsAfterInit(ctx) {
+  if (!ctx.resolvedDir)
+    return;
+  const projectDir = ctx.options.global ? process.cwd() : ctx.resolvedDir;
+  try {
+    const repaired = await repairLegacyHookPrompts(projectDir);
+    if (repaired > 0) {
+      logger.info(`Pruned ${repaired} legacy hook prompt(s)`);
+    }
+  } catch (error) {
+    logger.debug(`Legacy hook prompt repair skipped after init: ${error instanceof Error ? error.message : "unknown"}`);
+  }
+}
 async function executeInit(options2, prompts) {
   let ctx = createInitContext(options2, prompts);
   ctx = await resolveOptions(ctx);
@@ -108560,6 +108590,7 @@ async function executeInit(options2, prompts) {
 Installed ${installedKits.length} kits: ${installedKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
   }
   if (!isSyncMode) {
+    await repairLegacyHookPromptsAfterInit(ctx);
     await repairMissingHookFileReferencesAfterInit(ctx);
   }
   prompts.outro(`Project initialized successfully at ${ctx.resolvedDir}`);
@@ -113348,7 +113379,7 @@ async function detectInstallations() {
 }
 
 // src/commands/uninstall/removal-handler.ts
-import { readdirSync as readdirSync11, rmSync as rmSync5 } from "node:fs";
+import { readdirSync as readdirSync12, rmSync as rmSync5 } from "node:fs";
 import { basename as basename33, join as join152, resolve as resolve58, sep as sep14 } from "node:path";
 init_logger();
 init_safe_prompts();
@@ -113357,7 +113388,7 @@ var import_fs_extra42 = __toESM(require_lib(), 1);
 
 // src/commands/uninstall/analysis-handler.ts
 init_metadata_migration();
-import { readdirSync as readdirSync10, rmSync as rmSync4 } from "node:fs";
+import { readdirSync as readdirSync11, rmSync as rmSync4 } from "node:fs";
 import { dirname as dirname48, join as join151 } from "node:path";
 init_logger();
 init_safe_prompts();
@@ -113383,7 +113414,7 @@ async function cleanupEmptyDirectories3(filePath, installationRoot) {
   let currentDir = dirname48(filePath);
   while (currentDir !== installationRoot && currentDir.startsWith(installationRoot)) {
     try {
-      const entries = readdirSync10(currentDir);
+      const entries = readdirSync11(currentDir);
       if (entries.length === 0) {
         rmSync4(currentDir, { recursive: true });
         cleaned++;
@@ -113627,7 +113658,7 @@ async function removeInstallations(installations, options2) {
           }
         }
         try {
-          const remaining = readdirSync11(installation.path);
+          const remaining = readdirSync12(installation.path);
           if (remaining.length === 0) {
             rmSync5(installation.path, { recursive: true });
             logger.debug(`Removed empty installation directory: ${installation.path}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "4.3.1-dev.10",
+	"version": "4.3.1-dev.12",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {
@@ -16,6 +16,7 @@
 	},
 	"files": [
 		"bin/ck.js",
+		"bin/postinstall-self-heal.cjs",
 		"dist/index.js",
 		"dist/ui/",
 		"cli-manifest.json"
@@ -47,6 +48,7 @@
 		"ci:local": "bash scripts/ci-local.sh",
 		"install:hooks": "./.githooks/install.sh",
 		"prepare": "node -e \"try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}\"",
+		"postinstall": "node bin/postinstall-self-heal.cjs",
 		"help:check-parity": "bun run scripts/check-help-parity.ts",
 		"manifest:generate": "bun run scripts/generate-cli-manifest.ts",
 		"docs:generate": "bun run scripts/generate-cli-reference.ts",