@girardmedia/bootspring 2.5.0 → 2.5.2

package/generators/templates/claude.template.js

@@ -1,379 +0,0 @@
-/**
- * CLAUDE.md Template Generator
- *
- * Generates a rich CLAUDE.md from questionnaire answers.
- *
- * @package bootspring
- * @module generators/templates/claude
- */
-
-const utils = require('../../core/utils');
-
-/**
- * Generate CLAUDE.md content from config
- */
-function generate(config) {
-  const date = utils.formatDate();
-  const sections = [];
-
-  // Header
-  sections.push(`# ${config.project.name} - AI Context`);
-  sections.push('');
-  sections.push(`**Generated by**: Bootspring v${require('../../package.json').version}`);
-  sections.push(`**Last Updated**: ${date}`);
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // CRITICAL: Planning is the single source of truth
-  sections.push('## IMPORTANT: Planning First');
-  sections.push('');
-  sections.push('**The `/planning` folder is the SINGLE SOURCE OF TRUTH for all implementation.**');
-  sections.push('');
-  sections.push('### Before Writing ANY Code');
-  sections.push('1. Read `planning/MASTER_PLAN.md` - Overall vision and phases');
-  sections.push('2. Run `bootspring build task` - Current task ID comes from `planning/BUILD_STATE.json`');
-  sections.push('3. Read `planning/TODO.md` - Find the task ID and its acceptance criteria');
-  sections.push('4. Read `planning/CONTEXT.md` - Current build context');
-  sections.push('5. Understand the acceptance criteria before implementing');
-  sections.push('');
-  sections.push('### After Completing ANY Task');
-  sections.push('1. Update `planning/TODO.md` - Check off completed items');
-  sections.push('2. Run `bootspring build done` - Updates BUILD_STATE.json automatically');
-  sections.push('3. Document any architectural decisions or deviations');
-  sections.push('');
-  sections.push('**DO NOT skip reading planning docs. DO NOT skip updating them.**');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Planning folder contents
-  sections.push('## Planning Folder (`/planning`)');
-  sections.push('');
-  sections.push('| File | Purpose | When to Read |');
-  sections.push('|------|---------|--------------|');
-  sections.push('| `MASTER_PLAN.md` | Overall vision, phases, success criteria | **Always read first** |');
-  sections.push('| `TODO.md` | **Source of truth** — all tasks with acceptance criteria | **Before each task** |');
-  sections.push('| `CONTEXT.md` | Current build context and decisions | Before each task |');
-  sections.push('| `BUILD_STATE.json` | Machine state - source of current task ID | Reference only |');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Preseed docs - the source material
-  sections.push('## Source Documents (`.bootspring/preseed/`)');
-  sections.push('');
-  sections.push('These are the original specifications the planning was derived from:');
-  sections.push('');
-  sections.push('| File | Contains |');
-  sections.push('|------|----------|');
-  sections.push('| `VISION.md` | Product vision, problem/solution, goals |');
-  sections.push('| `AUDIENCE.md` | Target users, personas, ICP |');
-  sections.push('| `MARKET.md` | Market analysis, TAM/SAM/SOM |');
-  sections.push('| `COMPETITORS.md` | Competitive landscape, differentiation |');
-  sections.push('| `BUSINESS_MODEL.md` | Revenue model, pricing, unit economics |');
-  sections.push('| `PRD.md` | Product requirements, features, user stories |');
-  sections.push('| `TECHNICAL_SPEC.md` | Architecture, stack, data model, APIs |');
-  sections.push('| `ROADMAP.md` | Implementation phases, milestones |');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Project Overview
-  sections.push('## Project Overview');
-  sections.push('');
-  if (config.project.description) {
-    sections.push(config.project.description);
-  } else {
-    sections.push(`${config.project.name} is a ${config.stack.framework} project.`);
-  }
-  sections.push('');
-  sections.push(`**Status**: ${config.project.status || 'development'}`);
-  sections.push(`**Version**: ${config.project.version || '0.1.0'}`);
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Tech Stack
-  sections.push('## Tech Stack');
-  sections.push('');
-  sections.push(`- **Framework**: ${formatFramework(config.stack.framework)}`);
-  sections.push(`- **Language**: ${config.stack.language}`);
-  if (config.stack.database !== 'none') {
-    sections.push(`- **Database**: ${config.stack.database}`);
-    if (config.stack.orm) {
-      sections.push(`- **ORM**: ${config.stack.orm}`);
-    }
-  }
-  sections.push(`- **Hosting**: ${config.stack.hosting}`);
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Enabled Plugins
-  const enabledPlugins = Object.entries(config.plugins || {})
-    .filter(([_, p]) => p.enabled);
-
-  if (enabledPlugins.length > 0) {
-    sections.push('## Enabled Plugins');
-    sections.push('');
-    for (const [name, plugin] of enabledPlugins) {
-      sections.push(`### ${capitalize(name)}`);
-      sections.push(`- **Provider**: ${plugin.provider || 'default'}`);
-      if (plugin.features && plugin.features.length > 0) {
-        sections.push(`- **Features**: ${plugin.features.join(', ')}`);
-      }
-      sections.push('');
-    }
-    sections.push('---');
-    sections.push('');
-  }
-
-  // Custom Instructions
-  if (config.instructions && Object.keys(config.instructions).length > 0) {
-    sections.push('## Development Guidelines');
-    sections.push('');
-
-    if (config.instructions.componentPreferences?.length > 0) {
-      sections.push('### Component Guidelines');
-      for (const pref of config.instructions.componentPreferences) {
-        sections.push(`- ${formatPreference(pref)}`);
-      }
-      sections.push('');
-    }
-
-    if (config.instructions.validationPreferences?.length > 0) {
-      sections.push('### Validation & Types');
-      for (const pref of config.instructions.validationPreferences) {
-        sections.push(`- ${formatPreference(pref)}`);
-      }
-      sections.push('');
-    }
-
-    if (config.instructions.securityRules?.length > 0) {
-      sections.push('### Security Rules');
-      for (const rule of config.instructions.securityRules) {
-        sections.push(`- ${formatPreference(rule)}`);
-      }
-      sections.push('');
-    }
-
-    if (config.instructions.testingRules?.length > 0) {
-      sections.push('### Testing Rules');
-      for (const rule of config.instructions.testingRules) {
-        sections.push(`- ${formatPreference(rule)}`);
-      }
-      sections.push('');
-    }
-
-    if (config.instructions.forbiddenPatterns?.length > 0) {
-      sections.push('### Forbidden Patterns');
-      sections.push('Never use these:');
-      for (const pattern of config.instructions.forbiddenPatterns) {
-        sections.push(`- ${pattern}`);
-      }
-      sections.push('');
-    }
-
-    if (config.instructions.additionalInstructions) {
-      sections.push('### Additional Instructions');
-      sections.push(config.instructions.additionalInstructions);
-      sections.push('');
-    }
-
-    sections.push('---');
-    sections.push('');
-  }
-
-  // Workflow
-  if (config.workflow) {
-    sections.push('## Development Workflow');
-    sections.push('');
-    sections.push(`- **Git Strategy**: ${formatGitStrategy(config.workflow.gitStrategy)}`);
-    sections.push(`- **Team Size**: ${config.workflow.teamSize}`);
-    sections.push(`- **Commit Style**: ${config.workflow.commitStyle}`);
-    sections.push('');
-    sections.push('---');
-    sections.push('');
-  }
-
-  // Business Context (if available)
-  if (config.business && config.business.model) {
-    sections.push('## Business Context');
-    sections.push('');
-    sections.push(`- **Model**: ${config.business.model}`);
-    if (config.business.pricing) {
-      sections.push(`- **Pricing**: ${config.business.pricing}`);
-    }
-    if (config.business.targetMarket) {
-      sections.push(`- **Target Market**: ${config.business.targetMarket}`);
-    }
-    sections.push('');
-    sections.push('---');
-    sections.push('');
-  }
-
-  // Autonomous Build System
-  sections.push('## Build Loop');
-  sections.push('');
-  sections.push('**To start building, run:**');
-  sections.push('');
-  sections.push('```');
-  sections.push('bootspring build next');
-  sections.push('```');
-  sections.push('');
-  sections.push('This starts an autonomous loop:');
-  sections.push('');
-  sections.push('```');
-  sections.push('┌─────────────────────────────────────────────────────────────┐');
-  sections.push('│  bootspring build next                                      │');
-  sections.push('│         ↓                                                   │');
-  sections.push('│  bootspring build task → get in_progress task ID            │');
-  sections.push('│         ↓                                                   │');
-  sections.push('│  Read planning/TODO.md for acceptance criteria               │');
-  sections.push('│         ↓                                                   │');
-  sections.push('│  Implement task (meet acceptance criteria)                  │');
-  sections.push('│         ↓                                                   │');
-  sections.push('│  bootspring build done                                      │');
-  sections.push('│         ↓                                                   │');
-  sections.push('│  [Auto-queues next task] → Continue implementing...         │');
-  sections.push('└─────────────────────────────────────────────────────────────┘');
-  sections.push('```');
-  sections.push('');
-  sections.push('**Keep looping until all tasks are complete.**');
-  sections.push('');
-  sections.push('### Commands');
-  sections.push('');
-  sections.push('| Command | What it does |');
-  sections.push('|---------|--------------|');
-  sections.push('| `bootspring build next` | **Start here** - queue next task |');
-  sections.push('| `bootspring build task` | Show current in-progress task |');
-  sections.push('| `bootspring build done` | Mark complete, auto-queue next |');
-  sections.push('| `bootspring build status` | View progress |');
-  sections.push('| `bootspring build skip` | Skip current task |');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Rules
-  sections.push('## Rules');
-  sections.push('');
-  sections.push('1. **Always read before coding** - No implementation without reading MASTER_PLAN.md and checking `bootspring build task`');
-  sections.push('2. **Follow acceptance criteria exactly** - The task is not done until all criteria are met');
-  sections.push('3. **Update planning docs** - Check off TODO.md items, run `bootspring build done`');
-  sections.push('4. **One task at a time** - Complete current task before starting next');
-  sections.push('5. **Document decisions** - If you deviate from the plan, document why');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Git Commits
-  sections.push('## Git Commits');
-  sections.push('');
-  sections.push('- Use conventional commit format: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`');
-  sections.push('- Write clear, descriptive commit messages');
-  sections.push('- Keep commits atomic (one logical change per commit)');
-  sections.push('- **NEVER add Co-Authored-By or AI attribution to commits**');
-  sections.push('- Never commit secrets, API keys, or credentials');
-  sections.push('- Run quality checks before committing');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Bootspring Slash Commands
-  sections.push('## Bootspring Commands');
-  sections.push('');
-  sections.push('**IMPORTANT: When the user types any of these commands, run them directly as CLI commands.**');
-  sections.push('Do NOT interpret them as natural language requests. Execute the exact command.');
-  sections.push('');
-  sections.push('### Available Commands');
-  sections.push('');
-  sections.push('| Command | Description |');
-  sections.push('|---------|-------------|');
-  sections.push('| `bootspring build` | Run production build for the project |');
-  sections.push('| `bootspring build next` | Queue and start the next build task |');
-  sections.push('| `bootspring build task` | Show current in-progress task |');
-  sections.push('| `bootspring build done` | Mark current task complete |');
-  sections.push('| `bootspring build status` | View build progress |');
-  sections.push('| `bootspring analyze` | Run deep codebase analysis |');
-  sections.push('| `bootspring generate` | Regenerate CLAUDE.md context |');
-  sections.push('| `bootspring plan` | Get planning recommendations |');
-  sections.push('| `bootspring todo` | Manage project todos |');
-  sections.push('| `bootspring skill search <query>` | Search code patterns |');
-  sections.push('| `bootspring auth` | Check authentication status |');
-  sections.push('');
-  sections.push('### Command Recognition');
-  sections.push('');
-  sections.push('When the user says any of these, run the bootspring CLI command:');
-  sections.push('- "bootspring build" → `bootspring build`');
-  sections.push('- "build" or "/build" → `bootspring build`');
-  sections.push('- "analyze" or "/analyze" → `bootspring analyze`');
-  sections.push('- "generate" or "/generate" → `bootspring generate`');
-  sections.push('- "plan" or "/plan" → `bootspring plan`');
-  sections.push('- "todo" or "/todo" → `bootspring todo`');
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-
-  // Footer
-  sections.push('*Generated by [Bootspring](https://bootspring.com) - Development scaffolding with intelligence*');
-
-  return sections.join('\n');
-}
-
-// Helper functions
-function capitalize(str) {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
-
-function formatFramework(framework) {
-  const names = {
-    'nextjs': 'Next.js',
-    'remix': 'Remix',
-    'nuxt': 'Nuxt',
-    'sveltekit': 'SvelteKit',
-    'express': 'Express',
-    'fastify': 'Fastify',
-    'hono': 'Hono'
-  };
-  return names[framework] || framework;
-}
-
-function formatGitStrategy(strategy) {
-  const names = {
-    'feature-branch': 'Feature Branch',
-    'trunk': 'Trunk-Based',
-    'gitflow': 'GitFlow',
-    'github-flow': 'GitHub Flow'
-  };
-  return names[strategy] || strategy;
-}
-
-function formatPreference(pref) {
-  const descriptions = {
-    'server-components': 'Use Server Components by default',
-    'server-actions': 'Use Server Actions for mutations',
-    'small-components': 'Keep components small and focused',
-    'colocate-styles': 'Colocate styles with components',
-    'composition': 'Prefer composition over inheritance',
-    'tailwind': 'Use Tailwind CSS for styling',
-    'css-modules': 'Use CSS Modules',
-    'mobile-first': 'Mobile-first responsive design',
-    'zod': 'Use Zod for all input validation',
-    'strict-ts': 'Strict TypeScript mode',
-    'api-validation': 'Validate at API boundaries',
-    'runtime-types': 'Runtime type checking',
-    'no-client-keys': 'Never expose API keys to client',
-    'env-secrets': 'Use environment variables for secrets',
-    'sanitize-input': 'Sanitize all user input',
-    'parameterized-queries': 'Use parameterized queries',
-    'rate-limiting': 'Implement rate limiting',
-    'test-new-features': 'Write tests for new features',
-    'coverage-80': 'Maintain 80%+ test coverage',
-    'test-edge-cases': 'Test edge cases explicitly',
-    'meaningful-names': 'Use meaningful test names'
-  };
-  return descriptions[pref] || pref;
-}
-
-module.exports = { generate };