From 9f11f19fcd7095891c0417f744f54d0525c0d388 Mon Sep 17 00:00:00 2001 From: maximkrouk Date: Sun, 17 May 2026 18:06:30 +0200 Subject: [PATCH 1/4] fix: EditorConfig --- .editorconfig | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/.editorconfig b/.editorconfig index dc193b6..e029c86 100644 --- a/.editorconfig +++ b/.editorconfig @@ -1,7 +1,10 @@ -[*.swift] -indent_style = tab -indent_size = 1 +root = true +[*] +indent_style = tab +tab_width = 2 +trim_trailing_whitespace = true +insert_final_newline = true [*.yml] indent_style = space From 6ceb7a725c0570dcf4240eaa52f51ce7b9af77d8 Mon Sep 17 00:00:00 2001 From: maximkrouk Date: Tue, 4 Aug 2026 10:09:29 +0200 Subject: [PATCH 2/4] Add Swift interfaces for agent tooling --- .agents/interfaces/.gitkeep | 0 .../FoundationExtensions.swiftinterface | 820 ++++++++++++++++++ .../FoundationExtensionsMacros.swiftinterface | 10 + Makefile | 5 + scripts/generate-swiftinterfaces.sh | 237 +++++ scripts/list-swift-targets.swift | 82 ++ 6 files changed, 1154 insertions(+) create mode 100644 .agents/interfaces/.gitkeep create mode 100644 .agents/interfaces/FoundationExtensions.swiftinterface create mode 100644 .agents/interfaces/FoundationExtensionsMacros.swiftinterface create mode 100644 Makefile create mode 100755 scripts/generate-swiftinterfaces.sh create mode 100755 scripts/list-swift-targets.swift diff --git a/.agents/interfaces/.gitkeep b/.agents/interfaces/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.agents/interfaces/FoundationExtensions.swiftinterface b/.agents/interfaces/FoundationExtensions.swiftinterface new file mode 100644 index 0000000..8f00391 --- /dev/null +++ b/.agents/interfaces/FoundationExtensions.swiftinterface @@ -0,0 +1,820 @@ +// swift-interface-format-version: 1.0 +// swift-compiler-version: Apple Swift version 6.4 (swiftlang-6.4.0.25.4 clang-2100.3.25.1) +// swift-module-flags: -target arm64-apple-macos12.0 -enable-objc-interop -language-mode 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FoundationExtensions -package-name swift_foundation_extensions +// swift-module-flags-ignorable: -formal-cxx-interoperability-mode=off -interface-compiler-version 6.4 +@_exported import AssociatedObjects +import Combine +import Dispatch +@_exported import Equated +@_exported @preconcurrency import Foundation +@_exported import Resettable +import Swift +import _Concurrency +import _StringProcessing +import _SwiftConcurrencyShims +extension Swift::ClosedRange { + @available(*, deprecated, message: "Use value.clamped(in: range) instead") + @inlinable public func clamped(_ value: Bound) -> Bound { + if value < lowerBound { + return lowerBound + } else if value > upperBound { + return upperBound + } else { + return value + } + } +} +extension Swift::PartialRangeFrom { + @available(*, deprecated, message: "Use value.clamped(in: range) instead") + @inlinable public func clamped(_ value: Bound) -> Bound { + if value < lowerBound { + return lowerBound + } else { + return value + } + } +} +extension Swift::PartialRangeThrough { + @available(*, deprecated, message: "Use value.clamped(in: range) instead") + @inlinable public func clamped(_ value: Bound) -> Bound { + if value > upperBound { + return upperBound + } else { + return value + } + } +} +@available(*, deprecated, renamed: "Optional.UnwrappingError", message: "Use Optional.UnwrappingError instead") +public typealias UnwrappingError = Swift::Optional.FoundationExtensions::UnwrappingError +extension Swift::Optional.FoundationExtensions::UnwrappingError { + @available(*, deprecated, message: "Instead of UnwrappingError, use Optional.UnwrappingError") + public typealias T = Wrapped +} +extension Foundation::Bundle { + @inlinable public var appVersionNumber: Swift::String? { + get { infoDictionary?["CFBundleShortVersionString"] as? String } + } + @inlinable public var buildVersionNumber: Swift::String? { + get { infoDictionary?["CFBundleVersion"] as? String } + } + @inlinable public var teamIdentifierPrefix: Swift::String? { + get { infoDictionary?["TeamIdentifierPrefix"] as? String } + } + @inlinable public var keyPrefix: Swift::String { + get { + return bundleIdentifier.map { $0.appending(".") }.or("") + } + } + @inlinable public func makeKey(_ key: Swift::String) -> Swift::String { + return keyPrefix.appending(key) + } + @inlinable public func appGroupID(for teamIdentifier: Swift::String) -> Swift::String? { + return teamIdentifierPrefix.map { "\($0)\(teamIdentifier)" } + } +} +public enum RawCodingKey : Swift::CodingKey, Swift::ExpressibleByStringLiteral, Swift::ExpressibleByIntegerLiteral { + case key(Swift::String) + case index(Swift::Int) + @inlinable public init(stringLiteral value: Swift::String) { + self.init(stringValue: value) + } + @inlinable public init(stringValue: Swift::String) { + self = .key(stringValue) + } + @inlinable public init(integerLiteral value: Swift::Int) { + self.init(intValue: value) + } + @inlinable public init(intValue: Swift::Int) { + self = .index(intValue) + } + @inlinable public var stringValue: Swift::String { + get { + switch self { + case let .key(value): + return value + case let .index(value): + return value.description + } + } + } + @inlinable public var intValue: Swift::Int? { + get { + switch self { + case let .index(value): + return value + default: + return nil + } + } + } + public typealias ExtendedGraphemeClusterLiteralType = Swift::String + public typealias IntegerLiteralType = Swift::Int + public typealias StringLiteralType = Swift::String + public typealias UnicodeScalarLiteralType = Swift::String +} +extension Swift::Decoder { + @inlinable public func decode(_ decode: (Swift::KeyedDecodingContainer) throws -> T) throws -> T { + return try self.decode(RawCodingKey.self, decode) + } + @inlinable public func decode(_ codingKeys: CodingKeys.Type, _ decode: (Swift::KeyedDecodingContainer) throws -> T) throws -> T where CodingKeys : Swift::CodingKey { + let container = try container(keyedBy: codingKeys) + return try decode(container) + } +} +extension Swift::Encoder { + @inlinable public func encode(_ encode: (inout Swift::KeyedEncodingContainer) throws -> T) throws -> T { + return try self.encode(RawCodingKey.self, encode) + } + @inlinable public func encode(_ codingKeys: CodingKeys.Type, _ encode: (inout Swift::KeyedEncodingContainer) throws -> T) throws -> T where CodingKeys : Swift::CodingKey { + var container = container(keyedBy: codingKeys) + return try encode(&container) + } +} +extension Swift::KeyedDecodingContainer { + @inlinable public func decode(_ key: K) throws -> T where T : Swift::Decodable { + try decode(T.self, forKey: key) + } + @inlinable public func decodeIfPresent(_ key: K) throws -> T? where T : Swift::Decodable { + try decodeIfPresent(T.self, forKey: key) + } +} +extension Swift::Collection { + @inlinable public var isNotEmpty: Swift::Bool { + get { !self.isEmpty } + } +} +extension Swift::Array { + @inlinable public mutating func bringFront(elementsSatisfying predicate: (Element) -> Swift::Bool) { + let leftHalf = self.filter { predicate($0) } + let rightHalf = self.filter { !predicate($0) } + self = leftHalf + rightHalf + } +} +extension Swift::MutableCollection { + @inlinable public subscript(safe index: Self.Index?) -> Self.Element? { + get { + guard let index = index else { return nil } + return self[safe: index] + } + set { + guard let index = index else { return } + self[safe: index] = newValue + } + } + @inlinable public subscript(safe index: Self.Index) -> Self.Element? { + get { + guard indices.contains(index) + else { return nil } + return self[index] + } + set { + guard + indices.contains(index), + let value = newValue + else { return } + return self[index] = value + } + } +} +extension Swift::Collection { + @inlinable public subscript(safe index: Self.Index?) -> Self.Element? { + get { + guard let index = index else { return nil } + return self[safe: index] + } + } + @inlinable public subscript(safe index: Self.Index) -> Self.Element? { + get { + guard indices.contains(index) + else { return nil } + return self[index] + } + } +} +extension Swift::Comparable { + @inlinable public func clamped(in range: Swift::ClosedRange) -> Self { + min(max(range.lowerBound, self), range.upperBound) + } + @inlinable public mutating func clamp(in range: Swift::ClosedRange) { + self = self.clamped(in: range) + } + @inlinable public func clamped(in range: Swift::PartialRangeFrom) -> Self { + max(range.lowerBound, self) + } + @inlinable public mutating func clamp(in range: Swift::PartialRangeFrom) { + self = self.clamped(in: range) + } + @inlinable public func clamped(in range: Swift::PartialRangeThrough) -> Self { + min(self, range.upperBound) + } + @inlinable public mutating func clamp(in range: Swift::PartialRangeThrough) { + self = self.clamped(in: range) + } +} +extension Dispatch::DispatchTimeInterval { + @inlinable public static func interval(_ value: Foundation::TimeInterval) -> Dispatch::DispatchTimeInterval { + return .nanoseconds(Int(value * pow(10, 9))) + } +} +extension Dispatch::DispatchTime : @retroactive Swift::ExpressibleByFloatLiteral { + public typealias FloatLiteralType = Foundation::TimeInterval +} +extension Dispatch::DispatchTime { + @inlinable public static func interval(_ interval: Foundation::TimeInterval) -> Dispatch::DispatchTime { + return .now() + .interval(interval) + } + @inlinable public init(floatLiteral value: Foundation::TimeInterval) { + self = .interval(value) + } +} +extension Swift::FloatingPoint { + @inlinable public func progress(in total: Self) -> Self { + total != 0 ? self / total : 0 + } +} +extension Foundation::NSMutableAttributedString { + @inlinable public func addAttribute(_ key: Foundation::NSAttributedString.Foundation::Key, value: Any) { + addAttribute(key, value: value, range: NSRange(0.. Swift::Void) -> Foundation::NSAttributedString { + let attributedString = NSMutableAttributedString(attributedString: self) + let range = NSRange(0.. Swift::Void) -> Foundation::NSAttributedString { + let attributedString = NSMutableAttributedString(attributedString: self) + let range = NSRange(0..(_ value: T, in object: inout T) { + mutate(&object, with: { $0 = value }) + } + @inlinable public func mutate(_ object: T, with closure: (T) -> Swift::Void) where T : AnyObject { + execute { closure(object) } + } + @inlinable public func mutate(_ object: inout T, with closure: (inout T) -> Swift::Void) { + execute { closure(&object) } + } + @inlinable public func assign(_ value: Value, to keyPath: Swift::ReferenceWritableKeyPath, on object: T) where T : AnyObject { + execute { object[keyPath: keyPath] = value } + } + @inlinable public func assign(_ value: Value, to keyPath: Swift::WritableKeyPath, on object: inout T) { + execute { object[keyPath: keyPath] = value } + } + @discardableResult + @inlinable public func execute(_ closure: () -> T) -> T { + withLock(closure) + } +} +public protocol NSObjectSwizzlingProtocol : ObjectiveC::NSObjectProtocol { +} +extension FoundationExtensions::NSObjectSwizzlingProtocol { + @available(*, deprecated, message: "Use `objc_exchangeImplementations(_,_,_)` instead") + @inlinable public static func objc_exchangeImplementations(_ originalSelector: ObjectiveC::Selector, _ swizzledSelector: ObjectiveC::Selector) { + objc_exchangeImplementations( + originalSelector, + swizzledSelector, + using: class_getInstanceMethod + ) + } + @discardableResult + @inlinable public static func objc_exchangeImplementations(_ originalSelector: ObjectiveC::Selector, _ swizzledSelector: ObjectiveC::Selector, using extractMethod: (Swift::AnyClass?, ObjectiveC::Selector) -> ObjectiveC::Method?) -> Swift::Bool { + let originalMethod = extractMethod( + Self.self, + originalSelector + ) + + let swizzledMethod = extractMethod( + Self.self, + swizzledSelector + ) + + guard + let originalMethod, + let swizzledMethod + else { return false } + + method_exchangeImplementations(originalMethod, swizzledMethod) + return true + } +} +extension ObjectiveC::NSObject : FoundationExtensions::NSObjectSwizzlingProtocol { +} +extension Swift::Optional { + @inlinable public func orThrow(_ error: @autoclosure () -> any Swift::Error) throws -> Wrapped { + switch self { + case .some(let wrapped): + return wrapped + case .none: + throw error() + } + } + @inlinable public var isNil: Swift::Bool { + get { + switch self { + case .none: return true + case .some: return false + } + } + } + @inlinable public var isNotNil: Swift::Bool { + get { !isNil } + } + @inlinable public func or(_ value: @autoclosure () -> Wrapped) -> Wrapped { + self ?? value() + } + @inlinable public func or(_ value: @autoclosure () -> Wrapped?) -> Wrapped? { + self ?? value() + } + @inlinable public func unwrap(function: Swift::String = #function, file: Swift::String = #file, line: Swift::Int = #line) -> Swift::Result.FoundationExtensions::UnwrappingError> { + switch self { + case .some(let value): + return .success(value) + case .none: + return .failure( + UnwrappingError( + function: function, + file: file, + line: line + ) + ) + } + } + @inlinable public func assign(to keyPath: Swift::ReferenceWritableKeyPath>, on target: T) where T : AnyObject { target[keyPath: keyPath] = self } + @inlinable public func ifLetAssign(to keyPath: Swift::ReferenceWritableKeyPath, on target: T) where T : AnyObject { map { target[keyPath: keyPath] = $0 } } + @inlinable public func ifLetAssign(to keyPath: Swift::ReferenceWritableKeyPath>, on target: T) where T : AnyObject { map { target[keyPath: keyPath] = $0 } } + @inlinable public func assign(to keyPath: Swift::WritableKeyPath>, on target: inout T) { target[keyPath: keyPath] = self } + @inlinable public func ifLetAssign(to keyPath: Swift::WritableKeyPath, on target: inout T) { map { target[keyPath: keyPath] = $0 } } + @inlinable public func ifLetAssign(to keyPath: Swift::WritableKeyPath>, on target: inout T) { map { target[keyPath: keyPath] = $0 } } +} +extension Swift::Optional where Wrapped : Swift::Collection { + @inlinable public var isNilOrEmpty: Swift::Bool { + get { + map(\.isEmpty).or(true) + } + } +} +extension Swift::Optional { + public struct UnwrappingError : Swift::Error { + public let type: Wrapped.Type + public let function: Swift::String + public let file: Swift::String + public let line: Swift::Int + public init(_ type: Wrapped.Type = Wrapped.self, function: Swift::String = #function, file: Swift::String = #file, line: Swift::Int = #line) + @inlinable public var debugDescription: Swift::String { + get { + localizedDescription + .appending("\n{") + .appending("\n function: \(function)") + .appending("\n file: \(file),") + .appending("\n line: \(line)") + .appending("\n}") + } + } + } +} +extension Swift::Range where Bound : Swift::Numeric { + @inlinable public var length: Bound { + get { upperBound - lowerBound } + } +} +extension Swift::ClosedRange where Bound : Swift::Numeric { + @inlinable public var length: Bound { + get { upperBound - lowerBound } + } +} +extension Swift::Result { + @inlinable public var value: Success? { + get { + switch self { + case let .success(value): return value + default: return nil + } + } + } + @inlinable public var error: Failure? { + get { + switch self { + case let .failure(error): return error + default: return nil + } + } + } + @inlinable public func eraseError() -> Swift::Result { + mapError { $0 as Error } + } + @inlinable public func replaceError(with success: Success) -> Swift::Result { + replaceError { _ in success } + } + @inlinable public func replaceError(with closure: (any Swift::Error) -> Success) -> Swift::Result { + switch self { + case .success(let value): + return .success(value) + case .failure(let error): + return .success(closure(error)) + } + } +} +extension Swift::String { + @inlinable public func ranges(of substring: Swift::String, options: Swift::String.Foundation::CompareOptions = [], locale: Foundation::Locale? = nil) -> [Swift::Range] { + var ranges: [Range] = [] + while + let range = range( + of: substring, + options: options, + range: (ranges.last?.upperBound ?? startIndex).. { + final public var content: Content + @inlinable final public var wrappedValue: Content { + get { content } + set { content = newValue } + } + @inlinable convenience public init() where Content == T? { + self.init(wrappedValue: nil) + } + @inlinable convenience public init(_ wrappedValue: Content) { + self.init(wrappedValue: wrappedValue) + } + public init(wrappedValue: Content) + @inlinable final public var projectedValue: FoundationExtensions::Reference { + get { reference } + } + @inlinable final public var reference: FoundationExtensions::Reference { + get { + .object(self, keyPath: \.wrappedValue) + } + } + @inlinable final public subscript(dynamicMember keyPath: Swift::KeyPath) -> U { + get { self.wrappedValue[keyPath: keyPath] } + } + @inlinable final public subscript(dynamicMember keyPath: Swift::WritableKeyPath) -> U { + get { self.wrappedValue[keyPath: keyPath] } + set { self.wrappedValue[keyPath: keyPath] = newValue } + } + @inlinable final public subscript(dynamicMember keyPath: Swift::ReferenceWritableKeyPath) -> U { + get { self.wrappedValue[keyPath: keyPath] } + set { self.wrappedValue[keyPath: keyPath] = newValue } + } + @objc deinit +} +extension FoundationExtensions::ReadonlyReference { + @inlinable public static func constant(_ value: Value) -> FoundationExtensions::ReadonlyReference { + ReadonlyReference { value } + } + @inlinable public static func object(_ object: Object, read: @escaping (Object) -> Value) -> FoundationExtensions::ReadonlyReference where Object : AnyObject { + ReadonlyReference(read: { read(object) }) + } +} +@propertyWrapper @dynamicMemberLookup public struct ReadonlyReference { + @usableFromInline + internal var _read: () -> Value + @inlinable public init(wrappedValue: Value) { + self.init(read: { wrappedValue }) + } + public init(read: @escaping () -> Value) + @inlinable public var wrappedValue: Value { + get { + self._read() + } + } + @inlinable public var projectedValue: FoundationExtensions::ReadonlyReference { + get { + ReadonlyReference(read: _read) + } + } + @inlinable public var asWritable: FoundationExtensions::Reference { + get { + Reference(read: _read, write: { _ in }) + } + } + @inlinable public func writable(with write: @escaping (Value) -> Swift::Void) -> FoundationExtensions::Reference { + Reference(read: _read, write: write) + } + @inlinable public subscript(dynamicMember keyPath: Swift::KeyPath) -> FoundationExtensions::Reference { + get { + .readonly { wrappedValue[keyPath: keyPath] } + } + } + @inlinable public subscript(dynamicMember keyPath: Swift::ReferenceWritableKeyPath) -> FoundationExtensions::Reference { + get { + Reference( + read: { _read()[keyPath: keyPath] }, + write: { _read()[keyPath: keyPath] = $0 }) + } + } +} +extension FoundationExtensions::Reference { + @inlinable public static func readonly(_ read: @escaping () -> Value) -> FoundationExtensions::Reference { + Reference(read: read, write: { _ in }) + } + @inlinable public static func object(_ object: Object, read: @escaping (Object) -> Value) -> FoundationExtensions::Reference where Object : AnyObject { + .readonly { read(object) } + } + @inlinable public static func object(_ object: Object, keyPath: Swift::ReferenceWritableKeyPath) -> FoundationExtensions::Reference where Object : AnyObject { + Reference( + read: { object[keyPath: keyPath] }, + write: { object[keyPath: keyPath] = $0 } + ) + } + @inlinable public static func variable(_ initialValue: Value) -> FoundationExtensions::Reference { + Reference(wrappedValue: initialValue) + } + @inlinable public static func constant(_ value: Value) -> FoundationExtensions::Reference { + .readonly { value } + } +} +@propertyWrapper @dynamicMemberLookup public struct Reference { + @usableFromInline + internal var _read: () -> Value + @usableFromInline + internal var _write: (Value) -> Swift::Void + @inlinable public init(wrappedValue: Value) { + var value = wrappedValue + self.init( + read: { value }, + write: { value = $0 } + ) + } + public init(read: @escaping () -> Value, write: @escaping (Value) -> Swift::Void) + @inlinable public func read() -> Value { _read() } + @inlinable public func write(_ value: Value) { _write(value) } + @inlinable public var wrappedValue: Value { + get { _read() } + nonmutating set { _write(newValue) } + } + @inlinable public var projectedValue: FoundationExtensions::Reference { + get { + Reference(read: _read, write: _write) + } + } + @inlinable public var readonly: FoundationExtensions::ReadonlyReference { + get { ReadonlyReference(read: _read) } + } + @inlinable public subscript(dynamicMember keyPath: Swift::KeyPath) -> FoundationExtensions::Reference { + get { + .readonly { wrappedValue[keyPath: keyPath] } + } + } + @inlinable public subscript(dynamicMember keyPath: Swift::WritableKeyPath) -> FoundationExtensions::Reference { + get { + Reference( + read: { _read()[keyPath: keyPath] }, + write: { localValue in + var value = _read() + value[keyPath: keyPath] = localValue + _write(value) + } + ) + } + } +} +extension FoundationExtensions::Reference { + public func map(read: @escaping (Value) -> T, write: @escaping (T) -> Value) -> FoundationExtensions::Reference + public func onSet(perform action: @escaping (Value) -> Swift::Void) -> FoundationExtensions::Reference + public func onChange(perform action: @escaping (Value) -> Swift::Void) -> FoundationExtensions::Reference where Value : Swift::Equatable +} +public protocol ReferenceProvider : AnyObject { +} +extension FoundationExtensions::ReferenceProvider { + @inlinable public func reference(for keyPath: Swift::KeyPath) -> FoundationExtensions::ReadonlyReference { + .object(self, read: { $0[keyPath: keyPath] }) + } + @inlinable public func reference(for keyPath: Swift::ReferenceWritableKeyPath) -> FoundationExtensions::Reference { + .object(self, keyPath: keyPath) + } +} +extension ObjectiveC::NSObject : FoundationExtensions::ReferenceProvider { +} +public protocol Castable { + func `as`(_ type: T.Type) -> T? + func `is`(_ type: T.Type) -> Swift::Bool +} +extension FoundationExtensions::Castable { + public func `as`(_ type: T.Type) -> T? + public func `is`(_ type: T.Type) -> Swift::Bool +} +extension Swift::Optional : FoundationExtensions::Castable { +} +extension ObjectiveC::NSObject : FoundationExtensions::Castable { +} +@propertyWrapper @dynamicMemberLookup public struct Indirect { + @usableFromInline + internal class Storage : @unchecked Swift::Sendable { + @usableFromInline + internal var value: Value + @usableFromInline + internal init(_ value: Value) + @objc @usableFromInline + deinit + } + @usableFromInline + internal var storage: FoundationExtensions::Indirect.FoundationExtensions::Storage + @inlinable public init(_ value: Value) { + self.init(wrappedValue: value) + } + @inlinable public init(wrappedValue: Value) { + self.storage = .init(wrappedValue) + } + @inlinable public var wrappedValue: Value { + get { storage.value } + set { + if !isKnownUniquelyReferenced(&storage) { + storage = Storage(storage.value) + } + storage.value = newValue + } + } + @inlinable public var projectedValue: FoundationExtensions::Indirect { + get { self } + set { self = newValue } + } + @inlinable public subscript(dynamicMember keyPath: Swift::KeyPath) -> T { + get { + wrappedValue[keyPath: keyPath] + } + } + @inlinable public subscript(dynamicMember keyPath: Swift::WritableKeyPath) -> T { + get { wrappedValue[keyPath: keyPath] } + set { wrappedValue[keyPath: keyPath] = newValue } + } + @inlinable public func _setValue(_ value: Value) { + storage.value = value + } + @inlinable public func _modifyValue(_ transform: (inout Value) -> Swift::Void) { + transform(&storage.value) + } + @inlinable public func _sharesStorage(with other: FoundationExtensions::Indirect) -> Swift::Bool { + storage === other.storage + } +} +extension FoundationExtensions::Indirect : Swift::Sendable where Value : Swift::Sendable { +} +extension FoundationExtensions::Indirect : Swift::Equatable where Value : Swift::Equatable { + @inlinable public static func == (lhs: FoundationExtensions::Indirect, rhs: FoundationExtensions::Indirect) -> Swift::Bool { + lhs.wrappedValue == rhs.wrappedValue + } +} +extension FoundationExtensions::Indirect : Swift::Hashable where Value : Swift::Hashable { + @inlinable public func hash(into hasher: inout Swift::Hasher) { + wrappedValue.hash(into: &hasher) + } + public var hashValue: Swift::Int { + get + } +} +extension FoundationExtensions::Indirect : Swift::Comparable where Value : Swift::Comparable { + @inlinable public static func < (lhs: FoundationExtensions::Indirect, rhs: FoundationExtensions::Indirect) -> Swift::Bool { + lhs.wrappedValue < rhs.wrappedValue + } +} +extension FoundationExtensions::Indirect : Swift::Decodable where Value : Swift::Decodable { + @inlinable public init(from decoder: any Swift::Decoder) throws { + try self.init(.init(from: decoder)) + } +} +extension FoundationExtensions::Indirect : Swift::Encodable where Value : Swift::Encodable { + @inlinable public func encode(to encoder: any Swift::Encoder) throws { + try wrappedValue.encode(to: encoder) + } +} +@available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *) +extension FoundationExtensions::Indirect : Swift::Identifiable where Value : Swift::Identifiable { + @inlinable public var id: Value.ID { + get { wrappedValue.id } + } + @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *) + public typealias ID = Value.ID +} +@propertyWrapper public struct PropertyProxy where Object : AnyObject { + public static subscript(_enclosingInstance instance: Object, wrapped wrappedKeyPath: Swift::ReferenceWritableKeyPath, storage storageKeyPath: Swift::ReferenceWritableKeyPath>) -> Value { + get + set + } + private let keyPath: Swift::ReferenceWritableKeyPath + @available(*, unavailable, message: "@PropertyProxy can only be applied to classes") + public var wrappedValue: Value { + get + set + } + public init(_ keyPath: Swift::ReferenceWritableKeyPath) +} +@propertyWrapper public struct ReadonlyPropertyProxy where Object : AnyObject { + public static subscript(_enclosingInstance instance: Object, wrapped wrappedKeyPath: Swift::KeyPath, storage storageKeyPath: Swift::KeyPath>) -> Value { + get + } + private let keyPath: Swift::KeyPath + @available(*, unavailable, message: "@PropertyProxy can only be applied to classes") + public var wrappedValue: Value { + get + set + } + public init(_ keyPath: Swift::KeyPath) +} +extension Foundation::NSNotification.Foundation::Name { + @available(*, deprecated, message: "Use IssueReporting module from https://github.com/pointfreeco/swift-issue-reporting") + @_hasInitialValue public static let foundationExtensionsRuntimeWarning: Foundation::NSNotification.Foundation::Name +} +@available(*, deprecated, message: "Use IssueReporting module from https://github.com/pointfreeco/swift-issue-reporting") +@_transparent @inlinable @inline(__always) public func runtimeWarn(_ message: @autoclosure () -> Swift::String, category: Swift::String? = "FoundationExtensions", notificationName: Foundation::Notification.Foundation::Name? = .foundationExtensionsRuntimeWarning) { +} +@_hasInitialValue public let isTesting: Swift::Bool +public struct USID : Swift::Equatable, Swift::Hashable, Swift::RawRepresentable, Swift::ExpressibleByStringLiteral, Swift::ExpressibleByStringInterpolation, Swift::LosslessStringConvertible { + public let rawValue: Swift::String + @inlinable public init(_ uuid: Foundation::UUID = .init()) { + self.init(uuid.uuidString) + } + @inlinable public init(stringLiteral value: Swift::String) { + self.init(value) + } + @inlinable public init(_ value: Swift::String) { + self.init(rawValue: value) + } + @inlinable public init(usidString value: Swift::String) { + self.init(rawValue: value) + } + @inlinable public init(rawValue value: Swift::String) { + self.rawValue = value + } + @inlinable public var description: Swift::String { + get { rawValue } + } + @inlinable public var usidString: Swift::String { + get { rawValue } + } + @inlinable public var intValue: Swift::Int? { + get { Int(rawValue) } + } + @inlinable public var uuidValue: Foundation::UUID? { + get { UUID(uuidString: rawValue) } + } + public typealias ExtendedGraphemeClusterLiteralType = Swift::String + public typealias RawValue = Swift::String + public typealias StringInterpolation = Swift::DefaultStringInterpolation + public typealias StringLiteralType = Swift::String + public typealias UnicodeScalarLiteralType = Swift::String +} +extension FoundationExtensions::USID : Swift::Codable { + @inlinable public init(from decoder: any Swift::Decoder) throws { + let container = try decoder.singleValueContainer() + self.init(rawValue: try container.decode(String.self)) + } + @inlinable public func encode(to encoder: any Swift::Encoder) throws { + var container = encoder.singleValueContainer() + try container.encode(rawValue) + } +} +extension FoundationExtensions::USID : Swift::ExpressibleByIntegerLiteral { + @inlinable public init(integerLiteral value: Swift::Int) { + self = .describing(value) + } + public typealias IntegerLiteralType = Swift::Int +} +extension FoundationExtensions::USID { + @inlinable public static func describing(_ value: Value) -> FoundationExtensions::USID where Value : Swift::CustomStringConvertible { + return USID(rawValue: String(describing: value)) + } + @inlinable public static func hash(of value: Value) -> FoundationExtensions::USID where Value : Swift::Hashable { + return .describing(value.hashValue) + } + @inlinable public static func dump(_ value: T) -> FoundationExtensions::USID { + var buffer = "\(type(of: value))\n" + Swift.dump(value, to: &buffer) + return USID(rawValue: buffer) + } +} +extension Swift::String { + @inlinable public func usid() -> FoundationExtensions::USID { .init(self) } +} diff --git a/.agents/interfaces/FoundationExtensionsMacros.swiftinterface b/.agents/interfaces/FoundationExtensionsMacros.swiftinterface new file mode 100644 index 0000000..dddc769 --- /dev/null +++ b/.agents/interfaces/FoundationExtensionsMacros.swiftinterface @@ -0,0 +1,10 @@ +// swift-interface-format-version: 1.0 +// swift-compiler-version: Apple Swift version 6.4 (swiftlang-6.4.0.25.4 clang-2100.3.25.1) +// swift-module-flags: -target arm64-apple-macos12.0 -enable-objc-interop -language-mode 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FoundationExtensionsMacros -package-name swift_foundation_extensions +// swift-module-flags-ignorable: -formal-cxx-interoperability-mode=off -interface-compiler-version 6.4 +@_exported import AssociatedObjectsMacros +@_exported import FoundationExtensions +import Swift +import _Concurrency +import _StringProcessing +import _SwiftConcurrencyShims diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..ab93b4e --- /dev/null +++ b/Makefile @@ -0,0 +1,5 @@ +output ?= .agents/interfaces + +.PHONY: swiftinterface +swiftinterface: + @./scripts/generate-swiftinterfaces.sh --package-path . --output "$(output)" diff --git a/scripts/generate-swiftinterfaces.sh b/scripts/generate-swiftinterfaces.sh new file mode 100755 index 0000000..2011ead --- /dev/null +++ b/scripts/generate-swiftinterfaces.sh @@ -0,0 +1,237 @@ +#!/usr/bin/env bash + +set -euo pipefail + +script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)" +package_path="." +output_path=".agents/interfaces" +configuration="release" +include_tests=false +triple="" +sdk="" +swift_sdk="" +scratch_path="" +declare -a selected_targets=() +declare -a build_arguments=() + +usage() { + sed -n '1,$p' <<'USAGE' +Generate public Swift interfaces for SwiftPM targets. + +Usage: + generate-swiftinterfaces.sh [options] + +Options: + --package-path Package root (default: .) + --output Destination, relative to the package root unless absolute + (default: .agents/interfaces) + --configuration debug or release (default: release) + --include-tests Include Swift test targets + --target Generate one target; repeat to select several + --triple Forward a target triple to SwiftPM + --sdk Forward an SDK path to SwiftPM + --swift-sdk Forward an installed Swift SDK name to SwiftPM + --scratch-path Use a specific SwiftPM scratch directory + --build-arg Forward one additional argument to `swift build`; repeatable + -h, --help Show this help +USAGE +} + +fail() { + printf 'swiftinterfaces: %s\n' "$*" >&2 + exit 1 +} + +require_value() { + [[ $# -ge 2 ]] || fail "$1 requires a value" +} + +while [[ $# -gt 0 ]]; do + case "$1" in + --package-path) + require_value "$@" + package_path="$2" + shift 2 + ;; + --output) + require_value "$@" + output_path="$2" + shift 2 + ;; + --configuration) + require_value "$@" + configuration="$2" + shift 2 + ;; + --include-tests) + include_tests=true + shift + ;; + --target) + require_value "$@" + selected_targets+=("$2") + shift 2 + ;; + --triple) + require_value "$@" + triple="$2" + shift 2 + ;; + --sdk) + require_value "$@" + sdk="$2" + shift 2 + ;; + --swift-sdk) + require_value "$@" + swift_sdk="$2" + shift 2 + ;; + --scratch-path) + require_value "$@" + scratch_path="$2" + shift 2 + ;; + --build-arg) + require_value "$@" + build_arguments+=("$2") + shift 2 + ;; + -h|--help) + usage + exit 0 + ;; + *) + fail "unknown option: $1" + ;; + esac +done + +case "$configuration" in + debug|release) ;; + *) fail "--configuration must be debug or release" ;; +esac + +command -v swift >/dev/null 2>&1 || fail "Swift is required" +[[ -f "$script_dir/list-swift-targets.swift" ]] || fail "missing target parser beside generator" +[[ -d "$package_path" ]] || fail "package path does not exist: $package_path" + +package_root="$(cd "$package_path" && pwd -P)" +[[ -f "$package_root/Package.swift" ]] || fail "no Package.swift at $package_root" +package_identity="$(basename "$package_root" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_]/_/g')" + +if [[ "$output_path" = /* ]]; then + output_root="$output_path" +else + output_root="$package_root/$output_path" +fi + +if [[ -z "$scratch_path" ]]; then + scratch_root="$package_root/.build/swiftinterfaces/$configuration" +elif [[ "$scratch_path" = /* ]]; then + scratch_root="$scratch_path" +else + scratch_root="$package_root/$scratch_path" +fi + +mkdir -p "$output_root" "$scratch_root/module-cache" + +description_file="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-description.XXXXXX")" +targets_file="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-targets.XXXXXX")" +build_log="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-build.XXXXXX")" +cleanup() { + rm -f "$description_file" "$targets_file" "$build_log" +} +trap cleanup EXIT INT TERM + +( + cd "$package_root" + swift package describe --type json >"$description_file" +) + +declare -a parser_arguments=("$description_file") +if [[ "$include_tests" == true ]]; then + parser_arguments+=(--include-tests) +fi +if (( ${#selected_targets[@]} > 0 )); then + for target in "${selected_targets[@]}"; do + parser_arguments+=(--target "$target") + done +fi + +CLANG_MODULE_CACHE_PATH="$scratch_root/module-cache" \ +SWIFT_MODULECACHE_PATH="$scratch_root/module-cache" \ + swift "$script_dir/list-swift-targets.swift" "${parser_arguments[@]}" >"$targets_file" + +generated_count=0 +while IFS=$'\t' read -r target_name module_name target_type package_name; do + [[ -n "$target_name" && -n "$module_name" ]] || continue + + printf 'Generating %s (%s)...\n' "$module_name" "$target_name" + + declare -a common_command=( + swift build + --package-path "$package_root" + --scratch-path "$scratch_root" + --configuration "$configuration" + --enable-parseable-module-interfaces + ) + + [[ -z "$triple" ]] || common_command+=(--triple "$triple") + [[ -z "$sdk" ]] || common_command+=(--sdk "$sdk") + [[ -z "$swift_sdk" ]] || common_command+=(--swift-sdk "$swift_sdk") + if (( ${#build_arguments[@]} > 0 )); then + common_command+=("${build_arguments[@]}") + fi + + declare -a command=("${common_command[@]}") + if [[ "$target_type" == "test" ]]; then + command+=(--build-tests -Xswiftc -enable-testing) + else + command+=(--target "$target_name") + fi + + : >"$build_log" + if ! CLANG_MODULE_CACHE_PATH="$scratch_root/module-cache" \ + SWIFT_MODULECACHE_PATH="$scratch_root/module-cache" \ + "${command[@]}" 2>&1 | tee "$build_log"; then + if [[ "$target_type" != "test" ]] && \ + grep -Eiq 'multiple targets.*(name|named)' "$build_log"; then + printf 'Target name is ambiguous; building root package products instead...\n' + : >"$build_log" + CLANG_MODULE_CACHE_PATH="$scratch_root/module-cache" \ + SWIFT_MODULECACHE_PATH="$scratch_root/module-cache" \ + "${common_command[@]}" 2>&1 | tee "$build_log" + else + fail "SwiftPM could not build target $target_name" + fi + fi + + interface_path="$( + find "$scratch_root" -type f -name "$module_name.swiftinterface" \ + -path "*/$package_name.build/*" -exec ls -t {} + 2>/dev/null | head -n 1 || true + )" + if [[ -z "$interface_path" ]]; then + interface_path="$( + find "$scratch_root" -type f -name "$module_name.swiftinterface" \ + -exec grep -F -l -- "-package-name $package_identity" {} + 2>/dev/null | head -n 1 || true + )" + fi + if [[ -z "$interface_path" ]]; then + interface_path="$( + find "$scratch_root" -type f -name "$module_name.swiftinterface" \ + -exec ls -t {} + 2>/dev/null | head -n 1 || true + )" + fi + [[ -n "$interface_path" && -f "$interface_path" ]] || \ + fail "build succeeded but no public interface was found for $target_name ($module_name)" + + temporary_output="$output_root/.$module_name.swiftinterface.$$" + cp "$interface_path" "$temporary_output" + chmod 0644 "$temporary_output" + mv "$temporary_output" "$output_root/$module_name.swiftinterface" + generated_count=$((generated_count + 1)) +done <"$targets_file" + +[[ $generated_count -gt 0 ]] || fail "no interfaces were generated" +printf 'Generated %d interface(s) in %s\n' "$generated_count" "$output_root" diff --git a/scripts/list-swift-targets.swift b/scripts/list-swift-targets.swift new file mode 100755 index 0000000..4bac0c3 --- /dev/null +++ b/scripts/list-swift-targets.swift @@ -0,0 +1,82 @@ +#!/usr/bin/env swift + +import Foundation + +private struct PackageDescription: Decodable { + let name: String + let targets: [Target] +} + +private struct Target: Decodable { + let c99Name: String? + let moduleType: String? + let name: String + let type: String + + enum CodingKeys: String, CodingKey { + case c99Name = "c99name" + case moduleType = "module_type" + case name + case type + } +} + +private struct Options { + var includeTests = false + var selectedTargets = Set() + var jsonPath: String? +} + +private func fail(_ message: String) -> Never { + FileHandle.standardError.write(Data("swiftinterfaces: \(message)\n".utf8)) + exit(1) +} + +private var options = Options() +private var arguments = Array(CommandLine.arguments.dropFirst()) + +while !arguments.isEmpty { + let argument = arguments.removeFirst() + switch argument { + case "--include-tests": + options.includeTests = true + case "--target": + guard !arguments.isEmpty else { fail("--target requires a value") } + options.selectedTargets.insert(arguments.removeFirst()) + default: + guard !argument.hasPrefix("-") else { fail("unknown parser option: \(argument)") } + guard options.jsonPath == nil else { fail("expected exactly one package-description JSON file") } + options.jsonPath = argument + } +} + +guard let jsonPath = options.jsonPath else { fail("missing package-description JSON file") } + +do { + let data = try Data(contentsOf: URL(fileURLWithPath: jsonPath)) + let package = try JSONDecoder().decode(PackageDescription.self, from: data) + let swiftTargets = package.targets.filter { target in + target.moduleType == "SwiftTarget" && (options.includeTests || target.type != "test") + } + let availableNames = Set(swiftTargets.map(\.name)) + let unknownTargets = options.selectedTargets.subtracting(availableNames).sorted() + + guard unknownTargets.isEmpty else { + fail("unknown or excluded Swift target(s): \(unknownTargets.joined(separator: ", "))") + } + + let selected = swiftTargets + .filter { options.selectedTargets.isEmpty || options.selectedTargets.contains($0.name) } + .sorted { $0.name.localizedStandardCompare($1.name) == .orderedAscending } + + guard !selected.isEmpty else { fail("the package has no matching Swift targets") } + + for target in selected { + guard let moduleName = target.c99Name, !moduleName.isEmpty else { + fail("target \(target.name) does not have a Swift module name") + } + print("\(target.name)\t\(moduleName)\t\(target.type)\t\(package.name)") + } +} catch { + fail("could not decode package description: \(error)") +} From 92d061ca888be1525855c0dff27b4f53668f2ec3 Mon Sep 17 00:00:00 2001 From: maximkrouk Date: Tue, 4 Aug 2026 11:18:57 +0200 Subject: [PATCH 3/4] Generate Swift interfaces per platform --- .../FoundationExtensions.swiftinterface | 0 .../FoundationExtensionsMacros.swiftinterface | 0 .github/workflows/generate-swiftinterface.yml | 143 ++++++++++++++ .github/workflows/update-swiftinterfaces.yml | 102 ++++++++++ Makefile | 4 +- scripts/generate-swiftinterfaces.sh | 179 +++++++++++++++--- scripts/list-swift-targets.swift | 18 ++ 7 files changed, 419 insertions(+), 27 deletions(-) rename .agents/interfaces/{ => macos}/FoundationExtensions.swiftinterface (100%) rename .agents/interfaces/{ => macos}/FoundationExtensionsMacros.swiftinterface (100%) create mode 100644 .github/workflows/generate-swiftinterface.yml create mode 100644 .github/workflows/update-swiftinterfaces.yml diff --git a/.agents/interfaces/FoundationExtensions.swiftinterface b/.agents/interfaces/macos/FoundationExtensions.swiftinterface similarity index 100% rename from .agents/interfaces/FoundationExtensions.swiftinterface rename to .agents/interfaces/macos/FoundationExtensions.swiftinterface diff --git a/.agents/interfaces/FoundationExtensionsMacros.swiftinterface b/.agents/interfaces/macos/FoundationExtensionsMacros.swiftinterface similarity index 100% rename from .agents/interfaces/FoundationExtensionsMacros.swiftinterface rename to .agents/interfaces/macos/FoundationExtensionsMacros.swiftinterface diff --git a/.github/workflows/generate-swiftinterface.yml b/.github/workflows/generate-swiftinterface.yml new file mode 100644 index 0000000..3c4628a --- /dev/null +++ b/.github/workflows/generate-swiftinterface.yml @@ -0,0 +1,143 @@ +name: Generate Swift interface +run-name: Generate ${{ inputs.platform }} interfaces + +on: + workflow_dispatch: + inputs: + platform: + description: Normalized platform name (macos, ios, linux, windows, wasi, ...) + required: true + type: string + base_branch: + description: Branch that receives the generated-interface PR (defaults to the dispatched branch) + required: false + default: "" + type: string + request_id: + description: Optional stable ID shared by an umbrella run + required: false + default: "" + type: string + swift_sdk: + description: Optional installed Swift SDK ID (auto-detected for WASI) + required: false + default: "" + type: string + workflow_call: + inputs: + platform: + required: true + type: string + base_branch: + required: true + type: string + request_id: + required: true + type: string + swift_sdk: + required: false + default: "" + type: string + +permissions: + contents: write + pull-requests: write + +jobs: + generate: + name: Generate ${{ inputs.platform }} + runs-on: ${{ (inputs.platform == 'linux' || inputs.platform == 'wasi') && 'ubuntu-latest' || inputs.platform == 'windows' && 'windows-latest' || 'macos-latest' }} + env: + GH_TOKEN: ${{ github.token }} + INPUT_BASE_BRANCH: ${{ inputs.base_branch }} + INPUT_REQUEST_ID: ${{ inputs.request_id }} + INPUT_SWIFT_SDK: ${{ inputs.swift_sdk }} + PLATFORM: ${{ inputs.platform }} + steps: + - name: Validate request + shell: bash + run: | + if [[ ! "$PLATFORM" =~ ^[a-z0-9][a-z0-9._-]*$ ]]; then + echo "Platform must be a normalized lowercase directory name: $PLATFORM" >&2 + exit 1 + fi + + - uses: actions/checkout@v6 + with: + fetch-depth: 0 + ref: ${{ inputs.base_branch != '' && inputs.base_branch || github.ref_name }} + + - name: Set up Swift outside Xcode + if: runner.os != 'macOS' + uses: SwiftyLab/setup-swift@v1 + with: + swift-version: "6" + sdks: ${{ inputs.platform == 'wasi' && 'wasm' || '' }} + + - name: Prepare generation branch + shell: bash + run: | + base_branch="${INPUT_BASE_BRANCH:-$GITHUB_REF_NAME}" + request_id="${INPUT_REQUEST_ID:-$GITHUB_RUN_ID}" + interface_branch="automation/swiftinterfaces/$request_id/$PLATFORM" + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git switch -C "$interface_branch" + echo "BASE_BRANCH=$base_branch" >> "$GITHUB_ENV" + echo "INTERFACE_BRANCH=$interface_branch" >> "$GITHUB_ENV" + + - name: Select WASI SDK + if: inputs.platform == 'wasi' + shell: bash + run: | + swift_sdk="$INPUT_SWIFT_SDK" + if [[ -z "$swift_sdk" ]]; then + swift_sdk="$(swift sdk list | sed -nE '/(_wasm|wasi)/ { s/^[[:space:]]*([^[:space:]]+).*/\1/p; q; }')" + fi + if [[ -z "$swift_sdk" ]]; then + echo "No installed WASI Swift SDK was found" >&2 + swift sdk list >&2 || true + exit 1 + fi + echo "INPUT_SWIFT_SDK=$swift_sdk" >> "$GITHUB_ENV" + + - name: Generate interface + shell: bash + run: | + interface_dir=".agents/interfaces/$PLATFORM" + if [[ -d "$interface_dir" ]]; then + find "$interface_dir" -maxdepth 1 -type f -name '*.swiftinterface' -delete + fi + if [[ -n "$INPUT_SWIFT_SDK" ]]; then + make swiftinterface platform="$PLATFORM" swift_sdk="$INPUT_SWIFT_SDK" + else + make swiftinterface platform="$PLATFORM" + fi + + - name: Commit and push interface + id: commit + shell: bash + run: | + git add --all -- ".agents/interfaces/$PLATFORM" + if git diff --cached --quiet; then + echo "changed=false" >> "$GITHUB_OUTPUT" + echo "No $PLATFORM interface changes" >> "$GITHUB_STEP_SUMMARY" + exit 0 + fi + git commit -m "Update $PLATFORM Swift interfaces" + git push --force-with-lease --set-upstream origin "$INTERFACE_BRANCH" + echo "changed=true" >> "$GITHUB_OUTPUT" + + - name: Open platform PR + if: steps.commit.outputs.changed == 'true' + shell: bash + run: | + pr_url="$(gh pr list --state open --base "$BASE_BRANCH" --head "$INTERFACE_BRANCH" --json url --jq '.[0].url')" + if [[ -z "$pr_url" ]]; then + pr_url="$(gh pr create \ + --base "$BASE_BRANCH" \ + --head "$INTERFACE_BRANCH" \ + --title "Update $PLATFORM Swift interfaces" \ + --body "Generated from \`$BASE_BRANCH\` by workflow run $GITHUB_RUN_ID. Merge this PR into the aggregation branch after reviewing the platform-specific API snapshot.")" + fi + echo "$pr_url" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/update-swiftinterfaces.yml b/.github/workflows/update-swiftinterfaces.yml new file mode 100644 index 0000000..151464e --- /dev/null +++ b/.github/workflows/update-swiftinterfaces.yml @@ -0,0 +1,102 @@ +name: Update Swift interfaces +run-name: Update Swift interfaces from ${{ inputs.source_branch || github.ref_name }} + +on: + workflow_dispatch: + inputs: + source_branch: + description: Source branch to aggregate into (defaults to the dispatched branch) + required: false + default: "" + type: string + platforms: + description: JSON array of independently generated platforms + required: true + default: '["macos","ios","tvos","watchos","maccatalyst"]' + type: string + wasi_swift_sdk: + description: Optional installed Swift SDK ID for WASI + required: false + default: "" + type: string + +permissions: + contents: write + pull-requests: write + +jobs: + prepare: + name: Create aggregation branch + runs-on: ubuntu-latest + outputs: + source_branch: ${{ steps.branch.outputs.source_branch }} + update_branch: ${{ steps.branch.outputs.update_branch }} + steps: + - uses: actions/checkout@v6 + with: + fetch-depth: 0 + ref: ${{ inputs.source_branch != '' && inputs.source_branch || github.ref_name }} + + - name: Push aggregation branch + id: branch + shell: bash + env: + SOURCE_BRANCH_INPUT: ${{ inputs.source_branch != '' && inputs.source_branch || github.ref_name }} + run: | + source_branch="$SOURCE_BRANCH_INPUT" + update_branch="automation/swiftinterfaces/$GITHUB_RUN_ID" + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git switch -C "$update_branch" + git commit --allow-empty -m "Prepare Swift interface update" + git push --force-with-lease --set-upstream origin "$update_branch" + echo "source_branch=$source_branch" >> "$GITHUB_OUTPUT" + echo "update_branch=$update_branch" >> "$GITHUB_OUTPUT" + + generate: + name: Generate ${{ matrix.platform }} + needs: prepare + strategy: + fail-fast: false + matrix: + platform: ${{ fromJSON(inputs.platforms) }} + permissions: + contents: write + pull-requests: write + uses: ./.github/workflows/generate-swiftinterface.yml + with: + platform: ${{ matrix.platform }} + base_branch: ${{ needs.prepare.outputs.update_branch }} + request_id: ${{ format('{0}', github.run_id) }} + swift_sdk: ${{ matrix.platform == 'wasi' && inputs.wasi_swift_sdk || '' }} + + finalize: + name: Open draft aggregation PR + if: always() && needs.prepare.result == 'success' + needs: + - prepare + - generate + runs-on: ubuntu-latest + env: + GH_TOKEN: ${{ github.token }} + SOURCE_BRANCH: ${{ needs.prepare.outputs.source_branch }} + UPDATE_BRANCH: ${{ needs.prepare.outputs.update_branch }} + steps: + - uses: actions/checkout@v6 + with: + fetch-depth: 0 + ref: ${{ needs.prepare.outputs.source_branch }} + + - name: Open draft PR + shell: bash + run: | + pr_url="$(gh pr list --state open --base "$SOURCE_BRANCH" --head "$UPDATE_BRANCH" --json url --jq '.[0].url')" + if [[ -z "$pr_url" ]]; then + pr_url="$(gh pr create \ + --draft \ + --base "$SOURCE_BRANCH" \ + --head "$UPDATE_BRANCH" \ + --title "Update platform Swift interfaces" \ + --body "Aggregation PR for workflow run $GITHUB_RUN_ID. Merge the successful platform PRs into \`$UPDATE_BRANCH\`; failed platform jobs remain visible in the workflow and can be fixed or intentionally ignored. Matrix result: \`${{ needs.generate.result }}\`.")" + fi + echo "$pr_url" >> "$GITHUB_STEP_SUMMARY" diff --git a/Makefile b/Makefile index ab93b4e..c9eab41 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,7 @@ output ?= .agents/interfaces +platform ?= host +swift_sdk ?= .PHONY: swiftinterface swiftinterface: - @./scripts/generate-swiftinterfaces.sh --package-path . --output "$(output)" + @./scripts/generate-swiftinterfaces.sh --package-path . --output "$(output)" --platform "$(platform)" $(if $(swift_sdk),--swift-sdk "$(swift_sdk)") diff --git a/scripts/generate-swiftinterfaces.sh b/scripts/generate-swiftinterfaces.sh index 2011ead..b028e55 100755 --- a/scripts/generate-swiftinterfaces.sh +++ b/scripts/generate-swiftinterfaces.sh @@ -7,6 +7,8 @@ package_path="." output_path=".agents/interfaces" configuration="release" include_tests=false +list_declared_platforms=false +platform="" triple="" sdk="" swift_sdk="" @@ -16,24 +18,32 @@ declare -a build_arguments=() usage() { sed -n '1,$p' <<'USAGE' -Generate public Swift interfaces for SwiftPM targets. +Generate public Swift interfaces for one SwiftPM platform. Usage: - generate-swiftinterfaces.sh [options] + generate-swiftinterfaces.sh --platform [options] + generate-swiftinterfaces.sh --list-declared-platforms [options] Options: - --package-path Package root (default: .) - --output Destination, relative to the package root unless absolute - (default: .agents/interfaces) - --configuration debug or release (default: release) - --include-tests Include Swift test targets - --target Generate one target; repeat to select several - --triple Forward a target triple to SwiftPM - --sdk Forward an SDK path to SwiftPM - --swift-sdk Forward an installed Swift SDK name to SwiftPM - --scratch-path Use a specific SwiftPM scratch directory - --build-arg Forward one additional argument to `swift build`; repeatable - -h, --help Show this help + --package-path Package root (default: .) + --output Platform-parent destination, relative to the package root + unless absolute (default: .agents/interfaces) + --platform Output/build platform, for example macos, ios, linux, + windows, or wasi; host resolves to the current platform + --list-declared-platforms Print the Apple/custom platforms declared by Package.swift + --configuration debug or release (default: release) + --include-tests Include Swift test targets + --target Generate one target; repeat to select several + --triple Forward a target triple to SwiftPM + --sdk Forward an SDK path to SwiftPM + --swift-sdk Forward an installed Swift SDK name to SwiftPM + --scratch-path Use a specific SwiftPM scratch directory + --build-arg Forward one additional argument to `swift build`; repeatable + -h, --help Show this help + +The platform name becomes an output directory. For example, --platform ios writes +/ios/.swiftinterface. Generate platforms in separate invocations so +one unsupported platform does not suppress successful platform snapshots. USAGE } @@ -46,6 +56,32 @@ require_value() { [[ $# -ge 2 ]] || fail "$1 requires a value" } +host_platform() { + case "$(uname -s)" in + Darwin) printf 'macos\n' ;; + Linux) printf 'linux\n' ;; + MINGW*|MSYS*|CYGWIN*|Windows_NT) printf 'windows\n' ;; + *) fail "cannot infer a platform from host $(uname -s); pass --platform explicitly" ;; + esac +} + +normalize_platform() { + local value + value="$(printf '%s' "$1" | tr '[:upper:]' '[:lower:]')" + case "$value" in + osx|macosx) value="macos" ;; + iphoneos|iphonesimulator) value="ios" ;; + appletvos|appletvsimulator) value="tvos" ;; + watchsimulator) value="watchos" ;; + xros|xrsimulator) value="visionos" ;; + catalyst|mac-catalyst|mac_catalyst) value="maccatalyst" ;; + wasm|webassembly) value="wasi" ;; + host) value="$(host_platform)" ;; + esac + [[ "$value" =~ ^[a-z0-9][a-z0-9._-]*$ ]] || fail "invalid platform name: $1" + printf '%s\n' "$value" +} + while [[ $# -gt 0 ]]; do case "$1" in --package-path) @@ -58,6 +94,16 @@ while [[ $# -gt 0 ]]; do output_path="$2" shift 2 ;; + --platform) + require_value "$@" + [[ -z "$platform" ]] || fail "--platform may be passed only once" + platform="$2" + shift 2 + ;; + --list-declared-platforms) + list_declared_platforms=true + shift + ;; --configuration) require_value "$@" configuration="$2" @@ -112,35 +158,39 @@ case "$configuration" in *) fail "--configuration must be debug or release" ;; esac +[[ "$list_declared_platforms" == false || -z "$platform" ]] || \ + fail "--platform and --list-declared-platforms are separate operations" +[[ "$list_declared_platforms" == true || -n "$platform" ]] || \ + fail "--platform is required; use --list-declared-platforms to inspect Package.swift" + command -v swift >/dev/null 2>&1 || fail "Swift is required" -[[ -f "$script_dir/list-swift-targets.swift" ]] || fail "missing target parser beside generator" +[[ -f "$script_dir/list-swift-targets.swift" ]] || fail "missing package parser beside generator" [[ -d "$package_path" ]] || fail "package path does not exist: $package_path" package_root="$(cd "$package_path" && pwd -P)" [[ -f "$package_root/Package.swift" ]] || fail "no Package.swift at $package_root" package_identity="$(basename "$package_root" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_]/_/g')" -if [[ "$output_path" = /* ]]; then - output_root="$output_path" -else - output_root="$package_root/$output_path" +if [[ -n "$platform" ]]; then + platform="$(normalize_platform "$platform")" fi if [[ -z "$scratch_path" ]]; then - scratch_root="$package_root/.build/swiftinterfaces/$configuration" + scratch_root="$package_root/.build/swiftinterfaces/${platform:-metadata}/$configuration" elif [[ "$scratch_path" = /* ]]; then scratch_root="$scratch_path" else scratch_root="$package_root/$scratch_path" fi -mkdir -p "$output_root" "$scratch_root/module-cache" +mkdir -p "$scratch_root/module-cache" description_file="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-description.XXXXXX")" targets_file="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-targets.XXXXXX")" +platforms_file="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-platforms.XXXXXX")" build_log="$(mktemp "${TMPDIR:-/tmp}/swiftinterfaces-build.XXXXXX")" cleanup() { - rm -f "$description_file" "$targets_file" "$build_log" + rm -f "$description_file" "$targets_file" "$platforms_file" "$build_log" } trap cleanup EXIT INT TERM @@ -149,6 +199,83 @@ trap cleanup EXIT INT TERM swift package describe --type json >"$description_file" ) +CLANG_MODULE_CACHE_PATH="$scratch_root/module-cache" \ +SWIFT_MODULECACHE_PATH="$scratch_root/module-cache" \ + swift "$script_dir/list-swift-targets.swift" \ + --list-platforms "$description_file" >"$platforms_file" + +if [[ "$list_declared_platforms" == true ]]; then + if [[ -s "$platforms_file" ]]; then + cat "$platforms_file" + else + printf 'swiftinterfaces: Package.swift declares no platforms; support must be proven by a platform build\n' >&2 + fi + exit 0 +fi + +host="$(host_platform)" +if [[ -z "$swift_sdk" ]]; then + sdk_name="" + default_triple="" + case "$platform" in + macos) + [[ "$host" == "macos" || -n "$triple" || -n "$sdk" ]] || \ + fail "macos generation requires a macOS host or explicit cross-compilation options" + ;; + ios) + sdk_name="iphonesimulator" + default_triple="arm64-apple-ios-simulator" + ;; + tvos) + sdk_name="appletvsimulator" + default_triple="arm64-apple-tvos-simulator" + ;; + watchos) + sdk_name="watchsimulator" + default_triple="arm64-apple-watchos-simulator" + ;; + visionos) + sdk_name="xrsimulator" + default_triple="arm64-apple-xros-simulator" + ;; + maccatalyst) + sdk_name="macosx" + default_triple="arm64-apple-ios-macabi" + ;; + driverkit) + sdk_name="driverkit" + default_triple="arm64-apple-driverkit" + ;; + linux|windows) + [[ "$host" == "$platform" || -n "$triple" || -n "$sdk" ]] || \ + fail "$platform generation requires a $platform host or explicit cross-compilation options" + ;; + wasi) + [[ -n "$triple" || -n "$sdk" ]] || \ + fail "wasi generation requires --swift-sdk (recommended) or explicit --triple/--sdk options" + ;; + *) + [[ -n "$triple" || -n "$sdk" ]] || \ + fail "custom platform $platform requires --swift-sdk or explicit --triple/--sdk options" + ;; + esac + + if [[ -n "$sdk_name" ]]; then + [[ "$host" == "macos" ]] || fail "$platform generation requires Xcode on macOS" + command -v xcrun >/dev/null 2>&1 || fail "xcrun is required for $platform generation" + [[ -n "$sdk" ]] || sdk="$(xcrun --sdk "$sdk_name" --show-sdk-path)" + [[ -n "$triple" ]] || triple="$default_triple" + fi +fi + +if [[ "$output_path" = /* ]]; then + output_parent="$output_path" +else + output_parent="$package_root/$output_path" +fi +output_root="$output_parent/$platform" +mkdir -p "$output_root" + declare -a parser_arguments=("$description_file") if [[ "$include_tests" == true ]]; then parser_arguments+=(--include-tests) @@ -167,7 +294,7 @@ generated_count=0 while IFS=$'\t' read -r target_name module_name target_type package_name; do [[ -n "$target_name" && -n "$module_name" ]] || continue - printf 'Generating %s (%s)...\n' "$module_name" "$target_name" + printf 'Generating %s (%s) for %s...\n' "$module_name" "$target_name" "$platform" declare -a common_command=( swift build @@ -203,7 +330,7 @@ while IFS=$'\t' read -r target_name module_name target_type package_name; do SWIFT_MODULECACHE_PATH="$scratch_root/module-cache" \ "${common_command[@]}" 2>&1 | tee "$build_log" else - fail "SwiftPM could not build target $target_name" + fail "SwiftPM could not build target $target_name for $platform" fi fi @@ -224,7 +351,7 @@ while IFS=$'\t' read -r target_name module_name target_type package_name; do )" fi [[ -n "$interface_path" && -f "$interface_path" ]] || \ - fail "build succeeded but no public interface was found for $target_name ($module_name)" + fail "build succeeded but no public interface was found for $target_name ($module_name) on $platform" temporary_output="$output_root/.$module_name.swiftinterface.$$" cp "$interface_path" "$temporary_output" @@ -233,5 +360,5 @@ while IFS=$'\t' read -r target_name module_name target_type package_name; do generated_count=$((generated_count + 1)) done <"$targets_file" -[[ $generated_count -gt 0 ]] || fail "no interfaces were generated" +[[ $generated_count -gt 0 ]] || fail "no interfaces were generated for $platform" printf 'Generated %d interface(s) in %s\n' "$generated_count" "$output_root" diff --git a/scripts/list-swift-targets.swift b/scripts/list-swift-targets.swift index 4bac0c3..b66371d 100755 --- a/scripts/list-swift-targets.swift +++ b/scripts/list-swift-targets.swift @@ -4,7 +4,13 @@ import Foundation private struct PackageDescription: Decodable { let name: String + let platforms: [Platform] let targets: [Target] + + struct Platform: Decodable { + let name: String + let version: String + } } private struct Target: Decodable { @@ -23,6 +29,7 @@ private struct Target: Decodable { private struct Options { var includeTests = false + var listPlatforms = false var selectedTargets = Set() var jsonPath: String? } @@ -40,6 +47,8 @@ while !arguments.isEmpty { switch argument { case "--include-tests": options.includeTests = true + case "--list-platforms": + options.listPlatforms = true case "--target": guard !arguments.isEmpty else { fail("--target requires a value") } options.selectedTargets.insert(arguments.removeFirst()) @@ -55,6 +64,15 @@ guard let jsonPath = options.jsonPath else { fail("missing package-description J do { let data = try Data(contentsOf: URL(fileURLWithPath: jsonPath)) let package = try JSONDecoder().decode(PackageDescription.self, from: data) + if options.listPlatforms { + guard options.selectedTargets.isEmpty, !options.includeTests else { + fail("--list-platforms cannot be combined with target-selection options") + } + for platform in package.platforms.sorted(by: { $0.name < $1.name }) { + print("\(platform.name)\t\(platform.version)") + } + exit(0) + } let swiftTargets = package.targets.filter { target in target.moduleType == "SwiftTarget" && (options.includeTests || target.type != "test") } From 4c1c74f9ef9891152c00b8c02e155cf70dd7640a Mon Sep 17 00:00:00 2001 From: maximkrouk Date: Tue, 4 Aug 2026 12:12:31 +0200 Subject: [PATCH 4/4] Refine Swift interface workflows --- .github/workflows/generate-swiftinterface.yml | 53 ++++++------------- .github/workflows/update-swiftinterfaces.yml | 33 +++--------- 2 files changed, 23 insertions(+), 63 deletions(-) diff --git a/.github/workflows/generate-swiftinterface.yml b/.github/workflows/generate-swiftinterface.yml index 3c4628a..a7a4239 100644 --- a/.github/workflows/generate-swiftinterface.yml +++ b/.github/workflows/generate-swiftinterface.yml @@ -8,36 +8,19 @@ on: description: Normalized platform name (macos, ios, linux, windows, wasi, ...) required: true type: string - base_branch: + target_branch: description: Branch that receives the generated-interface PR (defaults to the dispatched branch) required: false default: "" type: string - request_id: - description: Optional stable ID shared by an umbrella run - required: false - default: "" - type: string - swift_sdk: - description: Optional installed Swift SDK ID (auto-detected for WASI) - required: false - default: "" - type: string workflow_call: inputs: platform: required: true type: string - base_branch: + target_branch: required: true type: string - request_id: - required: true - type: string - swift_sdk: - required: false - default: "" - type: string permissions: contents: write @@ -49,9 +32,7 @@ jobs: runs-on: ${{ (inputs.platform == 'linux' || inputs.platform == 'wasi') && 'ubuntu-latest' || inputs.platform == 'windows' && 'windows-latest' || 'macos-latest' }} env: GH_TOKEN: ${{ github.token }} - INPUT_BASE_BRANCH: ${{ inputs.base_branch }} - INPUT_REQUEST_ID: ${{ inputs.request_id }} - INPUT_SWIFT_SDK: ${{ inputs.swift_sdk }} + INPUT_TARGET_BRANCH: ${{ inputs.target_branch }} PLATFORM: ${{ inputs.platform }} steps: - name: Validate request @@ -65,7 +46,7 @@ jobs: - uses: actions/checkout@v6 with: fetch-depth: 0 - ref: ${{ inputs.base_branch != '' && inputs.base_branch || github.ref_name }} + ref: ${{ inputs.target_branch != '' && inputs.target_branch || github.ref_name }} - name: Set up Swift outside Xcode if: runner.os != 'macOS' @@ -77,29 +58,25 @@ jobs: - name: Prepare generation branch shell: bash run: | - base_branch="${INPUT_BASE_BRANCH:-$GITHUB_REF_NAME}" - request_id="${INPUT_REQUEST_ID:-$GITHUB_RUN_ID}" - interface_branch="automation/swiftinterfaces/$request_id/$PLATFORM" + target_branch="${INPUT_TARGET_BRANCH:-$GITHUB_REF_NAME}" + interface_branch="automation/swiftinterfaces/$GITHUB_RUN_ID/$PLATFORM" git config user.name "github-actions[bot]" git config user.email "41898282+github-actions[bot]@users.noreply.github.com" git switch -C "$interface_branch" - echo "BASE_BRANCH=$base_branch" >> "$GITHUB_ENV" + echo "TARGET_BRANCH=$target_branch" >> "$GITHUB_ENV" echo "INTERFACE_BRANCH=$interface_branch" >> "$GITHUB_ENV" - name: Select WASI SDK if: inputs.platform == 'wasi' shell: bash run: | - swift_sdk="$INPUT_SWIFT_SDK" - if [[ -z "$swift_sdk" ]]; then - swift_sdk="$(swift sdk list | sed -nE '/(_wasm|wasi)/ { s/^[[:space:]]*([^[:space:]]+).*/\1/p; q; }')" - fi + swift_sdk="$(swift sdk list | sed -nE '/(_wasm|wasi)/ { s/^[[:space:]]*([^[:space:]]+).*/\1/p; q; }')" if [[ -z "$swift_sdk" ]]; then echo "No installed WASI Swift SDK was found" >&2 swift sdk list >&2 || true exit 1 fi - echo "INPUT_SWIFT_SDK=$swift_sdk" >> "$GITHUB_ENV" + echo "SWIFT_SDK=$swift_sdk" >> "$GITHUB_ENV" - name: Generate interface shell: bash @@ -108,8 +85,8 @@ jobs: if [[ -d "$interface_dir" ]]; then find "$interface_dir" -maxdepth 1 -type f -name '*.swiftinterface' -delete fi - if [[ -n "$INPUT_SWIFT_SDK" ]]; then - make swiftinterface platform="$PLATFORM" swift_sdk="$INPUT_SWIFT_SDK" + if [[ -n "${SWIFT_SDK:-}" ]]; then + make swiftinterface platform="$PLATFORM" swift_sdk="$SWIFT_SDK" else make swiftinterface platform="$PLATFORM" fi @@ -132,12 +109,12 @@ jobs: if: steps.commit.outputs.changed == 'true' shell: bash run: | - pr_url="$(gh pr list --state open --base "$BASE_BRANCH" --head "$INTERFACE_BRANCH" --json url --jq '.[0].url')" + pr_url="$(gh pr list --state open --base "$TARGET_BRANCH" --head "$INTERFACE_BRANCH" --json url --jq '.[0].url')" if [[ -z "$pr_url" ]]; then pr_url="$(gh pr create \ - --base "$BASE_BRANCH" \ + --base "$TARGET_BRANCH" \ --head "$INTERFACE_BRANCH" \ - --title "Update $PLATFORM Swift interfaces" \ - --body "Generated from \`$BASE_BRANCH\` by workflow run $GITHUB_RUN_ID. Merge this PR into the aggregation branch after reviewing the platform-specific API snapshot.")" + --title "chore: update $PLATFORM Swift interfaces" \ + --body "Generated from \`$TARGET_BRANCH\` by workflow run $GITHUB_RUN_ID. Merge this PR into the aggregation branch after reviewing the platform-specific API snapshot.")" fi echo "$pr_url" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/update-swiftinterfaces.yml b/.github/workflows/update-swiftinterfaces.yml index 151464e..27fc7c9 100644 --- a/.github/workflows/update-swiftinterfaces.yml +++ b/.github/workflows/update-swiftinterfaces.yml @@ -1,24 +1,14 @@ name: Update Swift interfaces -run-name: Update Swift interfaces from ${{ inputs.source_branch || github.ref_name }} +run-name: Update Swift interfaces from ${{ github.ref_name }} on: workflow_dispatch: inputs: - source_branch: - description: Source branch to aggregate into (defaults to the dispatched branch) - required: false - default: "" - type: string platforms: description: JSON array of independently generated platforms required: true default: '["macos","ios","tvos","watchos","maccatalyst"]' type: string - wasi_swift_sdk: - description: Optional installed Swift SDK ID for WASI - required: false - default: "" - type: string permissions: contents: write @@ -29,28 +19,23 @@ jobs: name: Create aggregation branch runs-on: ubuntu-latest outputs: - source_branch: ${{ steps.branch.outputs.source_branch }} update_branch: ${{ steps.branch.outputs.update_branch }} steps: - uses: actions/checkout@v6 with: fetch-depth: 0 - ref: ${{ inputs.source_branch != '' && inputs.source_branch || github.ref_name }} + ref: ${{ github.ref_name }} - name: Push aggregation branch id: branch shell: bash - env: - SOURCE_BRANCH_INPUT: ${{ inputs.source_branch != '' && inputs.source_branch || github.ref_name }} run: | - source_branch="$SOURCE_BRANCH_INPUT" update_branch="automation/swiftinterfaces/$GITHUB_RUN_ID" git config user.name "github-actions[bot]" git config user.email "41898282+github-actions[bot]@users.noreply.github.com" git switch -C "$update_branch" git commit --allow-empty -m "Prepare Swift interface update" git push --force-with-lease --set-upstream origin "$update_branch" - echo "source_branch=$source_branch" >> "$GITHUB_OUTPUT" echo "update_branch=$update_branch" >> "$GITHUB_OUTPUT" generate: @@ -66,9 +51,7 @@ jobs: uses: ./.github/workflows/generate-swiftinterface.yml with: platform: ${{ matrix.platform }} - base_branch: ${{ needs.prepare.outputs.update_branch }} - request_id: ${{ format('{0}', github.run_id) }} - swift_sdk: ${{ matrix.platform == 'wasi' && inputs.wasi_swift_sdk || '' }} + target_branch: ${{ needs.prepare.outputs.update_branch }} finalize: name: Open draft aggregation PR @@ -79,24 +62,24 @@ jobs: runs-on: ubuntu-latest env: GH_TOKEN: ${{ github.token }} - SOURCE_BRANCH: ${{ needs.prepare.outputs.source_branch }} + TARGET_BRANCH: ${{ github.ref_name }} UPDATE_BRANCH: ${{ needs.prepare.outputs.update_branch }} steps: - uses: actions/checkout@v6 with: fetch-depth: 0 - ref: ${{ needs.prepare.outputs.source_branch }} + ref: ${{ github.ref_name }} - name: Open draft PR shell: bash run: | - pr_url="$(gh pr list --state open --base "$SOURCE_BRANCH" --head "$UPDATE_BRANCH" --json url --jq '.[0].url')" + pr_url="$(gh pr list --state open --base "$TARGET_BRANCH" --head "$UPDATE_BRANCH" --json url --jq '.[0].url')" if [[ -z "$pr_url" ]]; then pr_url="$(gh pr create \ --draft \ - --base "$SOURCE_BRANCH" \ + --base "$TARGET_BRANCH" \ --head "$UPDATE_BRANCH" \ - --title "Update platform Swift interfaces" \ + --title "chore: update platform Swift interfaces" \ --body "Aggregation PR for workflow run $GITHUB_RUN_ID. Merge the successful platform PRs into \`$UPDATE_BRANCH\`; failed platform jobs remain visible in the workflow and can be fixed or intentionally ignored. Matrix result: \`${{ needs.generate.result }}\`.")" fi echo "$pr_url" >> "$GITHUB_STEP_SUMMARY"