specweave 0.11.0 → 0.12.0

package/dist/hooks/lib/run-self-reflection.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Core Reflection Engine
+ *
+ * Orchestrates the self-reflection process:
+ * 1. Load configuration
+ * 2. Get modified files
+ * 3. Build prompt
+ * 4. Invoke reflective-reviewer agent
+ * 5. Parse response
+ * 6. Store reflection
+ *
+ * @module run-self-reflection
+ */
+import { ReflectionContext, ReflectionExecutionResult } from './types/reflection-types';
+/**
+ * Run self-reflection analysis
+ * Main entry point for the reflection system
+ *
+ * @param context Reflection context with increment, task, and files
+ * @returns Reflection execution result (success or error)
+ */
+export declare function runSelfReflection(context: ReflectionContext): Promise<ReflectionExecutionResult>;
+/**
+ * Create reflection context from hook environment
+ * Helper function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional, auto-detected)
+ * @returns Reflection context ready for runSelfReflection
+ */
+export declare function createReflectionContext(incrementId: string, taskId: string, projectRoot?: string): ReflectionContext;
+/**
+ * Run reflection with automatic context creation
+ * Convenience function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional)
+ * @returns Reflection execution result
+ */
+export declare function runReflectionAuto(incrementId: string, taskId: string, projectRoot?: string): Promise<ReflectionExecutionResult>;
+//# sourceMappingURL=run-self-reflection.d.ts.map

package/dist/hooks/lib/run-self-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-self-reflection.d.ts","sourceRoot":"","sources":["../../../src/hooks/lib/run-self-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EAG1B,MAAM,0BAA0B,CAAC;AAuFlC;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,yBAAyB,CAAC,CA2FpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,iBAAiB,CAanB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAGpC"}

package/dist/hooks/lib/run-self-reflection.js

@@ -0,0 +1,203 @@
+/**
+ * Core Reflection Engine
+ *
+ * Orchestrates the self-reflection process:
+ * 1. Load configuration
+ * 2. Get modified files
+ * 3. Build prompt
+ * 4. Invoke reflective-reviewer agent
+ * 5. Parse response
+ * 6. Store reflection
+ *
+ * @module run-self-reflection
+ */
+import { loadAndValidateReflectionConfig } from './reflection-config-loader';
+import { getModifiedFiles, getModifiedFilesSummary } from './git-diff-analyzer';
+import { buildReflectionPrompt, estimatePromptTokens } from './reflection-prompt-builder';
+import { parseReflectionMarkdown, validateReflectionResult } from './reflection-parser';
+import { saveReflection } from './reflection-storage';
+import { ReflectionMode, ReflectionModel } from './types/reflection-types';
+/**
+ * Check if reflection should run for the current context
+ *
+ * @param context Reflection context with config and modified files
+ * @returns True if reflection should run
+ */
+function shouldRunReflection(context) {
+    const { config, modifiedFiles } = context;
+    // Check if reflection is enabled
+    if (!config.enabled) {
+        return false;
+    }
+    // Check mode
+    if (config.mode === ReflectionMode.DISABLED) {
+        return false;
+    }
+    if (config.mode === ReflectionMode.MANUAL) {
+        // Manual mode requires explicit invocation
+        // This function is only called in auto mode, so skip
+        return false;
+    }
+    // Check if there are modified files to analyze
+    if (modifiedFiles.length === 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Estimate reflection cost based on model and prompt size
+ *
+ * @param model Reflection model (haiku, sonnet, opus)
+ * @param promptTokens Estimated prompt token count
+ * @param responseTokens Estimated response token count (default: 2000)
+ * @returns Estimated cost in USD
+ */
+function estimateReflectionCost(model, promptTokens, responseTokens = 2000) {
+    // Pricing per 1M tokens (as of Nov 2025)
+    const pricing = {
+        [ReflectionModel.HAIKU]: { input: 0.80, output: 4.00 },
+        [ReflectionModel.SONNET]: { input: 3.00, output: 15.00 },
+        [ReflectionModel.OPUS]: { input: 15.00, output: 75.00 }
+    };
+    const modelPricing = pricing[model];
+    const inputCost = (promptTokens / 1000000) * modelPricing.input;
+    const outputCost = (responseTokens / 1000000) * modelPricing.output;
+    return inputCost + outputCost;
+}
+/**
+ * Invoke reflective-reviewer agent to analyze code
+ *
+ * @param prompt Reflection prompt
+ * @param model Model to use (haiku, sonnet, opus)
+ * @returns Agent response (markdown reflection)
+ */
+async function invokeReflectiveReviewerAgent(prompt, model) {
+    // NOTE: This is a placeholder for agent invocation
+    // In the real implementation, this would use Claude Code's Task tool
+    // to invoke the specweave:reflective-reviewer:reflective-reviewer agent
+    //
+    // For now, we'll return a mock response to enable testing
+    // The actual implementation will be in the hook integration (T-008)
+    throw new Error('Agent invocation not implemented yet. ' +
+        'This function will be implemented in hook integration (T-008). ' +
+        'Call this from the post-task-completion hook using the Task tool.');
+}
+/**
+ * Run self-reflection analysis
+ * Main entry point for the reflection system
+ *
+ * @param context Reflection context with increment, task, and files
+ * @returns Reflection execution result (success or error)
+ */
+export async function runSelfReflection(context) {
+    const { incrementId, taskId, modifiedFiles, config } = context;
+    const startTime = Date.now();
+    try {
+        // Step 1: Check if reflection should run
+        if (!shouldRunReflection(context)) {
+            return {
+                success: true,
+                result: undefined,
+                error: undefined
+            };
+        }
+        // Step 2: Build reflection prompt
+        const prompt = buildReflectionPrompt({
+            taskId,
+            taskName: `Task ${taskId}`, // Will be enhanced with actual task name in hook
+            modifiedFiles,
+            config,
+            incrementId,
+            includeFullDiff: false // Use simplified prompt for token efficiency
+        });
+        // Step 3: Estimate cost
+        const promptTokens = estimatePromptTokens(prompt);
+        const estimatedCost = estimateReflectionCost(config.model, promptTokens);
+        // Step 4: Invoke reflective-reviewer agent
+        const agentResponse = await invokeReflectiveReviewerAgent(prompt, config.model);
+        // Step 5: Parse response
+        const endTime = Date.now();
+        const reflectionTime = Math.round((endTime - startTime) / 1000); // seconds
+        const reflectionResult = parseReflectionMarkdown(agentResponse, `Task ${taskId}`, config.model, reflectionTime, estimatedCost);
+        // Step 6: Add file modification stats
+        const fileStats = getModifiedFilesSummary(modifiedFiles);
+        reflectionResult.filesModified = {
+            count: fileStats.count,
+            linesAdded: fileStats.linesAdded,
+            linesRemoved: fileStats.linesRemoved
+        };
+        // Step 7: Validate reflection result
+        const validation = validateReflectionResult(reflectionResult);
+        if (!validation.valid) {
+            return {
+                success: false,
+                error: {
+                    message: 'Reflection validation failed',
+                    code: 'VALIDATION_ERROR',
+                    details: validation.errors
+                }
+            };
+        }
+        // Step 8: Store reflection (if enabled)
+        if (config.storeReflections) {
+            try {
+                saveReflection(reflectionResult, incrementId, taskId);
+            }
+            catch (storageError) {
+                // Storage failure shouldn't fail the entire reflection
+                console.warn(`Failed to store reflection: ${storageError.message}`);
+            }
+        }
+        // Step 9: Return success
+        return {
+            success: true,
+            result: reflectionResult
+        };
+    }
+    catch (error) {
+        // Graceful degradation: Return error but don't throw
+        return {
+            success: false,
+            error: {
+                message: error.message || 'Unknown error during reflection',
+                code: 'REFLECTION_ERROR',
+                details: error.stack
+            }
+        };
+    }
+}
+/**
+ * Create reflection context from hook environment
+ * Helper function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional, auto-detected)
+ * @returns Reflection context ready for runSelfReflection
+ */
+export function createReflectionContext(incrementId, taskId, projectRoot) {
+    // Load and validate configuration
+    const config = loadAndValidateReflectionConfig(projectRoot);
+    // Get modified files from git
+    const modifiedFiles = getModifiedFiles(projectRoot);
+    return {
+        incrementId,
+        taskId,
+        modifiedFiles,
+        config
+    };
+}
+/**
+ * Run reflection with automatic context creation
+ * Convenience function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional)
+ * @returns Reflection execution result
+ */
+export async function runReflectionAuto(incrementId, taskId, projectRoot) {
+    const context = createReflectionContext(incrementId, taskId, projectRoot);
+    return runSelfReflection(context);
+}
+//# sourceMappingURL=run-self-reflection.js.map

package/dist/hooks/lib/run-self-reflection.js.map

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

package/dist/hooks/lib/types/reflection-types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Type definitions for AI Self-Reflection System
+ * @module reflection-types
+ */
+/**
+ * Severity levels for identified issues
+ */
+export declare enum IssueSeverity {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW"
+}
+/**
+ * Issue categories
+ */
+export declare enum IssueCategory {
+    SECURITY = "SECURITY",
+    QUALITY = "QUALITY",
+    TESTING = "TESTING",
+    PERFORMANCE = "PERFORMANCE",
+    TECHNICAL_DEBT = "TECHNICAL_DEBT"
+}
+/**
+ * Reflection depth modes
+ */
+export declare enum ReflectionDepth {
+    QUICK = "quick",// <15s, critical issues only
+    STANDARD = "standard",// <30s, full analysis (default)
+    DEEP = "deep"
+}
+/**
+ * AI model selection for reflection
+ */
+export declare enum ReflectionModel {
+    HAIKU = "haiku",// Fast, cheap (~$0.01/task)
+    SONNET = "sonnet",// Balanced (~$0.05/task)
+    OPUS = "opus"
+}
+/**
+ * Reflection execution mode
+ */
+export declare enum ReflectionMode {
+    AUTO = "auto",// Automatic after task completion
+    MANUAL = "manual",// User-triggered only
+    DISABLED = "disabled"
+}
+/**
+ * Issue identified during reflection
+ */
+export interface ReflectionIssue {
+    severity: IssueSeverity;
+    category: IssueCategory;
+    description: string;
+    impact: string;
+    recommendation: string;
+    location?: {
+        file: string;
+        line?: number;
+        snippet?: string;
+    };
+}
+/**
+ * Lesson learned from task execution
+ */
+export interface LessonLearned {
+    whatWentWell: string[];
+    whatCouldImprove: string[];
+    forNextTime: string[];
+}
+/**
+ * Quality metrics from reflection
+ */
+export interface ReflectionMetrics {
+    codeQuality: number;
+    security: number;
+    testCoverage?: number;
+    technicalDebt: 'LOW' | 'MEDIUM' | 'HIGH';
+    performance: 'GOOD' | 'ACCEPTABLE' | 'NEEDS_WORK';
+}
+/**
+ * Complete reflection result
+ */
+export interface ReflectionResult {
+    taskName: string;
+    completed: string;
+    duration?: string;
+    filesModified: {
+        count: number;
+        linesAdded: number;
+        linesRemoved: number;
+    };
+    accomplishments: string[];
+    strengths: string[];
+    issues: ReflectionIssue[];
+    recommendedActions: {
+        priority1: string[];
+        priority2: string[];
+        priority3: string[];
+    };
+    lessonsLearned: LessonLearned;
+    metrics: ReflectionMetrics;
+    relatedTasks?: string[];
+    metadata: {
+        model: ReflectionModel;
+        reflectionTime: number;
+        estimatedCost: number;
+    };
+}
+/**
+ * Configuration for reflection system
+ */
+export interface ReflectionConfig {
+    enabled: boolean;
+    mode: ReflectionMode;
+    depth: ReflectionDepth;
+    model: ReflectionModel;
+    categories: {
+        security: boolean;
+        quality: boolean;
+        testing: boolean;
+        performance: boolean;
+        technicalDebt: boolean;
+    };
+    criticalThreshold: IssueSeverity;
+    storeReflections: boolean;
+    autoCreateFollowUpTasks: boolean;
+    soundNotifications?: boolean;
+}
+/**
+ * Git diff information for modified files
+ */
+export interface GitDiffInfo {
+    file: string;
+    linesAdded: number;
+    linesRemoved: number;
+    content: string;
+}
+/**
+ * Context for reflection execution
+ */
+export interface ReflectionContext {
+    incrementId: string;
+    taskId: string;
+    modifiedFiles: GitDiffInfo[];
+    config: ReflectionConfig;
+}
+/**
+ * Reflection execution result (success or failure)
+ */
+export interface ReflectionExecutionResult {
+    success: boolean;
+    result?: ReflectionResult;
+    error?: {
+        message: string;
+        code: string;
+        details?: any;
+    };
+}
+/**
+ * Default reflection configuration
+ */
+export declare const DEFAULT_REFLECTION_CONFIG: ReflectionConfig;
+//# sourceMappingURL=reflection-types.d.ts.map

package/dist/hooks/lib/types/reflection-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-types.d.ts","sourceRoot":"","sources":["../../../../src/hooks/lib/types/reflection-types.ts"],"names":[],"mappings":"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"}

package/dist/hooks/lib/types/reflection-types.js

@@ -0,0 +1,73 @@
+/**
+ * Type definitions for AI Self-Reflection System
+ * @module reflection-types
+ */
+/**
+ * Severity levels for identified issues
+ */
+export var IssueSeverity;
+(function (IssueSeverity) {
+    IssueSeverity["CRITICAL"] = "CRITICAL";
+    IssueSeverity["HIGH"] = "HIGH";
+    IssueSeverity["MEDIUM"] = "MEDIUM";
+    IssueSeverity["LOW"] = "LOW";
+})(IssueSeverity || (IssueSeverity = {}));
+/**
+ * Issue categories
+ */
+export var IssueCategory;
+(function (IssueCategory) {
+    IssueCategory["SECURITY"] = "SECURITY";
+    IssueCategory["QUALITY"] = "QUALITY";
+    IssueCategory["TESTING"] = "TESTING";
+    IssueCategory["PERFORMANCE"] = "PERFORMANCE";
+    IssueCategory["TECHNICAL_DEBT"] = "TECHNICAL_DEBT";
+})(IssueCategory || (IssueCategory = {}));
+/**
+ * Reflection depth modes
+ */
+export var ReflectionDepth;
+(function (ReflectionDepth) {
+    ReflectionDepth["QUICK"] = "quick";
+    ReflectionDepth["STANDARD"] = "standard";
+    ReflectionDepth["DEEP"] = "deep"; // <60s, detailed + architectural
+})(ReflectionDepth || (ReflectionDepth = {}));
+/**
+ * AI model selection for reflection
+ */
+export var ReflectionModel;
+(function (ReflectionModel) {
+    ReflectionModel["HAIKU"] = "haiku";
+    ReflectionModel["SONNET"] = "sonnet";
+    ReflectionModel["OPUS"] = "opus"; // Deep analysis (~$0.15/task)
+})(ReflectionModel || (ReflectionModel = {}));
+/**
+ * Reflection execution mode
+ */
+export var ReflectionMode;
+(function (ReflectionMode) {
+    ReflectionMode["AUTO"] = "auto";
+    ReflectionMode["MANUAL"] = "manual";
+    ReflectionMode["DISABLED"] = "disabled"; // Reflection disabled
+})(ReflectionMode || (ReflectionMode = {}));
+/**
+ * Default reflection configuration
+ */
+export const DEFAULT_REFLECTION_CONFIG = {
+    enabled: true,
+    mode: ReflectionMode.AUTO,
+    depth: ReflectionDepth.STANDARD,
+    model: ReflectionModel.HAIKU,
+    categories: {
+        security: true,
+        quality: true,
+        testing: true,
+        performance: true,
+        technicalDebt: true
+    },
+    criticalThreshold: IssueSeverity.MEDIUM,
+    storeReflections: true,
+    autoCreateFollowUpTasks: false,
+    soundNotifications: false
+};
+//# sourceMappingURL=reflection-types.js.map

package/dist/hooks/lib/types/reflection-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-types.js","sourceRoot":"","sources":["../../../../src/hooks/lib/types/reflection-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,kDAAiC,CAAA;AACnC,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IACrB,gCAAa,CAAA,CAAU,iCAAiC;AAC1D,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,gCAAa,CAAA,CAAQ,8BAA8B;AACrD,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,mCAAiB,CAAA;IACjB,uCAAqB,CAAA,CAAC,sBAAsB;AAC9C,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AA0HD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,cAAc,CAAC,IAAI;IACzB,KAAK,EAAE,eAAe,CAAC,QAAQ;IAC/B,KAAK,EAAE,eAAe,CAAC,KAAK;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;KACpB;IACD,iBAAiB,EAAE,aAAa,CAAC,MAAM;IACvC,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,KAAK;IAC9B,kBAAkB,EAAE,KAAK;CAC1B,CAAC"}

package/dist/plugins/specweave/lib/hooks/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/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-analyzer.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/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"}