specweave 0.17.0 → 0.17.1

package/dist/core/phase-detector.js

@@ -0,0 +1,229 @@
+/**
+ * Phase Detector
+ *
+ * Multi-signal phase detection algorithm that analyzes user prompts and context
+ * to determine whether work is in planning, execution, or review phase.
+ *
+ * Uses 4 signals with weighted scoring:
+ * 1. Keyword analysis (40%) - Planning/execution/review keywords
+ * 2. Command analysis (30%) - Slash commands hint at phase
+ * 3. Context analysis (20%) - Increment state, file types
+ * 4. Explicit hints (10%) - User explicitly states phase
+ *
+ * Target accuracy: >95%
+ */
+export class PhaseDetector {
+    constructor() {
+        // Keyword dictionaries for each phase
+        this.planningKeywords = [
+            'plan', 'design', 'analyze', 'research', 'architecture', 'decide',
+            'strategy', 'requirements', 'specification', 'feasibility', 'explore',
+            'brainstorm', 'assess', 'evaluate', 'investigate', 'study', 'conceive',
+            'blueprint', 'roadmap', 'scope', 'estimate', 'proposal'
+        ];
+        this.executionKeywords = [
+            'implement', 'build', 'create', 'write', 'code', 'generate',
+            'develop', 'construct', 'refactor', 'fix', 'update', 'modify',
+            'add', 'delete', 'remove', 'change', 'integrate', 'deploy',
+            'setup', 'configure', 'install', 'run', 'execute'
+        ];
+        this.reviewKeywords = [
+            'review', 'validate', 'audit', 'assess', 'check', 'verify',
+            'test', 'evaluate', 'inspect', 'examine', 'quality',
+            'debug', 'troubleshoot', 'analyze error', 'find bug', 'measure'
+        ];
+        // Command-to-phase mapping
+        this.commandPhaseMap = {
+            '/specweave.inc': 'planning',
+            '/specweave': 'planning',
+            '/increment': 'planning',
+            '/specweave.do': 'execution',
+            '/do': 'execution',
+            '/specweave.validate': 'review',
+            '/validate': 'review',
+            '/specweave.done': 'review',
+            '/spec-driven-brainstorming': 'planning',
+        };
+    }
+    /**
+     * Detect phase from user prompt and execution context
+     */
+    detect(prompt, context = {}) {
+        const scores = {
+            planning: 0,
+            execution: 0,
+            review: 0,
+        };
+        const signals = {
+            keywords: [],
+            context: [],
+        };
+        // Signal 1: Keyword analysis (40% weight)
+        const keywordScore = this.analyzeKeywords(prompt, scores, signals);
+        // Signal 2: Command analysis (30% weight)
+        const commandScore = this.analyzeCommand(context, scores, signals);
+        // Signal 3: Context analysis (20% weight)
+        const contextScore = this.analyzeContext(context, scores, signals);
+        // Signal 4: Explicit hints (10% weight)
+        const hintScore = this.analyzeHints(prompt, scores, signals);
+        // Calculate total signal strength
+        const totalSignals = keywordScore + commandScore + contextScore + hintScore;
+        // Determine winning phase
+        const phase = Object.keys(scores).reduce((a, b) => scores[a] > scores[b] ? a : b);
+        // Calculate confidence (normalized score of winning phase)
+        const maxScore = Math.max(...Object.values(scores));
+        const confidence = maxScore > 0 ? scores[phase] / maxScore : 0.5;
+        return {
+            phase,
+            confidence,
+            signals,
+            reasoning: this.generateReasoning(phase, confidence, signals, totalSignals),
+        };
+    }
+    /**
+     * Analyze keywords in prompt
+     */
+    analyzeKeywords(prompt, scores, signals) {
+        const lowerPrompt = prompt.toLowerCase();
+        let matchCount = 0;
+        // Check planning keywords
+        for (const keyword of this.planningKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.planning++;
+                if (signals.keywords.length < 5) { // Limit to first 5
+                    signals.keywords.push(`planning:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        // Check execution keywords
+        for (const keyword of this.executionKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.execution++;
+                if (signals.keywords.length < 5) {
+                    signals.keywords.push(`execution:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        // Check review keywords
+        for (const keyword of this.reviewKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.review++;
+                if (signals.keywords.length < 5) {
+                    signals.keywords.push(`review:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        return matchCount > 0 ? 1 : 0;
+    }
+    /**
+     * Analyze command hints
+     */
+    analyzeCommand(context, scores, signals) {
+        if (context.command && this.commandPhaseMap[context.command]) {
+            const phase = this.commandPhaseMap[context.command];
+            scores[phase] += 3; // Strong signal
+            signals.command = context.command;
+            return 1;
+        }
+        return 0;
+    }
+    /**
+     * Analyze execution context
+     */
+    analyzeContext(context, scores, signals) {
+        let signalCount = 0;
+        // Increment state signals
+        if (context.incrementState === 'backlog' || context.incrementState === 'planned') {
+            scores.planning++;
+            signals.context.push(`increment:${context.incrementState}`);
+            signalCount++;
+        }
+        else if (context.incrementState === 'in-progress') {
+            scores.execution++;
+            signals.context.push('increment:in-progress');
+            signalCount++;
+        }
+        else if (context.incrementState === 'completed') {
+            scores.review++;
+            signals.context.push('increment:completed');
+            signalCount++;
+        }
+        // File modification signals
+        if (context.filesModified && context.filesModified.length > 0) {
+            const hasArchitectureDocs = context.filesModified.some(f => f.includes('/architecture/') || f.includes('/adr/') || f.includes('spec.md') || f.includes('plan.md'));
+            const hasCodeFiles = context.filesModified.some(f => f.endsWith('.ts') || f.endsWith('.js') || f.endsWith('.py') ||
+                f.endsWith('.tsx') || f.endsWith('.jsx') || f.endsWith('.java'));
+            const hasTestFiles = context.filesModified.some(f => f.includes('.test.') || f.includes('.spec.') || f.includes('__tests__/'));
+            if (hasArchitectureDocs) {
+                scores.planning++;
+                signals.context.push('files:architecture-docs');
+                signalCount++;
+            }
+            if (hasCodeFiles) {
+                scores.execution++;
+                signals.context.push('files:code-files');
+                signalCount++;
+            }
+            if (hasTestFiles) {
+                scores.review++;
+                signals.context.push('files:test-files');
+                signalCount++;
+            }
+        }
+        return signalCount > 0 ? 1 : 0;
+    }
+    /**
+     * Analyze explicit hints in prompt
+     */
+    analyzeHints(prompt, scores, signals) {
+        const lowerPrompt = prompt.toLowerCase();
+        // Explicit phase mentions
+        if (lowerPrompt.includes('planning phase') || lowerPrompt.includes('plan for')) {
+            scores.planning += 2;
+            return 1;
+        }
+        if (lowerPrompt.includes('implementation') || lowerPrompt.includes('execution phase') || lowerPrompt.includes('build phase')) {
+            scores.execution += 2;
+            return 1;
+        }
+        if (lowerPrompt.includes('review phase') || lowerPrompt.includes('validation phase')) {
+            scores.review += 2;
+            return 1;
+        }
+        return 0;
+    }
+    /**
+     * Generate human-readable reasoning
+     */
+    generateReasoning(phase, confidence, signals, totalSignals) {
+        const reasons = [];
+        if (signals.command) {
+            reasons.push(`command '${signals.command}' indicates ${phase}`);
+        }
+        const planningKeywords = signals.keywords.filter(k => k.startsWith('planning:')).map(k => k.substring(9));
+        const executionKeywords = signals.keywords.filter(k => k.startsWith('execution:')).map(k => k.substring(10));
+        const reviewKeywords = signals.keywords.filter(k => k.startsWith('review:')).map(k => k.substring(7));
+        if (planningKeywords.length > 0) {
+            reasons.push(`planning keywords: ${planningKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (executionKeywords.length > 0) {
+            reasons.push(`execution keywords: ${executionKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (reviewKeywords.length > 0) {
+            reasons.push(`review keywords: ${reviewKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (signals.context.length > 0) {
+            reasons.push(`context: ${signals.context.join(', ')}`);
+        }
+        const confidencePercent = (confidence * 100).toFixed(0);
+        const signalStrength = totalSignals >= 3 ? 'strong' : totalSignals >= 2 ? 'moderate' : 'weak';
+        if (reasons.length === 0) {
+            return `${phase} phase (${confidencePercent}% confidence, ${signalStrength} signals) - defaulting due to low signal`;
+        }
+        return `${phase} phase (${confidencePercent}% confidence, ${signalStrength} signals) - ${reasons.join('; ')}`;
+    }
+}
+//# sourceMappingURL=phase-detector.js.map

package/dist/core/phase-detector.js.map

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

package/dist/core/spec-task-mapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Spec-Task Mapper for SpecWeave
+ *
+ * Maps tasks to spec user stories based on AC-IDs (Acceptance Criteria IDs).
+ * Enables traceability from increment tasks back to living docs specs.
+ */
+export interface UserStory {
+    id: string;
+    title: string;
+    description?: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+}
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    priority?: string;
+    testable: boolean;
+    completed: boolean;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    acIds: string[];
+    completed: boolean;
+    userStories: string[];
+}
+export interface SpecTaskMapping {
+    specId: string;
+    specPath: string;
+    incrementId: string;
+    incrementPath: string;
+    userStories: UserStory[];
+    tasks: Task[];
+    mappings: TaskToUserStoryMapping[];
+}
+export interface TaskToUserStoryMapping {
+    taskId: string;
+    userStoryIds: string[];
+    acIds: string[];
+    completed: boolean;
+}
+/**
+ * Parse spec.md to extract user stories and acceptance criteria
+ */
+export declare function parseSpec(specPath: string): Promise<UserStory[]>;
+/**
+ * Parse tasks.md to extract tasks with AC-IDs
+ */
+export declare function parseTasks(tasksPath: string): Promise<Task[]>;
+/**
+ * Create mapping between tasks and user stories
+ */
+export declare function createTaskToUserStoryMapping(tasks: Task[], userStories: UserStory[]): TaskToUserStoryMapping[];
+/**
+ * Get full mapping for an increment
+ */
+export declare function getSpecTaskMapping(incrementPath: string, specPath?: string): Promise<SpecTaskMapping | null>;
+/**
+ * Get completed user stories from mappings
+ */
+export declare function getCompletedUserStories(mapping: SpecTaskMapping): UserStory[];
+/**
+ * Get recently completed tasks (completed since last sync)
+ */
+export declare function getRecentlyCompletedTasks(mapping: SpecTaskMapping, lastSyncDate?: Date): Task[];
+/**
+ * Find spec path for an increment
+ */
+export declare function findSpecForIncrement(incrementPath: string): Promise<string | null>;
+//# sourceMappingURL=spec-task-mapper.d.ts.map

package/dist/core/spec-task-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-task-mapper.d.ts","sourceRoot":"","sources":["../../src/core/spec-task-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA+CtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAmDnE;AAWD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,EAAE,EACb,WAAW,EAAE,SAAS,EAAE,GACvB,sBAAsB,EAAE,CAa1B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA6DjC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,SAAS,EAAE,CAeb;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,IAAI,GAClB,IAAI,EAAE,CASR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/core/spec-task-mapper.js

@@ -0,0 +1,208 @@
+/**
+ * Spec-Task Mapper for SpecWeave
+ *
+ * Maps tasks to spec user stories based on AC-IDs (Acceptance Criteria IDs).
+ * Enables traceability from increment tasks back to living docs specs.
+ */
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Parse spec.md to extract user stories and acceptance criteria
+ */
+export async function parseSpec(specPath) {
+    const content = await fs.readFile(specPath, 'utf-8');
+    const userStories = [];
+    // Match user story patterns:
+    // **US-001**: As a developer, I want...
+    const userStoryRegex = /\*\*US-(\d+)\*\*:\s*(.+)/g;
+    const matches = [...content.matchAll(userStoryRegex)];
+    for (const match of matches) {
+        const usNumber = match[1];
+        const usId = `US-${usNumber}`;
+        const title = match[2].trim();
+        // Find acceptance criteria for this user story
+        // Pattern: - [x] **AC-US1-01**: Description (P1, testable)
+        const acRegex = new RegExp(`- \\[([ x])\\] \\*\\*AC-US${usNumber}-(\\d+)\\*\\*:\\s*([^(]+)(?:\\(([^)]+)\\))?`, 'g');
+        const acceptanceCriteria = [];
+        const acMatches = [...content.matchAll(acRegex)];
+        for (const acMatch of acMatches) {
+            const completed = acMatch[1] === 'x';
+            const acNumber = acMatch[2];
+            const description = acMatch[3].trim();
+            const metadata = acMatch[4] || '';
+            acceptanceCriteria.push({
+                id: `AC-US${usNumber}-${acNumber}`,
+                description,
+                priority: metadata.includes('P1') ? 'P1' : metadata.includes('P2') ? 'P2' : undefined,
+                testable: metadata.includes('testable'),
+                completed,
+            });
+        }
+        userStories.push({
+            id: usId,
+            title,
+            acceptanceCriteria,
+        });
+    }
+    return userStories;
+}
+/**
+ * Parse tasks.md to extract tasks with AC-IDs
+ */
+export async function parseTasks(tasksPath) {
+    const content = await fs.readFile(tasksPath, 'utf-8');
+    const tasks = [];
+    // Match task patterns:
+    // ## T-001: Task Title
+    const taskRegex = /##\s+T-(\d+):\s*(.+)/g;
+    const taskMatches = [...content.matchAll(taskRegex)];
+    for (const match of taskMatches) {
+        const taskNumber = match[1];
+        const taskId = `T-${taskNumber}`;
+        const title = match[2].trim();
+        // Extract AC-IDs for this task
+        // Pattern: **AC**: AC-US1-01, AC-US1-02, AC-US2-01
+        const taskSection = extractTaskSection(content, taskId);
+        const acLine = taskSection.match(/\*\*AC\*\*:\s*(.+)/);
+        const acIds = [];
+        if (acLine) {
+            const acText = acLine[1];
+            const acMatches = acText.matchAll(/AC-US\d+-\d+/g);
+            for (const acMatch of acMatches) {
+                acIds.push(acMatch[0]);
+            }
+        }
+        // Derive user story IDs from AC-IDs
+        const userStories = [...new Set(acIds.map(acId => {
+                const match = acId.match(/AC-US(\d+)-/);
+                return match ? `US-${match[1]}` : null;
+            }).filter(Boolean))];
+        // Check if task is completed
+        // Pattern: [x] T-001 or - [x] T-001
+        const completedRegex = new RegExp(`\\[(x)\\]\\s+T-${taskNumber}\\b`, 'i');
+        const completed = completedRegex.test(content);
+        tasks.push({
+            id: taskId,
+            title,
+            acIds,
+            userStories,
+            completed,
+        });
+    }
+    return tasks;
+}
+/**
+ * Extract task section from tasks.md content
+ */
+function extractTaskSection(content, taskId) {
+    const taskRegex = new RegExp(`##\\s+${taskId}:(.+?)(?=##\\s+T-\\d+:|---|\$)`, 's');
+    const match = content.match(taskRegex);
+    return match ? match[1] : '';
+}
+/**
+ * Create mapping between tasks and user stories
+ */
+export function createTaskToUserStoryMapping(tasks, userStories) {
+    const mappings = [];
+    for (const task of tasks) {
+        mappings.push({
+            taskId: task.id,
+            userStoryIds: task.userStories,
+            acIds: task.acIds,
+            completed: task.completed,
+        });
+    }
+    return mappings;
+}
+/**
+ * Get full mapping for an increment
+ */
+export async function getSpecTaskMapping(incrementPath, specPath) {
+    try {
+        // Read increment spec.md
+        const incrementSpecPath = path.join(incrementPath, 'spec.md');
+        const incrementSpec = await fs.readFile(incrementSpecPath, 'utf-8');
+        // Extract spec ID from increment spec
+        // Pattern: **Implements**: SPEC-001-core-framework-architecture
+        const specIdMatch = incrementSpec.match(/\*\*Implements\*\*:\s*SPEC-(\d+)-/);
+        const specId = specIdMatch ? `spec-${specIdMatch[1]}` : null;
+        if (!specId && !specPath) {
+            // No spec linked to this increment
+            return null;
+        }
+        // Determine spec path
+        let actualSpecPath = specPath;
+        if (!actualSpecPath && specId) {
+            // Try to find spec in living docs
+            const projectRoot = incrementPath.split('.specweave')[0];
+            const possiblePaths = [
+                path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs', `${specId}-*.md`),
+                path.join(projectRoot, '.specweave', 'docs', 'internal', 'projects', 'default', 'specs', `${specId}-*.md`),
+            ];
+            for (const possiblePath of possiblePaths) {
+                const glob = await import('glob');
+                const matches = glob.sync(possiblePath);
+                if (matches.length > 0) {
+                    actualSpecPath = matches[0];
+                    break;
+                }
+            }
+        }
+        if (!actualSpecPath) {
+            return null;
+        }
+        // Parse spec and tasks
+        const userStories = await parseSpec(actualSpecPath);
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        const tasks = await parseTasks(tasksPath);
+        // Create mappings
+        const mappings = createTaskToUserStoryMapping(tasks, userStories);
+        return {
+            specId: specId || 'unknown',
+            specPath: actualSpecPath,
+            incrementId: path.basename(incrementPath),
+            incrementPath,
+            userStories,
+            tasks,
+            mappings,
+        };
+    }
+    catch (error) {
+        console.error(`Failed to get spec-task mapping: ${error.message}`);
+        return null;
+    }
+}
+/**
+ * Get completed user stories from mappings
+ */
+export function getCompletedUserStories(mapping) {
+    const completedUSIds = new Set();
+    // Find user stories where ALL tasks are complete
+    for (const us of mapping.userStories) {
+        const relatedTasks = mapping.tasks.filter(t => t.userStories.includes(us.id));
+        if (relatedTasks.length > 0 && relatedTasks.every(t => t.completed)) {
+            completedUSIds.add(us.id);
+        }
+    }
+    return mapping.userStories.filter(us => completedUSIds.has(us.id));
+}
+/**
+ * Get recently completed tasks (completed since last sync)
+ */
+export function getRecentlyCompletedTasks(mapping, lastSyncDate) {
+    // If no last sync date, return all completed tasks
+    if (!lastSyncDate) {
+        return mapping.tasks.filter(t => t.completed);
+    }
+    // For now, return all completed tasks
+    // In the future, we could track completion timestamps in metadata
+    return mapping.tasks.filter(t => t.completed);
+}
+/**
+ * Find spec path for an increment
+ */
+export async function findSpecForIncrement(incrementPath) {
+    const mapping = await getSpecTaskMapping(incrementPath);
+    return mapping?.specPath || null;
+}
+//# sourceMappingURL=spec-task-mapper.js.map

package/dist/core/spec-task-mapper.js.map

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

package/dist/hooks/lib/git-diff-analyzer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Git Diff Analyzer
+ *
+ * Extracts modified files from git diff for reflection analysis
+ * Parses git diff output to get file changes, line counts, and content
+ *
+ * @module git-diff-analyzer
+ */
+import { GitDiffInfo } from './types/reflection-types';
+/**
+ * Check if directory is a git repository
+ * @param dir Directory to check (defaults to cwd)
+ * @returns True if directory is in a git repository
+ */
+export declare function isGitRepository(dir?: string): boolean;
+/**
+ * Get list of modified files in the working directory
+ * Includes both staged and unstaged changes
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @returns Array of file paths relative to git root
+ */
+export declare function getModifiedFilesList(cwd?: string): string[];
+/**
+ * Parse git diff numstat output to get line counts
+ * Format: <added>\t<removed>\t<filename>
+ *
+ * @param numstatOutput Output from git diff --numstat
+ * @returns Map of filename to {added, removed} counts
+ */
+export declare function parseNumstat(numstatOutput: string): Map<string, {
+    added: number;
+    removed: number;
+}>;
+/**
+ * Get diff content for a specific file
+ * @param file File path relative to git root
+ * @param cwd Working directory (optional)
+ * @returns Diff content as string
+ */
+export declare function getFileDiff(file: string, cwd?: string): string;
+/**
+ * Get current file content
+ * @param file File path (can be absolute or relative to cwd)
+ * @param cwd Working directory (optional)
+ * @returns File content as string, or empty string if file doesn't exist
+ */
+export declare function getFileContent(file: string, cwd?: string): string;
+/**
+ * Get modified files with diff information
+ * Main function for reflection analysis
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @param maxFiles Maximum number of files to return (optional, defaults to 100)
+ * @returns Array of GitDiffInfo objects with file changes
+ */
+export declare function getModifiedFiles(cwd?: string, maxFiles?: number): GitDiffInfo[];
+/**
+ * Get summary statistics for modified files
+ * Useful for reflection metadata
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @returns Summary with file count, total lines added/removed
+ */
+export declare function getModifiedFilesSummary(modifiedFiles: GitDiffInfo[]): {
+    count: number;
+    linesAdded: number;
+    linesRemoved: number;
+    totalChanges: number;
+};
+/**
+ * Filter files by extension
+ * Useful for focusing reflection on specific file types
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param extensions Array of file extensions (e.g., ['.ts', '.js'])
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function filterFilesByExtension(modifiedFiles: GitDiffInfo[], extensions: string[]): GitDiffInfo[];
+/**
+ * Exclude files matching patterns
+ * Useful for excluding generated files, test files, etc.
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param patterns Array of glob patterns to exclude
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function excludeFilesByPattern(modifiedFiles: GitDiffInfo[], patterns: string[]): GitDiffInfo[];
+//# sourceMappingURL=git-diff-analyzer.d.ts.map

package/dist/hooks/lib/git-diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-analyzer.d.ts","sourceRoot":"","sources":["../../../src/hooks/lib/git-diff-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAqBvD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBnG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAajE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAY,GACrB,WAAW,EAAE,CA8Cf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,WAAW,EAAE,EAC5B,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW,EAAE,CAKf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,WAAW,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAAE,GACjB,WAAW,EAAE,CAQf"}