fix: Capture Swift Testing custom #expect comments (#62)

* fix: Capture Swift Testing custom #expect comments (#61)

When #expect has a custom comment, Swift Testing outputs it on a
separate "details" line (􀄵 on macOS, ↳ on Linux). Use look-ahead in
parse() to join the comment to the failed test message.

* docs: Add multi-line context pattern and Swift Testing symbols to CLAUDE.md

Author: alexey1312

CLAUDE.md

@@ -264,6 +264,12 @@ The codebase follows a modular architecture:
 3. Parsed data → `BuildResult` struct
 4. Output formatting (JSON or TOON) → stdout
 
+### Multi-line Context Pattern
+- `parseLine()` processes each line in isolation (no access to neighboring lines)
+- For multi-line context, use **look-ahead/look-back** in the `parse()` loop (has access to `lines` array by index)
+- Existing examples: look-back for `PhaseScriptExecution` context, look-ahead for Swift Testing `#expect` comments
+- `failedTests` are deduplicated by normalized test name — duplicate names get merged, not appended
+
 ### Key Features
 - **Error/Warning Parsing**: Multiple regex patterns handle various Xcode error formats
 - **Runtime Warning Parsing**: Parses SwiftUI and custom runtime warnings (e.g., from swift-issue-reporting)
@@ -274,6 +280,11 @@ The codebase follows a modular architecture:
   - Included with `--warnings` flag (no separate flag needed)
 - **Linker Error Parsing**: Captures undefined symbols, missing frameworks/libraries, architecture mismatches, and duplicate symbols (with structured conflicting file paths)
 - **Test Failure Detection**: XCUnit assertion failures and general test failures
+  - **Swift Testing console symbols**: SF Symbols from Private Use Area (macOS) with Unicode fallbacks (Linux)
+    - `details` line: `􀄵` U+100135 (macOS) / `↳` U+21B3 (Linux) — carries `#expect` custom comments
+    - `fail` line: `􀢄` U+100884 (macOS) / `✘` U+2718 (Linux)
+    - `default`/started: `􀟈` U+1007C8 (macOS) / `◇` U+25C7 (Linux)
+    - Source: [apple/swift-testing Event.Symbol.swift](https://github.com/apple/swift-testing/blob/main/Sources/Testing/Events/Recorder/Event.Symbol.swift)
   - **Standard format**: `Test Case 'X.test()' passed/failed (0.123 seconds)`
   - **Parallel testing format**: `Test case 'X.test()' passed/failed on 'Device Name' (0.123 seconds)`
   - Parallel format uses lowercase 'case' and includes device name before duration

Sources/OutputParser.swift

@@ -358,6 +358,30 @@ class OutputParser {
         for (index, line) in lines.enumerated() {
             parseLine(line)
 
+            // Swift Testing: append custom comment from next line if present
+            // macOS: 􀄵 (U+100135, SF Symbol "arrow.turn.down.right")
+            // Linux:  ↳ (U+21B3, fallback)
+            if line.contains("recorded an issue"),
+                index + 1 < lines.count
+            {
+                let nextLine = lines[index + 1].trimmingCharacters(in: .whitespaces)
+                if nextLine.hasPrefix("􀄵") || nextLine.hasPrefix("↳") {
+                    let comment = String(
+                        nextLine.drop(while: { $0 != " " }).drop(while: { $0 == " " })
+                    )
+                    if !comment.isEmpty, let lastIdx = failedTests.indices.last {
+                        let existing = failedTests[lastIdx]
+                        failedTests[lastIdx] = FailedTest(
+                            test: existing.test,
+                            message: existing.message + ": " + comment,
+                            file: existing.file,
+                            line: existing.line,
+                            duration: existing.duration
+                        )
+                    }
+                }
+            }
+
             // Handle PhaseScriptExecution failures with context from preceding lines
             if line.contains("Command PhaseScriptExecution failed with a nonzero exit") {
                 // Look back for relevant context (skip unrelated warnings and metadata)

Tests/ParsingTests.swift

@@ -1539,4 +1539,77 @@ final class ParsingTests: XCTestCase {
         XCTAssertEqual(result.status, "success")
         XCTAssertEqual(result.summary.passedTests, 1)
     }
+
+    // MARK: - Swift Testing Custom Comment (#61)
+
+    func testSwiftTestingCustomComment() {
+        let parser = OutputParser()
+        let input = """
+            􀢄  Test "Domain stays free" recorded an issue at File.swift:16:17: Expectation failed: !(forbiddenImports.contains(import.name))
+            􀄵  Domain must not import SwiftData
+            􀢄  Test "Domain stays free" failed after 0.986 seconds with 1 issue.
+            """
+
+        let result = parser.parse(input: input)
+
+        XCTAssertEqual(result.failedTests.count, 1)
+        XCTAssertTrue(
+            result.failedTests[0].message.contains("Domain must not import SwiftData"),
+            "Expected message to contain the custom comment, got: \(result.failedTests[0].message)"
+        )
+        XCTAssertEqual(result.failedTests[0].file, "File.swift")
+        XCTAssertEqual(result.failedTests[0].line, 16)
+    }
+
+    func testSwiftTestingCustomCommentLinuxFallback() {
+        let parser = OutputParser()
+        let input = """
+            ✘ Test "Domain stays free" recorded an issue at File.swift:16:17: Expectation failed: !(forbiddenImports.contains(import.name))
+            ↳ Domain must not import SwiftData
+            ✘ Test "Domain stays free" failed after 0.986 seconds with 1 issue.
+            """
+
+        let result = parser.parse(input: input)
+
+        XCTAssertEqual(result.failedTests.count, 1)
+        XCTAssertTrue(
+            result.failedTests[0].message.contains("Domain must not import SwiftData"),
+            "Expected message to contain the custom comment, got: \(result.failedTests[0].message)"
+        )
+    }
+
+    func testSwiftTestingNoComment() {
+        let parser = OutputParser()
+        let input = """
+            􀢄  Test shouldFail() recorded an issue at File.swift:9:5: Expectation failed: Bool(false)
+            􀢄  Test shouldFail() failed after 0.001 seconds with 1 issue.
+            """
+
+        let result = parser.parse(input: input)
+
+        XCTAssertEqual(result.failedTests.count, 1)
+        XCTAssertEqual(result.failedTests[0].message, "Expectation failed: Bool(false)")
+    }
+
+    func testSwiftTestingMultipleIssuesWithComments() {
+        let parser = OutputParser()
+        let input = """
+            􀢄  Test "test A" recorded an issue at File.swift:10:5: Expectation failed: A
+            􀄵  Comment A
+            􀢄  Test "test B" recorded an issue at File.swift:20:5: Expectation failed: B
+            􀄵  Comment B
+            """
+
+        let result = parser.parse(input: input)
+
+        XCTAssertEqual(result.failedTests.count, 2)
+        XCTAssertTrue(
+            result.failedTests[0].message.contains("Comment A"),
+            "First message should contain Comment A, got: \(result.failedTests[0].message)"
+        )
+        XCTAssertTrue(
+            result.failedTests[1].message.contains("Comment B"),
+            "Second message should contain Comment B, got: \(result.failedTests[1].message)"
+        )
+    }
 }