@girardmedia/bootspring 2.5.0 → 2.5.2

package/generators/templates/agents.template.js

@@ -1,199 +0,0 @@
-/**
- * AGENTS.md Template Generator
- *
- * Generates AGENTS.md following the open standard for AI coding agents.
- * Supported by: OpenAI Codex, Cursor, Amp, Jules (Google), Factory, Kilo Code
- *
- * Best practices from https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/
- *
- * @package bootspring
- * @module generators/templates/agents
- */
-
-/**
- * Generate root AGENTS.md content from config
- */
-function generate(config) {
-  const sections = [];
-
-  // Persona - Be specific, not vague
-  sections.push(`# ${config.project.name}`);
-  sections.push('');
-  sections.push(`You are a senior full-stack developer working on ${config.project.name}, a ${formatFramework(config.stack.framework)} application with ${config.stack.language}.`);
-  sections.push('');
-
-  // Commands - Put early
-  sections.push('## Commands');
-  sections.push('');
-  sections.push('```bash');
-  sections.push('# Development');
-  sections.push('npm run dev');
-  sections.push('');
-  sections.push('# Quality checks (run before committing)');
-  sections.push('npm run lint');
-  sections.push('npm run test');
-  sections.push('npm run typecheck');
-  sections.push('');
-  sections.push('# Build tasks');
-  sections.push('bootspring build next    # Get next task');
-  sections.push('bootspring build task    # Show current in-progress task');
-  sections.push('bootspring build done    # Mark task complete');
-  sections.push('bootspring build status  # Check progress');
-  sections.push('```');
-  sections.push('');
-
-  // Task System
-  sections.push('## Build Loop');
-  sections.push('');
-  sections.push('**Start building:**');
-  sections.push('```');
-  sections.push('bootspring build next');
-  sections.push('```');
-  sections.push('');
-  sections.push('This loops through all tasks:');
-  sections.push('1. Run `bootspring build task` (current task comes from `planning/BUILD_STATE.json`)');
-  sections.push('2. Read that task\'s acceptance criteria in `planning/TODO.md`');
-  sections.push('3. Implement and validate the task');
-  sections.push('4. Run `bootspring build done` (auto-queues next)');
-  sections.push('');
-  sections.push('**Keep looping until MVP complete.**');
-  sections.push('');
-
-  // Stack - Be specific about versions
-  sections.push('## 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('');
-
-  // Code Style
-  sections.push('## Code Style');
-  sections.push('');
-  if (config.stack.framework === 'nextjs') {
-    sections.push('- Use Server Components by default');
-    sections.push('- Use Server Actions for mutations (not API routes)');
-  }
-  sections.push('- Use Zod for input validation');
-  sections.push('- Keep files under 300 lines');
-  sections.push('- Use meaningful variable and function names');
-  sections.push('- Follow existing patterns in the codebase');
-  sections.push('');
-
-  // Git Workflow
-  sections.push('## Git Workflow');
-  sections.push('');
-  sections.push('- Conventional commits: `feat:`, `fix:`, `docs:`, `refactor:`');
-  sections.push('- Atomic commits - one logical change per commit');
-  sections.push('- Run quality checks before committing');
-  sections.push('- Never force push to main');
-  sections.push('- **Never add Co-Authored-By or AI attribution to commits**');
-  sections.push('');
-
-  // Boundaries - Critical
-  sections.push('## Boundaries');
-  sections.push('');
-  sections.push('**Never:**');
-  sections.push('- Commit secrets, API keys, or credentials');
-  sections.push('- Modify `.env` files with real values');
-  sections.push('- Delete or overwrite migration files');
-  sections.push('- Skip tests to make code compile');
-  sections.push('- Introduce breaking changes without discussion');
-  sections.push('');
-  sections.push('**Always:**');
-  sections.push('- Read existing code before modifying');
-  sections.push('- Run tests after changes');
-  sections.push('- Check for TypeScript errors');
-  sections.push('- Follow the acceptance criteria exactly');
-  sections.push('');
-
-  // Testing
-  sections.push('## Testing');
-  sections.push('');
-  sections.push('- Write tests for new features');
-  sections.push('- Ensure existing tests still pass');
-  sections.push('- Test edge cases and error conditions');
-  sections.push('');
-
-  return sections.join('\n');
-}
-
-/**
- * Generate planning-specific AGENTS.md for the planning directory
- */
-function generatePlanningAgents(_config) {
-  const sections = [];
-
-  sections.push('# Planning Directory');
-  sections.push('');
-  sections.push('You are working on build tasks for the MVP. This directory contains build planning files.');
-  sections.push('');
-
-  sections.push('## Current Task');
-  sections.push('');
-  sections.push('Run `bootspring build task` to get the current `in_progress` task from `BUILD_STATE.json`.');
-  sections.push('');
-
-  sections.push('## Commands');
-  sections.push('');
-  sections.push('```bash');
-  sections.push('bootspring build task    # Show current task');
-  sections.push('bootspring build done    # Mark task complete, get next');
-  sections.push('bootspring build skip    # Skip task, get next');
-  sections.push('bootspring build status  # View progress');
-  sections.push('```');
-  sections.push('');
-
-  sections.push('## Files');
-  sections.push('');
-  sections.push('| File | Purpose |');
-  sections.push('|------|---------|');
-  sections.push('| `TODO.md` | **Source of truth** — task checklist with acceptance criteria |');
-  sections.push('| `BUILD_STATE.json` | Build state and current task ID (do not edit) |');
-  sections.push('| `CONTEXT.md` | Build context summary |');
-  sections.push('');
-
-  sections.push('## Workflow');
-  sections.push('');
-  sections.push('1. Run `bootspring build task` to identify the current task ID');
-  sections.push('2. Read the matching task in `TODO.md` for acceptance criteria');
-  sections.push('3. Implement in the main codebase (not here)');
-  sections.push('4. Ensure acceptance criteria are met');
-  sections.push('5. Run `npm run lint && npm run test`');
-  sections.push('6. Commit changes');
-  sections.push('7. Run `bootspring build done`');
-  sections.push('');
-
-  sections.push('## Boundaries');
-  sections.push('');
-  sections.push('- Do NOT edit `BUILD_STATE.json` directly');
-  sections.push('- Do NOT skip quality checks');
-  sections.push('- Do NOT work on multiple tasks at once');
-  sections.push('');
-
-  return sections.join('\n');
-}
-
-// Helper functions
-function formatFramework(framework) {
-  const names = {
-    'nextjs': 'Next.js 14+ (App Router)',
-    'remix': 'Remix',
-    'nuxt': 'Nuxt 3',
-    'sveltekit': 'SvelteKit',
-    'express': 'Express.js',
-    'fastify': 'Fastify',
-    'hono': 'Hono'
-  };
-  return names[framework] || framework;
-}
-
-module.exports = {
-  generate,
-  generatePlanningAgents
-};

package/generators/templates/assistant-context.template.js

@@ -1,83 +0,0 @@
-/**
- * Assistant Context Template Adapter
- *
- * Derives assistant-specific guides (GEMINI.md, CODEX.md)
- * from the generated CLAUDE.md baseline.
- *
- * @package bootspring
- * @module generators/templates/assistant-context
- */
-
-const ASSISTANT_DOC_META = {
-  gemini: {
-    filename: 'GEMINI.md',
-    label: 'Gemini CLI'
-  },
-  codex: {
-    filename: 'CODEX.md',
-    label: 'Codex'
-  }
-};
-
-const ASSISTANT_DOC_TARGETS = ['gemini', 'codex'];
-
-function getAssistantDocFilename(target) {
-  return ASSISTANT_DOC_META[target].filename;
-}
-
-function buildNaturalLanguageRoutingSection(label) {
-  const lines = [];
-  lines.push('## Natural Language Bootspring Routing');
-  lines.push('');
-  lines.push(`Use this section in ${label} to map plain-English requests to Bootspring commands.`);
-  lines.push('');
-  lines.push('- If a user message already starts with `bootspring`, run it exactly as written.');
-  lines.push('- If a user asks in natural language, execute the matching command from the table below.');
-  lines.push('');
-  lines.push('| User request | Run command |');
-  lines.push('|--------------|-------------|');
-  lines.push('| "log in to bootspring" | `bootspring auth login` |');
-  lines.push('| "show auth status" | `bootspring auth status` |');
-  lines.push('| "start build loop" or "next task" | `bootspring build next` |');
-  lines.push('| "what task am I on?" | `bootspring build task` |');
-  lines.push('| "mark this task done" | `bootspring build done` |');
-  lines.push('| "show build progress" | `bootspring build status` |');
-  lines.push('| "refresh context files" | `bootspring generate --full` |');
-  lines.push('');
-  lines.push('When in doubt, prefer direct Bootspring CLI commands over paraphrasing.');
-  return lines.join('\n');
-}
-
-function adaptBaseContent(claudeContent, target) {
-  const meta = ASSISTANT_DOC_META[target];
-  return claudeContent
-    .replace(/\bCLAUDE\.md\b/g, meta.filename)
-    .replace(/Claude Code context/g, `${meta.label} context`)
-    .replace(/Context for Claude Code/g, `Context for ${meta.label}`);
-}
-
-function generateAssistantContext(claudeContent, target) {
-  const meta = ASSISTANT_DOC_META[target];
-  const adaptedContent = adaptBaseContent(claudeContent, target).trimEnd();
-
-  return `${adaptedContent}
-
----
-
-${buildNaturalLanguageRoutingSection(meta.label)}
-`;
-}
-
-function generateAssistantContextFiles(claudeContent) {
-  return {
-    gemini: generateAssistantContext(claudeContent, 'gemini'),
-    codex: generateAssistantContext(claudeContent, 'codex')
-  };
-}
-
-module.exports = {
-  ASSISTANT_DOC_TARGETS,
-  getAssistantDocFilename,
-  generateAssistantContext,
-  generateAssistantContextFiles
-};