specweave 0.29.2 → 0.30.1

package/dist/src/core/living-docs/module-analyzer.js

@@ -0,0 +1,427 @@
+/**
+ * Module Analyzer - Deep Dive Phase for Living Docs Builder
+ *
+ * Analyzes individual modules to generate detailed documentation:
+ * 1. Select representative files based on sampling config
+ * 2. Extract exports, types, and dependencies
+ * 3. Generate module summary and documentation
+ *
+ * This is a SKELETON implementation - full LLM integration deferred.
+ */
+import * as fs from '../../utils/fs-native.js';
+import * as path from 'path';
+import { selectRepresentativeFiles } from './discovery.js';
+/**
+ * Analyze a single module
+ */
+export async function analyzeModule(projectPath, module, samplingConfig, workItemMatches, onProgress) {
+    const modulePath = path.join(projectPath, module.path);
+    // Get files to analyze based on sampling config
+    const allFiles = getModuleFiles(modulePath);
+    const filesToAnalyze = selectRepresentativeFiles(allFiles, samplingConfig.filesPerDir, module.name);
+    const analyzedFiles = [];
+    const allImports = new Set();
+    const externalDeps = new Set();
+    const internalDeps = new Set();
+    let totalExports = 0;
+    // Analyze each file
+    for (let i = 0; i < filesToAnalyze.length; i++) {
+        onProgress?.(module.name, i + 1, filesToAnalyze.length);
+        const filePath = filesToAnalyze[i];
+        const analysis = await analyzeFile(projectPath, modulePath, filePath);
+        if (analysis) {
+            analyzedFiles.push(analysis);
+            totalExports += analysis.exports.length;
+            // Collect dependencies
+            for (const imp of analysis.imports) {
+                allImports.add(imp.from);
+                if (imp.isExternal) {
+                    // Extract package name (handle scoped packages)
+                    const pkgName = imp.from.startsWith('@')
+                        ? imp.from.split('/').slice(0, 2).join('/')
+                        : imp.from.split('/')[0];
+                    externalDeps.add(pkgName);
+                }
+                else {
+                    // Check if it references another module
+                    const normalizedPath = normalizeImportPath(module.path, imp.from);
+                    const depModule = findModuleForPath(normalizedPath);
+                    if (depModule && depModule !== module.name) {
+                        internalDeps.add(depModule);
+                    }
+                }
+            }
+        }
+    }
+    // Generate summary (placeholder - LLM integration deferred)
+    const summary = generatePlaceholderSummary(module, analyzedFiles, totalExports);
+    return {
+        moduleName: module.name,
+        modulePath: module.path,
+        analyzedAt: new Date().toISOString(),
+        filesAnalyzed: analyzedFiles,
+        filesSkipped: allFiles.length - filesToAnalyze.length,
+        totalExports,
+        externalDeps: [...externalDeps],
+        internalDeps: [...internalDeps],
+        relatedWorkItems: workItemMatches.map(m => ({
+            id: m.workItem.id,
+            title: m.workItem.title,
+            score: m.score
+        })),
+        summary,
+        docStatus: analyzedFiles.length > 0 ? 'generated' : 'skipped'
+    };
+}
+/**
+ * Get all files in a module directory
+ */
+function getModuleFiles(modulePath) {
+    const files = [];
+    if (!fs.existsSync(modulePath)) {
+        return files;
+    }
+    function scanDir(dir, prefix = '') {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                // Skip common non-source directories
+                if (!['node_modules', 'dist', 'build', '.git', '__pycache__'].includes(entry.name)) {
+                    scanDir(fullPath, relativePath);
+                }
+            }
+            else if (entry.isFile()) {
+                // Only include source files
+                if (isSourceFile(entry.name)) {
+                    files.push(relativePath);
+                }
+            }
+        }
+    }
+    scanDir(modulePath);
+    return files;
+}
+/**
+ * Check if a file is a source file
+ */
+function isSourceFile(filename) {
+    const sourceExtensions = [
+        '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+        '.py', '.go', '.rs', '.java', '.kt', '.swift',
+        '.rb', '.php', '.cs', '.cpp', '.c', '.h'
+    ];
+    return sourceExtensions.some(ext => filename.endsWith(ext));
+}
+/**
+ * Analyze a single file
+ */
+async function analyzeFile(projectPath, modulePath, relativePath) {
+    const fullPath = path.join(modulePath, relativePath);
+    if (!fs.existsSync(fullPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        const stats = fs.statSync(fullPath);
+        const lines = content.split('\n');
+        // Determine file type
+        const type = getFileType(relativePath);
+        // Extract exports and imports based on file extension
+        const ext = path.extname(relativePath);
+        let exports = [];
+        let imports = [];
+        if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
+            exports = extractJsExports(content);
+            imports = extractJsImports(content);
+        }
+        else if (ext === '.py') {
+            exports = extractPythonExports(content);
+            imports = extractPythonImports(content);
+        }
+        // Add more language support as needed
+        return {
+            path: relativePath,
+            size: stats.size,
+            type,
+            exports,
+            imports,
+            lineCount: lines.length
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get file type from path
+ */
+function getFileType(filePath) {
+    const name = path.basename(filePath).toLowerCase();
+    if (name.includes('.test.') || name.includes('.spec.') || filePath.includes('__tests__')) {
+        return 'test';
+    }
+    if (name.includes('config') || name.includes('rc.') || name === '.env') {
+        return 'config';
+    }
+    if (name.endsWith('.md') || name.endsWith('.rst') || name.endsWith('.txt')) {
+        return 'doc';
+    }
+    return 'source';
+}
+/**
+ * Extract exports from JavaScript/TypeScript
+ */
+function extractJsExports(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // export default
+        if (/^\s*export\s+default\s+/.test(line)) {
+            const match = line.match(/export\s+default\s+(class|function|const)?\s*(\w+)?/);
+            exports.push({
+                name: match?.[2] || 'default',
+                type: match?.[1] || 'default',
+                isDefault: true,
+                line: i + 1
+            });
+        }
+        // export const/let/var
+        else if (/^\s*export\s+(const|let|var)\s+/.test(line)) {
+            const match = line.match(/export\s+(?:const|let|var)\s+(\w+)/);
+            if (match) {
+                exports.push({
+                    name: match[1],
+                    type: 'const',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+        // export function
+        else if (/^\s*export\s+(?:async\s+)?function\s+/.test(line)) {
+            const match = line.match(/export\s+(?:async\s+)?function\s+(\w+)/);
+            if (match) {
+                exports.push({
+                    name: match[1],
+                    type: 'function',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+        // export class
+        else if (/^\s*export\s+class\s+/.test(line)) {
+            const match = line.match(/export\s+class\s+(\w+)/);
+            if (match) {
+                exports.push({
+                    name: match[1],
+                    type: 'class',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+        // export interface
+        else if (/^\s*export\s+interface\s+/.test(line)) {
+            const match = line.match(/export\s+interface\s+(\w+)/);
+            if (match) {
+                exports.push({
+                    name: match[1],
+                    type: 'interface',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+        // export type
+        else if (/^\s*export\s+type\s+/.test(line)) {
+            const match = line.match(/export\s+type\s+(\w+)/);
+            if (match) {
+                exports.push({
+                    name: match[1],
+                    type: 'type',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * Extract imports from JavaScript/TypeScript
+ */
+function extractJsImports(content) {
+    const imports = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        // import { x, y } from 'module'
+        // import x from 'module'
+        // import * as x from 'module'
+        const match = line.match(/^\s*import\s+(?:(?:\{([^}]+)\}|(\w+)|\*\s+as\s+(\w+))(?:\s*,\s*)?)+\s*from\s*['"]([^'"]+)['"]/);
+        if (match) {
+            const from = match[4];
+            const isExternal = !from.startsWith('.') && !from.startsWith('/');
+            // Collect named imports
+            const names = [];
+            if (match[1]) {
+                names.push(...match[1].split(',').map(n => n.trim().split(' ')[0]));
+            }
+            if (match[2]) {
+                names.push(match[2]);
+            }
+            if (match[3]) {
+                names.push(match[3]);
+            }
+            imports.push({ from, isExternal, names });
+        }
+    }
+    return imports;
+}
+/**
+ * Extract exports from Python
+ */
+function extractPythonExports(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // def function_name
+        if (/^def\s+\w+/.test(line)) {
+            const match = line.match(/^def\s+(\w+)/);
+            if (match && !match[1].startsWith('_')) {
+                exports.push({
+                    name: match[1],
+                    type: 'function',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+        // class ClassName
+        else if (/^class\s+\w+/.test(line)) {
+            const match = line.match(/^class\s+(\w+)/);
+            if (match && !match[1].startsWith('_')) {
+                exports.push({
+                    name: match[1],
+                    type: 'class',
+                    isDefault: false,
+                    line: i + 1
+                });
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * Extract imports from Python
+ */
+function extractPythonImports(content) {
+    const imports = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        // from module import x, y
+        const fromMatch = line.match(/^from\s+([^\s]+)\s+import\s+(.+)/);
+        if (fromMatch) {
+            const from = fromMatch[1];
+            const isExternal = !from.startsWith('.');
+            const names = fromMatch[2].split(',').map(n => n.trim().split(' ')[0]);
+            imports.push({ from, isExternal, names });
+        }
+        // import module
+        const importMatch = line.match(/^import\s+([^\s,]+)/);
+        if (importMatch && !fromMatch) {
+            const from = importMatch[1];
+            const isExternal = !from.startsWith('.');
+            imports.push({ from, isExternal, names: [from.split('.')[0]] });
+        }
+    }
+    return imports;
+}
+/**
+ * Normalize import path to module path
+ */
+function normalizeImportPath(modulePath, importPath) {
+    if (!importPath.startsWith('.')) {
+        return importPath;
+    }
+    const parts = modulePath.split('/');
+    const importParts = importPath.split('/');
+    for (const part of importParts) {
+        if (part === '..') {
+            parts.pop();
+        }
+        else if (part !== '.') {
+            parts.push(part);
+        }
+    }
+    return parts.join('/');
+}
+/**
+ * Find module name for a path (simplified)
+ */
+function findModuleForPath(normalizedPath) {
+    // Extract first directory segment as module name
+    const parts = normalizedPath.split('/').filter(p => p && p !== 'src');
+    return parts[0] || null;
+}
+/**
+ * Generate placeholder summary (no LLM)
+ */
+function generatePlaceholderSummary(module, analyzedFiles, totalExports) {
+    const sourceFiles = analyzedFiles.filter(f => f.type === 'source');
+    const testFiles = analyzedFiles.filter(f => f.type === 'test');
+    const lines = [
+        `## ${module.name}`,
+        '',
+        `**Path**: \`${module.path}\``,
+        '',
+        '### Overview',
+        '',
+        `The ${module.name} module contains ${module.fileCount} files with approximately ${module.estimatedLOC.toLocaleString()} lines of code.`,
+        '',
+        '### Analysis Summary',
+        '',
+        `- **Files Analyzed**: ${analyzedFiles.length}`,
+        `- **Source Files**: ${sourceFiles.length}`,
+        `- **Test Files**: ${testFiles.length}`,
+        `- **Total Exports**: ${totalExports}`,
+        ''
+    ];
+    // Top exports
+    if (totalExports > 0) {
+        lines.push('### Main Exports');
+        lines.push('');
+        const allExports = analyzedFiles.flatMap(f => f.exports);
+        const topExports = allExports.slice(0, 10);
+        for (const exp of topExports) {
+            lines.push(`- \`${exp.name}\` (${exp.type})`);
+        }
+        if (allExports.length > 10) {
+            lines.push(`- ...and ${allExports.length - 10} more exports`);
+        }
+        lines.push('');
+    }
+    lines.push('### Documentation Status');
+    lines.push('');
+    lines.push(`**Has README**: ${module.hasReadme ? 'Yes' : 'No'}`);
+    lines.push(`**Has Tests**: ${module.hasTests ? 'Yes' : 'No'}`);
+    lines.push('');
+    lines.push('---');
+    lines.push(`*Analysis generated on ${new Date().toISOString().split('T')[0]}*`);
+    return lines.join('\n');
+}
+/**
+ * Save module analysis to disk
+ */
+export async function saveModuleAnalysis(projectPath, analysis) {
+    const outputDir = path.join(projectPath, '.specweave', 'docs', 'internal', 'modules');
+    fs.ensureDirSync(outputDir);
+    const outputPath = path.join(outputDir, `${analysis.moduleName}.md`);
+    fs.writeFileSync(outputPath, analysis.summary);
+    return outputPath;
+}
+//# sourceMappingURL=module-analyzer.js.map

package/dist/src/core/living-docs/module-analyzer.js.map

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

package/dist/src/core/living-docs/suggestions-generator.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Suggestions Generator - Final Phase of Living Docs Builder
+ *
+ * Produces actionable SUGGESTIONS.md with:
+ * 1. Summary statistics of documentation status
+ * 2. Priority zones based on work item density
+ * 3. Immediate actions with specific file paths
+ * 4. Gap analysis between modules and documentation
+ */
+import type { DiscoveryResult } from './discovery.js';
+import type { ModuleAnalysis } from './module-analyzer.js';
+import type { WorkItemMatchResult } from './workitem-matcher.js';
+import type { LivingDocsUserInputs } from '../background/types.js';
+/**
+ * Documentation status per module
+ */
+export interface ModuleDocStatus {
+    /** Module name */
+    moduleName: string;
+    /** Module path */
+    modulePath: string;
+    /** Has README */
+    hasReadme: boolean;
+    /** Has generated analysis */
+    hasAnalysis: boolean;
+    /** Doc coverage estimate (0-100) */
+    coverage: number;
+    /** Work item count */
+    workItemCount: number;
+    /** Priority level */
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    /** Status */
+    status: 'complete' | 'partial' | 'none';
+}
+/**
+ * Priority zone for focused documentation
+ */
+export interface PriorityZone {
+    /** Zone name (module name) */
+    name: string;
+    /** Zone path */
+    path: string;
+    /** Work item count */
+    workItems: number;
+    /** Documentation status */
+    docStatus: 'complete' | 'partial' | 'none';
+    /** Suggested action */
+    action: string;
+    /** Files to focus on */
+    focusFiles: string[];
+}
+/**
+ * Immediate action item
+ */
+export interface ImmediateAction {
+    /** Priority (1 = highest) */
+    priority: number;
+    /** Module name */
+    module: string;
+    /** Action description */
+    action: string;
+    /** Specific file paths */
+    files: string[];
+    /** Reason */
+    reason: string;
+}
+/**
+ * Suggestions report
+ */
+export interface SuggestionsReport {
+    /** Generation timestamp */
+    generatedAt: string;
+    /** Summary statistics */
+    summary: {
+        totalModules: number;
+        modulesDocumented: number;
+        modulesPartial: number;
+        modulesUndocumented: number;
+        totalWorkItems: number;
+        matchedWorkItems: number;
+        coveragePercent: number;
+    };
+    /** Priority zones */
+    priorityZones: PriorityZone[];
+    /** Immediate actions */
+    immediateActions: ImmediateAction[];
+    /** Module status details */
+    moduleStatuses: ModuleDocStatus[];
+    /** Additional sources processed */
+    additionalSources: string[];
+    /** Directories not fully analyzed */
+    notAnalyzed: Array<{
+        path: string;
+        reason: string;
+        filesSkipped: number;
+    }>;
+    /** User pain points addressed */
+    painPointsAddressed: string[];
+}
+/**
+ * Generate suggestions from all analysis data
+ */
+export declare function generateSuggestions(projectPath: string, discovery: DiscoveryResult, moduleAnalyses: Map<string, ModuleAnalysis>, matchResult: WorkItemMatchResult, userInputs: LivingDocsUserInputs): Promise<SuggestionsReport>;
+/**
+ * Format suggestions report as markdown
+ */
+export declare function formatSuggestionsMarkdown(report: SuggestionsReport): string;
+/**
+ * Save suggestions report to disk
+ */
+export declare function saveSuggestionsReport(projectPath: string, report: SuggestionsReport): Promise<string>;
+//# sourceMappingURL=suggestions-generator.d.ts.map

package/dist/src/core/living-docs/suggestions-generator.d.ts.map

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