specweave 0.14.0 → 0.15.0

package/dist/src/core/rfc-generator-v2.js

@@ -0,0 +1,399 @@
+/**
+ * RFC Generator V2 - Universal Flexible Structure Support
+ *
+ * Modern, multi-platform RFC generator that adapts to any project management structure:
+ * - Jira: Epic → Story → Sub-task
+ * - Azure DevOps: Feature → User Story → Task
+ * - GitHub: Milestone → Issue (or flat issues)
+ * - Custom: Any configurable hierarchy
+ *
+ * Key Features:
+ * - Flexible work item types (any string: story, bug, issue, feature, user story, etc.)
+ * - 6 grouping strategies: by_type, by_parent, by_priority, by_label, flat, custom
+ * - Parent-child relationships (Epic, Feature, Milestone)
+ * - Labels/tags support (GitHub-style)
+ * - Auto-detection via ProjectStructureDetector
+ * - Extensible metadata
+ *
+ * This is the official RFC generator (V1 deprecated).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { ProjectStructureDetector } from './project-structure-detector';
+export class FlexibleRFCGenerator {
+    constructor(projectRoot = process.cwd()) {
+        this.projectRoot = projectRoot;
+        this.structureDetector = new ProjectStructureDetector(projectRoot);
+    }
+    /**
+     * Generate RFC document with flexible structure support
+     */
+    async generateRFC(content) {
+        const rfcFolder = path.join(this.projectRoot, '.specweave', 'docs', 'rfcs');
+        this.ensureDir(rfcFolder);
+        // Auto-detect project structure if not provided
+        const structure = content.projectStructure || await this.structureDetector.detectStructure();
+        const rfcFileName = this.generateRFCFileName(content.metadata);
+        const rfcPath = path.join(rfcFolder, rfcFileName);
+        const rfcContent = this.buildRFCContent(content, structure);
+        fs.writeFileSync(rfcPath, rfcContent, 'utf-8');
+        return rfcPath;
+    }
+    /**
+     * Build RFC content with structure-aware formatting
+     */
+    buildRFCContent(content, structure) {
+        let rfc = this.generateHeader(content.metadata, content.sourceMetadata, structure);
+        rfc += this.generateSummary(content.summary);
+        rfc += this.generateMotivation(content.motivation);
+        rfc += this.generateDetailedDesign(content.workItems, structure, content.sourceMetadata);
+        rfc += this.generateAlternatives(content.alternatives);
+        rfc += this.generateImplementationPlan(content.metadata.incrementId);
+        return rfc;
+    }
+    /**
+     * Generate header with source-specific metadata
+     */
+    generateHeader(metadata, sourceMetadata, structure) {
+        let header = `# RFC ${metadata.incrementId}: ${metadata.title}\n\n`;
+        header += `**Status**: ${this.capitalizeFirst(metadata.status)}\n`;
+        header += `**Created**: ${metadata.created}\n`;
+        if (sourceMetadata && structure) {
+            // Show parent work item link (Epic, Feature, Milestone, etc.)
+            if (sourceMetadata.parent_key && sourceMetadata.parent_url) {
+                const parentType = sourceMetadata.parent_type || structure.workItemTypes.parentLevel || 'Parent';
+                header += `**${parentType}**: [${sourceMetadata.parent_key}](${sourceMetadata.parent_url})`;
+                if (sourceMetadata.parent_title) {
+                    header += ` - ${sourceMetadata.parent_title}`;
+                }
+                header += '\n';
+            }
+            // Add repository/project context
+            if (sourceMetadata.repository) {
+                header += `**Repository**: ${sourceMetadata.repository}\n`;
+            }
+            if (sourceMetadata.project) {
+                header += `**Project**: ${sourceMetadata.project}\n`;
+            }
+        }
+        header += '\n';
+        return header;
+    }
+    /**
+     * Generate Summary section
+     */
+    generateSummary(summary) {
+        return `## Summary\n\n${summary}\n\n`;
+    }
+    /**
+     * Generate Motivation section
+     */
+    generateMotivation(motivation) {
+        return `## Motivation\n\n${motivation}\n\n`;
+    }
+    /**
+     * Generate Detailed Design with flexible grouping
+     */
+    generateDetailedDesign(workItems, structure, sourceMetadata) {
+        let design = `## Detailed Design\n\n`;
+        // Group work items according to strategy
+        const grouped = this.groupWorkItems(workItems, structure);
+        // Generate sections for each group
+        grouped.forEach(group => {
+            design += `### ${group.displayName}\n\n`;
+            group.items.forEach((item, index) => {
+                design += `#### ${index + 1}. ${item.title}\n\n`;
+                if (item.description) {
+                    design += `${item.description}\n\n`;
+                }
+                // Add metadata line
+                const metadataItems = [];
+                if (item.priority) {
+                    metadataItems.push(`**Priority**: ${item.priority}`);
+                }
+                if (item.parent && structure.groupingStrategy !== 'by_parent') {
+                    metadataItems.push(`**${item.parent.type}**: ${item.parent.title}`);
+                }
+                if (item.source_key && item.source_url) {
+                    const sourceLabel = this.getSourceLabel(sourceMetadata?.source_type);
+                    metadataItems.push(`**${sourceLabel}**: [${item.source_key}](${item.source_url})`);
+                }
+                if (item.labels && item.labels.length > 0) {
+                    metadataItems.push(`**Labels**: ${item.labels.join(', ')}`);
+                }
+                if (metadataItems.length > 0) {
+                    design += metadataItems.join(' | ') + '\n\n';
+                }
+            });
+        });
+        return design;
+    }
+    /**
+     * Group work items according to project structure
+     */
+    groupWorkItems(items, structure) {
+        switch (structure.groupingStrategy) {
+            case 'by_type':
+                return this.groupByType(items, structure);
+            case 'by_parent':
+                return this.groupByParent(items, structure);
+            case 'by_priority':
+                return this.groupByPriority(items);
+            case 'by_label':
+                return this.groupByLabel(items);
+            case 'flat':
+                return [{
+                        groupName: 'all',
+                        displayName: 'Work Items',
+                        items
+                    }];
+            case 'custom':
+                if (structure.customGrouping) {
+                    const customGroups = structure.customGrouping(items);
+                    return Object.entries(customGroups).map(([name, groupItems]) => ({
+                        groupName: name,
+                        displayName: this.formatGroupName(name),
+                        items: groupItems
+                    }));
+                }
+                return this.groupByType(items, structure);
+            default:
+                return this.groupByType(items, structure);
+        }
+    }
+    /**
+     * Group by work item type (story, bug, task, issue, etc.)
+     */
+    groupByType(items, structure) {
+        const typeMap = new Map();
+        items.forEach(item => {
+            const type = item.type.toLowerCase();
+            if (!typeMap.has(type)) {
+                typeMap.set(type, []);
+            }
+            typeMap.get(type).push(item);
+        });
+        // Define display order and names
+        const typeDisplayNames = {
+            story: 'User Stories',
+            'user story': 'User Stories',
+            bug: 'Bug Fixes',
+            task: 'Technical Tasks',
+            issue: 'Issues',
+            feature: 'Features',
+            epic: 'Epics',
+            subtask: 'Sub-tasks',
+            'sub-task': 'Sub-tasks'
+        };
+        const typeOrder = ['story', 'user story', 'feature', 'bug', 'task', 'issue', 'subtask', 'sub-task'];
+        const groups = [];
+        // Add groups in order
+        typeOrder.forEach(type => {
+            if (typeMap.has(type)) {
+                groups.push({
+                    groupName: type,
+                    displayName: typeDisplayNames[type] || this.formatGroupName(type),
+                    items: typeMap.get(type)
+                });
+                typeMap.delete(type);
+            }
+        });
+        // Add remaining types not in predefined order
+        typeMap.forEach((groupItems, type) => {
+            groups.push({
+                groupName: type,
+                displayName: this.formatGroupName(type),
+                items: groupItems
+            });
+        });
+        return groups;
+    }
+    /**
+     * Group by parent (Epic, Feature, Milestone, etc.)
+     */
+    groupByParent(items, structure) {
+        const parentMap = new Map();
+        const noParent = [];
+        items.forEach(item => {
+            if (item.parent) {
+                const parentKey = item.parent.key;
+                if (!parentMap.has(parentKey)) {
+                    parentMap.set(parentKey, []);
+                }
+                parentMap.get(parentKey).push(item);
+            }
+            else {
+                noParent.push(item);
+            }
+        });
+        const groups = [];
+        // Add parent groups
+        parentMap.forEach((groupItems, parentKey) => {
+            const firstItem = groupItems[0];
+            const parentType = firstItem.parent?.type || structure.workItemTypes.parentLevel || 'Parent';
+            const parentTitle = firstItem.parent?.title || parentKey;
+            groups.push({
+                groupName: parentKey,
+                displayName: `${parentType}: ${parentTitle}`,
+                items: groupItems,
+                metadata: {
+                    parentKey,
+                    parentType,
+                    parentUrl: firstItem.parent?.url
+                }
+            });
+        });
+        // Add ungrouped items
+        if (noParent.length > 0) {
+            groups.push({
+                groupName: 'ungrouped',
+                displayName: 'Other Work Items',
+                items: noParent
+            });
+        }
+        return groups;
+    }
+    /**
+     * Group by priority
+     */
+    groupByPriority(items) {
+        const priorityMap = new Map();
+        items.forEach(item => {
+            const priority = item.priority || 'None';
+            if (!priorityMap.has(priority)) {
+                priorityMap.set(priority, []);
+            }
+            priorityMap.get(priority).push(item);
+        });
+        const priorityOrder = ['P1', 'P2', 'P3', 'High', 'Medium', 'Low', 'None'];
+        const groups = [];
+        priorityOrder.forEach(priority => {
+            if (priorityMap.has(priority)) {
+                groups.push({
+                    groupName: priority,
+                    displayName: `Priority: ${priority}`,
+                    items: priorityMap.get(priority)
+                });
+                priorityMap.delete(priority);
+            }
+        });
+        // Add remaining priorities
+        priorityMap.forEach((groupItems, priority) => {
+            groups.push({
+                groupName: priority,
+                displayName: `Priority: ${priority}`,
+                items: groupItems
+            });
+        });
+        return groups;
+    }
+    /**
+     * Group by labels
+     */
+    groupByLabel(items) {
+        const labelMap = new Map();
+        const noLabels = [];
+        items.forEach(item => {
+            if (item.labels && item.labels.length > 0) {
+                item.labels.forEach(label => {
+                    if (!labelMap.has(label)) {
+                        labelMap.set(label, []);
+                    }
+                    labelMap.get(label).push(item);
+                });
+            }
+            else {
+                noLabels.push(item);
+            }
+        });
+        const groups = [];
+        labelMap.forEach((groupItems, label) => {
+            groups.push({
+                groupName: label,
+                displayName: `Label: ${label}`,
+                items: groupItems
+            });
+        });
+        if (noLabels.length > 0) {
+            groups.push({
+                groupName: 'unlabeled',
+                displayName: 'Unlabeled Items',
+                items: noLabels
+            });
+        }
+        return groups;
+    }
+    /**
+     * Generate Alternatives section
+     */
+    generateAlternatives(alternatives) {
+        let alt = `## Alternatives Considered\n\n`;
+        if (alternatives) {
+            alt += `${alternatives}\n\n`;
+        }
+        else {
+            alt += `(To be filled in during design phase)\n\n`;
+        }
+        return alt;
+    }
+    /**
+     * Generate Implementation Plan section
+     */
+    generateImplementationPlan(incrementId) {
+        return `## Implementation Plan\n\nSee increment ${incrementId} in \`.specweave/increments/${incrementId}/\`\n`;
+    }
+    /**
+     * Generate RFC file name
+     */
+    generateRFCFileName(metadata) {
+        const slug = this.slugify(metadata.title);
+        return `rfc-${metadata.incrementId}-${slug}.md`;
+    }
+    /**
+     * Get source label
+     */
+    getSourceLabel(sourceType) {
+        switch (sourceType) {
+            case 'jira': return 'Jira';
+            case 'ado': return 'ADO';
+            case 'github': return 'GitHub';
+            default: return 'Source';
+        }
+    }
+    /**
+     * Format group name for display
+     */
+    formatGroupName(name) {
+        return name
+            .split(/[-_\s]/)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Capitalize first letter
+     */
+    capitalizeFirst(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    /**
+     * Slugify string
+     */
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-')
+            .trim()
+            .substring(0, 50);
+    }
+    /**
+     * Ensure directory exists
+     */
+    ensureDir(dir) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=rfc-generator-v2.js.map

package/dist/src/core/rfc-generator-v2.js.map

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

package/dist/src/core/specs/spec-metadata-manager.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Spec Metadata Manager
+ *
+ * Manages spec.md files in .specweave/docs/internal/specs/
+ *
+ * CRITICAL ARCHITECTURE:
+ * - Specs are the SOURCE OF TRUTH for features
+ * - Specs are PERMANENT (never deleted)
+ * - External tools (GitHub/Jira/ADO) sync to specs, NOT increments
+ *
+ * @module spec-metadata-manager
+ */
+import { SpecMetadata, SpecContent, SpecValidationResult } from '../types/spec-metadata.js';
+export declare class SpecMetadataManager {
+    private specsDir;
+    constructor(projectRoot?: string);
+    /**
+     * Get all spec files
+     */
+    getAllSpecs(): Promise<string[]>;
+    /**
+     * Load spec metadata and content
+     */
+    loadSpec(specId: string): Promise<SpecContent | null>;
+    /**
+     * Save spec metadata (update frontmatter)
+     */
+    saveMetadata(specId: string, metadata: Partial<SpecMetadata>): Promise<void>;
+    /**
+     * Link spec to external tool
+     */
+    linkToExternal(specId: string, provider: 'github' | 'jira' | 'ado', externalData: {
+        id: string | number;
+        url: string;
+        [key: string]: any;
+    }): Promise<void>;
+    /**
+     * Unlink spec from external tool
+     */
+    unlinkFromExternal(specId: string, provider: 'github' | 'jira' | 'ado'): Promise<void>;
+    /**
+     * Update sync status
+     */
+    updateSyncStatus(specId: string, provider: 'github' | 'jira' | 'ado', status: 'synced' | 'out-of-sync' | 'error', error?: string): Promise<void>;
+    /**
+     * Validate spec structure
+     */
+    validateSpec(specId: string): Promise<SpecValidationResult>;
+    /**
+     * Get spec file path
+     */
+    private getSpecPath;
+    /**
+     * Parse user stories from markdown content
+     */
+    private parseUserStories;
+    /**
+     * Parse increment references from markdown content
+     */
+    private parseIncrements;
+    /**
+     * Calculate progress from user stories
+     */
+    private calculateProgress;
+    /**
+     * Create a new spec (template)
+     */
+    createSpec(specId: string, title: string, priority?: 'P0' | 'P1' | 'P2' | 'P3'): Promise<string>;
+}
+//# sourceMappingURL=spec-metadata-manager.d.ts.map

package/dist/src/core/specs/spec-metadata-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-metadata-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/specs/spec-metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EACL,YAAY,EACZ,WAAW,EAIX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAEnC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,GAAE,MAAsB;IAgB/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoC3D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BlF;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACnC,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC;IAqChB;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAClC,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACnC,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4CjE;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA2D7G"}