specweave 0.13.6 → 0.15.0

package/dist/plugins/specweave-jira/lib/setup-wizard.js

@@ -0,0 +1,219 @@
+/**
+ * Smart Jira Setup Wizard
+ *
+ * Intelligent credential detection and setup flow:
+ * 1. Check .env for credentials (uses credentialsManager)
+ * 2. Interactive prompt only if missing
+ * 3. Never ask twice for same credentials
+ */
+import inquirer from 'inquirer';
+import { credentialsManager } from '../../../src/core/credentials-manager.js';
+// ============================================================================
+// Credential Detection
+// ============================================================================
+/**
+ * Smart credential detection - uses existing credentialsManager
+ */
+export async function detectJiraCredentials() {
+    if (credentialsManager.hasJiraCredentials()) {
+        try {
+            const credentials = credentialsManager.getJiraCredentials();
+            console.log('✅ Found Jira credentials in .env');
+            return {
+                found: true,
+                credentials,
+                source: 'env',
+            };
+        }
+        catch (error) {
+            // Credentials exist but invalid format
+            return { found: false };
+        }
+    }
+    return { found: false };
+}
+// ============================================================================
+// Interactive Setup
+// ============================================================================
+/**
+ * Interactive Jira credential setup
+ * Only runs if credentials not found
+ */
+export async function setupJiraCredentials() {
+    console.log('\n🔧 Jira Setup Wizard\n');
+    // Check for existing credentials first
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        // Ask user if they want to use existing or re-enter
+        const { useExisting } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useExisting',
+                message: `Found credentials in ${detected.source}. Use these credentials?`,
+                default: true,
+            },
+        ]);
+        if (useExisting) {
+            return detected.credentials;
+        }
+        console.log('\n📝 Enter new credentials:\n');
+    }
+    else {
+        console.log('⚠️  No Jira credentials found\n');
+        console.log('📝 Let\'s set up your Jira connection:\n');
+    }
+    // Interactive credential entry
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'setupType',
+            message: 'How would you like to connect to Jira?',
+            choices: [
+                {
+                    name: 'Cloud (*.atlassian.net)',
+                    value: 'cloud',
+                },
+                {
+                    name: 'Server/Data Center (self-hosted)',
+                    value: 'server',
+                },
+            ],
+        },
+        {
+            type: 'input',
+            name: 'domain',
+            message: (answers) => answers.setupType === 'cloud'
+                ? 'Jira domain (e.g., mycompany.atlassian.net):'
+                : 'Jira server URL (e.g., jira.mycompany.com):',
+            validate: (value) => {
+                if (!value)
+                    return 'Domain is required';
+                if (answers.setupType === 'cloud' && !value.includes('.atlassian.net')) {
+                    return 'Cloud domain must end with .atlassian.net';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Email address:',
+            validate: (value) => {
+                if (!value)
+                    return 'Email is required';
+                if (!value.includes('@'))
+                    return 'Must be a valid email';
+                return true;
+            },
+        },
+        {
+            type: 'password',
+            name: 'apiToken',
+            message: 'API token:',
+            mask: '*',
+            validate: (value) => {
+                if (!value)
+                    return 'API token is required';
+                if (value.length < 10)
+                    return 'API token seems too short';
+                return true;
+            },
+        },
+    ]);
+    const credentials = {
+        domain: answers.domain,
+        email: answers.email,
+        apiToken: answers.apiToken,
+    };
+    // Test connection
+    console.log('\n🔍 Testing connection...');
+    const isValid = await testJiraConnection(credentials);
+    if (!isValid) {
+        console.log('❌ Failed to connect to Jira');
+        console.log('💡 Please check your credentials and try again\n');
+        const { retry } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'retry',
+                message: 'Would you like to try again?',
+                default: true,
+            },
+        ]);
+        if (retry) {
+            return setupJiraCredentials();
+        }
+        throw new Error('Jira connection failed');
+    }
+    console.log('✅ Connection successful!\n');
+    // Save to .env using credentialsManager
+    await saveCredentialsToEnv(credentials);
+    return credentials;
+}
+/**
+ * Test Jira connection with credentials
+ */
+async function testJiraConnection(credentials) {
+    try {
+        const https = await import('https');
+        const auth = Buffer.from(`${credentials.email}:${credentials.apiToken}`).toString('base64');
+        return new Promise((resolve) => {
+            const req = https.request({
+                hostname: credentials.domain,
+                path: '/rest/api/3/myself',
+                method: 'GET',
+                headers: {
+                    Authorization: `Basic ${auth}`,
+                    'Content-Type': 'application/json',
+                },
+            }, (res) => {
+                resolve(res.statusCode === 200);
+            });
+            req.on('error', () => resolve(false));
+            req.setTimeout(5000, () => {
+                req.destroy();
+                resolve(false);
+            });
+            req.end();
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Save credentials to .env using credentialsManager
+ */
+async function saveCredentialsToEnv(credentials) {
+    console.log('💡 Save credentials to .env for future use\n');
+    const { saveToEnv } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'saveToEnv',
+            message: 'Save credentials to .env file?',
+            default: true,
+        },
+    ]);
+    if (saveToEnv) {
+        credentialsManager.saveToEnvFile({ jira: credentials });
+        console.log('✅ Credentials saved to .env');
+        console.log('✅ .env added to .gitignore');
+    }
+    else {
+        console.log('⚠️  Credentials not saved. You\'ll need to enter them again next time.');
+    }
+}
+// ============================================================================
+// Export Helpers
+// ============================================================================
+/**
+ * Get Jira credentials - smart detection with fallback to interactive setup
+ */
+export async function getJiraCredentials() {
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        return detected.credentials;
+    }
+    // Not found - run interactive setup
+    return setupJiraCredentials();
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/plugins/specweave-jira/lib/setup-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/setup-wizard.ts"],"names":[],"mappings":"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"}

package/dist/project-mapper.js

@@ -0,0 +1,272 @@
+/**
+ * Project Mapper - Intelligent User Story to Project Classification
+ *
+ * Analyzes user story content, tech stack mentions, and component architecture
+ * to intelligently map user stories to the correct projects (FE, BE, MOBILE, etc.)
+ *
+ * @module project-mapper
+ */
+/**
+ * Default project mapping rules
+ * These can be customized via .specweave/config.json
+ */
+export const DEFAULT_PROJECT_RULES = [
+    {
+        id: 'FE',
+        name: 'Frontend (Web)',
+        keywords: [
+            'ui', 'ux', 'web', 'browser', 'chart', 'graph', 'visualization',
+            'dashboard', 'button', 'form', 'input', 'page', 'view', 'screen',
+            'modal', 'dropdown', 'navigation', 'menu', 'search', 'filter',
+            'responsive', 'desktop', 'tablet', 'css', 'styling', 'theme',
+            'dark mode', 'light mode', 'component', 'state management'
+        ],
+        techStack: [
+            'react', 'vue', 'angular', 'next.js', 'gatsby', 'svelte',
+            'typescript', 'javascript', 'html', 'css', 'scss', 'tailwind',
+            'mui', 'material-ui', 'antd', 'chakra', 'redux', 'zustand',
+            'recharts', 'd3', 'chart.js', 'plotly'
+        ],
+        componentTypes: [
+            'component', 'hook', 'context', 'provider', 'hoc', 'page',
+            'layout', 'template', 'widget'
+        ]
+    },
+    {
+        id: 'BE',
+        name: 'Backend (API)',
+        keywords: [
+            'api', 'endpoint', 'rest', 'graphql', 'database', 'query',
+            'migration', 'schema', 'model', 'service', 'controller',
+            'authentication', 'authorization', 'jwt', 'session', 'token',
+            'validation', 'sanitization', 'rate limiting', 'caching',
+            'redis', 'queue', 'job', 'worker', 'webhook', 'integration',
+            'third-party', 'external api', 'data processing', 'batch',
+            'cron', 'scheduler', 'background'
+        ],
+        techStack: [
+            'node.js', 'express', 'fastify', 'nestjs', 'koa',
+            'python', 'fastapi', 'django', 'flask',
+            'java', 'spring boot',
+            '.net', 'asp.net',
+            'go', 'gin',
+            'rust', 'actix',
+            'postgresql', 'mysql', 'mongodb', 'redis',
+            'prisma', 'typeorm', 'sequelize', 'sqlalchemy'
+        ],
+        componentTypes: [
+            'controller', 'service', 'repository', 'middleware',
+            'route', 'handler', 'util', 'helper', 'validator'
+        ]
+    },
+    {
+        id: 'MOBILE',
+        name: 'Mobile (iOS/Android)',
+        keywords: [
+            'mobile', 'ios', 'android', 'app', 'native', 'cross-platform',
+            'push notification', 'offline', 'sync', 'device', 'camera',
+            'gps', 'location', 'gesture', 'touch', 'swipe', 'navigation',
+            'tab bar', 'bottom sheet', 'drawer', 'stack', 'screen transition',
+            'deep linking', 'universal link', 'app store', 'play store'
+        ],
+        techStack: [
+            'react native', 'expo', 'flutter', 'swift', 'swiftui',
+            'kotlin', 'jetpack compose', 'xamarin', 'cordova', 'ionic',
+            'react-navigation', 'react-native-reanimated', 'asyncstorage'
+        ],
+        componentTypes: [
+            'screen', 'navigator', 'modal', 'bottom-sheet', 'drawer'
+        ],
+        excludeKeywords: ['web']
+    },
+    {
+        id: 'INFRA',
+        name: 'Infrastructure',
+        keywords: [
+            'deployment', 'ci/cd', 'docker', 'kubernetes', 'helm',
+            'terraform', 'cloudformation', 'infrastructure', 'devops',
+            'monitoring', 'logging', 'metrics', 'alerting', 'slo', 'sli',
+            'scalability', 'load balancing', 'cdn', 'dns', 'ssl', 'tls',
+            'security', 'firewall', 'vpc', 'network', 'backup', 'disaster recovery'
+        ],
+        techStack: [
+            'aws', 'azure', 'gcp', 'kubernetes', 'docker', 'terraform',
+            'ansible', 'jenkins', 'github actions', 'gitlab ci', 'circleci',
+            'prometheus', 'grafana', 'datadog', 'new relic', 'sentry'
+        ],
+        componentTypes: [
+            'pipeline', 'manifest', 'helm chart', 'terraform module'
+        ]
+    }
+];
+/**
+ * Analyze user story content and map to projects
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules (defaults to DEFAULT_PROJECT_RULES)
+ * @returns Array of project mappings sorted by confidence (highest first)
+ */
+export function mapUserStoryToProjects(userStory, projectRules = DEFAULT_PROJECT_RULES) {
+    const mappings = [];
+    // Combine all user story text for analysis
+    const fullText = [
+        userStory.title,
+        userStory.description,
+        ...userStory.acceptanceCriteria,
+        userStory.technicalContext || ''
+    ].join(' ').toLowerCase();
+    for (const rule of projectRules) {
+        const reasoning = [];
+        let score = 0;
+        let maxScore = 0;
+        // Keyword matching (40% weight)
+        const keywordMatches = rule.keywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
+        const keywordScore = keywordMatches.length * 0.4;
+        score += keywordScore;
+        maxScore += rule.keywords.length * 0.4;
+        if (keywordMatches.length > 0) {
+            reasoning.push(`Keywords: ${keywordMatches.slice(0, 5).join(', ')}`);
+        }
+        // Tech stack matching (40% weight)
+        const techStackMatches = rule.techStack.filter(tech => fullText.includes(tech.toLowerCase()));
+        const techScore = techStackMatches.length * 0.4;
+        score += techScore;
+        maxScore += rule.techStack.length * 0.4;
+        if (techStackMatches.length > 0) {
+            reasoning.push(`Tech stack: ${techStackMatches.slice(0, 5).join(', ')}`);
+        }
+        // Component type matching (20% weight)
+        const componentMatches = rule.componentTypes.filter(component => fullText.includes(component.toLowerCase()));
+        const componentScore = componentMatches.length * 0.2;
+        score += componentScore;
+        maxScore += rule.componentTypes.length * 0.2;
+        if (componentMatches.length > 0) {
+            reasoning.push(`Components: ${componentMatches.slice(0, 3).join(', ')}`);
+        }
+        // Exclude keywords (penalty)
+        if (rule.excludeKeywords) {
+            const excludeMatches = rule.excludeKeywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
+            if (excludeMatches.length > 0) {
+                score *= 0.5; // 50% penalty
+                reasoning.push(`Penalty: ${excludeMatches.join(', ')} (not primary focus)`);
+            }
+        }
+        // Normalize confidence (0.0-1.0)
+        const confidence = maxScore > 0 ? Math.min(score / (maxScore * 0.3), 1.0) : 0;
+        // Only include mappings with confidence > 0.1
+        if (confidence > 0.1) {
+            mappings.push({
+                projectId: rule.id,
+                confidence,
+                reasoning
+            });
+        }
+    }
+    // Sort by confidence (highest first)
+    mappings.sort((a, b) => b.confidence - a.confidence);
+    return mappings;
+}
+/**
+ * Determine primary project for a user story
+ * (highest confidence mapping)
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules
+ * @returns Primary project mapping or null if no confident match
+ */
+export function getPrimaryProject(userStory, projectRules = DEFAULT_PROJECT_RULES) {
+    const mappings = mapUserStoryToProjects(userStory, projectRules);
+    // Require at least 30% confidence for primary project
+    return mappings.length > 0 && mappings[0].confidence >= 0.3
+        ? mappings[0]
+        : null;
+}
+/**
+ * Split spec into project-specific specs based on user story mappings
+ *
+ * @param userStories Array of user stories
+ * @param projectRules Project mapping rules
+ * @returns Map of projectId → user stories
+ */
+export function splitSpecByProject(userStories, projectRules = DEFAULT_PROJECT_RULES) {
+    const projectSpecs = new Map();
+    for (const userStory of userStories) {
+        const primaryProject = getPrimaryProject(userStory, projectRules);
+        if (primaryProject) {
+            const existing = projectSpecs.get(primaryProject.projectId) || [];
+            existing.push(userStory);
+            projectSpecs.set(primaryProject.projectId, existing);
+        }
+        else {
+            // No confident match - assign to "SHARED" or primary project
+            const shared = projectSpecs.get('SHARED') || [];
+            shared.push(userStory);
+            projectSpecs.set('SHARED', shared);
+        }
+    }
+    return projectSpecs;
+}
+/**
+ * Suggest JIRA item type hierarchy based on user story scope
+ *
+ * @param userStory User story to analyze
+ * @returns Suggested JIRA item type (Epic, Story, Task, Subtask)
+ */
+export function suggestJiraItemType(userStory) {
+    const storyPoints = estimateStoryPoints(userStory);
+    // Epic: > 13 story points (large feature area)
+    if (storyPoints > 13) {
+        return 'Epic';
+    }
+    // Story: 3-13 story points (standard user story)
+    if (storyPoints >= 3) {
+        return 'Story';
+    }
+    // Task: 1-2 story points (small implementation task)
+    if (storyPoints >= 1) {
+        return 'Task';
+    }
+    // Subtask: < 1 story point (granular work)
+    return 'Subtask';
+}
+/**
+ * Estimate story points based on acceptance criteria count and complexity
+ *
+ * @param userStory User story to estimate
+ * @returns Estimated story points (1-21)
+ */
+function estimateStoryPoints(userStory) {
+    const acCount = userStory.acceptanceCriteria.length;
+    // Simple heuristic: 1 AC ≈ 1 story point, max 21
+    return Math.min(acCount, 21);
+}
+/**
+ * Format project mapping report (for display to user)
+ *
+ * @param userStory User story
+ * @param mappings Project mappings
+ * @returns Formatted markdown report
+ */
+export function formatProjectMappingReport(userStory, mappings) {
+    const lines = [];
+    lines.push(`## ${userStory.id}: ${userStory.title}`);
+    lines.push('');
+    if (mappings.length === 0) {
+        lines.push('❌ **No project match** (assign to SHARED)');
+        return lines.join('\n');
+    }
+    lines.push(`✅ **Primary Project**: ${mappings[0].projectId} (${(mappings[0].confidence * 100).toFixed(0)}% confidence)`);
+    lines.push('');
+    lines.push('**Reasoning**:');
+    for (const reason of mappings[0].reasoning) {
+        lines.push(`- ${reason}`);
+    }
+    if (mappings.length > 1) {
+        lines.push('');
+        lines.push('**Secondary Matches**:');
+        for (const mapping of mappings.slice(1, 3)) {
+            lines.push(`- ${mapping.projectId} (${(mapping.confidence * 100).toFixed(0)}%)`);
+        }
+    }
+    return lines.join('\n');
+}

package/dist/scripts/split-spec-by-project.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+/**
+ * Split Monolithic Spec into Project-Specific Files
+ *
+ * Usage: node dist/scripts/split-spec-by-project.js <spec-path> <output-dir>
+ */
+
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import {
+  parseSpecFile,
+  splitSpecIntoProjects,
+  createMultiProjectFolderStructure
+} from '../utils/spec-splitter.js';
+import {
+  mapUserStoryToProjects,
+  formatProjectMappingReport
+} from '../utils/project-mapper.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 2) {
+    console.error('Usage: node dist/scripts/split-spec-by-project.js <spec-path> <output-dir>');
+    process.exit(1);
+  }
+
+  const [specPath, outputDir] = args;
+
+  console.log('🔍 Analyzing spec file...\n');
+
+  // Parse spec
+  const parsedSpec = await parseSpecFile(specPath);
+
+  console.log(`✓ Parsed spec: ${parsedSpec.metadata.title}`);
+  console.log(`  User stories: ${parsedSpec.userStories.length}`);
+  console.log('');
+
+  // Analyze user stories
+  console.log('📊 Classifying user stories by project...\n');
+
+  const projectStats = new Map();
+
+  for (const userStory of parsedSpec.userStories) {
+    const mappings = mapUserStoryToProjects(userStory);
+
+    if (mappings.length > 0) {
+      const primary = mappings[0];
+      console.log(formatProjectMappingReport(userStory, mappings));
+      console.log('');
+
+      projectStats.set(primary.projectId, (projectStats.get(primary.projectId) || 0) + 1);
+    } else {
+      console.log(`❌ ${userStory.id}: ${userStory.title} → NO MATCH (assign to SHARED)`);
+      console.log('');
+      projectStats.set('SHARED', (projectStats.get('SHARED') || 0) + 1);
+    }
+  }
+
+  // Print summary
+  console.log('📈 Project Distribution:\n');
+  const totalStories = parsedSpec.userStories.length;
+
+  for (const [projectId, count] of projectStats.entries()) {
+    const percentage = ((count / totalStories) * 100).toFixed(0);
+    console.log(`  ${projectId}: ${count} user stories (${percentage}%)`);
+  }
+
+  console.log('');
+
+  // Create folder structure
+  console.log('📁 Creating multi-project folder structure...\n');
+
+  const allProjectIds = [...projectStats.keys()];
+  await createMultiProjectFolderStructure(outputDir, allProjectIds);
+
+  console.log('✓ Folder structure created\n');
+
+  // Split spec
+  console.log('✂️  Splitting spec into project-specific files...\n');
+
+  const outputMap = await splitSpecIntoProjects(specPath, outputDir);
+
+  for (const [projectId, filePath] of outputMap.entries()) {
+    console.log(`✓ ${projectId}: ${filePath}`);
+  }
+
+  console.log('');
+  console.log('✅ Spec splitting complete!');
+  console.log('');
+  console.log('Next steps:');
+  console.log('1. Review project-specific specs in:', outputDir);
+  console.log('2. Configure JIRA sync for each project');
+  console.log('3. Run /specweave-jira:sync to create JIRA items');
+}
+
+main().catch((error) => {
+  console.error('❌ Error:', error.message);
+  console.error(error.stack);
+  process.exit(1);
+});