SOFA core-cli v0.3.0

Highlights

• New tool: sofa-artifact — extracts per-build device support lists directly from Apple's SUCatalog InstallAssistant metadata. Covers 33 macOS builds from 10.13.5 through 26.4.1 with stable, per-build device constraints that persist after Apple removes builds from GDMF.
• Intel/Apple Silicon device classification fixes — corrected arch classification in model data, refreshed device lookup
• Superseded detection — requires superset for superseded build detection (stricter, fewer false positives)
• Release cross-references — v2 feeds now include cross-references between related releases
• Canonical Devices map — unified across all v2 feeds
• BSI archival — SupportedDevices archived to NDJSON history with backfill support

New: sofa-artifact

Fetches Apple's SUCatalog and parses .dist installer metadata to capture which devices support each macOS build. Complements GDMF as a stable, per-build record.

sofa-artifact fetch              # Download SUCatalog (~7 MB)
sofa-artifact extract            # Parse .dist files → artifact_devices.json
sofa-artifact diff               # Show changes since last extract
sofa-artifact validate           # Cross-check against v2 feed Devices map

Platforms

• macOS aarch64 (Apple Silicon) — signed
• Linux x86_64 (Ubuntu)

Binaries included

• sofa-fetch — Download Apple security release data
• sofa-gather — Collect GDMF, KEV, XProtect, IPSW, Beta, UMA data
• sofa-build — Generate v1/v2 SOFA feeds, DMS consumer, bulletin
• sofa-cve — CVE enrichment and analysis
• sofa-models — Apple device model data from AppleDB
• sofa-init — Initialize SOFA directory structure
• sofa-artifact — Extract device support lists from Apple SUCatalog (new)

Installation

tar -xzf sofa-0.3.0-<platform>.tar.gz
sudo cp sofa-* /usr/local/bin/

SOFA core-cli v0.2.0

SOFA core-cli v0.2.0

Highlights

• CalVer Schema Versioning (2026.03.23.1) + JSON Schema for all v2 feeds
• Bulletin text — current wave only, LinkedIn-ready format
• DMS consumer — N-1 OS versions, all devices resolved across 5 platforms
• Per-version device layering — Nudge-compatible, prod-matching device counts
• BSI enrichment — security_info URL, CVEs, version-aware matching
• 98 Mac models with correct AppleDB names, unified device_lookup.json

Platforms

• macOS aarch64 (Apple Silicon) — signed + notarized
• Linux x86_64 (Ubuntu)

SOFA core-cli builds - v0.1.8

SOFA CLI Tools v0.1.8

Key fix: Device-specific release detection

• Uses count ratio instead of strict subset check — new device models (e.g. J700AP) that aren't yet in supported_devices.json are now correctly detected
• For 26.3.2: 1 GDMF device / 55 base devices = 0.018 < 0.5 threshold → device-specific
• Latest correctly selects 26.3.1 (universal) instead of 26.3.2
• v2 builder: device merge only applied to universal releases in Latest block
• Per-version diagnostic logging for device scope decisions

Built from headmin/sofa-core-private@v0.1.8

SOFA core-cli builds - v0.1.7

SOFA CLI Tools v0.1.7

What's new

• Fix: Device-specific release detection — releases targeting a single device model (e.g., macOS 26.3.2) are now correctly excluded from Latest and properly scoped
• Fix: Numeric version comparison — Latest selection uses proper numeric comparison instead of string sorting

Downloads

• Linux x86_64: sofa-core-cli-x86_64-linux-binaries.zip
• macOS Apple Silicon: sofa-core-cli-apple-silicon-mac-binaries.zip

Binaries included

• sofa-fetch — Download Apple security data
• sofa-gather — Collect and process security information
• sofa-build — Generate SOFA feeds
• sofa-cve — CVE enrichment and analysis
• sofa-models — Apple device model data

Built from headmin/sofa-core-private@v0.1.7

SOFA core-cli builds - v0.1.6

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on common x86_64 Linux distributions, primarily in GitHub Action runner

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

Native ARM64 -Only build for Apple Silicon
Code signing - Binaries are code signed with an Apple Developer ID

SOFA core-cli builds - v0.1.5

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on common x86_64 Linux distributions, primarily in GitHub Action runner

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

Native ARM64 -Only build for Apple Silicon
Code signing - Binaries are code signed with an Apple Developer ID

v0.1.4

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on common x86_64 Linux distributions, primarily in GitHub Action runner

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

Native ARM64 -Only build for Apple Silicon
Code signing - Binaries are code signed with an Apple Developer ID

SOFA core-cli builds - v0.1.3-RC

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on any Linux distribution
✅ Production ready - Cross-platform compatibility with musl static linking

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

✅ Native ARM64 - Maximum performance on Apple Silicon
🔏 Code signing - Developer ID code signed

SOFA core-cli builds - v0.1.2-beta1

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on any Linux distribution
✅ Production ready - Cross-platform compatibility with musl static linking

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

✅ Native ARM64 - Maximum performance on Apple Silicon
🔏 Code signing - Developer ID code signed

SOFA core-cli builds - v0.1.1-beta1

Linux Build Summary

Architecture: x86_64

Binaries built:

linux-binaries/sofa-build: 5.6M
linux-binaries/sofa-cve: 7.1M
linux-binaries/sofa-fetch: 9.0M
linux-binaries/sofa-gather: 9.1M
linux-binaries/sofa-init: 6.5M

✅ Static binaries - Will run on any Linux distribution
✅ Production ready - Cross-platform compatibility with musl static linking

---

macOS ARM64 Build Summary

Architecture: ARM64 (Apple Silicon)

Target: aarch64-apple-darwin

Compatible Devices:

• 🍎 M1-M4 Apple Silicon Macs (MacBook Air, MacBook Pro, iMac, Mac mini)

Binaries built:

macos-arm-binaries/sofa-build: 4.1M
macos-arm-binaries/sofa-cve: 5.4M
macos-arm-binaries/sofa-fetch: 6.8M
macos-arm-binaries/sofa-gather: 6.9M
macos-arm-binaries/sofa-init: 4.7M

✅ Native ARM64 - Maximum performance on Apple Silicon
🔏 Code signing - Developer ID code signed