sdd-mcp-server 1.4.4 → 1.5.0

package/dist/application/services/RequirementsClarificationService.js

@@ -0,0 +1,523 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { v4 as uuidv4 } from 'uuid';
+import { TYPES } from '../../infrastructure/di/types.js';
+import { QuestionCategory } from '../../domain/types.js';
+let RequirementsClarificationService = class RequirementsClarificationService {
+    fileSystem;
+    logger;
+    constructor(fileSystem, logger) {
+        this.fileSystem = fileSystem;
+        this.logger = logger;
+    }
+    /**
+     * Analyzes a project description to determine if clarification is needed
+     */
+    async analyzeDescription(description, projectPath) {
+        const correlationId = uuidv4();
+        this.logger.info('Analyzing project description for clarification needs', {
+            correlationId,
+            descriptionLength: description.length
+        });
+        // Load existing steering docs for context
+        const steeringContext = await this.loadSteeringContext(projectPath);
+        // Perform analysis
+        const analysis = this.performAnalysis(description, steeringContext);
+        this.logger.debug('Description analysis completed', {
+            correlationId,
+            qualityScore: analysis.qualityScore,
+            needsClarification: analysis.needsClarification
+        });
+        if (!analysis.needsClarification) {
+            return {
+                needsClarification: false,
+                analysis
+            };
+        }
+        // Generate clarification questions
+        const questions = this.generateQuestions(analysis, steeringContext);
+        return {
+            needsClarification: true,
+            questions,
+            analysis
+        };
+    }
+    /**
+     * Validates and processes clarification answers
+     */
+    validateAnswers(questions, answers) {
+        const missingRequired = [];
+        for (const question of questions) {
+            if (question.required && !answers[question.id]) {
+                missingRequired.push(question.question);
+            }
+        }
+        return {
+            valid: missingRequired.length === 0,
+            missingRequired
+        };
+    }
+    /**
+     * Synthesizes an enriched project description from original + answers
+     */
+    synthesizeDescription(originalDescription, questions, answers) {
+        const correlationId = uuidv4();
+        this.logger.info('Synthesizing enriched project description', {
+            correlationId,
+            questionCount: questions.length
+        });
+        // Extract answers by category
+        const why = this.extractAnswersByCategory(questions, answers, QuestionCategory.WHY);
+        const who = this.extractAnswersByCategory(questions, answers, QuestionCategory.WHO);
+        const what = this.extractAnswersByCategory(questions, answers, QuestionCategory.WHAT);
+        const how = this.extractAnswersByCategory(questions, answers, QuestionCategory.HOW);
+        const successCriteria = this.extractAnswersByCategory(questions, answers, QuestionCategory.SUCCESS);
+        // Build enriched description
+        const enriched = this.buildEnrichedDescription({
+            original: originalDescription,
+            why,
+            who,
+            what,
+            how,
+            successCriteria
+        });
+        return {
+            original: originalDescription,
+            why,
+            who,
+            what,
+            how: how || undefined,
+            successCriteria,
+            enriched
+        };
+    }
+    /**
+     * Performs the core analysis of the description
+     */
+    performAnalysis(description, steeringContext) {
+        const missingElements = [];
+        const ambiguousTerms = [];
+        // Check for WHY (business justification, problem statement)
+        const hasWhy = this.detectWhy(description);
+        if (!hasWhy && !steeringContext.hasProductContext) {
+            missingElements.push('Business justification or problem statement (WHY)');
+        }
+        // Check for WHO (target users)
+        const hasWho = this.detectWho(description);
+        if (!hasWho && !steeringContext.hasTargetUsers) {
+            missingElements.push('Target users or personas (WHO)');
+        }
+        // Check for WHAT (core features, scope)
+        const hasWhat = this.detectWhat(description);
+        if (!hasWhat) {
+            missingElements.push('Core features or scope definition (WHAT)');
+        }
+        // Check for success criteria
+        const hasSuccessCriteria = this.detectSuccessCriteria(description);
+        if (!hasSuccessCriteria) {
+            missingElements.push('Success criteria or metrics');
+        }
+        // Detect ambiguous terms
+        ambiguousTerms.push(...this.detectAmbiguousTerms(description));
+        // Calculate quality score (0-100)
+        const qualityScore = this.calculateQualityScore({
+            hasWhy,
+            hasWho,
+            hasWhat,
+            hasSuccessCriteria,
+            ambiguousTermCount: ambiguousTerms.length,
+            descriptionLength: description.length
+        });
+        // Need clarification if score < 70 or missing critical elements
+        const needsClarification = qualityScore < 70 || missingElements.length > 0;
+        return {
+            qualityScore,
+            missingElements,
+            ambiguousTerms,
+            needsClarification,
+            hasWhy,
+            hasWho,
+            hasWhat,
+            hasSuccessCriteria
+        };
+    }
+    /**
+     * Generates targeted clarification questions based on analysis
+     */
+    generateQuestions(analysis, steeringContext) {
+        const questions = [];
+        // WHY questions - always high priority
+        if (!analysis.hasWhy && !steeringContext.hasProductContext) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHY,
+                question: 'What business problem does this project solve? Why is it needed?',
+                why: 'Understanding the business justification ensures we build the right solution',
+                examples: [
+                    'Our customer support team spends 5 hours/day on repetitive inquiries',
+                    'Users are abandoning checkout because the process takes too long',
+                    'Developers waste time searching for undocumented APIs'
+                ],
+                required: true
+            });
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHY,
+                question: 'What value does this project provide to users or the business?',
+                why: 'Clarifying value proposition helps prioritize features and measure success',
+                examples: [
+                    'Reduce support ticket volume by 40%',
+                    'Increase conversion rate by improving checkout speed',
+                    'Save developers 2 hours/week with better documentation'
+                ],
+                required: true
+            });
+        }
+        // WHO questions
+        if (!analysis.hasWho && !steeringContext.hasTargetUsers) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHO,
+                question: 'Who are the primary users of this project?',
+                why: 'Knowing the target users shapes UX, features, and technical decisions',
+                examples: [
+                    'Customer support agents using ticketing systems',
+                    'E-commerce shoppers on mobile devices',
+                    'Backend developers integrating APIs'
+                ],
+                required: true
+            });
+        }
+        // WHAT questions
+        if (!analysis.hasWhat) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHAT,
+                question: 'What are the 3-5 core features for the MVP?',
+                why: 'Defining MVP scope prevents scope creep and ensures focused delivery',
+                examples: [
+                    'Auto-response system, ticket categorization, analytics dashboard',
+                    'Product search, cart management, payment integration',
+                    'API explorer, code examples, interactive documentation'
+                ],
+                required: true
+            });
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHAT,
+                question: 'What is explicitly OUT OF SCOPE for this project?',
+                why: 'Boundary definition prevents feature creep and manages expectations',
+                examples: [
+                    'Admin panel (future phase)',
+                    'Mobile app (web only for MVP)',
+                    'Multi-language support (English only initially)'
+                ],
+                required: false
+            });
+        }
+        // SUCCESS questions
+        if (!analysis.hasSuccessCriteria) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.SUCCESS,
+                question: 'How will you measure if this project is successful?',
+                why: 'Quantifiable metrics enable objective evaluation and iteration',
+                examples: [
+                    'Support ticket volume reduced by 30% within 3 months',
+                    'Page load time under 2 seconds, conversion rate > 3%',
+                    'API documentation rated 4.5/5 stars by developers'
+                ],
+                required: true
+            });
+        }
+        // HOW questions (technical approach) - only if no tech steering
+        if (!steeringContext.hasTechContext) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.HOW,
+                question: 'Are there any technical constraints or preferences? (language, platform, existing systems)',
+                why: 'Technical constraints shape architecture and technology choices',
+                examples: [
+                    'Must integrate with existing Salesforce CRM',
+                    'TypeScript + React preferred, hosted on AWS',
+                    'Python-based, needs to run on-premise'
+                ],
+                required: false
+            });
+        }
+        // Ambiguity clarification
+        for (const ambiguous of analysis.ambiguousTerms.slice(0, 3)) {
+            questions.push({
+                id: uuidv4(),
+                category: QuestionCategory.WHAT,
+                question: `You mentioned "${ambiguous.term}". ${ambiguous.suggestion}`,
+                why: 'Removing ambiguity ensures shared understanding',
+                examples: ambiguous.context ? [ambiguous.context] : undefined,
+                required: false
+            });
+        }
+        return questions;
+    }
+    /**
+     * Load steering documents for context
+     */
+    async loadSteeringContext(projectPath) {
+        if (!projectPath) {
+            return {
+                hasProductContext: false,
+                hasTargetUsers: false,
+                hasTechContext: false
+            };
+        }
+        const context = {
+            hasProductContext: false,
+            hasTargetUsers: false,
+            hasTechContext: false
+        };
+        try {
+            // Check product.md
+            const productPath = `${projectPath}/.kiro/steering/product.md`;
+            if (await this.fileSystem.exists(productPath)) {
+                const productContent = await this.fileSystem.readFile(productPath);
+                context.hasProductContext = productContent.length > 200; // Has substantial content
+                context.hasTargetUsers = /target\s+users|user\s+persona/i.test(productContent);
+            }
+            // Check tech.md
+            const techPath = `${projectPath}/.kiro/steering/tech.md`;
+            if (await this.fileSystem.exists(techPath)) {
+                const techContent = await this.fileSystem.readFile(techPath);
+                context.hasTechContext = techContent.length > 200;
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to load steering context', {
+                error: error.message
+            });
+        }
+        return context;
+    }
+    /**
+     * Detects if description contains WHY (business justification)
+     */
+    detectWhy(description) {
+        const whyPatterns = [
+            /\bproblem\b/i,
+            /\bsolve[sd]?\b/i,
+            /\bchallenge\b/i,
+            /\bpain\s+point/i,
+            /\bissue\b/i,
+            /\bwhy\b/i,
+            /\bbecause\b/i,
+            /\benables?\b/i,
+            /\bvalue\s+proposition/i,
+            /\bbenefit/i,
+            /\bjustification/i,
+            /\bgoal\b/i,
+            /\bobjective\b/i,
+            /\bpurpose\b/i
+        ];
+        return whyPatterns.some(pattern => pattern.test(description));
+    }
+    /**
+     * Detects if description contains WHO (target users)
+     */
+    detectWho(description) {
+        const whoPatterns = [
+            /\buser[s]?\b/i,
+            /\bcustomer[s]?\b/i,
+            /\btarget\s+(audience|users?|customers?)/i,
+            /\bpersona[s]?\b/i,
+            /\bstakeholder[s]?\b/i,
+            /\b(developer|designer|admin|manager)[s]?\b/i,
+            /\bfor\s+(teams?|companies|individuals)/i
+        ];
+        return whoPatterns.some(pattern => pattern.test(description));
+    }
+    /**
+     * Detects if description contains WHAT (features, scope)
+     */
+    detectWhat(description) {
+        const whatPatterns = [
+            /\bfeature[s]?\b/i,
+            /\bfunctionality\b/i,
+            /\bcapabilit(y|ies)/i,
+            /\bprovides?\b/i,
+            /\binclude[s]?\b/i,
+            /\bsupport[s]?\b/i,
+            /\ballow[s]?\b/i,
+            /\benable[s]?\b/i,
+            /\bMVP\b/i,
+            /\bscope\b/i
+        ];
+        return whatPatterns.some(pattern => pattern.test(description));
+    }
+    /**
+     * Detects if description contains success criteria
+     */
+    detectSuccessCriteria(description) {
+        const successPatterns = [
+            /\bmetric[s]?\b/i,
+            /\bKPI[s]?\b/i,
+            /\bmeasure[sd]?\b/i,
+            /\bsuccess\s+(criteria|metric)/i,
+            /\b\d+%/,
+            /\bperformance\s+target/i,
+            /\bgoal[s]?\b.*\d+/i
+        ];
+        return successPatterns.some(pattern => pattern.test(description));
+    }
+    /**
+     * Detects ambiguous terms that need clarification
+     */
+    detectAmbiguousTerms(description) {
+        const ambiguousTerms = [];
+        const ambiguityMap = [
+            {
+                pattern: /\bfast\b/gi,
+                suggestion: 'Can you specify a target response time? (e.g., "< 200ms API response", "page loads in 2s")'
+            },
+            {
+                pattern: /\bscalable\b/gi,
+                suggestion: 'What scale do you need to support? (e.g., "1000 concurrent users", "100k requests/hour")'
+            },
+            {
+                pattern: /\buser[- ]friendly\b/gi,
+                suggestion: 'What makes it user-friendly? (e.g., "3-click checkout", "mobile-responsive", "keyboard shortcuts")'
+            },
+            {
+                pattern: /\beasy\s+to\s+use\b/gi,
+                suggestion: 'What does easy mean for your users? (e.g., "no training required", "5-minute onboarding", "intuitive navigation")'
+            },
+            {
+                pattern: /\bhigh\s+quality\b/gi,
+                suggestion: 'How do you define quality? (e.g., "zero critical bugs in production", "90% test coverage", "< 5% error rate")'
+            },
+            {
+                pattern: /\breliable\b/gi,
+                suggestion: 'What reliability level do you need? (e.g., "99.9% uptime", "zero data loss", "automatic failover")'
+            },
+            {
+                pattern: /\bsecure\b/gi,
+                suggestion: 'What security requirements apply? (e.g., "SOC 2 compliant", "end-to-end encryption", "OAuth 2.0")'
+            },
+            {
+                pattern: /\bmodern\b/gi,
+                suggestion: 'What technologies or approaches are you considering? (e.g., "React + TypeScript", "microservices", "serverless")'
+            }
+        ];
+        for (const { pattern, suggestion } of ambiguityMap) {
+            const matches = description.match(pattern);
+            if (matches) {
+                for (const match of matches) {
+                    const context = this.extractContext(description, match);
+                    ambiguousTerms.push({
+                        term: match,
+                        context,
+                        suggestion
+                    });
+                }
+            }
+        }
+        return ambiguousTerms;
+    }
+    /**
+     * Extracts surrounding context for an ambiguous term
+     */
+    extractContext(text, term) {
+        const index = text.toLowerCase().indexOf(term.toLowerCase());
+        if (index === -1)
+            return '';
+        const start = Math.max(0, index - 30);
+        const end = Math.min(text.length, index + term.length + 30);
+        return '...' + text.slice(start, end).trim() + '...';
+    }
+    /**
+     * Calculates quality score based on completeness and clarity
+     */
+    calculateQualityScore(metrics) {
+        let score = 0;
+        // WHY is most important (30 points)
+        if (metrics.hasWhy)
+            score += 30;
+        // WHO is critical (20 points)
+        if (metrics.hasWho)
+            score += 20;
+        // WHAT is essential (20 points)
+        if (metrics.hasWhat)
+            score += 20;
+        // Success criteria (15 points)
+        if (metrics.hasSuccessCriteria)
+            score += 15;
+        // Penalize ambiguous terms (up to -15 points)
+        const ambiguityPenalty = Math.min(15, metrics.ambiguousTermCount * 5);
+        score -= ambiguityPenalty;
+        // Length bonus (up to 15 points) - adequate detail
+        if (metrics.descriptionLength > 100)
+            score += 5;
+        if (metrics.descriptionLength > 300)
+            score += 5;
+        if (metrics.descriptionLength > 500)
+            score += 5;
+        return Math.max(0, Math.min(100, score));
+    }
+    /**
+     * Extracts answers for a specific category
+     */
+    extractAnswersByCategory(questions, answers, category) {
+        const categoryQuestions = questions.filter(q => q.category === category);
+        const categoryAnswers = categoryQuestions
+            .map(q => answers[q.id])
+            .filter(a => a && a.trim().length > 0);
+        return categoryAnswers.join(' ');
+    }
+    /**
+     * Builds the enriched description from all components
+     */
+    buildEnrichedDescription(components) {
+        const parts = [];
+        // Start with original if it has content
+        if (components.original && components.original.trim().length > 0) {
+            parts.push(`## Original Description\n${components.original}`);
+        }
+        // Add WHY
+        if (components.why) {
+            parts.push(`## Business Justification (Why)\n${components.why}`);
+        }
+        // Add WHO
+        if (components.who) {
+            parts.push(`## Target Users (Who)\n${components.who}`);
+        }
+        // Add WHAT
+        if (components.what) {
+            parts.push(`## Core Features (What)\n${components.what}`);
+        }
+        // Add HOW (optional)
+        if (components.how) {
+            parts.push(`## Technical Approach (How)\n${components.how}`);
+        }
+        // Add success criteria
+        if (components.successCriteria) {
+            parts.push(`## Success Criteria\n${components.successCriteria}`);
+        }
+        return parts.join('\n\n');
+    }
+};
+RequirementsClarificationService = __decorate([
+    injectable(),
+    __param(0, inject(TYPES.FileSystemPort)),
+    __param(1, inject(TYPES.LoggerPort)),
+    __metadata("design:paramtypes", [Object, Object])
+], RequirementsClarificationService);
+export { RequirementsClarificationService };
+//# sourceMappingURL=RequirementsClarificationService.js.map

package/dist/application/services/RequirementsClarificationService.js.map

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

package/dist/application/services/staticSteering.d.ts

@@ -0,0 +1,6 @@
+import type { SteeringDocumentService } from './SteeringDocumentService.js';
+/**
+ * Ensure the static steering documents exist for a project, creating them when missing.
+ * This centralises the shared logic used by different entrypoints (CLI, simplified MCP, etc.)
+ */
+export declare function ensureStaticSteeringDocuments(projectPath: string, steeringService: SteeringDocumentService): Promise<void>;