@kaitranntt/ccs 7.34.1-dev.3 → 7.34.1-dev.5

package/dist/utils/hooks/image-analyzer-profile-hook-injector.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Image Analyzer Profile Hook Injector
+ *
+ * Injects image analyzer hooks into per-profile settings files.
+ * This replaces the global ~/.claude/settings.json approach.
+ *
+ * Only injects for CLIProxy profiles (agy, gemini) that support vision analysis.
+ *
+ * @module utils/hooks/image-analyzer-profile-injector
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeMigrationMarker = exports.ensureProfileHooks = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("../ui");
+const image_analyzer_hook_configuration_1 = require("./image-analyzer-hook-configuration");
+const unified_config_loader_1 = require("../../config/unified-config-loader");
+const config_manager_1 = require("../config-manager");
+// Valid profile name pattern (alphanumeric, dash, underscore only)
+const VALID_PROFILE_NAME = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Get migration marker path (respects CCS_HOME for test isolation)
+ */
+function getMigrationMarkerPath() {
+    return path.join((0, config_manager_1.getCcsDir)(), '.image-analyzer-hook-migrated');
+}
+/**
+ * Check if CCS image analyzer hook exists in settings
+ */
+function hasCcsHook(settings) {
+    const hooks = settings.hooks;
+    if (!hooks?.PreToolUse)
+        return false;
+    return hooks.PreToolUse.some((h) => {
+        const hook = h;
+        if (hook.matcher !== 'Read')
+            return false;
+        const hookArray = hook.hooks;
+        const command = hookArray?.[0]?.command;
+        if (typeof command !== 'string')
+            return false;
+        const normalized = command
+            .replace(/\\/g, '/') // Windows backslashes
+            .replace(/\/+/g, '/'); // Collapse multiple slashes
+        return normalized.includes('.ccs/hooks/image-analyzer-transformer');
+    });
+}
+/**
+ * One-time migration marker management
+ */
+function migrateGlobalHook() {
+    const markerPath = getMigrationMarkerPath();
+    if (fs.existsSync(markerPath)) {
+        return; // Already migrated
+    }
+    try {
+        // No global hook to migrate (image analyzer is profile-only from the start)
+        // Just create marker to prevent future migration attempts
+        const ccsDir = (0, config_manager_1.getCcsDir)();
+        if (!fs.existsSync(ccsDir)) {
+            fs.mkdirSync(ccsDir, { recursive: true, mode: 0o700 });
+        }
+        // Create marker file atomically (wx = fail if exists, prevents race condition)
+        fs.writeFileSync(markerPath, new Date().toISOString(), { encoding: 'utf8', flag: 'wx' });
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Migration failed: ${error.message}`));
+        }
+    }
+}
+/**
+ * Ensure image analyzer hook is configured in profile's settings file
+ *
+ * Only injects for CLIProxy profiles with vision support (agy, gemini).
+ *
+ * @param profileName - Name of the profile (e.g., 'agy', 'gemini')
+ * @returns true if hook is configured (existing or newly added)
+ */
+function ensureProfileHooks(profileName) {
+    try {
+        // Validate profile name to prevent path traversal
+        if (!VALID_PROFILE_NAME.test(profileName)) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)(`Invalid profile name: ${profileName}`));
+            }
+            return false;
+        }
+        // Only inject for CLIProxy profiles with vision support
+        const visionProfiles = ['agy', 'gemini'];
+        if (!visionProfiles.includes(profileName)) {
+            return false;
+        }
+        const imageConfig = (0, unified_config_loader_1.getImageAnalysisConfig)();
+        // Skip if image analysis is disabled
+        if (!imageConfig.enabled) {
+            return false;
+        }
+        // One-time migration marker
+        migrateGlobalHook();
+        // Get CCS directory (respects CCS_HOME for test isolation)
+        const ccsDir = (0, config_manager_1.getCcsDir)();
+        // Ensure CCS dir exists
+        if (!fs.existsSync(ccsDir)) {
+            fs.mkdirSync(ccsDir, { recursive: true, mode: 0o700 });
+        }
+        const settingsPath = path.join(ccsDir, `${profileName}.settings.json`);
+        // Read existing settings or create empty
+        let settings = {};
+        if (fs.existsSync(settingsPath)) {
+            try {
+                const content = fs.readFileSync(settingsPath, 'utf8');
+                settings = JSON.parse(content);
+            }
+            catch (parseError) {
+                if (process.env.CCS_DEBUG) {
+                    console.error((0, ui_1.warn)(`Malformed ${profileName}.settings.json: ${parseError.message}`));
+                }
+                // Continue with empty settings, will add hooks
+            }
+        }
+        // Check if CCS hook already present
+        if (hasCcsHook(settings)) {
+            // Update timeout if needed
+            return updateHookTimeoutIfNeeded(settings, settingsPath);
+        }
+        // Get hook config
+        const hookConfig = (0, image_analyzer_hook_configuration_1.getImageAnalyzerHookConfig)();
+        // Ensure hooks structure exists
+        if (!settings.hooks) {
+            settings.hooks = {};
+        }
+        const settingsHooks = settings.hooks;
+        if (!settingsHooks.PreToolUse) {
+            settingsHooks.PreToolUse = [];
+        }
+        // Add CCS hook
+        const preToolUseHooks = hookConfig.PreToolUse;
+        settingsHooks.PreToolUse.push(...preToolUseHooks);
+        // Write updated settings
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.info)(`Added image analyzer hook to ${profileName}.settings.json`));
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Failed to inject hook: ${error.message}`));
+        }
+        return false;
+    }
+}
+exports.ensureProfileHooks = ensureProfileHooks;
+/**
+ * Update hook timeout if it differs from current config
+ */
+function updateHookTimeoutIfNeeded(settings, settingsPath) {
+    try {
+        const hooks = settings.hooks;
+        const hookConfig = (0, image_analyzer_hook_configuration_1.getImageAnalyzerHookConfig)();
+        const expectedHookPath = (0, image_analyzer_hook_configuration_1.getImageAnalyzerHookPath)();
+        const expectedCommand = `node "${expectedHookPath}"`;
+        const expectedHooks = hookConfig.PreToolUse[0]
+            .hooks;
+        const expectedTimeout = expectedHooks[0].timeout;
+        let needsUpdate = false;
+        for (const h of hooks.PreToolUse) {
+            const hook = h;
+            if (hook.matcher !== 'Read')
+                continue;
+            const hookArray = hook.hooks;
+            if (!hookArray?.[0]?.command)
+                continue;
+            const command = hookArray[0].command;
+            if (typeof command !== 'string')
+                continue;
+            // Normalize path separators for cross-platform matching (Windows uses backslashes)
+            const normalizedCommand = command
+                .replace(/\\/g, '/') // Windows backslashes
+                .replace(/\/+/g, '/'); // Collapse multiple slashes
+            if (!normalizedCommand.includes('.ccs/hooks/image-analyzer-transformer'))
+                continue;
+            // Found CCS hook - check if needs update
+            if (hookArray[0].command !== expectedCommand) {
+                hookArray[0].command = expectedCommand;
+                needsUpdate = true;
+            }
+            if (hookArray[0].timeout !== expectedTimeout) {
+                hookArray[0].timeout = expectedTimeout;
+                needsUpdate = true;
+            }
+        }
+        if (needsUpdate) {
+            fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.info)('Updated image analyzer hook timeout in profile settings'));
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`updateHookTimeoutIfNeeded failed: ${error.message}`));
+        }
+        return false;
+    }
+}
+/**
+ * Remove migration marker (called during uninstall)
+ */
+function removeMigrationMarker() {
+    try {
+        const markerPath = getMigrationMarkerPath();
+        if (fs.existsSync(markerPath)) {
+            fs.unlinkSync(markerPath);
+        }
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`removeMigrationMarker failed: ${error.message}`));
+        }
+    }
+}
+exports.removeMigrationMarker = removeMigrationMarker;
+//# sourceMappingURL=image-analyzer-profile-hook-injector.js.map

package/dist/utils/hooks/image-analyzer-profile-hook-injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-analyzer-profile-hook-injector.js","sourceRoot":"","sources":["../../../src/utils/hooks/image-analyzer-profile-hook-injector.ts"],"names":[],"mappings":"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"}

package/dist/utils/hooks/image-read-block-hook-env.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Image Read Block Hook Environment Variables
+ *
+ * Provides environment variables for image read blocking hook configuration.
+ * Prevents context overflow when skills generate images and agent tries to read them.
+ *
+ * Enabled by default for third-party profiles (settings, cliproxy).
+ * Disabled for native Claude accounts where context is managed server-side.
+ *
+ * @module utils/hooks/image-read-block-hook-env
+ */
+/**
+ * Configuration for image read blocking.
+ */
+export interface ImageReadBlockConfig {
+    /** Whether blocking is enabled (default: true) */
+    enabled: boolean;
+}
+/**
+ * Get image read block configuration from unified config.
+ * Defaults to ENABLED (opt-out feature) - matches WebSearch pattern.
+ */
+export declare function getImageReadBlockConfig(): ImageReadBlockConfig;
+/**
+ * Get environment variables for image read block hook configuration.
+ *
+ * Like WebSearch, this respects CCS_PROFILE_TYPE:
+ * - 'account' or 'default' profiles: Skip blocking (native Claude)
+ * - 'settings' or 'cliproxy' profiles: Apply blocking
+ *
+ * @returns Record of environment variables to set before spawning Claude
+ */
+export declare function getImageReadBlockHookEnv(): Record<string, string>;
+//# sourceMappingURL=image-read-block-hook-env.d.ts.map

package/dist/utils/hooks/image-read-block-hook-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-read-block-hook-env.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/image-read-block-hook-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAU9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYjE"}

package/dist/utils/hooks/image-read-block-hook-env.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Image Read Block Hook Environment Variables
+ *
+ * Provides environment variables for image read blocking hook configuration.
+ * Prevents context overflow when skills generate images and agent tries to read them.
+ *
+ * Enabled by default for third-party profiles (settings, cliproxy).
+ * Disabled for native Claude accounts where context is managed server-side.
+ *
+ * @module utils/hooks/image-read-block-hook-env
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImageReadBlockHookEnv = exports.getImageReadBlockConfig = void 0;
+const unified_config_loader_1 = require("../../config/unified-config-loader");
+/**
+ * Get image read block configuration from unified config.
+ * Defaults to ENABLED (opt-out feature) - matches WebSearch pattern.
+ */
+function getImageReadBlockConfig() {
+    const config = (0, unified_config_loader_1.loadOrCreateUnifiedConfig)();
+    // Access hooks config via type assertion since it's a new field not yet in UnifiedConfig type
+    const hooksConfig = config.hooks;
+    return {
+        // Default to TRUE - enabled by default, user can opt-out
+        enabled: hooksConfig?.block_image_read?.enabled ?? true,
+    };
+}
+exports.getImageReadBlockConfig = getImageReadBlockConfig;
+/**
+ * Get environment variables for image read block hook configuration.
+ *
+ * Like WebSearch, this respects CCS_PROFILE_TYPE:
+ * - 'account' or 'default' profiles: Skip blocking (native Claude)
+ * - 'settings' or 'cliproxy' profiles: Apply blocking
+ *
+ * @returns Record of environment variables to set before spawning Claude
+ */
+function getImageReadBlockHookEnv() {
+    const config = getImageReadBlockConfig();
+    const env = {};
+    if (config.enabled) {
+        env.CCS_BLOCK_IMAGE_READ = '1';
+    }
+    else {
+        // Explicit disable signal
+        env.CCS_BLOCK_IMAGE_READ = '0';
+    }
+    return env;
+}
+exports.getImageReadBlockHookEnv = getImageReadBlockHookEnv;
+//# sourceMappingURL=image-read-block-hook-env.js.map

package/dist/utils/hooks/image-read-block-hook-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-read-block-hook-env.js","sourceRoot":"","sources":["../../../src/utils/hooks/image-read-block-hook-env.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,8EAA+E;AAU/E;;;GAGG;AACH,SAAgB,uBAAuB;IACrC,MAAM,MAAM,GAAG,IAAA,iDAAyB,GAAE,CAAC;IAC3C,8FAA8F;IAC9F,MAAM,WAAW,GACf,MACD,CAAC,KAAK,CAAC;IACR,OAAO;QACL,yDAAyD;QACzD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,IAAI,IAAI;KACxD,CAAC;AACJ,CAAC;AAVD,0DAUC;AAED;;;;;;;;GAQG;AACH,SAAgB,wBAAwB;IACtC,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,0BAA0B;QAC1B,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC;IACjC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAZD,4DAYC"}

package/dist/utils/hooks/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hooks Utilities Index
+ *
+ * Centralized exports for all hook-related utilities.
+ *
+ * @module utils/hooks
+ */
+export { getImageReadBlockHookEnv, getImageReadBlockConfig } from './image-read-block-hook-env';
+export { getImageAnalysisHookEnv } from './get-image-analysis-hook-env';
+export { getImageAnalyzerHookPath, getImageAnalyzerHookConfig, hasImageAnalyzerHook, installImageAnalyzerHook, uninstallImageAnalyzerHook, } from './image-analyzer-hook-installer';
+export { ensureProfileHooks as ensureImageAnalyzerProfileHooks } from './image-analyzer-profile-hook-injector';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,IAAI,+BAA+B,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/utils/hooks/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Hooks Utilities Index
+ *
+ * Centralized exports for all hook-related utilities.
+ *
+ * @module utils/hooks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureImageAnalyzerProfileHooks = exports.uninstallImageAnalyzerHook = exports.installImageAnalyzerHook = exports.hasImageAnalyzerHook = exports.getImageAnalyzerHookConfig = exports.getImageAnalyzerHookPath = exports.getImageAnalysisHookEnv = exports.getImageReadBlockConfig = exports.getImageReadBlockHookEnv = void 0;
+var image_read_block_hook_env_1 = require("./image-read-block-hook-env");
+Object.defineProperty(exports, "getImageReadBlockHookEnv", { enumerable: true, get: function () { return image_read_block_hook_env_1.getImageReadBlockHookEnv; } });
+Object.defineProperty(exports, "getImageReadBlockConfig", { enumerable: true, get: function () { return image_read_block_hook_env_1.getImageReadBlockConfig; } });
+var get_image_analysis_hook_env_1 = require("./get-image-analysis-hook-env");
+Object.defineProperty(exports, "getImageAnalysisHookEnv", { enumerable: true, get: function () { return get_image_analysis_hook_env_1.getImageAnalysisHookEnv; } });
+var image_analyzer_hook_installer_1 = require("./image-analyzer-hook-installer");
+Object.defineProperty(exports, "getImageAnalyzerHookPath", { enumerable: true, get: function () { return image_analyzer_hook_installer_1.getImageAnalyzerHookPath; } });
+Object.defineProperty(exports, "getImageAnalyzerHookConfig", { enumerable: true, get: function () { return image_analyzer_hook_installer_1.getImageAnalyzerHookConfig; } });
+Object.defineProperty(exports, "hasImageAnalyzerHook", { enumerable: true, get: function () { return image_analyzer_hook_installer_1.hasImageAnalyzerHook; } });
+Object.defineProperty(exports, "installImageAnalyzerHook", { enumerable: true, get: function () { return image_analyzer_hook_installer_1.installImageAnalyzerHook; } });
+Object.defineProperty(exports, "uninstallImageAnalyzerHook", { enumerable: true, get: function () { return image_analyzer_hook_installer_1.uninstallImageAnalyzerHook; } });
+var image_analyzer_profile_hook_injector_1 = require("./image-analyzer-profile-hook-injector");
+Object.defineProperty(exports, "ensureImageAnalyzerProfileHooks", { enumerable: true, get: function () { return image_analyzer_profile_hook_injector_1.ensureProfileHooks; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/hooks/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,yEAAgG;AAAvF,qIAAA,wBAAwB,OAAA;AAAE,oIAAA,uBAAuB,OAAA;AAC1D,6EAAwE;AAA/D,sIAAA,uBAAuB,OAAA;AAChC,iFAMyC;AALvC,yIAAA,wBAAwB,OAAA;AACxB,2IAAA,0BAA0B,OAAA;AAC1B,qIAAA,oBAAoB,OAAA;AACpB,yIAAA,wBAAwB,OAAA;AACxB,2IAAA,0BAA0B,OAAA;AAE5B,+FAA+G;AAAtG,uJAAA,kBAAkB,OAAmC"}

package/dist/utils/image-analysis/hook-installer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Image Analysis Hook Installer
+ *
+ * Manages installation of:
+ * 1. block-image-read.cjs hook (blocks image reads to prevent context overflow)
+ * 2. Prompt templates for image analysis (user-customizable)
+ *
+ * @module utils/image-analysis/hook-installer
+ */
+/**
+ * Get path to installed hook script
+ */
+export declare function getHookPath(): string;
+/**
+ * Get CCS hooks directory
+ */
+export declare function getCcsHooksDir(): string;
+/**
+ * Get prompts directory for image analysis
+ */
+export declare function getPromptsDir(): string;
+/**
+ * Check if image block hook is installed
+ */
+export declare function hasImageBlockHook(): boolean;
+/**
+ * Install image block hook to ~/.ccs/hooks/
+ *
+ * This hook intercepts Read tool calls for image files and blocks them
+ * to prevent context overflow (images consume 100K+ tokens each).
+ *
+ * @returns true if hook installed successfully
+ */
+export declare function installImageBlockHook(): boolean;
+/**
+ * Install prompt templates to ~/.ccs/prompts/image-analysis/
+ * Only installs if directory doesn't exist (doesn't overwrite user edits)
+ *
+ * @returns true if prompts installed or already exist
+ */
+export declare function installImageAnalysisPrompts(): boolean;
+/**
+ * Uninstall image block hook from ~/.ccs/hooks/
+ *
+ * @returns true if hook uninstalled successfully
+ */
+export declare function uninstallImageBlockHook(): boolean;
+//# sourceMappingURL=hook-installer.d.ts.map

package/dist/utils/image-analysis/hook-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.d.ts","sourceRoot":"","sources":["../../../src/utils/image-analysis/hook-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAiD/C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAqErD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAkBjD"}

package/dist/utils/image-analysis/hook-installer.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Image Analysis Hook Installer
+ *
+ * Manages installation of:
+ * 1. block-image-read.cjs hook (blocks image reads to prevent context overflow)
+ * 2. Prompt templates for image analysis (user-customizable)
+ *
+ * @module utils/image-analysis/hook-installer
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uninstallImageBlockHook = exports.installImageAnalysisPrompts = exports.installImageBlockHook = exports.hasImageBlockHook = exports.getPromptsDir = exports.getCcsHooksDir = exports.getHookPath = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("../ui");
+const config_manager_1 = require("../config-manager");
+// Hook file name
+const IMAGE_BLOCK_HOOK = 'block-image-read.cjs';
+/**
+ * Get path to installed hook script
+ */
+function getHookPath() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'hooks', IMAGE_BLOCK_HOOK);
+}
+exports.getHookPath = getHookPath;
+/**
+ * Get CCS hooks directory
+ */
+function getCcsHooksDir() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'hooks');
+}
+exports.getCcsHooksDir = getCcsHooksDir;
+/**
+ * Get prompts directory for image analysis
+ */
+function getPromptsDir() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'prompts', 'image-analysis');
+}
+exports.getPromptsDir = getPromptsDir;
+/**
+ * Check if image block hook is installed
+ */
+function hasImageBlockHook() {
+    return fs.existsSync(getHookPath());
+}
+exports.hasImageBlockHook = hasImageBlockHook;
+/**
+ * Install image block hook to ~/.ccs/hooks/
+ *
+ * This hook intercepts Read tool calls for image files and blocks them
+ * to prevent context overflow (images consume 100K+ tokens each).
+ *
+ * @returns true if hook installed successfully
+ */
+function installImageBlockHook() {
+    try {
+        // Ensure hooks directory exists
+        const hooksDir = getCcsHooksDir();
+        if (!fs.existsSync(hooksDir)) {
+            fs.mkdirSync(hooksDir, { recursive: true, mode: 0o700 });
+        }
+        const hookPath = getHookPath();
+        // Find the bundled hook script
+        // In npm package: node_modules/ccs/lib/hooks/
+        // In development: lib/hooks/
+        const possiblePaths = [
+            path.join(__dirname, '..', '..', '..', 'lib', 'hooks', IMAGE_BLOCK_HOOK),
+            path.join(__dirname, '..', '..', 'lib', 'hooks', IMAGE_BLOCK_HOOK),
+            path.join(__dirname, '..', 'lib', 'hooks', IMAGE_BLOCK_HOOK),
+        ];
+        let sourcePath = null;
+        for (const p of possiblePaths) {
+            if (fs.existsSync(p)) {
+                sourcePath = p;
+                break;
+            }
+        }
+        if (!sourcePath) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)(`Image block hook source not found: ${IMAGE_BLOCK_HOOK}`));
+            }
+            return false;
+        }
+        // Copy hook to ~/.ccs/hooks/
+        fs.copyFileSync(sourcePath, hookPath);
+        fs.chmodSync(hookPath, 0o755);
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.info)(`Installed image block hook: ${hookPath}`));
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Failed to install image block hook: ${error.message}`));
+        }
+        return false;
+    }
+}
+exports.installImageBlockHook = installImageBlockHook;
+/**
+ * Install prompt templates to ~/.ccs/prompts/image-analysis/
+ * Only installs if directory doesn't exist (doesn't overwrite user edits)
+ *
+ * @returns true if prompts installed or already exist
+ */
+function installImageAnalysisPrompts() {
+    try {
+        const promptsDir = getPromptsDir();
+        // Skip if already exists (preserve user customizations)
+        if (fs.existsSync(promptsDir)) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.info)('Image analysis prompts already installed - preserving user customizations'));
+            }
+            return true;
+        }
+        // Create directory
+        fs.mkdirSync(promptsDir, { recursive: true, mode: 0o755 });
+        // Find bundled prompts
+        const possibleBasePaths = [
+            path.join(__dirname, '..', '..', '..', 'lib', 'prompts'),
+            path.join(__dirname, '..', '..', 'lib', 'prompts'),
+            path.join(__dirname, '..', 'lib', 'prompts'),
+        ];
+        let promptsBasePath = null;
+        for (const p of possibleBasePaths) {
+            if (fs.existsSync(p)) {
+                promptsBasePath = p;
+                break;
+            }
+        }
+        if (!promptsBasePath) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)('Image analysis prompts source not found'));
+            }
+            return false;
+        }
+        // Copy prompt files
+        const promptFiles = [
+            'image-analysis-default.txt',
+            'image-analysis-screenshot.txt',
+            'image-analysis-document.txt',
+        ];
+        for (const file of promptFiles) {
+            const sourcePath = path.join(promptsBasePath, file);
+            const destPath = path.join(promptsDir, file.replace('image-analysis-', ''));
+            if (fs.existsSync(sourcePath)) {
+                fs.copyFileSync(sourcePath, destPath);
+                fs.chmodSync(destPath, 0o644);
+            }
+            else if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)(`Prompt template not found: ${file}`));
+            }
+        }
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.info)(`Installed image analysis prompts: ${promptsDir}`));
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Failed to install image analysis prompts: ${error.message}`));
+        }
+        return false;
+    }
+}
+exports.installImageAnalysisPrompts = installImageAnalysisPrompts;
+/**
+ * Uninstall image block hook from ~/.ccs/hooks/
+ *
+ * @returns true if hook uninstalled successfully
+ */
+function uninstallImageBlockHook() {
+    try {
+        const hookPath = getHookPath();
+        if (fs.existsSync(hookPath)) {
+            fs.unlinkSync(hookPath);
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.info)(`Uninstalled image block hook: ${hookPath}`));
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Failed to uninstall image block hook: ${error.message}`));
+        }
+        return false;
+    }
+}
+exports.uninstallImageBlockHook = uninstallImageBlockHook;
+//# sourceMappingURL=hook-installer.js.map