sf-agent-framework/tools/installer/lib/post-install.js

AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction

#!/usr/bin/env node

/**
 * Post-install script for SF-Agent Framework CLI
 * Displays welcome message and next steps after npm installation
 */

const chalk = require('chalk');
const path = require('path');
const fs = require('fs');

function displayWelcome() {
  console.log('\n' + '='.repeat(60));
  console.log(chalk.blue.bold('   SF-Agent Framework CLI Successfully Installed! 🎉'));
  console.log('='.repeat(60));

  console.log(chalk.cyan('\n📦 Package Information:'));
  console.log('   Version: 4.0.0');
  console.log('   Type: CLI Tools Package');

  console.log(chalk.cyan('\n🚀 Quick Start:'));
  console.log(chalk.white('   To install the full SF-Agent Framework in your project:'));
  console.log(chalk.green.bold('\n   npx sf-agent-framework install'));

  console.log(chalk.cyan('\n📚 Available Commands:'));
  console.log('   sf-agent install       - Install framework in project');
  console.log('   sf-agent workflow      - Start interactive workflow');
  console.log('   sf-agent phase         - Switch planning/development mode');
  console.log('   sf-agent build         - Generate web bundles');
  console.log('   sf-agent handoff       - Manage agent handoffs');
  console.log('   sf-agent help          - Show all commands');

  console.log(chalk.cyan('\n🌐 Web UI Usage:'));
  console.log('   1. Run: sf-agent build');
  console.log('   2. Upload dist/teams/*.txt to ChatGPT/Gemini');
  console.log('   3. Use *help command in chat for slash commands');

  console.log(chalk.cyan('\n💡 Next Steps:'));
  console.log('   1. Navigate to your Salesforce project directory');
  console.log('   2. Run: ' + chalk.green('sf-agent install'));
  console.log('   3. Choose your IDE configuration');
  console.log('   4. Start building with AI agents!');

  console.log(chalk.cyan('\n📖 Documentation:'));
  console.log('   GitHub: https://github.com/kripaSFDC/sf-agent-framework');
  console.log('   Issues: https://github.com/kripaSFDC/sf-agent-framework/issues');

  console.log(chalk.cyan('\n🤝 Community:'));
  console.log('   Star us on GitHub if you find this helpful!');
  console.log('   Report issues or request features on GitHub');

  console.log('\n' + '='.repeat(60));
  console.log(chalk.yellow('\n⚡ Ready to revolutionize your Salesforce development!'));
  console.log('='.repeat(60) + '\n');
}

// Only show message if not in CI environment
if (!process.env.CI && !process.env.CONTINUOUS_INTEGRATION && !process.env.SF_AGENT_QUIET) {
  displayWelcome();
}

// Create success marker file for verification
try {
  const markerPath = path.join(__dirname, '.post-install-success');
  fs.writeFileSync(markerPath, new Date().toISOString());
} catch (error) {
  // Silently fail - not critical
}