charleswiltgen/axiom/axiom-resolve-spm

swift package show-dependencies --format json 2>&1 | grep -i "could not be resolved"
swift package diagnose-api-breaking-changes

// ❌ Conflict
.package(url: "https://github.com/A/PackageA", from: "1.0.0"),  // Requires Alamofire 5.8+
.package(url: "https://github.com/B/PackageB", from: "2.0.0"),  // Requires Alamofire < 5.5
 
// ✅ Resolution: Find compatible versions or update PackageB
.package(url: "https://github.com/A/PackageA", from: "1.0.0"),
.package(url: "https://github.com/B/PackageB", from: "3.0.0"),  // Updated to support Alamofire 5.8+

# Inspect selected package-product and framework-phase relationships, then Read the graph.
xcproject inspect --project "$PROJECT" --target "$TARGET"
 
# Check Package.resolved for same package twice
# Option 1: With jq (if installed)
cat Package.resolved | jq '.pins[] | .identity' | sort | uniq -d
 
# Option 2: Without jq
swift package show-dependencies --format json 2>/dev/null | grep -o '"identity"[^,]*' | sort | uniq -d

// ❌ Problem: PackageA bundles Alamofire, you also depend on it directly
.package(url: "https://github.com/A/PackageA", from: "1.0.0"),  // Has Alamofire inside
.package(url: "https://github.com/Alamofire/Alamofire", from: "5.8.0"),  // Duplicate!
 
// ✅ Resolution: Remove direct Alamofire dependency
.package(url: "https://github.com/A/PackageA", from: "1.0.0"),
// Use Alamofire transitively through PackageA

grep -r "swiftLanguageMode" Package.swift
grep -r "swift-tools-version" Package.swift

// Package.swift
let package = Package(
    name: "MyApp",
    platforms: [.iOS(.v18)],
    products: [...],
    dependencies: [...],
    targets: [
        .target(
            name: "MyApp",
            dependencies: [...],
            swiftSettings: [
                .swiftLanguageMode(.v6),  // Set explicit mode
                // Or for gradual migration:
                .enableExperimentalFeature("StrictConcurrency")
            ]
        )
    ]
)

# Check if Package.resolved is in sync
swift package resolve 2>&1
 
# Verify all pins are valid
swift package show-dependencies

# Full reset
rm -rf .build
rm Package.resolved
swift package resolve

grep -r "macro" Package.swift
grep -r ".macro(" Package.swift

# Trust macro in Xcode
# Product → Swift Packages → Trust & Enable Package Plugin
 
# Command line (last resort)
swift build --disable-sandbox

grep -r "platforms:" Package.swift
grep -r ".iOS\|.macOS\|.watchOS" Package.swift

// Package.swift
let package = Package(
    name: "MyApp",
    platforms: [
        .iOS(.v18),  // Must meet or exceed dependency requirements
        .macOS(.v15)
    ],
    ...
)

# Read Package.swift
cat Package.swift
 
# Check resolved versions
cat Package.resolved
 
# Show dependency tree
swift package show-dependencies --format text
 
# Check for issues
swift package diagnose-api-breaking-changes 2>&1 || true

swift package resolve 2>&1 | grep -i "could not be resolved\|conflict\|incompatible"

swift build 2>&1 | head -50

# JSON format for programmatic analysis
swift package show-dependencies --format json > deps.json
 
# Check for shared dependencies
cat deps.json | jq '.dependencies[].dependencies[] | .name' | sort | uniq -c | sort -rn

# SPM Dependency Analysis
 
## Summary
- **CRITICAL Conflicts**: [count]
- **HIGH Issues**: [count]
- **MEDIUM Issues**: [count]
 
## Package Information
- **Swift Tools Version**: 6.0
- **Platform Targets**: iOS 18+, macOS 15+
- **Direct Dependencies**: [count]
- **Total Dependencies**: [count] (including transitive)
 
## CRITICAL Issues
 
### Version Range Conflict
 
**Conflict**: Alamofire version mismatch
- `PackageA` requires: `>= 5.8.0`
- `PackageB` requires: `< 5.5.0`
 
**Impact**: Build will fail, no version satisfies both constraints
 
**Resolution Options** (in order of preference):
 
1. **Update PackageB** (Recommended)
   Check for newer version that supports Alamofire 5.8+:
   ```bash
   # Check latest versions
   git ls-remote --tags https://github.com/Example/PackageB
   ```
   Then update Package.swift:
   ```swift
   .package(url: "https://github.com/Example/PackageB", from: "3.0.0")
   ```
 
2. **Fork and Patch**
   If no compatible version exists:
   ```bash
   git clone https://github.com/Example/PackageB
   # Update its Package.swift to allow Alamofire 5.8+
   # Push to your fork
   ```
   ```swift
   .package(url: "https://github.com/YourFork/PackageB", branch: "alamofire-5.8")
   ```
 
3. **Pin to Specific Versions**
   Force specific version of shared dependency:
   ```swift
   .package(url: "https://github.com/Alamofire/Alamofire", exact: "5.4.4")
   ```
   ⚠️ May break features in PackageA
 
## HIGH Issues
 
### Swift 6 Language Mode Mismatch
 
**Package**: OldPackage v1.2.3
**Issue**: Compiled with Swift 5 mode, your target uses Swift 6
 
**Resolution**:

 
Or use gradual migration:

 
## Resolution Commands
 

 
## Dependency Graph
 

 
## Verification
 
After resolution:

# SPM Dependency Analysis
 
## Summary
No conflicts detected.
 
## Package Health
- ✅ All version constraints satisfied
- ✅ No duplicate dependencies
- ✅ Swift tools version compatible
- ✅ Platform requirements met
 
## Dependency Graph
[Show clean dependency tree]
 
## Recommendations
- Consider updating packages:
  ```bash
  swift package update
  ```
- Check for security advisories:
  ```bash
  swift package diagnose-api-breaking-changes
  ```

# Resolve dependencies
swift package resolve
 
# Update all packages
swift package update
 
# Update specific package
swift package update PackageName
 
# Show dependencies
swift package show-dependencies
swift package show-dependencies --format json
 
# Clean build
rm -rf .build
 
# Reset SPM cache (nuclear option)
rm -rf ~/Library/Caches/org.swift.swiftpm
rm -rf .build
rm Package.resolved
swift package resolve
 
# Diagnose issues
swift package diagnose-api-breaking-changes