sdd-mcp-server 1.3.10 → 1.4.0

package/dist/utils/specGenerator.js

@@ -0,0 +1,259 @@
+import { analyzeProject } from './documentGenerator.js';
+export async function generateRequirementsDocument(projectPath, featureName) {
+    const analysis = await analyzeProject(projectPath);
+    const desc = analysis.description || 'Feature requirements specification';
+    const obj = generateCoreObjective(analysis);
+    const acceptance = generateAcceptanceCriteria(analysis)
+        .map((c, i) => `${i + 1}. ${c}`)
+        .join('\n');
+    return `# Requirements Document
+
+## Introduction
+${featureName} - Requirements derived from codebase analysis.
+
+**Project**: ${analysis.name}  
+**Description**: ${desc}
+
+Generated on: ${new Date().toISOString()}
+
+## Functional Requirements
+
+### FR-1: Core Functionality
+**Objective:** ${obj}
+
+#### Acceptance Criteria
+${acceptance}
+
+### FR-2: Technology Integration
+**Objective:** Integrate with the detected technology stack
+
+#### Acceptance Criteria
+${generateTechRequirements(analysis).map((r, i) => `${i + 1}. ${r}`).join('\n')}
+
+### FR-3: Quality Standards
+**Objective:** Meet quality, testing, and review standards
+
+#### Acceptance Criteria
+${generateQualityRequirements(analysis).map((r, i) => `${i + 1}. ${r}`).join('\n')}
+
+## Non-Functional Requirements
+
+### NFR-1: Performance
+- System SHALL respond within acceptable time limits
+- Memory usage SHALL remain within reasonable bounds
+
+### NFR-2: Reliability
+- System SHALL handle errors gracefully
+- System SHALL maintain data integrity
+
+### NFR-3: Maintainability
+- Code SHALL follow established conventions
+- System SHALL be well-documented
+`;
+}
+export async function generateDesignDocument(projectPath, featureName) {
+    const analysis = await analyzeProject(projectPath);
+    const arch = describeArchitecture(analysis);
+    const components = generateComponentList(analysis).map(c => `- **${c.name}**: ${c.description}`).join('\n');
+    const dataModels = generateDataModels(analysis).map(m => `- **${m}**: Data structure definition`).join('\n');
+    const techStack = generateDetailedTechStack(analysis);
+    return `# Technical Design Document
+
+## Project: ${featureName}
+
+**Project Name:** ${analysis.name}
+**Architecture:** ${analysis.architecture}
+**Language:** ${analysis.language}
+
+Generated on: ${new Date().toISOString()}
+
+## Architecture Overview
+
+### System Architecture
+${arch}
+
+### Key Components
+${components}
+
+### Data Models
+${dataModels}
+
+## Implementation Details
+
+### Technology Stack
+${techStack}
+
+### Dependencies
+${generateDependencySummary(analysis)}
+
+## Interface Specifications
+
+### Module Interfaces
+${generateModuleInterfaces(analysis)}
+
+## Configuration
+
+### Environment Variables
+${generateEnvVars(analysis)}
+
+### Build Configuration
+${generateBuildConfig(analysis)}
+`;
+}
+export async function generateTasksDocument(projectPath, featureName) {
+    const analysis = await analyzeProject(projectPath);
+    const tasks = generateImplementationTasks(analysis);
+    const section = (title, list) => list.map((task, idx) => `- [ ] ${idx + 1}. ${task.title}
+  ${task.subtasks.map(s => `  - ${s}`).join('\n')}
+  - _Requirements: ${task.requirements}_`).join('\n\n');
+    return `# Implementation Plan
+
+## Project: ${featureName}
+
+**Project Name:** ${analysis.name}
+**Detected Stack:** ${[analysis.language, analysis.framework || '', analysis.buildTool || ''].filter(Boolean).join(' / ')}
+
+Generated on: ${new Date().toISOString()}
+
+## Development Phase Tasks
+
+${section('Development', tasks.development)}
+
+## Integration Phase Tasks
+
+${section('Integration', tasks.integration)}
+
+## Quality & Testing Tasks
+
+${section('Quality', tasks.quality)}
+`;
+}
+// Helpers derived from TemplateService, reduced and dependency-free
+function generateCoreObjective(analysis) {
+    if (analysis.dependencies?.includes('@modelcontextprotocol/sdk'))
+        return 'Provide MCP tools for spec-driven development workflows';
+    if (analysis.framework === 'Express.js')
+        return 'Expose REST endpoints and middleware for business logic';
+    if (analysis.framework === 'React')
+        return 'Render interactive UI components with state management';
+    return 'Deliver feature-aligned functionality integrated with existing architecture';
+}
+function generateAcceptanceCriteria(analysis) {
+    const criteria = [
+        'WHEN invoked THEN it SHALL execute without runtime errors',
+        'IF input is invalid THEN it SHALL return meaningful errors',
+        'WHILE under typical load IT SHALL meet performance targets'
+    ];
+    if (analysis.testFramework)
+        criteria.push('WHERE tests exist THEY SHALL pass with adequate coverage');
+    if (analysis.language === 'typescript')
+        criteria.push('WHEN type-checking THEN no TypeScript errors SHALL occur');
+    return criteria;
+}
+function generateTechRequirements(analysis) {
+    const out = ['Integrate with existing build and run scripts'];
+    if (analysis.dependencies?.includes('@modelcontextprotocol/sdk'))
+        out.push('Expose MCP-compliant tools over stdio');
+    if (analysis.buildTool)
+        out.push(`Provide build artifacts using ${analysis.buildTool}`);
+    return out;
+}
+function generateQualityRequirements(analysis) {
+    const out = ['Follow project coding conventions', 'Apply error handling and logging'];
+    if (analysis.testFramework)
+        out.push(`Include ${analysis.testFramework} tests for new code`);
+    return out;
+}
+function describeArchitecture(analysis) {
+    if (analysis.architecture === 'Domain-Driven Design (DDD)')
+        return 'Layered DDD: Domain, Application, Infrastructure, Presentation';
+    if (analysis.architecture.includes('API'))
+        return 'REST API with routing, middleware, services, and data access layers';
+    if (analysis.framework === 'MCP SDK')
+        return 'MCP server exposing development tools via stdio protocol';
+    return analysis.architecture || 'Modular architecture with clear separation of concerns';
+}
+function generateComponentList(analysis) {
+    const comps = [];
+    if (analysis.framework === 'MCP SDK') {
+        comps.push({ name: 'MCPServer', description: 'Handles stdio transport and tool registry' });
+        comps.push({ name: 'ToolHandlers', description: 'Implement SDD tools (init, requirements, design, tasks, etc.)' });
+    }
+    if (analysis.architecture.includes('API')) {
+        comps.push({ name: 'Controllers', description: 'HTTP route handlers' });
+        comps.push({ name: 'Services', description: 'Business logic orchestration' });
+    }
+    if (comps.length === 0)
+        comps.push({ name: 'CoreModule', description: 'Primary feature implementation module' });
+    return comps;
+}
+function generateDataModels(analysis) {
+    if (analysis.framework === 'MCP SDK')
+        return ['Tool', 'Request', 'Response'];
+    if (analysis.architecture.includes('API'))
+        return ['RequestDTO', 'ResponseDTO'];
+    return ['Entity', 'ValueObject'];
+}
+function generateDetailedTechStack(analysis) {
+    const parts = [];
+    parts.push(`- Runtime: ${analysis.language === 'typescript' ? 'Node.js (TypeScript)' : 'Node.js (JavaScript)'}`);
+    if (analysis.framework)
+        parts.push(`- Framework: ${analysis.framework}`);
+    if (analysis.buildTool)
+        parts.push(`- Build: ${analysis.buildTool}`);
+    if (analysis.testFramework)
+        parts.push(`- Testing: ${analysis.testFramework}`);
+    return parts.join('\n');
+}
+function generateDependencySummary(analysis) {
+    const deps = (analysis.dependencies || []).slice(0, 10).map((d) => `- ${d}`).join('\n');
+    const dev = (analysis.devDependencies || []).slice(0, 10).map((d) => `- ${d}`).join('\n');
+    return `#### Production\n${deps || '- (none)'}\n\n#### Development\n${dev || '- (none)'}`;
+}
+function generateModuleInterfaces(analysis) {
+    if (analysis.framework === 'MCP SDK') {
+        return `- registerTool(name: string, handler: (args) => Promise<unknown>)\n- connect(transport): Promise<void>`;
+    }
+    if (analysis.architecture.includes('API')) {
+        return `- handle(request): Response\n- service.process(input): Result`;
+    }
+    return `- execute(input): Output`;
+}
+function generateEnvVars(analysis) {
+    const envs = ['NODE_ENV', 'LOG_LEVEL'];
+    if (analysis.framework === 'MCP SDK')
+        envs.push('MCP_MODE');
+    return envs.map(e => `- ${e}`).join('\n');
+}
+function generateBuildConfig(analysis) {
+    if (analysis.buildTool)
+        return `Use ${analysis.buildTool} to emit production artifacts`;
+    return 'Use npm scripts (build/test/lint) defined in package.json';
+}
+function generateImplementationTasks(analysis) {
+    const dev = [
+        { title: 'Set up project scaffolding', subtasks: ['Initialize directories', 'Configure scripts'], requirements: 'FR-1' },
+        { title: 'Implement core feature logic', subtasks: ['Add modules', 'Wire integrations'], requirements: 'FR-1' }
+    ];
+    const integ = [
+        { title: 'Integrate with stack', subtasks: ['Validate build', 'Run dev server'], requirements: 'FR-2' }
+    ];
+    const quality = [
+        { title: 'Add tests and quality checks', subtasks: ['Unit tests', 'Lint/typecheck', 'Quality review'], requirements: 'FR-3' }
+    ];
+    // Tailor tasks if MCP or API
+    if (analysis.framework === 'MCP SDK') {
+        dev.unshift({ title: 'Expose MCP tools', subtasks: ['Register tools', 'Handle stdio transport'], requirements: 'FR-2' });
+    }
+    if (analysis.architecture.includes('API')) {
+        dev.unshift({ title: 'Add HTTP endpoints', subtasks: ['Define routes', 'Implement handlers'], requirements: 'FR-1' });
+    }
+    if (analysis.testFramework) {
+        quality[0].subtasks.unshift(`Set up ${analysis.testFramework}`);
+    }
+    if (analysis.language === 'typescript') {
+        quality[0].subtasks.push('Ensure type safety (tsc)');
+    }
+    return { development: dev, integration: integ, quality };
+}
+//# sourceMappingURL=specGenerator.js.map

package/dist/utils/specGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specGenerator.js","sourceRoot":"","sources":["../../src/utils/specGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,WAAmB,EAAE,WAAmB;IACzF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,IAAI,oCAAoC,CAAC;IAC1E,MAAM,GAAG,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,0BAA0B,CAAC,QAAQ,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;EAGP,WAAW;;eAEE,QAAQ,CAAC,IAAI;mBACT,IAAI;;gBAEP,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;;;iBAKvB,GAAG;;;EAGlB,UAAU;;;;;;EAMV,wBAAwB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;EAM7E,2BAA2B,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;CAejF,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB,EAAE,WAAmB;IACnF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5G,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7G,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAEtD,OAAO;;cAEK,WAAW;;oBAEL,QAAQ,CAAC,IAAI;oBACb,QAAQ,CAAC,YAAY;gBACzB,QAAQ,CAAC,QAAQ;;gBAEjB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;;;EAKtC,IAAI;;;EAGJ,UAAU;;;EAGV,UAAU;;;;;EAKV,SAAS;;;EAGT,yBAAyB,CAAC,QAAQ,CAAC;;;;;EAKnC,wBAAwB,CAAC,QAAQ,CAAC;;;;;EAKlC,eAAe,CAAC,QAAQ,CAAC;;;EAGzB,mBAAmB,CAAC,QAAQ,CAAC;CAC9B,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB,EAAE,WAAmB;IAClF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,IAAwE,EAAE,EAAE,CAC1G,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK;IACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;qBAC5B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;;cAEK,WAAW;;oBAEL,QAAQ,CAAC,IAAI;sBACX,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;;gBAEzG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;;EAItC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;;;;EAIzC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;;;;EAIzC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;CAClC,CAAC;AACF,CAAC;AAED,oEAAoE;AACpE,SAAS,qBAAqB,CAAC,QAAa;IAC1C,IAAI,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,2BAA2B,CAAC;QAAE,OAAO,yDAAyD,CAAC;IACnI,IAAI,QAAQ,CAAC,SAAS,KAAK,YAAY;QAAE,OAAO,yDAAyD,CAAC;IAC1G,IAAI,QAAQ,CAAC,SAAS,KAAK,OAAO;QAAE,OAAO,wDAAwD,CAAC;IACpG,OAAO,6EAA6E,CAAC;AACvF,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAa;IAC/C,MAAM,QAAQ,GAAG;QACf,2DAA2D;QAC3D,4DAA4D;QAC5D,4DAA4D;KAC7D,CAAC;IACF,IAAI,QAAQ,CAAC,aAAa;QAAE,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACtG,IAAI,QAAQ,CAAC,QAAQ,KAAK,YAAY;QAAE,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAClH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAa;IAC7C,MAAM,GAAG,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,2BAA2B,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpH,IAAI,QAAQ,CAAC,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,iCAAiC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACxF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAa;IAChD,MAAM,GAAG,GAAG,CAAC,mCAAmC,EAAE,kCAAkC,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,aAAa;QAAE,GAAG,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,aAAa,qBAAqB,CAAC,CAAC;IAC7F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAa;IACzC,IAAI,QAAQ,CAAC,YAAY,KAAK,4BAA4B;QAAE,OAAO,gEAAgE,CAAC;IACpI,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,qEAAqE,CAAC;IACxH,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,0DAA0D,CAAC;IACxG,OAAO,QAAQ,CAAC,YAAY,IAAI,wDAAwD,CAAC;AAC3F,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAa;IAC1C,MAAM,KAAK,GAAG,EAAkD,CAAC;IACjE,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAAC;IACjH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAa;IACvC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAChF,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAa;IAC9C,MAAM,KAAK,GAAG,EAAc,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACjH,IAAI,QAAQ,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAa;IAC9C,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,oBAAoB,IAAI,IAAI,UAAU,yBAAyB,GAAG,IAAI,UAAU,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAa;IAC7C,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,wGAAwG,CAAC;IAClH,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,+DAA+D,CAAC;IACzE,CAAC;IACD,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,QAAa;IACpC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAa;IACxC,IAAI,QAAQ,CAAC,SAAS;QAAE,OAAO,OAAO,QAAQ,CAAC,SAAS,+BAA+B,CAAC;IACxF,OAAO,2DAA2D,CAAC;AACrE,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAa;IAChD,MAAM,GAAG,GAAG;QACV,EAAE,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE;QACxH,EAAE,KAAK,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE;KAChH,CAAC;IACF,MAAM,KAAK,GAAG;QACZ,EAAE,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE;KACxG,CAAC;IACF,MAAM,OAAO,GAAG;QACd,EAAE,KAAK,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE;KAC9H,CAAC;IAEF,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3H,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,eAAe,EAAE,oBAAoB,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACvC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/documentGenerator.js

@@ -26,13 +26,11 @@ export async function analyzeProject(projectPath) {
     packageManager: 'npm'
   };
 
-  console.log(`Analyzing project at: ${projectPath}`);
 
   try {
     // Check for package.json
     const packageJsonPath = path.join(projectPath, 'package.json');
     if (fs.existsSync(packageJsonPath)) {
-      console.log('Found package.json, parsing...');
       try {
         const packageJsonContent = fs.readFileSync(packageJsonPath, 'utf8');
         const packageJson = JSON.parse(packageJsonContent);
@@ -46,9 +44,7 @@ export async function analyzeProject(projectPath) {
         analysis.devDependencies = Object.keys(packageJson.devDependencies || {});
         analysis.scripts = packageJson.scripts || {};
         
-        console.log(`Extracted: name=${analysis.name}, deps=${analysis.dependencies.length}, devDeps=${analysis.devDependencies.length}`);
       } catch (parseError) {
-        console.log('Error parsing package.json:', parseError.message);
         // Use fallbacks if package.json is malformed
         analysis.name = getDirectoryBasedName(projectPath);
         analysis.description = generateSmartDescription(analysis.name);
@@ -103,17 +99,60 @@ export async function analyzeProject(projectPath) {
         analysis.buildTool = 'Rollup';
       }
     } else {
-      console.log('No package.json found, using directory-based fallbacks');
       // No package.json found, use directory-based fallbacks
       analysis.name = getDirectoryBasedName(projectPath);
       analysis.description = generateSmartDescription(analysis.name);
     }
 
-    // Check for Java/Maven/Gradle projects
+
+
+    // Check for yarn or pnpm
+    if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
+      analysis.packageManager = 'yarn';
+    } else if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
+      analysis.packageManager = 'pnpm';
+    }
+
+    // Scan directory structure
+    const items = fs.readdirSync(projectPath, { withFileTypes: true });
+    for (const item of items) {
+      if (item.isDirectory() && !item.name.startsWith('.') && item.name !== 'node_modules') {
+        analysis.directories.push(item.name);
+
+        // Check for test directories
+        if (item.name === 'test' || item.name === 'tests' || item.name === '__tests__' || item.name === 'spec') {
+          analysis.hasTests = true;
+        }
+      } else if (item.isFile()) {
+        analysis.files.push(item.name);
+
+        // Check for Docker
+        if (item.name === 'Dockerfile' || item.name === 'docker-compose.yml') {
+          analysis.hasDocker = true;
+        }
+
+        // Check for CI/CD
+        if (item.name === '.gitlab-ci.yml' || item.name === '.travis.yml' || item.name === 'Jenkinsfile') {
+          analysis.hasCI = true;
+        }
+      }
+    }
+
+    // Check for Java/Maven/Gradle projects (including multi-module projects)
     const pomPath = path.join(projectPath, 'pom.xml');
     const gradlePath = path.join(projectPath, 'build.gradle');
     const gradleKtsPath = path.join(projectPath, 'build.gradle.kts');
-    if (fs.existsSync(pomPath) || fs.existsSync(gradlePath) || fs.existsSync(gradleKtsPath)) {
+
+    // Also check for Maven/Gradle projects in subdirectories (multi-module projects)
+    const hasSubmodulePom = analysis.directories.some(dir =>
+      fs.existsSync(path.join(projectPath, dir, 'pom.xml'))
+    );
+    const hasSubmoduleGradle = analysis.directories.some(dir =>
+      fs.existsSync(path.join(projectPath, dir, 'build.gradle')) ||
+      fs.existsSync(path.join(projectPath, dir, 'build.gradle.kts'))
+    );
+
+    if (fs.existsSync(pomPath) || fs.existsSync(gradlePath) || fs.existsSync(gradleKtsPath) || hasSubmodulePom || hasSubmoduleGradle) {
       analysis.language = 'java';
       if (fs.existsSync(pomPath)) {
         analysis.packageManager = 'maven';
@@ -134,6 +173,36 @@ export async function analyzeProject(projectPath) {
             analysis.hasTests = true;
           }
         } catch {}
+      } else if (hasSubmodulePom) {
+        // Analyze submodule pom.xml files for multi-module projects
+        analysis.packageManager = 'maven';
+        analysis.buildTool = 'Maven';
+        let foundSpringBoot = false;
+        let foundJUnit = false;
+
+        for (const dir of analysis.directories) {
+          const subPomPath = path.join(projectPath, dir, 'pom.xml');
+          if (fs.existsSync(subPomPath)) {
+            try {
+              const pom = fs.readFileSync(subPomPath, 'utf8');
+              if (/spring-boot/i.test(pom) || /org\.springframework\.boot/i.test(pom)) {
+                foundSpringBoot = true;
+              }
+              if (/junit|jupiter/i.test(pom)) {
+                foundJUnit = true;
+              }
+            } catch {}
+          }
+        }
+
+        if (foundSpringBoot) {
+          analysis.framework = 'Spring Boot';
+          analysis.architecture = 'Microservices (Spring Boot)';
+        }
+        if (foundJUnit) {
+          analysis.testFramework = 'JUnit';
+          analysis.hasTests = true;
+        }
       } else {
         analysis.packageManager = 'gradle';
         analysis.buildTool = 'Gradle';
@@ -159,38 +228,6 @@ export async function analyzeProject(projectPath) {
       }
     }
 
-    // Check for yarn or pnpm
-    if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
-      analysis.packageManager = 'yarn';
-    } else if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
-      analysis.packageManager = 'pnpm';
-    }
-
-    // Scan directory structure
-    const items = fs.readdirSync(projectPath, { withFileTypes: true });
-    for (const item of items) {
-      if (item.isDirectory() && !item.name.startsWith('.') && item.name !== 'node_modules') {
-        analysis.directories.push(item.name);
-        
-        // Check for test directories
-        if (item.name === 'test' || item.name === 'tests' || item.name === '__tests__' || item.name === 'spec') {
-          analysis.hasTests = true;
-        }
-      } else if (item.isFile()) {
-        analysis.files.push(item.name);
-        
-        // Check for Docker
-        if (item.name === 'Dockerfile' || item.name === 'docker-compose.yml') {
-          analysis.hasDocker = true;
-        }
-        
-        // Check for CI/CD
-        if (item.name === '.gitlab-ci.yml' || item.name === '.travis.yml' || item.name === 'Jenkinsfile') {
-          analysis.hasCI = true;
-        }
-      }
-    }
-
     // Check for GitHub Actions
     if (fs.existsSync(path.join(projectPath, '.github', 'workflows'))) {
       analysis.hasCI = true;
@@ -220,8 +257,7 @@ export async function analyzeProject(projectPath) {
 
   // Validate and improve analysis results before returning
   const finalAnalysis = validateAndImproveAnalysis(analysis, projectPath);
-  console.log(`Final analysis: ${finalAnalysis.name} - ${finalAnalysis.architecture}`);
-  
+
   return finalAnalysis;
 }
 
@@ -243,7 +279,16 @@ function getDirectoryBasedName(projectPath) {
  */
 function generateSmartDescription(projectName) {
   const name = projectName.toLowerCase();
-  
+
+  if (name.includes('microservices') && name.includes('spring')) {
+    return 'Spring Boot microservices application demonstrating distributed architecture patterns and service communication';
+  }
+  if (name.includes('microservices')) {
+    return 'Microservices architecture demonstration with multiple independent services';
+  }
+  if (name.includes('spring') && name.includes('boot')) {
+    return 'Spring Boot application built with modern Java frameworks and best practices';
+  }
   if (name.includes('api')) {
     return `RESTful API service for ${projectName.replace(/api/i, '').trim()} application`;
   }
@@ -265,7 +310,7 @@ function generateSmartDescription(projectName) {
   if (name.includes('tool')) {
     return `Development tool for ${projectName.replace(/tool/i, '').trim()} workflows`;
   }
-  
+
   return `${projectName} application providing core functionality and services`;
 }
 
@@ -309,8 +354,7 @@ function validateAndImproveAnalysis(analysis, projectPath) {
 export function generateProductDocument(analysis) {
   // Validate analysis has meaningful content
   if (isAnalysisGeneric(analysis)) {
-    console.log('Analysis appears generic, enhancing with intelligent defaults');
-    analysis = enhanceGenericAnalysis(analysis);
+      analysis = enhanceGenericAnalysis(analysis);
   }
   
   const features = extractFeatures(analysis);