specweave 0.17.0 → 0.17.1

package/dist/plugins/specweave-ado/lib/ado-project-detector.js

@@ -0,0 +1,416 @@
+/**
+ * Azure DevOps Project Detector
+ *
+ * Intelligently detects which Azure DevOps project a spec or increment belongs to
+ * based on content analysis, folder structure, and configuration.
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+// ============================================================================
+// Project Detection Keywords and Patterns
+// ============================================================================
+/**
+ * Keywords that indicate a spec belongs to a specific project
+ */
+export const PROJECT_KEYWORDS = {
+    'AuthService': [
+        'authentication', 'auth', 'login', 'logout', 'oauth',
+        'jwt', 'token', 'session', 'password', 'credential',
+        'sso', 'saml', 'ldap', 'mfa', '2fa', 'totp'
+    ],
+    'UserService': [
+        'user', 'profile', 'account', 'registration', 'preferences',
+        'settings', 'avatar', 'username', 'email', 'verification',
+        'onboarding', 'demographics', 'personalization'
+    ],
+    'PaymentService': [
+        'payment', 'billing', 'stripe', 'paypal', 'invoice',
+        'subscription', 'charge', 'refund', 'credit card', 'transaction',
+        'checkout', 'cart', 'pricing', 'plan', 'tier'
+    ],
+    'NotificationService': [
+        'notification', 'email', 'sms', 'push', 'alert',
+        'message', 'webhook', 'queue', 'sendgrid', 'twilio',
+        'template', 'broadcast', 'digest', 'reminder'
+    ],
+    'Platform': [
+        'infrastructure', 'deployment', 'monitoring', 'logging',
+        'metrics', 'kubernetes', 'docker', 'ci/cd', 'pipeline',
+        'terraform', 'ansible', 'helm', 'grafana', 'prometheus'
+    ],
+    'DataService': [
+        'database', 'data', 'analytics', 'etl', 'warehouse',
+        'pipeline', 'kafka', 'spark', 'hadoop', 'bigquery',
+        'redshift', 'snowflake', 'datalake', 'streaming'
+    ],
+    'ApiGateway': [
+        'gateway', 'api', 'proxy', 'routing', 'load balancer',
+        'rate limiting', 'throttling', 'circuit breaker', 'cors',
+        'authentication proxy', 'service mesh', 'envoy', 'kong'
+    ],
+    'WebApp': [
+        'frontend', 'ui', 'react', 'angular', 'vue', 'component',
+        'responsive', 'mobile-first', 'spa', 'ssr', 'next.js',
+        'gatsby', 'webpack', 'css', 'sass', 'styled-components'
+    ],
+    'MobileApp': [
+        'ios', 'android', 'react native', 'flutter', 'swift',
+        'kotlin', 'objective-c', 'java', 'push notification',
+        'app store', 'play store', 'mobile', 'tablet', 'responsive'
+    ]
+};
+/**
+ * File path patterns that indicate project ownership
+ */
+export const FILE_PATTERNS = {
+    'AuthService': [
+        /auth\//i,
+        /login\//i,
+        /security\//i,
+        /oauth\//i,
+        /jwt\//i
+    ],
+    'UserService': [
+        /users?\//i,
+        /profiles?\//i,
+        /accounts?\//i,
+        /members?\//i
+    ],
+    'PaymentService': [
+        /payment\//i,
+        /billing\//i,
+        /checkout\//i,
+        /stripe\//i,
+        /subscription\//i
+    ],
+    'NotificationService': [
+        /notification\//i,
+        /email\//i,
+        /messaging\//i,
+        /templates?\//i
+    ],
+    'Platform': [
+        /infrastructure\//i,
+        /terraform\//i,
+        /kubernetes\//i,
+        /k8s\//i,
+        /\.github\/workflows\//i
+    ],
+    'WebApp': [
+        /frontend\//i,
+        /src\/components\//i,
+        /src\/pages\//i,
+        /public\//i,
+        /styles?\//i
+    ],
+    'MobileApp': [
+        /ios\//i,
+        /android\//i,
+        /mobile\//i,
+        /app\//i
+    ]
+};
+// ============================================================================
+// Project Detector Class
+// ============================================================================
+export class AdoProjectDetector {
+    constructor(strategy, availableProjects, customKeywords, customPatterns) {
+        this.strategy = strategy;
+        this.availableProjects = availableProjects;
+        this.projectKeywords = { ...PROJECT_KEYWORDS, ...customKeywords };
+        this.filePatterns = { ...FILE_PATTERNS, ...customPatterns };
+    }
+    /**
+     * Detect project from spec file path
+     */
+    async detectFromSpecPath(specPath) {
+        // For project-per-team strategy, use folder structure
+        if (this.strategy === 'project-per-team') {
+            const pathParts = specPath.split(path.sep);
+            const specsIndex = pathParts.indexOf('specs');
+            if (specsIndex !== -1 && specsIndex < pathParts.length - 1) {
+                const projectFolder = pathParts[specsIndex + 1];
+                // Check if it matches an available project
+                const matchedProject = this.availableProjects.find(p => p.toLowerCase() === projectFolder.toLowerCase());
+                if (matchedProject) {
+                    return {
+                        primary: matchedProject,
+                        confidence: 1.0,
+                        strategy: this.strategy
+                    };
+                }
+            }
+        }
+        // Fall back to content detection
+        const content = await fs.readFile(specPath, 'utf-8');
+        return this.detectFromContent(content);
+    }
+    /**
+     * Detect project from spec content
+     */
+    async detectFromContent(content) {
+        const candidates = this.analyzeContent(content);
+        // High confidence: Auto-select
+        if (candidates[0]?.confidence > 0.7) {
+            return {
+                primary: candidates[0].project,
+                confidence: candidates[0].confidence,
+                strategy: this.strategy
+            };
+        }
+        // Medium confidence: Primary with secondary projects
+        if (candidates[0]?.confidence > 0.4) {
+            const secondary = candidates
+                .slice(1)
+                .filter(c => c.confidence > 0.3)
+                .map(c => c.project);
+            return {
+                primary: candidates[0].project,
+                secondary: secondary.length > 0 ? secondary : undefined,
+                confidence: candidates[0].confidence,
+                strategy: this.strategy
+            };
+        }
+        // Low confidence: Default to first available project
+        return {
+            primary: this.availableProjects[0] || 'Unknown',
+            confidence: 0,
+            strategy: this.strategy
+        };
+    }
+    /**
+     * Analyze content and return project candidates with confidence scores
+     */
+    analyzeContent(content) {
+        const results = [];
+        const lowerContent = content.toLowerCase();
+        for (const project of this.availableProjects) {
+            let confidence = 0;
+            const reasons = [];
+            // Check if project name is in title or frontmatter
+            if (lowerContent.includes(project.toLowerCase())) {
+                confidence += 0.5;
+                reasons.push(`Project name "${project}" found in content`);
+            }
+            // Check keywords
+            const keywords = this.projectKeywords[project] || [];
+            let keywordMatches = 0;
+            for (const keyword of keywords) {
+                if (lowerContent.includes(keyword.toLowerCase())) {
+                    keywordMatches++;
+                }
+            }
+            if (keywordMatches > 0) {
+                const keywordScore = Math.min(keywordMatches * 0.1, 0.4);
+                confidence += keywordScore;
+                reasons.push(`Found ${keywordMatches} keyword matches`);
+            }
+            // Check file references
+            const patterns = this.filePatterns[project] || [];
+            let patternMatches = 0;
+            for (const pattern of patterns) {
+                if (pattern.test(content)) {
+                    patternMatches++;
+                }
+            }
+            if (patternMatches > 0) {
+                const patternScore = Math.min(patternMatches * 0.15, 0.3);
+                confidence += patternScore;
+                reasons.push(`Found ${patternMatches} file pattern matches`);
+            }
+            // Check for explicit project assignment
+            const projectAssignment = new RegExp(`project:\\s*${project}`, 'i');
+            if (projectAssignment.test(content)) {
+                confidence = 1.0; // Override with full confidence
+                reasons.push('Explicit project assignment in frontmatter');
+            }
+            results.push({ project, confidence, reasons });
+        }
+        // Sort by confidence (highest first)
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Detect projects for multi-project spec
+     */
+    async detectMultiProject(content) {
+        const candidates = this.analyzeContent(content);
+        // Get all projects with meaningful confidence
+        const significantProjects = candidates.filter(c => c.confidence > 0.3);
+        if (significantProjects.length === 0) {
+            return {
+                primary: this.availableProjects[0] || 'Unknown',
+                confidence: 0,
+                strategy: this.strategy
+            };
+        }
+        // Primary is highest confidence
+        const primary = significantProjects[0];
+        // Secondary are other significant projects
+        const secondary = significantProjects
+            .slice(1)
+            .map(c => c.project);
+        return {
+            primary: primary.project,
+            secondary: secondary.length > 0 ? secondary : undefined,
+            confidence: primary.confidence,
+            strategy: this.strategy
+        };
+    }
+    /**
+     * Map spec to area path (for area-path-based strategy)
+     */
+    mapToAreaPath(content, project) {
+        const areaPaths = process.env.AZURE_DEVOPS_AREA_PATHS?.split(',').map(a => a.trim()) || [];
+        for (const areaPath of areaPaths) {
+            if (content.toLowerCase().includes(areaPath.toLowerCase())) {
+                return `${project}\\${areaPath}`;
+            }
+        }
+        // Default area path
+        return project;
+    }
+    /**
+     * Assign to team (for team-based strategy)
+     */
+    assignToTeam(content) {
+        const teams = process.env.AZURE_DEVOPS_TEAMS?.split(',').map(t => t.trim()) || [];
+        // Check for explicit team assignment
+        const teamMatch = content.match(/team:\s*([^\n]+)/i);
+        if (teamMatch) {
+            const assignedTeam = teamMatch[1].trim();
+            if (teams.includes(assignedTeam)) {
+                return assignedTeam;
+            }
+        }
+        // Auto-detect based on keywords
+        const teamKeywords = {
+            'Frontend': ['ui', 'react', 'component', 'css', 'design'],
+            'Backend': ['api', 'database', 'server', 'endpoint', 'query'],
+            'Mobile': ['ios', 'android', 'app', 'native', 'push'],
+            'DevOps': ['deploy', 'ci/cd', 'kubernetes', 'docker', 'pipeline'],
+            'Data': ['analytics', 'etl', 'warehouse', 'bigquery', 'spark']
+        };
+        for (const team of teams) {
+            const keywords = teamKeywords[team] || [];
+            for (const keyword of keywords) {
+                if (content.toLowerCase().includes(keyword)) {
+                    return team;
+                }
+            }
+        }
+        // Default to first team
+        return teams[0] || 'Default Team';
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Get project detector from environment
+ */
+export function getProjectDetectorFromEnv() {
+    const strategy = process.env.AZURE_DEVOPS_STRATEGY || 'team-based';
+    let projects = [];
+    switch (strategy) {
+        case 'project-per-team':
+            projects = process.env.AZURE_DEVOPS_PROJECTS?.split(',').map(p => p.trim()) || [];
+            break;
+        case 'area-path-based':
+        case 'team-based':
+            const project = process.env.AZURE_DEVOPS_PROJECT;
+            if (project) {
+                projects = [project];
+            }
+            break;
+    }
+    return new AdoProjectDetector(strategy, projects);
+}
+/**
+ * Create project folders based on strategy
+ */
+export async function createProjectFolders(baseDir, strategy, projects) {
+    const specsPath = path.join(baseDir, '.specweave', 'docs', 'internal', 'specs');
+    switch (strategy) {
+        case 'project-per-team':
+            // Create folder for each project
+            for (const project of projects) {
+                const projectPath = path.join(specsPath, project);
+                await fs.ensureDir(projectPath);
+                await createProjectReadme(projectPath, project);
+            }
+            break;
+        case 'area-path-based':
+            // Create folders for area paths
+            const areaPaths = process.env.AZURE_DEVOPS_AREA_PATHS?.split(',').map(a => a.trim()) || [];
+            const project = projects[0];
+            if (project) {
+                const projectPath = path.join(specsPath, project);
+                await fs.ensureDir(projectPath);
+                for (const area of areaPaths) {
+                    const areaPath = path.join(projectPath, area);
+                    await fs.ensureDir(areaPath);
+                }
+            }
+            break;
+        case 'team-based':
+            // Create folders for teams
+            const teams = process.env.AZURE_DEVOPS_TEAMS?.split(',').map(t => t.trim()) || [];
+            const proj = projects[0];
+            if (proj) {
+                const projectPath = path.join(specsPath, proj);
+                await fs.ensureDir(projectPath);
+                for (const team of teams) {
+                    const teamPath = path.join(projectPath, team);
+                    await fs.ensureDir(teamPath);
+                }
+            }
+            break;
+    }
+}
+/**
+ * Create README for project folder
+ */
+async function createProjectReadme(projectPath, projectName) {
+    const readmePath = path.join(projectPath, 'README.md');
+    // Don't overwrite existing README
+    if (await fs.pathExists(readmePath)) {
+        return;
+    }
+    const content = `# ${projectName} Specifications
+
+## Overview
+
+This folder contains specifications for the ${projectName} project.
+
+## Azure DevOps
+
+- Organization: ${process.env.AZURE_DEVOPS_ORG || 'TBD'}
+- Project: ${projectName}
+- URL: https://dev.azure.com/${process.env.AZURE_DEVOPS_ORG || 'org'}/${projectName}
+
+## Specifications
+
+_No specifications yet. Specs will appear here as they are created._
+
+## Team
+
+- Lead: TBD
+- Members: TBD
+
+## Keywords
+
+${PROJECT_KEYWORDS[projectName]?.join(', ') || 'TBD'}
+
+## Getting Started
+
+1. Create a new spec: \`/specweave:increment "feature-name"\`
+2. Specs will be organized here automatically
+3. Sync to Azure DevOps: \`/specweave-ado:sync-spec spec-001\`
+
+---
+
+_Generated by SpecWeave_
+`;
+    await fs.writeFile(readmePath, content);
+}
+//# sourceMappingURL=ado-project-detector.js.map

package/dist/plugins/specweave-ado/lib/ado-project-detector.js.map

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

package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Azure DevOps Spec Commit Sync
+ *
+ * Posts commit/PR comments to ADO work items linked to living docs specs.
+ * This enables traceability from spec user stories to actual code changes.
+ */
+import { AdoClientV2 } from './ado-client-v2.js';
+import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
+import { UserStory } from '../../../src/core/spec-task-mapper.js';
+export interface SyncOptions {
+    incrementPath: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    commentsPosted: number;
+    errors: string[];
+    commits: GitCommit[];
+    userStories: UserStory[];
+}
+/**
+ * Sync commits for completed user stories to ADO work item
+ */
+export declare function syncSpecCommitsToAdo(client: AdoClientV2, options: SyncOptions): Promise<SyncResult>;
+/**
+ * Post batch commit update to ADO work item
+ */
+export declare function postCommitBatchUpdate(client: AdoClientV2, incrementPath: string, commits: GitCommit[], workItemId: number, repo: GitRepository, dryRun?: boolean): Promise<boolean>;
+/**
+ * Check if spec commit sync is enabled in config
+ */
+export declare function isSpecCommitSyncEnabled(projectRoot: string): Promise<boolean>;
+/**
+ * Get ADO work item ID from spec metadata
+ */
+export declare function getAdoWorkItemForSpec(specPath: string): Promise<number | null>;
+//# sourceMappingURL=ado-spec-commit-sync.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-spec-commit-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-spec-commit-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAOL,SAAS,EACT,aAAa,EAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,SAAS,EACV,MAAM,uCAAuC,CAAC;AAY/C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoKrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}