@orchid-labs/pluxx 0.1.1 → 0.1.3

package/src/cli/migrate.ts

@@ -1,867 +0,0 @@
-import { resolve, basename } from 'path'
-import { existsSync, readdirSync, mkdirSync, cpSync, readFileSync } from 'fs'
-import {
-  MCP_SCAFFOLD_METADATA_PATH,
-  MCP_TAXONOMY_PATH,
-  type McpScaffoldMetadata,
-  type PersistedSkill,
-} from './init-from-mcp'
-import type { McpServer } from '../schema'
-
-type DetectedPlatform = 'claude-code' | 'cursor' | 'codex' | 'opencode'
-
-interface DetectionResult {
-  platform: DetectedPlatform
-  manifestPath: string
-}
-
-interface ParsedManifest {
-  name?: string
-  version?: string
-  description?: string
-  author?: { name: string; url?: string; email?: string }
-  repository?: string
-  license?: string
-  keywords?: string[]
-}
-
-interface ParsedMcp {
-  [serverName: string]: {
-    url?: string
-    transport?: 'http' | 'sse' | 'stdio'
-    command?: string
-    args?: string[]
-    env?: Record<string, string>
-    auth?: {
-      type: 'bearer' | 'header' | 'none'
-      envVar?: string
-      headerName?: string
-      headerTemplate?: string
-    }
-  }
-}
-
-interface ParsedHooks {
-  [event: string]: Array<{
-    command: string
-    timeout?: number
-    matcher?: string
-  }>
-}
-
-interface MigrateResult {
-  platform: DetectedPlatform
-  manifest: ParsedManifest
-  mcp: ParsedMcp
-  hooks: ParsedHooks
-  instructions?: string
-  directories: {
-    skills: boolean
-    commands: boolean
-    agents: boolean
-    scripts: boolean
-    assets: boolean
-  }
-  persistedSkills: PersistedSkill[]
-}
-
-// ── Platform Detection ──────────────────────────────────────────
-
-function detectPlatform(pluginDir: string): DetectionResult | null {
-  const checks: Array<{ dir: string; platform: DetectedPlatform }> = [
-    { dir: '.claude-plugin', platform: 'claude-code' },
-    { dir: '.cursor-plugin', platform: 'cursor' },
-    { dir: '.codex-plugin', platform: 'codex' },
-  ]
-
-  for (const check of checks) {
-    const manifestPath = resolve(pluginDir, check.dir, 'plugin.json')
-    if (existsSync(manifestPath)) {
-      return { platform: check.platform, manifestPath }
-    }
-  }
-
-  // Check for OpenCode (package.json with @opencode-ai/plugin)
-  const pkgPath = resolve(pluginDir, 'package.json')
-  if (existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
-      const deps = {
-        ...pkg.dependencies,
-        ...pkg.devDependencies,
-        ...pkg.peerDependencies,
-      }
-      if (deps && '@opencode-ai/plugin' in deps) {
-        return { platform: 'opencode', manifestPath: pkgPath }
-      }
-    } catch {
-      // not valid JSON, skip
-    }
-  }
-
-  return null
-}
-
-// ── Manifest Parsing ────────────────────────────────────────────
-
-function parseManifest(detection: DetectionResult): ParsedManifest {
-  const raw = JSON.parse(readFileSync(detection.manifestPath, 'utf-8'))
-
-  const result: ParsedManifest = {}
-
-  if (raw.name) result.name = raw.name
-  if (raw.version) result.version = raw.version
-  if (raw.description) result.description = raw.description
-  if (raw.license) result.license = raw.license
-  if (raw.keywords) result.keywords = raw.keywords
-  if (raw.repository) {
-    result.repository = typeof raw.repository === 'string'
-      ? raw.repository
-      : raw.repository?.url
-  }
-
-  if (raw.author) {
-    if (typeof raw.author === 'string') {
-      result.author = { name: raw.author }
-    } else {
-      result.author = {
-        name: raw.author.name,
-        ...(raw.author.url && { url: raw.author.url }),
-        ...(raw.author.email && { email: raw.author.email }),
-      }
-    }
-  }
-
-  return result
-}
-
-// ── MCP Parsing ─────────────────────────────────────────────────
-
-function parseMcp(pluginDir: string, detection: DetectionResult): ParsedMcp {
-  const mcpPaths = [
-    resolve(pluginDir, '.mcp.json'),
-    resolve(pluginDir, 'mcp.json'),
-  ]
-
-  // Also check if the manifest references an mcpServers file
-  try {
-    const manifest = JSON.parse(readFileSync(detection.manifestPath, 'utf-8'))
-    if (manifest.mcpServers && typeof manifest.mcpServers === 'string') {
-      mcpPaths.unshift(resolve(pluginDir, manifest.mcpServers))
-    }
-  } catch {
-    // ignore
-  }
-
-  for (const mcpPath of mcpPaths) {
-    if (!existsSync(mcpPath)) continue
-    try {
-      const raw = JSON.parse(readFileSync(mcpPath, 'utf-8'))
-      const servers = raw.mcpServers ?? raw
-      if (!servers || typeof servers !== 'object') continue
-
-      const result: ParsedMcp = {}
-
-      for (const [name, config] of Object.entries(servers)) {
-        const cfg = config as Record<string, unknown>
-        const entry: ParsedMcp[string] = {}
-
-        if (cfg.url) entry.url = cfg.url as string
-
-        // Detect transport
-        if (cfg.type === 'stdio' || cfg.command) {
-          entry.transport = 'stdio'
-          if (cfg.command) entry.command = cfg.command as string
-          if (cfg.args) entry.args = cfg.args as string[]
-          if (cfg.env) entry.env = cfg.env as Record<string, string>
-        } else if (cfg.type === 'sse') {
-          entry.transport = 'sse'
-        } else {
-          entry.transport = 'http'
-        }
-
-        // Parse auth from headers
-        if (cfg.headers && typeof cfg.headers === 'object') {
-          const headers = cfg.headers as Record<string, string>
-          const authHeader = headers['Authorization'] ?? headers['authorization']
-          if (authHeader) {
-            // Extract env var from patterns like "Bearer ${SOME_KEY}"
-            const envMatch = authHeader.match(/\$\{(\w+)\}/)
-            if (envMatch) {
-              entry.auth = {
-                type: 'bearer',
-                envVar: envMatch[1],
-                headerTemplate: authHeader.replace(/\$\{\w+\}/, '${value}'),
-              }
-            }
-          }
-        }
-
-        // Codex-style bearer_token_env_var
-        if (cfg.bearer_token_env_var) {
-          entry.auth = {
-            type: 'bearer',
-            envVar: cfg.bearer_token_env_var as string,
-          }
-        }
-
-        // Codex-style env_http_headers
-        if (cfg.env_http_headers && typeof cfg.env_http_headers === 'object') {
-          const envHeaders = Object.entries(cfg.env_http_headers as Record<string, string>)
-          if (envHeaders.length > 0) {
-            const [headerName, envVar] = envHeaders[0]
-            entry.auth = {
-              type: 'header',
-              envVar,
-              headerName,
-              headerTemplate: '${value}',
-            }
-          }
-        }
-
-        result[name] = entry
-      }
-
-      return result
-    } catch {
-      continue
-    }
-  }
-
-  return {}
-}
-
-// ── Hooks Parsing ───────────────────────────────────────────────
-
-// Maps platform-specific hook event names to pluxx schema names
-const HOOK_EVENT_MAP: Record<string, string> = {
-  SessionStart: 'sessionStart',
-  SessionEnd: 'sessionEnd',
-  PreToolUse: 'preToolUse',
-  PostToolUse: 'postToolUse',
-  BeforeShellExecution: 'beforeShellExecution',
-  AfterShellExecution: 'afterShellExecution',
-  BeforeMCPExecution: 'beforeMCPExecution',
-  AfterMCPExecution: 'afterMCPExecution',
-  AfterFileEdit: 'afterFileEdit',
-  BeforeReadFile: 'beforeReadFile',
-  BeforeSubmitPrompt: 'beforeSubmitPrompt',
-  Stop: 'stop',
-  // Also handle already-normalized names
-  sessionStart: 'sessionStart',
-  sessionEnd: 'sessionEnd',
-  preToolUse: 'preToolUse',
-  postToolUse: 'postToolUse',
-}
-
-function parseHooks(pluginDir: string, detection: DetectionResult): ParsedHooks {
-  const hooksPaths = [
-    resolve(pluginDir, '.codex', 'hooks.json'),
-    resolve(pluginDir, 'hooks.json'),
-    resolve(pluginDir, 'hooks', 'hooks.json'),
-  ]
-
-  // Check if manifest references a hooks file
-  try {
-    const manifest = JSON.parse(readFileSync(detection.manifestPath, 'utf-8'))
-    if (manifest.hooks && typeof manifest.hooks === 'string') {
-      hooksPaths.unshift(resolve(pluginDir, manifest.hooks))
-    }
-  } catch {
-    // ignore
-  }
-
-  for (const hooksPath of hooksPaths) {
-    if (!existsSync(hooksPath)) continue
-    try {
-      const raw = JSON.parse(readFileSync(hooksPath, 'utf-8'))
-      const hooksObj = raw.hooks ?? raw
-      if (!hooksObj || typeof hooksObj !== 'object') continue
-
-      const result: ParsedHooks = {}
-
-      for (const [event, entries] of Object.entries(hooksObj)) {
-        const normalizedEvent = HOOK_EVENT_MAP[event] ?? event
-        const hookEntries: ParsedHooks[string] = []
-
-        if (!Array.isArray(entries)) continue
-
-        for (const entry of entries) {
-          // Claude Code format: { hooks: [{ type: 'command', command: '...' }] }
-          if (entry.hooks && Array.isArray(entry.hooks)) {
-            for (const hook of entry.hooks) {
-              if (hook.command) {
-                hookEntries.push({
-                  command: hook.command,
-                  ...(hook.timeout && { timeout: hook.timeout }),
-                })
-              }
-            }
-          }
-          // Direct format: { command: '...' }
-          else if (entry.command) {
-            hookEntries.push({
-              command: entry.command,
-              ...(entry.timeout && { timeout: entry.timeout }),
-              ...(entry.matcher && { matcher: entry.matcher }),
-            })
-          }
-        }
-
-        if (hookEntries.length > 0) {
-          result[normalizedEvent] = hookEntries
-        }
-      }
-
-      return result
-    } catch {
-      continue
-    }
-  }
-
-  return {}
-}
-
-// ── Instructions Detection ──────────────────────────────────────
-
-function findInstructions(pluginDir: string): string | undefined {
-  const candidates = [
-    'CLAUDE.md',
-    'AGENTS.md',
-    'instructions.md',
-    'INSTRUCTIONS.md',
-    'README.md',
-  ]
-
-  for (const candidate of candidates) {
-    const filePath = resolve(pluginDir, candidate)
-    if (existsSync(filePath)) {
-      return `./${candidate}`
-    }
-  }
-
-  return undefined
-}
-
-// ── Directory Detection ─────────────────────────────────────────
-
-function detectDirectories(pluginDir: string) {
-  return {
-    skills: existsSync(resolve(pluginDir, 'skills')),
-    commands: existsSync(resolve(pluginDir, 'commands')),
-    agents: existsSync(resolve(pluginDir, 'agents')),
-    scripts: existsSync(resolve(pluginDir, 'scripts')),
-    assets: existsSync(resolve(pluginDir, 'assets')),
-  }
-}
-
-function toKebabCase(value: string): string {
-  return value
-    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-    .replace(/[^A-Za-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .toLowerCase()
-}
-
-function titleCaseFromDirName(value: string): string {
-  return value
-    .split(/[-_]+/)
-    .filter(Boolean)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join(' ')
-}
-
-function firstHeading(content: string): string | undefined {
-  for (const line of content.split(/\r?\n/)) {
-    const trimmed = line.trim()
-    const match = trimmed.match(/^#\s+(.+)$/)
-    if (match) {
-      return match[1].trim()
-    }
-  }
-  return undefined
-}
-
-function extractFrontmatterField(content: string, key: 'name' | 'description'): string | undefined {
-  const lines = content.split(/\r?\n/)
-  if (lines[0]?.trim() !== '---') return undefined
-
-  let endIndex = -1
-  for (let i = 1; i < lines.length; i += 1) {
-    if (lines[i].trim() === '---') {
-      endIndex = i
-      break
-    }
-  }
-
-  if (endIndex === -1) return undefined
-
-  for (const line of lines.slice(1, endIndex)) {
-    const match = line.match(new RegExp(`^${key}:\\s*(.*)$`))
-    if (!match) continue
-    return match[1].trim().replace(/^['"]|['"]$/g, '')
-  }
-
-  return undefined
-}
-
-function readMigratedSkills(pluginDir: string, dirs: MigrateResult['directories']): PersistedSkill[] {
-  const skills: PersistedSkill[] = []
-
-  if (dirs.skills) {
-    const skillsDir = resolve(pluginDir, 'skills')
-    const entries = readdirSync(skillsDir, { withFileTypes: true })
-
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue
-      const dirName = entry.name
-      const skillPath = resolve(skillsDir, dirName, 'SKILL.md')
-      let title = titleCaseFromDirName(dirName)
-      let description: string | undefined
-
-      if (existsSync(skillPath)) {
-        const content = readFileSync(skillPath, 'utf-8')
-        title = extractFrontmatterField(content, 'name')
-          ?? firstHeading(content)
-          ?? title
-        description = extractFrontmatterField(content, 'description')
-      }
-
-      skills.push({
-        dirName,
-        title,
-        description,
-        toolNames: [],
-      })
-    }
-  }
-
-  if (skills.length === 0 && dirs.commands) {
-    const commandsDir = resolve(pluginDir, 'commands')
-    const entries = readdirSync(commandsDir, { withFileTypes: true })
-
-    for (const entry of entries) {
-      if (!entry.isFile() || !entry.name.endsWith('.md')) continue
-      const dirName = toKebabCase(entry.name.replace(/\.md$/, '')) || 'command'
-      const content = readFileSync(resolve(commandsDir, entry.name), 'utf-8')
-      skills.push({
-        dirName,
-        title: firstHeading(content) ?? titleCaseFromDirName(dirName),
-        description: extractFrontmatterField(content, 'description'),
-        toolNames: [],
-      })
-    }
-  }
-
-  return skills.sort((a, b) => a.dirName.localeCompare(b.dirName))
-}
-
-function primarySource(result: MigrateResult): McpServer {
-  const [serverName, server] = Object.entries(result.mcp)[0] ?? []
-  const auth = normalizeMigrateAuth(server?.auth)
-  if (server) {
-    if (server.transport === 'stdio') {
-      return {
-        transport: 'stdio',
-        command: server.command ?? 'TODO_MCP_COMMAND',
-        args: server.args ?? [],
-        ...(server.env ? { env: server.env } : {}),
-        ...(auth ? { auth } : {}),
-      }
-    }
-
-    if (server.transport === 'sse') {
-      return {
-        transport: 'sse',
-        url: server.url ?? `https://example.com/${serverName ?? 'mcp'}`,
-        ...(auth ? { auth } : {}),
-      }
-    }
-
-    return {
-      transport: 'http',
-      url: server.url ?? `https://example.com/${serverName ?? 'mcp'}`,
-      ...(auth ? { auth } : {}),
-    }
-  }
-
-  return {
-    transport: 'stdio',
-    command: 'TODO_MCP_COMMAND',
-    args: [],
-  }
-}
-
-function normalizeMigrateAuth(auth: ParsedMcp[string]['auth']) {
-  if (!auth) return undefined
-  if (auth.type === 'none') {
-    return { type: 'none' as const }
-  }
-  if (auth.type === 'bearer' && auth.envVar) {
-    return {
-      type: 'bearer' as const,
-      envVar: auth.envVar,
-      headerName: auth.headerName ?? 'Authorization',
-      headerTemplate: auth.headerTemplate ?? 'Bearer ${value}',
-    }
-  }
-  if (auth.type === 'header' && auth.envVar && auth.headerName) {
-    return {
-      type: 'header' as const,
-      envVar: auth.envVar,
-      headerName: auth.headerName,
-      headerTemplate: auth.headerTemplate ?? '${value}',
-    }
-  }
-  return undefined
-}
-
-function buildMigratedScaffoldMetadata(result: MigrateResult, outputDir: string): McpScaffoldMetadata {
-  const pluginName = result.manifest.name ?? 'my-plugin'
-  const displayName = result.manifest.name ? titleCaseFromDirName(result.manifest.name) : 'Migrated Plugin'
-  const description = result.manifest.description ?? 'Migrated plugin scaffold.'
-  const generatedHookEvents = Object.keys(result.hooks)
-  const managedFiles = [
-    ...(result.instructions ? [result.instructions.replace(/^\.\//, '')] : []),
-    ...(['skills', 'commands', 'agents', 'scripts', 'assets'] as const).flatMap((dir) => {
-      if (!result.directories[dir]) return []
-      const baseDir = dir
-      const dirPath = resolve(outputDir, baseDir)
-      if (!existsSync(dirPath)) return []
-      const entries = readdirSync(dirPath, { withFileTypes: true })
-      const files: string[] = []
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          const nestedDir = resolve(dirPath, entry.name)
-          for (const nested of readdirSync(nestedDir, { withFileTypes: true })) {
-            if (nested.isFile()) {
-              files.push(`${baseDir}/${entry.name}/${nested.name}`)
-            }
-          }
-          continue
-        }
-        if (entry.isFile()) {
-          files.push(`${baseDir}/${entry.name}`)
-        }
-      }
-      return files
-    }),
-    'pluxx.config.ts',
-    MCP_TAXONOMY_PATH,
-    MCP_SCAFFOLD_METADATA_PATH,
-  ]
-
-  return {
-    version: 1,
-    source: primarySource(result),
-    serverInfo: {
-      name: pluginName,
-      title: displayName,
-      version: result.manifest.version ?? '0.1.0',
-      description,
-      ...(result.manifest.repository ? { websiteUrl: result.manifest.repository } : {}),
-    },
-    settings: {
-      pluginName,
-      displayName,
-      description,
-      skillGrouping: 'workflow',
-      requestedHookMode: generatedHookEvents.length > 0 ? 'safe' : 'none',
-      generatedHookMode: generatedHookEvents.length > 0 ? 'safe' : 'none',
-      generatedHookEvents,
-      runtimeAuthMode: 'inline',
-    },
-    userConfig: [],
-    tools: [],
-    resources: [],
-    resourceTemplates: [],
-    prompts: [],
-    skills: result.persistedSkills.map((skill) => ({
-      dirName: skill.dirName,
-      title: skill.title,
-      description: skill.description,
-      toolNames: skill.toolNames,
-    })),
-    managedFiles: [...new Set(managedFiles)].sort(),
-  }
-}
-
-// ── Copy Directories ────────────────────────────────────────────
-
-function copyDirectories(
-  pluginDir: string,
-  outputDir: string,
-  dirs: MigrateResult['directories'],
-): string[] {
-  const copied: string[] = []
-  const toCopy = ['skills', 'commands', 'agents', 'scripts', 'assets'] as const
-
-  for (const dir of toCopy) {
-    if (!dirs[dir]) continue
-    const src = resolve(pluginDir, dir)
-    const dest = resolve(outputDir, dir)
-    if (existsSync(dest)) {
-      console.log(`  skip ./${dir}/ (already exists)`)
-      continue
-    }
-    cpSync(src, dest, { recursive: true })
-    copied.push(dir)
-  }
-
-  return copied
-}
-
-// ── Config Generation ───────────────────────────────────────────
-
-function generateConfigTs(result: MigrateResult): string {
-  const lines: string[] = []
-  lines.push(`import { definePlugin } from 'pluxx'`)
-  lines.push('')
-  lines.push('export default definePlugin({')
-
-  // Identity
-  const name = result.manifest.name ?? 'my-plugin'
-  lines.push(`  name: ${quote(name)},`)
-  if (result.manifest.version) {
-    lines.push(`  version: ${quote(result.manifest.version)},`)
-  }
-  lines.push(`  description: ${quote(result.manifest.description ?? 'TODO: Describe your plugin')},`)
-
-  // Author
-  if (result.manifest.author) {
-    const a = result.manifest.author
-    lines.push('  author: {')
-    lines.push(`    name: ${quote(a.name)},`)
-    if (a.url) lines.push(`    url: ${quote(a.url)},`)
-    if (a.email) lines.push(`    email: ${quote(a.email)},`)
-    lines.push('  },')
-  } else {
-    lines.push('  author: { name: \'TODO: Your Name\' },')
-  }
-
-  if (result.manifest.repository) {
-    lines.push(`  repository: ${quote(result.manifest.repository)},`)
-  }
-  if (result.manifest.license) {
-    lines.push(`  license: ${quote(result.manifest.license)},`)
-  }
-  if (result.manifest.keywords && result.manifest.keywords.length > 0) {
-    lines.push(`  keywords: [${result.manifest.keywords.map(k => quote(k)).join(', ')}],`)
-  }
-
-  lines.push('')
-
-  // Directories
-  if (result.directories.skills) {
-    lines.push(`  skills: './skills/',`)
-  }
-  if (result.directories.commands) {
-    lines.push(`  commands: './commands/',`)
-  }
-  if (result.directories.agents) {
-    lines.push(`  agents: './agents/',`)
-  }
-  if (result.directories.scripts) {
-    lines.push(`  scripts: './scripts/',`)
-  }
-  if (result.directories.assets) {
-    lines.push(`  assets: './assets/',`)
-  }
-  if (result.instructions) {
-    lines.push(`  instructions: ${quote(result.instructions)},`)
-  }
-
-  // MCP
-  const mcpNames = Object.keys(result.mcp)
-  if (mcpNames.length > 0) {
-    lines.push('')
-    lines.push('  mcp: {')
-    for (const name of mcpNames) {
-      const server = result.mcp[name]
-      lines.push(`    ${quote(name)}: {`)
-      if (server.url) lines.push(`      url: ${quote(server.url)},`)
-      if (server.transport && server.transport !== 'http') {
-        lines.push(`      transport: ${quote(server.transport)},`)
-      }
-      if (server.command) lines.push(`      command: ${quote(server.command)},`)
-      if (server.args && server.args.length > 0) {
-        lines.push(`      args: [${server.args.map(a => quote(a)).join(', ')}],`)
-      }
-      if (server.env) {
-        lines.push('      env: {')
-        for (const [k, v] of Object.entries(server.env)) {
-          lines.push(`        ${quote(k)}: ${quote(v)},`)
-        }
-        lines.push('      },')
-      }
-      if (server.auth) {
-        lines.push('      auth: {')
-        lines.push(`        type: ${quote(server.auth.type)},`)
-        if (server.auth.envVar) lines.push(`        envVar: ${quote(server.auth.envVar)},`)
-        if (server.auth.headerName && server.auth.headerName !== 'Authorization') {
-          lines.push(`        headerName: ${quote(server.auth.headerName)},`)
-        }
-        if (server.auth.headerTemplate && server.auth.headerTemplate !== 'Bearer ${value}') {
-          lines.push(`        headerTemplate: ${quote(server.auth.headerTemplate)},`)
-        }
-        lines.push('      },')
-      }
-      lines.push('    },')
-    }
-    lines.push('  },')
-  }
-
-  // Hooks
-  const hookEvents = Object.keys(result.hooks)
-  if (hookEvents.length > 0) {
-    lines.push('')
-    lines.push('  hooks: {')
-    for (const event of hookEvents) {
-      const entries = result.hooks[event]
-      lines.push(`    ${event}: [`)
-      for (const entry of entries) {
-        const parts: string[] = [`command: ${quote(entry.command)}`]
-        if (entry.timeout) parts.push(`timeout: ${entry.timeout}`)
-        if (entry.matcher) parts.push(`matcher: ${quote(entry.matcher)}`)
-        lines.push(`      { ${parts.join(', ')} },`)
-      }
-      lines.push('    ],')
-    }
-    lines.push('  },')
-  }
-
-  lines.push('')
-  lines.push(`  // Migrated from ${result.platform} plugin`)
-  lines.push(`  targets: ['claude-code', 'cursor', 'codex', 'opencode'],`)
-  lines.push('})')
-  lines.push('')
-
-  return lines.join('\n')
-}
-
-function quote(s: string): string {
-  // Use single quotes, escape single quotes inside
-  return `'${s.replace(/'/g, "\\'")}'`
-}
-
-// ── Main Migrate Function ───────────────────────────────────────
-
-export async function migrate(inputPath: string): Promise<void> {
-  const pluginDir = resolve(inputPath)
-  const outputDir = process.cwd()
-
-  if (!existsSync(pluginDir)) {
-    console.error(`Error: Path does not exist: ${pluginDir}`)
-    process.exit(1)
-  }
-
-  console.log(`Scanning ${pluginDir} ...`)
-
-  // 1. Detect platform
-  const detection = detectPlatform(pluginDir)
-  if (!detection) {
-    console.error('Error: Could not detect plugin platform.')
-    console.error('Expected one of:')
-    console.error('  .claude-plugin/plugin.json')
-    console.error('  .cursor-plugin/plugin.json')
-    console.error('  .codex-plugin/plugin.json')
-    console.error('  package.json with @opencode-ai/plugin dependency')
-    process.exit(1)
-  }
-
-  console.log(`Detected: ${detection.platform} plugin`)
-
-  // 2. Parse manifest
-  const manifest = parseManifest(detection)
-  console.log(`  name: ${manifest.name ?? '(none)'}`)
-  console.log(`  version: ${manifest.version ?? '(none)'}`)
-
-  // 3. Parse MCP
-  const mcp = parseMcp(pluginDir, detection)
-  const mcpCount = Object.keys(mcp).length
-  if (mcpCount > 0) {
-    console.log(`  mcp servers: ${Object.keys(mcp).join(', ')}`)
-  }
-
-  // 4. Parse hooks
-  const hooks = parseHooks(pluginDir, detection)
-  const hookCount = Object.keys(hooks).length
-  if (hookCount > 0) {
-    console.log(`  hooks: ${Object.keys(hooks).join(', ')}`)
-  }
-
-  // 5. Find instructions
-  const instructions = findInstructions(pluginDir)
-  if (instructions) {
-    console.log(`  instructions: ${instructions}`)
-  }
-
-  // 6. Detect directories
-  const directories = detectDirectories(pluginDir)
-  const persistedSkills = readMigratedSkills(pluginDir, directories)
-  const dirNames = Object.entries(directories)
-    .filter(([_, exists]) => exists)
-    .map(([name]) => name)
-  if (dirNames.length > 0) {
-    console.log(`  directories: ${dirNames.join(', ')}`)
-  }
-  if (persistedSkills.length > 0) {
-    console.log(`  migrated skills: ${persistedSkills.map((skill) => skill.dirName).join(', ')}`)
-  }
-
-  // 7. Build result
-  const result: MigrateResult = {
-    platform: detection.platform,
-    manifest,
-    mcp,
-    hooks,
-    instructions,
-    directories,
-    persistedSkills,
-  }
-
-  // 8. Generate config
-  const configContent = generateConfigTs(result)
-  const configPath = resolve(outputDir, 'pluxx.config.ts')
-
-  if (existsSync(configPath)) {
-    console.error(`\nError: pluxx.config.ts already exists in ${outputDir}`)
-    console.error('Remove it first or run from a different directory.')
-    process.exit(1)
-  }
-
-  await Bun.write(configPath, configContent)
-  console.log(`\nGenerated pluxx.config.ts`)
-
-  // 9. Copy directories
-  const copied = copyDirectories(pluginDir, outputDir, directories)
-  if (copied.length > 0) {
-    console.log(`Copied: ${copied.map(d => `./${d}/`).join(', ')}`)
-  }
-
-  // 10. Copy instructions file if it exists and is not README.md
-  if (instructions && instructions !== './README.md') {
-    const srcInstr = resolve(pluginDir, instructions)
-    const destInstr = resolve(outputDir, instructions)
-    if (!existsSync(destInstr)) {
-      const content = readFileSync(srcInstr, 'utf-8')
-      await Bun.write(destInstr, content)
-      console.log(`Copied: ${instructions}`)
-    }
-  }
-
-  // 11. Create synthetic migration metadata/taxonomy so Agent Mode and evals work.
-  const taxonomyPath = resolve(outputDir, MCP_TAXONOMY_PATH)
-  const metadataPath = resolve(outputDir, MCP_SCAFFOLD_METADATA_PATH)
-  mkdirSync(resolve(outputDir, '.pluxx'), { recursive: true })
-  await Bun.write(taxonomyPath, `${JSON.stringify(result.persistedSkills, null, 2)}\n`)
-  await Bun.write(metadataPath, `${JSON.stringify(buildMigratedScaffoldMetadata(result, outputDir), null, 2)}\n`)
-  console.log(`Generated: ${MCP_TAXONOMY_PATH}, ${MCP_SCAFFOLD_METADATA_PATH}`)
-
-  console.log('')
-  console.log('Migration complete! Next steps:')
-  console.log('  1. Review pluxx.config.ts and fill in any TODOs')
-  console.log('  2. Run: pluxx doctor')
-  console.log('  3. Run: pluxx eval')
-  console.log('  4. Run: pluxx build')
-}