@mmerterden/multi-agent-pipeline 20.2.1 → 20.3.1

package/pipeline/skills/shared/external/compose-components/SKILL.md

@@ -202,9 +202,9 @@ fun InfoCard(
 
 // Usage
 InfoCard(
-    icon = { Icon(Icons.Default.Flight, contentDescription = null) },
-    title = { Text("IST to JFK") },
-    subtitle = { Text("Flight AB1234") },
+    icon = { Icon(Icons.Default.ShoppingCart, contentDescription = null) },
+    title = { Text("London to New York") },
+    subtitle = { Text("Order AB1234") },
     actions = {
         IconButton(onClick = { /* bookmark */ }) {
             Icon(Icons.Default.BookmarkBorder, contentDescription = "Bookmark")
@@ -331,7 +331,7 @@ val AppTypography = Typography(
 
 // Usage: always reference tokens, never raw values
 Text(
-    text = "Flight Details",
+    text = "Order Details",
     style = MaterialTheme.typography.headlineMedium,
     color = MaterialTheme.colorScheme.onSurface,
 )

package/pipeline/skills/shared/external/compose-navigation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: compose-navigation
-description: "Implement type-safe navigation in Jetpack Compose using Navigation 2.8+ with @Serializable routes, NavHost, composable<Route>, nested navigation graphs, deep links, BackHandler, type-safe argument passing, and bottom navigation with NavigationBar integration. Use when building Compose navigation, adding new screens, handling deep links, or implementing bottom nav patterns."
+description: "Implement type-safe navigation in Jetpack Compose using Navigation 2.8+ with @Serializable routes, NavHost, typed composable routes, nested navigation graphs, deep links, BackHandler, type-safe argument passing, and bottom navigation with NavigationBar integration. Use when building Compose navigation, adding new screens, handling deep links, or implementing bottom nav patterns."
 ---
 
 # Compose Navigation
@@ -102,7 +102,7 @@ fun AppNavHost(
 
 ```kotlin
 // Navigate forward
-navController.navigate(DetailRoute(id = "flight-123"))
+navController.navigate(DetailRoute(id = "order-123"))
 
 // Navigate with options
 navController.navigate(HomeRoute) {
@@ -129,31 +129,31 @@ serializes them automatically.
 
 ```kotlin
 @Serializable
-data class FlightDetailRoute(
-    val flightId: String,
-    val origin: String,
-    val destination: String,
-    val departureTimestamp: Long,
+data class OrderDetailRoute(
+    val orderId: String,
+    val store: String,
+    val region: String,
+    val placedTimestamp: Long,
 )
 
 // Navigate with arguments
 navController.navigate(
-    FlightDetailRoute(
-        flightId = "TK1",
-        origin = "IST",
-        destination = "JFK",
-        departureTimestamp = System.currentTimeMillis(),
+    OrderDetailRoute(
+        orderId = "ORD-101",
+        store = "LDN",
+        region = "NYC",
+        placedTimestamp = System.currentTimeMillis(),
     )
 )
 
 // Retrieve arguments in destination
-composable<FlightDetailRoute> { backStackEntry ->
-    val route = backStackEntry.toRoute<FlightDetailRoute>()
-    FlightDetailScreen(
-        flightId = route.flightId,
-        origin = route.origin,
-        destination = route.destination,
-        departureTime = Instant.fromEpochMilliseconds(route.departureTimestamp),
+composable<OrderDetailRoute> { backStackEntry ->
+    val route = backStackEntry.toRoute<OrderDetailRoute>()
+    OrderDetailScreen(
+        orderId = route.orderId,
+        store = route.store,
+        region = route.region,
+        placedAt = Instant.fromEpochMilliseconds(route.placedTimestamp),
     )
 }
 ```
@@ -178,7 +178,7 @@ Passing a complex `@Serializable` type through a route needs a custom `NavType`
 in a `typeMap` shared by `composable<>()` and every `toRoute` read (else only primitives resolve).
 
 ```kotlin
-val searchTypeMap = mapOf(typeOf<PassengerFilter>() to PassengerFilterNavType)
+val searchTypeMap = mapOf(typeOf<SearchFilter>() to SearchFilterNavType)
 
 composable<SearchRoute>(typeMap = searchTypeMap) { entry ->
     val route = entry.toRoute<SearchRoute>(typeMap = searchTypeMap)
@@ -186,8 +186,8 @@ composable<SearchRoute>(typeMap = searchTypeMap) { entry ->
 }
 ```
 
-A shared holder owns the one `typeMap`; the ViewModel reads the arg back with
-`savedStateHandle.toRoute<SearchRoute>(typeMap = searchTypeMap)`. Full `NavType`
+A shared holder owns the one `typeMap`; wrap `composable<>()` and the ViewModel's `savedStateHandle.toRoute<SearchRoute>(typeMap = ...)` in helpers that always pass it,
+and use them even for primitive-only routes - a bare `toRoute()` crashes the day the route gains a complex field. Full `NavType`
 + holder: [references/patterns.md#custom-navtype-type-map](references/patterns.md#custom-navtype-type-map).
 
 ## SafeNavController via CompositionLocal

package/pipeline/skills/shared/external/compose-navigation/references/patterns.md

@@ -18,22 +18,22 @@ only primitive nav args resolve and the route fails to build.
 
 ```kotlin
 @Serializable
-data class PassengerFilter(val cabin: String, val adults: Int, val children: Int)
+data class SearchFilter(val category: String, val minPrice: Int, val maxPrice: Int)
 
 @Serializable
-data class SearchRoute(val filter: PassengerFilter)
+data class SearchRoute(val filter: SearchFilter)
 
-val PassengerFilterNavType = object : NavType<PassengerFilter>(isNullableAllowed = false) {
-    override fun get(bundle: Bundle, key: String): PassengerFilter? =
+val SearchFilterNavType = object : NavType<SearchFilter>(isNullableAllowed = false) {
+    override fun get(bundle: Bundle, key: String): SearchFilter? =
         bundle.getString(key)?.let { Json.decodeFromString(it) }
 
-    override fun parseValue(value: String): PassengerFilter =
+    override fun parseValue(value: String): SearchFilter =
         Json.decodeFromString(Uri.decode(value))
 
-    override fun serializeAsValue(value: PassengerFilter): String =
+    override fun serializeAsValue(value: SearchFilter): String =
         Uri.encode(Json.encodeToString(value))
 
-    override fun put(bundle: Bundle, key: String, value: PassengerFilter) {
+    override fun put(bundle: Bundle, key: String, value: SearchFilter) {
         bundle.putString(key, Json.encodeToString(value))
     }
 }
@@ -46,7 +46,7 @@ One holder owns the map so the registration and every read agree:
 ```kotlin
 object NavTypeMaps {
     val search: Map<KType, NavType<*>> =
-        mapOf(typeOf<PassengerFilter>() to PassengerFilterNavType)
+        mapOf(typeOf<SearchFilter>() to SearchFilterNavType)
 }
 ```
 
@@ -68,7 +68,7 @@ composable<SearchRoute>(typeMap = NavTypeMaps.search) { entry ->
 class SearchViewModel @Inject constructor(
     savedStateHandle: SavedStateHandle,
 ) : ViewModel() {
-    private val filter: PassengerFilter =
+    private val filter: SearchFilter =
         savedStateHandle.toRoute<SearchRoute>(typeMap = NavTypeMaps.search).filter
 }
 ```
@@ -173,7 +173,7 @@ fun HomeRoute(viewModel: HomeViewModel = hiltViewModel()) {
         viewModel.navEvents.collect { event ->
             when (event) {
                 is HomeNavEvent.ToDetail -> nav.navigate(DetailRoute(event.id))
-                HomeNavEvent.ToSearch -> nav.navigate(SearchRoute(PassengerFilter("ECONOMY", 1, 0)))
+                HomeNavEvent.ToSearch -> nav.navigate(SearchRoute(SearchFilter("BOOKS", 0, 50)))
             }
         }
     }

package/pipeline/skills/shared/external/compose-testing/SKILL.md

@@ -52,9 +52,9 @@ Select nodes by semantics, never by implementation details. Set
 `Modifier.testTag("tag")` on key composables so tests find them reliably.
 
 ```kotlin
-composeTestRule.onNodeWithText("Book Flight")
-composeTestRule.onNodeWithTag("flight_list")
-composeTestRule.onNodeWithContentDescription("Search flights")
+composeTestRule.onNodeWithText("Place Order")
+composeTestRule.onNodeWithTag("order_list")
+composeTestRule.onNodeWithContentDescription("Search orders")
 ```
 
 Combined matchers (`hasText and hasClickAction`), `onAllNodesWith*`, parent/child
@@ -70,10 +70,17 @@ shared identifier source; the codegen side lives in the
 `android-design-tokens-codegen` skill.
 
 ```kotlin
-Modifier.testTag(TestTags.FlightCard)
-composeTestRule.onNodeWithTag(TestTags.FlightCard).assertIsDisplayed()
+Modifier.testTag(TestTags.OrderCard)
+composeTestRule.onNodeWithTag(TestTags.OrderCard).assertIsDisplayed()
 ```
 
+Keep the registry predictable: keys follow one hierarchy (`Components.<Name>.<Element>`
+in the source, generated as constants), a fixed element vocabulary (`Container` on
+every component root, then `Title`, `Subtitle`, `LeadingIcon`, `TrailingIcon`,
+`Action`, `CloseButton`, `Item`), and an indexed format such as `..._item_%s` for
+repeated children. The tool that adds entries rejects a duplicate key or value, so
+two components can never share a tag.
+
 Full generated-registry and usage example: references/patterns.md#test-tags-from-a-generated-registry
 
 ## Performing Actions
@@ -130,7 +137,7 @@ the ViewModel with a fake repository rather than a mocking framework.
 ```kotlin
 viewModel.uiState.test {
     assertThat(awaitItem()).isEqualTo(HomeUiState.Loading)
-    viewModel.loadFlights("IST", "JFK")
+    viewModel.loadOrders("LDN", "NYC")
     assertThat(awaitItem()).isInstanceOf(HomeUiState.Success::class.java)
     cancelAndIgnoreRemainingEvents()
 }

package/pipeline/skills/shared/external/compose-testing/references/patterns.md

@@ -34,12 +34,12 @@ class ButtonComponentTest {
     fun primaryButton_displaysLabel() {
         composeTestRule.setContent {
             AppTheme {
-                PrimaryButton(label = "Book Flight", onClick = {})
+                PrimaryButton(label = "Place Order", onClick = {})
             }
         }
 
         composeTestRule
-            .onNodeWithText("Book Flight")
+            .onNodeWithText("Place Order")
             .assertIsDisplayed()
     }
 }
@@ -77,19 +77,19 @@ class HomeScreenTest {
 
 ```kotlin
 // By text content
-composeTestRule.onNodeWithText("Book Flight")
-composeTestRule.onNodeWithText("book flight", ignoreCase = true)
-composeTestRule.onNodeWithText("Flight", substring = true)
+composeTestRule.onNodeWithText("Place Order")
+composeTestRule.onNodeWithText("place order", ignoreCase = true)
+composeTestRule.onNodeWithText("Order", substring = true)
 
 // By test tag (set via Modifier.testTag("tag"))
-composeTestRule.onNodeWithTag("flight_list")
+composeTestRule.onNodeWithTag("order_list")
 
 // By content description (accessibility)
-composeTestRule.onNodeWithContentDescription("Search flights")
+composeTestRule.onNodeWithContentDescription("Search orders")
 
 // Multiple nodes
 composeTestRule.onAllNodesWithText("Select")
-composeTestRule.onAllNodesWithTag("flight_card")
+composeTestRule.onAllNodesWithTag("order_card")
 
 // Combined matchers
 composeTestRule.onNode(
@@ -98,22 +98,22 @@ composeTestRule.onNode(
 
 // Parent/child traversal
 composeTestRule
-    .onNodeWithTag("flight_card")
+    .onNodeWithTag("order_card")
     .onChildren()
-    .filterToOne(hasText("IST"))
+    .filterToOne(hasText("LDN"))
 ```
 
 ### Setting Test Tags
 
 ```kotlin
 @Composable
-fun FlightCard(flight: Flight, modifier: Modifier = Modifier) {
+fun OrderCard(order: Order, modifier: Modifier = Modifier) {
     Card(
-        modifier = modifier.testTag("flight_card_${flight.id}"),
+        modifier = modifier.testTag("order_card_${order.id}"),
     ) {
         Text(
-            text = flight.origin,
-            modifier = Modifier.testTag("flight_origin"),
+            text = order.store,
+            modifier = Modifier.testTag("order_store"),
         )
     }
 }
@@ -130,19 +130,19 @@ the codegen side lives in the `android-design-tokens-codegen` skill.
 ```kotlin
 // Generated -- do not edit by hand
 object TestTags {
-    const val FlightCard = "flight_card"
-    const val FlightOrigin = "flight_origin"
+    const val OrderCard = "order_card"
+    const val OrderStore = "order_store"
     const val SearchField = "search_field"
 }
 ```
 
 ```kotlin
 // Production
-Card(modifier = Modifier.testTag(TestTags.FlightCard)) { /* ... */ }
+Card(modifier = Modifier.testTag(TestTags.OrderCard)) { /* ... */ }
 
 // Test -- same constant, so a rename is a compile error, not a silent miss
-composeTestRule.onNodeWithTag(TestTags.FlightCard).assertIsDisplayed()
-composeTestRule.onNodeWithTag(TestTags.SearchField).performTextInput("Istanbul")
+composeTestRule.onNodeWithTag(TestTags.OrderCard).assertIsDisplayed()
+composeTestRule.onNodeWithTag(TestTags.SearchField).performTextInput("London")
 ```
 
 ## Performing Actions
@@ -152,7 +152,7 @@ composeTestRule.onNodeWithTag(TestTags.SearchField).performTextInput("Istanbul")
 composeTestRule.onNodeWithText("Book").performClick()
 
 // Text input
-composeTestRule.onNodeWithTag("search_field").performTextInput("Istanbul")
+composeTestRule.onNodeWithTag("search_field").performTextInput("London")
 
 // Clear and replace text
 composeTestRule.onNodeWithTag("search_field").performTextClearance()
@@ -162,10 +162,10 @@ composeTestRule.onNodeWithTag("search_field").performTextReplacement("Ankara")
 composeTestRule.onNodeWithText("Last Item").performScrollTo()
 
 // Scroll to index in LazyColumn
-composeTestRule.onNodeWithTag("flight_list").performScrollToIndex(15)
+composeTestRule.onNodeWithTag("order_list").performScrollToIndex(15)
 
 // Scroll to key in LazyColumn
-composeTestRule.onNodeWithTag("flight_list").performScrollToKey("flight-42")
+composeTestRule.onNodeWithTag("order_list").performScrollToKey("order-42")
 
 // Swipe gestures
 composeTestRule.onNodeWithTag("card").performTouchInput {
@@ -207,7 +207,7 @@ composeTestRule.onNodeWithTag("wifi_toggle").assertIsOn()
 composeTestRule.onNodeWithTag("wifi_toggle").assertIsOff()
 
 // Count assertions
-composeTestRule.onAllNodesWithTag("flight_card").assertCountEquals(5)
+composeTestRule.onAllNodesWithTag("order_card").assertCountEquals(5)
 
 // Focused state
 composeTestRule.onNodeWithTag("search_field").assertIsFocused()
@@ -241,7 +241,7 @@ fun searchField_filtersResults() {
         }
     }
 
-    composeTestRule.onNodeWithTag("search_input").performTextInput("Istanbul")
+    composeTestRule.onNodeWithTag("search_input").performTextInput("London")
 
     // Wait for async results
     composeTestRule.waitUntil(timeoutMillis = 5_000) {
@@ -336,44 +336,44 @@ Turbine provides `test {}` extension on Flow for asserting emissions.
 
 class HomeViewModelTest {
 
-    private val fakeRepository = FakeFlightRepository()
+    private val fakeRepository = FakeOrderRepository()
     private lateinit var viewModel: HomeViewModel
 
     @Before
     fun setup() {
         viewModel = HomeViewModel(
-            getFlightsUseCase = GetFlightsUseCase(fakeRepository),
+            getOrdersUseCase = GetOrdersUseCase(fakeRepository),
         )
     }
 
     @Test
-    fun `loadFlights emits loading then success`() = runTest {
-        fakeRepository.setFlights(listOf(testFlight))
+    fun `loadOrders emits loading then success`() = runTest {
+        fakeRepository.setOrders(listOf(testOrder))
 
         viewModel.uiState.test {
             // Initial state
             assertThat(awaitItem()).isEqualTo(HomeUiState.Loading)
 
             // Trigger load
-            viewModel.loadFlights("IST", "JFK")
+            viewModel.loadOrders("LDN", "NYC")
 
             // Success state
             val success = awaitItem()
             assertThat(success).isInstanceOf(HomeUiState.Success::class.java)
-            assertThat((success as HomeUiState.Success).flights).hasSize(1)
+            assertThat((success as HomeUiState.Success).orders).hasSize(1)
 
             cancelAndIgnoreRemainingEvents()
         }
     }
 
     @Test
-    fun `loadFlights emits error on failure`() = runTest {
+    fun `loadOrders emits error on failure`() = runTest {
         fakeRepository.setShouldFail(true)
 
         viewModel.uiState.test {
             skipItems(1) // skip Loading
 
-            viewModel.loadFlights("IST", "JFK")
+            viewModel.loadOrders("LDN", "NYC")
 
             val error = awaitItem()
             assertThat(error).isInstanceOf(HomeUiState.Error::class.java)
@@ -387,23 +387,23 @@ class HomeViewModelTest {
 ### Fake Repository
 
 ```kotlin
-class FakeFlightRepository : FlightRepository {
-    private val flights = MutableStateFlow<List<Flight>>(emptyList())
+class FakeOrderRepository : OrderRepository {
+    private val orders = MutableStateFlow<List<Order>>(emptyList())
     private var shouldFail = false
 
-    fun setFlights(list: List<Flight>) { flights.value = list }
+    fun setOrders(list: List<Order>) { orders.value = list }
     fun setShouldFail(fail: Boolean) { shouldFail = fail }
 
-    override fun getFlights(origin: String, destination: String): Flow<List<Flight>> =
+    override fun getOrders(store: String, region: String): Flow<List<Order>> =
         if (shouldFail) flow { throw IOException("Network error") }
-        else flights
+        else orders
 
-    override fun searchFlights(query: String, date: LocalDate): Flow<List<Flight>> =
-        flights.map { it.filter { f -> f.origin.code == query } }
+    override fun searchOrders(query: String, date: LocalDate): Flow<List<Order>> =
+        orders.map { it.filter { f -> f.store.code == query } }
 
-    override suspend fun bookFlight(flightId: String): Result<Booking> =
-        if (shouldFail) Result.failure(IOException("Booking failed"))
-        else Result.success(Booking(id = "B1", confirmationCode = "CONF", status = BookingStatus.CONFIRMED))
+    override suspend fun payOrder(orderId: String): Result<Payment> =
+        if (shouldFail) Result.failure(IOException("Payment failed"))
+        else Result.success(Payment(id = "P1", confirmationCode = "CONF", status = PaymentStatus.CONFIRMED))
 }
 ```
 
@@ -413,7 +413,7 @@ Use `runTest` with `StandardTestDispatcher` or `UnconfinedTestDispatcher` to
 control coroutine execution in tests.
 
 ```kotlin
-class FlightRepositoryTest {
+class OrderRepositoryTest {
 
     private val testDispatcher = StandardTestDispatcher()
 
@@ -429,13 +429,13 @@ class FlightRepositoryTest {
 
     @Test
     fun `repository returns cached data`() = runTest {
-        val repo = FlightRepositoryImpl(
+        val repo = OrderRepositoryImpl(
             remoteDataSource = fakeRemote,
             localDataSource = fakeLocal,
-            flightMapper = FlightMapper(),
+            orderMapper = OrderMapper(),
         )
 
-        val result = repo.getFlights("IST", "JFK").first()
+        val result = repo.getOrders("LDN", "NYC").first()
         assertThat(result).hasSize(2)
     }
 }
@@ -485,7 +485,7 @@ class TestDispatcherProvider(
 @RunWith(RobolectricTestRunner::class)
 @GraphicsMode(GraphicsMode.Mode.NATIVE)
 @Config(sdk = [34])
-class FlightCardScreenshotTest {
+class OrderCardScreenshotTest {
 
     @get:Rule
     val composeTestRule = createComposeRule()
@@ -498,28 +498,28 @@ class FlightCardScreenshotTest {
     )
 
     @Test
-    fun flightCard_default() {
+    fun orderCard_default() {
         composeTestRule.setContent {
             AppTheme {
-                FlightCard(flight = previewFlight)
+                OrderCard(order = previewOrder)
             }
         }
 
         composeTestRule
-            .onNodeWithTag("flight_card")
+            .onNodeWithTag("order_card")
             .captureRoboImage()
     }
 
     @Test
-    fun flightCard_dark() {
+    fun orderCard_dark() {
         composeTestRule.setContent {
             AppTheme(darkTheme = true) {
-                FlightCard(flight = previewFlight)
+                OrderCard(order = previewOrder)
             }
         }
 
         composeTestRule
-            .onNodeWithTag("flight_card")
+            .onNodeWithTag("order_card")
             .captureRoboImage()
     }
 }
@@ -531,7 +531,7 @@ class FlightCardScreenshotTest {
 // build.gradle.kts
 // testImplementation(libs.paparazzi)
 
-class FlightCardPaparazziTest {
+class OrderCardPaparazziTest {
 
     @get:Rule
     val paparazzi = Paparazzi(
@@ -540,10 +540,10 @@ class FlightCardPaparazziTest {
     )
 
     @Test
-    fun flightCard_snapshot() {
+    fun orderCard_snapshot() {
         paparazzi.snapshot {
             AppTheme {
-                FlightCard(flight = previewFlight)
+                OrderCard(order = previewOrder)
             }
         }
     }
@@ -599,20 +599,20 @@ Mark previews under the `screenshotTest` source set with `@PreviewTest`:
 
 ```kotlin
 // src/screenshotTest/kotlin/...
-class FlightCardScreenshots {
+class OrderCardScreenshots {
 
     @PreviewTest
     @Preview(showBackground = true)
     @Composable
     fun cardLight() {
-        AppTheme { FlightCard(flight = previewFlight) }
+        AppTheme { OrderCard(order = previewOrder) }
     }
 
     @PreviewTest
     @Preview(showBackground = true, uiMode = Configuration.UI_MODE_NIGHT_YES)
     @Composable
     fun cardDark() {
-        AppTheme(darkTheme = true) { FlightCard(flight = previewFlight) }
+        AppTheme(darkTheme = true) { OrderCard(order = previewOrder) }
     }
 }
 ```

package/pipeline/skills/shared/external/contacts-framework/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: contacts-framework
 description: "Read, create, update, and pick contacts using the Contacts and ContactsUI frameworks. Use when fetching contact data, saving new contacts, wrapping CNContactPickerViewController in SwiftUI, handling contact permissions, or working with CNContactStore fetch and save requests."
+metadata:
+  source: "dpearson2699/swift-ios-skills (PolyForm Perimeter 1.0.0)"
 ---
 
 # Contacts Framework