@girardmedia/bootspring 2.5.0 → 2.5.2

package/generators/index.ts

@@ -1,82 +0,0 @@
-/**
- * Bootspring Generators Module
- *
- * Provides context generation, scaffolding, and project setup.
- *
- * @package bootspring
- * @module generators
- */
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface GenerateOptions {
-  cwd?: string | undefined;
-  force?: boolean | undefined;
-  verbose?: boolean | undefined;
-}
-
-export interface GenerateResult {
-  success: boolean;
-  files: string[];
-  errors?: string[] | undefined;
-}
-
-export interface MvpAnalysis {
-  sections: Record<string, string>;
-  features: string[];
-  entities: string[];
-  routes: string[];
-  components: string[];
-}
-
-export interface ParsedConfig {
-  project?: {
-    name?: string | undefined;
-    description?: string | undefined;
-    version?: string | undefined;
-  } | undefined;
-  stack?: {
-    framework?: string | undefined;
-    language?: string | undefined;
-    database?: string | undefined;
-  } | undefined;
-  plugins?: Record<string, unknown> | undefined;
-}
-
-export interface ParsedSeed {
-  name?: string | undefined;
-  tagline?: string | undefined;
-  problem?: string | undefined;
-  solution?: string | undefined;
-  features?: string[] | undefined;
-  userTypes?: string[] | undefined;
-  stack?: Record<string, string> | undefined;
-  phases?: Array<{
-    name: string;
-    tasks: string[];
-  }> | undefined;
-}
-
-// ============================================================================
-// Module Import
-// ============================================================================
-
-const generator = require('./generate') as {
-  generate: (options?: GenerateOptions) => GenerateResult;
-  generateClaudeMd: (options?: GenerateOptions) => string;
-  analyzeMvpSource: (content: string) => MvpAnalysis;
-  parseConfig: (configPath: string) => ParsedConfig | null;
-  parseSeedMd: (content: string) => ParsedSeed;
-};
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export const generate = generator.generate;
-export const generateClaudeMd = generator.generateClaudeMd;
-export const analyzeMvpSource = generator.analyzeMvpSource;
-export const parseConfig = generator.parseConfig;
-export const parseSeedMd = generator.parseSeedMd;

package/generators/presets/full.js

@@ -1,28 +0,0 @@
-/**
- * Full Preset
- *
- * Comprehensive setup with all options.
- * Time: 10-15 minutes
- *
- * @package bootspring
- * @module generators/presets/full
- */
-
-module.exports = {
-  name: 'full',
-  description: 'Comprehensive setup - all options',
-  duration: '10-15 minutes',
-  sections: [
-    'pre-build',
-    'identity',
-    'technical',
-    'plugins',
-    'workflow',
-    'instructions',
-    'business',
-    'advanced'
-  ],
-  defaults: {
-    // No defaults - everything is asked
-  }
-};

package/generators/presets/index.js

@@ -1,12 +0,0 @@
-/**
- * Presets Index
- *
- * @package bootspring
- * @module generators/presets
- */
-
-module.exports = {
-  minimal: require('./minimal'),
-  standard: require('./standard'),
-  full: require('./full')
-};

package/generators/presets/minimal.js

@@ -1,29 +0,0 @@
-/**
- * Minimal Preset
- *
- * Quick setup with just the essentials.
- * Time: 2-3 minutes
- *
- * @package bootspring
- * @module generators/presets/minimal
- */
-
-module.exports = {
-  name: 'minimal',
-  description: 'Quick setup - just the essentials',
-  duration: '2-3 minutes',
-  sections: ['pre-build', 'identity', 'technical', 'plugins'],
-  defaults: {
-    // Sensible defaults for skipped sections
-    workflow: {
-      gitStrategy: 'feature-branch',
-      teamSize: 'solo',
-      commitStyle: 'conventional'
-    },
-    instructions: {
-      componentPreferences: ['server-components', 'small-components'],
-      validationPreferences: ['zod', 'strict-ts'],
-      securityRules: ['no-client-keys', 'env-secrets']
-    }
-  }
-};

package/generators/presets/standard.js

@@ -1,28 +0,0 @@
-/**
- * Standard Preset
- *
- * Balanced setup covering most use cases.
- * Time: 5-8 minutes
- *
- * @package bootspring
- * @module generators/presets/standard
- */
-
-module.exports = {
-  name: 'standard',
-  description: 'Balanced setup - recommended for most projects',
-  duration: '5-8 minutes',
-  sections: ['pre-build', 'identity', 'technical', 'plugins', 'workflow', 'instructions'],
-  defaults: {
-    // Defaults for skipped business/advanced sections
-    business: {
-      model: null,
-      pricing: null
-    },
-    advanced: {
-      securityLevel: 'standard',
-      compliance: [],
-      infrastructure: 'managed'
-    }
-  }
-};

package/generators/questionnaire.js

@@ -1,414 +0,0 @@
-/**
- * Bootspring Questionnaire Engine
- *
- * Interactive questionnaire system for project initialization.
- * Provides a guided, conversational experience for scaffolding.
- *
- * @package bootspring
- * @module generators/questionnaire
- */
-
-const readline = require('readline');
-const utils = require('../core/utils');
-
-/**
- * Questionnaire configuration - 17 sections
- */
-const QUESTIONNAIRE_CONFIG = {
-  sections: [
-    'pre-build',      // 1. Pre-Build Assets (MVP, PRD, business docs)
-    'identity',       // 2. Project Identity
-    'business',       // 3. Business Context (model, pricing, market)
-    'technical',      // 4. Technical Framework
-    'frontend',       // 5. Frontend Stack (UI, styling, state)
-    'backend',        // 6. Backend Stack (API, jobs, storage)
-    'auth',           // 7. Authentication
-    'payments',       // 8. Payments & Monetization
-    'ai',             // 9. AI Integration
-    'testing',        // 10. Testing Strategy
-    'deployment',     // 11. DevOps & Deployment
-    'security',       // 12. Security Requirements
-    'features',       // 13. Features & Functionality
-    'content',        // 14. Content & Documentation
-    'workflow',       // 15. Team & Workflow
-    'instructions',   // 16. Custom Instructions
-    'advanced'        // 17. Advanced Options
-  ],
-  presets: {
-    // Quick setup - just the essentials (4 sections)
-    minimal: ['pre-build', 'identity', 'technical', 'features'],
-    // Standard setup - core config (9 sections)
-    standard: ['pre-build', 'identity', 'business', 'technical', 'frontend', 'auth', 'content', 'workflow', 'instructions'],
-    // Full setup - all sections (17 sections)
-    full: [
-      'pre-build', 'identity', 'business', 'technical', 'frontend', 'backend',
-      'auth', 'payments', 'ai', 'testing', 'deployment', 'security',
-      'features', 'content', 'workflow', 'instructions', 'advanced'
-    ],
-    // Startup preset - business-focused (11 sections)
-    startup: [
-      'pre-build', 'identity', 'business', 'technical', 'frontend',
-      'auth', 'payments', 'features', 'content', 'workflow', 'instructions'
-    ],
-    // API preset - backend-focused (9 sections)
-    api: ['pre-build', 'identity', 'technical', 'backend', 'auth', 'testing', 'deployment', 'security', 'content'],
-    // Content preset - content and marketing focused (8 sections)
-    content: ['pre-build', 'identity', 'business', 'technical', 'frontend', 'content', 'workflow', 'instructions']
-  }
-};
-
-/**
- * Create readline interface
- */
-function createInterface() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-
-/**
- * Ask a simple text question
- */
-function askText(rl, question, defaultValue = '') {
-  const prompt = defaultValue
-    ? `${question} ${utils.COLORS.dim}[${defaultValue}]${utils.COLORS.reset}: `
-    : `${question}: `;
-
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      resolve(answer.trim() || defaultValue);
-    });
-  });
-}
-
-/**
- * Ask a single choice question
- */
-function askChoice(rl, question, options, defaultIndex = 0) {
-  return new Promise((resolve) => {
-    console.log(`\n${utils.COLORS.bold}${question}${utils.COLORS.reset}`);
-
-    options.forEach((opt, i) => {
-      const marker = i === defaultIndex
-        ? `${utils.COLORS.cyan}→${utils.COLORS.reset}`
-        : ' ';
-      const label = typeof opt === 'object' ? opt.label : opt;
-      const desc = typeof opt === 'object' && opt.description
-        ? ` ${utils.COLORS.dim}- ${opt.description}${utils.COLORS.reset}`
-        : '';
-      console.log(`  ${marker} ${i + 1}. ${label}${desc}`);
-    });
-
-    rl.question(`\n${utils.COLORS.dim}Select [1-${options.length}]${utils.COLORS.reset}: `, (answer) => {
-      const index = parseInt(answer, 10) - 1;
-      const selectedIndex = (index >= 0 && index < options.length) ? index : defaultIndex;
-      const selected = options[selectedIndex];
-      resolve(typeof selected === 'object' ? selected.value : selected);
-    });
-  });
-}
-
-/**
- * Ask a multi-select question
- */
-function askMultiSelect(rl, question, options, defaults = []) {
-  return new Promise((resolve) => {
-    console.log(`\n${utils.COLORS.bold}${question}${utils.COLORS.reset}`);
-    console.log(`${utils.COLORS.dim}(Enter comma-separated numbers, or 'all' / 'none')${utils.COLORS.reset}`);
-
-    options.forEach((opt, i) => {
-      const isDefault = defaults.includes(typeof opt === 'object' ? opt.value : opt);
-      const marker = isDefault ? `${utils.COLORS.green}✓${utils.COLORS.reset}` : ' ';
-      const label = typeof opt === 'object' ? opt.label : opt;
-      console.log(`  ${marker} ${i + 1}. ${label}`);
-    });
-
-    rl.question(`\n${utils.COLORS.dim}Select${utils.COLORS.reset}: `, (answer) => {
-      const trimmed = answer.trim().toLowerCase();
-
-      if (trimmed === 'all') {
-        resolve(options.map(o => typeof o === 'object' ? o.value : o));
-        return;
-      }
-      if (trimmed === 'none' || trimmed === '') {
-        resolve(defaults);
-        return;
-      }
-
-      const indices = trimmed.split(',').map(s => parseInt(s.trim(), 10) - 1);
-      const selected = indices
-        .filter(i => i >= 0 && i < options.length)
-        .map(i => {
-          const opt = options[i];
-          return typeof opt === 'object' ? opt.value : opt;
-        });
-
-      resolve(selected.length > 0 ? selected : defaults);
-    });
-  });
-}
-
-/**
- * Ask a yes/no question
- */
-function askYesNo(rl, question, defaultYes = true) {
-  const hint = defaultYes
-    ? `${utils.COLORS.dim}[Y/n]${utils.COLORS.reset}`
-    : `${utils.COLORS.dim}[y/N]${utils.COLORS.reset}`;
-
-  return new Promise((resolve) => {
-    rl.question(`${question} ${hint}: `, (answer) => {
-      const a = answer.trim().toLowerCase();
-      if (a === '') {
-        resolve(defaultYes);
-      } else {
-        resolve(a === 'y' || a === 'yes');
-      }
-    });
-  });
-}
-
-/**
- * Display a section header
- */
-function displaySectionHeader(sectionNumber, totalSections, title, description) {
-  console.log('\n');
-  console.log(`${utils.COLORS.cyan}${'─'.repeat(60)}${utils.COLORS.reset}`);
-  console.log(`${utils.COLORS.bold}Section ${sectionNumber}/${totalSections}: ${title}${utils.COLORS.reset}`);
-  if (description) {
-    console.log(`${utils.COLORS.dim}${description}${utils.COLORS.reset}`);
-  }
-  console.log(`${utils.COLORS.cyan}${'─'.repeat(60)}${utils.COLORS.reset}`);
-}
-
-/**
- * Display progress indicator
- */
-function displayProgress(current, total) {
-  const percentage = Math.round((current / total) * 100);
-  const barWidth = 30;
-  const filled = Math.round((current / total) * barWidth);
-  const empty = barWidth - filled;
-
-  const bar = `${utils.COLORS.green}${'█'.repeat(filled)}${utils.COLORS.dim}${'░'.repeat(empty)}${utils.COLORS.reset}`;
-  console.log(`\n${bar} ${percentage}% complete`);
-}
-
-/**
- * Questionnaire class
- */
-class Questionnaire {
-  constructor(preset = 'standard') {
-    this.preset = preset;
-    this.sections = QUESTIONNAIRE_CONFIG.presets[preset] || QUESTIONNAIRE_CONFIG.presets.standard;
-    this.answers = {};
-    this.rl = null;
-  }
-
-  /**
-   * Run the questionnaire
-   */
-  async run() {
-    this.rl = createInterface();
-    this.answers = {};
-
-    console.log(`\n${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Project Setup${utils.COLORS.reset}`);
-    console.log(`${utils.COLORS.dim}Preset: ${this.preset} (${this.sections.length} sections)${utils.COLORS.reset}`);
-
-    try {
-      for (let i = 0; i < this.sections.length; i++) {
-        const sectionName = this.sections[i];
-        const section = require(`./sections/${sectionName}`);
-
-        displaySectionHeader(
-          i + 1,
-          this.sections.length,
-          section.title,
-          section.description
-        );
-
-        // Check skip conditions
-        if (section.shouldSkip && section.shouldSkip(this.answers)) {
-          console.log(`${utils.COLORS.dim}Skipping (based on previous answers)...${utils.COLORS.reset}`);
-          continue;
-        }
-
-        // Run section questions
-        const sectionAnswers = await section.run(this.rl, this.answers, {
-          askText,
-          askChoice,
-          askMultiSelect,
-          askYesNo
-        });
-
-        // Merge answers
-        this.answers = { ...this.answers, ...sectionAnswers };
-
-        displayProgress(i + 1, this.sections.length);
-      }
-
-      this.rl.close();
-
-      console.log(`\n${utils.COLORS.green}${utils.COLORS.bold}✓ Questionnaire complete!${utils.COLORS.reset}\n`);
-
-      return this.answers;
-    } catch (error) {
-      this.rl.close();
-      throw error;
-    }
-  }
-
-  /**
-   * Build configuration from answers
-   */
-  buildConfig() {
-    return {
-      project: {
-        name: this.answers.projectName || 'untitled',
-        description: this.answers.projectDescription || '',
-        version: this.answers.projectVersion || '1.0.0',
-        status: this.answers.projectStatus || 'development',
-        type: this.answers.appType || 'saas',
-        mvpScope: this.answers.mvpScope || 'single',
-        primaryUseCase: this.answers.primaryUseCase || '',
-        targetUsers: this.answers.targetUsers || 'b2c'
-      },
-      stack: {
-        framework: this.answers.framework || 'nextjs',
-        language: this.answers.language || 'typescript',
-        database: this.answers.database || 'postgresql',
-        orm: this.answers.orm || 'prisma',
-        hosting: this.answers.hosting || 'vercel'
-      },
-      frontend: {
-        uiLibrary: this.answers.uiLibrary || 'shadcn',
-        styling: this.answers.styling || 'tailwind',
-        stateManagement: this.answers.stateManagement || 'context',
-        dataFetching: this.answers.dataFetching || 'tanstack',
-        features: this.answers.frontendFeatures || []
-      },
-      backend: {
-        apiStyle: this.answers.apiStyle || 'rest',
-        validation: this.answers.validation || 'zod',
-        caching: this.answers.caching || 'none',
-        backgroundJobs: this.answers.enableBackgroundJobs ? {
-          enabled: true,
-          processor: this.answers.jobProcessor || 'inngest'
-        } : { enabled: false },
-        fileStorage: this.answers.enableFileStorage ? {
-          enabled: true,
-          provider: this.answers.fileStorage || 'uploadthing'
-        } : { enabled: false },
-        email: this.answers.enableEmail ? {
-          enabled: true,
-          provider: this.answers.emailProvider || 'resend'
-        } : { enabled: false }
-      },
-      plugins: {
-        auth: {
-          enabled: this.answers.enableAuth || false,
-          provider: this.answers.authProvider || 'clerk',
-          methods: this.answers.authMethods || ['email'],
-          features: this.answers.authFeatures || []
-        },
-        payments: {
-          enabled: this.answers.enablePayments || false,
-          provider: this.answers.paymentsProvider || 'stripe',
-          types: this.answers.paymentTypes || [],
-          tiers: this.answers.pricingTiers || null,
-          features: this.answers.paymentFeatures || []
-        },
-        database: {
-          enabled: this.answers.database !== 'none',
-          provider: this.answers.orm || 'prisma'
-        },
-        testing: {
-          enabled: this.answers.enableTesting !== false,
-          runner: this.answers.testRunner || 'vitest',
-          types: this.answers.testTypes || ['unit'],
-          e2eFramework: this.answers.e2eFramework || null,
-          componentTesting: this.answers.componentTesting || null,
-          coverageTarget: this.answers.coverageTarget || 'standard',
-          runInCI: this.answers.testInCI !== false
-        },
-        security: {
-          enabled: true,
-          level: this.answers.securityLevel || 'standard',
-          features: this.answers.securityFeatures || [],
-          compliance: this.answers.compliance || [],
-          dataHandling: this.answers.dataHandling || [],
-          scanning: this.answers.enableSecurityScanning ? {
-            enabled: true,
-            scanner: this.answers.securityScanner || 'dependabot'
-          } : { enabled: false }
-        },
-        ai: {
-          enabled: this.answers.enableAI || false,
-          provider: this.answers.aiProvider || 'anthropic',
-          features: this.answers.aiFeatures || [],
-          vectorDb: this.answers.vectorDb || null,
-          streaming: this.answers.aiStreaming !== false,
-          rateLimiting: this.answers.aiRateLimiting !== false
-        }
-      },
-      deployment: {
-        environments: this.answers.environments || 'prod-preview',
-        ciPlatform: this.answers.ciPlatform || 'github',
-        branchStrategy: this.answers.branchStrategy || 'github-flow',
-        pipelineSteps: this.answers.pipelineSteps || ['lint', 'build'],
-        monitoring: this.answers.enableMonitoring ? {
-          enabled: true,
-          provider: this.answers.monitoringProvider || 'sentry'
-        } : { enabled: false },
-        featureFlags: this.answers.enableFeatureFlags ? {
-          enabled: true,
-          provider: this.answers.featureFlagProvider || 'posthog'
-        } : { enabled: false }
-      },
-      features: {
-        core: this.answers.coreFeatures || ['dashboard', 'settings']
-      },
-      workflow: {
-        gitStrategy: this.answers.gitStrategy || 'feature-branch',
-        teamSize: this.answers.teamSize || 'solo',
-        commitStyle: this.answers.commitStyle || 'conventional'
-      },
-      instructions: this.answers.customInstructions || {},
-      business: {
-        model: this.answers.businessModel || null,
-        pricing: this.answers.pricingStrategy || null,
-        targetMarket: this.answers.targetMarket || null
-      },
-      advanced: {
-        security: this.answers.securityLevel || 'standard',
-        compliance: this.answers.compliance || [],
-        infrastructure: this.answers.infrastructure || 'managed'
-      },
-      dashboard: { port: 3456, autoOpen: false },
-      quality: { preCommit: true, prePush: false, strictMode: false },
-      paths: { context: 'CLAUDE.md', config: 'bootspring.config.js', todo: 'todo.md' }
-    };
-  }
-}
-
-/**
- * Run questionnaire with preset
- */
-async function runQuestionnaire(preset = 'standard') {
-  const questionnaire = new Questionnaire(preset);
-  await questionnaire.run();
-  return questionnaire.buildConfig();
-}
-
-module.exports = {
-  Questionnaire,
-  runQuestionnaire,
-  askText,
-  askChoice,
-  askMultiSelect,
-  askYesNo,
-  displaySectionHeader,
-  displayProgress,
-  QUESTIONNAIRE_CONFIG
-};