specweave 0.34.4 → 0.34.6

package/dist/src/core/living-docs/enterprise/relationship-mapper.js

@@ -0,0 +1,227 @@
+/**
+ * Relationship Mapper
+ *
+ * Maps relationships between all entities:
+ * - Features → Code files
+ * - Teams → Features
+ * - Modules → Modules (dependencies)
+ * - Increments → Features
+ * - External refs → Internal entities
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+import { consoleLogger } from '../../../utils/logger.js';
+/**
+ * Maps relationships between all entities in the system
+ */
+export class RelationshipMapper {
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        this.logger = options.logger ?? consoleLogger;
+        this.repoAnalyses = options.repoAnalyses;
+    }
+    /**
+     * Build complete relationship map
+     */
+    async map(catalog, orgResult) {
+        const featureToCode = new Map();
+        const featureToTeam = new Map();
+        const teamToFeatures = new Map();
+        const moduleDependencies = new Map();
+        const incrementToFeature = new Map();
+        const externalToFeature = new Map();
+        // 1. Map features to code
+        this.logger.debug('Mapping features to code...');
+        for (const feature of catalog.features) {
+            const files = await this.findCodeForFeature(feature);
+            featureToCode.set(feature.featureId, files);
+        }
+        // 2. Map features to teams (from org result or heuristics)
+        this.logger.debug('Mapping features to teams...');
+        if (orgResult?.enhancedTeams) {
+            for (const team of orgResult.enhancedTeams) {
+                // Initialize team in map
+                if (!teamToFeatures.has(team.name)) {
+                    teamToFeatures.set(team.name, []);
+                }
+                // Match features to teams by:
+                // 1. Project match
+                // 2. Module match (if team owns modules that feature touches)
+                for (const feature of catalog.features) {
+                    const featureFiles = featureToCode.get(feature.featureId) ?? [];
+                    // Check if any team modules are in feature files
+                    const teamModules = team.repos;
+                    const hasOverlap = teamModules.some(mod => featureFiles.some(file => file.includes(mod)));
+                    // Check project match
+                    const projectMatch = feature.project && team.project === feature.project;
+                    if (hasOverlap || projectMatch) {
+                        featureToTeam.set(feature.featureId, team.name);
+                        teamToFeatures.get(team.name).push(feature.featureId);
+                    }
+                }
+            }
+        }
+        // 3. Map module dependencies
+        this.logger.debug('Mapping module dependencies...');
+        if (this.repoAnalyses) {
+            for (const [modName, analysis] of this.repoAnalyses) {
+                const deps = this.extractModuleDependencies(modName, analysis);
+                moduleDependencies.set(modName, deps);
+            }
+        }
+        // 4. Map increments to features
+        this.logger.debug('Mapping increments to features...');
+        for (const feature of catalog.features) {
+            for (const incId of feature.relatedIncrements) {
+                incrementToFeature.set(incId, feature.featureId);
+            }
+        }
+        // 5. Map external refs to features
+        this.logger.debug('Mapping external references...');
+        for (const feature of catalog.features) {
+            for (const ref of feature.externalRefs) {
+                const key = `${ref.provider}:${ref.id}`;
+                externalToFeature.set(key, feature.featureId);
+            }
+        }
+        // Calculate total relationships
+        let totalRelationships = 0;
+        totalRelationships += Array.from(featureToCode.values()).reduce((sum, arr) => sum + arr.length, 0);
+        totalRelationships += featureToTeam.size;
+        totalRelationships += Array.from(moduleDependencies.values()).reduce((sum, arr) => sum + arr.length, 0);
+        totalRelationships += incrementToFeature.size;
+        totalRelationships += externalToFeature.size;
+        return {
+            featureToCode,
+            featureToTeam,
+            teamToFeatures,
+            moduleDependencies,
+            incrementToFeature,
+            externalToFeature,
+            totalRelationships,
+        };
+    }
+    /**
+     * Find code files related to a feature
+     */
+    async findCodeForFeature(feature) {
+        const relatedFiles = [];
+        // Strategy 1: Search for feature ID in code
+        const featureIdPattern = feature.featureId.replace('-', '[-_]?');
+        const srcPath = path.join(this.projectPath, 'src');
+        if (fs.existsSync(srcPath)) {
+            try {
+                // Search for feature ID mentions in code
+                const files = await glob('**/*.{ts,js,tsx,jsx}', {
+                    cwd: srcPath,
+                    nodir: true,
+                    ignore: ['**/node_modules/**', '**/dist/**'],
+                });
+                for (const file of files.slice(0, 1000)) { // Limit search
+                    const content = fs.readFileSync(path.join(srcPath, file), 'utf-8');
+                    if (content.includes(feature.featureId) ||
+                        content.match(new RegExp(featureIdPattern, 'i'))) {
+                        relatedFiles.push(`src/${file}`);
+                    }
+                }
+            }
+            catch (err) {
+                this.logger.debug(`Code search failed: ${err.message}`);
+            }
+        }
+        // Strategy 2: Search for key concepts from user stories
+        for (const us of feature.userStories) {
+            // Extract key terms from title
+            const keyTerms = this.extractKeyTerms(us.title);
+            for (const term of keyTerms) {
+                // Search for term in file names
+                const matchingFiles = await this.findFilesByTerm(term);
+                relatedFiles.push(...matchingFiles);
+            }
+        }
+        // Deduplicate and limit
+        return [...new Set(relatedFiles)].slice(0, 50);
+    }
+    /**
+     * Extract key terms from a title for code matching
+     */
+    extractKeyTerms(title) {
+        // Remove common words and extract meaningful terms
+        const stopWords = new Set([
+            'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+            'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+            'should', 'may', 'might', 'must', 'shall', 'can', 'need', 'dare',
+            'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as',
+            'into', 'through', 'during', 'before', 'after', 'above', 'below',
+            'between', 'under', 'again', 'further', 'then', 'once', 'here',
+            'there', 'when', 'where', 'why', 'how', 'all', 'each', 'every',
+            'both', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'not',
+            'only', 'own', 'same', 'so', 'than', 'too', 'very', 'just', 'and',
+            'but', 'if', 'or', 'because', 'until', 'while', 'although', 'user',
+            'users', 'system', 'feature', 'implement', 'add', 'create', 'update',
+        ]);
+        return title
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(word => word.length > 3 && !stopWords.has(word))
+            .slice(0, 5);
+    }
+    /**
+     * Find files matching a term
+     */
+    async findFilesByTerm(term) {
+        const srcPath = path.join(this.projectPath, 'src');
+        if (!fs.existsSync(srcPath))
+            return [];
+        try {
+            // Search for term in file names
+            const pattern = `**/*${term}*/*.{ts,js}`;
+            const files = await glob(pattern, {
+                cwd: srcPath,
+                nodir: true,
+                nocase: true,
+                ignore: ['**/node_modules/**', '**/dist/**'],
+            });
+            return files.slice(0, 10).map(f => `src/${f}`);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Extract module dependencies from repo analysis
+     */
+    extractModuleDependencies(modName, analysis) {
+        const deps = [];
+        // Extract from external dependencies
+        for (const dep of analysis.externalDependencies) {
+            // Check if it's an internal module reference
+            if (this.repoAnalyses?.has(dep)) {
+                deps.push(dep);
+            }
+        }
+        // Extract from observations (may mention other modules)
+        for (const obs of analysis.observations) {
+            const moduleMentions = obs.match(/(?:uses|depends on|imports from)\s+(\w+)/gi);
+            if (moduleMentions) {
+                for (const mention of moduleMentions) {
+                    const modMatch = mention.match(/(\w+)$/);
+                    if (modMatch && this.repoAnalyses?.has(modMatch[1])) {
+                        deps.push(modMatch[1]);
+                    }
+                }
+            }
+        }
+        // Try to infer from patterns
+        if (analysis.patternsUsed.some(p => p.pattern.includes('API') || p.pattern.includes('client'))) {
+            // API-related modules likely depend on core
+            if (this.repoAnalyses?.has('core') && modName !== 'core') {
+                deps.push('core');
+            }
+        }
+        return [...new Set(deps)];
+    }
+}
+//# sourceMappingURL=relationship-mapper.js.map

package/dist/src/core/living-docs/enterprise/relationship-mapper.js.map

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

package/dist/src/core/living-docs/enterprise/spec-loader.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Enhanced Spec Loader
+ *
+ * Loads ALL specifications from living docs with full details:
+ * - Feature hierarchies (FS-XXX -> US-XXX)
+ * - User story details with acceptance criteria
+ * - Status and completion information
+ * - External tool references (GitHub/JIRA/ADO)
+ * - Related increments
+ */
+import { Logger } from '../../../utils/logger.js';
+/**
+ * User story detail with full acceptance criteria
+ */
+export interface UserStoryDetail {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+    priority: 'P0' | 'P1' | 'P2' | 'P3' | null;
+    status: 'draft' | 'ready' | 'in_progress' | 'completed';
+    project?: string;
+    board?: string;
+    externalRef?: ExternalReference;
+    filePath: string;
+}
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    completed: boolean;
+}
+export interface ExternalReference {
+    provider: 'github' | 'jira' | 'ado';
+    id: string;
+    url?: string;
+    status?: string;
+}
+/**
+ * Enhanced feature spec with full hierarchy
+ */
+export interface EnhancedFeatureSpec {
+    featureId: string;
+    featureName: string;
+    description: string;
+    userStories: UserStoryDetail[];
+    status: 'active' | 'completed' | 'archived';
+    createdAt: string;
+    completedAt?: string;
+    externalRefs: ExternalReference[];
+    relatedIncrements: string[];
+    project?: string;
+    board?: string;
+    folderPath: string;
+    totalACs: number;
+    completedACs: number;
+    completionPercentage: number;
+}
+/**
+ * Full specs catalog with aggregated metrics
+ */
+export interface SpecsCatalog {
+    features: EnhancedFeatureSpec[];
+    totalFeatures: number;
+    activeFeatures: number;
+    completedFeatures: number;
+    archivedFeatures: number;
+    totalUserStories: number;
+    totalACs: number;
+    completedACs: number;
+    overallCompletion: number;
+    byProject: Map<string, EnhancedFeatureSpec[]>;
+    byStatus: Map<string, EnhancedFeatureSpec[]>;
+    loadedAt: string;
+}
+export interface SpecLoaderOptions {
+    projectPath: string;
+    logger?: Logger;
+    includeArchived?: boolean;
+}
+/**
+ * Enhanced spec loader that extracts full details from all specs
+ */
+export declare class EnhancedSpecLoader {
+    private projectPath;
+    private logger;
+    private includeArchived;
+    constructor(options: SpecLoaderOptions);
+    /**
+     * Load all specifications with full details
+     */
+    loadAllSpecs(): Promise<SpecsCatalog>;
+    /**
+     * Load a single feature with all its user stories
+     */
+    private loadFeature;
+    /**
+     * Load all user stories in a feature folder
+     */
+    private loadUserStories;
+    /**
+     * Load a single user story with acceptance criteria
+     */
+    private loadUserStory;
+    /**
+     * Extract acceptance criteria from user story content
+     */
+    private extractAcceptanceCriteria;
+    /**
+     * Extract priority from content or title
+     */
+    private extractPriority;
+    /**
+     * Determine user story status from content
+     */
+    private determineUserStoryStatus;
+    /**
+     * Extract external reference (GitHub/JIRA/ADO)
+     */
+    private extractExternalRef;
+    /**
+     * Find increments related to a feature
+     */
+    private findRelatedIncrements;
+    /**
+     * Extract frontmatter from markdown
+     */
+    private extractFrontmatter;
+    /**
+     * Extract title from markdown (first H1)
+     */
+    private extractTitle;
+    /**
+     * Extract description (first paragraph after title)
+     */
+    private extractDescription;
+    /**
+     * Extract user story description ("As a... I want... So that...")
+     */
+    private extractUserStoryDescription;
+    /**
+     * Extract a specific field like **Project**: value
+     */
+    private extractField;
+    /**
+     * Get file creation date
+     */
+    private getFileCreatedDate;
+    /**
+     * Get file modification date
+     */
+    private getFileModifiedDate;
+    /**
+     * Build the full catalog from loaded features
+     */
+    private buildCatalog;
+    /**
+     * Create empty catalog
+     */
+    private createEmptyCatalog;
+}
+//# sourceMappingURL=spec-loader.d.ts.map

package/dist/src/core/living-docs/enterprise/spec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/enterprise/spec-loader.ts"],"names":[],"mappings":"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"}