@girardmedia/bootspring 2.0.21 → 2.0.23

package/src/cli/generate.ts

@@ -0,0 +1,346 @@
+/**
+ * Bootspring Generate Command
+ * Generate and regenerate AI context files
+ *
+ * @package bootspring
+ * @module cli/generate
+ */
+
+import * as path from 'path';
+import * as config from '../core/config';
+import * as context from '../core/context';
+import * as utils from '../core/utils';
+import type { LoadedConfig, ConfigInput } from '../core/config';
+import type { ProjectContext, ValidationCheck } from '../core/context';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/**
+ * Git memory module interface
+ */
+interface GitMemoryModule {
+  extractLearnings: (options: { limit: number; since: string; cwd: string }) => { learnings: unknown[] };
+  toCompactSummary: (learnings: unknown[], options: { maxItems: number }) => string;
+}
+
+/**
+ * Agents template module interface
+ */
+interface AgentsTemplateModule {
+  generate: (cfg: LoadedConfig | ConfigInput) => string;
+}
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Generate CLAUDE.md content from config and project state
+ */
+export function generateClaudeMd(cfg: LoadedConfig | ConfigInput, ctx: ProjectContext): string {
+  const date = utils.formatDate();
+
+  const sections: string[] = [];
+
+  // Header
+  sections.push(`# ${cfg.project?.name ?? 'Project'} - AI Context
+
+**Generated by**: Bootspring v1.0.0
+**Last Updated**: ${date}
+**Status**: ${ctx.state.phase}
+**Health**: ${ctx.state.health}
+
+---`);
+
+  // Project Overview
+  sections.push(`## Project Overview
+
+${cfg.project?.description ?? 'A modern web application built with Bootspring.'}
+
+---`);
+
+  // Tech Stack
+  sections.push(`## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Framework | ${cfg.stack?.framework ?? 'unknown'} |
+| Language | ${cfg.stack?.language ?? 'unknown'} |
+| Database | ${cfg.stack?.database ?? 'unknown'} |
+| Hosting | ${cfg.stack?.hosting ?? 'unknown'} |
+
+---`);
+
+  // Enabled Plugins
+  const plugins = cfg.plugins ?? {};
+  const enabledPlugins = Object.entries(plugins)
+    .filter(([_name, p]) => p && p.enabled !== false);
+
+  if (enabledPlugins.length > 0) {
+    const pluginSections = enabledPlugins.map(([name, plugin]) => {
+      const pluginData = plugin as { provider?: string; features?: string[] };
+      return `### ${name.charAt(0).toUpperCase() + name.slice(1)}
+- **Provider**: ${pluginData.provider ?? 'default'}
+- **Features**: ${(pluginData.features ?? []).join(', ') || 'default'}`;
+    });
+
+    sections.push(`## Enabled Plugins
+
+${pluginSections.join('\n\n')}
+
+---`);
+  }
+
+  // Bootspring Commands
+  sections.push(`## Bootspring Commands
+
+Quick commands for your AI assistant:
+
+### Todo Management
+\`\`\`bash
+bootspring todo add "task"    # Add a new todo
+bootspring todo list          # List all todos
+bootspring todo done <id>     # Mark as complete
+bootspring todo clear         # Clear completed
+\`\`\`
+
+### Agents & Skills
+\`\`\`bash
+bootspring agent list         # List available agents
+bootspring agent invoke <n>   # Get specialized help
+bootspring skill search <q>   # Find code patterns
+bootspring skill show <name>  # View a skill
+\`\`\`
+
+### Project Tools
+\`\`\`bash
+bootspring dashboard          # Start real-time dashboard
+bootspring generate           # Regenerate this context
+bootspring quality pre-commit # Run quality checks
+bootspring context validate   # Validate project setup
+\`\`\`
+
+---`);
+
+  // Project State
+  const issuesText = ctx.state.issues && ctx.state.issues.length > 0
+    ? `\n- **Issues**: ${ctx.state.issues.join(', ')}`
+    : '';
+
+  sections.push(`## Current State
+
+- **Phase**: ${ctx.state.phase}
+- **Health**: ${ctx.state.health}
+- **Open Todos**: ${ctx.state.todos}${issuesText}
+
+---`);
+
+  // Git Info
+  if (ctx.git.initialized) {
+    sections.push(`## Git Repository
+
+- **Branch**: ${ctx.git.branch ?? 'unknown'}
+- **Remote**: ${ctx.git.hasRemote ? 'configured' : 'not configured'}
+
+---`);
+
+    // Extract git learnings
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      const gitMemory = require('../../intelligence/git-memory') as GitMemoryModule;
+      const loadedCfg = cfg as LoadedConfig;
+      const { learnings } = gitMemory.extractLearnings({
+        limit: 30,
+        since: '2 months ago',
+        cwd: loadedCfg._projectRoot ?? process.cwd()
+      });
+
+      if (learnings && learnings.length > 0) {
+        const learningsSection = gitMemory.toCompactSummary(learnings, { maxItems: 12 });
+        sections.push(learningsSection + '\n---');
+      }
+    } catch {
+      // Git memory extraction failed silently
+    }
+  }
+
+  // Project Structure
+  sections.push(`## Project Structure
+
+- **Structure Type**: ${ctx.files.structure}
+- **Has TypeScript**: ${ctx.files.hasTsConfig ? 'yes' : 'no'}
+- **Has Package.json**: ${ctx.files.hasPackageJson ? 'yes' : 'no'}
+
+---`);
+
+  // Development Guidelines
+  const language = cfg.stack?.language === 'typescript' ? 'TypeScript' : 'JavaScript';
+  sections.push(`## Development Guidelines
+
+### Code Style
+- Use ${language} for all new code
+- Follow existing naming conventions in the codebase
+- Keep files focused and under 300 lines when possible
+
+### Best Practices
+- Use Server Components by default (if Next.js)
+- Prefer Server Actions over API routes for mutations
+- Use Zod for all input validation
+- Never expose API keys to client-side code
+- Write tests for new features
+
+### Git Commits
+- Use conventional commit format: \`feat:\`, \`fix:\`, \`docs:\`, \`refactor:\`
+- Keep commits focused and atomic
+- **Never add Co-Authored-By or AI attribution to commits**
+- Never commit sensitive data or API keys
+
+---`);
+
+  // Custom Instructions
+  if (cfg.customInstructions) {
+    sections.push(`## Custom Instructions
+
+${cfg.customInstructions}
+
+---`);
+  }
+
+  // Footer
+  sections.push(`---
+
+*Generated by [Bootspring](https://bootspring.com) - Development scaffolding with intelligence*
+`);
+
+  return sections.join('\n\n');
+}
+
+// =============================================================================
+// Main Entry Point
+// =============================================================================
+
+/**
+ * Run generate command
+ */
+export async function run(args: string[]): Promise<void> {
+  const parsedArgs = utils.parseArgs(args);
+  const full = parsedArgs.full || parsedArgs.f;
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}\u26a1 Bootspring Generate${utils.COLORS.reset}
+${utils.COLORS.dim}Regenerating AI context...${utils.COLORS.reset}
+`);
+
+  // Load config
+  const cfg = config.load();
+
+  if (!cfg._configPath) {
+    utils.print.error('No bootspring.config.js found');
+    utils.print.dim('Run "bootspring init" first to initialize your project');
+    return;
+  }
+
+  // Get context
+  const ctx = context.get({ config: cfg });
+
+  // Generate CLAUDE.md
+  const claudePath = path.join(cfg._projectRoot ?? process.cwd(), cfg.paths?.context ?? 'CLAUDE.md');
+  const spinner = utils.createSpinner('Generating CLAUDE.md').start();
+
+  try {
+    const content = generateClaudeMd(cfg, ctx);
+    utils.writeFile(claudePath, content);
+    spinner.succeed('Generated CLAUDE.md');
+  } catch (error) {
+    spinner.fail(`Failed to generate CLAUDE.md: ${error instanceof Error ? error.message : String(error)}`);
+    return;
+  }
+
+  // Generate todo.md if missing (required for 100% score)
+  const todoPath = path.join(cfg._projectRoot ?? process.cwd(), cfg.paths?.todo ?? 'todo.md');
+  if (!utils.fileExists(todoPath)) {
+    const todoSpinner = utils.createSpinner('Generating todo.md').start();
+    const todoContent = `# ${cfg.project?.name ?? 'Project'} - Todo List
+
+> Last updated: ${utils.formatDate()}
+
+## In Progress
+
+## Pending
+
+- [ ] Review generated context
+- [ ] Configure environment variables
+
+## Completed
+
+`;
+    utils.writeFile(todoPath, todoContent);
+    todoSpinner.succeed('Generated todo.md');
+  }
+
+  // Validate context
+  const validation = context.validate({ config: cfg });
+
+  console.log(`
+${utils.COLORS.bold}Context Validation${utils.COLORS.reset}
+`);
+
+  for (const check of validation.checks) {
+    const icon = check.status === 'pass' ? utils.COLORS.green + '\u2713' :
+      check.status === 'fail' ? utils.COLORS.red + '\u2717' :
+        check.status === 'warn' ? utils.COLORS.yellow + '\u26a0' :
+          utils.COLORS.dim + '\u2139';
+    console.log(`  ${icon}${utils.COLORS.reset} ${check.name}: ${utils.COLORS.dim}${check.message}${utils.COLORS.reset}`);
+  }
+
+  console.log(`
+${utils.COLORS.bold}Score:${utils.COLORS.reset} ${validation.score}/${validation.maxScore} (${validation.percentage}%)
+`);
+
+  if (validation.valid) {
+    utils.print.success('Context is valid and ready for AI assistants');
+  } else {
+    utils.print.warning('Context has some issues - review the checks above');
+  }
+
+  // Full generation includes additional files
+  if (full) {
+    console.log(`\n${utils.COLORS.bold}Full Generation${utils.COLORS.reset}\n`);
+
+    // Generate .mcp.json if missing
+    const mcpPath = path.join(cfg._projectRoot ?? process.cwd(), '.mcp.json');
+    if (!utils.fileExists(mcpPath)) {
+      const mcpSpinner = utils.createSpinner('Generating .mcp.json').start();
+      const mcpConfig = {
+        mcpServers: {
+          bootspring: {
+            command: 'npx',
+            args: ['bootspring', 'mcp'],
+            env: {}
+          }
+        }
+      };
+      utils.writeFile(mcpPath, JSON.stringify(mcpConfig, null, 2));
+      mcpSpinner.succeed('Generated .mcp.json');
+    }
+
+    // Generate AGENTS.md for multi-tool compatibility
+    const agentsPath = path.join(cfg._projectRoot ?? process.cwd(), 'AGENTS.md');
+    const agentsSpinner = utils.createSpinner('Generating AGENTS.md').start();
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      const agentsTemplate = require('../../generators/templates/agents.template') as AgentsTemplateModule;
+      const agentsContent = agentsTemplate.generate(cfg);
+      utils.writeFile(agentsPath, agentsContent);
+      agentsSpinner.succeed('Generated AGENTS.md (Codex, Cursor, Amp, Kilo)');
+    } catch (error) {
+      agentsSpinner.fail(`Failed to generate AGENTS.md: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  console.log(`
+${utils.COLORS.dim}Tip: Run 'bootspring generate --full' to regenerate all files${utils.COLORS.reset}
+`);
+}