@wowok/skills 3.0.4 → 3.1.1

package/scripts/install.js

@@ -1,871 +1,33 @@
 /**
- * WoWok Skills installer
+ * npm lifecycle entry point.
  *
- * npm lifecycle integration:
- *   postinstall  → copy SKILL.md folders to ALL client skill dirs by default
- *                   (no need to pick a client — skills fit everywhere)
- *   preuninstall → remove SKILL.md folders from all installed client dirs
+ * Deliberately tiny: ALL logic lives in src/installer.ts so the npm hook and
+ * the `wowok-skills` CLI share one implementation (the two used to be
+ * duplicated and drifted apart).
  *
- * Environment variables:
- *   WOWOK_SKILLS_TARGETS  Comma-separated client targets to override the default (all).
- *                         Rarely needed — the default installs to every supported client.
- *   WOWOK_SKILLS_NO_MCP   Set to "1" or "true" to skip MCP server management (default: auto-install MCP)
- *   WOWOK_REFERRER        Airdrop referrer (address or name) to record during global install —
- *                         saved once so the MCP auto-injects it on first on-chain interaction.
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execSync } = require('child_process');
-
-/**
- * Retained skills (post GLM5-31 sink refactor) — only these are installed.
- * The 4 rule-reference skills (wowok-safety/tools/scenario/guard) were sunk
- * into the MCP knowledge layer and are served by the MCP server directly:
- *   - wowok-safety   → schema_query action='get_safety_rules'
- *   - wowok-tools    → schema_query action='get_tool_reference'
- *   - wowok-scenario → industry_pack_operation recommend_industry / list_modes
- *   - wowok-guard    → schema_query action='get_guard_design_patterns'
- */
-const SKILL_DIRS = [
-  'wowok-provider',
-  'wowok-arbitrator',
-  'wowok-order',
-  'wowok-messenger',
-  'wowok-machine',
-  'wowok-output',
-  'wowok-onboard',
-  'wowok-planner',
-  'wowok-auditor',
-  'wowok-supplier',
-  'wowok-collaborator',
-  'wowok-market',
-  'wowok-governance',
-];
-
-/**
- * Deprecated skills removed in the GLM5-31 sink refactor. They are NEVER
- * installed, but preuninstall/init still clean them up from legacy installs
- * and warn the user where the content now lives.
- */
-const LEGACY_SKILL_DIRS = [
-  'wowok-guard',
-  'wowok-tools',
-  'wowok-safety',
-  'wowok-scenario',
-];
-
-/** Where each deprecated skill's content now lives (migration message). */
-const SKILL_MIGRATION_MAP = {
-  'wowok-safety': "MCP schema_query action='get_safety_rules'",
-  'wowok-tools': "MCP schema_query action='get_tool_reference'",
-  'wowok-scenario': "MCP industry_pack_operation action='recommend_industry' / 'list_modes'",
-  'wowok-guard': "MCP schema_query action='get_guard_design_patterns'",
-};
-
-const CLIENT_DIRS = {
-  claude: path.join(os.homedir(), '.claude', 'skills'),
-  cursor: path.join(os.homedir(), '.cursor', 'rules'),
-  windsurf: path.join(os.homedir(), '.windsurf', 'skills'),
-  codebuddy: path.join(os.homedir(), '.codebuddy', 'skills'),
-  codex: path.join(os.homedir(), '.codex', 'skills'),
-  trae: path.join(os.homedir(), '.agents', 'skills'),
-  qoder: path.join(os.homedir(), '.qoder', 'skills'),
-  roo: path.join(os.homedir(), '.roo', 'skills'),
-  cline: path.join(os.homedir(), '.cline', 'skills'),
-  kilo: path.join(os.homedir(), '.kilo', 'skills'),
-  agents: path.join(os.homedir(), '.agents', 'skills'), // deprecated alias
-  copilot: path.join(os.homedir(), '.github', 'prompts'),
-};
-
-const ALL_CLIENT_TARGETS = [
-  'claude', 'cursor', 'windsurf', 'codebuddy', 'codex', 'trae', 'qoder', 'roo', 'cline', 'kilo', 'copilot',
-];
-
-function getPackageRoot() {
-  return path.resolve(__dirname, '..');
-}
-
-/**
- * Wow MCP data dir — mirrors @wowok/wowok getWowMcpDir(): dirname(wowDir)/mcp.
- * Windows: %USERPROFILE%\.wow\mcp · macOS: ~/Library/Application Support/.wow/mcp
- * Linux: ~/.config/.wow/mcp (or XDG fallbacks) · WOWOK_DATA_DIR override.
- */
-function wowMcpDir() {
-  const home = os.homedir();
-  let wowDir;
-  if (process.env.WOWOK_DATA_DIR) {
-    wowDir = process.env.WOWOK_DATA_DIR;
-  } else if (process.platform === 'win32') {
-    wowDir = path.join(home, '.wow', 'V1');
-  } else if (process.platform === 'darwin') {
-    wowDir = path.join(home, 'Library', 'Application Support', '.wow', 'V1');
-  } else {
-    const xdgConfig = process.env.XDG_CONFIG_HOME;
-    if (xdgConfig) {
-      wowDir = path.join(xdgConfig, '.wow', 'V1');
-    } else {
-      const xdgData = process.env.XDG_DATA_HOME;
-      wowDir = xdgData ? path.join(xdgData, '.wow', 'V1') : path.join(home, '.wow', 'V1');
-    }
-  }
-  return path.join(path.dirname(wowDir), 'mcp');
-}
-
-/**
- * Persist the airdrop referrer so the MCP auto-injects it on every call.
- * Also used by `wowok-skills referrer <addr>` and `init --referrer`.
- */
-function saveReferrer(referrer) {
-  const dir = wowMcpDir();
-  fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(path.join(dir, 'referrer'), String(referrer).trim() + '\n', 'utf-8');
-  console.log(`[wowok-skills] airdrop referrer saved: ${String(referrer).trim()}`);
-  console.log('[wowok-skills] it is auto-recorded on your first on-chain interaction.');
-}
-
-function copyDir(src, dest) {
-  if (!fs.existsSync(src)) return false;
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-  return true;
-}
-
-function removeDir(dir) {
-  if (!fs.existsSync(dir)) return;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      removeDir(fullPath);
-    } else {
-      fs.unlinkSync(fullPath);
-    }
-  }
-  fs.rmdirSync(dir);
-}
-
-function getFileExt(target) {
-  const exts = { claude: '.md', codex: '.md', agents: '.md', codebuddy: '.md', cursor: '.mdc', copilot: '.prompt.md' };
-  return exts[target] || '.md';
-}
-
-function parseFrontmatter(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!match) return null;
-  const frontmatterStr = match[1];
-  const body = match[2];
-  const frontmatter = {};
-  let currentKey = null;
-  let currentValue = '';
-  for (const line of frontmatterStr.split('\n')) {
-    const kvMatch = line.match(/^(\w[\w-]*)\s*:\s*(.*)$/);
-    if (kvMatch) {
-      if (currentKey) {
-        frontmatter[currentKey] = currentValue.trim();
-      }
-      currentKey = kvMatch[1];
-      currentValue = kvMatch[2];
-    } else if (currentKey) {
-      currentValue += '\n' + line;
-    }
-  }
-  if (currentKey) {
-    frontmatter[currentKey] = currentValue.trim();
-  }
-  return { frontmatter, body };
-}
-
-function convertSkill(content, target, skillDir) {
-  if (target === 'cursor') {
-    const parsed = parseFrontmatter(content);
-    if (!parsed) return content;
-    const { frontmatter, body } = parsed;
-    let description = (frontmatter.description || frontmatter.name || skillDir);
-    if (typeof description === 'string') {
-      description = description.replace(/\n/g, ' ');
-    }
-    const isAlways = frontmatter.loading === 'always' || frontmatter.always === true;
-    const alwaysApply = isAlways ? 'true' : 'false';
-    const newFrontmatter = [
-      '---',
-      `description: "${description}"`,
-      `alwaysApply: ${alwaysApply}`,
-      '---',
-    ].join('\n');
-    return newFrontmatter + '\n' + body;
-  }
-  if (target === 'copilot') {
-    const parsed = parseFrontmatter(content);
-    if (!parsed) return content;
-    return parsed.body;
-  }
-  return content;
-}
-
-function installSkills(targetDir, target) {
-  const pkgRoot = getPackageRoot();
-  const ext = getFileExt(target);
-  let count = 0;
-
-  fs.mkdirSync(targetDir, { recursive: true });
-
-  for (const dir of SKILL_DIRS) {
-    const src = path.join(pkgRoot, dir, 'SKILL.md');
-
-    if (!fs.existsSync(src)) {
-      console.warn(`[wowok-skills] WARN: SKILL.md not found for ${dir}`);
-      continue;
-    }
-
-    const content = fs.readFileSync(src, 'utf-8');
-    const converted = convertSkill(content, target, dir);
-    const basename = (target === 'cursor' || target === 'copilot')
-      ? `wowok-${dir.replace('wowok-', '')}${ext}`
-      : 'SKILL.md';
-    const destDir = path.join(targetDir, dir);
-    const dest = path.join(destDir, basename);
-
-    fs.mkdirSync(destDir, { recursive: true });
-    fs.writeFileSync(dest, converted, 'utf-8');
-    count++;
-    console.log(`[wowok-skills]   installed: ${dir} → ${dest}`);
-  }
-
-  return count;
-}
-
-function uninstallSkills(targetDir) {
-  let count = 0;
-
-  // Remove both retained and legacy (deprecated) skills — legacy dirs may
-  // still exist from pre-refactor installs and must be cleaned up.
-  for (const dir of [...SKILL_DIRS, ...LEGACY_SKILL_DIRS]) {
-    const dirPath = path.join(targetDir, dir);
-    if (fs.existsSync(dirPath)) {
-      removeDir(dirPath);
-      count++;
-      console.log(`[wowok-skills]   removed: ${dirPath}`);
-    }
-  }
-
-  return count;
-}
-
-/**
- * Detect deprecated skills still present in a target dir and print a
- * migration hint (GLM5-31 §3.2). Returns the list of legacy dirs found.
- */
-function warnLegacySkills(targetDir) {
-  const found = LEGACY_SKILL_DIRS.filter((dir) => fs.existsSync(path.join(targetDir, dir)));
-  if (found.length > 0) {
-    console.warn(`[wowok-skills] ⚠ MIGRATION: deprecated skills detected in ${targetDir}:`);
-    for (const dir of found) {
-      console.warn(`[wowok-skills]   - ${dir} → content now served by ${SKILL_MIGRATION_MAP[dir]}`);
-    }
-    console.warn('[wowok-skills]   These skills are stale (MCP knowledge layer is the source of truth).');
-    console.warn('[wowok-skills]   Remove them with: wowok-skills uninit  (or delete the folders above)');
-  }
-  return found;
-}
-
-function getTargets() {
-  const envTargets = process.env.WOWOK_SKILLS_TARGETS;
-  if (!envTargets) {
-    return [...ALL_CLIENT_TARGETS];
-  }
-  return envTargets.split(',').map(t => t.trim()).filter(t => CLIENT_DIRS[t]);
-}
-
-function main() {
-  const event = process.env.npm_lifecycle_event || '';
-  const skipMcp = process.env.WOWOK_SKILLS_NO_MCP === '1' || process.env.WOWOK_SKILLS_NO_MCP === 'true';
-
-  if (event === 'postinstall') {
-    const targets = getTargets();
-    console.log(`[wowok-skills] Installing skills to ${targets.length} client(s)...`);
-
-    let total = 0;
-    for (const target of targets) {
-      const dir = CLIENT_DIRS[target];
-      console.log(`[wowok-skills] → ${dir}`);
-      const count = installSkills(dir, target);
-      total += count;
-      // GLM5-31 §3.2: warn about stale pre-refactor skills still present.
-      warnLegacySkills(dir);
-    }
-
-    console.log(`[wowok-skills] Done — ${total} skills installed across ${targets.length} client(s).`);
-
-    // ─── MCP Server Management ───────────────────────────────────────
-    console.log('');
-
-    if (skipMcp) {
-      console.log('[wowok-skills] WOWOK_SKILLS_NO_MCP=1 — skipping MCP server management.');
-    } else {
-      console.log('[wowok-skills] Checking MCP server...');
-
-      // Step 1: Install or upgrade the MCP server
-      const mcpChanged = ensureMcpServer();
-
-      // Step 2: Write MCP config for each target client
-      console.log('[wowok-skills] Registering MCP server in client config...');
-      for (const target of targets) {
-        writeMcpConfig(target);
-      }
-
-      // Step 3: Restart MCP server so the new version takes effect
-      if (mcpChanged) {
-        console.log('[wowok-skills] Restarting MCP server (so IDE picks up the new version)...');
-        restartMcpServer();
-      } else {
-        console.log('[wowok-skills] MCP server unchanged — no restart needed.');
-      }
-
-      console.log('[wowok-skills] MCP server setup complete.');
-    }
-
-    // ─── Airdrop referrer from WOWOK_REFERRER (single-command global install) ──
-    const referrer = process.env.WOWOK_REFERRER;
-    if (referrer && referrer.trim()) {
-      console.log('');
-      saveReferrer(referrer);
-    }
-
-    // ─── Project-install reminder ──────────────────────────────────────────
-    console.log('');
-    console.log('[wowok-skills] Skills installed GLOBALLY + MCP server registered (all clients).');
-    console.log('[wowok-skills] To ALSO install skills into a project, cd into it and run `wowok-skills init`.');
-  } else if (event === 'preuninstall') {
-    // Use the same target list as postinstall (ALL_CLIENT_TARGETS) so the
-    // set of dirs we remove from is symmetric with the set we installed to.
-    // Object.keys(CLIENT_DIRS) would additionally include the 'agents' alias
-    // which is identical to 'trae' → redundant.
-    const targets = [...ALL_CLIENT_TARGETS];
-    console.log('[wowok-skills] Removing skills from all client dirs...');
-
-    let total = 0;
-    for (const target of targets) {
-      const dir = CLIENT_DIRS[target];
-      if (countExisting(dir) > 0) {
-        console.log(`[wowok-skills] → ${dir}`);
-        total += uninstallSkills(dir);
-      }
-    }
-
-    console.log(`[wowok-skills] Done — ${total} skills removed.`);
-  }
-}
-
-function countExisting(targetDir) {
-  let count = 0;
-  for (const dir of [...SKILL_DIRS, ...LEGACY_SKILL_DIRS]) {
-    if (fs.existsSync(path.join(targetDir, dir))) {
-      count++;
-    }
-  }
-  return count;
-}
-
-// =========================================================================
-// MCP Server Management — auto-install, upgrade, config, and restart
-// =========================================================================
-
-/** MCP server npm package name */
-const MCP_PACKAGE = '@wowok/agent-mcp';
-
-/**
- * Resolve CodeBuddy MCP config file according to its official priority rules.
- * Reference: https://www.codebuddy.ai/docs/cli/mcp#configuration-file-locations
+ *   postinstall → copy SKILL.md to every client + register the MCP server
  *
- * USER scope priority (highest → lowest):
- *   1. ~/.codebuddy/.mcp.json  (recommended)
- *   2. ~/.codebuddy/mcp.json   (deprecated)
- *   3. ~/.codebuddy.json       (legacy)
+ * There is NO uninstall hook: npm v7+ never runs `preuninstall`/`uninstall`
+ * scripts, so removal is an explicit command — `wowok-skills uninit`.
  *
- * Read rule : pick the FIRST existing candidate.
- * Write rule: if any file exists, merge into that first existing file;
- *             if none exist, create the highest-priority one (.mcp.json).
- */
-function resolveCodeBuddyMcpFile() {
-  const home = os.homedir();
-  const candidates = [
-    path.join(home, '.codebuddy', '.mcp.json'), // 1. recommended
-    path.join(home, '.codebuddy', 'mcp.json'),  // 2. deprecated
-    path.join(home, '.codebuddy.json'),          // 3. legacy
-  ];
-  const existing = candidates.find((p) => fs.existsSync(p));
-  return existing || candidates[0];
-}
-
-/**
- * Resolve VS Code globalStorage MCP settings files for a given extension ID.
- *
- * VS Code extensions store their settings under:
- *   <user-data>/User/globalStorage/<extensionId>/settings/<fileName>
- *
- * Where <user-data> depends on the platform and the installed VS Code
- * *variant* (Code, Code - Insiders, VSCodium, Cursor). Only variants whose
- * User directory actually exists on disk are returned.
- *
- *   macOS:   ~/Library/Application Support/{Code,Code - Insiders,VSCodium,Cursor}
- *   Windows: %APPDATA%\{Code,Code - Insiders,VSCodium,Cursor}
- *   Linux:   ~/.config/{Code,Code - Insiders,VSCodium,Cursor}
+ * Environment variables:
+ *   WOWOK_SKILLS_TARGETS  comma-separated target ids (default: all)
+ *   WOWOK_SKILLS_NO_MCP   "1" to skip MCP install/registration
+ *   WOWOK_REFERRER        airdrop referrer (address or name) to persist
  */
-function resolveVscodeGlobalStorageFiles(extensionId, fileName) {
-  const home = os.homedir();
-  const vsBaseDirs = (() => {
-    switch (process.platform) {
-      case 'darwin':
-        return [path.join(home, 'Library', 'Application Support')];
-      case 'win32':
-        return [process.env.APPDATA || path.join(home, 'AppData', 'Roaming')];
-      default:
-        return [process.env.XDG_CONFIG_HOME || path.join(home, '.config')];
-    }
-  })();
 
-  const results = [];
-  const vsVariants = ['Code', 'Code - Insiders', 'VSCodium', 'Cursor'];
-  for (const base of vsBaseDirs) {
-    for (const variant of vsVariants) {
-      const vsUserDir = path.join(base, variant, 'User');
-      if (fs.existsSync(vsUserDir)) {
-        results.push(path.join(
-          vsUserDir,
-          'globalStorage',
-          extensionId,
-          'settings',
-          fileName,
-        ));
-      }
-    }
-  }
-  return results;
-}
+const path = require('path');
+const fs = require('fs');
 
-/**
- * Resolve ALL Roo Code MCP config files that should receive the wowok entry.
- * Roo Code ships in two forms and we should cover BOTH:
- *
- *   (A) Standalone CLI config → ~/.roo/mcp_settings.json
- *       Reference: https://mcp.harishgarg.com/use/apple-script/mcp-server/with/43
- *
- *   (B) VS Code extension (rooveterinaryinc.roo-cline) config. The extension
- *       stores MCP settings inside VS Code's globalStorage under its
- *       extension ID.
- *       References:
- *         - Path convention : https://www.skillmd.ai/skills/mcp-installer-1/
- *         - macOS/Windows   : https://crosstrade.io/learn/connect-roo-code-to-ninjatrader-8-mcp
- */
-function resolveRooMcpFiles() {
-  const results = [];
-  // (A) Standalone CLI config — always include this target
-  results.push(path.join(os.homedir(), '.roo', 'mcp_settings.json'));
-  // (B) VS Code extension globalStorage entries
-  results.push(...resolveVscodeGlobalStorageFiles(
-    'rooveterinaryinc.roo-cline',
-    'cline_mcp_settings.json',
-  ));
-  return results;
-}
+const dist = path.join(__dirname, '..', 'dist', 'installer.js');
 
-/**
- * Resolve ALL Cline (VS Code) MCP config files.
- * Cline is a VS Code extension that stores MCP settings in globalStorage
- * under its extension ID (saoudrizwan.claude-dev), filename cline_mcp_settings.json.
- * Reference: https://www.skillmd.ai/skills/mcp-installer-1/
- */
-function resolveClineMcpFiles() {
-  return resolveVscodeGlobalStorageFiles(
-    'saoudrizwan.claude-dev',
-    'cline_mcp_settings.json',
+if (!fs.existsSync(dist)) {
+  console.warn(
+    '[wowok-skills] dist/installer.js is missing — skills were NOT installed.\n' +
+      '[wowok-skills] Build the package first (npm run build) or reinstall from the npm registry.',
   );
+  process.exit(0);
 }
 
-/**
- * Resolve ALL Kilo Code MCP config files.
- * Kilo Code reads MCP settings from two separate places (documented by Kilo):
- *   (A) VS Code extension → globalStorage/kilocode.kilo-code/settings/mcp_settings.json
- *   (B) CLI              → ~/.kilocode/cli/global/settings/mcp_settings.json
- * References:
- *   - https://kilo.ai/docs/features/mcp/using-mcp-in-cli
- *   - https://github.com/Kilo-Org/kilocode/blob/main/docs/file-locations.md
- */
-function resolveKiloMcpFiles() {
-  const results = [];
-  results.push(...resolveVscodeGlobalStorageFiles(
-    'kilocode.kilo-code',
-    'mcp_settings.json',
-  ));
-  results.push(path.join(os.homedir(), '.kilocode', 'cli', 'global', 'settings', 'mcp_settings.json'));
-  return results;
-}
-
-/**
- * MCP config entries per client target.
- * null means the client does not support MCP or manages it internally.
- * Each entry may either provide a static `configPath` string, or a
- * `resolveConfigPaths()` function that returns an array of concrete paths
- * (for clients like CodeBuddy with priority-resolution rules, or Roo with
- * multiple simultaneous install targets).
- */
-const MCP_TARGET_CONFIGS = {
-  claude: {
-    configPath: path.join(os.homedir(), '.claude', 'settings.json'),
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  codebuddy: {
-    resolveConfigPaths: () => [resolveCodeBuddyMcpFile()],
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  windsurf: {
-    configPath: path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  qoder: {
-    configPath: (() => {
-      // Qoder MCP config paths — confirmed by community guides:
-      //   Windows : %APPDATA%\Qoder\mcp-settings.json
-      //   macOS   : ~/Library/Application Support/Qoder/mcp-settings.json
-      //   Linux   : ~/.config/qoder/mcp-settings.json
-      // Reference: github.com/oscar-wang-xin/mcp-session-saver/docs/MULTI_IDE_SETUP.md
-      if (process.platform === 'win32') {
-        return path.join(
-          process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'),
-          'Qoder', 'mcp-settings.json',
-        );
-      }
-      if (process.platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'Qoder', 'mcp-settings.json');
-      }
-      return path.join(
-        process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'),
-        'qoder', 'mcp-settings.json',
-      );
-    })(),
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  roo: {
-    resolveConfigPaths: resolveRooMcpFiles,
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  cline: {
-    resolveConfigPaths: resolveClineMcpFiles,
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  kilo: {
-    resolveConfigPaths: resolveKiloMcpFiles,
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  // trae / agents: IDE-managed MCP via ~/.trae-cn/mcps/ directory structure — skip global config
-  trae: null,
-  agents: null,
-  // cursor: MCP config is project-level, handled by `wowok-skills init` in project dir
-  cursor: null,
-  // copilot: user-level MCP config (Copilot CLI)
-  copilot: {
-    configPath: path.join(os.homedir(), '.copilot', 'mcp-config.json'),
-    merge: (config) => {
-      config.mcpServers = config.mcpServers || {};
-      config.mcpServers.wowok = { type: 'local', command: 'npx', args: ['-y', '@wowok/agent-mcp'] };
-      return config;
-    }
-  },
-  // codex: global TOML config (~/.codex/config.toml)
-  codex: {
-    configPath: path.join(os.homedir(), '.codex', 'config.toml'),
-    format: 'toml',
-  },
-};
-
-/**
- * Parse a semver string to its major version number.
- * Returns 0 for invalid/missing versions.
- */
-function semverMajor(version) {
-  if (!version) return 0;
-  const parts = version.split('.');
-  return parseInt(parts[0], 10) || 0;
-}
-
-/**
- * Get the currently installed global version of the MCP server.
- * Uses `npm ls -g <package>` (targeted, no tree scan) for speed.
- * Returns null if not installed.
- */
-function getInstalledMcpVersion() {
-  try {
-    // npm ls -g <pkg> is faster than npm list -g because it skips
-    // scanning unrelated packages in the global node_modules.
-    const output = execSync(`npm ls -g ${MCP_PACKAGE} --depth=0 --json`, {
-      encoding: 'utf-8',
-      stdio: 'pipe',
-      timeout: 15000,
-    });
-    const parsed = JSON.parse(output);
-    // npm ls output has the package as a top-level key, not under dependencies
-    const pkg = parsed.dependencies?.[MCP_PACKAGE] || parsed[MCP_PACKAGE];
-    return pkg?.version || null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get the latest available version from the npm registry.
- * Returns null on failure (offline, registry unreachable, etc.).
- */
-function getLatestMcpVersion() {
-  try {
-    // --prefer-online forces npm to bypass local cache and hit the registry
-    // directly. Without this flag, stale cache can return outdated version
-    // numbers (see project memory: components.mjs fix).
-    const output = execSync(`npm view --prefer-online ${MCP_PACKAGE} version`, {
-      encoding: 'utf-8',
-      stdio: 'pipe',
-      timeout: 15000,
-    });
-    return output.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Install an npm package globally with retry logic.
- * Retries up to 2 times on failure (covers transient network errors).
- */
-function npmInstallGlobal(pkg, retries = 2) {
-  for (let attempt = 1; attempt <= retries; attempt++) {
-    try {
-      execSync(`npm install -g ${pkg}`, { stdio: 'inherit', timeout: 120000 });
-      return true;
-    } catch (err) {
-      if (attempt < retries) {
-        console.log(`[wowok-skills]   npm install attempt ${attempt} failed, retrying...`);
-        // Wait 2s before retry to let network recover
-        execSync('ping -n 3 127.0.0.1 >nul', { stdio: 'pipe', timeout: 5000 });
-      } else {
-        console.error(`[wowok-skills]   npm install failed after ${retries} attempts: ${err.message}`);
-        return false;
-      }
-    }
-  }
-  return false;
-}
-
-/**
- * Ensure the MCP server is installed and up to date.
- *
- *   - Not installed        → install latest
- *   - Outdated (same major) → upgrade to latest
- *   - Major version bump   → warn user, skip auto-upgrade
- *   - Up to date           → skip
- *
- * Returns true if the package was installed or upgraded (changed).
- */
-function ensureMcpServer() {
-  const currentVersion = getInstalledMcpVersion();
-  const latestVersion = getLatestMcpVersion();
-
-  if (currentVersion) {
-    console.log(`[wowok-skills] MCP server ${MCP_PACKAGE} v${currentVersion} found.`);
-
-    if (!latestVersion) {
-      console.log(`[wowok-skills]   Cannot check latest version (offline or registry unreachable). Keeping v${currentVersion}.`);
-      return false;
-    }
-
-    if (currentVersion === latestVersion) {
-      console.log(`[wowok-skills] MCP server is up to date (v${currentVersion}).`);
-      return false;
-    }
-
-    // Major version guard: warn if the latest version has a different major
-    const currentMajor = semverMajor(currentVersion);
-    const latestMajor = semverMajor(latestVersion);
-
-    if (latestMajor > currentMajor) {
-      console.warn(`[wowok-skills] ⚠ WARNING: Major version bump detected v${currentVersion} → v${latestVersion}.`);
-      console.warn(`[wowok-skills]   Skipping auto-upgrade to avoid breaking changes.`);
-      console.warn(`[wowok-skills]   To upgrade manually: npm install -g ${MCP_PACKAGE}@latest`);
-      return false;
-    }
-
-    console.log(`[wowok-skills] Upgrading MCP server v${currentVersion} → v${latestVersion}...`);
-    if (npmInstallGlobal(`${MCP_PACKAGE}@latest`)) {
-      console.log(`[wowok-skills] MCP server upgraded to v${latestVersion}.`);
-      return true;
-    }
-    console.error(`[wowok-skills] MCP server upgrade FAILED. Keeping v${currentVersion}.`);
-    return false;
-  }
-
-  console.log(`[wowok-skills] Installing MCP server ${MCP_PACKAGE}...`);
-  if (npmInstallGlobal(MCP_PACKAGE)) {
-    console.log(`[wowok-skills] MCP server installed.`);
-    return true;
-  }
-  console.error(`[wowok-skills] MCP server installation FAILED.`);
-  return false;
-}
-
-/**
- * Write MCP server config entry for a given client target.
- * Safely merges with any existing MCP configuration.
- * Supports JSON format (most clients) and TOML format (Codex).
- *
- * When the target's MCP_TARGET_CONFIGS entry has `resolveConfigPaths()`
- * (instead of a single `configPath` string) the function will iterate the
- * returned array so multi-target clients (Roo, CodeBuddy with priority
- * resolution) get every applicable location written to.
- */
-function writeMcpConfig(target) {
-  const cfg = MCP_TARGET_CONFIGS[target];
-  if (!cfg) {
-    console.log(`[wowok-skills]   MCP config: ${target} does not support external MCP registration (skipped).`);
-    return false;
-  }
-
-  // ── TOML format (Codex CLI uses ~/.codex/config.toml) ──────────────
-  if (cfg.format === 'toml') {
-    try {
-      const tomlEntry = '\n[mcp_servers.wowok]\ncommand = "npx"\nargs = ["-y", "@wowok/agent-mcp"]\n';
-      let content = '';
-      if (fs.existsSync(cfg.configPath)) {
-        content = fs.readFileSync(cfg.configPath, 'utf-8');
-      }
-      // Line-level regex detection.  Avoids false positives when the header
-      // appears inside a comment (e.g. `; [mcp_servers.wowok]`) or a
-      // multi-line string literal.
-      if (/^\s*\[mcp_servers\.wowok\]\s*$/m.test(content)) {
-        console.log(`[wowok-skills]   MCP config already up to date: ${cfg.configPath}`);
-        return false;
-      }
-      fs.mkdirSync(path.dirname(cfg.configPath), { recursive: true });
-      fs.writeFileSync(cfg.configPath, content + tomlEntry, 'utf-8');
-      console.log(`[wowok-skills]   MCP config written: ${cfg.configPath}`);
-      return true;
-    } catch (err) {
-      console.error(`[wowok-skills]   ERROR writing MCP config for ${target}: ${err.message}`);
-      return false;
-    }
-  }
-
-  // ── JSON format (all other clients) ────────────────────────────────
-  // Expand to an array of concrete paths so a single target can cover
-  // multiple physical files (priority resolution for CodeBuddy, CLI +
-  // VS Code variants for Roo/Cline/Kilo).
-  const configPaths = cfg.resolveConfigPaths ? cfg.resolveConfigPaths() : [cfg.configPath];
-  let anyWritten = false;
-
-  if (configPaths.length === 0) {
-    console.log(`[wowok-skills]   MCP config: no config file detected for ${target} (client not installed) — skipped.`);
-    return false;
-  }
-
-  for (const configPath of configPaths) {
-    try {
-      let config = {};
-      const dir = path.dirname(configPath);
-      if (fs.existsSync(configPath)) {
-        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-      }
-
-      const before = JSON.stringify(config);
-      config = cfg.merge(config);
-      const after = JSON.stringify(config);
-
-      if (before !== after) {
-        fs.mkdirSync(dir, { recursive: true });
-        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-        console.log(`[wowok-skills]   MCP config written: ${configPath}`);
-        anyWritten = true;
-      } else {
-        console.log(`[wowok-skills]   MCP config already up to date: ${configPath}`);
-      }
-    } catch (err) {
-      console.error(`[wowok-skills]   ERROR writing MCP config for ${target} at ${configPath}: ${err.message}`);
-    }
-  }
-
-  return anyWritten;
-}
-
-/**
- * Attempt to restart the running MCP server process.
- *
- * The MCP server is a child process of the IDE (Claude Code, Trae, etc.).
- * We cannot directly "start" it — only kill the existing process so the IDE
- * detects the exit and auto-restarts it with the new version.
- *
- * Best-effort: if the kill fails (no process running), it's harmless.
- */
-function restartMcpServer() {
-  try {
-    if (process.platform === 'win32') {
-      // Windows: use PowerShell (via -EncodedCommand to avoid quoting hell)
-      const psScript =
-        'Get-CimInstance Win32_Process -Filter "Name=\'node.exe\' AND CommandLine LIKE \'%wowok%agent-mcp%\'" | ' +
-        'ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }';
-      const encoded = Buffer.from(psScript, 'utf16le').toString('base64');
-      execSync(`powershell -NoProfile -EncodedCommand ${encoded}`, {
-        stdio: 'pipe',
-        timeout: 10000,
-      });
-    } else {
-      // Unix: pkill by command-line pattern
-      execSync('pkill -f "wowok.*agent-mcp" 2>/dev/null || true', {
-        stdio: 'pipe',
-        timeout: 5000,
-        shell: true,
-      });
-    }
-    console.log('[wowok-skills] MCP server process terminated (IDE will auto-restart).');
-    return true;
-  } catch (e) {
-    console.log('[wowok-skills] No running MCP server process found. Start your IDE to launch it.');
-    return false;
-  }
-}
-
-main();
+const { runLifecycle } = require(dist);
+runLifecycle(process.env.npm_lifecycle_event || '');