claudekit-cli 4.3.1-dev.17 → 4.3.1-dev.19

package/bin/postinstall-hook-restore.cjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const MAX_SETTINGS_BYTES = 5 * 1024 * 1024;
+const SAFE_KIT_NAMES = new Set(["engineer", "marketing"]);
+
+function getHomeDir() {
+	return process.env.CK_TEST_HOME || os.homedir();
+}
+
+function readJsonFile(filePath) {
+	try {
+		if (!filePath || !fs.existsSync(filePath)) return null;
+		const stat = fs.statSync(filePath);
+		if (!stat.isFile() || stat.size > MAX_SETTINGS_BYTES) return null;
+		return JSON.parse(fs.readFileSync(filePath, "utf8").replace(/^\uFEFF/, ""));
+	} catch {
+		return null;
+	}
+}
+
+function normalizeCommand(command) {
+	if (!command) return "";
+	let normalized = String(command).replace(/"/g, "");
+	normalized = normalized.replace(/~\//g, "$HOME/");
+	normalized = normalized.replace(/\$\{HOME\}/g, "$HOME");
+	normalized = normalized.replace(/\$CLAUDE_PROJECT_DIR/g, "$HOME");
+	normalized = normalized.replace(/%USERPROFILE%/g, "$HOME");
+	normalized = normalized.replace(/%CLAUDE_PROJECT_DIR%/g, "$HOME");
+	normalized = normalized.replace(/(^|\s)(?:\.\/)?\.claude\//g, "$1$HOME/.claude/");
+	normalized = normalized.replace(/\\/g, "/");
+	return normalized.replace(/\s+/g, " ").trim();
+}
+
+function collectHookCommands(settings) {
+	const commands = new Set();
+	for (const entries of Object.values(settings?.hooks || {})) {
+		if (!Array.isArray(entries)) continue;
+		for (const entry of entries) {
+			if (typeof entry?.command === "string") commands.add(normalizeCommand(entry.command));
+			if (!Array.isArray(entry?.hooks)) continue;
+			for (const hook of entry.hooks) {
+				if (typeof hook?.command === "string") commands.add(normalizeCommand(hook.command));
+			}
+		}
+	}
+	return commands;
+}
+
+function extractCkHookName(command) {
+	if (!String(command || "").trim().startsWith("node ")) return null;
+	const normalized = String(command).replace(/\\/g, "/");
+	const match = normalized.match(/\/hooks\/([^/"'\s]+)\.(?:cjs|mjs|js)(?:["'\s]|$)/);
+	return match?.[1] || null;
+}
+
+function installedHookCommands(config) {
+	return Object.values(config?.kits || {}).flatMap((entry) =>
+		Array.isArray(entry?.installedSettings?.hooks) ? entry.installedSettings.hooks : [],
+	);
+}
+
+function countMissingCkHookRegistrations(claudeDir) {
+	const settings = readJsonFile(path.join(claudeDir, "settings.json"));
+	const config = readJsonFile(path.join(claudeDir, ".ck.json"));
+	if (!settings || !config) return 0;
+
+	const existingCommands = collectHookCommands(settings);
+	const disabledHooks = new Set(
+		Object.entries(config.hooks || {})
+			.filter(([, enabled]) => enabled === false)
+			.map(([name]) => name),
+	);
+
+	let missing = 0;
+	for (const command of installedHookCommands(config)) {
+		const hookName = extractCkHookName(command);
+		if (hookName && disabledHooks.has(hookName)) continue;
+		if (!existingCommands.has(normalizeCommand(command))) missing++;
+	}
+	return missing;
+}
+
+function normalizeKitName(name) {
+	const normalized = String(name || "").toLowerCase();
+	if (normalized.includes("engineer")) return "engineer";
+	if (normalized.includes("marketing")) return "marketing";
+	return SAFE_KIT_NAMES.has(normalized) ? normalized : null;
+}
+
+function getInstalledKit(claudeDir) {
+	const metadata = readJsonFile(path.join(claudeDir, "metadata.json"));
+	const metadataKit = normalizeKitName(Object.keys(metadata?.kits || {})[0] || metadata?.name);
+	if (metadataKit) {
+		const kitVersion = metadata?.kits?.[metadataKit]?.version || metadata?.version || "";
+		return { kit: metadataKit, isBeta: String(kitVersion).includes("beta") };
+	}
+
+	const config = readJsonFile(path.join(claudeDir, ".ck.json"));
+	const configKit = normalizeKitName(Object.keys(config?.kits || {})[0]);
+	return configKit ? { kit: configKit, isBeta: false } : null;
+}
+
+function collectCandidateClaudeDirs(settingsFiles) {
+	const dirs = new Set();
+	for (const settingsFile of settingsFiles) dirs.add(path.dirname(settingsFile));
+	return [...dirs];
+}
+
+function resolveCkEntrypoint() {
+	return process.env.CK_POSTINSTALL_CK_BIN || path.join(__dirname, "ck.js");
+}
+
+function restoreMissingHookRegistrations(settingsFiles) {
+	if (process.env.CK_POSTINSTALL_SKIP_RESTORE_CK_HOOKS === "1") return 0;
+
+	let restored = 0;
+	for (const claudeDir of collectCandidateClaudeDirs(settingsFiles)) {
+		const missing = countMissingCkHookRegistrations(claudeDir);
+		if (missing <= 0) continue;
+
+		const installedKit = getInstalledKit(claudeDir);
+		if (!installedKit?.kit) continue;
+
+		const homeDir = getHomeDir();
+		const globalClaudeDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, ".claude");
+		const isGlobal = path.resolve(claudeDir) === path.resolve(globalClaudeDir);
+		const args = [resolveCkEntrypoint(), "init"];
+		if (isGlobal) args.push("-g");
+		args.push("--kit", installedKit.kit, "--yes", "--restore-ck-hooks", "--install-skills");
+		if (installedKit.isBeta) args.push("--beta");
+
+		const result = spawnSync(process.execPath, args, {
+			env: { ...process.env, CK_POSTINSTALL_SKIP_RESTORE_CK_HOOKS: "1" },
+			stdio: process.env.CK_POSTINSTALL_DEBUG === "1" ? "inherit" : "ignore",
+		});
+		if (result.status === 0) restored += missing;
+	}
+
+	return restored;
+}
+
+module.exports = {
+	countMissingCkHookRegistrations,
+	restoreMissingHookRegistrations,
+};

package/bin/postinstall-self-heal.cjs

@@ -4,6 +4,10 @@
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
+const {
+	countMissingCkHookRegistrations,
+	restoreMissingHookRegistrations,
+} = require("./postinstall-hook-restore.cjs");
 
 const MAX_SETTINGS_BYTES = 5 * 1024 * 1024;
 
@@ -124,20 +128,28 @@ function collectCandidateSettingsFiles() {
 
 function main() {
 	let pruned = 0;
-	for (const filePath of collectCandidateSettingsFiles()) {
+	const settingsFiles = collectCandidateSettingsFiles();
+	for (const filePath of settingsFiles) {
 		pruned += pruneSettingsFile(filePath);
 	}
 
+	const restored = restoreMissingHookRegistrations(settingsFiles);
+
 	if (pruned > 0 && process.env.CK_POSTINSTALL_DEBUG === "1") {
 		console.warn(`[claudekit-cli] Pruned ${pruned} legacy hook prompt(s)`);
 	}
+	if (restored > 0 && process.env.CK_POSTINSTALL_DEBUG === "1") {
+		console.warn(`[claudekit-cli] Restored ${restored} missing hook registration(s)`);
+	}
 }
 
 main();
 
 module.exports = {
 	collectCandidateSettingsFiles,
+	countMissingCkHookRegistrations,
 	isLegacyDescriptiveNamePrompt,
 	pruneHooks,
 	pruneSettingsFile,
+	restoreMissingHookRegistrations,
 };

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "4.3.1-dev.17",
-	"generatedAt": "2026-05-27T03:32:56.469Z",
+	"version": "4.3.1-dev.19",
+	"generatedAt": "2026-05-27T13:19:15.391Z",
 	"commands": {
 		"agents": {
 			"name": "agents",