@liangjie559567/ultrapower 5.5.20 → 5.5.21

package/dist/installer/index.js

@@ -0,0 +1,824 @@
+/**
+ * Installer Module
+ *
+ * Handles installation of OMC agents, commands, and configuration
+ * into the Claude Code config directory (~/.claude/).
+ *
+ * Cross-platform support via Node.js-based hook scripts (.mjs).
+ * Bash hook scripts were removed in v3.9.0.
+ */
+import { existsSync, mkdirSync, readFileSync, chmodSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+import { getHookScripts, getHooksSettingsConfig, isWindows, MIN_NODE_VERSION } from './hooks.js';
+import { getRuntimePackageVersion } from '../lib/version.js';
+import { getConfigDir } from '../utils/config-dir.js';
+import { atomicWriteFileSync, atomicWriteJsonSync } from '../lib/atomic-write.js';
+/** Claude Code configuration directory */
+export const CLAUDE_CONFIG_DIR = getConfigDir();
+export const AGENTS_DIR = join(CLAUDE_CONFIG_DIR, 'agents');
+export const COMMANDS_DIR = join(CLAUDE_CONFIG_DIR, 'commands');
+export const SKILLS_DIR = join(CLAUDE_CONFIG_DIR, 'skills');
+export const HOOKS_DIR = join(CLAUDE_CONFIG_DIR, 'hooks');
+export const HUD_DIR = join(CLAUDE_CONFIG_DIR, 'hud');
+export const SETTINGS_FILE = join(CLAUDE_CONFIG_DIR, 'settings.json');
+export const VERSION_FILE = join(CLAUDE_CONFIG_DIR, '.omc-version.json');
+/**
+ * Core commands - DISABLED for v3.0+
+ * All commands are now plugin-scoped skills managed by Claude Code.
+ * The installer no longer copies commands to ~/.claude/commands/
+ */
+export const CORE_COMMANDS = [];
+/** Current version */
+export const VERSION = getRuntimePackageVersion();
+/**
+ * Find a marker that appears at the start of a line (line-anchored).
+ * This prevents matching markers inside code blocks.
+ * @param content - The content to search in
+ * @param marker - The marker string to find
+ * @param fromEnd - If true, finds the LAST occurrence instead of first
+ * @returns The index of the marker, or -1 if not found
+ */
+function findLineAnchoredMarker(content, marker, fromEnd = false) {
+    // Escape special regex characters in marker
+    const escapedMarker = marker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex = new RegExp(`^${escapedMarker}$`, 'gm');
+    if (fromEnd) {
+        // Find the last occurrence
+        let lastIndex = -1;
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            lastIndex = match.index;
+        }
+        return lastIndex;
+    }
+    else {
+        // Find the first occurrence
+        const match = regex.exec(content);
+        return match ? match.index : -1;
+    }
+}
+/**
+ * Read hudEnabled from .omc-config.json without importing auto-update
+ * (avoids circular dependency since auto-update imports from installer)
+ */
+export function isHudEnabledInConfig() {
+    const configPath = join(CLAUDE_CONFIG_DIR, '.omc-config.json');
+    if (!existsSync(configPath)) {
+        return true; // default: enabled
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Only disable if explicitly set to false
+        return config.hudEnabled !== false;
+    }
+    catch {
+        return true; // default: enabled on parse error
+    }
+}
+/**
+ * Detect whether a statusLine config belongs to ultrapower.
+ *
+ * Checks the command string for known OMC HUD paths so that custom
+ * (non-OMC) statusLine configurations are preserved during forced
+ * updates/reconciliation.
+ *
+ * @param statusLine - The statusLine setting object from settings.json
+ * @returns true if the statusLine was set by OMC
+ */
+export function isOmcStatusLine(statusLine) {
+    if (!statusLine || typeof statusLine !== 'object')
+        return false;
+    const sl = statusLine;
+    if (typeof sl.command !== 'string')
+        return false;
+    return sl.command.includes('omc-hud');
+}
+/**
+ * Known OMC hook script filenames installed into .claude/hooks/.
+ * Must be kept in sync with getHookScripts() in hooks.ts and
+ * HOOKS_SETTINGS_CONFIG_NODE command entries.
+ */
+const OMC_HOOK_FILENAMES = new Set([
+    'keyword-detector.mjs',
+    'session-start.mjs',
+    'pre-tool-use.mjs',
+    'post-tool-use.mjs',
+    'post-tool-use-failure.mjs',
+    'persistent-mode.mjs',
+    'stop-continuation.mjs',
+]);
+/**
+ * Detect whether a hook command belongs to ultrapower.
+ *
+ * Recognition strategy (any match is sufficient):
+ * 1. Command path contains "omc" as a path/word segment (e.g. `omc-hook.mjs`, `/omc/`)
+ * 2. Command path contains "ultrapower"
+ * 3. Command references a known OMC hook filename inside .claude/hooks/
+ *
+ * @param command - The hook command string
+ * @returns true if the command belongs to OMC
+ */
+export function isOmcHook(command) {
+    const lowerCommand = command.toLowerCase();
+    // Match "omc" as a path segment or word boundary
+    // Matches: /omc/, /omc-, omc/, -omc, _omc, omc_
+    const omcPattern = /(?:^|[/\\_-])omc(?:$|[/\\_-])/;
+    const fullNamePattern = /ultrapower|oh-my-claudecode/;
+    if (omcPattern.test(lowerCommand) || fullNamePattern.test(lowerCommand)) {
+        return true;
+    }
+    // Check for known OMC hook filenames in .claude/hooks/ path.
+    // Handles both Unix (.claude/hooks/) and Windows (.claude\hooks\) paths.
+    const hookPathMatch = lowerCommand.match(/\.claude[/\\]hooks[/\\]([a-z0-9-]+\.mjs)/);
+    if (hookPathMatch && OMC_HOOK_FILENAMES.has(hookPathMatch[1])) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if the current Node.js version meets the minimum requirement
+ */
+export function checkNodeVersion() {
+    const current = parseInt(process.versions.node.split('.')[0], 10);
+    return {
+        valid: current >= MIN_NODE_VERSION,
+        current,
+        required: MIN_NODE_VERSION
+    };
+}
+/**
+ * Check if Claude Code is installed
+ * Uses 'where' on Windows, 'which' on Unix
+ */
+export function isClaudeInstalled() {
+    try {
+        const command = isWindows() ? 'where claude' : 'which claude';
+        execSync(command, { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if we're running in Claude Code plugin context
+ *
+ * When installed as a plugin, we should NOT copy files to ~/.claude/
+ * because the plugin system already handles file access via ${CLAUDE_PLUGIN_ROOT}.
+ *
+ * Detection method:
+ * - Check if CLAUDE_PLUGIN_ROOT environment variable is set (primary method)
+ * - This env var is set by the Claude Code plugin system when running plugin hooks
+ *
+ * @returns true if running in plugin context, false otherwise
+ */
+export function isRunningAsPlugin() {
+    // Check for CLAUDE_PLUGIN_ROOT env var (set by plugin system)
+    // This is the most reliable indicator that we're running as a plugin
+    return !!process.env.CLAUDE_PLUGIN_ROOT;
+}
+/**
+ * Check if we're running as a project-scoped plugin (not global)
+ *
+ * Project-scoped plugins are installed in the project's .claude/plugins/ directory,
+ * while global plugins are installed in ~/.claude/plugins/.
+ *
+ * When project-scoped, we should NOT modify global settings (like ~/.claude/settings.json)
+ * because the user explicitly chose project-level installation.
+ *
+ * @returns true if running as a project-scoped plugin, false otherwise
+ */
+export function isProjectScopedPlugin() {
+    const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+    if (!pluginRoot) {
+        return false;
+    }
+    // Global plugins are installed under ~/.claude/plugins/
+    const globalPluginBase = join(CLAUDE_CONFIG_DIR, 'plugins');
+    // If the plugin root is NOT under the global plugin directory, it's project-scoped
+    // Normalize paths for comparison (resolve symlinks, trailing slashes, etc.)
+    const normalizedPluginRoot = pluginRoot.replace(/\\/g, '/').replace(/\/$/, '');
+    const normalizedGlobalBase = globalPluginBase.replace(/\\/g, '/').replace(/\/$/, '');
+    return !normalizedPluginRoot.startsWith(normalizedGlobalBase);
+}
+/**
+ * Get the package root directory.
+ * Works for both ESM (dist/installer/) and CJS bundles (bridge/).
+ * When esbuild bundles to CJS, import.meta is replaced with {} so we
+ * fall back to __dirname which is natively available in CJS.
+ */
+function getPackageDir() {
+    try {
+        if (import.meta?.url) {
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = dirname(__filename);
+            // From dist/installer/index.js, go up to package root
+            return join(__dirname, '..', '..');
+        }
+    }
+    catch {
+        // import.meta.url unavailable — fall through to CJS path
+    }
+    // CJS bundle path: from bridge/ go up 1 level to package root
+    if (typeof __dirname !== 'undefined') {
+        return join(__dirname, '..');
+    }
+    return process.cwd();
+}
+/**
+ * Load agent definitions from /agents/*.md files
+ */
+function loadAgentDefinitions() {
+    const agentsDir = join(getPackageDir(), 'agents');
+    const definitions = {};
+    if (!existsSync(agentsDir)) {
+        console.error(`FATAL: agents directory not found: ${agentsDir}`);
+        process.exit(1);
+    }
+    for (const file of readdirSync(agentsDir)) {
+        if (file.endsWith('.md')) {
+            definitions[file] = readFileSync(join(agentsDir, file), 'utf-8');
+        }
+    }
+    return definitions;
+}
+/**
+ * Load command definitions from /commands/*.md files
+ *
+ * NOTE: The commands/ directory was removed in v4.1.16 (#582).
+ * All commands are now plugin-scoped skills. This function returns
+ * an empty object for backward compatibility.
+ */
+function loadCommandDefinitions() {
+    const commandsDir = join(getPackageDir(), 'commands');
+    if (!existsSync(commandsDir)) {
+        return {};
+    }
+    const definitions = {};
+    for (const file of readdirSync(commandsDir)) {
+        if (file.endsWith('.md')) {
+            definitions[file] = readFileSync(join(commandsDir, file), 'utf-8');
+        }
+    }
+    return definitions;
+}
+/**
+ * Load CLAUDE.md content from /docs/CLAUDE.md
+ */
+function loadClaudeMdContent() {
+    const claudeMdPath = join(getPackageDir(), 'docs', 'CLAUDE.md');
+    if (!existsSync(claudeMdPath)) {
+        console.error(`FATAL: CLAUDE.md not found: ${claudeMdPath}`);
+        process.exit(1);
+    }
+    return readFileSync(claudeMdPath, 'utf-8');
+}
+/**
+ * Merge OMC content into existing CLAUDE.md using markers
+ * @param existingContent - Existing CLAUDE.md content (null if file doesn't exist)
+ * @param omcContent - New OMC content to inject
+ * @returns Merged content with markers
+ */
+export function mergeClaudeMd(existingContent, omcContent, version) {
+    const START_MARKER = '<!-- OMC:START -->';
+    const END_MARKER = '<!-- OMC:END -->';
+    const USER_CUSTOMIZATIONS = '<!-- User customizations -->';
+    // Idempotency guard: strip markers from omcContent if already present
+    // This handles the case where docs/CLAUDE.md ships with markers
+    let cleanOmcContent = omcContent;
+    const omcStartIdx = findLineAnchoredMarker(omcContent, START_MARKER);
+    const omcEndIdx = findLineAnchoredMarker(omcContent, END_MARKER, true);
+    if (omcStartIdx !== -1 && omcEndIdx !== -1 && omcStartIdx < omcEndIdx) {
+        // Extract content between markers, trimming any surrounding whitespace
+        cleanOmcContent = omcContent
+            .substring(omcStartIdx + START_MARKER.length, omcEndIdx)
+            .trim();
+    }
+    // Strip any existing version marker from content and inject current version
+    cleanOmcContent = cleanOmcContent.replace(/<!-- OMC:VERSION:[^\s]*? -->\n?/, '');
+    const versionMarker = version ? `<!-- OMC:VERSION:${version} -->\n` : '';
+    // Case 1: No existing content - wrap omcContent in markers
+    if (!existingContent) {
+        return `${START_MARKER}\n${versionMarker}${cleanOmcContent}\n${END_MARKER}\n`;
+    }
+    // Case 2: Existing content has both markers - replace content between markers
+    // Use line-anchored search to avoid matching markers inside code blocks
+    const startIndex = findLineAnchoredMarker(existingContent, START_MARKER);
+    const endIndex = findLineAnchoredMarker(existingContent, END_MARKER, true);
+    if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+        // Extract content before START_MARKER and after END_MARKER
+        const beforeMarker = existingContent.substring(0, startIndex);
+        const afterMarker = existingContent.substring(endIndex + END_MARKER.length);
+        return `${beforeMarker}${START_MARKER}\n${versionMarker}${cleanOmcContent}\n${END_MARKER}${afterMarker}`;
+    }
+    // Case 3: Corrupted markers (START without END or vice versa)
+    if (startIndex !== -1 || endIndex !== -1) {
+        // Handle corrupted state - backup will be created by caller
+        return `${START_MARKER}\n${versionMarker}${cleanOmcContent}\n${END_MARKER}\n\n<!-- User customizations (recovered from corrupted markers) -->\n${existingContent}`;
+    }
+    // Case 4: No markers - wrap omcContent in markers, preserve existing after user customizations header
+    return `${START_MARKER}\n${versionMarker}${cleanOmcContent}\n${END_MARKER}\n\n${USER_CUSTOMIZATIONS}\n${existingContent}`;
+}
+/**
+ * Install OMC agents, commands, skills, and hooks
+ */
+export function install(options = {}) {
+    const result = {
+        success: false,
+        message: '',
+        installedAgents: [],
+        installedCommands: [],
+        installedSkills: [],
+        hooksConfigured: false,
+        hookConflicts: [],
+        errors: []
+    };
+    const log = (msg) => {
+        if (options.verbose) {
+            console.log(msg);
+        }
+    };
+    // Check Node.js version (required for Node.js hooks)
+    const nodeCheck = checkNodeVersion();
+    if (!nodeCheck.valid) {
+        result.errors.push(`Node.js ${nodeCheck.required}+ is required. Found: ${nodeCheck.current}`);
+        result.message = `Installation failed: Node.js ${nodeCheck.required}+ required`;
+        return result;
+    }
+    // Log platform info
+    log(`Platform: ${process.platform} (Node.js hooks)`);
+    // Check if running as a plugin
+    const runningAsPlugin = isRunningAsPlugin();
+    const projectScoped = isProjectScopedPlugin();
+    const allowPluginHookRefresh = runningAsPlugin && options.refreshHooksInPlugin && !projectScoped;
+    if (runningAsPlugin) {
+        log('Detected Claude Code plugin context - skipping agent/command file installation');
+        log('Plugin files are managed by Claude Code plugin system');
+        if (projectScoped) {
+            log('Detected project-scoped plugin - skipping global HUD/settings modifications');
+        }
+        else {
+            log('Will still install HUD statusline...');
+            if (allowPluginHookRefresh) {
+                log('Will refresh global hooks/settings for plugin runtime reconciliation');
+            }
+        }
+        // Don't return early - continue to install HUD (unless project-scoped)
+    }
+    // Check Claude installation (optional)
+    if (!options.skipClaudeCheck && !isClaudeInstalled()) {
+        log('Warning: Claude Code not found. Install it first:');
+        if (isWindows()) {
+            log('  Visit https://docs.anthropic.com/claude-code for Windows installation');
+        }
+        else {
+            log('  curl -fsSL https://claude.ai/install.sh | bash');
+        }
+        // Continue anyway - user might be installing ahead of time
+    }
+    try {
+        // Ensure base config directory exists (skip for project-scoped plugins)
+        if (!projectScoped && !existsSync(CLAUDE_CONFIG_DIR)) {
+            mkdirSync(CLAUDE_CONFIG_DIR, { recursive: true });
+        }
+        // Skip agent/command/hook file installation when running as plugin
+        // Plugin system handles these via ${CLAUDE_PLUGIN_ROOT}
+        if (!runningAsPlugin) {
+            // Create directories
+            log('Creating directories...');
+            if (!existsSync(AGENTS_DIR)) {
+                mkdirSync(AGENTS_DIR, { recursive: true });
+            }
+            if (!existsSync(COMMANDS_DIR)) {
+                mkdirSync(COMMANDS_DIR, { recursive: true });
+            }
+            if (!existsSync(SKILLS_DIR)) {
+                mkdirSync(SKILLS_DIR, { recursive: true });
+            }
+            if (!existsSync(HOOKS_DIR)) {
+                mkdirSync(HOOKS_DIR, { recursive: true });
+            }
+            // Install agents
+            log('Installing agent definitions...');
+            for (const [filename, content] of Object.entries(loadAgentDefinitions())) {
+                const filepath = join(AGENTS_DIR, filename);
+                if (existsSync(filepath) && !options.force) {
+                    log(`  Skipping ${filename} (already exists)`);
+                }
+                else {
+                    atomicWriteFileSync(filepath, content);
+                    result.installedAgents.push(filename);
+                    log(`  Installed ${filename}`);
+                }
+            }
+            // Install slash commands to ~/.claude/commands/ so users can invoke them
+            // without the ultrapower: prefix (e.g. /ax-reflect instead of /ultrapower:ax-reflect)
+            log('Installing slash commands to ~/.claude/commands/');
+            for (const [filename, content] of Object.entries(loadCommandDefinitions())) {
+                const filepath = join(COMMANDS_DIR, filename);
+                // Create command directory if needed (only for nested paths like 'ultrawork/skill.md')
+                // Handle both Unix (/) and Windows (\) path separators
+                if (filename.includes('/') || filename.includes('\\')) {
+                    const segments = filename.split(/[/\\]/);
+                    const commandDir = join(COMMANDS_DIR, segments[0]);
+                    if (!existsSync(commandDir)) {
+                        mkdirSync(commandDir, { recursive: true });
+                    }
+                }
+                if (existsSync(filepath) && !options.force) {
+                    log(`  Skipping ${filename} (already exists)`);
+                }
+                else {
+                    atomicWriteFileSync(filepath, content);
+                    result.installedCommands.push(filename);
+                    log(`  Installed ${filename}`);
+                }
+            }
+            // NOTE: SKILL_DEFINITIONS removed - skills now only installed via COMMAND_DEFINITIONS
+            // to avoid duplicate entries in Claude Code's available skills list
+            // Install CLAUDE.md with merge support
+            const claudeMdPath = join(CLAUDE_CONFIG_DIR, 'CLAUDE.md');
+            const homeMdPath = join(homedir(), 'CLAUDE.md');
+            if (!existsSync(homeMdPath)) {
+                const omcContent = loadClaudeMdContent();
+                // Read existing content if it exists
+                let existingContent = null;
+                if (existsSync(claudeMdPath)) {
+                    existingContent = readFileSync(claudeMdPath, 'utf-8');
+                }
+                // Always create backup before modification (if file exists)
+                if (existingContent !== null) {
+                    const timestamp = new Date().toISOString().replace(/:/g, '-').split('.')[0]; // YYYY-MM-DDTHH-MM-SS
+                    const backupPath = join(CLAUDE_CONFIG_DIR, `CLAUDE.md.backup.${timestamp}`);
+                    atomicWriteFileSync(backupPath, existingContent);
+                    log(`Backed up existing CLAUDE.md to ${backupPath}`);
+                }
+                // Merge OMC content with existing content
+                const mergedContent = mergeClaudeMd(existingContent, omcContent, options.version ?? VERSION);
+                atomicWriteFileSync(claudeMdPath, mergedContent);
+                if (existingContent) {
+                    log('Updated CLAUDE.md (merged with existing content)');
+                }
+                else {
+                    log('Created CLAUDE.md');
+                }
+            }
+            else {
+                log('CLAUDE.md exists in home directory, skipping');
+            }
+            // Install hook scripts
+            const hookScripts = getHookScripts();
+            log('Installing hook scripts...');
+            for (const [filename, content] of Object.entries(hookScripts)) {
+                const filepath = join(HOOKS_DIR, filename);
+                // Create subdirectory if needed (e.g., lib/)
+                const dir = dirname(filepath);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                if (existsSync(filepath) && !options.force) {
+                    log(`  Skipping ${filename} (already exists)`);
+                }
+                else {
+                    atomicWriteFileSync(filepath, content);
+                    // Make script executable (skip on Windows - not needed)
+                    if (!isWindows()) {
+                        chmodSync(filepath, 0o755);
+                    }
+                    log(`  Installed ${filename}`);
+                }
+            }
+            // Note: hooks configuration is deferred to consolidated settings.json write below
+            result.hooksConfigured = true; // Will be set properly after consolidated write
+        }
+        else if (allowPluginHookRefresh) {
+            // Refresh hooks in plugin context when explicitly requested (global plugin only)
+            log('Refreshing hook scripts for plugin reconciliation...');
+            if (!existsSync(HOOKS_DIR)) {
+                mkdirSync(HOOKS_DIR, { recursive: true });
+            }
+            const hookScripts = getHookScripts();
+            for (const [filename, content] of Object.entries(hookScripts)) {
+                const filepath = join(HOOKS_DIR, filename);
+                const dir = dirname(filepath);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                atomicWriteFileSync(filepath, content);
+                if (!isWindows()) {
+                    chmodSync(filepath, 0o755);
+                }
+            }
+            result.hooksConfigured = true;
+        }
+        else {
+            log('Skipping agent/command/hook files (managed by plugin system)');
+        }
+        // Install HUD statusline (skip for project-scoped plugins, skipHud option, or hudEnabled config)
+        let hudScriptPath = null;
+        const hudDisabledByOption = options.skipHud === true;
+        const hudDisabledByConfig = !isHudEnabledInConfig();
+        const skipHud = projectScoped || hudDisabledByOption || hudDisabledByConfig;
+        if (projectScoped) {
+            log('Skipping HUD statusline (project-scoped plugin should not modify global settings)');
+        }
+        else if (hudDisabledByOption) {
+            log('Skipping HUD statusline (user opted out)');
+        }
+        else if (hudDisabledByConfig) {
+            log('Skipping HUD statusline (hudEnabled is false in .omc-config.json)');
+        }
+        else {
+            log('Installing HUD statusline...');
+        }
+        if (!skipHud)
+            try {
+                if (!existsSync(HUD_DIR)) {
+                    mkdirSync(HUD_DIR, { recursive: true });
+                }
+                // Build the HUD script content (compiled from src/hud/index.ts)
+                // Create a wrapper that checks multiple locations for the HUD module
+                hudScriptPath = join(HUD_DIR, 'omc-hud.mjs');
+                const hudScriptLines = [
+                    '#!/usr/bin/env node',
+                    '/**',
+                    ' * OMC HUD - Statusline Script',
+                    ' * Wrapper that imports from dev paths, plugin cache, or npm package',
+                    ' */',
+                    '',
+                    'import { existsSync, readdirSync } from "node:fs";',
+                    'import { homedir } from "node:os";',
+                    'import { join } from "node:path";',
+                    'import { pathToFileURL } from "node:url";',
+                    '',
+                    'async function main() {',
+                    '  const home = homedir();',
+                    '  let pluginCacheVersion = null;',
+                    '  let pluginCacheDir = null;',
+                    '  ',
+                    '  // 1. Development paths (only when OMC_DEV=1)',
+                    '  if (process.env.OMC_DEV === "1") {',
+                    '    const devPaths = [',
+                    '      join(home, "Workspace/ultrapower/dist/hud/index.js"),',
+                    '      join(home, "workspace/ultrapower/dist/hud/index.js"),',
+                    '      join(home, "projects/ultrapower/dist/hud/index.js"),',
+                    '    ];',
+                    '    ',
+                    '    for (const devPath of devPaths) {',
+                    '      if (existsSync(devPath)) {',
+                    '        try {',
+                    '          await import(pathToFileURL(devPath).href);',
+                    '          return;',
+                    '        } catch { /* continue */ }',
+                    '      }',
+                    '    }',
+                    '  }',
+                    '  ',
+                    '  // 2. Plugin cache (for production installs)',
+                    '  // Search multiple namespaces: Claude Code uses the package name as namespace',
+                    '  const pluginCacheBases = [',
+                    '    join(home, ".claude/plugins/cache/ultrapower/ultrapower"),',
+                    '    join(home, ".claude/plugins/cache/omc/ultrapower"),',
+                    '    join(home, ".claude/plugins/cache/liangjie559567/ultrapower"),',
+                    '  ];',
+                    '  for (const pluginCacheBase of pluginCacheBases) {',
+                    '  if (existsSync(pluginCacheBase)) {',
+                    '    try {',
+                    '      const versions = readdirSync(pluginCacheBase);',
+                    '      if (versions.length > 0) {',
+                    '        // Filter to only versions with built dist/hud/index.js',
+                    '        // This prevents picking an unbuilt new version after plugin update',
+                    '        const builtVersions = versions.filter(version => {',
+                    '          const pluginPath = join(pluginCacheBase, version, "dist/hud/index.js");',
+                    '          return existsSync(pluginPath);',
+                    '        });',
+                    '        ',
+                    '        if (builtVersions.length > 0) {',
+                    '          const latestVersion = builtVersions.sort((a, b) => a.localeCompare(b, undefined, { numeric: true })).reverse()[0];',
+                    '          pluginCacheVersion = latestVersion;',
+                    '          pluginCacheDir = join(pluginCacheBase, latestVersion);',
+                    '          const pluginPath = join(pluginCacheDir, "dist/hud/index.js");',
+                    '          await import(pathToFileURL(pluginPath).href);',
+                    '          return;',
+                    '        }',
+                    '      }',
+                    '    } catch { /* continue */ }',
+                    '  }',
+                    '  }',
+                    '  ',
+                    '  // 2b. Temp npm cache dirs (Claude Code plugin install leaves temp_npm_* dirs)',
+                    '  {',
+                    '    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || join(home, ".claude");',
+                    '    const cacheDir = join(claudeConfigDir, "plugins", "cache");',
+                    '    try {',
+                    '      const cacheDirs = readdirSync(cacheDir);',
+                    '      const tempDirs = cacheDirs',
+                    '        .filter(d => d.startsWith("temp_npm_"))',
+                    '        .map(d => ({ name: d, path: join(cacheDir, d) }))',
+                    '        .filter(d => existsSync(join(d.path, "dist", "hud", "index.js")))',
+                    '        .sort((a, b) => b.name.localeCompare(a.name));',
+                    '      if (tempDirs.length > 0) {',
+                    '        const hudPath = join(tempDirs[0].path, "dist", "hud", "index.js");',
+                    '        pluginCacheDir = tempDirs[0].path;',
+                    '        await import(pathToFileURL(hudPath).href);',
+                    '        return;',
+                    '      }',
+                    '    } catch { /* continue */ }',
+                    '  }',
+                    '  ',
+                    '  // 3. npm package (global or local install)',
+                    '  try {',
+                    '    await import("@liangjie559567/ultrapower/dist/hud/index.js");',
+                    '    return;',
+                    '  } catch { /* continue */ }',
+                    '  ',
+                    '  // 4. Fallback: provide detailed error message with fix instructions',
+                    '  if (pluginCacheDir && existsSync(pluginCacheDir)) {',
+                    '    // Plugin exists but dist/ folder is missing - needs build',
+                    '    const distDir = join(pluginCacheDir, "dist");',
+                    '    if (!existsSync(distDir)) {',
+                    '      console.log(`[OMC HUD] Plugin installed but not built. Run: cd "${pluginCacheDir}" && npm install && npm run build`);',
+                    '    } else {',
+                    '      console.log(`[OMC HUD] Plugin dist/ exists but HUD not found. Run: cd "${pluginCacheDir}" && npm run build`);',
+                    '    }',
+                    '  } else {',
+                    '    // No plugin installation found at all',
+                    '    console.log("[OMC HUD] Plugin not installed. Run: /ultrapower:omc-setup");',
+                    '  }',
+                    '}',
+                    '',
+                    'main();',
+                ];
+                const hudScript = hudScriptLines.join('\n');
+                atomicWriteFileSync(hudScriptPath, hudScript);
+                if (!isWindows()) {
+                    chmodSync(hudScriptPath, 0o755);
+                }
+                log('  Installed omc-hud.mjs');
+            }
+            catch (_e) {
+                log('  Warning: Could not install HUD statusline script (non-fatal)');
+                hudScriptPath = null;
+            }
+        // Consolidated settings.json write (atomic: read once, modify, write once)
+        // Skip for project-scoped plugins to avoid affecting global settings
+        if (projectScoped) {
+            log('Skipping settings.json configuration (project-scoped plugin)');
+        }
+        else {
+            log('Configuring settings.json...');
+        }
+        if (!projectScoped)
+            try {
+                let existingSettings = {};
+                if (existsSync(SETTINGS_FILE)) {
+                    const settingsContent = readFileSync(SETTINGS_FILE, 'utf-8');
+                    existingSettings = JSON.parse(settingsContent);
+                }
+                // 1. Configure hooks (only if not running as plugin unless refresh requested)
+                if (!runningAsPlugin || allowPluginHookRefresh) {
+                    const existingHooks = (existingSettings.hooks || {});
+                    const hooksConfig = getHooksSettingsConfig();
+                    const newHooks = hooksConfig.hooks;
+                    for (const [eventType, eventHooks] of Object.entries(newHooks)) {
+                        const newOmcGroups = eventHooks;
+                        if (!existingHooks[eventType]) {
+                            // No existing hooks for this event type — add OMC's directly
+                            existingHooks[eventType] = newOmcGroups;
+                            log(`  Added ${eventType} hook`);
+                        }
+                        else {
+                            const existingGroups = existingHooks[eventType];
+                            // Partition existing groups: non-OMC groups are preserved, OMC groups are replaced
+                            const nonOmcGroups = existingGroups.filter(group => group.hooks.some(h => h.type === 'command' && !isOmcHook(h.command)));
+                            const hasNonOmcHook = nonOmcGroups.length > 0;
+                            const nonOmcCommand = hasNonOmcHook
+                                ? nonOmcGroups[0].hooks.find(h => h.type === 'command' && !isOmcHook(h.command))?.command ?? ''
+                                : '';
+                            if (options.forceHooks && !allowPluginHookRefresh) {
+                                // Explicit --force-hooks: replace everything; warn when clobbering non-OMC hooks
+                                if (hasNonOmcHook) {
+                                    log(`  [OMC] Warning: Overwriting non-OMC ${eventType} hook with --force-hooks: ${nonOmcCommand}`);
+                                    result.hookConflicts.push({ eventType, existingCommand: nonOmcCommand });
+                                }
+                                existingHooks[eventType] = newOmcGroups;
+                                log(`  Updated ${eventType} hook (--force-hooks)`);
+                            }
+                            else if (options.force) {
+                                // omc update path: merge — keep non-OMC groups, replace OMC groups
+                                existingHooks[eventType] = [...nonOmcGroups, ...newOmcGroups];
+                                if (hasNonOmcHook) {
+                                    log(`  Merged ${eventType} hooks (updated OMC hooks, preserved non-OMC hook: ${nonOmcCommand})`);
+                                    result.hookConflicts.push({ eventType, existingCommand: nonOmcCommand });
+                                }
+                                else {
+                                    log(`  Updated ${eventType} hook (--force)`);
+                                }
+                            }
+                            else {
+                                // No force: skip already-configured events; report non-OMC hooks
+                                if (hasNonOmcHook) {
+                                    log(`  [OMC] Warning: ${eventType} hook has non-OMC hook. Skipping. Use --force-hooks to override.`);
+                                    result.hookConflicts.push({ eventType, existingCommand: nonOmcCommand });
+                                }
+                                else {
+                                    log(`  ${eventType} hook already configured, skipping`);
+                                }
+                            }
+                        }
+                    }
+                    existingSettings.hooks = existingHooks;
+                    log('  Hooks configured');
+                    result.hooksConfigured = true;
+                }
+                // 2. Configure statusLine (always, even in plugin mode)
+                if (hudScriptPath) {
+                    // Normalize path separators for cross-platform compatibility.
+                    // Claude Code executes statusLine commands via Git Bash on Windows,
+                    // which requires forward slashes. Backslashes in JSON cause parse failures.
+                    const hudCommandPath = hudScriptPath.replace(/\\/g, '/');
+                    if (!existingSettings.statusLine) {
+                        existingSettings.statusLine = {
+                            type: 'command',
+                            command: 'node ' + hudCommandPath
+                        };
+                        log('  Configured statusLine');
+                    }
+                    else if (options.force && isOmcStatusLine(existingSettings.statusLine)) {
+                        existingSettings.statusLine = {
+                            type: 'command',
+                            command: 'node ' + hudCommandPath
+                        };
+                        log('  Updated statusLine (--force)');
+                    }
+                    else if (options.force) {
+                        log('  statusLine owned by another tool, preserving (use manual edit to override)');
+                    }
+                    else {
+                        log('  statusLine already configured, skipping (use --force to override)');
+                    }
+                }
+                // 3. Single atomic write
+                atomicWriteJsonSync(SETTINGS_FILE, existingSettings);
+                log('  settings.json updated');
+            }
+            catch (_e) {
+                log('  Warning: Could not configure settings.json (non-fatal)');
+                result.hooksConfigured = false;
+            }
+        // Save version metadata (skip for project-scoped plugins)
+        if (!projectScoped) {
+            const versionMetadata = {
+                version: options.version ?? VERSION,
+                installedAt: new Date().toISOString(),
+                installMethod: 'npm',
+                lastCheckAt: new Date().toISOString()
+            };
+            atomicWriteJsonSync(VERSION_FILE, versionMetadata);
+            log('Saved version metadata');
+        }
+        else {
+            log('Skipping version metadata (project-scoped plugin)');
+        }
+        result.success = true;
+        const hookCount = Object.keys(getHookScripts()).length;
+        result.message = `Successfully installed ${result.installedAgents.length} agents, ${result.installedCommands.length} commands, ${result.installedSkills.length} skills, and ${hookCount} hooks`;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push(errorMessage);
+        result.message = `Installation failed: ${errorMessage}`;
+    }
+    return result;
+}
+/**
+ * Check if OMC is already installed
+ */
+export function isInstalled() {
+    return existsSync(VERSION_FILE) && existsSync(AGENTS_DIR);
+}
+/**
+ * Get installation info
+ */
+export function getInstallInfo() {
+    if (!existsSync(VERSION_FILE)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(VERSION_FILE, 'utf-8');
+        const data = JSON.parse(content);
+        return {
+            version: data.version,
+            installedAt: data.installedAt,
+            method: data.installMethod
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map