Merge branch 'prodigy-workflow-1762310617374'

Author: iepathos

specs/166-lcov-function-name-matching-fix.md

@@ -506,20 +506,23 @@ mod tests {
                 execution_count: 10,
                 coverage_percentage: 80.0,
                 uncovered_lines: vec![2, 3],
+                normalized: crate::risk::lcov::NormalizedFunctionName::simple("func1"),
             },
             FunctionCoverage {
                 name: "func2".to_string(),
                 start_line: 10,
                 execution_count: 0,
                 coverage_percentage: 0.0,
                 uncovered_lines: vec![10, 11, 12, 13, 14],
+                normalized: crate::risk::lcov::NormalizedFunctionName::simple("func2"),
             },
             FunctionCoverage {
                 name: "func3".to_string(),
                 start_line: 20,
                 execution_count: 5,
                 coverage_percentage: 50.0,
                 uncovered_lines: vec![21, 22],
+                normalized: crate::risk::lcov::NormalizedFunctionName::simple("func3"),
             },
         ];
         functions.insert(PathBuf::from("test.rs"), function_coverages);

src/analyzers/file_analyzer.rs

@@ -457,6 +457,32 @@ pub enum Commands {
         #[arg(long, short = 'q')]
         quiet: bool,
     },
+
+    /// Explain coverage detection for a specific function (debugging tool)
+    ExplainCoverage {
+        /// Path to the codebase to analyze
+        path: PathBuf,
+
+        /// LCOV coverage file
+        #[arg(long = "coverage-file", visible_alias = "lcov")]
+        coverage_file: PathBuf,
+
+        /// Function name to explain (e.g., "create_auto_commit")
+        #[arg(long = "function")]
+        function_name: String,
+
+        /// File path containing the function (optional, helps narrow search)
+        #[arg(long = "file")]
+        file_path: Option<PathBuf>,
+
+        /// Show all attempted matching strategies
+        #[arg(long = "verbose", short = 'v')]
+        verbose: bool,
+
+        /// Output format
+        #[arg(short = 'f', long = "format", value_enum, default_value = "text")]
+        format: DebugFormatArg,
+    },
 }
 
 #[derive(Copy, Clone, Debug, PartialEq, Eq, PartialOrd, Ord, ValueEnum)]