@girardmedia/bootspring 1.2.0 → 2.0.3

package/mcp/tools/prd-tool.js

@@ -0,0 +1,579 @@
+/**
+ * MCP PRD tool module
+ * Provides PRD operations via MCP: create, list, show, import, to-tasks, status
+ */
+
+function getToolDefinition() {
+  return {
+    name: 'bootspring_prd',
+    description: 'Manage Product Requirements Documents. Create PRDs, import existing documents, convert to tasks, and track status.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['create', 'list', 'show', 'import', 'to-tasks', 'status', 'analyze'],
+          description: 'Action to perform: create (new PRD), list (show all), show (view specific), import (process input files), to-tasks (convert to todos), status (PRD health), analyze (extract insights)'
+        },
+        name: {
+          type: 'string',
+          description: 'PRD name for create/show actions'
+        },
+        title: {
+          type: 'string',
+          description: 'PRD title for create action'
+        },
+        description: {
+          type: 'string',
+          description: 'PRD description for create action'
+        },
+        features: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Feature list for create action'
+        }
+      },
+      required: ['action']
+    }
+  };
+}
+
+function createHandler({ ingestModule, todoModule, config, format }) {
+  return async (args) => {
+    const { action, name, title, description, features } = args;
+    const cfg = config.load();
+    const projectRoot = cfg._projectRoot;
+
+    try {
+      switch (action) {
+        case 'create':
+          return handleCreate(projectRoot, { name, title, description, features }, format);
+
+        case 'list':
+          return handleList(projectRoot, format);
+
+        case 'show':
+          return handleShow(projectRoot, name, format);
+
+        case 'import':
+          return handleImport(projectRoot, ingestModule, format);
+
+        case 'to-tasks':
+          return handleToTasks(projectRoot, name, todoModule, format);
+
+        case 'status':
+          return handleStatus(projectRoot, format);
+
+        case 'analyze':
+          return handleAnalyze(projectRoot, ingestModule, format);
+
+        default:
+          return format.error(`Unknown action: ${action}`, [
+            'Valid actions: create, list, show, import, to-tasks, status, analyze'
+          ]);
+      }
+    } catch (error) {
+      return format.error(`PRD operation failed: ${error.message}`);
+    }
+  };
+}
+
+function handleCreate(projectRoot, prdData, format) {
+  const fs = require('fs');
+  const path = require('path');
+
+  if (!prdData.name) {
+    return format.error('PRD name required', [
+      'Provide name parameter for the PRD'
+    ]);
+  }
+
+  const prdDir = path.join(projectRoot, '.bootspring', 'generated', 'prd');
+  if (!fs.existsSync(prdDir)) {
+    fs.mkdirSync(prdDir, { recursive: true });
+  }
+
+  const fileName = `${prdData.name.toLowerCase().replace(/\s+/g, '-')}.md`;
+  const filePath = path.join(prdDir, fileName);
+
+  const featureList = (prdData.features || [])
+    .map((f, i) => `${i + 1}. ${f}`)
+    .join('\n');
+
+  const content = `# ${prdData.title || prdData.name}
+
+**Status:** Draft
+**Created:** ${new Date().toISOString().split('T')[0]}
+**Author:** Bootspring
+
+## Overview
+
+${prdData.description || 'Add description here.'}
+
+## Features
+
+${featureList || '1. Feature 1\n2. Feature 2\n3. Feature 3'}
+
+## User Stories
+
+### As a user, I want to...
+
+- [ ] User story 1
+- [ ] User story 2
+- [ ] User story 3
+
+## Requirements
+
+### Must Have
+- Requirement 1
+- Requirement 2
+
+### Should Have
+- Requirement 3
+
+### Nice to Have
+- Requirement 4
+
+## Success Metrics
+
+- Metric 1
+- Metric 2
+
+## Open Questions
+
+1. Question 1?
+2. Question 2?
+
+---
+*Generated by Bootspring PRD System*
+`;
+
+  fs.writeFileSync(filePath, content);
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## PRD Created
+
+**File:** \`.bootspring/generated/prd/${fileName}\`
+
+**Title:** ${prdData.title || prdData.name}
+
+**Features:** ${(prdData.features || []).length || 3}
+
+**Next Steps:**
+1. Edit the PRD to add details
+2. Run \`bootspring_prd\` with action: "to-tasks" to convert to todos
+3. Share with stakeholders for review`
+    }]
+  };
+}
+
+function handleList(projectRoot, _format) {
+  const fs = require('fs');
+  const path = require('path');
+
+  const prdDir = path.join(projectRoot, '.bootspring', 'generated', 'prd');
+  const inputPrdDir = path.join(projectRoot, '.bootspring', 'inputs', 'prd');
+
+  const prds = [];
+
+  // Check generated PRDs
+  if (fs.existsSync(prdDir)) {
+    const files = fs.readdirSync(prdDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const filePath = path.join(prdDir, file);
+      const stats = fs.statSync(filePath);
+      const content = fs.readFileSync(filePath, 'utf-8');
+      const titleMatch = content.match(/^#\s+(.+)/m);
+
+      prds.push({
+        name: file.replace('.md', ''),
+        title: titleMatch ? titleMatch[1] : file,
+        source: 'generated',
+        modified: stats.mtime.toISOString().split('T')[0]
+      });
+    }
+  }
+
+  // Check input PRDs
+  if (fs.existsSync(inputPrdDir)) {
+    const files = fs.readdirSync(inputPrdDir).filter(f =>
+      f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.pdf')
+    );
+    for (const file of files) {
+      const filePath = path.join(inputPrdDir, file);
+      const stats = fs.statSync(filePath);
+
+      prds.push({
+        name: file.replace(/\.(md|txt|pdf)$/, ''),
+        title: file,
+        source: 'input',
+        modified: stats.mtime.toISOString().split('T')[0]
+      });
+    }
+  }
+
+  if (prds.length === 0) {
+    return {
+      content: [{
+        type: 'text',
+        text: `## PRD List
+
+No PRDs found.
+
+**To add PRDs:**
+1. Create new: \`bootspring_prd\` action: "create" name: "my-prd"
+2. Import existing: Drop files in \`.bootspring/inputs/prd/\` then run action: "import"`
+      }]
+    };
+  }
+
+  const prdTable = prds
+    .map(p => `| ${p.name} | ${p.title.slice(0, 40)} | ${p.source} | ${p.modified} |`)
+    .join('\n');
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## PRD List
+
+| Name | Title | Source | Modified |
+|------|-------|--------|----------|
+${prdTable}
+
+**Total:** ${prds.length} PRDs
+
+**Commands:**
+- Show: \`bootspring_prd\` action: "show" name: "prd-name"
+- Convert: \`bootspring_prd\` action: "to-tasks" name: "prd-name"`
+    }]
+  };
+}
+
+function handleShow(projectRoot, name, format) {
+  const fs = require('fs');
+  const path = require('path');
+
+  if (!name) {
+    return format.error('PRD name required', [
+      'Use name parameter to specify which PRD to show'
+    ]);
+  }
+
+  // Try generated first, then input
+  const paths = [
+    path.join(projectRoot, '.bootspring', 'generated', 'prd', `${name}.md`),
+    path.join(projectRoot, '.bootspring', 'inputs', 'prd', `${name}.md`),
+    path.join(projectRoot, '.bootspring', 'inputs', 'prd', name)
+  ];
+
+  let content = null;
+  let foundPath = null;
+
+  for (const p of paths) {
+    if (fs.existsSync(p)) {
+      content = fs.readFileSync(p, 'utf-8');
+      foundPath = p;
+      break;
+    }
+  }
+
+  if (!content) {
+    return format.error(`PRD not found: ${name}`, [
+      'Use action: "list" to see available PRDs'
+    ]);
+  }
+
+  // Extract key sections
+  const titleMatch = content.match(/^#\s+(.+)/m);
+  const statusMatch = content.match(/\*\*Status:\*\*\s*(.+)/i);
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## ${titleMatch ? titleMatch[1] : name}
+
+**Source:** ${foundPath.includes('generated') ? 'Generated' : 'Input'}
+**Status:** ${statusMatch ? statusMatch[1] : 'Unknown'}
+
+---
+
+${content.slice(0, 4000)}${content.length > 4000 ? '\n\n... (truncated)' : ''}`
+    }]
+  };
+}
+
+async function handleImport(projectRoot, ingestModule, format) {
+  const ingested = await ingestModule.ingestPRD(projectRoot);
+
+  if (!ingested || ingested.length === 0) {
+    return format.warning(
+      'No PRD files found in .bootspring/inputs/prd/',
+      ['Drop your PRD files there and run again']
+    );
+  }
+
+  const imported = [];
+  for (const prd of ingested) {
+    imported.push({
+      file: prd.file,
+      userStories: prd.userStories?.length || 0,
+      features: prd.features?.length || 0,
+      requirements: (prd.requirements?.mustHave?.length || 0) +
+                   (prd.requirements?.shouldHave?.length || 0) +
+                   (prd.requirements?.niceToHave?.length || 0)
+    });
+  }
+
+  const importTable = imported
+    .map(p => `| ${p.file} | ${p.userStories} | ${p.features} | ${p.requirements} |`)
+    .join('\n');
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## PRD Import Complete
+
+| File | User Stories | Features | Requirements |
+|------|--------------|----------|--------------|
+${importTable}
+
+**Total Imported:** ${imported.length} files
+
+**Extracted:**
+- User Stories: ${imported.reduce((a, p) => a + p.userStories, 0)}
+- Features: ${imported.reduce((a, p) => a + p.features, 0)}
+- Requirements: ${imported.reduce((a, p) => a + p.requirements, 0)}
+
+**Next Steps:**
+1. Run \`bootspring_prd\` action: "analyze" for insights
+2. Run \`bootspring_prd\` action: "to-tasks" to create todos`
+    }]
+  };
+}
+
+async function handleToTasks(projectRoot, name, todoModule, format) {
+  const fs = require('fs');
+  const path = require('path');
+
+  // Find the PRD
+  const paths = [
+    path.join(projectRoot, '.bootspring', 'generated', 'prd', `${name || ''}.md`),
+    path.join(projectRoot, '.bootspring', 'inputs', 'prd', `${name || ''}.md`)
+  ];
+
+  let content = null;
+  for (const p of paths) {
+    if (name && fs.existsSync(p)) {
+      content = fs.readFileSync(p, 'utf-8');
+      break;
+    }
+  }
+
+  if (!content && name) {
+    return format.error(`PRD not found: ${name}`, [
+      'Use action: "list" to see available PRDs'
+    ]);
+  }
+
+  // Extract user stories and requirements
+  const tasks = [];
+
+  // Extract user stories (lines starting with - [ ] or numbered items)
+  const storyMatches = content?.matchAll(/(?:^|\n)\s*(?:-\s*\[[ x]\]|\d+\.)\s*(.+)/gi) || [];
+  for (const match of storyMatches) {
+    const text = match[1].trim();
+    if (text.length > 10 && !text.startsWith('#')) {
+      tasks.push({
+        text: text.slice(0, 100),
+        type: 'story'
+      });
+    }
+  }
+
+  // Extract requirements (lines starting with -)
+  const reqMatches = content?.matchAll(/(?:^|\n)\s*-\s+(?![[\d])(.+)/gi) || [];
+  for (const match of reqMatches) {
+    const text = match[1].trim();
+    if (text.length > 10 && !text.startsWith('[') && !text.startsWith('#')) {
+      tasks.push({
+        text: text.slice(0, 100),
+        type: 'requirement'
+      });
+    }
+  }
+
+  if (tasks.length === 0) {
+    return format.warning(
+      'No actionable items found in PRD',
+      ['Add user stories or requirements in standard format']
+    );
+  }
+
+  // Add tasks to todo
+  let added = 0;
+  for (const task of tasks.slice(0, 20)) {
+    try {
+      todoModule.add({ text: `[PRD] ${task.text}`, priority: 2 });
+      added++;
+    } catch {
+      // Skip if todo fails
+    }
+  }
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## Tasks Created from PRD
+
+**Source:** ${name || 'All PRDs'}
+**Tasks Found:** ${tasks.length}
+**Tasks Added:** ${added}
+
+**Sample Tasks:**
+${tasks.slice(0, 10).map(t => `- [${t.type}] ${t.text}`).join('\n')}
+${tasks.length > 10 ? `\n... and ${tasks.length - 10} more` : ''}
+
+**Next Steps:**
+1. Run \`bootspring_todo\` action: "list" to see all tasks
+2. Prioritize and assign tasks`
+    }]
+  };
+}
+
+async function handleStatus(projectRoot, _format) {
+  const fs = require('fs');
+  const path = require('path');
+
+  const prdDir = path.join(projectRoot, '.bootspring', 'generated', 'prd');
+  const inputPrdDir = path.join(projectRoot, '.bootspring', 'inputs', 'prd');
+
+  const stats = {
+    generated: 0,
+    input: 0,
+    draft: 0,
+    approved: 0,
+    totalFeatures: 0,
+    totalStories: 0
+  };
+
+  // Count generated PRDs
+  if (fs.existsSync(prdDir)) {
+    const files = fs.readdirSync(prdDir).filter(f => f.endsWith('.md'));
+    stats.generated = files.length;
+
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(prdDir, file), 'utf-8');
+      if (content.includes('Status:** Draft')) stats.draft++;
+      if (content.includes('Status:** Approved')) stats.approved++;
+
+      // Count features (numbered items in Features section)
+      const featureSection = content.match(/## Features[\s\S]*?(?=##|$)/i);
+      if (featureSection) {
+        const featureCount = (featureSection[0].match(/^\d+\./gm) || []).length;
+        stats.totalFeatures += featureCount;
+      }
+
+      // Count user stories
+      const storyCount = (content.match(/-\s*\[[ x]\]/g) || []).length;
+      stats.totalStories += storyCount;
+    }
+  }
+
+  // Count input PRDs
+  if (fs.existsSync(inputPrdDir)) {
+    const files = fs.readdirSync(inputPrdDir).filter(f =>
+      f.endsWith('.md') || f.endsWith('.txt')
+    );
+    stats.input = files.length;
+  }
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## PRD Status
+
+| Metric | Count |
+|--------|-------|
+| Generated PRDs | ${stats.generated} |
+| Input PRDs | ${stats.input} |
+| Draft Status | ${stats.draft} |
+| Approved Status | ${stats.approved} |
+| Total Features | ${stats.totalFeatures} |
+| Total User Stories | ${stats.totalStories} |
+
+**Health:** ${stats.generated > 0 ? '✓ PRDs exist' : '○ No PRDs yet'}
+
+**Commands:**
+- Create: \`bootspring_prd\` action: "create" name: "feature-x"
+- Import: \`bootspring_prd\` action: "import"
+- Analyze: \`bootspring_prd\` action: "analyze"`
+    }]
+  };
+}
+
+async function handleAnalyze(projectRoot, ingestModule, format) {
+  const ingested = await ingestModule.ingestPRD(projectRoot);
+
+  if (!ingested || ingested.length === 0) {
+    return format.warning(
+      'No PRDs to analyze',
+      ['Create or import PRDs first']
+    );
+  }
+
+  // Aggregate analysis
+  const allStories = [];
+  const allFeatures = [];
+  const allQuestions = [];
+  const requirements = {
+    mustHave: [],
+    shouldHave: [],
+    niceToHave: []
+  };
+
+  for (const prd of ingested) {
+    if (prd.userStories) allStories.push(...prd.userStories);
+    if (prd.features) allFeatures.push(...prd.features);
+    if (prd.openQuestions) allQuestions.push(...prd.openQuestions);
+    if (prd.requirements) {
+      if (prd.requirements.mustHave) requirements.mustHave.push(...prd.requirements.mustHave);
+      if (prd.requirements.shouldHave) requirements.shouldHave.push(...prd.requirements.shouldHave);
+      if (prd.requirements.niceToHave) requirements.niceToHave.push(...prd.requirements.niceToHave);
+    }
+  }
+
+  return {
+    content: [{
+      type: 'text',
+      text: `## PRD Analysis
+
+**Documents Analyzed:** ${ingested.length}
+
+### User Stories (${allStories.length})
+${allStories.slice(0, 5).map(s => `- As a ${s.role}, I want ${s.action.slice(0, 50)}...`).join('\n')}
+${allStories.length > 5 ? `\n... and ${allStories.length - 5} more` : ''}
+
+### Features (${allFeatures.length})
+${allFeatures.slice(0, 5).map(f => `- ${f.slice(0, 60)}`).join('\n')}
+${allFeatures.length > 5 ? `\n... and ${allFeatures.length - 5} more` : ''}
+
+### Requirements
+- **Must Have:** ${requirements.mustHave.length}
+- **Should Have:** ${requirements.shouldHave.length}
+- **Nice to Have:** ${requirements.niceToHave.length}
+
+### Open Questions (${allQuestions.length})
+${allQuestions.slice(0, 3).map(q => `- ${q.slice(0, 60)}...`).join('\n')}
+${allQuestions.length > 3 ? `\n... and ${allQuestions.length - 3} more` : ''}
+
+**Completeness Score:** ${Math.round((allStories.length > 0 ? 25 : 0) + (allFeatures.length > 0 ? 25 : 0) + (requirements.mustHave.length > 0 ? 25 : 0) + (allQuestions.length < 5 ? 25 : 10))}%`
+    }]
+  };
+}
+
+module.exports = {
+  getToolDefinition,
+  createHandler
+};