specweave 0.28.68 → 0.29.0

package/dist/src/cli/workers/brownfield-worker.js

@@ -0,0 +1,417 @@
+/**
+ * Brownfield Analysis Worker
+ *
+ * Performs brownfield documentation analysis in phases:
+ * 1. Discovery - Find all code/doc files
+ * 2. Code Analysis - Extract signatures, APIs
+ * 3. Doc Matching - Match code to docs
+ * 4. Discrepancy Detection - Find documentation gaps
+ * 5. Reporting - Generate summary
+ *
+ * Supports pause/resume via checkpoints.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { updateBrownfieldProgress, completeBrownfieldJob, failBrownfieldJob, } from '../../core/background/index.js';
+import { BrownfieldDiscrepancyManager, } from '../../core/discrepancy/index.js';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Brownfield Analysis Worker
+ */
+export class BrownfieldAnalysisWorker {
+    constructor(projectPath, jobId, config, options = {}) {
+        this.projectPath = projectPath;
+        this.jobId = jobId;
+        this.config = config;
+        this.logger = options.logger ?? consoleLogger;
+        this.discrepancyManager = new BrownfieldDiscrepancyManager(projectPath, {
+            logger: this.logger,
+        });
+        this.context = {
+            projectPath,
+            sourceDocsPath: config.sourceDocsPath,
+            depth: config.analysisDepth,
+            codeFiles: [],
+            docFiles: [],
+            modules: [],
+            docs: [],
+        };
+    }
+    /**
+     * Run the brownfield analysis
+     */
+    async run() {
+        const phases = [
+            'discovery',
+            'code-analysis',
+            'doc-matching',
+            'discrepancy-detect',
+            'reporting',
+        ];
+        // Resume from checkpoint if exists
+        const startPhaseIndex = this.config.checkpoint
+            ? phases.indexOf(this.config.checkpoint.phase)
+            : 0;
+        let discrepancyCount = 0;
+        try {
+            for (let i = startPhaseIndex; i < phases.length; i++) {
+                const phase = phases[i];
+                this.logger.log(`Starting phase: ${phase}`);
+                updateBrownfieldProgress(this.projectPath, this.jobId, phase, 0, 100);
+                switch (phase) {
+                    case 'discovery':
+                        await this.runDiscoveryPhase();
+                        break;
+                    case 'code-analysis':
+                        await this.runCodeAnalysisPhase();
+                        break;
+                    case 'doc-matching':
+                        await this.runDocMatchingPhase();
+                        break;
+                    case 'discrepancy-detect':
+                        discrepancyCount = await this.runDiscrepancyDetectionPhase();
+                        break;
+                    case 'reporting':
+                        await this.runReportingPhase(discrepancyCount);
+                        break;
+                }
+                updateBrownfieldProgress(this.projectPath, this.jobId, phase, 100, 100);
+                this.logger.log(`Completed phase: ${phase}`);
+            }
+            completeBrownfieldJob(this.projectPath, this.jobId, discrepancyCount);
+            return discrepancyCount;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            this.logger.error('Brownfield analysis failed:', error);
+            failBrownfieldJob(this.projectPath, this.jobId, errorMsg);
+            throw error;
+        }
+    }
+    /**
+     * Phase 1: Discovery - Find all code and documentation files
+     */
+    async runDiscoveryPhase() {
+        this.logger.log('Discovering files...');
+        // Find code files
+        this.context.codeFiles = this.findFiles(this.projectPath, [
+            '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+        ], ['code']);
+        // Find documentation files
+        const docPaths = this.context.sourceDocsPath
+            ? [path.join(this.projectPath, this.context.sourceDocsPath)]
+            : [this.projectPath];
+        for (const docPath of docPaths) {
+            if (fs.existsSync(docPath)) {
+                this.context.docFiles.push(...this.findFiles(docPath, [
+                    '.md', '.mdx', '.rst', '.txt',
+                ], ['doc']));
+            }
+        }
+        this.logger.log(`Found ${this.context.codeFiles.length} code files`);
+        this.logger.log(`Found ${this.context.docFiles.length} doc files`);
+    }
+    /**
+     * Phase 2: Code Analysis - Extract exports and signatures
+     */
+    async runCodeAnalysisPhase() {
+        this.logger.log('Analyzing code...');
+        // Group files by directory to form modules
+        const moduleMap = new Map();
+        for (const file of this.context.codeFiles) {
+            const dir = path.dirname(file.relativePath);
+            if (!moduleMap.has(dir)) {
+                moduleMap.set(dir, []);
+            }
+            moduleMap.get(dir).push(file);
+        }
+        // Analyze each module
+        for (const [modulePath, files] of moduleMap.entries()) {
+            const module = this.analyzeModule(modulePath, files);
+            if (module) {
+                this.context.modules.push(module);
+            }
+        }
+        this.logger.log(`Analyzed ${this.context.modules.length} modules`);
+    }
+    /**
+     * Phase 3: Doc Matching - Match docs to code modules
+     */
+    async runDocMatchingPhase() {
+        this.logger.log('Matching documentation...');
+        for (const docFile of this.context.docFiles) {
+            const docInfo = this.parseDocFile(docFile);
+            if (docInfo) {
+                this.context.docs.push(docInfo);
+            }
+        }
+        this.logger.log(`Parsed ${this.context.docs.length} doc files`);
+    }
+    /**
+     * Phase 4: Discrepancy Detection - Find documentation gaps
+     */
+    async runDiscrepancyDetectionPhase() {
+        this.logger.log('Detecting discrepancies...');
+        await this.discrepancyManager.ensureFolderStructure();
+        const discrepancies = [];
+        // Detect undocumented exports
+        for (const module of this.context.modules) {
+            const undocumented = module.exports.filter(e => !e.hasDocComment);
+            if (undocumented.length > 0) {
+                discrepancies.push({
+                    type: 'missing-docs',
+                    module: module.name,
+                    codeLocation: `${module.path}`,
+                    summary: `${undocumented.length} undocumented exports in ${module.name}`,
+                    details: `The following exports lack documentation:\n${undocumented.map(e => `- ${e.name} (${e.type})`).join('\n')}`,
+                    evidence: {
+                        codeSnippet: undocumented.slice(0, 5).map(e => e.signature || e.name).join('\n'),
+                    },
+                    priority: this.calculatePriority(undocumented.length, module.exports.length),
+                    confidence: 90,
+                    autoDetected: true,
+                    status: 'pending',
+                    detectedAt: new Date().toISOString(),
+                    detectedBy: 'brownfield-analyzer',
+                    lastChecked: new Date().toISOString(),
+                });
+            }
+        }
+        // Detect modules without any docs
+        const modulesWithoutDocs = this.context.modules.filter(m => {
+            const moduleName = m.name.toLowerCase();
+            return !this.context.docs.some(d => d.relativePath.toLowerCase().includes(moduleName) ||
+                d.topics.some(t => t.toLowerCase().includes(moduleName)));
+        });
+        for (const module of modulesWithoutDocs) {
+            discrepancies.push({
+                type: 'missing-docs',
+                module: module.name,
+                codeLocation: module.path,
+                summary: `No documentation found for module: ${module.name}`,
+                details: `Module ${module.name} has ${module.exports.length} exports but no matching documentation file.`,
+                evidence: {},
+                priority: 'medium',
+                confidence: 75,
+                autoDetected: true,
+                status: 'pending',
+                detectedAt: new Date().toISOString(),
+                detectedBy: 'brownfield-analyzer',
+                lastChecked: new Date().toISOString(),
+            });
+        }
+        // Create discrepancies in batch
+        if (discrepancies.length > 0) {
+            await this.discrepancyManager.createBatch(discrepancies);
+        }
+        this.logger.log(`Detected ${discrepancies.length} discrepancies`);
+        return discrepancies.length;
+    }
+    /**
+     * Phase 5: Reporting - Generate summary
+     */
+    async runReportingPhase(discrepancyCount) {
+        this.logger.log('Generating report...');
+        const stats = await this.discrepancyManager.getStats();
+        const report = {
+            generatedAt: new Date().toISOString(),
+            analysisDepth: this.context.depth,
+            codebase: {
+                codeFiles: this.context.codeFiles.length,
+                docFiles: this.context.docFiles.length,
+                modules: this.context.modules.length,
+            },
+            discrepancies: {
+                total: discrepancyCount,
+                byType: stats.byType,
+                byPriority: stats.byPriority,
+            },
+            recommendations: this.generateRecommendations(stats),
+        };
+        // Save report
+        const reportPath = path.join(this.projectPath, '.specweave', 'discrepancies', 'latest-report.json');
+        fs.writeFileSync(reportPath, JSON.stringify(report, null, 2));
+        this.logger.log(`Report saved to ${reportPath}`);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Helper methods
+    // ─────────────────────────────────────────────────────────────
+    findFiles(dir, extensions, types, maxDepth = 10) {
+        const files = [];
+        this.walkDir(dir, extensions, files, '', maxDepth, types[0]);
+        return files;
+    }
+    walkDir(dir, extensions, files, relativePath, depth, type) {
+        if (depth <= 0)
+            return;
+        if (!fs.existsSync(dir))
+            return;
+        // Skip common non-code directories
+        const skipDirs = ['node_modules', '.git', '.specweave', 'dist', 'build', 'coverage'];
+        const dirName = path.basename(dir);
+        if (skipDirs.includes(dirName))
+            return;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = path.join(relativePath, entry.name);
+                if (entry.isDirectory()) {
+                    this.walkDir(fullPath, extensions, files, relPath, depth - 1, type);
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name).toLowerCase();
+                    if (extensions.includes(ext)) {
+                        const stats = fs.statSync(fullPath);
+                        files.push({
+                            path: fullPath,
+                            relativePath: relPath,
+                            type,
+                            extension: ext,
+                            size: stats.size,
+                            lastModified: stats.mtime,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore permission errors
+        }
+    }
+    analyzeModule(modulePath, files) {
+        const exports = [];
+        let lastModified = new Date(0);
+        for (const file of files) {
+            if (file.lastModified > lastModified) {
+                lastModified = file.lastModified;
+            }
+            // Quick analysis: look for export statements
+            try {
+                const content = fs.readFileSync(file.path, 'utf-8');
+                const fileExports = this.extractExports(content, file);
+                exports.push(...fileExports);
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+        if (exports.length === 0 && this.context.depth === 'quick') {
+            return null;
+        }
+        return {
+            name: modulePath || 'root',
+            path: modulePath,
+            exports,
+            hasTests: files.some(f => f.relativePath.includes('.test.') || f.relativePath.includes('.spec.')),
+            lastModified,
+        };
+    }
+    extractExports(content, file) {
+        const exports = [];
+        const lines = content.split('\n');
+        // Simple regex patterns for exports
+        const exportPatterns = [
+            { regex: /export\s+(?:async\s+)?function\s+(\w+)/g, type: 'function' },
+            { regex: /export\s+class\s+(\w+)/g, type: 'class' },
+            { regex: /export\s+(?:type|interface)\s+(\w+)/g, type: 'type' },
+            { regex: /export\s+const\s+(\w+)/g, type: 'const' },
+            { regex: /export\s+\{\s*([^}]+)\s*\}/g, type: 'variable' },
+        ];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            for (const pattern of exportPatterns) {
+                const matches = line.matchAll(pattern.regex);
+                for (const match of matches) {
+                    const name = match[1].trim();
+                    // Check if previous line has doc comment
+                    const hasDocComment = i > 0 && (lines[i - 1].trim().startsWith('*/') ||
+                        lines[i - 1].trim().startsWith('* ') ||
+                        lines[i - 1].trim().startsWith('//'));
+                    if (pattern.type === 'variable') {
+                        // Handle export { a, b, c }
+                        const names = name.split(',').map(n => n.trim().split(' ')[0]);
+                        for (const n of names) {
+                            if (n && !n.includes('type')) {
+                                exports.push({
+                                    name: n,
+                                    type: 'variable',
+                                    line: i + 1,
+                                    hasDocComment: false, // Can't easily detect for re-exports
+                                });
+                            }
+                        }
+                    }
+                    else {
+                        exports.push({
+                            name,
+                            type: pattern.type,
+                            line: i + 1,
+                            hasDocComment,
+                            signature: line.trim().slice(0, 100),
+                        });
+                    }
+                }
+            }
+        }
+        return exports;
+    }
+    parseDocFile(file) {
+        try {
+            const content = fs.readFileSync(file.path, 'utf-8');
+            // Extract title (first heading)
+            const titleMatch = content.match(/^#\s+(.+)$/m);
+            const title = titleMatch?.[1];
+            // Extract topics (other headings)
+            const headingMatches = content.matchAll(/^#{2,}\s+(.+)$/gm);
+            const topics = Array.from(headingMatches).map(m => m[1]);
+            // Word count
+            const wordCount = content.split(/\s+/).length;
+            return {
+                path: file.path,
+                relativePath: file.relativePath,
+                title,
+                topics,
+                lastModified: file.lastModified,
+                wordCount,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    calculatePriority(undocumentedCount, totalCount) {
+        const ratio = undocumentedCount / totalCount;
+        if (ratio > 0.8 && undocumentedCount > 5)
+            return 'critical';
+        if (ratio > 0.5 && undocumentedCount > 3)
+            return 'high';
+        if (ratio > 0.3)
+            return 'medium';
+        return 'low';
+    }
+    generateRecommendations(stats) {
+        const recommendations = [];
+        if (stats.byType['missing-docs'] > 10) {
+            recommendations.push('Consider creating a documentation sprint to address missing docs');
+        }
+        if (stats.byType['stale-docs'] > 5) {
+            recommendations.push('Review and update stale documentation');
+        }
+        if (stats.byPriority.critical > 0) {
+            recommendations.push('Address critical discrepancies first - they may impact onboarding');
+        }
+        if (stats.total > 50) {
+            recommendations.push('Consider using /specweave:discrepancy-to-increment to batch discrepancies');
+        }
+        return recommendations;
+    }
+}
+/**
+ * Run brownfield analysis for a job
+ */
+export async function runBrownfieldAnalysis(projectPath, jobId, config, options = {}) {
+    const worker = new BrownfieldAnalysisWorker(projectPath, jobId, config, options);
+    return worker.run();
+}
+//# sourceMappingURL=brownfield-worker.js.map

package/dist/src/cli/workers/brownfield-worker.js.map

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

package/dist/src/core/background/brownfield-launcher.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Brownfield Analysis Job Launcher
+ *
+ * Launches brownfield documentation analysis as a background job.
+ * Supports long-running analysis of large codebases (1000+ files).
+ */
+import { BackgroundJob, BrownfieldPhase } from './types.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Options for launching brownfield analysis
+ */
+export interface BrownfieldLaunchOptions {
+    projectPath: string;
+    sourceDocsPath?: string;
+    analysisDepth: 'quick' | 'standard' | 'deep';
+    logger?: Logger;
+}
+/**
+ * Result of launching a brownfield job
+ */
+export interface BrownfieldLaunchResult {
+    success: boolean;
+    jobId: string;
+    message: string;
+}
+/**
+ * Load job state from filesystem
+ */
+export declare function loadJobState(projectPath: string, jobId: string): BackgroundJob | null;
+/**
+ * List all brownfield jobs for a project
+ */
+export declare function listBrownfieldJobs(projectPath: string): BackgroundJob[];
+/**
+ * Get the most recent active brownfield job
+ */
+export declare function getActiveBrownfieldJob(projectPath: string): BackgroundJob | null;
+/**
+ * Update job progress
+ */
+export declare function updateJobProgress(projectPath: string, jobId: string, phase: BrownfieldPhase, current: number, total: number, currentItem?: string): void;
+/**
+ * Brownfield completion statistics
+ */
+export interface BrownfieldCompletionStats {
+    discrepancyCount: number;
+    filesAnalyzed: number;
+    modulesDetected: number;
+    byType: Record<string, number>;
+    byPriority: Record<string, number>;
+    durationMs: number;
+}
+/**
+ * Mark job as completed with full statistics
+ */
+export declare function completeJob(projectPath: string, jobId: string, discrepancyCount: number, stats?: BrownfieldCompletionStats): void;
+/**
+ * Format completion notification for display
+ */
+export declare function formatCompletionNotification(jobId: string, stats: BrownfieldCompletionStats): string;
+/**
+ * Mark job as failed
+ */
+export declare function failJob(projectPath: string, jobId: string, error: string): void;
+/**
+ * Pause a running job
+ */
+export declare function pauseJob(projectPath: string, jobId: string): boolean;
+/**
+ * Launch brownfield analysis as a background job
+ *
+ * Note: In the current implementation, this creates the job state
+ * but the actual analysis is performed by the brownfield-worker
+ * which is invoked separately. For now, this sets up the job
+ * for future integration with a proper background process system.
+ */
+export declare function launchBrownfieldAnalysisJob(options: BrownfieldLaunchOptions): Promise<BrownfieldLaunchResult>;
+/**
+ * Resume a paused job
+ */
+export declare function resumeJob(projectPath: string, jobId: string): boolean;
+/**
+ * Delete a job and its state
+ */
+export declare function deleteJob(projectPath: string, jobId: string): boolean;
+//# sourceMappingURL=brownfield-launcher.d.ts.map

package/dist/src/core/background/brownfield-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brownfield-launcher.d.ts","sourceRoot":"","sources":["../../../../src/core/background/brownfield-launcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,aAAa,EAEb,eAAe,EAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAqDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWrF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBvE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAgCN;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,yBAAyB,GAChC,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,yBAAyB,GAC/B,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS/E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASpE;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA8BjC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASrE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAUrE"}