@girardmedia/bootspring 2.0.21 → 2.0.23

package/src/cli/fundraise.ts

@@ -0,0 +1,494 @@
+/**
+ * Bootspring Fundraise Command
+ * Fundraising tools and templates
+ *
+ * @package bootspring
+ * @command fundraise
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Type interfaces for JS modules
+interface Colors {
+  reset: string;
+  bold: string;
+  dim: string;
+  cyan: string;
+  green: string;
+  yellow: string;
+  red: string;
+}
+
+interface PrintModule {
+  error(msg: string): void;
+  dim(msg: string): void;
+  warning(msg: string): void;
+  success(msg: string): void;
+}
+
+interface Spinner {
+  start(): Spinner;
+  stop(): void;
+  succeed(text: string): void;
+  fail(text: string): void;
+}
+
+interface UtilsModule {
+  COLORS: Colors;
+  print: PrintModule;
+  createSpinner(text: string): Spinner;
+}
+
+interface AuthModule {
+  isAuthenticated(): boolean;
+}
+
+interface ApiModule {
+  getTemplate(category: string, templateFile: string): Promise<TemplateResponse>;
+}
+
+interface TemplateResponse {
+  content: string;
+  error?: string | undefined;
+  message?: string | undefined;
+}
+
+interface FetchTemplateResult {
+  content?: string | undefined;
+  error?: string | undefined;
+  message?: string | undefined;
+}
+
+interface Template {
+  name: string;
+  file: string;
+  output: string;
+  description: string;
+}
+
+interface FailedTemplate {
+  name: string;
+  error: string;
+}
+
+interface ProjectConfig {
+  projectName?: string | undefined;
+  name?: string | undefined;
+  domain?: string | undefined;
+}
+
+const utils = require('../core/utils') as UtilsModule;
+const api = require('../core/api-client') as ApiModule;
+const auth = require('../core/auth') as AuthModule;
+
+/**
+ * Output directory for fundraising docs
+ */
+const OUTPUT_DIR = 'planning';
+
+/**
+ * Available fundraising templates
+ */
+const TEMPLATES: Record<string, Template> = {
+  pitch: {
+    name: 'Pitch Deck Outline',
+    file: 'pitch-deck-outline.md',
+    output: 'PITCH_DECK.md',
+    description: 'Structured pitch deck with speaker notes'
+  },
+  dataroom: {
+    name: 'Data Room Checklist',
+    file: 'data-room-checklist.md',
+    output: 'DATA_ROOM_CHECKLIST.md',
+    description: 'Due diligence document checklist'
+  },
+  investors: {
+    name: 'Investor Research',
+    file: 'investor-research.md',
+    output: 'INVESTOR_RESEARCH.md',
+    description: 'Investor tracking and research template'
+  }
+};
+
+/**
+ * Get project config if available
+ */
+function getProjectConfig(): ProjectConfig {
+  const configPath = path.join(process.cwd(), 'bootspring.config.js');
+  if (fs.existsSync(configPath)) {
+    try {
+      return require(configPath) as ProjectConfig;
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+/**
+ * Replace template variables
+ */
+function processTemplate(content: string, config: ProjectConfig): string {
+  const projectName = config.projectName || config.name || path.basename(process.cwd());
+  const date = new Date().toISOString().split('T')[0] || '';
+
+  return content
+    .replace(/\{\{PROJECT_NAME\}\}/g, projectName)
+    .replace(/\{\{DATE\}\}/g, date)
+    .replace(/\{\{DOMAIN\}\}/g, config.domain || 'example.com');
+}
+
+/**
+ * Fetch template content from API
+ */
+async function fetchTemplate(templateFile: string): Promise<FetchTemplateResult> {
+  if (!auth.isAuthenticated()) {
+    return { error: 'auth_required' };
+  }
+
+  try {
+    const response = await api.getTemplate('fundraising', templateFile);
+    return response;
+  } catch (error) {
+    const err = error as { status?: number; message?: string };
+    if (err.status === 401) {
+      return { error: 'auth_required' };
+    }
+    if (err.status === 403) {
+      return { error: 'upgrade_required' };
+    }
+    return { error: 'network_error', message: err.message };
+  }
+}
+
+/**
+ * Initialize fundraising docs
+ */
+async function fundraiseInit(): Promise<void> {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Fundraising Materials${utils.COLORS.reset}
+${utils.COLORS.dim}Initialize fundraising documents and checklists${utils.COLORS.reset}
+`);
+
+  // Check authentication
+  if (!auth.isAuthenticated()) {
+    utils.print.error('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  const config = getProjectConfig();
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+
+  // Create output directory
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  const created: string[] = [];
+  const skipped: string[] = [];
+  const failed: FailedTemplate[] = [];
+
+  const spinner = utils.createSpinner('Loading templates...');
+  spinner.start();
+
+  // Create all fundraising templates
+  for (const [_key, template] of Object.entries(TEMPLATES)) {
+    const outputPath = path.join(outputDir, template.output);
+
+    if (fs.existsSync(outputPath)) {
+      skipped.push(template.name);
+      continue;
+    }
+
+    const result = await fetchTemplate(template.file);
+
+    if (result.error) {
+      failed.push({ name: template.name, error: result.error });
+      continue;
+    }
+
+    if (result.content) {
+      const processed = processTemplate(result.content, config);
+      fs.writeFileSync(outputPath, processed);
+      created.push(template.name);
+    }
+  }
+
+  spinner.stop();
+
+  if (created.length > 0) {
+    console.log(`${utils.COLORS.bold}Created:${utils.COLORS.reset}`);
+    for (const name of created) {
+      console.log(`  ${utils.COLORS.green}✓${utils.COLORS.reset} ${name}`);
+    }
+    console.log();
+  }
+
+  if (skipped.length > 0) {
+    console.log(`${utils.COLORS.bold}Skipped (already exist):${utils.COLORS.reset}`);
+    for (const name of skipped) {
+      console.log(`  ${utils.COLORS.dim}●${utils.COLORS.reset} ${name}`);
+    }
+    console.log();
+  }
+
+  if (failed.length > 0) {
+    console.log(`${utils.COLORS.bold}Failed:${utils.COLORS.reset}`);
+    for (const { name, error } of failed) {
+      console.log(`  ${utils.COLORS.red}✗${utils.COLORS.reset} ${name} (${error})`);
+    }
+    console.log();
+  }
+
+  console.log(`${utils.COLORS.bold}Next Steps:${utils.COLORS.reset}`);
+  console.log(`  1. Fill out ${utils.COLORS.cyan}${OUTPUT_DIR}/PITCH_DECK.md${utils.COLORS.reset}`);
+  console.log(`  2. Run ${utils.COLORS.cyan}bootspring agent invoke fundraising-expert${utils.COLORS.reset}`);
+  console.log(`  3. Run ${utils.COLORS.cyan}bootspring fundraise status${utils.COLORS.reset} to check progress`);
+}
+
+/**
+ * Create a specific fundraising document
+ */
+async function fundraiseCreate(templateKey: string): Promise<void> {
+  const template = TEMPLATES[templateKey];
+
+  if (!template) {
+    utils.print.error(`Unknown template: ${templateKey}`);
+    console.log(`\nAvailable templates: ${Object.keys(TEMPLATES).join(', ')}`);
+    return;
+  }
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ ${template.name}${utils.COLORS.reset}
+${utils.COLORS.dim}${template.description}${utils.COLORS.reset}
+`);
+
+  // Check authentication
+  if (!auth.isAuthenticated()) {
+    utils.print.error('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  const config = getProjectConfig();
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+  const outputPath = path.join(outputDir, template.output);
+
+  // Create output directory
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  if (fs.existsSync(outputPath)) {
+    utils.print.warning(`File already exists: ${OUTPUT_DIR}/${template.output}`);
+    console.log(`Edit it directly or use ${utils.COLORS.cyan}bootspring fundraise show ${templateKey}${utils.COLORS.reset}`);
+    return;
+  }
+
+  const spinner = utils.createSpinner('Loading template...');
+  spinner.start();
+
+  const result = await fetchTemplate(template.file);
+
+  if (result.error === 'auth_required') {
+    spinner.fail('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  if (result.error === 'upgrade_required') {
+    spinner.fail('Upgrade required');
+    console.log(`${utils.COLORS.dim}This template requires a Pro subscription.${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}Run: bootspring billing upgrade${utils.COLORS.reset}`);
+    return;
+  }
+
+  if (result.error) {
+    spinner.fail('Failed to load template');
+    console.log(`${utils.COLORS.dim}${result.message || 'Check your internet connection.'}${utils.COLORS.reset}`);
+    return;
+  }
+
+  spinner.succeed('Template loaded');
+
+  if (result.content) {
+    const processed = processTemplate(result.content, config);
+    fs.writeFileSync(outputPath, processed);
+  }
+
+  utils.print.success(`Created ${template.name}`);
+  console.log(`\nFile: ${utils.COLORS.cyan}${OUTPUT_DIR}/${template.output}${utils.COLORS.reset}`);
+  console.log(`\n${utils.COLORS.bold}Next Steps:${utils.COLORS.reset}`);
+  console.log('  1. Open and edit the document');
+  console.log('  2. Use AI agents for assistance:');
+  console.log(`     ${utils.COLORS.cyan}bootspring agent invoke fundraising-expert${utils.COLORS.reset}`);
+}
+
+/**
+ * Show status of fundraising documents
+ */
+function fundraiseStatus(): void {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Fundraising Materials Status${utils.COLORS.reset}
+`);
+
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+  let found = 0;
+  const total = Object.keys(TEMPLATES).length;
+
+  for (const [key, template] of Object.entries(TEMPLATES)) {
+    const outputPath = path.join(outputDir, template.output);
+    const exists = fs.existsSync(outputPath);
+
+    if (exists) {
+      found++;
+      const stats = fs.statSync(outputPath);
+      const modified = stats.mtime.toISOString().split('T')[0] || '';
+      const size = Math.round(stats.size / 1024);
+
+      console.log(`  ${utils.COLORS.green}✓${utils.COLORS.reset} ${template.name}`);
+      console.log(`    ${utils.COLORS.dim}${OUTPUT_DIR}/${template.output} (${size}KB, modified ${modified})${utils.COLORS.reset}`);
+    } else {
+      console.log(`  ${utils.COLORS.yellow}○${utils.COLORS.reset} ${template.name}`);
+      console.log(`    ${utils.COLORS.dim}Not created - run: bootspring fundraise ${key}${utils.COLORS.reset}`);
+    }
+  }
+
+  console.log();
+  console.log(`${utils.COLORS.bold}Progress:${utils.COLORS.reset} ${found}/${total} documents created`);
+
+  if (found < total) {
+    console.log(`\n${utils.COLORS.bold}Create Missing:${utils.COLORS.reset}`);
+    console.log(`  ${utils.COLORS.cyan}bootspring fundraise init${utils.COLORS.reset} - Create all documents`);
+  }
+}
+
+/**
+ * Show a fundraising document
+ */
+function fundraiseShow(templateKey: string): void {
+  const template = TEMPLATES[templateKey];
+
+  if (!template) {
+    utils.print.error(`Unknown template: ${templateKey}`);
+    console.log(`\nAvailable templates: ${Object.keys(TEMPLATES).join(', ')}`);
+    return;
+  }
+
+  const outputPath = path.join(process.cwd(), OUTPUT_DIR, template.output);
+
+  if (!fs.existsSync(outputPath)) {
+    utils.print.warning(`${template.name} not created yet`);
+    console.log(`\nRun: ${utils.COLORS.cyan}bootspring fundraise ${templateKey}${utils.COLORS.reset}`);
+    return;
+  }
+
+  const content = fs.readFileSync(outputPath, 'utf-8');
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ ${template.name}${utils.COLORS.reset}
+${utils.COLORS.dim}${OUTPUT_DIR}/${template.output}${utils.COLORS.reset}
+`);
+
+  // Show first 50 lines as preview
+  const lines = content.split('\n').slice(0, 50);
+  console.log(lines.join('\n'));
+
+  if (content.split('\n').length > 50) {
+    console.log(`\n${utils.COLORS.dim}... (${content.split('\n').length - 50} more lines)${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}Open the full file to see more${utils.COLORS.reset}`);
+  }
+}
+
+/**
+ * Show help
+ */
+function showHelp(): void {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Fundraise${utils.COLORS.reset}
+${utils.COLORS.dim}Fundraising tools and templates${utils.COLORS.reset}
+
+${utils.COLORS.bold}Usage:${utils.COLORS.reset}
+  bootspring fundraise <command> [options]
+
+${utils.COLORS.bold}Commands:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}init${utils.COLORS.reset}           Initialize all fundraising documents
+  ${utils.COLORS.cyan}pitch${utils.COLORS.reset}          Create pitch deck outline
+  ${utils.COLORS.cyan}dataroom${utils.COLORS.reset}       Create data room checklist
+  ${utils.COLORS.cyan}investors${utils.COLORS.reset}      Create investor research template
+  ${utils.COLORS.cyan}status${utils.COLORS.reset}         Show status of fundraising documents
+  ${utils.COLORS.cyan}show${utils.COLORS.reset} <type>    Preview a fundraising document
+
+${utils.COLORS.bold}Examples:${utils.COLORS.reset}
+  bootspring fundraise init         # Create all fundraising docs
+  bootspring fundraise pitch        # Create pitch deck outline
+  bootspring fundraise dataroom     # Create data room checklist
+  bootspring fundraise investors    # Create investor tracking
+  bootspring fundraise status       # Check progress
+  bootspring fundraise show pitch   # Preview pitch deck
+
+${utils.COLORS.bold}Related Agents:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}fundraising-expert${utils.COLORS.reset}         Pitch decks and investor relations
+  ${utils.COLORS.cyan}investor-relations-expert${utils.COLORS.reset}  Board management and updates
+  ${utils.COLORS.cyan}financial-expert${utils.COLORS.reset}           Financial modeling and projections
+  ${utils.COLORS.cyan}private-equity-expert${utils.COLORS.reset}      Term sheets and negotiations
+`);
+}
+
+/**
+ * Run fundraise command
+ */
+export async function run(args: string[]): Promise<void> {
+  const subcommand = args[0] || 'help';
+
+  switch (subcommand) {
+    case 'init':
+      await fundraiseInit();
+      break;
+
+    case 'pitch':
+    case 'deck':
+      await fundraiseCreate('pitch');
+      break;
+
+    case 'dataroom':
+    case 'data-room':
+      await fundraiseCreate('dataroom');
+      break;
+
+    case 'investors':
+    case 'research':
+      await fundraiseCreate('investors');
+      break;
+
+    case 'status':
+      fundraiseStatus();
+      break;
+
+    case 'show':
+      if (!args[1]) {
+        utils.print.error('Please specify a document type');
+        console.log(`Usage: ${utils.COLORS.cyan}bootspring fundraise show <pitch|dataroom|investors>${utils.COLORS.reset}`);
+        return;
+      }
+      fundraiseShow(args[1]);
+      break;
+
+    case 'help':
+    case '-h':
+    case '--help':
+      showHelp();
+      break;
+
+    default:
+      // Check if it's a template name
+      if (TEMPLATES[subcommand]) {
+        await fundraiseCreate(subcommand);
+      } else {
+        utils.print.error(`Unknown subcommand: ${subcommand}`);
+        showHelp();
+      }
+  }
+}