@girardmedia/bootspring 2.0.21 → 2.0.22

package/cli/preseed/index.js

@@ -0,0 +1,16 @@
+/**
+ * Preseed Module Index
+ * Re-exports all preseed submodules
+ * @package bootspring
+ */
+
+const interactive = require('./interactive');
+const templates = require('./templates');
+
+module.exports = {
+  interactive,
+  templates,
+  // Re-export commonly used functions at top level
+  ...interactive,
+  ...templates
+};

package/cli/preseed/interactive.js

@@ -0,0 +1,143 @@
+/**
+ * Interactive Helpers
+ * Readline and prompting utilities for preseed wizard
+ * @package bootspring
+ */
+
+const readline = require('readline');
+const utils = require('../../core/utils');
+
+/**
+ * Create readline interface
+ * @returns {readline.Interface}
+ */
+function createInterface() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
+
+/**
+ * Ask a text question
+ * @param {readline.Interface} rl - readline interface
+ * @param {string} question - the question to ask
+ * @param {string} defaultValue - default value if empty
+ * @returns {Promise<string>}
+ */
+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 multi-line text question
+ * @param {readline.Interface} rl - readline interface
+ * @param {string} question - the question to ask
+ * @param {string} hint - hint text
+ * @returns {Promise<string>}
+ */
+function askMultiLine(rl, question, hint = 'Enter text (empty line to finish)') {
+  return new Promise((resolve) => {
+    console.log(`\n${utils.COLORS.bold}${question}${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}${hint}${utils.COLORS.reset}`);
+
+    const lines = [];
+    const onLine = (line) => {
+      if (line.trim() === '') {
+        rl.removeListener('line', onLine);
+        resolve(lines.join('\n'));
+      } else {
+        lines.push(line);
+      }
+    };
+    rl.on('line', onLine);
+  });
+}
+
+/**
+ * Ask a list question (comma-separated)
+ * @param {readline.Interface} rl - readline interface
+ * @param {string} question - the question to ask
+ * @param {string} hint - hint text
+ * @returns {Promise<string[]>}
+ */
+function askList(rl, question, hint = 'Enter comma-separated values') {
+  return new Promise((resolve) => {
+    console.log(`\n${utils.COLORS.bold}${question}${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}${hint}${utils.COLORS.reset}`);
+
+    rl.question('> ', (answer) => {
+      const items = answer
+        .split(',')
+        .map(s => s.trim())
+        .filter(s => s.length > 0);
+      resolve(items);
+    });
+  });
+}
+
+/**
+ * Ask a choice question
+ * @param {readline.Interface} rl - readline interface
+ * @param {string} question - the question to ask
+ * @param {Array} options - array of options (strings or {label, value, description})
+ * @param {number} defaultIndex - default selected index
+ * @returns {Promise<string>}
+ */
+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);
+    });
+  });
+}
+
+/**
+ * Display section header
+ * @param {number} number - current step number
+ * @param {number} total - total steps
+ * @param {string} title - section title
+ * @param {string} description - section description
+ */
+function displaySection(number, total, title, description) {
+  console.log('\n');
+  console.log(`${utils.COLORS.cyan}${'━'.repeat(60)}${utils.COLORS.reset}`);
+  console.log(`${utils.COLORS.bold}Step ${number}/${total}: ${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}`);
+}
+
+module.exports = {
+  createInterface,
+  askText,
+  askMultiLine,
+  askList,
+  askChoice,
+  displaySection
+};

package/cli/preseed/templates.js

@@ -0,0 +1,227 @@
+/**
+ * Document Templates
+ * Template generation for preseed documents
+ * @package bootspring
+ */
+
+/**
+ * Generate a document template
+ * @param {string} docType - Document type (vision, audience, etc.)
+ * @param {string} name - Fallback document name
+ * @returns {string} Template content
+ */
+function generateDocumentTemplate(docType, name) {
+  const date = new Date().toISOString().split('T')[0];
+  const templates = {
+    vision: `# Vision Document
+
+**Generated:** ${date}
+
+## The Problem
+
+*Describe the problem you're solving...*
+
+## Our Solution
+
+*Describe your solution...*
+
+### Key Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+### Unique Value Proposition
+
+*What makes your solution unique?*
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    audience: `# Target Audience
+
+**Generated:** ${date}
+
+## Primary Audience
+
+*Describe your primary audience...*
+
+## Market Segments
+
+1. Segment 1
+2. Segment 2
+
+## User Personas
+
+### Persona 1
+
+**Role:** *Job title*
+**Goals:** *What they want to achieve*
+**Pain Points:** *What frustrates them*
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    market: `# Market Analysis
+
+**Generated:** ${date}
+
+## Market Size
+
+| Metric | Value |
+|--------|-------|
+| TAM | $X billion |
+| SAM | $X million |
+| SOM | $X million |
+
+## Market Trends
+
+- Trend 1
+- Trend 2
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    competitors: `# Competitive Analysis
+
+**Generated:** ${date}
+
+## Direct Competitors
+
+| Company | Strengths | Weaknesses |
+|---------|-----------|------------|
+| Competitor 1 | ... | ... |
+
+## Our Positioning
+
+*How we differentiate...*
+
+## Key Differentiators
+
+1. Differentiator 1
+2. Differentiator 2
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    'business-model': `# Business Model
+
+**Generated:** ${date}
+
+## Model Type
+
+*Subscription / Freemium / Usage-based / etc.*
+
+## Revenue Streams
+
+1. Primary revenue source
+2. Secondary revenue source
+
+## Pricing Strategy
+
+| Tier | Price | Features |
+|------|-------|----------|
+| Free | $0 | Basic |
+| Pro | $X/mo | Advanced |
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    prd: `# Product Requirements Document
+
+**Generated:** ${date}
+**Version:** 1.0
+
+## Product Vision
+
+*What we're building and why...*
+
+## MVP Features
+
+| Feature | Priority | Description |
+|---------|----------|-------------|
+| Feature 1 | P1 | ... |
+| Feature 2 | P1 | ... |
+
+## User Stories
+
+### US-001: User Login
+
+**As a** user
+**I want to** log in to my account
+**So that** I can access my data
+
+**Acceptance Criteria:**
+- [ ] User can enter email/password
+- [ ] System validates credentials
+- [ ] User is redirected to dashboard
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    'technical-spec': `# Technical Specification
+
+**Generated:** ${date}
+
+## Technology Stack
+
+| Component | Technology |
+|-----------|------------|
+| Frontend | ... |
+| Backend | ... |
+| Database | ... |
+
+## Architecture Overview
+
+*High-level architecture description...*
+
+## Third-Party Integrations
+
+- Integration 1
+- Integration 2
+
+---
+*This is a draft. Edit and approve to continue.*
+`,
+    roadmap: `# Product Roadmap
+
+**Generated:** ${date}
+
+## Development Phases
+
+### Phase 1: MVP
+
+**Duration:** X weeks
+
+**Goals:**
+- Launch core features
+- Validate with early users
+
+**Deliverables:**
+- [ ] Core feature 1
+- [ ] Core feature 2
+
+### Phase 2: Growth
+
+**Duration:** X months
+
+**Goals:**
+- Scale user base
+- Add key features
+
+## Key Milestones
+
+| Milestone | Target Date | Status |
+|-----------|-------------|--------|
+| MVP Launch | TBD | Planned |
+| Beta | TBD | Planned |
+
+---
+*This is a draft. Edit and approve to continue.*
+`
+  };
+
+  return templates[docType] || `# ${name}\n\n**Generated:** ${date}\n\n*Add content here...*\n`;
+}
+
+module.exports = { generateDocumentTemplate };

package/cli/seed/builders/ai-context-builder.js

@@ -0,0 +1,85 @@
+/**
+ * AI Context Builder - Generate CLAUDE.md and AGENTS.md
+ * @package bootspring
+ */
+
+const path = require('path');
+const fs = require('fs');
+const utils = require('../../../core/utils');
+const claudeTemplate = require('../../../generators/templates/claude.template');
+const agentsTemplate = require('../../../generators/templates/agents.template');
+
+/**
+ * Generate AI context files (CLAUDE.md and AGENTS.md)
+ * @param {string} projectRoot - Project root path
+ * @param {object} scaffoldConfig - Configuration object
+ * @returns {object} Results of generation
+ */
+function generateAIContextFiles(projectRoot, scaffoldConfig) {
+  const results = { claudeMd: false, agentsMd: false, planningAgentsMd: false };
+
+  // Build a config object suitable for the templates
+  const cfg = {
+    project: {
+      name: scaffoldConfig.project?.name || 'My Project',
+      description: scaffoldConfig.project?.description || '',
+      version: scaffoldConfig.project?.version || '0.1.0',
+      status: 'development'
+    },
+    stack: scaffoldConfig.stack || {
+      framework: 'nextjs',
+      language: 'typescript',
+      database: 'postgresql',
+      hosting: 'vercel'
+    },
+    frontend: scaffoldConfig.frontend || {
+      uiLibrary: 'shadcn',
+      styling: 'tailwind'
+    },
+    backend: scaffoldConfig.backend || {
+      orm: 'prisma',
+      auth: 'clerk'
+    },
+    plugins: scaffoldConfig.plugins || {},
+    instructions: scaffoldConfig.instructions || {},
+    workflow: scaffoldConfig.workflow || {},
+    business: scaffoldConfig.business || {}
+  };
+
+  // Generate CLAUDE.md
+  try {
+    const claudePath = path.join(projectRoot, 'CLAUDE.md');
+    const claudeContent = claudeTemplate.generate(cfg);
+    fs.writeFileSync(claudePath, claudeContent);
+    results.claudeMd = true;
+  } catch (error) {
+    utils.print.debug(`Failed to generate CLAUDE.md: ${error.message}`);
+  }
+
+  // Generate AGENTS.md (root level)
+  try {
+    const agentsPath = path.join(projectRoot, 'AGENTS.md');
+    const agentsContent = agentsTemplate.generate(cfg);
+    fs.writeFileSync(agentsPath, agentsContent);
+    results.agentsMd = true;
+  } catch (error) {
+    utils.print.debug(`Failed to generate AGENTS.md: ${error.message}`);
+  }
+
+  // Generate planning/AGENTS.md if planning folder exists
+  const planningDir = path.join(projectRoot, 'planning');
+  if (fs.existsSync(planningDir)) {
+    try {
+      const planningAgentsPath = path.join(planningDir, 'AGENTS.md');
+      const planningAgentsContent = agentsTemplate.generatePlanningAgents(cfg);
+      fs.writeFileSync(planningAgentsPath, planningAgentsContent);
+      results.planningAgentsMd = true;
+    } catch (error) {
+      utils.print.debug(`Failed to generate planning/AGENTS.md: ${error.message}`);
+    }
+  }
+
+  return results;
+}
+
+module.exports = { generateAIContextFiles };

package/cli/seed/builders/index.js

@@ -0,0 +1,13 @@
+/**
+ * Seed Builders - Re-export all builder functions
+ * @package bootspring
+ */
+
+const { generateSeedFromPreseed, generateEnhancementPrompt } = require('./seed-builder');
+const { generateAIContextFiles } = require('./ai-context-builder');
+
+module.exports = {
+  generateSeedFromPreseed,
+  generateEnhancementPrompt,
+  generateAIContextFiles
+};