@ekkos/cli 0.2.9 → 0.2.11

package/dist/commands/hooks.js

@@ -0,0 +1,668 @@
+"use strict";
+/**
+ * ekkOS CLI: hooks subcommand
+ * Implements: ekkos hooks install | verify | status
+ *
+ * Per ekkOS Onboarding Spec v1.2 + Addendum:
+ * - Manifest-driven deployment
+ * - SHA256 checksum verification
+ * - Installed-state manifest tracking
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findManifest = findManifest;
+exports.loadManifest = loadManifest;
+exports.hooksInstall = hooksInstall;
+exports.hooksVerify = hooksVerify;
+exports.hooksStatus = hooksStatus;
+exports.findProjectRoot = findProjectRoot;
+exports.expandPath = expandPath;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const crypto_1 = require("crypto");
+const chalk_1 = __importDefault(require("chalk"));
+// ═══════════════════════════════════════════════════════════════════════════
+// CONSTANTS
+// ═══════════════════════════════════════════════════════════════════════════
+const isWindows = (0, os_1.platform)() === 'win32';
+const HOME_DIR = (0, os_1.homedir)();
+// Resolved paths
+function expandPath(p) {
+    return p
+        .replace(/^~/, HOME_DIR)
+        .replace(/%USERPROFILE%/g, HOME_DIR);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// MANIFEST DISCOVERY
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Find the ekkos-manifest.json file
+ * Search order per spec:
+ * 1. <packageRoot>/templates/ekkos-manifest.json
+ * 2. <distRoot>/../templates/ekkos-manifest.json
+ * 3. In monorepo dev: <repoRoot>/templates/ekkos-manifest.json
+ */
+function findManifest() {
+    const candidates = [];
+    // 1. Package root (npm install location)
+    const packageRoot = (0, path_1.join)((0, path_1.dirname)((0, path_1.dirname)(__dirname)), 'templates', 'ekkos-manifest.json');
+    candidates.push(packageRoot);
+    // 2. Dist root (compiled location)
+    const distRoot = (0, path_1.join)((0, path_1.dirname)((0, path_1.dirname)((0, path_1.dirname)(__dirname))), 'templates', 'ekkos-manifest.json');
+    candidates.push(distRoot);
+    // 3. Monorepo dev (presence of templates/ at repo root)
+    const repoRoot = (0, path_1.join)((0, path_1.dirname)((0, path_1.dirname)((0, path_1.dirname)((0, path_1.dirname)((0, path_1.dirname)(__dirname))))), 'templates', 'ekkos-manifest.json');
+    candidates.push(repoRoot);
+    // Also check from current __dirname variations
+    const fromDirname = (0, path_1.join)(__dirname, '..', '..', 'templates', 'ekkos-manifest.json');
+    candidates.push(fromDirname);
+    for (const candidate of candidates) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            return {
+                path: candidate,
+                templatesDir: (0, path_1.dirname)(candidate)
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Load manifest from disk
+ */
+function loadManifest() {
+    const found = findManifest();
+    if (!found)
+        return null;
+    try {
+        const content = (0, fs_1.readFileSync)(found.path, 'utf-8');
+        const manifest = JSON.parse(content);
+        return { manifest, ...found };
+    }
+    catch {
+        return null;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// CHECKSUM UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════
+function sha256File(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath);
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+function sha256String(content) {
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// PROJECT ROOT DETECTION
+// ═══════════════════════════════════════════════════════════════════════════
+function findProjectRoot(startDir = process.cwd()) {
+    let dir = startDir;
+    // Walk up looking for .git or package.json
+    while (dir !== (0, path_1.dirname)(dir)) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(dir, '.git')) || (0, fs_1.existsSync)((0, path_1.join)(dir, 'package.json'))) {
+            return dir;
+        }
+        dir = (0, path_1.dirname)(dir);
+    }
+    // Fallback to cwd
+    return startDir;
+}
+async function hooksInstall(options) {
+    const verbose = options.verbose || false;
+    const isGlobal = options.global !== false; // Default to global
+    const isProject = options.project === true;
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('ekkOS Hooks Installer'));
+    console.log(chalk_1.default.gray('-'.repeat(50)));
+    console.log('');
+    // Load manifest
+    const manifestData = loadManifest();
+    if (!manifestData) {
+        console.log(chalk_1.default.red('Error: Could not find ekkos-manifest.json'));
+        console.log(chalk_1.default.gray('Searched in:'));
+        console.log(chalk_1.default.gray('  - <packageRoot>/templates/'));
+        console.log(chalk_1.default.gray('  - <distRoot>/../templates/'));
+        console.log(chalk_1.default.gray('  - <repoRoot>/templates/ (monorepo dev)'));
+        process.exit(1);
+    }
+    const { manifest, templatesDir } = manifestData;
+    const platformConfig = manifest.platforms[(0, os_1.platform)()];
+    if (verbose) {
+        console.log(chalk_1.default.gray(`Manifest: ${manifestData.path}`));
+        console.log(chalk_1.default.gray(`Templates: ${templatesDir}`));
+        console.log(chalk_1.default.gray(`Platform: ${(0, os_1.platform)()}`));
+        console.log('');
+    }
+    const installedFiles = [];
+    let errorCount = 0;
+    // Resolve config and hooks directories
+    const configDir = expandPath(platformConfig.configDir);
+    const globalHooksDir = expandPath(platformConfig.globalHooksDir);
+    // Create directories
+    const defaultsDir = (0, path_1.join)(configDir, '.defaults');
+    const helpersDir = (0, path_1.join)(configDir, '.helpers');
+    (0, fs_1.mkdirSync)(configDir, { recursive: true });
+    (0, fs_1.mkdirSync)(defaultsDir, { recursive: true });
+    (0, fs_1.mkdirSync)(helpersDir, { recursive: true });
+    (0, fs_1.mkdirSync)(globalHooksDir, { recursive: true });
+    (0, fs_1.mkdirSync)((0, path_1.join)(globalHooksDir, 'lib'), { recursive: true });
+    if (verbose) {
+        console.log(chalk_1.default.gray(`Config dir: ${configDir}`));
+        console.log(chalk_1.default.gray(`Hooks dir: ${globalHooksDir}`));
+        console.log('');
+    }
+    // Helper to copy a file
+    const copyFile = (source, dest, description, options = {}) => {
+        const sourcePath = (0, path_1.join)(templatesDir, source);
+        if (!(0, fs_1.existsSync)(sourcePath)) {
+            console.log(chalk_1.default.yellow(`  SKIP ${(0, path_1.basename)(dest)} - source not found`));
+            return false;
+        }
+        // Check overwrite policy
+        if (options.overwrite === 'createOnly' && (0, fs_1.existsSync)(dest)) {
+            if (verbose) {
+                console.log(chalk_1.default.gray(`  SKIP ${(0, path_1.basename)(dest)} - already exists (user-editable)`));
+            }
+            return true; // Not an error
+        }
+        try {
+            (0, fs_1.mkdirSync)((0, path_1.dirname)(dest), { recursive: true });
+            (0, fs_1.copyFileSync)(sourcePath, dest);
+            // Make executable on Unix
+            if (options.executable && !isWindows) {
+                (0, fs_1.chmodSync)(dest, '755');
+            }
+            const checksum = sha256File(dest);
+            installedFiles.push({
+                path: dest,
+                checksum,
+                installedAt: new Date().toISOString()
+            });
+            console.log(chalk_1.default.green(`  ✓ ${(0, path_1.basename)(dest)}`));
+            if (verbose) {
+                console.log(chalk_1.default.gray(`    → ${dest}`));
+            }
+            return true;
+        }
+        catch (err) {
+            console.log(chalk_1.default.red(`  ✗ ${(0, path_1.basename)(dest)} - ${err.message}`));
+            errorCount++;
+            return false;
+        }
+    };
+    // ═══════════════════════════════════════════════════════════════════════════
+    // GLOBAL INSTALL
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (isGlobal) {
+        console.log(chalk_1.default.cyan('Installing global hooks...'));
+        console.log('');
+        // 1. Managed defaults (always overwrite)
+        console.log(chalk_1.default.gray('Managed defaults:'));
+        for (const file of manifest.files.managed) {
+            const dest = (0, path_1.join)(configDir, file.destination);
+            copyFile(file.source, dest, file.description, {
+                overwrite: 'always'
+            });
+        }
+        console.log('');
+        // 2. Helpers (always overwrite, executable)
+        console.log(chalk_1.default.gray('Helpers:'));
+        for (const file of manifest.files.helpers) {
+            const dest = (0, path_1.join)(configDir, file.destination);
+            copyFile(file.source, dest, file.description, {
+                executable: file.executable,
+                overwrite: 'always'
+            });
+        }
+        console.log('');
+        // 3. User-editable files (create if missing only)
+        console.log(chalk_1.default.gray('User-editable (create if missing):'));
+        for (const file of manifest.files.userEditable) {
+            const dest = (0, path_1.join)(configDir, file.destination);
+            copyFile(file.source, dest, file.description, {
+                overwrite: 'createOnly'
+            });
+        }
+        console.log('');
+        // 4. Hooks (platform-specific)
+        console.log(chalk_1.default.gray('Hooks:'));
+        const hookFiles = isWindows ? manifest.files.hooks.powershell : manifest.files.hooks.bash;
+        for (const file of hookFiles) {
+            const dest = (0, path_1.join)(globalHooksDir, file.destination);
+            copyFile(file.source, dest, file.description, {
+                executable: file.executable,
+                overwrite: 'always'
+            });
+        }
+        console.log('');
+        // 5. Lib files (Unix only)
+        if (!isWindows) {
+            console.log(chalk_1.default.gray('Hook libraries:'));
+            for (const file of manifest.files.hooks.lib) {
+                const dest = (0, path_1.join)(globalHooksDir, file.destination);
+                copyFile(file.source, dest, file.description, {
+                    executable: file.executable,
+                    overwrite: 'always'
+                });
+            }
+            console.log('');
+        }
+        // Write installed-state manifest (only on success)
+        if (errorCount === 0) {
+            const installedManifest = {
+                version: manifest.manifestVersion,
+                installedAt: new Date().toISOString(),
+                installedBy: `@ekkos/cli@${require('../../package.json').version}`,
+                sourceManifestChecksum: sha256File(manifestData.path),
+                installedFiles
+            };
+            const installedManifestPath = (0, path_1.join)(globalHooksDir, '.ekkos-manifest.json');
+            (0, fs_1.writeFileSync)(installedManifestPath, JSON.stringify(installedManifest, null, 2));
+            if (verbose) {
+                console.log(chalk_1.default.gray(`Installed manifest: ${installedManifestPath}`));
+            }
+        }
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PROJECT INSTALL
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (isProject) {
+        const projectRoot = findProjectRoot();
+        const projectHooksDir = (0, path_1.join)(projectRoot, '.claude', 'hooks');
+        const projectEkkosDir = (0, path_1.join)(projectRoot, '.ekkos');
+        console.log(chalk_1.default.cyan(`Installing project hooks for: ${projectRoot}`));
+        console.log('');
+        (0, fs_1.mkdirSync)(projectHooksDir, { recursive: true });
+        (0, fs_1.mkdirSync)(projectEkkosDir, { recursive: true });
+        // Use manifest.projectStubs if available, otherwise fallback to scanning directory
+        console.log(chalk_1.default.gray('Project stubs:'));
+        if (manifest.projectStubs) {
+            // Use manifest-driven installation
+            const stubFiles = isWindows ? manifest.projectStubs.powershell : manifest.projectStubs.bash;
+            for (const file of stubFiles) {
+                const sourcePath = (0, path_1.join)(templatesDir, file.source);
+                const destPath = (0, path_1.join)(projectHooksDir, file.destination);
+                if (!(0, fs_1.existsSync)(sourcePath)) {
+                    console.log(chalk_1.default.yellow(`  SKIP ${file.destination} - source not found`));
+                    continue;
+                }
+                try {
+                    (0, fs_1.copyFileSync)(sourcePath, destPath);
+                    if (file.executable && !isWindows) {
+                        (0, fs_1.chmodSync)(destPath, '755');
+                    }
+                    console.log(chalk_1.default.green(`  ✓ ${file.destination}`));
+                    installedFiles.push({
+                        path: destPath,
+                        checksum: sha256File(destPath),
+                        installedAt: new Date().toISOString()
+                    });
+                }
+                catch (err) {
+                    console.log(chalk_1.default.red(`  ✗ ${file.destination} - ${err.message}`));
+                    errorCount++;
+                }
+            }
+        }
+        else {
+            // Fallback: scan project-stubs directory
+            const stubsDir = (0, path_1.join)(templatesDir, 'project-stubs');
+            if ((0, fs_1.existsSync)(stubsDir)) {
+                const stubExt = isWindows ? '.ps1' : '.sh';
+                const stubFileNames = (0, fs_1.readdirSync)(stubsDir).filter(f => f.endsWith(stubExt));
+                for (const stubFile of stubFileNames) {
+                    const sourcePath = (0, path_1.join)(stubsDir, stubFile);
+                    const destPath = (0, path_1.join)(projectHooksDir, stubFile);
+                    try {
+                        (0, fs_1.copyFileSync)(sourcePath, destPath);
+                        if (!isWindows) {
+                            (0, fs_1.chmodSync)(destPath, '755');
+                        }
+                        console.log(chalk_1.default.green(`  ✓ ${stubFile}`));
+                        installedFiles.push({
+                            path: destPath,
+                            checksum: sha256File(destPath),
+                            installedAt: new Date().toISOString()
+                        });
+                    }
+                    catch (err) {
+                        console.log(chalk_1.default.yellow(`  SKIP ${stubFile} - ${err.message}`));
+                    }
+                }
+            }
+            else {
+                console.log(chalk_1.default.yellow('  No project stubs found - using global hooks'));
+            }
+        }
+        console.log('');
+        // Write project installed manifest
+        if (errorCount === 0) {
+            const projectInstalledManifest = {
+                version: manifest.manifestVersion,
+                installedAt: new Date().toISOString(),
+                installedBy: `@ekkos/cli@${require('../../package.json').version}`,
+                sourceManifestChecksum: sha256File(manifestData.path),
+                installedFiles: installedFiles.filter(f => f.path.startsWith(projectRoot))
+            };
+            const projectManifestPath = (0, path_1.join)(projectEkkosDir, '.ekkos-project-manifest.json');
+            (0, fs_1.writeFileSync)(projectManifestPath, JSON.stringify(projectInstalledManifest, null, 2));
+            if (verbose) {
+                console.log(chalk_1.default.gray(`Project manifest: ${projectManifestPath}`));
+            }
+        }
+    }
+    // Summary
+    console.log(chalk_1.default.gray('-'.repeat(50)));
+    if (errorCount === 0) {
+        console.log(chalk_1.default.green.bold(`✓ ${installedFiles.length} files installed successfully`));
+        console.log('');
+        console.log(chalk_1.default.gray('Run `ekkos hooks verify` to confirm installation.'));
+    }
+    else {
+        console.log(chalk_1.default.red.bold(`✗ ${errorCount} errors during installation`));
+        console.log('');
+        console.log(chalk_1.default.yellow('Some files may not have been installed correctly.'));
+        process.exit(1);
+    }
+    console.log('');
+}
+async function hooksVerify(options) {
+    const verbose = options.verbose || false;
+    const checkGlobal = options.global !== false;
+    const checkProject = options.project === true;
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('ekkOS Hooks Verification'));
+    console.log(chalk_1.default.gray('-'.repeat(50)));
+    console.log('');
+    const issues = [];
+    // Load source manifest for reference
+    const manifestData = loadManifest();
+    if (!manifestData) {
+        issues.push({
+            severity: 'error',
+            message: 'Source manifest not found - cannot verify'
+        });
+        return { status: 'FAIL', issues };
+    }
+    const { manifest } = manifestData;
+    const platformConfig = manifest.platforms[(0, os_1.platform)()];
+    const configDir = expandPath(platformConfig.configDir);
+    const globalHooksDir = expandPath(platformConfig.globalHooksDir);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // GLOBAL VERIFICATION
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (checkGlobal) {
+        console.log(chalk_1.default.cyan('Verifying global installation...'));
+        console.log('');
+        // Check installed-state manifest
+        const installedManifestPath = (0, path_1.join)(globalHooksDir, '.ekkos-manifest.json');
+        if (!(0, fs_1.existsSync)(installedManifestPath)) {
+            issues.push({
+                severity: 'error',
+                file: installedManifestPath,
+                message: 'Installed-state manifest not found. Run: ekkos hooks install --global'
+            });
+        }
+        else {
+            try {
+                const installedManifest = JSON.parse((0, fs_1.readFileSync)(installedManifestPath, 'utf-8'));
+                console.log(chalk_1.default.gray(`Installed version: ${installedManifest.version}`));
+                console.log(chalk_1.default.gray(`Installed at: ${installedManifest.installedAt}`));
+                console.log(chalk_1.default.gray(`Installed by: ${installedManifest.installedBy}`));
+                console.log('');
+                // Verify each installed file
+                console.log(chalk_1.default.gray('Checking files:'));
+                for (const file of installedManifest.installedFiles) {
+                    if (!(0, fs_1.existsSync)(file.path)) {
+                        console.log(chalk_1.default.red(`  ✗ ${(0, path_1.basename)(file.path)} - missing`));
+                        issues.push({
+                            severity: 'error',
+                            file: file.path,
+                            message: 'File missing'
+                        });
+                    }
+                    else {
+                        const currentChecksum = sha256File(file.path);
+                        if (currentChecksum !== file.checksum) {
+                            console.log(chalk_1.default.yellow(`  ○ ${(0, path_1.basename)(file.path)} - modified`));
+                            issues.push({
+                                severity: 'warning',
+                                file: file.path,
+                                message: 'File has been modified since installation'
+                            });
+                        }
+                        else {
+                            console.log(chalk_1.default.green(`  ✓ ${(0, path_1.basename)(file.path)}`));
+                        }
+                    }
+                }
+                console.log('');
+            }
+            catch (err) {
+                issues.push({
+                    severity: 'error',
+                    file: installedManifestPath,
+                    message: `Invalid installed manifest: ${err.message}`
+                });
+            }
+        }
+        // Check required files
+        console.log(chalk_1.default.gray('Required files:'));
+        // Helper
+        const helperPath = (0, path_1.join)(configDir, '.helpers', 'json-parse.cjs');
+        if (!(0, fs_1.existsSync)(helperPath)) {
+            console.log(chalk_1.default.red(`  ✗ json-parse.cjs - missing`));
+            issues.push({
+                severity: 'error',
+                file: helperPath,
+                message: 'JSON parse helper missing. Run: ekkos hooks install --global'
+            });
+        }
+        else {
+            console.log(chalk_1.default.green(`  ✓ json-parse.cjs`));
+        }
+        // Defaults
+        const defaultsPath = (0, path_1.join)(configDir, '.defaults', 'session-words.json');
+        if (!(0, fs_1.existsSync)(defaultsPath)) {
+            console.log(chalk_1.default.red(`  ✗ session-words.json (defaults) - missing`));
+            issues.push({
+                severity: 'error',
+                file: defaultsPath,
+                message: 'Default session words missing. Run: ekkos hooks install --global'
+            });
+        }
+        else {
+            console.log(chalk_1.default.green(`  ✓ session-words.json (defaults)`));
+        }
+        // Check EKKOS_MANAGED header in hooks
+        console.log('');
+        console.log(chalk_1.default.gray('Hook fingerprints:'));
+        const hookFiles = isWindows ? manifest.files.hooks.powershell : manifest.files.hooks.bash;
+        for (const hookFile of hookFiles) {
+            const hookPath = (0, path_1.join)(globalHooksDir, hookFile.destination);
+            if ((0, fs_1.existsSync)(hookPath)) {
+                const content = (0, fs_1.readFileSync)(hookPath, 'utf-8');
+                if (content.includes('EKKOS_MANAGED=1')) {
+                    console.log(chalk_1.default.green(`  ✓ ${(0, path_1.basename)(hookPath)} - managed`));
+                }
+                else {
+                    console.log(chalk_1.default.yellow(`  ○ ${(0, path_1.basename)(hookPath)} - custom (not managed)`));
+                    issues.push({
+                        severity: 'warning',
+                        file: hookPath,
+                        message: 'Hook does not have EKKOS_MANAGED=1 fingerprint'
+                    });
+                }
+            }
+            else {
+                console.log(chalk_1.default.red(`  ✗ ${(0, path_1.basename)(hookFile.destination)} - missing`));
+                issues.push({
+                    severity: 'error',
+                    file: hookPath,
+                    message: 'Hook file missing'
+                });
+            }
+        }
+        console.log('');
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PROJECT VERIFICATION
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (checkProject) {
+        const projectRoot = findProjectRoot();
+        const projectManifestPath = (0, path_1.join)(projectRoot, '.ekkos', '.ekkos-project-manifest.json');
+        console.log(chalk_1.default.cyan(`Verifying project installation: ${projectRoot}`));
+        console.log('');
+        if (!(0, fs_1.existsSync)(projectManifestPath)) {
+            issues.push({
+                severity: 'warning',
+                file: projectManifestPath,
+                message: 'No project-level hooks installed (using global)'
+            });
+            console.log(chalk_1.default.yellow('  No project-level hooks installed'));
+            console.log(chalk_1.default.gray('  Using global hooks from ~/.claude/hooks/'));
+        }
+        else {
+            const projectManifest = JSON.parse((0, fs_1.readFileSync)(projectManifestPath, 'utf-8'));
+            console.log(chalk_1.default.gray(`Project hooks version: ${projectManifest.version}`));
+            for (const file of projectManifest.installedFiles) {
+                if (!(0, fs_1.existsSync)(file.path)) {
+                    console.log(chalk_1.default.red(`  ✗ ${(0, path_1.basename)(file.path)} - missing`));
+                    issues.push({ severity: 'error', file: file.path, message: 'Missing' });
+                }
+                else {
+                    console.log(chalk_1.default.green(`  ✓ ${(0, path_1.basename)(file.path)}`));
+                }
+            }
+        }
+        console.log('');
+    }
+    // Summary
+    console.log(chalk_1.default.gray('-'.repeat(50)));
+    const errors = issues.filter(i => i.severity === 'error').length;
+    const warnings = issues.filter(i => i.severity === 'warning').length;
+    let status = 'PASS';
+    if (errors > 0) {
+        status = 'FAIL';
+        console.log(chalk_1.default.red.bold(`FAIL: ${errors} error(s), ${warnings} warning(s)`));
+    }
+    else if (warnings > 0) {
+        status = 'WARN';
+        console.log(chalk_1.default.yellow.bold(`WARN: ${warnings} warning(s)`));
+    }
+    else {
+        console.log(chalk_1.default.green.bold('PASS: All checks passed'));
+    }
+    console.log('');
+    return { status, issues };
+}
+async function hooksStatus(options) {
+    const verbose = options.verbose || false;
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('ekkOS Hooks Status'));
+    console.log(chalk_1.default.gray('-'.repeat(50)));
+    console.log('');
+    const manifestData = loadManifest();
+    const platformConfig = manifestData?.manifest.platforms[(0, os_1.platform)()];
+    const configDir = platformConfig ? expandPath(platformConfig.configDir) : (0, path_1.join)(HOME_DIR, '.ekkos');
+    const globalHooksDir = platformConfig ? expandPath(platformConfig.globalHooksDir) : (0, path_1.join)(HOME_DIR, '.claude', 'hooks');
+    const projectRoot = findProjectRoot();
+    const projectHooksDir = (0, path_1.join)(projectRoot, '.claude', 'hooks');
+    // Display directories
+    console.log(chalk_1.default.gray('Directories:'));
+    console.log(`  Config:       ${configDir}`);
+    console.log(`  Global hooks: ${globalHooksDir}`);
+    console.log(`  Project:      ${projectRoot}`);
+    console.log('');
+    // Check global installation
+    console.log(chalk_1.default.cyan('Global Installation:'));
+    const globalManifestPath = (0, path_1.join)(globalHooksDir, '.ekkos-manifest.json');
+    if ((0, fs_1.existsSync)(globalManifestPath)) {
+        const globalManifest = JSON.parse((0, fs_1.readFileSync)(globalManifestPath, 'utf-8'));
+        console.log(chalk_1.default.green(`  ✓ Installed (v${globalManifest.version})`));
+        console.log(chalk_1.default.gray(`    Installed: ${new Date(globalManifest.installedAt).toLocaleString()}`));
+        console.log(chalk_1.default.gray(`    Files: ${globalManifest.installedFiles.length}`));
+    }
+    else {
+        console.log(chalk_1.default.yellow('  ○ Not installed'));
+        console.log(chalk_1.default.gray('    Run: ekkos hooks install --global'));
+    }
+    console.log('');
+    // Check hooks enablement
+    console.log(chalk_1.default.cyan('Hook Enablement:'));
+    const hooksEnabledPath = (0, path_1.join)(configDir, 'hooks-enabled.json');
+    if ((0, fs_1.existsSync)(hooksEnabledPath)) {
+        try {
+            const hooksEnabled = JSON.parse((0, fs_1.readFileSync)(hooksEnabledPath, 'utf-8'));
+            const targets = hooksEnabled.targets || {};
+            for (const [target, config] of Object.entries(targets)) {
+                const hooks = config || {};
+                const enabled = Object.entries(hooks)
+                    .filter(([, v]) => v === true)
+                    .map(([k]) => k);
+                const disabled = Object.entries(hooks)
+                    .filter(([, v]) => v === false)
+                    .map(([k]) => k);
+                console.log(`  ${target}:`);
+                if (enabled.length > 0) {
+                    console.log(chalk_1.default.green(`    Enabled: ${enabled.join(', ')}`));
+                }
+                if (disabled.length > 0) {
+                    console.log(chalk_1.default.yellow(`    Disabled: ${disabled.join(', ')}`));
+                }
+            }
+        }
+        catch {
+            console.log(chalk_1.default.yellow('  ○ Could not read hooks-enabled.json'));
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray('  Using defaults (all enabled)'));
+    }
+    console.log('');
+    // List hooks with modification times
+    console.log(chalk_1.default.cyan('Installed Hooks:'));
+    const hookExt = isWindows ? '.ps1' : '.sh';
+    if ((0, fs_1.existsSync)(globalHooksDir)) {
+        const hookFiles = (0, fs_1.readdirSync)(globalHooksDir)
+            .filter(f => f.endsWith(hookExt))
+            .sort();
+        for (const hookFile of hookFiles) {
+            const hookPath = (0, path_1.join)(globalHooksDir, hookFile);
+            const stat = (0, fs_1.statSync)(hookPath);
+            const mtime = stat.mtime.toLocaleString();
+            const content = (0, fs_1.readFileSync)(hookPath, 'utf-8');
+            const isManaged = content.includes('EKKOS_MANAGED=1');
+            const icon = isManaged ? chalk_1.default.green('✓') : chalk_1.default.yellow('○');
+            const tag = isManaged ? chalk_1.default.gray('[managed]') : chalk_1.default.yellow('[custom]');
+            console.log(`  ${icon} ${hookFile} ${tag}`);
+            if (verbose) {
+                console.log(chalk_1.default.gray(`      Modified: ${mtime}`));
+            }
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray('  No hooks directory found'));
+    }
+    console.log('');
+    // Check project-level hooks
+    console.log(chalk_1.default.cyan('Project Hooks:'));
+    if ((0, fs_1.existsSync)(projectHooksDir) && projectHooksDir !== globalHooksDir) {
+        const projectHookFiles = (0, fs_1.readdirSync)(projectHooksDir).filter(f => f.endsWith(hookExt));
+        if (projectHookFiles.length > 0) {
+            for (const hookFile of projectHookFiles) {
+                console.log(chalk_1.default.green(`  ✓ ${hookFile}`));
+            }
+        }
+        else {
+            console.log(chalk_1.default.gray('  Using global hooks'));
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray('  Using global hooks'));
+    }
+    console.log('');
+}

package/dist/commands/run.d.ts

@@ -3,6 +3,8 @@ interface RunOptions {
     verbose?: boolean;
     bypass?: boolean;
     doctor?: boolean;
+    noInject?: boolean;
+    research?: boolean;
     slashOpenDelayMs?: number;
     charDelayMs?: number;
     postEnterDelayMs?: number;