oden-forge 2.0.0

package/bin/migrate.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+const inquirer = require('inquirer');
+
+async function migrate() {
+  console.log('\n' + chalk.blue('🔄 Oden Forge Migration Tool'));
+  console.log(chalk.blue('═'.repeat(50)));
+
+  const claudeDir = path.join(process.env.HOME, '.claude');
+
+  // Detect what needs migration
+  const migrationPlan = await analyzeMigrationNeeds(claudeDir);
+
+  if (migrationPlan.items.length === 0) {
+    console.log(chalk.green('✅ No migration needed - you\'re already on v2!'));
+    return;
+  }
+
+  console.log(chalk.yellow(`Found ${migrationPlan.items.length} items to migrate:\n`));
+
+  migrationPlan.items.forEach(item => {
+    console.log(chalk.white(`📁 ${item.type}:`));
+    console.log(chalk.gray(`   From: ${item.from}`));
+    console.log(chalk.gray(`   Action: ${item.action}`));
+    console.log('');
+  });
+
+  const { proceed } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'proceed',
+    message: 'Proceed with migration?',
+    default: true
+  }]);
+
+  if (!proceed) {
+    console.log(chalk.blue('❌ Migration cancelled'));
+    return;
+  }
+
+  // Execute migration
+  await executeMigration(migrationPlan);
+}
+
+async function analyzeMigrationNeeds(claudeDir) {
+  const migrationItems = [];
+
+  // Check for old command structures
+  const oldCommands = [
+    path.join(claudeDir, 'commands', 'pm'),
+    path.join(claudeDir, 'commands', 'ccpm')
+  ];
+
+  oldCommands.forEach(dir => {
+    if (fs.existsSync(dir)) {
+      migrationItems.push({
+        type: 'Legacy Commands',
+        from: dir,
+        action: 'Remove (replaced by /oden:* commands)',
+        priority: 'high'
+      });
+    }
+  });
+
+  // Check for old scripts
+  const oldScripts = [
+    path.join(claudeDir, 'scripts', 'pm'),
+    path.join(claudeDir, 'scripts', 'ccpm')
+  ];
+
+  oldScripts.forEach(dir => {
+    if (fs.existsSync(dir)) {
+      migrationItems.push({
+        type: 'Legacy Scripts',
+        from: dir,
+        action: 'Remove (replaced by new scripts)',
+        priority: 'high'
+      });
+    }
+  });
+
+  // Check for CCPM installations
+  const ccpmPath = path.join(process.env.HOME, '.ccpm');
+  if (fs.existsSync(ccpmPath)) {
+    migrationItems.push({
+      type: 'CCMP Installation',
+      from: ccpmPath,
+      action: 'Archive and remove (now native)',
+      priority: 'medium'
+    });
+  }
+
+  // Check for old PRD/Epic structures
+  const oldStructures = [
+    path.join(claudeDir, 'pm'),
+    path.join(claudeDir, 'ccpm')
+  ];
+
+  oldStructures.forEach(dir => {
+    if (fs.existsSync(dir)) {
+      migrationItems.push({
+        type: 'Old Data Structure',
+        from: dir,
+        action: 'Migrate to new structure',
+        priority: 'low'
+      });
+    }
+  });
+
+  return {
+    items: migrationItems,
+    hasHighPriority: migrationItems.some(i => i.priority === 'high'),
+    hasData: migrationItems.some(i => i.priority === 'low')
+  };
+}
+
+async function executeMigration(migrationPlan) {
+  console.log(chalk.yellow('\n🔄 Executing migration...\n'));
+
+  let completed = 0;
+  let failed = 0;
+
+  for (const item of migrationPlan.items) {
+    try {
+      console.log(chalk.white(`Processing: ${item.type}`));
+
+      switch (item.priority) {
+        case 'high':
+          await removeOldInstallation(item);
+          break;
+        case 'medium':
+          await archiveAndRemove(item);
+          break;
+        case 'low':
+          await migrateDataStructure(item);
+          break;
+      }
+
+      console.log(chalk.green(`   ✅ ${item.action}`));
+      completed++;
+
+    } catch (error) {
+      console.log(chalk.red(`   ❌ Failed: ${error.message}`));
+      failed++;
+    }
+    console.log('');
+  }
+
+  // Summary
+  console.log(chalk.green('🎉 Migration Complete!'));
+  console.log(chalk.green('═'.repeat(30)));
+  console.log(chalk.white(`✅ Completed: ${completed}`));
+  if (failed > 0) {
+    console.log(chalk.red(`❌ Failed: ${failed}`));
+  }
+  console.log('');
+  console.log(chalk.blue('Next Steps:'));
+  console.log(chalk.white('   1. Open Claude Code'));
+  console.log(chalk.white('   2. Run: /oden:init'));
+  console.log(chalk.white('   3. Enjoy Oden Forge 2.0!'));
+  console.log('');
+}
+
+async function removeOldInstallation(item) {
+  if (fs.existsSync(item.from)) {
+    fs.removeSync(item.from);
+  }
+}
+
+async function archiveAndRemove(item) {
+  if (fs.existsSync(item.from)) {
+    const archivePath = item.from + '.bak.' + Date.now();
+    fs.moveSync(item.from, archivePath);
+    console.log(chalk.gray(`   Archived to: ${path.basename(archivePath)}`));
+  }
+}
+
+async function migrateDataStructure(item) {
+  // For now, just archive old data structures
+  // In the future, we could implement smart migration of PRDs/Epics
+  if (fs.existsSync(item.from)) {
+    const backupPath = item.from + '.backup.' + Date.now();
+    fs.copySync(item.from, backupPath);
+    console.log(chalk.gray(`   Backed up to: ${path.basename(backupPath)}`));
+    fs.removeSync(item.from);
+  }
+}
+
+module.exports = { migrate };

package/bin/oden-forge.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+const { program } = require('commander');
+const fs = require('fs-extra');
+const path = require('path');
+const { execSync } = require('child_process');
+
+program
+  .name('oden-forge')
+  .description('Documentation-First Development Toolkit for Claude Code')
+  .version('2.0.0');
+
+program
+  .command('install')
+  .description('Install Oden Forge skills to Claude Code')
+  .option('-f, --force', 'Force reinstall, overwriting existing')
+  .action(async (options) => {
+    const { install } = require('./install.js');
+    await install(options);
+  });
+
+program
+  .command('uninstall')
+  .description('Remove Oden Forge skills from Claude Code')
+  .action(async () => {
+    const { uninstall } = require('./pre-uninstall.js');
+    await uninstall();
+  });
+
+program
+  .command('status')
+  .description('Check installation status')
+  .action(() => {
+    const claudeDir = path.join(process.env.HOME, '.claude');
+    const odenCommands = path.join(claudeDir, 'commands', 'oden');
+
+    console.log('\n' + chalk.blue('📋 Oden Forge Status'));
+    console.log(chalk.blue('═'.repeat(50)));
+
+    if (fs.existsSync(odenCommands)) {
+      const commands = fs.readdirSync(odenCommands).filter(f => f.endsWith('.md'));
+      console.log(chalk.green(`✅ Installed: ${commands.length} commands`));
+      console.log(chalk.gray(`   Location: ${odenCommands}`));
+    } else {
+      console.log(chalk.red('❌ Not installed'));
+      console.log(chalk.yellow('   Run: oden-forge install'));
+    }
+
+    // Check for legacy v1
+    const legacyPaths = [
+      path.join(claudeDir, 'commands', 'pm'),
+      path.join(claudeDir, 'commands', 'ccpm'),
+      path.join(process.env.HOME, '.ccpm')
+    ];
+
+    const legacyFound = legacyPaths.filter(p => fs.existsSync(p));
+    if (legacyFound.length > 0) {
+      console.log(chalk.yellow('\n⚠️  Legacy installations found:'));
+      legacyFound.forEach(p => console.log(chalk.gray(`   ${p}`)));
+      console.log(chalk.yellow('   Run: oden-forge migrate'));
+    }
+
+    console.log('\n' + chalk.blue('💡 Quick Start:'));
+    console.log(chalk.white('   1. cd your-project'));
+    console.log(chalk.white('   2. claude-code (or your Claude Code command)'));
+    console.log(chalk.white('   3. /oden:init'));
+    console.log('');
+  });
+
+program
+  .command('migrate')
+  .description('Migrate from Oden Forge v1 or CCPM')
+  .action(async () => {
+    const { migrate } = require('./migrate.js');
+    await migrate();
+  });
+
+program
+  .command('update')
+  .description('Update to latest version')
+  .action(() => {
+    console.log(chalk.yellow('🔄 Updating Oden Forge...'));
+    try {
+      execSync('npm update -g oden-forge', { stdio: 'inherit' });
+      console.log(chalk.green('✅ Updated successfully!'));
+    } catch (error) {
+      console.log(chalk.red('❌ Update failed:'), error.message);
+    }
+  });
+
+// Default action
+program
+  .action(() => {
+    console.log('\n' + chalk.blue('🔨 Oden Forge - Documentation-First Development'));
+    console.log(chalk.blue('═'.repeat(50)));
+    console.log(chalk.white('Usage: oden-forge <command>'));
+    console.log('');
+    console.log(chalk.yellow('Commands:'));
+    console.log('  install   Install skills to Claude Code');
+    console.log('  status    Check installation status');
+    console.log('  migrate   Migrate from v1 or CCPM');
+    console.log('  update    Update to latest version');
+    console.log('  help      Show help');
+    console.log('');
+    console.log(chalk.gray('After installation, use /oden:init in Claude Code'));
+    console.log('');
+  });
+
+if (process.argv.length === 2) {
+  program.outputHelp();
+}
+
+program.parse();

package/bin/post-install.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+async function postInstall() {
+  // Only run auto-install for global installs
+  if (!process.env.npm_config_global) {
+    return; // Skip for local installs
+  }
+
+  try {
+    // Check if dependencies are available
+    const chalk = require('chalk');
+    const { install } = require('./install.js');
+
+    console.log(chalk.blue('\n🔄 Running post-install setup...'));
+
+    await install({ force: false });
+
+    console.log(chalk.blue('\n💡 Next Steps:'));
+    console.log(chalk.white('   1. Open Claude Code in your project'));
+    console.log(chalk.white('   2. Run: /oden:init'));
+    console.log(chalk.white('   3. Follow the wizard'));
+    console.log('');
+    console.log(chalk.gray('   📖 Documentation: https://javikin.github.io/oden-forge'));
+    console.log(chalk.gray('   🆘 Help: oden-forge --help'));
+    console.log('');
+
+  } catch (error) {
+    // Fallback if dependencies aren't ready yet
+    console.log('\n🔄 Oden Forge 2.0 installed!');
+    console.log('');
+    console.log('💡 Next Steps:');
+    console.log('   1. Run: oden-forge install');
+    console.log('   2. Open Claude Code in your project');
+    console.log('   3. Run: /oden:init');
+    console.log('');
+    console.log('📖 Documentation: https://javikin.github.io/oden-forge');
+    console.log('🆘 Help: oden-forge --help');
+    console.log('');
+  }
+}
+
+// Only run if called directly
+if (require.main === module) {
+  postInstall();
+}
+
+module.exports = { postInstall };

package/bin/pre-uninstall.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+const inquirer = require('inquirer');
+
+async function uninstall() {
+  console.log('\n' + chalk.yellow('🗑️  Uninstalling Oden Forge'));
+  console.log(chalk.yellow('═'.repeat(40)));
+
+  const claudeDir = path.join(process.env.HOME, '.claude');
+  const pathsToRemove = [
+    path.join(claudeDir, 'commands', 'oden'),
+    path.join(claudeDir, 'scripts', 'oden'),
+    path.join(claudeDir, 'prds'),
+    path.join(claudeDir, 'epics')
+  ];
+
+  // Check what exists
+  const existingPaths = pathsToRemove.filter(p => fs.existsSync(p));
+
+  if (existingPaths.length === 0) {
+    console.log(chalk.green('✅ Oden Forge is not installed'));
+    return;
+  }
+
+  console.log(chalk.white('The following will be removed:'));
+  existingPaths.forEach(p => {
+    console.log(chalk.gray(`   ${p}`));
+  });
+
+  // Ask for confirmation in interactive mode
+  if (process.stdout.isTTY) {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Are you sure you want to remove Oden Forge?',
+      default: false
+    }]);
+
+    if (!confirm) {
+      console.log(chalk.blue('❌ Uninstall cancelled'));
+      return;
+    }
+  }
+
+  // Remove files
+  console.log(chalk.yellow('\n🗑️  Removing files...'));
+  let removed = 0;
+
+  for (const p of existingPaths) {
+    try {
+      if (fs.existsSync(p)) {
+        fs.removeSync(p);
+        console.log(chalk.green(`   ✅ Removed: ${path.basename(p)}`));
+        removed++;
+      }
+    } catch (error) {
+      console.log(chalk.red(`   ❌ Failed to remove ${p}: ${error.message}`));
+    }
+  }
+
+  // Don't remove ~/.claude/rules as other tools might use it
+  // Just remove our specific rules
+  const rulesDir = path.join(claudeDir, 'rules');
+  if (fs.existsSync(rulesDir)) {
+    try {
+      const odenRules = [
+        'oden-methodology.md',
+        'worktree-operations.md',
+        'agent-coordination.md',
+        'standard-patterns.md',
+        'github-operations.md',
+        'frontmatter-operations.md',
+        'datetime.md',
+        'path-standards.md',
+        'strip-frontmatter.md'
+      ];
+
+      let rulesRemoved = 0;
+      odenRules.forEach(rule => {
+        const rulePath = path.join(rulesDir, rule);
+        if (fs.existsSync(rulePath)) {
+          fs.removeSync(rulePath);
+          rulesRemoved++;
+        }
+      });
+
+      if (rulesRemoved > 0) {
+        console.log(chalk.green(`   ✅ Removed: ${rulesRemoved} rules`));
+      }
+    } catch (error) {
+      console.log(chalk.yellow(`   ⚠️  Could not clean rules: ${error.message}`));
+    }
+  }
+
+  console.log(chalk.green(`\n✅ Uninstall complete (${removed + 1} items removed)`));
+  console.log(chalk.gray('Your project files remain untouched.'));
+  console.log('');
+}
+
+// Only run if called directly (not during npm uninstall)
+if (require.main === module) {
+  uninstall();
+}
+
+module.exports = { uninstall };

package/install.sh

@@ -0,0 +1,231 @@
+#!/bin/bash
+
+# ============================================================================
+# ODEN FORGE - INSTALLER
+# ============================================================================
+# Instala todo lo necesario para usar Oden Forge:
+# - Comandos /oden:* (52 comandos unificados)
+# - Scripts de soporte
+# - Hooks
+# - Rules de Claude
+# - Carpetas para PRDs y Epics
+# - Agentes de desarrollo (opcional)
+# ============================================================================
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo ""
+echo -e "${BLUE}╔══════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║                    ODEN FORGE INSTALLER                      ║${NC}"
+echo -e "${BLUE}║         Documentation-First Development Toolkit              ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# ============================================================================
+# CHECK PREREQUISITES
+# ============================================================================
+
+echo -e "${YELLOW}Verificando requisitos...${NC}"
+
+# Check if Claude directory exists
+if [ ! -d "$HOME/.claude" ]; then
+    echo -e "${YELLOW}Creando directorio ~/.claude...${NC}"
+    mkdir -p "$HOME/.claude"
+fi
+
+# Check for git
+if ! command -v git &> /dev/null; then
+    echo -e "${RED}❌ Git no está instalado. Por favor instala git primero.${NC}"
+    exit 1
+fi
+echo -e "${GREEN}✓ Git instalado${NC}"
+
+# Check for GitHub CLI
+if ! command -v gh &> /dev/null; then
+    echo -e "${YELLOW}⚠ GitHub CLI (gh) no está instalado.${NC}"
+    echo -e "  Para sync con GitHub, instala: https://cli.github.com/"
+    GH_INSTALLED=false
+else
+    echo -e "${GREEN}✓ GitHub CLI instalado${NC}"
+    GH_INSTALLED=true
+fi
+
+echo ""
+
+# ============================================================================
+# INSTALL COMMANDS
+# ============================================================================
+
+echo -e "${YELLOW}Instalando comandos /oden:*...${NC}"
+
+mkdir -p "$HOME/.claude/commands/oden"
+
+if [ -d "$SCRIPT_DIR/.claude/commands/oden" ]; then
+    cp -r "$SCRIPT_DIR/.claude/commands/oden/"* "$HOME/.claude/commands/oden/"
+    ODEN_COUNT=$(ls "$HOME/.claude/commands/oden/"*.md 2>/dev/null | wc -l | tr -d ' ')
+    echo -e "${GREEN}✓ $ODEN_COUNT comandos /oden:* instalados${NC}"
+else
+    echo -e "${RED}❌ No se encontraron comandos${NC}"
+    exit 1
+fi
+
+echo ""
+
+# ============================================================================
+# INSTALL SCRIPTS
+# ============================================================================
+
+echo -e "${YELLOW}Instalando scripts...${NC}"
+
+mkdir -p "$HOME/.claude/scripts/oden"
+
+if [ -d "$SCRIPT_DIR/.claude/scripts/oden" ]; then
+    cp -r "$SCRIPT_DIR/.claude/scripts/oden/"* "$HOME/.claude/scripts/oden/"
+    chmod +x "$HOME/.claude/scripts/oden/"*.sh 2>/dev/null || true
+    SCRIPT_COUNT=$(ls "$HOME/.claude/scripts/oden/"*.sh 2>/dev/null | wc -l | tr -d ' ')
+    echo -e "${GREEN}✓ $SCRIPT_COUNT scripts instalados${NC}"
+else
+    echo -e "${YELLOW}⚠ No se encontraron scripts${NC}"
+fi
+
+echo ""
+
+# ============================================================================
+# INSTALL HOOKS
+# ============================================================================
+
+echo -e "${YELLOW}Instalando hooks...${NC}"
+
+mkdir -p "$HOME/.claude/hooks"
+
+if [ -d "$SCRIPT_DIR/.claude/hooks" ]; then
+    cp -r "$SCRIPT_DIR/.claude/hooks/"* "$HOME/.claude/hooks/"
+    chmod +x "$HOME/.claude/hooks/"*.sh 2>/dev/null || true
+    echo -e "${GREEN}✓ Hooks instalados${NC}"
+else
+    echo -e "${YELLOW}⚠ No se encontraron hooks${NC}"
+fi
+
+echo ""
+
+# ============================================================================
+# INSTALL RULES
+# ============================================================================
+
+echo -e "${YELLOW}Instalando rules...${NC}"
+
+mkdir -p "$HOME/.claude/rules"
+
+if [ -d "$SCRIPT_DIR/.claude/rules" ]; then
+    cp -r "$SCRIPT_DIR/.claude/rules/"* "$HOME/.claude/rules/"
+    RULES_COUNT=$(ls "$HOME/.claude/rules/"*.md 2>/dev/null | wc -l | tr -d ' ')
+    echo -e "${GREEN}✓ $RULES_COUNT rules instaladas${NC}"
+else
+    echo -e "${YELLOW}⚠ No se encontraron rules${NC}"
+fi
+
+echo ""
+
+# ============================================================================
+# CREATE FOLDERS
+# ============================================================================
+
+echo -e "${YELLOW}Creando carpetas de trabajo...${NC}"
+
+mkdir -p "$HOME/.claude/prds"
+mkdir -p "$HOME/.claude/epics"
+touch "$HOME/.claude/prds/.gitkeep" 2>/dev/null || true
+touch "$HOME/.claude/epics/.gitkeep" 2>/dev/null || true
+echo -e "${GREEN}✓ Carpetas prds/ y epics/ creadas${NC}"
+
+echo ""
+
+# ============================================================================
+# INSTALL AGENTS (OPTIONAL)
+# ============================================================================
+
+echo -e "${YELLOW}¿Deseas instalar los agentes de desarrollo? (y/n)${NC}"
+read -r INSTALL_AGENTS
+
+if [[ "$INSTALL_AGENTS" =~ ^[Yy]$ ]]; then
+    echo -e "${YELLOW}Instalando agentes...${NC}"
+
+    mkdir -p "$HOME/.claude/agents"
+
+    if [ -d "$SCRIPT_DIR/.claude/agents" ]; then
+        cp -r "$SCRIPT_DIR/.claude/agents/"* "$HOME/.claude/agents/"
+        AGENTS_COUNT=$(ls "$HOME/.claude/agents/"*.md 2>/dev/null | wc -l | tr -d ' ')
+        echo -e "${GREEN}✓ $AGENTS_COUNT agentes instalados${NC}"
+    else
+        echo -e "${YELLOW}⚠ No se encontraron agentes en el repo.${NC}"
+        echo -e "  Usa /oden:init-agents dentro de Claude Code para instalarlos.${NC}"
+    fi
+else
+    echo -e "${BLUE}Agentes no instalados. Usa /oden:init-agents después.${NC}"
+fi
+
+echo ""
+
+# ============================================================================
+# GITHUB CLI SETUP
+# ============================================================================
+
+if [ "$GH_INSTALLED" = true ]; then
+    # Check if already authenticated
+    if gh auth status &> /dev/null; then
+        echo -e "${GREEN}✓ GitHub CLI ya está autenticado${NC}"
+    else
+        echo -e "${YELLOW}¿Deseas configurar GitHub CLI ahora? (y/n)${NC}"
+        read -r SETUP_GH
+
+        if [[ "$SETUP_GH" =~ ^[Yy]$ ]]; then
+            echo -e "${YELLOW}Iniciando autenticación de GitHub...${NC}"
+            gh auth login
+        fi
+    fi
+fi
+
+echo ""
+
+# ============================================================================
+# SUMMARY
+# ============================================================================
+
+echo -e "${GREEN}╔══════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║                  INSTALACIÓN COMPLETADA                      ║${NC}"
+echo -e "${GREEN}╚══════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "${BLUE}COMANDOS INSTALADOS (/oden:*):${NC}"
+echo -e "  Setup:        init, init-agents, init-mcp, help"
+echo -e "  Pre-Dev:      architect, analyze, spec, plan, checklist"
+echo -e "  GitHub:       prd-new, epic-sync, issue-start, ..."
+echo -e "  Desarrollo:   dev, test, debug, research, daily"
+echo -e "  Git:          git start, git pr, git finish"
+echo ""
+echo -e "${BLUE}ESTRUCTURA CREADA:${NC}"
+echo -e "  ~/.claude/commands/oden/   → Comandos"
+echo -e "  ~/.claude/scripts/oden/    → Scripts"
+echo -e "  ~/.claude/hooks/           → Hooks"
+echo -e "  ~/.claude/rules/           → Rules"
+echo -e "  ~/.claude/prds/            → PRDs"
+echo -e "  ~/.claude/epics/           → Epics"
+echo ""
+echo -e "${BLUE}PRÓXIMOS PASOS:${NC}"
+echo -e "  1. Abre Claude Code en tu proyecto"
+echo -e "  2. Ejecuta: /oden:init"
+echo -e "  3. Sigue el wizard"
+echo ""
+echo -e "${YELLOW}DOCUMENTACIÓN:${NC}"
+echo -e "  README: $SCRIPT_DIR/README.md"
+echo -e "  Help:   /oden:help"
+echo ""