claude-conversation-memory-mcp 0.1.0

package/dist/parsers/MistakeExtractor.js

@@ -0,0 +1,341 @@
+/**
+ * Mistake Extractor
+ * Identifies errors and how they were corrected to prevent repetition
+ */
+import { nanoid } from "nanoid";
+export class MistakeExtractor {
+    // User correction indicators
+    CORRECTION_INDICATORS = [
+        /^no[,\s]/i,
+        /that'?s?\s+(?:wrong|incorrect|not right|a mistake)/i,
+        /(?:you|that)\s+(?:made|caused|introduced)\s+(?:a|an)\s+(?:error|bug|mistake)/i,
+        /don't\s+do\s+(?:that|this)/i,
+        /(?:should not|shouldn't|must not|mustn't)\s+(?:have\s+)?(?:done|used)/i,
+        /(?:fix|correct|change)\s+(?:that|this)/i,
+    ];
+    // Error indicators in assistant messages
+    ERROR_INDICATORS = [
+        /error:/i,
+        /failed:/i,
+        /exception:/i,
+        /(?:this|that)\s+(?:didn't|doesn't|won't)\s+work/i,
+        /(?:broke|breaking|broken)/i,
+        /(?:issue|problem|bug)/i,
+    ];
+    // Mistake type patterns
+    MISTAKE_PATTERNS = {
+        logic_error: [/logic\s+error/i, /incorrect\s+logic/i, /wrong\s+condition/i],
+        wrong_approach: [
+            /wrong\s+approach/i,
+            /better\s+way/i,
+            /should\s+(?:have\s+)?use(?:d)?/i,
+        ],
+        misunderstanding: [
+            /misunderstood/i,
+            /(?:didn't|don't)\s+understand/i,
+            /confused\s+about/i,
+        ],
+        syntax_error: [/syntax\s+error/i, /parse\s+error/i, /invalid\s+syntax/i],
+    };
+    /**
+     * Extract mistakes from messages and tool results
+     */
+    extractMistakes(messages, toolResults) {
+        const mistakes = [];
+        // Extract from tool errors
+        const toolErrors = this.extractToolErrors(toolResults, messages);
+        mistakes.push(...toolErrors);
+        // Extract from user corrections
+        const userCorrections = this.extractUserCorrections(messages);
+        mistakes.push(...userCorrections);
+        // Extract from error discussions
+        const errorDiscussions = this.extractErrorDiscussions(messages);
+        mistakes.push(...errorDiscussions);
+        return this.deduplicateMistakes(mistakes);
+    }
+    /**
+     * Extract mistakes from tool execution errors
+     */
+    extractToolErrors(toolResults, messages) {
+        const mistakes = [];
+        for (const result of toolResults) {
+            if (!result.is_error) {
+                continue;
+            }
+            const message = messages.find((m) => m.id === result.message_id);
+            if (!message) {
+                continue;
+            }
+            // Extract error details
+            const errorContent = result.stderr || result.content || "";
+            const mistakeType = this.classifyMistakeType(errorContent);
+            mistakes.push({
+                id: nanoid(),
+                conversation_id: message.conversation_id,
+                message_id: message.id,
+                mistake_type: mistakeType || "tool_error",
+                what_went_wrong: this.summarizeError(errorContent),
+                correction: this.findCorrection(message, messages),
+                files_affected: this.extractFilesFromError(errorContent),
+                timestamp: result.timestamp,
+            });
+        }
+        return mistakes;
+    }
+    /**
+     * Extract mistakes from user corrections
+     */
+    extractUserCorrections(messages) {
+        const mistakes = [];
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            if (message.role !== "user" || !message.content) {
+                continue;
+            }
+            const content = message.content;
+            // Check if this is a correction
+            const isCorrection = this.CORRECTION_INDICATORS.some((pattern) => pattern.test(content));
+            if (!isCorrection) {
+                continue;
+            }
+            // Find the previous assistant message
+            const previousAssistant = this.findPreviousAssistantMessage(messages, i);
+            if (!previousAssistant) {
+                continue;
+            }
+            const mistakeType = this.classifyMistakeType(message.content);
+            mistakes.push({
+                id: nanoid(),
+                conversation_id: message.conversation_id,
+                message_id: previousAssistant.id,
+                mistake_type: mistakeType || "misunderstanding",
+                what_went_wrong: this.extractWhatWentWrong(message.content),
+                correction: this.extractCorrection(message.content),
+                user_correction_message: message.content,
+                files_affected: this.extractFilesFromMessage(message),
+                timestamp: message.timestamp,
+            });
+        }
+        return mistakes;
+    }
+    /**
+     * Extract mistakes from error discussions in messages
+     */
+    extractErrorDiscussions(messages) {
+        const mistakes = [];
+        for (const message of messages) {
+            if (message.role !== "assistant" || !message.content) {
+                continue;
+            }
+            const content = message.content;
+            // Check if message discusses an error
+            const hasErrorDiscussion = this.ERROR_INDICATORS.some((pattern) => pattern.test(content));
+            if (!hasErrorDiscussion) {
+                continue;
+            }
+            // Extract error discussion
+            const errorText = this.extractErrorDiscussion(message.content);
+            if (!errorText) {
+                continue;
+            }
+            const mistakeType = this.classifyMistakeType(errorText);
+            mistakes.push({
+                id: nanoid(),
+                conversation_id: message.conversation_id,
+                message_id: message.id,
+                mistake_type: mistakeType || "logic_error",
+                what_went_wrong: errorText,
+                correction: this.extractSolutionFromSameMessage(message.content),
+                files_affected: this.extractFilesFromMessage(message),
+                timestamp: message.timestamp,
+            });
+        }
+        return mistakes;
+    }
+    /**
+     * Classify the type of mistake
+     */
+    classifyMistakeType(text) {
+        for (const [type, patterns] of Object.entries(this.MISTAKE_PATTERNS)) {
+            for (const pattern of patterns) {
+                if (pattern.test(text)) {
+                    return type;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Summarize error message
+     */
+    summarizeError(errorText) {
+        // Take first line or first 200 characters
+        const firstLine = errorText.split("\n")[0];
+        return firstLine.length > 200
+            ? firstLine.substring(0, 200) + "..."
+            : firstLine;
+    }
+    /**
+     * Find correction in subsequent messages
+     */
+    findCorrection(errorMessage, allMessages) {
+        const index = allMessages.findIndex((m) => m.id === errorMessage.id);
+        if (index === -1) {
+            return undefined;
+        }
+        // Look at next few messages for a fix
+        const nextMessages = allMessages.slice(index + 1, index + 5);
+        for (const msg of nextMessages) {
+            if (msg.role === "assistant" && msg.content) {
+                // Look for fix indicators
+                if (/(?:fixed|resolved|corrected|solved)/i.test(msg.content)) {
+                    return msg.content.substring(0, 500);
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract files mentioned in error
+     */
+    extractFilesFromError(errorText) {
+        const files = [];
+        // Common file path patterns
+        const filePathPattern = /(?:\/|\.\/|\.\.\/)?(?:[\w-]+\/)*[\w-]+\.[\w]+/g;
+        const matches = errorText.match(filePathPattern);
+        if (matches) {
+            files.push(...matches);
+        }
+        return [...new Set(files)];
+    }
+    /**
+     * Extract files from message metadata
+     */
+    extractFilesFromMessage(message) {
+        const files = [];
+        if (message.metadata) {
+            const metadataStr = JSON.stringify(message.metadata);
+            const filePathPattern = /(?:\/[\w-]+)+\.[\w]+/g;
+            const matches = metadataStr.match(filePathPattern);
+            if (matches) {
+                files.push(...matches);
+            }
+        }
+        return [...new Set(files)];
+    }
+    /**
+     * Find previous assistant message
+     */
+    findPreviousAssistantMessage(messages, currentIndex) {
+        for (let i = currentIndex - 1; i >= 0; i--) {
+            if (messages[i].role === "assistant") {
+                return messages[i];
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract what went wrong from correction message
+     */
+    extractWhatWentWrong(correctionText) {
+        // Remove correction indicators
+        let cleaned = correctionText;
+        for (const pattern of this.CORRECTION_INDICATORS) {
+            cleaned = cleaned.replace(pattern, "");
+        }
+        // Take first sentence or up to 300 characters
+        const sentences = cleaned.split(/\.|!|\?/);
+        const firstSentence = sentences[0]?.trim();
+        return firstSentence && firstSentence.length > 0
+            ? firstSentence.substring(0, 300)
+            : cleaned.substring(0, 300);
+    }
+    /**
+     * Extract correction from user message
+     */
+    extractCorrection(correctionText) {
+        // Look for "instead" or "should" patterns
+        const insteadMatch = correctionText.match(/instead[,\s]+(.+?)(?:\.|$)/i);
+        if (insteadMatch) {
+            return insteadMatch[1].trim();
+        }
+        const shouldMatch = correctionText.match(/should\s+(?:have\s+)?(.+?)(?:\.|$)/i);
+        if (shouldMatch) {
+            return shouldMatch[1].trim();
+        }
+        return undefined;
+    }
+    /**
+     * Extract error discussion from message
+     */
+    extractErrorDiscussion(content) {
+        // Find sentences containing error indicators
+        const sentences = content.split(/\.|!|\?/);
+        for (const sentence of sentences) {
+            if (this.ERROR_INDICATORS.some((pattern) => pattern.test(sentence))) {
+                return sentence.trim();
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract solution from same message that discusses error
+     */
+    extractSolutionFromSameMessage(content) {
+        // Look for solution indicators
+        const solutionPattern = /(?:to fix|solution|resolved by|corrected by|fixed by)\s+(.+?)(?:\.|$)/i;
+        const match = content.match(solutionPattern);
+        return match?.[1]?.trim();
+    }
+    /**
+     * Deduplicate similar mistakes
+     */
+    deduplicateMistakes(mistakes) {
+        const unique = [];
+        const seen = new Set();
+        for (const mistake of mistakes) {
+            // Create signature
+            const signature = `${mistake.what_went_wrong.substring(0, 100)}_${mistake.timestamp}`;
+            if (!seen.has(signature)) {
+                seen.add(signature);
+                unique.push(mistake);
+            }
+        }
+        return unique;
+    }
+    /**
+     * Score mistake severity (for prioritization)
+     */
+    scoreMistakeSeverity(mistake) {
+        let score = 0;
+        // Has correction
+        if (mistake.correction) {
+            score += 2;
+        }
+        // User explicitly corrected
+        if (mistake.user_correction_message) {
+            score += 3;
+        }
+        // Affects files
+        if (mistake.files_affected.length > 0) {
+            score += 2;
+        }
+        // Type-based severity
+        switch (mistake.mistake_type) {
+            case "logic_error":
+                score += 3;
+                break;
+            case "wrong_approach":
+                score += 2;
+                break;
+            case "syntax_error":
+                score += 1;
+                break;
+            case "tool_error":
+                score += 1;
+                break;
+        }
+        return score;
+    }
+}
+//# sourceMappingURL=MistakeExtractor.js.map

package/dist/parsers/MistakeExtractor.js.map

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

package/dist/parsers/RequirementsExtractor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Requirements and Validations Extractor
+ * Tracks constraints, dependencies, and testing context
+ */
+import type { Message, ToolUse, ToolResult } from "./ConversationParser.js";
+export interface Requirement {
+    id: string;
+    type: "dependency" | "performance" | "compatibility" | "business";
+    description: string;
+    rationale?: string;
+    affects_components: string[];
+    conversation_id: string;
+    message_id: string;
+    timestamp: number;
+}
+export interface Validation {
+    id: string;
+    conversation_id: string;
+    what_was_tested: string;
+    test_command?: string;
+    result: "passed" | "failed" | "error";
+    performance_data?: Record<string, unknown>;
+    files_tested: string[];
+    timestamp: number;
+}
+export declare class RequirementsExtractor {
+    private readonly REQUIREMENT_PATTERNS;
+    private readonly TEST_PATTERNS;
+    /**
+     * Extract requirements from messages
+     */
+    extractRequirements(messages: Message[]): Requirement[];
+    /**
+     * Extract validations from tool uses
+     */
+    extractValidations(toolUses: ToolUse[], toolResults: ToolResult[], messages: Message[]): Validation[];
+    /**
+     * Parse a requirement from pattern match
+     */
+    private parseRequirement;
+    /**
+     * Extract rationale from requirement text
+     */
+    private extractRationale;
+    /**
+     * Extract affected components from message metadata
+     */
+    private extractAffectedComponents;
+    /**
+     * Extract what was tested from command and result
+     */
+    private extractWhatWasTested;
+    /**
+     * Determine test result from tool result
+     */
+    private determineTestResult;
+    /**
+     * Extract performance data from test results
+     */
+    private extractPerformanceData;
+    /**
+     * Extract files that were tested
+     */
+    private extractTestedFiles;
+    /**
+     * Deduplicate similar requirements
+     */
+    private deduplicateRequirements;
+}
+//# sourceMappingURL=RequirementsExtractor.d.ts.map

package/dist/parsers/RequirementsExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequirementsExtractor.d.ts","sourceRoot":"","sources":["../../src/parsers/RequirementsExtractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAmBnC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAQ5B;IAEF;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;IA8BvD;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,OAAO,EAAE,GAClB,UAAU,EAAE;IAuCf;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0BjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAchC"}

package/dist/parsers/RequirementsExtractor.js

@@ -0,0 +1,252 @@
+/**
+ * Requirements and Validations Extractor
+ * Tracks constraints, dependencies, and testing context
+ */
+import { nanoid } from "nanoid";
+export class RequirementsExtractor {
+    // Requirement indicators
+    REQUIREMENT_PATTERNS = {
+        dependency: [
+            /(?:need|require|must use|depends on)\s+(.+?)\s+(?:library|package|module|dependency)/gi,
+            /(?:install|add)\s+(.+?)\s+(?:for|to)/gi,
+        ],
+        performance: [
+            /(?:must|should|need to)\s+(?:be|run)\s+(?:faster|slower|within|under)\s+(.+)/gi,
+            /response time\s+(?:must|should)\s+(?:be\s+)?(?:under|less than|within)\s+(.+)/gi,
+            /(?:latency|throughput|performance)\s+requirement:\s*(.+)/gi,
+        ],
+        compatibility: [
+            /(?:must|should|need to)\s+(?:support|work with|be compatible with)\s+(.+)/gi,
+            /(?:requires?|needs?)\s+(.+?)\s+(?:version|or higher|or later)/gi,
+        ],
+        business: [
+            /business requirement:\s*(.+)/gi,
+            /(?:must|cannot|can't)\s+(?:exceed|violate|break)\s+(.+)/gi,
+            /(?:constraint|limitation):\s*(.+)/gi,
+        ],
+    };
+    // Test/validation indicators
+    TEST_PATTERNS = [
+        /(?:npm|yarn|pnpm)\s+test/,
+        /(?:npm|yarn|pnpm)\s+run\s+test/,
+        /pytest/,
+        /jest/,
+        /mocha/,
+        /cargo\s+test/,
+        /go\s+test/,
+    ];
+    /**
+     * Extract requirements from messages
+     */
+    extractRequirements(messages) {
+        const requirements = [];
+        for (const message of messages) {
+            if (!message.content) {
+                continue;
+            }
+            // Check each requirement type
+            for (const [type, patterns] of Object.entries(this.REQUIREMENT_PATTERNS)) {
+                for (const pattern of patterns) {
+                    const matches = Array.from(message.content.matchAll(pattern));
+                    for (const match of matches) {
+                        const requirement = this.parseRequirement(type, match, message);
+                        if (requirement) {
+                            requirements.push(requirement);
+                        }
+                    }
+                }
+            }
+        }
+        return this.deduplicateRequirements(requirements);
+    }
+    /**
+     * Extract validations from tool uses
+     */
+    extractValidations(toolUses, toolResults, messages) {
+        const validations = [];
+        for (const toolUse of toolUses) {
+            // Check if this is a test command
+            if (toolUse.tool_name === "Bash") {
+                const command = toolUse.tool_input.command;
+                if (!command || typeof command !== "string") {
+                    continue;
+                }
+                const isTest = this.TEST_PATTERNS.some((pattern) => pattern.test(command));
+                if (isTest) {
+                    // Find corresponding result
+                    const result = toolResults.find((r) => r.tool_use_id === toolUse.id);
+                    const message = messages.find((m) => m.id === toolUse.message_id);
+                    if (result && message) {
+                        validations.push({
+                            id: nanoid(),
+                            conversation_id: message.conversation_id,
+                            what_was_tested: this.extractWhatWasTested(command, result),
+                            test_command: command,
+                            result: this.determineTestResult(result),
+                            performance_data: this.extractPerformanceData(result),
+                            files_tested: this.extractTestedFiles(result),
+                            timestamp: toolUse.timestamp,
+                        });
+                    }
+                }
+            }
+        }
+        return validations;
+    }
+    /**
+     * Parse a requirement from pattern match
+     */
+    parseRequirement(type, match, message) {
+        const description = match[1]?.trim();
+        if (!description) {
+            return null;
+        }
+        if (!message.content) {
+            return null;
+        }
+        // Extract rationale from message context
+        const rationale = this.extractRationale(match[0], message.content);
+        // Extract affected components
+        const components = this.extractAffectedComponents(message);
+        return {
+            id: nanoid(),
+            type,
+            description,
+            rationale,
+            affects_components: components,
+            conversation_id: message.conversation_id,
+            message_id: message.id,
+            timestamp: message.timestamp,
+        };
+    }
+    /**
+     * Extract rationale from requirement text
+     */
+    extractRationale(requirementText, fullContent) {
+        // Look for "because", "since", "for" explanations
+        const rationaleMatch = requirementText.match(/(?:because|since|for|due to)\s+(.+?)(?:\.|$)/i);
+        if (rationaleMatch) {
+            return rationaleMatch[1].trim();
+        }
+        // Look in surrounding context
+        const contextMatch = fullContent.match(new RegExp(`${requirementText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[^.]*?(?:because|since|for|due to)\\s+(.+?)(?:\\.|$)`, "i"));
+        return contextMatch?.[1]?.trim();
+    }
+    /**
+     * Extract affected components from message metadata
+     */
+    extractAffectedComponents(message) {
+        const components = [];
+        // Common component keywords
+        const componentKeywords = [
+            "frontend",
+            "backend",
+            "api",
+            "database",
+            "auth",
+            "ui",
+            "server",
+            "client",
+        ];
+        const content = message.content?.toLowerCase() || "";
+        for (const keyword of componentKeywords) {
+            if (content.includes(keyword)) {
+                components.push(keyword);
+            }
+        }
+        return [...new Set(components)];
+    }
+    /**
+     * Extract what was tested from command and result
+     */
+    extractWhatWasTested(command, result) {
+        // Try to extract test file/suite name
+        const fileMatch = command.match(/test[/\\](.+?)(?:\s|$)/);
+        if (fileMatch) {
+            return fileMatch[1];
+        }
+        // Try to extract from result
+        const resultContent = result.stdout || result.content || "";
+        const suiteMatch = resultContent.match(/(?:Test Suite|Describe):\s*(.+)/i);
+        if (suiteMatch) {
+            return suiteMatch[1].trim();
+        }
+        // Fallback to command
+        return command;
+    }
+    /**
+     * Determine test result from tool result
+     */
+    determineTestResult(result) {
+        if (result.is_error) {
+            return "error";
+        }
+        const output = (result.stdout || result.content || "").toLowerCase();
+        // Check for pass indicators
+        if (/(?:all tests? passed|✓|✔|success)/i.test(output) ||
+            /(?:\d+\s+passed,\s+0\s+failed)/i.test(output)) {
+            return "passed";
+        }
+        // Check for fail indicators
+        if (/(?:test failed|✗|✘|failure|failed)/i.test(output) ||
+            /(?:\d+\s+failed)/i.test(output)) {
+            return "failed";
+        }
+        // Default to passed if no errors
+        return result.is_error ? "error" : "passed";
+    }
+    /**
+     * Extract performance data from test results
+     */
+    extractPerformanceData(result) {
+        const output = result.stdout || result.content || "";
+        const data = {};
+        // Extract timing information
+        const timeMatch = output.match(/(\d+(?:\.\d+)?)\s*(ms|s|seconds?|milliseconds?)/i);
+        if (timeMatch) {
+            const value = parseFloat(timeMatch[1]);
+            const unit = timeMatch[2].toLowerCase();
+            data.duration_ms = unit.startsWith("s") ? value * 1000 : value;
+        }
+        // Extract test counts
+        const passedMatch = output.match(/(\d+)\s+passed/i);
+        if (passedMatch) {
+            data.tests_passed = parseInt(passedMatch[1]);
+        }
+        const failedMatch = output.match(/(\d+)\s+failed/i);
+        if (failedMatch) {
+            data.tests_failed = parseInt(failedMatch[1]);
+        }
+        return Object.keys(data).length > 0 ? data : undefined;
+    }
+    /**
+     * Extract files that were tested
+     */
+    extractTestedFiles(result) {
+        const output = result.stdout || result.content || "";
+        const files = [];
+        // Look for file paths
+        const filePattern = /(?:PASS|FAIL|ERROR)\s+([\w/.-]+\.(?:test|spec)\.[\w]+)/gi;
+        const matches = Array.from(output.matchAll(filePattern));
+        for (const match of matches) {
+            files.push(match[1]);
+        }
+        return [...new Set(files)];
+    }
+    /**
+     * Deduplicate similar requirements
+     */
+    deduplicateRequirements(requirements) {
+        const unique = [];
+        const seen = new Set();
+        for (const req of requirements) {
+            const signature = `${req.type}_${req.description.substring(0, 50)}`;
+            if (!seen.has(signature)) {
+                seen.add(signature);
+                unique.push(req);
+            }
+        }
+        return unique;
+    }
+}
+//# sourceMappingURL=RequirementsExtractor.js.map