@teamlens/core 0.1.0

package/dist/analytics/analytics-engine.d.ts

@@ -0,0 +1,45 @@
+import type { MemoryDatabase } from '../store/database.js';
+import type { TeamAnalytics, DeveloperStats, ContributorEntry, UsageTrend, ROIMetrics, HotFile } from '../types.js';
+export declare class AnalyticsEngine {
+    private db;
+    constructor(db: MemoryDatabase);
+    /** Full analytics report for the dashboard. */
+    getTeamAnalytics(days?: number): TeamAnalytics;
+    /** Dashboard overview stats with time ranges. */
+    getOverview(): {
+        today: {
+            sessions: number;
+            insights: number;
+        };
+        week: {
+            sessions: number;
+            insights: number;
+        };
+        month: {
+            sessions: number;
+            insights: number;
+        };
+        total: {
+            sessions: number;
+            insights: number;
+            developers: number;
+        };
+        topContributors: {
+            developer: string;
+            count: number;
+        }[];
+    };
+    /** Per-developer statistics. */
+    getDeveloperStats(developer: string): DeveloperStats;
+    /** Contributor leaderboard ranked by impact score. */
+    getContributorLeaderboard(limit?: number): ContributorEntry[];
+    /** Daily usage trends over the given time range. */
+    getUsageTrends(days?: number): UsageTrend[];
+    /** ROI metrics for the team. */
+    getRoiMetrics(): ROIMetrics;
+    /** Insight breakdown by category. */
+    getInsightsByType(): Record<string, number>;
+    /** Files with most insights. */
+    getHotFiles(limit?: number): HotFile[];
+}
+//# sourceMappingURL=analytics-engine.d.ts.map

package/dist/analytics/analytics-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-engine.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,OAAO,EACR,MAAM,aAAa,CAAC;AAKrB,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEtC,+CAA+C;IAC/C,gBAAgB,CAAC,IAAI,SAAK,GAAG,aAAa;IAsB1C,iDAAiD;IACjD,WAAW,IAAI;QACb,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,IAAI,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QAClE,eAAe,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACzD;IA6BD,gCAAgC;IAChC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IAwBpD,sDAAsD;IACtD,yBAAyB,CAAC,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAiCzD,oDAAoD;IACpD,cAAc,CAAC,IAAI,SAAK,GAAG,UAAU,EAAE;IAsCvC,gCAAgC;IAChC,aAAa,IAAI,UAAU;IA4B3B,qCAAqC;IACrC,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI3C,gCAAgC;IAChC,WAAW,CAAC,KAAK,SAAK,GAAG,OAAO,EAAE;CAQnC"}

package/dist/analytics/analytics-engine.js

@@ -0,0 +1,176 @@
+/** Minutes saved per insight reused — each reuse saves ~15 minutes of re-discovery time. */
+const MINUTES_PER_REUSE = 15;
+export class AnalyticsEngine {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Full analytics report for the dashboard. */
+    getTeamAnalytics(days = 30) {
+        const totalSessions = this.db.getTotalSessionCount();
+        const stats = this.db.getMemoryCount();
+        const developers = this.db.getDistinctDevelopers();
+        const avgInsightsPerSession = totalSessions > 0 ? stats.team / totalSessions : 0;
+        return {
+            overview: {
+                totalSessions,
+                totalInsights: stats.team,
+                activeDevelopers: developers.length,
+                avgInsightsPerSession: Math.round(avgInsightsPerSession * 100) / 100,
+            },
+            roi: this.getRoiMetrics(),
+            trends: this.getUsageTrends(days),
+            contributors: this.getContributorLeaderboard(),
+            hotFiles: this.getHotFiles(),
+            insightsByType: this.getInsightsByType(),
+        };
+    }
+    /** Dashboard overview stats with time ranges. */
+    getOverview() {
+        const now = new Date();
+        const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
+        const weekStart = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString();
+        const monthStart = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString();
+        const farFuture = new Date(now.getTime() + 24 * 60 * 60 * 1000).toISOString();
+        return {
+            today: {
+                sessions: this.db.getSessionsInRange(todayStart, farFuture).length,
+                insights: this.db.getTeamInsightCountSince(todayStart),
+            },
+            week: {
+                sessions: this.db.getSessionsInRange(weekStart, farFuture).length,
+                insights: this.db.getTeamInsightCountSince(weekStart),
+            },
+            month: {
+                sessions: this.db.getSessionsInRange(monthStart, farFuture).length,
+                insights: this.db.getTeamInsightCountSince(monthStart),
+            },
+            total: {
+                sessions: this.db.getTotalSessionCount(),
+                insights: this.db.getTeamInsightCount(),
+                developers: this.db.getDistinctDevelopers().length,
+            },
+            topContributors: this.db.getInsightCountsByDeveloper().slice(0, 3),
+        };
+    }
+    /** Per-developer statistics. */
+    getDeveloperStats(developer) {
+        const sessions = this.db.getSessionsByDeveloper(developer);
+        const insights = this.db.getMemoriesByAuthor(developer).filter(m => m.tier === 'team');
+        const totalDuration = sessions.reduce((sum, s) => sum + (s.durationSeconds ?? 0), 0);
+        const avgDuration = sessions.length > 0 ? totalDuration / sessions.length : 0;
+        const reuseCount = insights.reduce((sum, m) => sum + m.reuseCount, 0);
+        const lastSession = sessions[0];
+        return {
+            developer,
+            totalSessions: sessions.length,
+            totalInsights: insights.length,
+            avgSessionDuration: Math.round(avgDuration),
+            insightsPerSession: sessions.length > 0
+                ? Math.round((insights.length / sessions.length) * 100) / 100
+                : 0,
+            knowledgeReused: reuseCount,
+            lastActive: lastSession?.startedAt ?? null,
+        };
+    }
+    /** Contributor leaderboard ranked by impact score. */
+    getContributorLeaderboard(limit = 20) {
+        const insightsByDeveloper = this.db.getInsightCountsByDeveloper();
+        const allTeamMemories = this.db.getMemoriesByTier('team', false);
+        // Calculate reuse counts per developer
+        const reuseByDeveloper = new Map();
+        for (const memory of allTeamMemories) {
+            if (memory.reuseCount > 0) {
+                const current = reuseByDeveloper.get(memory.author) ?? 0;
+                reuseByDeveloper.set(memory.author, current + memory.reuseCount);
+            }
+        }
+        const entries = insightsByDeveloper.map((entry, index) => {
+            const reused = reuseByDeveloper.get(entry.developer) ?? 0;
+            return {
+                rank: index + 1,
+                developer: entry.developer,
+                insightsShared: entry.count,
+                knowledgeReused: reused,
+                impactScore: entry.count * 2 + reused * 3,
+            };
+        });
+        // Re-sort by impact score
+        entries.sort((a, b) => b.impactScore - a.impactScore);
+        // Re-rank after sorting
+        entries.forEach((e, i) => { e.rank = i + 1; });
+        return entries.slice(0, limit);
+    }
+    /** Daily usage trends over the given time range. */
+    getUsageTrends(days = 30) {
+        const sessionsByDate = this.db.getSessionCountsByDate(days);
+        const insightsByDate = this.db.getInsightCountsByDate(days);
+        const devsByDate = this.db.getActiveDevelopersByDate(days);
+        // Merge into date-keyed map
+        const dateMap = new Map();
+        // Fill in all dates in the range
+        for (let i = 0; i < days; i++) {
+            const date = new Date(Date.now() - (days - 1 - i) * 24 * 60 * 60 * 1000);
+            const dateStr = date.toISOString().split('T')[0];
+            dateMap.set(dateStr, {
+                date: dateStr,
+                sessions: 0,
+                insights: 0,
+                activeDevelopers: 0,
+            });
+        }
+        for (const entry of sessionsByDate) {
+            const existing = dateMap.get(entry.date);
+            if (existing)
+                existing.sessions = entry.count;
+        }
+        for (const entry of insightsByDate) {
+            const existing = dateMap.get(entry.date);
+            if (existing)
+                existing.insights = entry.count;
+        }
+        for (const entry of devsByDate) {
+            const existing = dateMap.get(entry.date);
+            if (existing)
+                existing.activeDevelopers = entry.count;
+        }
+        return Array.from(dateMap.values());
+    }
+    /** ROI metrics for the team. */
+    getRoiMetrics() {
+        const knowledgeReuseCount = this.db.getTotalReuseCount();
+        const estimatedHoursSaved = Math.round((knowledgeReuseCount * MINUTES_PER_REUSE / 60) * 10) / 10;
+        const totalSessions = this.db.getTotalSessionCount();
+        const totalInsights = this.db.getMemoryCount().team;
+        const totalDurationHours = this.db.getTotalSessionDuration() / 3600;
+        const insightsPerAIHour = totalDurationHours > 0
+            ? Math.round((totalInsights / totalDurationHours) * 100) / 100
+            : 0;
+        const hotFiles = this.db.getHotFiles(999);
+        const allFilesWithInsights = new Set(this.db.getMemoriesByTier('team', false).flatMap(m => m.relatedFiles));
+        const teamKnowledgeCoverage = allFilesWithInsights.size > 0
+            ? Math.min(allFilesWithInsights.size / Math.max(hotFiles.length, allFilesWithInsights.size), 1.0)
+            : 0;
+        return {
+            duplicatesPrevented: 0, // Not yet implemented
+            knowledgeReuseCount,
+            estimatedHoursSaved,
+            insightsPerAIHour,
+            teamKnowledgeCoverage: Math.round(teamKnowledgeCoverage * 100) / 100,
+        };
+    }
+    /** Insight breakdown by category. */
+    getInsightsByType() {
+        return this.db.getInsightsByCategory();
+    }
+    /** Files with most insights. */
+    getHotFiles(limit = 10) {
+        const raw = this.db.getHotFiles(limit);
+        return raw.map(r => ({
+            filePath: r.filePath,
+            insightCount: r.count,
+            lastInsight: r.lastInsight,
+        }));
+    }
+}
+//# sourceMappingURL=analytics-engine.js.map

package/dist/analytics/analytics-engine.js.map

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

package/dist/distribution/distributor.d.ts

@@ -0,0 +1,19 @@
+import type { DistributionTarget } from '../types.js';
+import type { MemoryDatabase } from '../store/database.js';
+export declare class Distributor {
+    private db;
+    private repoPath;
+    constructor(db: MemoryDatabase, repoPath: string);
+    /** Auto-detect which targets are available. Always includes claude + agents_md. */
+    detectTargets(): DistributionTarget[];
+    /** Generate config files for the given targets (auto-detect if not specified). */
+    distribute(targets?: DistributionTarget[]): {
+        generated: string[];
+        warnings: string[];
+    };
+    private generateClaudeMd;
+    private generateCursorRules;
+    private generateAgentsMd;
+    private generateCopilotInstructions;
+}
+//# sourceMappingURL=distributor.d.ts.map

package/dist/distribution/distributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributor.d.ts","sourceRoot":"","sources":["../../src/distribution/distributor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAU,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqB3D,qBAAa,WAAW;IAEpB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ;gBADR,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM;IAG1B,mFAAmF;IACnF,aAAa,IAAI,kBAAkB,EAAE;IAarC,kFAAkF;IAClF,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAiCvF,OAAO,CAAC,gBAAgB;IAoFxB,OAAO,CAAC,mBAAmB;IAoD3B,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,2BAA2B;CAapC"}

package/dist/distribution/distributor.js

@@ -0,0 +1,220 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const HEADER = '# Generated by TeamLens — do not edit manually.\n';
+const PRIORITY_ORDER = ['critical', 'high', 'normal', 'low'];
+function priorityLabel(p) {
+    return p ?? 'normal';
+}
+function groupBy(items, key) {
+    const map = new Map();
+    for (const item of items) {
+        const k = key(item);
+        const group = map.get(k) ?? [];
+        group.push(item);
+        map.set(k, group);
+    }
+    return map;
+}
+export class Distributor {
+    db;
+    repoPath;
+    constructor(db, repoPath) {
+        this.db = db;
+        this.repoPath = repoPath;
+    }
+    /** Auto-detect which targets are available. Always includes claude + agents_md. */
+    detectTargets() {
+        const targets = ['claude', 'agents_md'];
+        if (fs.existsSync(path.join(this.repoPath, '.cursor'))) {
+            targets.push('cursor');
+        }
+        if (fs.existsSync(path.join(this.repoPath, '.github'))) {
+            targets.push('copilot');
+        }
+        return targets;
+    }
+    /** Generate config files for the given targets (auto-detect if not specified). */
+    distribute(targets) {
+        const activeTargets = targets ?? this.detectTargets();
+        const rules = this.db.getRules(false);
+        const recentInsights = this.db.getRecentInsights(10);
+        const generated = [];
+        const warnings = [];
+        for (const target of activeTargets) {
+            switch (target) {
+                case 'claude':
+                    this.generateClaudeMd(rules, recentInsights, warnings);
+                    generated.push('CLAUDE.md');
+                    break;
+                case 'cursor':
+                    this.generateCursorRules(rules);
+                    generated.push('.cursor/rules/');
+                    break;
+                case 'agents_md':
+                    this.generateAgentsMd(rules);
+                    generated.push('AGENTS.md');
+                    break;
+                case 'copilot':
+                    this.generateCopilotInstructions(rules);
+                    generated.push('.github/copilot-instructions.md');
+                    break;
+            }
+        }
+        return { generated, warnings };
+    }
+    // ── CLAUDE.md ──
+    generateClaudeMd(rules, recentInsights, warnings) {
+        const filePath = path.join(this.repoPath, 'CLAUDE.md');
+        // Backup existing CLAUDE.md if it wasn't generated by us
+        if (fs.existsSync(filePath)) {
+            const existing = fs.readFileSync(filePath, 'utf-8');
+            if (!existing.startsWith('# Generated by TeamLens') && !existing.startsWith('# Generated by CodeMemory')) {
+                const backupPath = path.join(this.repoPath, 'CLAUDE.md.backup');
+                fs.writeFileSync(backupPath, existing);
+                warnings.push(`Existing CLAUDE.md backed up to CLAUDE.md.backup`);
+            }
+        }
+        let content = HEADER + '\n';
+        // Session protocol instructions — strong directives
+        content += '## TeamLens — REQUIRED Protocol\n\n';
+        content += 'This project uses TeamLens for team AI intelligence. You MUST follow this protocol:\n\n';
+        content += '### Sharing Insights (MANDATORY)\n\n';
+        content += 'After completing any significant task, you MUST call `share_insight` to share what you learned.\n';
+        content += 'Examples of when to share:\n';
+        content += '- You discovered a bug or gotcha ("The auth middleware silently swallows 401 errors")\n';
+        content += '- You figured out how something works ("Payment webhooks retry 3x with exponential backoff")\n';
+        content += '- You made an architecture decision ("Used JSONL instead of JSON for append-friendly sync")\n';
+        content += '- You found a convention ("All API routes return { data, error } shape")\n';
+        content += '- You fixed a tricky issue ("ESM imports need .js extension even for .ts files")\n\n';
+        content += '**Call `share_insight` at least once per task.** If you learned nothing worth sharing, that is rare.\n\n';
+        content += '### Querying Team Knowledge\n\n';
+        content += 'Before starting work, call `ask` to check if teammates already solved a similar problem.\n';
+        content += 'This prevents duplicate work and surfaces existing conventions.\n\n';
+        content += '### Sessions\n\n';
+        content += 'Sessions are tracked automatically — no need to start/end manually.\n\n';
+        // Recent team insights
+        if (recentInsights.length > 0) {
+            content += '## Recent Team Insights\n\n';
+            for (const insight of recentInsights.slice(0, 5)) {
+                content += `- **[${insight.category}]** ${insight.content}`;
+                if (insight.author !== 'unknown') {
+                    content += ` _(${insight.author})_`;
+                }
+                content += '\n';
+            }
+            content += '\n';
+        }
+        // Rules grouped by priority, then by category
+        if (rules.length > 0) {
+            for (const priority of PRIORITY_ORDER) {
+                const priorityRules = rules.filter((r) => priorityLabel(r.priority) === priority);
+                if (priorityRules.length === 0)
+                    continue;
+                content += `## ${priority.charAt(0).toUpperCase() + priority.slice(1)} Rules\n\n`;
+                const byCategory = groupBy(priorityRules, (r) => r.category);
+                for (const [category, categoryRules] of byCategory) {
+                    content += `### ${category.charAt(0).toUpperCase() + category.slice(1)}\n\n`;
+                    for (const rule of categoryRules) {
+                        content += `- ${rule.content}`;
+                        if (rule.scope && rule.scope.length > 0) {
+                            content += ` _(applies to: ${rule.scope.join(', ')})_`;
+                        }
+                        content += '\n';
+                        if (rule.examples) {
+                            if (rule.examples.good) {
+                                content += `  - Good: \`${rule.examples.good}\`\n`;
+                            }
+                            if (rule.examples.bad) {
+                                content += `  - Bad: \`${rule.examples.bad}\`\n`;
+                            }
+                        }
+                    }
+                    content += '\n';
+                }
+            }
+        }
+        fs.writeFileSync(filePath, content);
+    }
+    // ── .cursor/rules/ ──
+    generateCursorRules(rules) {
+        const rulesDir = path.join(this.repoPath, '.cursor', 'rules');
+        fs.mkdirSync(rulesDir, { recursive: true });
+        // Separate scoped vs global rules
+        const globalRules = rules.filter((r) => !r.scope || r.scope.length === 0);
+        const scopedRules = rules.filter((r) => r.scope && r.scope.length > 0);
+        // Global rules → _global.mdc
+        if (globalRules.length > 0) {
+            let content = '---\n';
+            content += 'description: Global project rules from TeamLens\n';
+            content += 'alwaysApply: true\n';
+            content += '---\n\n';
+            content += HEADER + '\n';
+            for (const rule of globalRules) {
+                content += `- ${rule.content}\n`;
+                if (rule.examples) {
+                    if (rule.examples.good)
+                        content += `  - Good: \`${rule.examples.good}\`\n`;
+                    if (rule.examples.bad)
+                        content += `  - Bad: \`${rule.examples.bad}\`\n`;
+                }
+            }
+            fs.writeFileSync(path.join(rulesDir, '_global.mdc'), content);
+        }
+        // Scoped rules → one .mdc per rule
+        for (const rule of scopedRules) {
+            const slug = rule.id.slice(0, 8);
+            const globs = JSON.stringify(rule.scope);
+            const summary = rule.content.slice(0, 60).replace(/[^a-zA-Z0-9 ]/g, '').trim();
+            let content = '---\n';
+            content += `description: ${summary}\n`;
+            content += `globs: ${globs}\n`;
+            content += 'alwaysApply: false\n';
+            content += '---\n\n';
+            content += rule.content + '\n';
+            if (rule.examples) {
+                content += '\n';
+                if (rule.examples.good)
+                    content += `Good: \`${rule.examples.good}\`\n`;
+                if (rule.examples.bad)
+                    content += `Bad: \`${rule.examples.bad}\`\n`;
+            }
+            fs.writeFileSync(path.join(rulesDir, `teamlens-${slug}.mdc`), content);
+        }
+    }
+    // ── AGENTS.md ──
+    generateAgentsMd(rules) {
+        const filePath = path.join(this.repoPath, 'AGENTS.md');
+        let content = HEADER + '\n';
+        const byCategory = groupBy(rules, (r) => r.category);
+        for (const [category, categoryRules] of byCategory) {
+            content += `## ${category.charAt(0).toUpperCase() + category.slice(1)}\n\n`;
+            for (const rule of categoryRules) {
+                const priorityTag = rule.priority && rule.priority !== 'normal' ? ` [${rule.priority}]` : '';
+                content += `- ${rule.content}${priorityTag}\n`;
+                if (rule.scope && rule.scope.length > 0) {
+                    content += `  - Scope: ${rule.scope.join(', ')}\n`;
+                }
+                if (rule.examples) {
+                    if (rule.examples.good)
+                        content += `  - Good: \`${rule.examples.good}\`\n`;
+                    if (rule.examples.bad)
+                        content += `  - Bad: \`${rule.examples.bad}\`\n`;
+                }
+            }
+            content += '\n';
+        }
+        fs.writeFileSync(filePath, content);
+    }
+    // ── .github/copilot-instructions.md ──
+    generateCopilotInstructions(rules) {
+        const dir = path.join(this.repoPath, '.github');
+        fs.mkdirSync(dir, { recursive: true });
+        const filePath = path.join(dir, 'copilot-instructions.md');
+        let content = HEADER + '\n';
+        for (const rule of rules) {
+            content += `- ${rule.content}\n`;
+        }
+        fs.writeFileSync(filePath, content);
+    }
+}
+//# sourceMappingURL=distributor.js.map

package/dist/distribution/distributor.js.map

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

package/dist/extractor/git-extractor.d.ts

@@ -0,0 +1,36 @@
+import { type DiffResult } from 'simple-git';
+import type { ExtractedMemory, TrackedCommit } from '../types.js';
+/**
+ * Extracts memories from git history — commits, diffs, and file changes.
+ *
+ * Uses heuristic pattern matching (no LLM required).
+ * Detects architectural decisions, migrations, refactors, and conventions
+ * from commit messages and diff patterns.
+ */
+export declare class GitExtractor {
+    private git;
+    constructor(repoPath: string);
+    /** Get recent commits not yet tracked. */
+    getRecentCommits(since?: string): Promise<TrackedCommit[]>;
+    /** Get files changed in a specific commit. */
+    getCommitFiles(sha: string): Promise<string[]>;
+    /** Get the diff stat for a specific file in a commit. */
+    getFileDiffStat(sha: string, filePath: string): Promise<{
+        insertions: number;
+        deletions: number;
+    } | null>;
+    /** Extract memories from a single commit. */
+    extractFromCommit(commit: TrackedCommit): Promise<ExtractedMemory[]>;
+    /** Get current file hash for staleness tracking. */
+    getFileHash(filePath: string): Promise<string | null>;
+    /** Get all tracked files in the repo. */
+    getTrackedFiles(): Promise<string[]>;
+    /** Get diff summary between HEAD and a previous state. */
+    getDiffSummary(fromRef: string, toRef?: string): Promise<DiffResult>;
+    private isArchitecturalCommit;
+    private isMigrationCommit;
+    private isConventionCommit;
+    private extractDecision;
+    private extractTags;
+}
+//# sourceMappingURL=git-extractor.d.ts.map

package/dist/extractor/git-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/git-extractor.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAElF;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAY;gBAEX,QAAQ,EAAE,MAAM;IAI5B,0CAA0C;IACpC,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBhE,8CAA8C;IACxC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASpD,yDAAyD;IACnD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAW/G,6CAA6C;IACvC,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqE1E,oDAAoD;IAC9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS3D,yCAAyC;IACnC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK1C,0DAA0D;IACpD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAM1E,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,WAAW;CAwBpB"}