Repository navigation
Added
appletrace summary: per-span count, total, self, mean, p50, p95 and max
durations for one or more runs, as a table or JSON (-osaves a baseline).appletrace diff: compares two traces or summaries span by span and exits
with status 2 when a span regressed by more than--thresholdand
--min-delta(--metric,--only,--fail-on-missing,--json). See
docs/ci-performance-gates.md.TraceStatistics,TraceStatisticsBuilderandTraceComparisonin
AppleTraceKit.- Swift async spans (
withAsyncSpan,@Tracedonasyncfunctions) record
the current task's name (Swift 6.2 named tasks, OS 26 and later) as their
taskargument. C:APTAsyncBeginWithTask(). - Binary fragments gain a
Trecord carrying that task name;appletrace mergeandmerge.pyattach it to the async begin that follows.
Verified
- Swift tests (36), Python tests (27),
scripts/test_ci_gates.sh, and the
Swift demo app recorded three times against three times on an iOS 27.2
Simulator: unchanged code passes with--metric p50 --threshold 20% --min-delta 2ms, and runs recorded under load are flagged.
Assets
appletrace-2.1.0-macos.zip— theappletraceCLI (universal macOS binary, ad-hoc signed; if Gatekeeper blocks it, runxattr -d com.apple.quarantine appletraceor build withswift build -c release --product appletrace)appletrace.xcframework.zip— Objective-C framework (iOS device arm64/arm64e, iOS Simulator arm64/x86_64)appletrace-loader_2.1.0_iphoneos-arm64.deb— jailbreak loader, rootlessappletrace-loader_2.1.0_iphoneos-arm64e.deb— jailbreak loader, roothideSHA256SUMS
Swift Package Manager: .package(url: "https://github.com/everettjf/appletrace.git", from: "2.1.0")
Guide: Performance gates in CI