supernal-coding/archive/2025-08-08/cli-commands/agent/suggest.js

Comprehensive development workflow CLI with kanban task management, project validation, git safety hooks, and cross-project distribution system

const chalk = require('chalk');
const { execSync } = require('child_process');

function gatherContext() {
  const context = {
    cwd: process.cwd(),
    command: process.argv.slice(2).join(' '),
    node: process.version,
    platform: process.platform,
    timestamp: new Date().toISOString()
  };

  // Try to get git info safely
  try {
    context.gitBranch = execSync('git branch --show-current 2>/dev/null', { encoding: 'utf8' }).trim();
  } catch (e) {
    // Not in a git repo - that's fine
  }

  // Get supernal-coding version
  try {
    const packagePath = require('path').join(__dirname, '../../package.json');
    const pkg = require(packagePath);
    context.version = pkg.version;
  } catch (e) {
    context.version = 'unknown';
  }

  return context;
}

function generateGitHubUrl(title, description, type = 'feedback') {
  const context = gatherContext();
  
  // Default to main repo, but users can fork and change this
  const repo = 'supernalintelligence/supernal-coding';
  
  const issueTitle = encodeURIComponent(`[${type.toUpperCase()}] ${title}`);
  
  const body = `## Description
${description}

## Environment
- **OS**: ${context.platform}
- **Node**: ${context.node}
- **Supernal Coding**: ${context.version}
- **Command**: \`${context.command}\`
${context.gitBranch ? `- **Git Branch**: ${context.gitBranch}` : ''}

## Context
- **Directory**: ${context.cwd}
- **Timestamp**: ${context.timestamp}

---
*Issue created via \`sc suggest\` command*`;

  const encodedBody = encodeURIComponent(body);
  const labels = encodeURIComponent('user-feedback');

  return `https://github.com/${repo}/issues/new?title=${issueTitle}&body=${encodedBody}&labels=${labels}`;
}

function showHelp() {
  console.log(chalk.cyan('\n💡 Supernal Coding Suggestion System\n'));
  console.log(chalk.white('Instantly create GitHub issues with context\n'));
  
  console.log(chalk.yellow('Usage:'));
  console.log(chalk.white('  sc suggest "Your feedback here"'));
  console.log(chalk.white('  sc suggest bug "Bug description"'));
  console.log(chalk.white('  sc suggest feature "Feature idea"'));
  console.log();
  
  console.log(chalk.yellow('Examples:'));
  console.log(chalk.white('  sc suggest "The kanban command is too slow"'));
  console.log(chalk.white('  sc suggest bug "CLI crashes on empty directory"'));
  console.log(chalk.white('  sc suggest feature "Add dark mode support"'));
  console.log();
  
  console.log(chalk.green('How it works:'));
  console.log(chalk.gray('  1. Captures your system context'));
  console.log(chalk.gray('  2. Generates GitHub issue URL with details'));
  console.log(chalk.gray('  3. You click the URL to submit (or not)'));
  console.log(chalk.gray('  4. Works with forks - no authentication needed'));
}

module.exports = async function(action, options) {
  // Handle different command patterns
  let title, type;
  
  if (action === 'help' || action === '--help') {
    showHelp();
    return;
  }
  
  // Handle: sc suggest bug "description"
  if (action === 'bug' || action === 'feature') {
    type = action;
    title = Array.isArray(options._) ? options._[0] : options._;
    
    if (!title) {
      console.log(chalk.red(`❌ Please provide a ${type} description`));
      console.log(chalk.white(`   Example: sc suggest ${type} "Your ${type} description here"`));
      return;
    }
  }
  // Handle: sc suggest "general feedback"
  else {
    type = 'feedback';
    title = action; // The action IS the title in this case
    
    if (!title) {
      console.log(chalk.red('❌ Please provide your suggestion'));
      console.log(chalk.white('   Example: sc suggest "Your feedback here"'));
      showHelp();
      return;
    }
  }

  // Generate the GitHub issue URL
  const githubUrl = generateGitHubUrl(title, title, type);
  
  console.log(chalk.green('\n✅ GitHub Issue Ready!'));
  console.log(chalk.cyan('\n🔗 Click this URL to create the issue:'));
  console.log(chalk.blue(githubUrl));
  console.log(chalk.gray('\n💡 The URL contains your suggestion and system context'));
  console.log(chalk.gray('   Click to open GitHub, review the details, and submit'));
  
  // Show what will be included
  console.log(chalk.yellow('\n📋 Context included:'));
  const context = gatherContext();
  console.log(chalk.gray(`   • Command: ${context.command}`));
  console.log(chalk.gray(`   • System: ${context.platform} with Node ${context.node}`));
  console.log(chalk.gray(`   • Version: supernal-coding ${context.version}`));
  if (context.gitBranch) {
    console.log(chalk.gray(`   • Git branch: ${context.gitBranch}`));
  }
};