specweave 0.17.0 → 0.17.1

package/dist/src/utils/project-mapper.js

@@ -0,0 +1,276 @@
+/**
+ * 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
+ * @param config Optional configuration (confidence threshold, custom rules)
+ * @returns Primary project mapping or null if no confident match
+ */
+export function getPrimaryProject(userStory, projectRules = DEFAULT_PROJECT_RULES, config) {
+    const rules = config?.customRules || projectRules;
+    const threshold = config?.confidenceThreshold ?? 0.3; // Default: 30%
+    const mappings = mapUserStoryToProjects(userStory, rules);
+    // Require confidence >= threshold for primary project
+    return mappings.length > 0 && mappings[0].confidence >= threshold
+        ? 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');
+}
+//# sourceMappingURL=project-mapper.js.map

package/dist/src/utils/project-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mapper.js","sourceRoot":"","sources":["../../../src/utils/project-mapper.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/spec-splitter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Spec Splitter - Split Monolithic Specs into Project-Specific Files
+ *
+ * Takes a comprehensive spec file covering multiple projects and intelligently
+ * splits it into project-specific spec files (FE/, BE/, MOBILE/, etc.)
+ *
+ * @module spec-splitter
+ */
+import { type UserStory, type ProjectRule } from './project-mapper.js';
+export interface SpecMetadata {
+    specId?: string;
+    spec_id?: string;
+    title: string;
+    version: string;
+    status: string;
+    created: string;
+    lastUpdated?: string;
+    last_updated?: string;
+    authors: string[];
+    reviewers?: string[];
+    priority: string;
+    estimatedEffort?: string;
+    estimated_effort?: string;
+    targetRelease?: string;
+    target_release?: string;
+    jiraSync?: boolean;
+    jira_sync?: boolean;
+    jiraProjects?: string[];
+    jira_projects?: string[];
+}
+/**
+ * Normalize metadata fields (prefers camelCase over snake_case)
+ *
+ * @param metadata Raw metadata with potential snake_case fields
+ * @returns Normalized metadata with camelCase fields
+ */
+export declare function normalizeMetadata(metadata: SpecMetadata): SpecMetadata;
+export interface ParsedSpec {
+    metadata: SpecMetadata;
+    executiveSummary: string;
+    problemStatement: string;
+    userStories: UserStory[];
+    functionalRequirements: string;
+    nonFunctionalRequirements: string;
+    successMetrics: string;
+    technicalArchitecture: string;
+    testStrategy: string;
+    riskAnalysis: string;
+    futureRoadmap: string;
+    appendices: string;
+}
+/**
+ * Parse spec file into structured format
+ *
+ * @param specPath Path to spec.md file
+ * @returns Parsed spec structure
+ */
+export declare function parseSpecFile(specPath: string): Promise<ParsedSpec>;
+/**
+ * Split spec into project-specific files
+ *
+ * @param specPath Path to monolithic spec.md
+ * @param outputDir Directory to write project-specific specs (e.g., .specweave/docs/internal/specs/)
+ * @param projectRules Custom project mapping rules (optional)
+ * @returns Map of projectId → output file path
+ */
+export declare function splitSpecIntoProjects(specPath: string, outputDir: string, projectRules?: ProjectRule[]): Promise<Map<string, string>>;
+/**
+ * Create multi-project folder structure
+ *
+ * @param specsDir Base specs directory (.specweave/docs/internal/specs/)
+ * @param projectIds Array of project IDs (e.g., ['FE', 'BE', 'MOBILE'])
+ */
+export declare function createMultiProjectFolderStructure(specsDir: string, projectIds: string[]): Promise<void>;
+//# sourceMappingURL=spec-splitter.d.ts.map

package/dist/src/utils/spec-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-splitter.d.ts","sourceRoot":"","sources":["../../../src/utils/spec-splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAUtE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCzE;AA8ID;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,WAAW,EAA0B,GAClD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0B9B;AA6GD;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAgCf"}