Merge pull request #13 from alexey1312/feature/cc

Add automatic code coverage conversion and reporting

Author: ldomaradzki

CLAUDE.md

@@ -45,6 +45,36 @@ xcodebuild build 2>&1 | xcsift --print-warnings
 # Quiet mode - suppress output when build succeeds with no warnings or errors
 swift build 2>&1 | xcsift --quiet
 xcodebuild build 2>&1 | xcsift -q
+
+# Code coverage - automatically converts .profraw/.xcresult to JSON (no manual conversion needed!)
+
+# SPM: auto-detects and converts .profraw files (summary-only by default)
+swift test --enable-code-coverage 2>&1 | xcsift --coverage
+swift test --enable-code-coverage 2>&1 | xcsift -c
+
+# xcodebuild: auto-detects and converts .xcresult bundles (searches DerivedData automatically!)
+# Automatically filters coverage to tested target only
+xcodebuild test -enableCodeCoverage YES 2>&1 | xcsift --coverage
+
+# Show detailed per-file coverage (default is summary-only for token efficiency)
+swift test --enable-code-coverage 2>&1 | xcsift --coverage --coverage-details
+xcodebuild test 2>&1 | xcsift -c --coverage-details
+
+# Specify custom coverage path (optional - auto-detects by default)
+swift test --enable-code-coverage 2>&1 | xcsift --coverage --coverage-path .build/arm64-apple-macosx/debug/codecov
+xcodebuild test 2>&1 | xcsift --coverage --coverage-path path/to/file.xcresult
+
+# Auto-detection and conversion:
+# SPM (.profraw → .profdata → JSON via llvm tools):
+#   - .build/debug/codecov
+#   - .build/arm64-apple-macosx/debug/codecov
+#   - .build/x86_64-apple-macosx/debug/codecov
+#   - .build/arm64-unknown-linux-gnu/debug/codecov
+#   - .build/x86_64-unknown-linux-gnu/debug/codecov
+#
+# xcodebuild (.xcresult → JSON via xcrun xccov):
+#   - ~/Library/Developer/Xcode/DerivedData/**/*.xcresult (searches automatically)
+#   - Current directory/**/*.xcresult
 ```
 
 ## Architecture
@@ -59,9 +89,10 @@ The codebase follows a simple two-component architecture:
 
 2. **OutputParser.swift** - Core parsing logic
    - `OutputParser` class with regex-based line parsing
-   - Defines data structures: `BuildResult`, `BuildSummary`, `BuildError`, `BuildWarning`, `FailedTest`
+   - Defines data structures: `BuildResult`, `BuildSummary`, `BuildError`, `BuildWarning`, `FailedTest`, `CodeCoverage`, `FileCoverage`
    - Pattern matching for various Xcode/SPM output formats
    - Extracts file paths, line numbers, and messages from build output
+   - Parses code coverage data from SPM coverage JSON files
 
 ### Data Flow
 1. Stdin input → `readStandardInput()`
@@ -74,6 +105,19 @@ The codebase follows a simple two-component architecture:
 - **Test Failure Detection**: XCUnit assertion failures and general test failures
 - **Build Time Extraction**: Captures build duration from output
 - **File/Line Mapping**: Extracts precise source locations for navigation
+- **Code Coverage with Auto-Conversion**: Automatically converts coverage files to JSON when `--coverage` flag is used
+  - **Auto-detection**: Searches multiple default paths for both SPM and xcodebuild formats
+  - **Target filtering**: Automatically extracts tested target name from xcodebuild output and filters coverage to that target only
+  - **Summary-only mode** (default): Outputs only line coverage percentage to minimize token usage
+  - **Details mode** (with `--coverage-details`): Includes full per-file coverage data
+  - **SPM auto-conversion**: Finds `.profraw` files, locates test binary, runs `llvm-profdata merge` and `llvm-cov export`
+    - `.profraw` → `.profdata` → JSON (fully automatic)
+  - **xcodebuild auto-conversion**: Finds `.xcresult` bundles, runs `xcrun xccov view --report --json`
+    - `.xcresult` → JSON (fully automatic)
+  - **No manual steps**: Works out of the box with both build systems
+    - SPM: `swift test --enable-code-coverage 2>&1 | xcsift --coverage`
+    - xcodebuild: `xcodebuild test -enableCodeCoverage YES 2>&1 | xcsift --coverage`
+  - Supports both formats seamlessly
 
 ## Testing
 
@@ -84,6 +128,14 @@ Tests are in `Tests/OutputParserTests.swift` using XCTest framework. Test cases
 - Multi-error scenarios
 - Build time parsing
 - Edge cases (missing files, deprecated functions)
+- Code coverage data structures and parsing
+- JSON encoding with and without coverage data
+- SPM coverage format parsing
+- xcodebuild coverage format parsing (decimal and percentage formats)
+- Format auto-detection
+- Target extraction from xcodebuild output
+- Coverage target filtering
+- Summary-only vs details mode for coverage output
 
 Run individual tests:
 ```bash
@@ -100,8 +152,39 @@ swift test --filter OutputParserTests.testParseError
 
 The tool outputs structured data optimized for coding agents:
 
-- **JSON**: Structured format with `status`, `summary`, `errors`, `warnings` (optional), `failed_tests`
+- **JSON**: Structured format with `status`, `summary`, `errors`, `warnings` (optional), `failed_tests`, `coverage` (optional)
   - **Summary always includes warning count**: `{"summary": {"warnings": N, ...}}`
+  - **Summary includes coverage percentage** (when `--coverage` flag is used): `{"summary": {"coverage_percent": X.X, ...}}`
   - **Detailed warnings list** (with `--print-warnings` flag): `{"warnings": [{"file": "...", "line": N, "message": "..."}]}`
   - **Default behavior** (without flag): Only shows warning count in summary, omits detailed warnings array to reduce token usage
   - **Quiet mode** (with `--quiet` or `-q` flag): Produces no output when build succeeds with zero warnings and zero errors
+  - **Coverage data** (with `--coverage` flag):
+    - **Summary-only mode** (default - token-efficient): Only includes coverage percentage in summary
+      ```json
+      {
+        "summary": {
+          "coverage_percent": 85.5
+        }
+      }
+      ```
+    - **Details mode** (with `--coverage-details` flag): Includes per-file coverage details
+      ```json
+      {
+        "coverage": {
+          "line_coverage": 85.5,
+          "files": [
+            {
+              "path": "/path/to/file.swift",
+              "name": "file.swift",
+              "line_coverage": 92.5,
+              "covered_lines": 37,
+              "executable_lines": 40
+            }
+          ]
+        }
+      }
+      ```
+    - **Target filtering** (xcodebuild only): Automatically extracts tested target from stdout and filters coverage to that target only
+    - Supports both SPM (`swift test --enable-code-coverage`) and xcodebuild (`-enableCodeCoverage YES`) formats
+    - Automatically detects format and parses accordingly
+    - Warns to stderr if target was detected but no matching coverage data found

README.md

@@ -12,6 +12,10 @@ A Swift command-line tool to parse and format xcodebuild/SPM output for coding a
 - **Structured error reporting** - Clear categorization of errors, warnings, and test failures
 - **File/line number extraction** - Easy navigation to problematic code locations
 - **Build status summary** - Quick overview of build results
+- **Automatic code coverage conversion** - Converts .profraw (SPM) and .xcresult (xcodebuild) to JSON automatically
+- **Target filtering** - Automatically filters xcodebuild coverage to tested target only
+- **Summary-only mode** - Default coverage output includes only percentage (token-efficient)
+- **Quiet mode** - Suppress output when build succeeds with no warnings or errors
 
 ## Installation
 
@@ -74,6 +78,26 @@ xcodebuild build 2>&1 | xcsift
 
 # Print detailed warnings list (useful for fixing warnings)
 xcodebuild build 2>&1 | xcsift --print-warnings
+xcodebuild build 2>&1 | xcsift -w
+
+# Quiet mode - suppress output when build succeeds with no warnings or errors
+xcodebuild build 2>&1 | xcsift --quiet
+swift build 2>&1 | xcsift -q
+
+# Code coverage - automatic conversion from .profraw or .xcresult to JSON
+# Default: summary-only mode (line coverage percentage only - token-efficient)
+# xcodebuild automatically searches ~/Library/Developer/Xcode/DerivedData for latest .xcresult
+# and filters to tested target only
+swift test --enable-code-coverage 2>&1 | xcsift --coverage
+xcodebuild test -enableCodeCoverage YES 2>&1 | xcsift --coverage
+xcodebuild test 2>&1 | xcsift -c
+
+# Show detailed per-file coverage (use when you need file-by-file breakdown)
+swift test --enable-code-coverage 2>&1 | xcsift --coverage --coverage-details
+xcodebuild test 2>&1 | xcsift -c --coverage-details
+
+# Specify custom coverage path (optional - auto-detects by default)
+swift test --enable-code-coverage 2>&1 | xcsift --coverage --coverage-path .build/arm64-apple-macosx/debug/codecov
 
 # Test output parsing
 xcodebuild test 2>&1 | xcsift
@@ -94,7 +118,9 @@ swift test 2>&1 | xcsift
     "errors": 2,
     "warnings": 1,
     "failed_tests": 2,
-    "build_time": "3.2 seconds"
+    "passed_tests": 28,
+    "build_time": "3.2",
+    "coverage_percent": 85.5
   },
   "errors": [
     {
@@ -115,12 +141,37 @@ swift test 2>&1 | xcsift
       "test": "Test assertion",
       "message": "XCTAssertEqual failed: (\"invalid\") is not equal to (\"valid\")"
     }
-  ]
+  ],
+  "coverage": {
+    "line_coverage": 85.5,
+    "files": [
+      {
+        "path": "/path/to/ViewController.swift",
+        "name": "ViewController.swift",
+        "line_coverage": 92.5,
+        "covered_lines": 37,
+        "executable_lines": 40
+      }
+    ]
+  }
 }
 ```
 
 **Note on warnings:** By default, only the warning count appears in `summary.warnings`. The detailed `warnings` array (shown above) is only included when using the `--print-warnings` flag. This reduces token usage for coding agents that don't need to process every warning.
 
+**Note on coverage:** The `coverage` section is only included when using the `--coverage-details` flag:
+- **Summary-only mode** (default): Only includes coverage percentage in summary for maximum token efficiency
+  ```json
+  {
+    "summary": {
+      "coverage_percent": 85.5
+    }
+  }
+  ```
+- **Details mode** (with `--coverage-details`): Includes full `files` array as shown in the example above
+- **Target filtering** (xcodebuild only): Automatically extracts tested target from stdout and shows coverage for that target only
+- xcsift automatically converts `.profraw` files (SPM) or `.xcresult` bundles (xcodebuild) to JSON format without requiring manual llvm-cov or xccov commands
+
 
 ## Comparison with xcbeautify/xcpretty
 
@@ -131,6 +182,7 @@ swift test 2>&1 | xcsift
 | **Token efficiency** | High | Medium | Low |
 | **Machine readable** | Yes | No | Limited |
 | **Error extraction** | Structured | Visual | Visual |
+| **Code coverage** | Auto-converts | No | No |
 | **Build time** | Fast | Fast | Slower |
 
 ## Development