specweave 0.11.0 → 0.12.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/sync/bidirectional-engine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Bidirectional Sync Engine
+ *
+ * Handles synchronization between SpecWeave increments and external systems
+ * (GitHub, Jira, ADO) in both directions with conflict detection and resolution.
+ *
+ * Features:
+ * - Bidirectional sync (to-external, from-external, both)
+ * - Conflict detection (field-level granularity)
+ * - Interactive conflict resolution
+ * - Change tracking (detect what changed since last sync)
+ * - Reorganization detection (moved issues, split/merged stories)
+ */
+import { SyncProvider } from '../types/sync-profile';
+export type SyncDirection = 'to-external' | 'from-external' | 'bidirectional';
+export type ConflictResolution = 'prefer-local' | 'prefer-external' | 'manual' | 'prompt';
+export interface SyncState {
+    /** Increment metadata */
+    incrementId: string;
+    title: string;
+    status: string;
+    /** External metadata */
+    externalId?: string;
+    externalKey?: string;
+    externalUrl?: string;
+    /** Sync state */
+    lastSyncAt?: string;
+    lastLocalChange?: string;
+    lastExternalChange?: string;
+    /** Content hashes (for change detection) */
+    localHash?: string;
+    externalHash?: string;
+    /** Linked items (user stories, tasks, etc.) */
+    linkedItems?: Record<string, string>;
+}
+export interface FieldChange {
+    field: string;
+    localValue: any;
+    externalValue: any;
+    lastSyncValue?: any;
+}
+export interface Conflict extends FieldChange {
+    resolution?: 'local' | 'external' | 'merged';
+    mergedValue?: any;
+}
+export interface ChangeSet {
+    /** Changes to sync to external */
+    toExternal: FieldChange[];
+    /** Changes to sync from external */
+    fromExternal: FieldChange[];
+    /** Conflicts (both sides changed) */
+    conflicts: Conflict[];
+}
+export interface SyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    changes: ChangeSet;
+    conflictsResolved: number;
+    errors: string[];
+}
+export declare class BidirectionalSyncEngine {
+    private provider;
+    private projectRoot;
+    constructor(provider: SyncProvider, projectRoot?: string);
+    /**
+     * Main sync orchestrator
+     */
+    sync(incrementId: string, direction: SyncDirection, conflictResolution?: ConflictResolution): Promise<SyncResult>;
+    /**
+     * Detect changes in both local and external state
+     */
+    private detectChanges;
+    /**
+     * Fetch local state from increment files
+     */
+    private fetchLocalState;
+    /**
+     * Fetch external state from Jira/GitHub/ADO
+     */
+    private fetchExternalState;
+    /**
+     * Resolve conflicts interactively or automatically
+     */
+    private resolveConflicts;
+    /**
+     * Interactive conflict resolution prompt
+     */
+    private promptConflictResolution;
+    /**
+     * Apply changes to external system
+     */
+    private applyToExternal;
+    /**
+     * Apply changes to local increment
+     */
+    private applyToLocal;
+    /**
+     * Load sync state from metadata
+     */
+    private loadSyncState;
+    /**
+     * Update sync state in metadata
+     */
+    private updateSyncState;
+    /**
+     * Print sync summary
+     */
+    private printSyncSummary;
+}
+//# sourceMappingURL=bidirectional-engine.d.ts.map

package/dist/src/core/sync/bidirectional-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidirectional-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/bidirectional-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMrD,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7C,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1B,oCAAoC;IACpC,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qCAAqC;IACrC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;gBADX,QAAQ,EAAE,YAAY,EACtB,WAAW,GAAE,MAAsB;IAG7C;;OAEG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,EACxB,kBAAkB,GAAE,kBAA6B,GAChD,OAAO,CAAC,UAAU,CAAC;IA2FtB;;OAEG;YACW,aAAa;IAuD3B;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,wBAAwB;IAiDtC;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,YAAY;IA2C1B;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,eAAe;IAmC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}