feat(logging): add configurable logging with file output support

Introduce --log-level and --log-file CLI arguments.
Add execution time tracking and detailed logs across all modules.

tests/test_pipeline.py

@@ -122,6 +122,29 @@ class PipelineTests(unittest.TestCase):
             self.assertIn("Code Root", overview)
             self.assertIn("Docs Root", overview)
 
+    def test_pipeline_emits_stage_logs(self) -> None:
+        with TemporaryDirectory() as tmp:
+            tmp_path = Path(tmp)
+            project_root = tmp_path / "project"
+            output_root = tmp_path / "workspace"
+            (project_root / "Flows").mkdir(parents=True)
+            (project_root / "Flows" / "Active.xaml").write_text(ACTIVE_XAML, encoding="utf-8")
+            (project_root / "Flows" / "Old.xaml").write_text(OLD_XAML, encoding="utf-8")
+            (project_root / "Scripts").mkdir()
+            (project_root / "Scripts" / "Keep.bas").write_text("Sub Keep()\nEnd Sub", encoding="utf-8")
+            (project_root / "Scripts" / "Drop.bas").write_text("Sub Drop()\nEnd Sub", encoding="utf-8")
+            (project_root / "main.xaml").write_text(MAIN_XAML, encoding="utf-8")
+
+            with self.assertLogs("uipath_explainator", level="INFO") as captured:
+                ProjectPipeline(project_root, output_root, "main.xaml", force=True).run(StubAnalyzer())
+
+            combined = "\n".join(captured.output)
+            self.assertIn("Starting pipeline:", combined)
+            self.assertIn("Initial scan complete:", combined)
+            self.assertIn("Copied 5 files and cleaned 1 XAML files", combined)
+            self.assertIn("Final scan complete:", combined)
+            self.assertIn("Pipeline completed in", combined)
+
 
 if __name__ == "__main__":
     unittest.main()