# macOS crash logs
~/Library/Logs/DiagnosticReports/*.ips

# iOS Simulator crash logs (same location)
~/Library/Logs/DiagnosticReports/*.ips

# Device crash logs (after sync)
~/Library/Logs/CrashReporter/MobileDevice/<DeviceName>/

{"app_name":"MyApp","timestamp":"2026-01-09 06:55:45.00 -0800",...}
{
  "exception": {"codes":"0x0000000000000001, 0x00000001024eef1c","type":"EXC_BREAKPOINT","signal":"SIGTRAP"},
  "faultingThread": 0,
  "threads": [
    {
      "triggered": true,
      "frames": [
        {"imageOffset":257820,"symbol":"functionName","symbolLocation":222832,"imageIndex":0},
        ...
      ]
    }
  ],
  "usedImages": [
    {"uuid":"4c4c44ef-5555-3144-a1b5-0562264d518f","path":"/path/to/binary","name":"MyApp"}
  ]
}

Exception Type:  EXC_BAD_ACCESS (SIGSEGV)
Exception Codes: KERN_INVALID_ADDRESS at 0x0000000000000010

Thread 0 Crashed:
0   MyApp    0x100abc123 functionName + 45
1   MyApp    0x100abc456 callerFunction + 123

# Check if file is JSON (.ips) or text (.crash)
if head -1 "$CRASH_FILE" | grep -q "^{"; then
  echo "JSON format (.ips)"
else
  echo "Text format (.crash)"
fi

# Parse with jq (if available) or grep/sed

# App info (first line is separate JSON)
head -1 "$CRASH_FILE" | python3 -c "import sys,json; d=json.load(sys.stdin); print(f'App: {d[\"app_name\"]} {d.get(\"app_version\",\"\")} ({d.get(\"build_version\",\"\")})')"

# Exception type
grep -o '"type":"[^"]*"' "$CRASH_FILE" | head -1

# Exception codes
grep -o '"codes":"[^"]*"' "$CRASH_FILE" | head -1

# Faulting thread
grep -o '"faultingThread":[0-9]*' "$CRASH_FILE"

{"symbol":"MyViewController.viewDidLoad()","symbolLocation":45}

{"imageOffset":257820,"symbolLocation":0}

# For JSON, extract frames from faulting thread
# Look for thread with "triggered": true

Crash at address 0x0000000000000010
↓
Low address (< 0x1000) indicates nil + offset
↓
Likely: Force-unwrapped optional or accessing property on nil

EXC_BREAKPOINT + SIGTRAP
↓
Swift runtime intentionally stopped execution
↓
Look for: fatalError(), precondition failure, array bounds, force cast

0x8badf00d = "ate bad food"
↓
Main thread was blocked for too long
↓
System killed app to maintain responsiveness

## Crash Analysis Report

### Summary
- **App**: [name] [version] ([build])
- **Crash Time**: [timestamp]
- **OS**: [version]
- **Device**: [model]

### Exception
- **Type**: [EXC_TYPE] ([SIGNAL])
- **Codes**: [codes or special code name]
- **Category**: [pattern category from above]

### Symbolication Status
- [✅ Fully symbolicated / ⚠️ Partially symbolicated / ❌ Not symbolicated]
- [If not symbolicated: Instructions to fix]

### Crashed Thread (Thread [N])

### Analysis
[Interpretation of what happened based on pattern matching]

### Root Cause Hypothesis
[Most likely cause based on evidence]

### Actionable Steps
1. [Specific step with code location if known]
2. [Investigation step]
3. [Fix recommendation]

### If Unsymbolicated
```bash
# Find dSYM for UUID: [uuid]
mdfind "com_apple_xcode_dsym_uuids == [UUID]"

# Symbolicate address manually
xcrun atos -arch arm64 -o MyApp.app.dSYM/Contents/Resources/DWARF/MyApp -l [load_address] [crash_address]

## Symbolication Commands

When crash is not symbolicated, provide these commands:

```bash
# Find dSYM by UUID (from crash report's usedImages)
mdfind "com_apple_xcode_dsym_uuids == YOUR-UUID-HERE"

# If dSYM not found, check Archives
ls ~/Library/Developer/Xcode/Archives/

# Symbolicate a single address
xcrun atos -arch arm64 \
  -o /path/to/MyApp.app.dSYM/Contents/Resources/DWARF/MyApp \
  -l 0x100000000 \
  0x0000000100abc123

# Batch symbolicate from file
xcrun atos -arch arm64 \
  -o /path/to/MyApp.dSYM/Contents/Resources/DWARF/MyApp \
  -l 0x100000000 \
  -f addresses.txt