cccmemory 1.8.0

package/dist/parsers/GitIntegrator.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Git Integrator - Links git commits to conversations based on temporal and contextual analysis.
+ *
+ * This integrator connects git repository history with conversation history by:
+ * - Parsing git log to extract commits
+ * - Matching commits to conversations using multiple signals:
+ *   - Temporal proximity (commit time vs conversation time)
+ *   - File overlap (files changed in commit vs files edited in conversation)
+ *   - Branch matching (git branch in commit vs conversation metadata)
+ *   - Decision matching (commit message mentions decisions from conversation)
+ *
+ * Provides confidence scores (0-1) for each linkage based on:
+ * - Exact timestamp match (highest confidence)
+ * - File overlap percentage
+ * - Branch name match
+ * - Decision keyword presence
+ *
+ * Helps answer "WHY was this code changed?" by linking code changes to their
+ * discussion context.
+ *
+ * @example
+ * ```typescript
+ * const integrator = new GitIntegrator('/path/to/project');
+ * const linkedCommits = await integrator.linkCommitsToConversations(
+ *   conversations,
+ *   fileEdits,
+ *   decisions
+ * );
+ * console.error(`Linked ${linkedCommits.filter(c => c.conversation_id).length} commits`);
+ * ```
+ */
+import type { Conversation, FileEdit } from "./ConversationParser.js";
+import type { Decision } from "./DecisionExtractor.js";
+/**
+ * Represents a git commit with conversation linkage.
+ */
+export interface GitCommit {
+    /** Short commit hash (7 chars) or full hash */
+    hash: string;
+    /** Commit message */
+    message: string;
+    /** Commit author */
+    author?: string;
+    /** Commit timestamp */
+    timestamp: number;
+    /** Git branch name */
+    branch?: string;
+    /** Files modified in this commit */
+    files_changed: string[];
+    /** Linked conversation ID (if matched) */
+    conversation_id?: string;
+    /** Related message ID within the conversation */
+    related_message_id?: string;
+    /** Additional commit metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Represents a commit-to-conversation linkage with confidence score.
+ * @internal
+ */
+export interface CommitLinkage {
+    /** The git commit */
+    commit: GitCommit;
+    /** The matched conversation */
+    conversation: Conversation;
+    /** Confidence score (0-1) of the match */
+    confidence: number;
+    /** Reasons why this match was made */
+    reasons: string[];
+}
+/**
+ * Integrates git repository history with conversation history.
+ *
+ * Links commits to conversations using temporal and contextual analysis.
+ */
+export declare class GitIntegrator {
+    private git;
+    /**
+     * Create a new GitIntegrator.
+     *
+     * @param projectPath - Path to the git repository
+     * @throws {Error} If the directory is not a git repository
+     */
+    constructor(projectPath: string);
+    /**
+     * Parse git history and link commits to conversations.
+     *
+     * Analyzes git log and matches commits to conversations using multiple signals:
+     * - Temporal proximity (commits made during conversation timeframe)
+     * - File overlap (files changed in commit match files edited in conversation)
+     * - Branch matching (git branch matches conversation metadata)
+     * - Decision context (commit message references decisions from conversation)
+     *
+     * Only creates links with confidence > 0.3 to avoid false positives.
+     *
+     * @param conversations - Array of conversations to match against
+     * @param fileEdits - Array of file edits from conversations
+     * @param decisions - Array of decisions that may be referenced in commits
+     * @returns Array of GitCommit objects with conversation_id set for matches
+     *
+     * @example
+     * ```typescript
+     * const integrator = new GitIntegrator('/path/to/project');
+     * const commits = await integrator.linkCommitsToConversations(
+     *   conversations,
+     *   fileEdits,
+     *   decisions
+     * );
+     *
+     * // Find commits linked to a specific conversation
+     * const convCommits = commits.filter(c => c.conversation_id === 'conv-123');
+     * console.error(`${convCommits.length} commits for this conversation`);
+     * ```
+     */
+    linkCommitsToConversations(conversations: Conversation[], fileEdits: FileEdit[], decisions: Decision[]): Promise<GitCommit[]>;
+    /**
+     * Parse git history
+     */
+    private parseGitHistory;
+    /**
+     * Get files changed in a commit
+     */
+    private getChangedFiles;
+    /**
+     * Find best conversation match for a commit
+     */
+    private findBestConversationMatch;
+    /**
+     * Score how well a commit matches a conversation
+     */
+    private scoreCommitConversationMatch;
+    /**
+     * Score based on timestamp proximity
+     * Returns 0-3 points
+     */
+    private scoreTimestampProximity;
+    /**
+     * Score based on file overlap
+     * Returns 0-4 points
+     */
+    private scoreFileOverlap;
+    /**
+     * Score based on commit message keywords
+     * Returns 0-2 points
+     */
+    private scoreCommitMessageKeywords;
+    /**
+     * Get recent commits (last N days)
+     */
+    getRecentCommits(days?: number): Promise<GitCommit[]>;
+    /**
+     * Get commits affecting a specific file
+     */
+    getCommitsForFile(filePath: string): Promise<GitCommit[]>;
+}
+//# sourceMappingURL=GitIntegrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GitIntegrator.d.ts","sourceRoot":"","sources":["../../src/parsers/GitIntegrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAY;IAEvB;;;;;OAKG;gBACS,WAAW,EAAE,MAAM;IAI/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,0BAA0B,CAC9B,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC;IAqCvB;;OAEG;YACW,eAAe;IA4C7B;;OAEG;YACW,eAAe;IAgB7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0BjC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiDpC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAkC/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAyClC;;OAEG;IACG,gBAAgB,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAkC/D;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAsBhE"}

package/dist/parsers/GitIntegrator.js

@@ -0,0 +1,348 @@
+/**
+ * Git Integrator - Links git commits to conversations based on temporal and contextual analysis.
+ *
+ * This integrator connects git repository history with conversation history by:
+ * - Parsing git log to extract commits
+ * - Matching commits to conversations using multiple signals:
+ *   - Temporal proximity (commit time vs conversation time)
+ *   - File overlap (files changed in commit vs files edited in conversation)
+ *   - Branch matching (git branch in commit vs conversation metadata)
+ *   - Decision matching (commit message mentions decisions from conversation)
+ *
+ * Provides confidence scores (0-1) for each linkage based on:
+ * - Exact timestamp match (highest confidence)
+ * - File overlap percentage
+ * - Branch name match
+ * - Decision keyword presence
+ *
+ * Helps answer "WHY was this code changed?" by linking code changes to their
+ * discussion context.
+ *
+ * @example
+ * ```typescript
+ * const integrator = new GitIntegrator('/path/to/project');
+ * const linkedCommits = await integrator.linkCommitsToConversations(
+ *   conversations,
+ *   fileEdits,
+ *   decisions
+ * );
+ * console.error(`Linked ${linkedCommits.filter(c => c.conversation_id).length} commits`);
+ * ```
+ */
+import simpleGit from "simple-git";
+/**
+ * Integrates git repository history with conversation history.
+ *
+ * Links commits to conversations using temporal and contextual analysis.
+ */
+export class GitIntegrator {
+    git;
+    /**
+     * Create a new GitIntegrator.
+     *
+     * @param projectPath - Path to the git repository
+     * @throws {Error} If the directory is not a git repository
+     */
+    constructor(projectPath) {
+        this.git = simpleGit(projectPath);
+    }
+    /**
+     * Parse git history and link commits to conversations.
+     *
+     * Analyzes git log and matches commits to conversations using multiple signals:
+     * - Temporal proximity (commits made during conversation timeframe)
+     * - File overlap (files changed in commit match files edited in conversation)
+     * - Branch matching (git branch matches conversation metadata)
+     * - Decision context (commit message references decisions from conversation)
+     *
+     * Only creates links with confidence > 0.3 to avoid false positives.
+     *
+     * @param conversations - Array of conversations to match against
+     * @param fileEdits - Array of file edits from conversations
+     * @param decisions - Array of decisions that may be referenced in commits
+     * @returns Array of GitCommit objects with conversation_id set for matches
+     *
+     * @example
+     * ```typescript
+     * const integrator = new GitIntegrator('/path/to/project');
+     * const commits = await integrator.linkCommitsToConversations(
+     *   conversations,
+     *   fileEdits,
+     *   decisions
+     * );
+     *
+     * // Find commits linked to a specific conversation
+     * const convCommits = commits.filter(c => c.conversation_id === 'conv-123');
+     * console.error(`${convCommits.length} commits for this conversation`);
+     * ```
+     */
+    async linkCommitsToConversations(conversations, fileEdits, decisions) {
+        console.error("Parsing git history...");
+        // Get git log
+        const commits = await this.parseGitHistory();
+        console.error(`Found ${commits.length} commits`);
+        // Link commits to conversations
+        const linkedCommits = [];
+        for (const commit of commits) {
+            const linkage = this.findBestConversationMatch(commit, conversations, fileEdits, decisions);
+            if (linkage && linkage.confidence > 0.3) {
+                commit.conversation_id = linkage.conversation.id;
+                console.error(`Linked commit ${commit.hash.substring(0, 7)} to conversation (confidence: ${(linkage.confidence * 100).toFixed(0)}%)`);
+                console.error(`  Reasons: ${linkage.reasons.join(", ")}`);
+            }
+            linkedCommits.push(commit);
+        }
+        console.error(`Linked ${linkedCommits.filter((c) => c.conversation_id).length} commits to conversations`);
+        return linkedCommits;
+    }
+    /**
+     * Parse git history
+     */
+    async parseGitHistory() {
+        try {
+            const log = await this.git.log({
+                "--all": null,
+                "--name-only": null,
+            });
+            const commits = [];
+            for (const entry of log.all) {
+                // Get current branch (if available)
+                let branch;
+                try {
+                    const branches = await this.git.branch(["--contains", entry.hash]);
+                    branch = branches.current || branches.all[0];
+                }
+                catch (_e) {
+                    // Branch info not available
+                }
+                // Parse changed files from diff
+                const files = await this.getChangedFiles(entry.hash);
+                commits.push({
+                    hash: entry.hash,
+                    message: entry.message,
+                    author: entry.author_name,
+                    timestamp: new Date(entry.date).getTime(),
+                    branch,
+                    files_changed: files,
+                    metadata: {
+                        author_email: entry.author_email,
+                        refs: entry.refs,
+                        body: entry.body,
+                    },
+                });
+            }
+            return commits;
+        }
+        catch (error) {
+            console.error("Error parsing git history:", error);
+            return [];
+        }
+    }
+    /**
+     * Get files changed in a commit
+     */
+    async getChangedFiles(commitHash) {
+        try {
+            const diff = await this.git.show([
+                "--name-only",
+                "--format=",
+                commitHash,
+            ]);
+            return diff
+                .split("\n")
+                .map((f) => f.trim())
+                .filter((f) => f.length > 0);
+        }
+        catch (_error) {
+            return [];
+        }
+    }
+    /**
+     * Find best conversation match for a commit
+     */
+    findBestConversationMatch(commit, conversations, fileEdits, decisions) {
+        let bestMatch = null;
+        let highestConfidence = 0;
+        for (const conversation of conversations) {
+            const linkage = this.scoreCommitConversationMatch(commit, conversation, fileEdits, decisions);
+            if (linkage.confidence > highestConfidence) {
+                highestConfidence = linkage.confidence;
+                bestMatch = linkage;
+            }
+        }
+        return bestMatch;
+    }
+    /**
+     * Score how well a commit matches a conversation
+     */
+    scoreCommitConversationMatch(commit, conversation, fileEdits, decisions) {
+        let score = 0;
+        const reasons = [];
+        const maxScore = 10; // Total possible points
+        // 1. Timestamp proximity (3 points max)
+        const timestampScore = this.scoreTimestampProximity(commit, conversation);
+        score += timestampScore;
+        if (timestampScore > 0) {
+            reasons.push(`timestamp proximity (${timestampScore.toFixed(1)}/3)`);
+        }
+        // 2. File overlap (4 points max)
+        const fileScore = this.scoreFileOverlap(commit, conversation, fileEdits);
+        score += fileScore;
+        if (fileScore > 0) {
+            reasons.push(`file overlap (${fileScore.toFixed(1)}/4)`);
+        }
+        // 3. Branch match (1 point)
+        if (commit.branch && commit.branch === conversation.git_branch) {
+            score += 1;
+            reasons.push("branch match");
+        }
+        // 4. Commit message keywords (2 points max)
+        const keywordScore = this.scoreCommitMessageKeywords(commit, conversation, decisions);
+        score += keywordScore;
+        if (keywordScore > 0) {
+            reasons.push(`message keywords (${keywordScore.toFixed(1)}/2)`);
+        }
+        return {
+            commit,
+            conversation,
+            confidence: score / maxScore,
+            reasons,
+        };
+    }
+    /**
+     * Score based on timestamp proximity
+     * Returns 0-3 points
+     */
+    scoreTimestampProximity(commit, conversation) {
+        const { first_message_at, last_message_at } = conversation;
+        // Check if commit is within conversation timespan
+        if (commit.timestamp >= first_message_at &&
+            commit.timestamp <= last_message_at) {
+            return 3; // Perfect match
+        }
+        // Check if commit is within 5 minutes before/after conversation
+        const fiveMinutes = 5 * 60 * 1000;
+        const timeDelta = Math.min(Math.abs(commit.timestamp - first_message_at), Math.abs(commit.timestamp - last_message_at));
+        if (timeDelta < fiveMinutes) {
+            return 2; // Very close
+        }
+        // Check if commit is within 1 hour
+        const oneHour = 60 * 60 * 1000;
+        if (timeDelta < oneHour) {
+            return 1; // Somewhat close
+        }
+        return 0; // Too far away
+    }
+    /**
+     * Score based on file overlap
+     * Returns 0-4 points
+     */
+    scoreFileOverlap(commit, conversation, fileEdits) {
+        // Get files discussed in conversation
+        const conversationFiles = fileEdits
+            .filter((edit) => edit.conversation_id === conversation.id)
+            .map((edit) => edit.file_path);
+        if (conversationFiles.length === 0) {
+            return 0;
+        }
+        // Calculate overlap
+        const commitFilesSet = new Set(commit.files_changed);
+        const overlappingFiles = conversationFiles.filter((file) => commitFilesSet.has(file));
+        const overlapRatio = overlappingFiles.length /
+            Math.max(commit.files_changed.length, conversationFiles.length);
+        // 4 points for 100% overlap, scaling down
+        return overlapRatio * 4;
+    }
+    /**
+     * Score based on commit message keywords
+     * Returns 0-2 points
+     */
+    scoreCommitMessageKeywords(commit, conversation, decisions) {
+        const commitMessage = commit.message.toLowerCase();
+        // Get keywords from conversation decisions
+        const conversationDecisions = decisions.filter((d) => d.conversation_id === conversation.id);
+        if (conversationDecisions.length === 0) {
+            return 0;
+        }
+        // Extract keywords from decisions
+        const keywords = new Set();
+        for (const decision of conversationDecisions) {
+            // Extract significant words (3+ characters)
+            const words = decision.decision_text
+                .toLowerCase()
+                .split(/\s+/)
+                .filter((w) => w.length >= 3);
+            words.forEach((w) => keywords.add(w));
+            if (decision.context) {
+                keywords.add(decision.context.toLowerCase());
+            }
+        }
+        // Count keyword matches
+        let matches = 0;
+        for (const keyword of keywords) {
+            if (commitMessage.includes(keyword)) {
+                matches++;
+            }
+        }
+        // 2 points for 3+ matches, scaling down
+        return Math.min(matches / 3, 1) * 2;
+    }
+    /**
+     * Get recent commits (last N days)
+     */
+    async getRecentCommits(days = 30) {
+        const sinceDate = new Date();
+        sinceDate.setDate(sinceDate.getDate() - days);
+        try {
+            const log = await this.git.log({
+                "--since": sinceDate.toISOString(),
+            });
+            const commits = [];
+            for (const entry of log.all) {
+                const files = await this.getChangedFiles(entry.hash);
+                commits.push({
+                    hash: entry.hash,
+                    message: entry.message,
+                    author: entry.author_name,
+                    timestamp: new Date(entry.date).getTime(),
+                    files_changed: files,
+                    metadata: {
+                        author_email: entry.author_email,
+                        refs: entry.refs,
+                    },
+                });
+            }
+            return commits;
+        }
+        catch (error) {
+            console.error("Error getting recent commits:", error);
+            return [];
+        }
+    }
+    /**
+     * Get commits affecting a specific file
+     */
+    async getCommitsForFile(filePath) {
+        try {
+            const log = await this.git.log({
+                file: filePath,
+            });
+            return log.all.map((entry) => ({
+                hash: entry.hash,
+                message: entry.message,
+                author: entry.author_name,
+                timestamp: new Date(entry.date).getTime(),
+                files_changed: [filePath],
+                metadata: {
+                    author_email: entry.author_email,
+                    refs: entry.refs,
+                },
+            }));
+        }
+        catch (error) {
+            console.error(`Error getting commits for ${filePath}:`, error);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=GitIntegrator.js.map

package/dist/parsers/GitIntegrator.js.map

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

package/dist/parsers/MistakeExtractor.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Mistake Extractor - Identifies errors and how they were corrected.
+ *
+ * This extractor analyzes conversation messages and tool results to identify
+ * mistakes made during development and how they were corrected. It helps prevent
+ * repeating the same errors by documenting:
+ * - What went wrong
+ * - How it was corrected
+ * - Files affected
+ * - Type of mistake (logic error, wrong approach, etc.)
+ *
+ * Sources of mistakes:
+ * - Tool execution errors (failed commands, syntax errors)
+ * - User corrections ("that's wrong", "don't do that")
+ * - Error discussions (debugging conversations)
+ *
+ * @example
+ * ```typescript
+ * const extractor = new MistakeExtractor();
+ * const mistakes = extractor.extractMistakes(messages, toolResults);
+ * console.log(`Found ${mistakes.length} mistakes`);
+ * mistakes.forEach(m => {
+ *   console.log(`${m.mistake_type}: ${m.what_went_wrong}`);
+ *   if (m.correction) console.log(`Fixed by: ${m.correction}`);
+ * });
+ * ```
+ */
+import type { Message, ToolResult } from "./ConversationParser.js";
+/**
+ * Represents a mistake made during development and how it was corrected.
+ */
+export interface Mistake {
+    /** Unique mistake identifier */
+    id: string;
+    /** Conversation where the mistake occurred */
+    conversation_id: string;
+    /** Message containing or referencing the mistake */
+    message_id: string;
+    /** Category of mistake */
+    mistake_type: "logic_error" | "wrong_approach" | "misunderstanding" | "tool_error" | "syntax_error";
+    /** Description of what went wrong */
+    what_went_wrong: string;
+    /** How the mistake was corrected */
+    correction?: string;
+    /** User's message correcting the mistake */
+    user_correction_message?: string;
+    /** Files affected by this mistake */
+    files_affected: string[];
+    /** When the mistake occurred */
+    timestamp: number;
+}
+/**
+ * Extracts mistakes and corrections from conversation history.
+ *
+ * Analyzes tool errors, user corrections, and error discussions to document
+ * mistakes and prevent repetition.
+ */
+export declare class MistakeExtractor {
+    private readonly MIN_SEVERITY_SCORE;
+    private readonly NOISE_PATTERNS;
+    private readonly CORRECTION_INDICATORS;
+    private readonly ERROR_INDICATORS;
+    private readonly MISTAKE_PATTERNS;
+    /**
+     * Extract mistakes from messages and tool results.
+     *
+     * Analyzes three sources to identify mistakes:
+     * 1. Tool execution errors (failed commands, syntax errors)
+     * 2. User corrections (explicit corrections by the user)
+     * 3. Error discussions (conversations about bugs and fixes)
+     *
+     * @param messages - Array of conversation messages
+     * @param toolResults - Array of tool execution results
+     * @returns Array of extracted Mistake objects, deduplicated
+     *
+     * @example
+     * ```typescript
+     * const extractor = new MistakeExtractor();
+     * const mistakes = extractor.extractMistakes(messages, toolResults);
+     *
+     * // Find logic errors
+     * const logicErrors = mistakes.filter(m => m.mistake_type === 'logic_error');
+     * ```
+     */
+    extractMistakes(messages: Message[], toolResults: ToolResult[]): Mistake[];
+    /**
+     * Check if content is noise that should be filtered out
+     */
+    private isNoiseContent;
+    /**
+     * Extract mistakes from tool execution errors
+     */
+    private extractToolErrors;
+    /**
+     * Extract mistakes from user corrections
+     */
+    private extractUserCorrections;
+    /**
+     * Extract mistakes from error discussions in messages
+     */
+    private extractErrorDiscussions;
+    /**
+     * Classify the type of mistake
+     */
+    private classifyMistakeType;
+    /**
+     * Summarize error message - find the most descriptive error line
+     */
+    private summarizeError;
+    /**
+     * Find correction in subsequent messages
+     */
+    private findCorrection;
+    /**
+     * Extract files mentioned in error
+     */
+    private extractFilesFromError;
+    /**
+     * Extract files from message metadata
+     */
+    private extractFilesFromMessage;
+    /**
+     * Find previous assistant message
+     */
+    private findPreviousAssistantMessage;
+    /**
+     * Extract what went wrong from correction message
+     */
+    private extractWhatWentWrong;
+    /**
+     * Extract correction from user message
+     */
+    private extractCorrection;
+    /**
+     * Extract error discussion from message
+     */
+    private extractErrorDiscussion;
+    /**
+     * Extract solution from same message that discusses error
+     */
+    private extractSolutionFromSameMessage;
+    /**
+     * Deduplicate similar mistakes
+     */
+    private deduplicateMistakes;
+    /**
+     * Score mistake severity (for prioritization)
+     */
+    scoreMistakeSeverity(mistake: Mistake): number;
+}
+//# sourceMappingURL=MistakeExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MistakeExtractor.d.ts","sourceRoot":"","sources":["../../src/parsers/MistakeExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,YAAY,EAAE,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,YAAY,GAAG,cAAc,CAAC;IACpG,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qCAAqC;IACrC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAG3B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IAGxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAM7B;IAGF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAWpC;IAGF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAS/B;IAGF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAa/B;IAEF;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE;IAyB1E;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyC9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsC/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAYpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAQtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CA8B/C"}