@ekkos/cli 1.2.18 → 1.3.0

package/dist/deploy/hooks.js

@@ -1,121 +1,28 @@
 "use strict";
+/**
+ * DEPRECATED: Hook deployment removed in hookless architecture migration.
+ * The CLI + proxy handle everything — hooks are no longer needed.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deployHooks = deployHooks;
 exports.areHooksDeployed = areHooksDeployed;
 exports.countDeployedHooks = countDeployedHooks;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const platform_1 = require("../utils/platform");
-const templates_1 = require("../utils/templates");
 /**
- * Deploy all hook scripts to ~/.claude/hooks/
- * Deploys .sh scripts on Unix, .ps1 scripts on Windows
+ * @deprecated Hooks are no longer deployed. This is a no-op.
  */
-function deployHooks(apiKey) {
-    // Create directories
-    if (!(0, fs_1.existsSync)(platform_1.CLAUDE_HOOKS_DIR)) {
-        (0, fs_1.mkdirSync)(platform_1.CLAUDE_HOOKS_DIR, { recursive: true });
-    }
-    if (!(0, fs_1.existsSync)(platform_1.CLAUDE_STATE_DIR)) {
-        (0, fs_1.mkdirSync)(platform_1.CLAUDE_STATE_DIR, { recursive: true });
-    }
-    // Create lib directory
-    const libDir = (0, path_1.join)(platform_1.CLAUDE_HOOKS_DIR, 'lib');
-    if (!(0, fs_1.existsSync)(libDir)) {
-        (0, fs_1.mkdirSync)(libDir, { recursive: true });
-    }
-    const deployedFiles = [];
-    // Transform function to inject API key
-    const transformHook = (content) => {
-        // Replace placeholder API key with actual key (works for both bash and PowerShell)
-        return content
-            .replace(/EKKOS_API_KEY="[^"]*"/g, `EKKOS_API_KEY="${apiKey}"`)
-            .replace(/\$env:EKKOS_API_KEY\s*=\s*"[^"]*"/g, `$env:EKKOS_API_KEY = "${apiKey}"`);
-    };
-    // Hook extension based on platform
-    const hookExt = platform_1.isWindows ? '.ps1' : '.sh';
-    // Main hook files to deploy
-    const hookNames = [
-        'session-start',
-        'user-prompt-submit',
-        'stop'
-    ];
-    // Copy main hook files (platform-specific)
-    for (const hookName of hookNames) {
-        const hookFile = `${hookName}${hookExt}`;
-        const templatePath = `hooks/${hookFile}`;
-        const destPath = (0, path_1.join)(platform_1.CLAUDE_HOOKS_DIR, hookFile);
-        try {
-            (0, templates_1.copyTemplateFile)(templatePath, destPath, transformHook);
-            deployedFiles.push(hookFile);
-            // Make executable on Unix
-            if (!platform_1.isWindows) {
-                (0, fs_1.chmodSync)(destPath, '755');
-            }
-        }
-        catch (error) {
-            // Skip if template doesn't exist
-            console.warn(`Warning: Template ${templatePath} not found`);
-        }
-    }
-    // Also deploy assistant-response.sh on Unix (optional hook)
-    if (!platform_1.isWindows) {
-        try {
-            const templatePath = 'hooks/assistant-response.sh';
-            const destPath = (0, path_1.join)(platform_1.CLAUDE_HOOKS_DIR, 'assistant-response.sh');
-            (0, templates_1.copyTemplateFile)(templatePath, destPath, transformHook);
-            deployedFiles.push('assistant-response.sh');
-            (0, fs_1.chmodSync)(destPath, '755');
-        }
-        catch (error) {
-            // Optional hook, skip silently
-        }
-    }
-    // Copy lib files (only for Unix - PowerShell doesn't need them)
-    if (!platform_1.isWindows) {
-        const libFiles = ['contract.sh', 'state.sh'];
-        for (const libFile of libFiles) {
-            const templatePath = `hooks/lib/${libFile}`;
-            const destPath = (0, path_1.join)(libDir, libFile);
-            try {
-                (0, templates_1.copyTemplateFile)(templatePath, destPath);
-                deployedFiles.push(`lib/${libFile}`);
-                (0, fs_1.chmodSync)(destPath, '755');
-            }
-            catch (error) {
-                // Skip if template doesn't exist
-            }
-        }
-    }
-    return {
-        count: deployedFiles.length,
-        files: deployedFiles
-    };
+function deployHooks(_apiKey) {
+    console.warn('[ekkOS] deployHooks() is deprecated and has no effect. Hooks are no longer needed.');
+    return { count: 0, files: [] };
 }
 /**
- * Check if hooks are deployed
+ * @deprecated Hooks are no longer deployed. Always returns false.
  */
 function areHooksDeployed() {
-    const hookExt = platform_1.isWindows ? '.ps1' : '.sh';
-    const requiredHooks = [
-        `session-start${hookExt}`,
-        `user-prompt-submit${hookExt}`,
-        `stop${hookExt}`
-    ];
-    for (const hook of requiredHooks) {
-        if (!(0, fs_1.existsSync)((0, path_1.join)(platform_1.CLAUDE_HOOKS_DIR, hook))) {
-            return false;
-        }
-    }
-    return true;
+    return false;
 }
 /**
- * Count deployed hook files
+ * @deprecated Hooks are no longer deployed. Always returns 0.
  */
 function countDeployedHooks() {
-    if (!(0, fs_1.existsSync)(platform_1.CLAUDE_HOOKS_DIR))
-        return 0;
-    const hookExt = platform_1.isWindows ? '.ps1' : '.sh';
-    const files = (0, fs_1.readdirSync)(platform_1.CLAUDE_HOOKS_DIR);
-    return files.filter(f => f.endsWith(hookExt)).length;
+    return 0;
 }

package/dist/deploy/settings.d.ts

@@ -1,8 +1,14 @@
 /**
- * Deploy Claude Code settings.json with hooks configuration
+ * DEPRECATED: Hook configuration removed in hookless architecture migration.
+ * Claude Code settings.json will NOT have any hooks entries written by ekkOS.
+ * The CLI + proxy handle everything — hooks are no longer needed.
+ */
+/**
+ * Deploy Claude Code settings.json — no-op for hooks.
+ * Preserves any existing settings but does NOT write any hooks configuration.
  */
 export declare function deployClaudeSettings(): void;
 /**
- * Check if hooks are configured in settings.json
+ * @deprecated Hooks are no longer configured. Always returns false.
  */
 export declare function areHooksConfigured(): boolean;

package/dist/deploy/settings.js

@@ -1,71 +1,42 @@
 "use strict";
+/**
+ * DEPRECATED: Hook configuration removed in hookless architecture migration.
+ * Claude Code settings.json will NOT have any hooks entries written by ekkOS.
+ * The CLI + proxy handle everything — hooks are no longer needed.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deployClaudeSettings = deployClaudeSettings;
 exports.areHooksConfigured = areHooksConfigured;
 const fs_1 = require("fs");
 const platform_1 = require("../utils/platform");
-function makeHook(command) {
-    return [{ matcher: '*', hooks: [{ type: 'command', command, timeout: 5000 }] }];
-}
 /**
- * Generate the hooks configuration for Claude Code settings.json
- * Uses the correct Claude Code format: [{ matcher, hooks: [{ type, command, timeout }] }]
- */
-function generateHooksConfig() {
-    const hooksDir = platform_1.CLAUDE_HOOKS_DIR;
-    if (platform_1.isWindows) {
-        const ps = (name) => `powershell -ExecutionPolicy Bypass -File "${hooksDir}\\${name}.ps1"`;
-        return {
-            SessionStart: makeHook(ps('session-start')),
-            UserPromptSubmit: makeHook(ps('user-prompt-submit')),
-            Stop: makeHook(ps('stop')),
-        };
-    }
-    // Unix uses bash
-    const sh = (name) => `bash "${hooksDir}/${name}.sh"`;
-    return {
-        SessionStart: makeHook(sh('session-start')),
-        UserPromptSubmit: makeHook(sh('user-prompt-submit')),
-        Stop: makeHook(sh('stop')),
-    };
-}
-/**
- * Deploy Claude Code settings.json with hooks configuration
+ * Deploy Claude Code settings.json — no-op for hooks.
+ * Preserves any existing settings but does NOT write any hooks configuration.
  */
 function deployClaudeSettings() {
     // Ensure .claude directory exists
     if (!(0, fs_1.existsSync)(platform_1.CLAUDE_DIR)) {
         (0, fs_1.mkdirSync)(platform_1.CLAUDE_DIR, { recursive: true });
     }
-    // Read existing settings or create new
-    let settings = {};
-    if ((0, fs_1.existsSync)(platform_1.CLAUDE_SETTINGS)) {
-        try {
-            settings = JSON.parse((0, fs_1.readFileSync)(platform_1.CLAUDE_SETTINGS, 'utf-8'));
-        }
-        catch {
-            // Invalid JSON, start fresh
-        }
+    // Read existing settings (if any) but do NOT add or modify hooks
+    if (!(0, fs_1.existsSync)(platform_1.CLAUDE_SETTINGS)) {
+        return; // Nothing to do — don't create an empty file
     }
-    // Merge hooks config (preserving other settings)
-    settings.hooks = generateHooksConfig();
-    // Write settings
-    (0, fs_1.writeFileSync)(platform_1.CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
-}
-/**
- * Check if hooks are configured in settings.json
- */
-function areHooksConfigured() {
-    if (!(0, fs_1.existsSync)(platform_1.CLAUDE_SETTINGS))
-        return false;
     try {
         const settings = JSON.parse((0, fs_1.readFileSync)(platform_1.CLAUDE_SETTINGS, 'utf-8'));
-        const hooks = settings.hooks || {};
-        return Boolean(hooks.SessionStart?.length &&
-            hooks.UserPromptSubmit?.length &&
-            hooks.Stop?.length);
+        // Remove any previously-installed ekkOS hooks entries
+        if ('hooks' in settings) {
+            delete settings.hooks;
+            (0, fs_1.writeFileSync)(platform_1.CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
+        }
     }
     catch {
-        return false;
+        // Invalid JSON or read error — leave the file alone
     }
 }
+/**
+ * @deprecated Hooks are no longer configured. Always returns false.
+ */
+function areHooksConfigured() {
+    return false;
+}

package/dist/index.js

@@ -45,7 +45,8 @@ const run_1 = require("./commands/run");
 const test_claude_1 = require("./commands/test-claude");
 const doctor_1 = require("./commands/doctor");
 const stream_1 = require("./commands/stream");
-const hooks_1 = require("./commands/hooks");
+// DEPRECATED: Hooks removed in hookless architecture migration
+// hooksInstall, hooksVerify, hooksStatus no longer called — `hooks` command prints a deprecation notice.
 const setup_remote_1 = require("./commands/setup-remote");
 const agent_1 = require("./commands/agent");
 const state_1 = require("./utils/state");
@@ -169,7 +170,7 @@ commander_1.program
                     { name: 'usage', desc: 'Token usage and cost tracking (daily, weekly, monthly, session)' },
                     { name: 'dashboard', desc: 'Live TUI dashboard for session monitoring' },
                     { name: 'stream', desc: 'Stream capture status and management' },
-                    { name: 'hooks', desc: 'Install, verify, and manage ekkOS hooks' },
+                    { name: 'hooks', desc: '[DEPRECATED] Hooks no longer needed — use `ekkos run`' },
                 ],
             },
             {
@@ -223,7 +224,7 @@ commander_1.program
     .option('-i, --ide <ide>', 'IDE to setup (claude, cursor, windsurf, all)')
     .option('-k, --key <key>', 'Use API key instead of device auth')
     .option('-f, --force', 'Force re-authentication and overwrite existing config')
-    .option('--skip-hooks', 'Skip hook deployment')
+    .option('--skip-hooks', '[DEPRECATED] Hooks are no longer deployed; this flag is a no-op')
     .option('--skip-skills', 'Skip skills deployment')
     .action(init_1.init);
 // Status command
@@ -310,43 +311,20 @@ streamCmd
     .action(() => {
     (0, stream_1.streamList)();
 });
-// Hooks command - install, verify, status
-const hooksCmd = commander_1.program
+// DEPRECATED: Hooks removed in hookless architecture migration
+// The `hooks` command prints a deprecation notice directing users to `ekkos run`.
+commander_1.program
     .command('hooks')
-    .description('Manage ekkOS hooks (install, verify, status)');
-hooksCmd
-    .command('install')
-    .description('Install ekkOS hooks to ~/.claude/hooks/ (global) or project')
-    .option('-g, --global', 'Install globally (default)')
-    .option('-p, --project', 'Install to current project only')
-    .option('-v, --verbose', 'Show detailed output')
-    .action((options) => {
-    (0, hooks_1.hooksInstall)({
-        global: options.global !== false && !options.project,
-        project: options.project,
-        verbose: options.verbose
-    });
-});
-hooksCmd
-    .command('verify')
-    .description('Verify hook installation and checksums')
-    .option('-g, --global', 'Verify global installation (default)')
-    .option('-p, --project', 'Verify project installation')
-    .option('-v, --verbose', 'Show detailed output')
-    .action(async (options) => {
-    const result = await (0, hooks_1.hooksVerify)({
-        global: options.global !== false && !options.project,
-        project: options.project,
-        verbose: options.verbose
-    });
-    process.exit(result.status === 'FAIL' ? 1 : 0);
-});
-hooksCmd
-    .command('status')
-    .description('Show hook installation status and enablement')
-    .option('-v, --verbose', 'Show detailed output')
-    .action((options) => {
-    (0, hooks_1.hooksStatus)({ verbose: options.verbose });
+    .description('[DEPRECATED] Hooks are no longer needed. Use `ekkos run` instead.')
+    .allowUnknownOption()
+    .action(() => {
+    console.log('');
+    console.log(chalk_1.default.yellow('  Hooks are no longer needed.'));
+    console.log(chalk_1.default.white('  Use ') + chalk_1.default.cyan.bold('ekkos run') + chalk_1.default.white(' instead.'));
+    console.log('');
+    console.log(chalk_1.default.gray('  The hookless architecture routes everything through'));
+    console.log(chalk_1.default.gray('  the ekkOS proxy — no shell hooks required.'));
+    console.log('');
 });
 // Usage command - track Claude Code token usage and costs (powered by ccusage)
 (0, index_1.registerUsageCommand)(commander_1.program);

package/dist/utils/state.js

@@ -79,14 +79,19 @@ function uuidToWords(uuid) {
     if (!/^[0-9a-fA-F]+$/.test(hex)) {
         return 'unknown-session-starts';
     }
-    // Use different 4-char segments for each word
+    // Use different 4-char segments for each word + 3-char segment for numeric suffix
     const adjSeed = parseInt(hex.slice(0, 4), 16);
     const nounSeed = parseInt(hex.slice(4, 8), 16);
     const verbSeed = parseInt(hex.slice(8, 12), 16);
     const adjIdx = adjSeed % ADJECTIVES.length;
     const nounIdx = nounSeed % NOUNS.length;
     const verbIdx = verbSeed % VERBS.length;
-    return `${ADJECTIVES[adjIdx]}-${NOUNS[nounIdx]}-${VERBS[verbIdx]}`;
+    // Numeric suffix from additional hex chars to reduce collision risk
+    // 125k word combos × 1000 = 125M unique names
+    const fullHex = uuid.replace(/-/g, '');
+    const suffixHex = fullHex.slice(12, 15) || hex.slice(0, 3);
+    const suffix = String(parseInt(suffixHex, 16) % 1000).padStart(3, '0');
+    return `${ADJECTIVES[adjIdx]}-${NOUNS[nounIdx]}-${VERBS[verbIdx]}-${suffix}`;
 }
 /**
  * Ensure .ekkos directory exists and has required files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekkos/cli",
-  "version": "1.2.18",
+  "version": "1.3.0",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {