@girardmedia/bootspring 2.0.21 → 2.0.23

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/preseed.js

@@ -30,7 +30,6 @@
 
 const path = require('path');
 const fs = require('fs');
-const readline = require('readline');
 const config = require('../core/config');
 const utils = require('../core/utils');
 const { PreseedEngine, PRESETS, DOCUMENT_TYPES } = require('../core/preseed');
@@ -46,30 +45,15 @@ const session = require('../core/session');
 const preseedStart = require('./preseed-start');
 const tierEnforcement = require('../core/tier-enforcement');
 
-/**
- * Create readline interface
- */
-function createInterface() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-
-/**
- * Ask a 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);
-    });
-  });
-}
+// Import from extracted modules
+const {
+  createInterface,
+  askText,
+  askList,
+  askChoice,
+  displaySection
+} = require('./preseed/interactive');
+const { generateDocumentTemplate } = require('./preseed/templates');
 
 /**
  * Ask a multi-line text question
@@ -96,64 +80,6 @@ function _askMultiLine(rl, question, hint = 'Enter text (empty line to finish)')
   });
 }
 
-/**
- * Ask a list question (comma-separated)
- */
-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
- */
-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
- */
-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}`);
-}
-
 /**
  * Run the preseed wizard
  */
@@ -1705,224 +1631,6 @@ async function runWorkflowLoop(workflow) {
     }
   }
 }
-
-/**
- * Generate a document template
- */
-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`;
-}
-
 /**
  * Format quality score with color
  */

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
+};