@mmerterden/multi-agent-pipeline 20.36.0 → 20.37.0

package/pipeline/skills/shared/external/swiftdata/references/code-examples.md

@@ -0,0 +1,140 @@
+# SwiftData Code Examples
+
+<!-- toc -->
+- [Defining models](#defining-models)
+- [Container setup](#container-setup)
+- [Schema versions and migration](#schema-versions-and-migration)
+<!-- /toc -->
+
+Full code samples for the SKILL.md sections that link here. The rules and the decision guidance stay in SKILL.md; each heading below matches the SKILL.md section the code belongs to.
+
+## Defining models
+
+```swift
+import SwiftData
+import Foundation
+
+@Model
+class Plant {
+    var commonName: String
+    var acquiredOn: Date
+    var needsRepotting: Bool = false
+    @Attribute(.externalStorage) var photo: Data?
+    @Relationship(deleteRule: .cascade, inverse: \CareEvent.plant)
+    var careEvents: [CareEvent] = []
+    var bed: GardenBed?
+    @Transient var isHighlighted: Bool = false
+
+    init(commonName: String, acquiredOn: Date = .now) {
+        self.commonName = commonName
+        self.acquiredOn = acquiredOn
+    }
+}
+
+@Model
+final class GardenBed {
+    var label: String
+    @Relationship(deleteRule: .nullify, inverse: \Plant.bed)
+    var plants: [Plant] = []
+    init(label: String) { self.label = label }
+}
+
+@Model
+final class CareEvent {
+    var kind: String
+    var loggedAt: Date
+    var plant: Plant?
+
+    init(kind: String, loggedAt: Date) {
+        self.kind = kind
+        self.loggedAt = loggedAt
+    }
+}
+```
+
+## Container setup
+
+```swift
+// Every model type the app stores, listed once.
+let simple = try ModelContainer(for: Plant.self, CareEvent.self, GardenBed.self)
+
+// Named store, shared with extensions, synced to a private CloudKit database.
+let config = ModelConfiguration(
+    "Garden",
+    isStoredInMemoryOnly: false,
+    groupContainer: .identifier("group.example.garden"),
+    cloudKitDatabase: .private("iCloud.example.garden")
+)
+let configured = try ModelContainer(for: Plant.self, configurations: config)
+
+// Versioned schema with a migration plan.
+let migrating = try ModelContainer(
+    for: GardenSchemaV3.Plant.self,
+    migrationPlan: GardenMigrationPlan.self
+)
+
+// Tests and previews: nothing touches disk.
+let scratch = try ModelContainer(
+    for: Plant.self,
+    configurations: ModelConfiguration(isStoredInMemoryOnly: true)
+)
+```
+
+## Schema versions and migration
+
+```swift
+enum GardenSchemaV1: VersionedSchema {
+    static let versionIdentifier = Schema.Version(1, 0, 0)
+    static var models: [any PersistentModel.Type] { [Plant.self] }
+
+    @Model final class Plant {
+        var name: String
+        init(name: String) { self.name = name }
+    }
+}
+
+enum GardenSchemaV2: VersionedSchema {
+    static let versionIdentifier = Schema.Version(2, 0, 0)
+    static var models: [any PersistentModel.Type] { [Plant.self] }
+
+    @Model final class Plant {
+        @Attribute(originalName: "name") var commonName: String
+        var sunlight: String = "partial"
+        init(commonName: String) { self.commonName = commonName }
+    }
+}
+
+enum GardenSchemaV3: VersionedSchema {
+    static let versionIdentifier = Schema.Version(3, 0, 0)
+    static var models: [any PersistentModel.Type] { [Plant.self] }
+
+    @Model final class Plant {
+        var commonName: String
+        var sunlight: String = "partial"
+        var sunlightHours: Int = 4
+        init(commonName: String) { self.commonName = commonName }
+    }
+}
+
+enum GardenMigrationPlan: SchemaMigrationPlan {
+    static var schemas: [any VersionedSchema.Type] {
+        [GardenSchemaV1.self, GardenSchemaV2.self, GardenSchemaV3.self]
+    }
+    static var stages: [MigrationStage] {
+        [
+            .lightweight(fromVersion: GardenSchemaV1.self, toVersion: GardenSchemaV2.self),
+            .custom(
+                fromVersion: GardenSchemaV2.self, toVersion: GardenSchemaV3.self,
+                willMigrate: nil,
+                didMigrate: { context in
+                    let plants = try context.fetch(FetchDescriptor<GardenSchemaV3.Plant>())
+                    for plant in plants {
+                        plant.sunlightHours = plant.sunlight == "full" ? 8 : 4
+                    }
+                    try context.save()
+                }
+            )
+        ]
+    }
+}
+```

package/pipeline/skills/shared/external/swiftui-uikit-interop/SKILL.md

@@ -52,39 +52,7 @@ are required:
   the view already holds can trigger a delegate callback that writes the binding
   that calls update again.
 
-```swift
-import UIKit
-import SwiftUI
-
-struct PlainTextEditor: UIViewRepresentable {
-    @Binding var draft: String
-
-    func makeCoordinator() -> Coordinator { Coordinator(parent: self) }
-
-    func makeUIView(context: Context) -> UITextView {
-        let editor = UITextView(frame: .zero)
-        editor.delegate = context.coordinator
-        editor.font = .preferredFont(forTextStyle: .body)
-        return editor
-    }
-
-    func updateUIView(_ editor: UITextView, context: Context) {
-        context.coordinator.parent = self
-        guard editor.text != draft else { return }
-        editor.text = draft
-    }
-
-    @MainActor
-    final class Coordinator: NSObject, UITextViewDelegate {
-        init(parent: PlainTextEditor) { self.parent = parent }
-        var parent: PlainTextEditor
-
-        func textViewDidChange(_ editor: UITextView) {
-            parent.draft = editor.text
-        }
-    }
-}
-```
+Code for this section: [Interop code](references/interop-code.md).
 
 ### Lifecycle order
 
@@ -141,28 +109,7 @@ and `makeCoordinator()`. For a modal controller the update method usually
 has nothing to push after presentation; it only refreshes the coordinator's
 `parent`.
 
-```swift
-import VisionKit
-import SwiftUI
-
-struct PageScannerView: UIViewControllerRepresentable {
-    @Environment(\.dismiss) var close
-    @Binding var pages: [UIImage]
-
-    func makeCoordinator() -> Coordinator { Coordinator(parent: self) }
-
-    func makeUIViewController(context: Context) -> VNDocumentCameraViewController {
-        let camera = VNDocumentCameraViewController()
-        camera.delegate = context.coordinator
-        return camera
-    }
-
-    func updateUIViewController(_ camera: VNDocumentCameraViewController,
-                                context: Context) {
-        context.coordinator.parent = self
-    }
-}
-```
+Code for this section: [Interop code](references/interop-code.md).
 
 ### Returning results from a presented controller
 
@@ -170,35 +117,12 @@ Delegate callbacks land in the Coordinator, which passes results on by writing
 a `@Binding` or calling a closure stored on `parent`. Every exit path, success, cancel
 and failure, ends by dismissing.
 
-```swift
-extension PageScannerView {
-    @MainActor
-    final class Coordinator: NSObject, @preconcurrency VNDocumentCameraViewControllerDelegate {
-        init(parent: PageScannerView) { self.parent = parent }
-        var parent: PageScannerView
-
-        func documentCameraViewController(_ camera: VNDocumentCameraViewController,
-                                          didFinishWith result: VNDocumentCameraScan) {
-            parent.pages = (0..<result.pageCount).map { index in result.imageOfPage(at: index) }
-            parent.close()
-        }
-
-        func documentCameraViewControllerDidCancel(_ camera: VNDocumentCameraViewController) {
-            parent.close()
-        }
-
-        func documentCameraViewController(_ camera: VNDocumentCameraViewController,
-                                          didFailWithError failure: Error) {
-            parent.close()
-        }
-    }
-}
-```
-
 The coordinator is a `final class` that subclasses `NSObject`, adopts the
 delegate protocol, stores `parent`, and is built from `makeCoordinator()` by
 passing `self`.
 
+Code for this section: [Interop code](references/interop-code.md).
+
 ## 3. The Coordinator Pattern
 
 ### Why it exists
@@ -214,40 +138,7 @@ Declare the Coordinator as a nested type of the representable, directly or
 through an extension. Give it a `parent` property holding the representable
 struct; that is how it writes to `@Binding` properties and calls closures.
 
-```swift
-struct LegacySearchField: UIViewRepresentable {
-    @Binding var query: String
-    var onSubmit: (String) -> Void
-
-    func makeCoordinator() -> Coordinator { .init(parent: self) }
-
-    func makeUIView(context: Context) -> UISearchBar {
-        let bar = UISearchBar(frame: .zero)
-        bar.delegate = context.coordinator
-        return bar
-    }
-
-    func updateUIView(_ bar: UISearchBar, context: Context) {
-        context.coordinator.parent = self
-        if bar.text != query { bar.text = query }
-    }
-
-    @MainActor
-    final class Coordinator: NSObject, UISearchBarDelegate {
-        init(parent: LegacySearchField) { self.parent = parent }
-        var parent: LegacySearchField
-
-        func searchBar(_ bar: UISearchBar, textDidChange newText: String) {
-            parent.query = newText
-        }
-
-        func searchBarSearchButtonClicked(_ bar: UISearchBar) {
-            parent.onSubmit(parent.query)
-            bar.resignFirstResponder()
-        }
-    }
-}
-```
+Code for this section: [Interop code](references/interop-code.md).
 
 ### Rules
 
@@ -267,34 +158,15 @@ struct LegacySearchField: UIViewRepresentable {
 ### Basic embedding
 
 `UIHostingController(rootView:)` puts a SwiftUI view inside a UIKit
-controller. Containment has three steps and the order is fixed:
-
-```swift
-final class ProfileScreenController: UIViewController {
-    let summaryHost = UIHostingController(rootView: ProfileSummary(profile: .empty))
-
-    override func viewDidLoad() {
-        super.viewDidLoad()
-        addChild(summaryHost)                                   // 1
-
-        let hosted: UIView = summaryHost.view
-        hosted.translatesAutoresizingMaskIntoConstraints = false // 2
-        view.addSubview(hosted)
-        NSLayoutConstraint.activate([
-            hosted.topAnchor.constraint(equalTo: view.topAnchor),
-            hosted.bottomAnchor.constraint(equalTo: view.bottomAnchor),
-            hosted.leadingAnchor.constraint(equalTo: view.leadingAnchor),
-            hosted.trailingAnchor.constraint(equalTo: view.trailingAnchor)
-        ])
-
-        summaryHost.didMove(toParent: self)                     // 3
-    }
-}
-```
+controller. Containment has three steps and the order is fixed: `addChild(_:)`, add the
+hosting view to the hierarchy with its constraints, then
+`didMove(toParent:)`.
 
 Leave out any step and containment callbacks, appearance transitions and trait
 propagation stop working correctly.
 
+Code for this section: [Interop code](references/interop-code.md).
+
 ### Sizing options (iOS 16+)
 
 `sizingOptions` is an option set on the hosting controller:
@@ -353,7 +225,7 @@ depend on this.
 
 **Two-way with `@Binding`.** The coordinator writes `parent.value` from a
 delegate method; `updateUIView` reads the binding and applies it to the view.
-The `PlainTextEditor` above does both halves (`textViewDidChange(_:)` writes,
+The `PlainTextEditor` wrapper in the interop code reference does both halves (`textViewDidChange(_:)` writes,
 the update method applies).
 
 **One-way with closures.** For events that flow only from UIKit to SwiftUI
@@ -431,6 +303,7 @@ is what ends that cycle.
 
 ## References
 
+- [Interop code](references/interop-code.md): open for the code behind a representable wrapper, a coordinator, a presented controller that returns a result, or embedding SwiftUI in UIKit.
 - [wrapper recipes](references/representable-recipes.md): complete wrapper recipes
 - [migration guide](references/hosting-migration.md): incremental UIKit to SwiftUI migration
 - Apple: [UIViewRepresentable](https://developer.apple.com/documentation/swiftui/uiviewrepresentable),

package/pipeline/skills/shared/external/swiftui-uikit-interop/references/interop-code.md

@@ -0,0 +1,198 @@
+# Interop code
+
+<!-- toc -->
+- [1. UIViewRepresentable](#1-uiviewrepresentable)
+- [2. UIViewControllerRepresentable](#2-uiviewcontrollerrepresentable)
+- [Returning results from a presented controller](#returning-results-from-a-presented-controller)
+- [Shape](#shape)
+- [Basic embedding](#basic-embedding)
+<!-- /toc -->
+
+Code for the representable protocols, returning results from a presented controller, the coordinator shape and basic hosting. SKILL.md keeps lifecycle, rules and review guidance.
+
+## 1. UIViewRepresentable
+
+`UIViewRepresentable` lets SwiftUI display any `UIView` subclass. Two methods
+are required:
+
+- `makeUIView(context:)` builds and returns the UIKit view. SwiftUI calls it a
+  single time, when the representable is inserted. Put one-time setup here:
+  delegate assignment, fonts, static configuration.
+- `updateUIView(_:context:)` pushes SwiftUI state into the view. It runs again
+  for every relevant state change, so compare before you assign. Writing a value
+  the view already holds can trigger a delegate callback that writes the binding
+  that calls update again.
+
+```swift
+import UIKit
+import SwiftUI
+
+struct PlainTextEditor: UIViewRepresentable {
+    @Binding var draft: String
+
+    func makeCoordinator() -> Coordinator { Coordinator(parent: self) }
+
+    func makeUIView(context: Context) -> UITextView {
+        let editor = UITextView(frame: .zero)
+        editor.delegate = context.coordinator
+        editor.font = .preferredFont(forTextStyle: .body)
+        return editor
+    }
+
+    func updateUIView(_ editor: UITextView, context: Context) {
+        context.coordinator.parent = self
+        guard editor.text != draft else { return }
+        editor.text = draft
+    }
+
+    @MainActor
+    final class Coordinator: NSObject, UITextViewDelegate {
+        init(parent: PlainTextEditor) { self.parent = parent }
+        var parent: PlainTextEditor
+
+        func textViewDidChange(_ editor: UITextView) {
+            parent.draft = editor.text
+        }
+    }
+}
+```
+
+## 2. UIViewControllerRepresentable
+
+Wrap a `UIViewController` subclass with `UIViewControllerRepresentable`. It is
+the right choice for pickers the system provides, a scanner for documents, the
+mail composer, and other controllers that are normally presented modally.
+The methods mirror the view version: `makeUIViewController(context:)`, `updateUIViewController(_:context:)`
+and `makeCoordinator()`. For a modal controller the update method usually
+has nothing to push after presentation; it only refreshes the coordinator's
+`parent`.
+
+```swift
+import VisionKit
+import SwiftUI
+
+struct PageScannerView: UIViewControllerRepresentable {
+    @Environment(\.dismiss) var close
+    @Binding var pages: [UIImage]
+
+    func makeCoordinator() -> Coordinator { Coordinator(parent: self) }
+
+    func makeUIViewController(context: Context) -> VNDocumentCameraViewController {
+        let camera = VNDocumentCameraViewController()
+        camera.delegate = context.coordinator
+        return camera
+    }
+
+    func updateUIViewController(_ camera: VNDocumentCameraViewController,
+                                context: Context) {
+        context.coordinator.parent = self
+    }
+}
+```
+
+### Returning results from a presented controller
+
+Delegate callbacks land in the Coordinator, which passes results on by writing
+a `@Binding` or calling a closure stored on `parent`. Every exit path, success, cancel
+and failure, ends by dismissing.
+
+```swift
+extension PageScannerView {
+    @MainActor
+    final class Coordinator: NSObject, @preconcurrency VNDocumentCameraViewControllerDelegate {
+        init(parent: PageScannerView) { self.parent = parent }
+        var parent: PageScannerView
+
+        func documentCameraViewController(_ camera: VNDocumentCameraViewController,
+                                          didFinishWith result: VNDocumentCameraScan) {
+            parent.pages = (0..<result.pageCount).map { index in result.imageOfPage(at: index) }
+            parent.close()
+        }
+
+        func documentCameraViewControllerDidCancel(_ camera: VNDocumentCameraViewController) {
+            parent.close()
+        }
+
+        func documentCameraViewController(_ camera: VNDocumentCameraViewController,
+                                          didFailWithError failure: Error) {
+            parent.close()
+        }
+    }
+}
+```
+
+The coordinator is a `final class` that subclasses `NSObject`, adopts the
+delegate protocol, stores `parent`, and is built from `makeCoordinator()` by
+passing `self`.
+
+### Shape
+
+Declare the Coordinator as a nested type of the representable, directly or
+through an extension. Give it a `parent` property holding the representable
+struct; that is how it writes to `@Binding` properties and calls closures.
+
+```swift
+struct LegacySearchField: UIViewRepresentable {
+    @Binding var query: String
+    var onSubmit: (String) -> Void
+
+    func makeCoordinator() -> Coordinator { .init(parent: self) }
+
+    func makeUIView(context: Context) -> UISearchBar {
+        let bar = UISearchBar(frame: .zero)
+        bar.delegate = context.coordinator
+        return bar
+    }
+
+    func updateUIView(_ bar: UISearchBar, context: Context) {
+        context.coordinator.parent = self
+        if bar.text != query { bar.text = query }
+    }
+
+    @MainActor
+    final class Coordinator: NSObject, UISearchBarDelegate {
+        init(parent: LegacySearchField) { self.parent = parent }
+        var parent: LegacySearchField
+
+        func searchBar(_ bar: UISearchBar, textDidChange newText: String) {
+            parent.query = newText
+        }
+
+        func searchBarSearchButtonClicked(_ bar: UISearchBar) {
+            parent.onSubmit(parent.query)
+            bar.resignFirstResponder()
+        }
+    }
+}
+```
+
+### Basic embedding
+
+`UIHostingController(rootView:)` puts a SwiftUI view inside a UIKit
+controller. Containment has three steps and the order is fixed:
+
+```swift
+final class ProfileScreenController: UIViewController {
+    let summaryHost = UIHostingController(rootView: ProfileSummary(profile: .empty))
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        addChild(summaryHost)                                   // 1
+
+        let hosted: UIView = summaryHost.view
+        hosted.translatesAutoresizingMaskIntoConstraints = false // 2
+        view.addSubview(hosted)
+        NSLayoutConstraint.activate([
+            hosted.topAnchor.constraint(equalTo: view.topAnchor),
+            hosted.bottomAnchor.constraint(equalTo: view.bottomAnchor),
+            hosted.leadingAnchor.constraint(equalTo: view.leadingAnchor),
+            hosted.trailingAnchor.constraint(equalTo: view.trailingAnchor)
+        ])
+
+        summaryHost.didMove(toParent: self)                     // 3
+    }
+}
+```
+
+Leave out any step and containment callbacks, appearance transitions and trait
+propagation stop working correctly.

package/pipeline/skills/shared/external/tailwind-css/SKILL.md

@@ -123,91 +123,15 @@ Content detection is automatic with no `content` array needed.
 
 ### Form
 
-```html
-<form class="space-y-6 max-w-md mx-auto">
-  <div>
-    <label for="email" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
-      Email
-    </label>
-    <input
-      type="email"
-      id="email"
-      class="
-        mt-1 block w-full rounded-lg border border-gray-300
-        px-4 py-2.5 text-gray-900
-        shadow-sm
-        placeholder:text-gray-400
-        focus:border-brand focus:ring-2 focus:ring-brand/20 focus:outline-none
-        dark:border-gray-600 dark:bg-gray-800 dark:text-gray-100
-        dark:focus:border-brand-light
-      "
-      placeholder="you@example.com"
-    />
-  </div>
+Every input has a `<label for>`, focus styles use `focus:ring` plus `focus:outline-none`, each state has a `dark:` variant, helper text sits under the field, and the submit button carries `disabled:` styles.
 
-  <div>
-    <label for="password" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
-      Password
-    </label>
-    <input
-      type="password"
-      id="password"
-      class="
-        mt-1 block w-full rounded-lg border border-gray-300
-        px-4 py-2.5 text-gray-900
-        shadow-sm
-        focus:border-brand focus:ring-2 focus:ring-brand/20 focus:outline-none
-        dark:border-gray-600 dark:bg-gray-800 dark:text-gray-100
-      "
-    />
-    <p class="mt-1 text-xs text-gray-500">Must be at least 8 characters.</p>
-  </div>
-
-  <button
-    type="submit"
-    class="
-      w-full rounded-lg bg-brand px-4 py-2.5
-      text-sm font-semibold text-white
-      shadow-sm
-      hover:bg-brand-dark focus:ring-2 focus:ring-brand/50 focus:outline-none
-      disabled:opacity-50 disabled:cursor-not-allowed
-      transition-colors
-    "
-  >
-    Sign in
-  </button>
-</form>
-```
+Code: [Form](references/code-examples.md#form).
 
 ### Navigation
 
-```html
-<nav class="bg-white dark:bg-gray-900 border-b border-gray-200 dark:border-gray-700">
-  <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
-    <div class="flex h-16 items-center justify-between">
-      <div class="flex items-center gap-8">
-        <a href="/" class="text-xl font-bold text-brand">Logo</a>
-        <div class="hidden md:flex gap-6">
-          <a href="#" class="text-sm font-medium text-gray-900 dark:text-gray-100 hover:text-brand">
-            Home
-          </a>
-          <a href="#" class="text-sm font-medium text-gray-500 dark:text-gray-400 hover:text-brand">
-            Products
-          </a>
-          <a href="#" class="text-sm font-medium text-gray-500 dark:text-gray-400 hover:text-brand">
-            About
-          </a>
-        </div>
-      </div>
-      <button class="md:hidden p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800">
-        <svg class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
-          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16" />
-        </svg>
-      </button>
-    </div>
-  </div>
-</nav>
-```
+A bordered `<nav>` with a centered `max-w-7xl` container, inline links shown from `md:` up, and a menu button visible only below `md:`.
+
+Code: [Navigation](references/code-examples.md#navigation).
 
 ## The cn() Utility
 
@@ -310,3 +234,7 @@ function Button({ variant = 'primary', size = 'md', className, children }: Butto
 | Custom color not found | Missing `@theme` definition | Define custom values in `@theme` block |
 | Container queries not working | Missing `@container` parent | Wrap parent element with `@container` class |
 | Arbitrary value not compiled | Syntax error in brackets | Check for spaces: `w-[calc(100%-2rem)]` |
+
+## References
+
+- [Code examples](references/code-examples.md): open for the full code behind Form, Navigation.