@mmerterden/multi-agent-pipeline 20.33.0 → 20.35.0

package/pipeline/skills/shared/external/live-activities/references/activitykit-patterns.md

@@ -1,5 +1,26 @@
 # ActivityKit Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [A complete attributes model](#a-complete-attributes-model)
+- [Starting, with every parameter](#starting-with-every-parameter)
+- [Updating from the app](#updating-from-the-app)
+- [Server payloads](#server-payloads)
+- [Channel pushes (iOS 18+)](#channel-pushes-ios-18)
+- [Ending by outcome](#ending-by-outcome)
+- [Dynamic Island, all regions](#dynamic-island-all-regions)
+- [Lock Screen view with timer and progress](#lock-screen-view-with-timer-and-progress)
+- [Several activities at once](#several-activities-at-once)
+- [Observing state and content](#observing-state-and-content)
+- [Tokens](#tokens)
+- [Authorization](#authorization)
+- [Errors](#errors)
+- [Background behaviour](#background-behaviour)
+- [Testing](#testing)
+- [Info.plist keys](#infoplist-keys)
+- [Apple documentation](#apple-documentation)
+<!-- /toc -->
+
 Worked patterns for Live Activities. Everything here uses async/await and
 `ActivityContent`, so it needs iOS 16.2 or later unless a heading names a
 newer release.

package/pipeline/skills/shared/external/localization-reuse-map/reference/format-and-output.md

@@ -1,5 +1,14 @@
 # Mapping format and outputs
 
+<!-- toc -->
+- [Mapping schema](#mapping-schema)
+- [Rendered artifacts](#rendered-artifacts)
+- [Overlay and keyshots](#overlay-and-keyshots)
+- [CMS import spreadsheet](#cms-import-spreadsheet)
+- [Fidelity gate](#fidelity-gate)
+- [Script reference](#script-reference)
+<!-- /toc -->
+
 The mapping JSON is the single source every renderer reads. The scripts add nothing of their own: what is not in the mapping does not appear in the table, the spreadsheet or the page.
 
 ## Mapping schema

package/pipeline/skills/shared/external/localization-reuse-map/reference/sources-and-recipes.md

@@ -1,5 +1,17 @@
 # Sources and recipes
 
+<!-- toc -->
+- [Where each input lives](#where-each-input-lives)
+- [New keys: the three-way union](#new-keys-the-three-way-union)
+- [New values](#new-values)
+- [CMS copy (Figma annotations)](#cms-copy-figma-annotations)
+- [Legacy keys: trace, do not skim](#legacy-keys-trace-do-not-skim)
+- [Legacy values](#legacy-values)
+- [Overlay geometry](#overlay-geometry)
+- [Keyshots](#keyshots)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Where every column of the map comes from, how to trace it, and the traps that produce a confidently wrong row. The whole point of the skill is a cross-reference: each column is checked against at least one other source, never skimmed from one.
 
 ## Where each input lives

package/pipeline/skills/shared/external/mapkit-location/references/mapkit-corelocation-patterns.md

@@ -1,5 +1,21 @@
 # CoreLocation Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [CLLocationUpdate.liveUpdates()](#cllocationupdateliveupdates)
+- [Service Sessions (iOS 18+)](#service-sessions-ios-18)
+- [Geofences with CLMonitor (iOS 17+)](#geofences-with-clmonitor-ios-17)
+- [CLBackgroundActivitySession](#clbackgroundactivitysession)
+- [Coarse Updates from Significant Changes](#coarse-updates-from-significant-changes)
+- [Visits](#visits)
+- [Moving Off CLCircularRegion](#moving-off-clcircularregion)
+- [Choosing Accuracy](#choosing-accuracy)
+- [Simulating Position](#simulating-position)
+- [Info.plist Privacy Keys](#infoplist-privacy-keys)
+- [Pitfalls](#pitfalls)
+- [References](#references)
+<!-- /toc -->
+
 Modern CoreLocation with Swift concurrency, iOS 17 and later unless a heading
 says otherwise. Import `CoreLocation` in each file that uses these types.
 

package/pipeline/skills/shared/external/mapkit-location/references/mapkit-patterns.md

@@ -1,5 +1,26 @@
 # MapKit Patterns for SwiftUI
 
+<!-- toc -->
+- [Contents](#contents)
+- [A Full Map Screen](#a-full-map-screen)
+- [Custom Annotations](#custom-annotations)
+- [Camera Control](#camera-control)
+- [Selection](#selection)
+- [Autocomplete Search](#autocomplete-search)
+- [Route Display](#route-display)
+- [Cycling Directions (iOS 14+)](#cycling-directions-ios-14)
+- [Street-Level Look Around](#street-level-look-around)
+- [Still Images with MKMapSnapshotter](#still-images-with-mkmapsnapshotter)
+- [Dense Annotations and Clustering](#dense-annotations-and-clustering)
+- [MKMapItem Helpers](#mkmapitem-helpers)
+- [Geocoding and Places on iOS 26](#geocoding-and-places-on-ios-26)
+- [Showing the User](#showing-the-user)
+- [Maps Inside Scrolling Content](#maps-inside-scrolling-content)
+- [Coordinate Math](#coordinate-math)
+- [Accessibility](#accessibility)
+- [Apple Documentation](#apple-documentation)
+<!-- /toc -->
+
 Everything here targets iOS 17 and SwiftUI unless a heading names a later
 release. Each file that uses these types imports both `MapKit` and `SwiftUI`.
 

package/pipeline/skills/shared/external/metrickit-diagnostics/references/metrickit-patterns.md

@@ -1,5 +1,15 @@
 # MetricKit patterns
 
+<!-- toc -->
+- [Reading call-stack trees](#reading-call-stack-trees)
+- [Custom signposts end to end](#custom-signposts-end-to-end)
+- [Exporting and uploading](#exporting-and-uploading)
+- [Catching up on missed payloads](#catching-up-on-missed-payloads)
+- [Extended launch rules](#extended-launch-rules)
+- [Xcode Organizer](#xcode-organizer)
+- [Apple documentation](#apple-documentation)
+<!-- /toc -->
+
 Worked examples for the `metrickit-diagnostics` skill ([../SKILL.md](../SKILL.md)).
 
 ## Reading call-stack trees

package/pipeline/skills/shared/external/musickit-audio/references/musickit-patterns.md

@@ -1,5 +1,14 @@
 # MusicKit Patterns
 
+<!-- toc -->
+- [SwiftUI integration](#swiftui-integration)
+- [Genre and chart browsing](#genre-and-chart-browsing)
+- [Library management](#library-management)
+- [Playlist access](#playlist-access)
+- [Now Playing session](#now-playing-session)
+- [Background audio configuration](#background-audio-configuration)
+<!-- /toc -->
+
 Longer examples for the `musickit-audio` skill. Its SKILL.md covers setup,
 authorization, subscription checks and the basic player; this file builds on
 that.

package/pipeline/skills/shared/external/natural-language/references/translation-patterns.md

@@ -1,5 +1,17 @@
 # Translation and text-analysis patterns
 
+<!-- toc -->
+- [Plugging in a Create ML model](#plugging-in-a-create-ml-model)
+- [Contextual embeddings](#contextual-embeddings)
+- [Gazetteers for your own vocabulary](#gazetteers-for-your-own-vocabulary)
+- [One tagger, several schemes](#one-tagger-several-schemes)
+- [Translating text in place](#translating-text-in-place)
+- [Choosing a translation strategy](#choosing-a-translation-strategy)
+- [Getting a session ready](#getting-a-session-ready)
+- [A live analysis panel in SwiftUI](#a-live-analysis-panel-in-swiftui)
+- [Lemmas for search](#lemmas-for-search)
+<!-- /toc -->
+
 Deeper material for the `natural-language` skill ([../SKILL.md](../SKILL.md)).
 
 ## Plugging in a Create ML model

package/pipeline/skills/shared/external/nodejs-backend-patterns/references/runtime-patterns.md

@@ -1,5 +1,16 @@
 # Node.js runtime patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Project shape](#project-shape)
+- [Configuration validated at startup](#configuration-validated-at-startup)
+- [Errors](#errors)
+- [Graceful shutdown](#graceful-shutdown)
+- [Request context](#request-context)
+- [Timeouts and cancellation](#timeouts-and-cancellation)
+- [Streams and backpressure](#streams-and-backpressure)
+<!-- /toc -->
+
 Worked code for the project layout, configuration, errors, shutdown, request context, timeouts and streams summarised in SKILL.md.
 
 ## Contents

package/pipeline/skills/shared/external/passkit-wallet/references/wallet-passes.md

@@ -1,5 +1,16 @@
 # Wallet Passes and Advanced Apple Pay
 
+<!-- toc -->
+- [One advanced type per request](#one-advanced-type-per-request)
+- [Recurring payments](#recurring-payments)
+- [Coupon codes](#coupon-codes)
+- [Several merchants in one checkout](#several-merchants-in-one-checkout)
+- [Deferred payments](#deferred-payments)
+- [Pass bundles](#pass-bundles)
+- [Keeping passes current](#keeping-passes-current)
+- [SwiftUI checkout screen](#swiftui-checkout-screen)
+<!-- /toc -->
+
 Reference for the `passkit-wallet` skill: advanced payment request types,
 pass bundles, pass updates and a complete SwiftUI checkout.
 

package/pipeline/skills/shared/external/pdfkit/references/pdfkit-patterns.md

@@ -1,5 +1,23 @@
 # PDFKit patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Forms](#forms)
+- [Building PDFs in code](#building-pdfs-in-code)
+- [Watermarks](#watermarks)
+- [Merging and splitting](#merging-and-splitting)
+- [Printing](#printing)
+- [Outlines](#outlines)
+- [Custom annotation classes](#custom-annotation-classes)
+- [Custom page classes](#custom-page-classes)
+- [Overlay lifecycle](#overlay-lifecycle)
+- [Rendering a page to an image](#rendering-a-page-to-an-image)
+- [Rotation and cropping](#rotation-and-cropping)
+- [Burning in annotations](#burning-in-annotations)
+- [Permissions](#permissions)
+- [Coordinator-based SwiftUI wrapper](#coordinator-based-swiftui-wrapper)
+<!-- /toc -->
+
 Longer recipes that build on the main skill. Code targets Swift 6.3 and iOS 26;
 functions that touch views are `@MainActor`.
 

package/pipeline/skills/shared/external/pencilkit-drawing/references/pencilkit-patterns.md

@@ -1,5 +1,16 @@
 # PencilKit patterns
 
+<!-- toc -->
+- [Listening to the tool picker](#listening-to-the-tool-picker)
+- [A custom picker item](#a-custom-picker-item)
+- [Delegate lifecycle](#delegate-lifecycle)
+- [Undo and redo](#undo-and-redo)
+- [Thumbnails with a fixed aspect ratio](#thumbnails-with-a-fixed-aspect-ratio)
+- [Scoring a tracing exercise](#scoring-a-tracing-exercise)
+- [Managing content versions](#managing-content-versions)
+- [A configurable SwiftUI wrapper](#a-configurable-swiftui-wrapper)
+<!-- /toc -->
+
 Longer recipes for the `pencilkit-drawing` skill ([../SKILL.md](../SKILL.md)).
 
 ## Listening to the tool picker

package/pipeline/skills/shared/external/permissionkit/references/permissionkit-patterns.md

@@ -1,5 +1,16 @@
 # PermissionKit patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [UIKit view controller](#uikit-view-controller)
+- [Response manager](#response-manager)
+- [Several contacts in one question](#several-contacts-in-one-question)
+- [Limits-check view model](#limits-check-view-model)
+- [SwiftUI full flow](#swiftui-full-flow)
+- [macOS](#macos)
+- [Error recovery](#error-recovery)
+<!-- /toc -->
+
 Longer examples that back the main `permissionkit` skill. They assume the iOS
 26.2 SDK (macOS 26.2 for the AppKit section) unless marked otherwise; the
 26.0 pieces (`CommunicationLimits`, the topic and question types) work

package/pipeline/skills/shared/external/photos-camera-media/references/av-playback.md

@@ -1,5 +1,20 @@
 # Audio and video playback
 
+<!-- toc -->
+- [Contents](#contents)
+- [Players and where they render](#players-and-where-they-render)
+- [Assets and items](#assets-and-items)
+- [Transport controls](#transport-controls)
+- [Watching state and time](#watching-state-and-time)
+- [HLS streaming](#hls-streaming)
+- [The audio session](#the-audio-session)
+- [Background audio](#background-audio)
+- [Now Playing](#now-playing)
+- [Remote commands](#remote-commands)
+- [Picture in Picture](#picture-in-picture)
+- [Documentation](#documentation)
+<!-- /toc -->
+
 ## Contents
 
 - [Players and where they render](#players-and-where-they-render)

package/pipeline/skills/shared/external/photos-camera-media/references/camera-capture.md

@@ -1,5 +1,19 @@
 # Capture session recipes
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. A full photo camera](#1-a-full-photo-camera)
+- [2. Preview view](#2-preview-view)
+- [3. Camera screen](#3-camera-screen)
+- [4. Recording video](#4-recording-video)
+- [5. Flash and torch](#5-flash-and-torch)
+- [6. Tap to focus and expose](#6-tap-to-focus-and-expose)
+- [7. Barcodes and QR codes](#7-barcodes-and-qr-codes)
+- [8. Orientation](#8-orientation)
+- [9. Choosing specific cameras](#9-choosing-specific-cameras)
+- [10. Limiting the scan area](#10-limiting-the-scan-area)
+<!-- /toc -->
+
 Shape used throughout: an `@Observable` model owns the capture session and all
 camera state; the SwiftUI view draws the preview and forwards taps. Session
 work runs on one private serial queue, because `AVCaptureSession` is not

package/pipeline/skills/shared/external/photos-camera-media/references/image-loading-caching.md

@@ -1,5 +1,19 @@
 # Loading, caching and downsampling images
 
+<!-- toc -->
+- [Contents](#contents)
+- [AsyncImage](#asyncimage)
+- [In-memory cache on NSCache](#in-memory-cache-on-nscache)
+- [Disk cache with URLCache](#disk-cache-with-urlcache)
+- [Downsampling at decode time](#downsampling-at-decode-time)
+- [Prefetching](#prefetching)
+- [HEIF and HEIC](#heif-and-heic)
+- [Shrinking before upload](#shrinking-before-upload)
+- [Staying inside a memory budget](#staying-inside-a-memory-budget)
+- [One loader for everything](#one-loader-for-everything)
+- [Which layer for which job](#which-layer-for-which-job)
+<!-- /toc -->
+
 Everything here uses async/await and targets iOS 26 and Swift 6.3.
 The samples need iOS 17 or later because the models use `@Observable`.
 

package/pipeline/skills/shared/external/photos-camera-media/references/photokit-patterns.md

@@ -1,5 +1,19 @@
 # Picker and PhotoKit recipes
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. One photo with an explicit loading state](#1-one-photo-with-an-explicit-loading-state)
+- [2. Many photos with progress](#2-many-photos-with-progress)
+- [3. Video from the picker](#3-video-from-the-picker)
+- [4. Live Photos](#4-live-photos)
+- [5. PHPickerViewController inside SwiftUI](#5-phpickerviewcontroller-inside-swiftui)
+- [6. Saving into the library](#6-saving-into-the-library)
+- [7. Thumbnails with ImageIO](#7-thumbnails-with-imageio)
+- [8. HEIC and HEIF](#8-heic-and-heif)
+- [9. Picker appearance](#9-picker-appearance)
+- [10. Cropping](#10-cropping)
+<!-- /toc -->
+
 Each recipe uses SwiftUI with async/await and needs iOS 17 or later (the views
 use the two-parameter `onChange(of:)`). `PhotosPicker` itself is iOS 16.
 

package/pipeline/skills/shared/external/push-notifications/references/notification-patterns.md

@@ -1,5 +1,19 @@
 # Notification Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [App and AppDelegate Wiring](#app-and-appdelegate-wiring)
+- [The Center Delegate](#the-center-delegate)
+- [Routing a Tap to a Screen](#routing-a-tap-to-a-screen)
+- [Handling a Silent Push](#handling-a-silent-push)
+- [A Local Scheduler](#a-local-scheduler)
+- [Token Lifecycle](#token-lifecycle)
+- [Registering Categories](#registering-categories)
+- [Testing and Debugging Delivery](#testing-and-debugging-delivery)
+- [Badges](#badges)
+- [From Provisional to Full Permission](#from-provisional-to-full-permission)
+<!-- /toc -->
+
 Working code for the app side of notifications: wiring at launch, the center
 delegate, routing a tap to a screen, silent pushes, a small scheduler, the
 token lifecycle, category setup, testing, badges and moving a provisional user

package/pipeline/skills/shared/external/push-notifications/references/rich-notifications.md

@@ -1,5 +1,15 @@
 # Rich Notifications
 
+<!-- toc -->
+- [Contents](#contents)
+- [Service Extension](#service-extension)
+- [Attachments](#attachments)
+- [Content Extension](#content-extension)
+- [Communication Notifications](#communication-notifications)
+- [Troubleshooting Extensions](#troubleshooting-extensions)
+- [A Complete Service Extension](#a-complete-service-extension)
+<!-- /toc -->
+
 Two app extensions shape how a notification looks:
 
 - **Notification Service Extension**: edits the content of a remote

package/pipeline/skills/shared/external/realitykit-ar/references/realitykit-patterns.md

@@ -1,5 +1,17 @@
 # RealityKit Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Physics](#physics)
+- [Animation](#animation)
+- [Materials and lighting](#materials-and-lighting)
+- [Custom components and systems](#custom-components-and-systems)
+- [Occlusion and environment](#occlusion-and-environment)
+- [A SwiftUI model viewer](#a-swiftui-model-viewer)
+- [Entity accessibility](#entity-accessibility)
+- [Performance](#performance)
+<!-- /toc -->
+
 Longer examples for the `realitykit-ar` skill. SKILL.md covers setup, anchoring,
 raycasting and gestures; this file goes deeper.
 

package/pipeline/skills/shared/external/retrofit-networking/references/patterns.md

@@ -1,5 +1,19 @@
 # Retrofit Networking -- Reference Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [API Interface](#api-interface)
+- [Retrofit Setup with Hilt](#retrofit-setup-with-hilt)
+- [OkHttp Interceptors](#okhttp-interceptors)
+- [Error Handling](#error-handling)
+- [Network-Bound Resource](#network-bound-resource)
+- [Multipart Uploads](#multipart-uploads)
+- [WebSocket Support](#websocket-support)
+- [Envelope to Typed Exception](#envelope-to-typed-exception)
+- [Unknown-Tolerant Enum Serialization](#unknown-tolerant-enum-serialization)
+- [Client Composition and Environment Config](#client-composition-and-environment-config)
+<!-- /toc -->
+
 Full code for the patterns summarized in `SKILL.md`. Load the section you need
 when implementing that part of the networking layer.
 

package/pipeline/skills/shared/external/room-database/references/patterns.md

@@ -1,5 +1,21 @@
 # Room Database Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Entity Definition](#entity-definition)
+- [DAO Interface](#dao-interface)
+- [Database Setup](#database-setup)
+- [Reactive Queries with Flow](#reactive-queries-with-flow)
+- [TypeConverters](#typeconverters)
+- [Relations](#relations)
+- [Migration Strategies](#migration-strategies)
+- [Hilt Integration](#hilt-integration)
+- [Testing with In-Memory Database](#testing-with-in-memory-database)
+- [Encrypted Database (SQLCipher)](#encrypted-database-sqlcipher)
+- [Async Database Provisioning](#async-database-provisioning)
+- [Runtime Hygiene](#runtime-hygiene)
+<!-- /toc -->
+
 Full code examples backing the guidance in `SKILL.md`. Headings mirror the
 SKILL.md sections.
 

package/pipeline/skills/shared/external/shareplay-activities/references/shareplay-patterns.md

@@ -1,5 +1,15 @@
 # SharePlay Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [A shared sticky-note board](#a-shared-sticky-note-board)
+- [A reusable manager](#a-reusable-manager)
+- [SwiftUI entry points](#swiftui-entry-points)
+- [Syncing game state, including late joiners](#syncing-game-state-including-late-joiners)
+- [Tracking who joins and leaves](#tracking-who-joins-and-leaves)
+- [Nearby participants on visionOS](#nearby-participants-on-visionos)
+<!-- /toc -->
+
 Longer examples for the `shareplay-activities` skill. SKILL.md covers setup,
 the session lifecycle and the messenger basics; this file builds on them.
 

package/pipeline/skills/shared/external/speech-recognition/references/speechanalyzer-patterns.md

@@ -1,5 +1,15 @@
 # SpeechAnalyzer patterns (iOS 26+)
 
+<!-- toc -->
+- [Picking modules](#picking-modules)
+- [Model assets](#model-assets)
+- [Transcribing a file](#transcribing-a-file)
+- [Live audio](#live-audio)
+- [Reading results](#reading-results)
+- [Ending a session](#ending-a-session)
+- [Further reading](#further-reading)
+<!-- /toc -->
+
 Companion to the `speech-recognition` skill ([../SKILL.md](../SKILL.md)).
 Every API here needs iOS 26 or later.
 

package/pipeline/skills/shared/external/spm-build-analysis/references/build-optimization-sources.md

@@ -1,5 +1,19 @@
 # Build Optimization Sources
 
+<!-- toc -->
+- [Apple: Improving the speed of incremental builds](#apple-improving-the-speed-of-incremental-builds)
+- [Apple: Improving build efficiency with good coding practices](#apple-improving-build-efficiency-with-good-coding-practices)
+- [Apple: Building your project with explicit module dependencies](#apple-building-your-project-with-explicit-module-dependencies)
+- [SwiftLee: Build performance analysis for speeding up Xcode builds](#swiftlee-build-performance-analysis-for-speeding-up-xcode-builds)
+- [Apple: Xcode Release Notes -- Compilation Caching](#apple-xcode-release-notes----compilation-caching)
+- [Apple: Demystify explicitly built modules (WWDC24)](#apple-demystify-explicitly-built-modules-wwdc24)
+- [Swift Compile-Time Best Practices](#swift-compile-time-best-practices)
+- [Bitrise: Demystifying Explicitly Built Modules for Xcode](#bitrise-demystifying-explicitly-built-modules-for-xcode)
+- [Bitrise: Xcode Compilation Cache FAQ](#bitrise-xcode-compilation-cache-faq)
+- [RocketSim Docs: Build Insights](#rocketsim-docs-build-insights)
+- [Swift Forums: Slow incremental builds because of planning swift module](#swift-forums-slow-incremental-builds-because-of-planning-swift-module)
+<!-- /toc -->
+
 This file stores the external sources that the README and skill docs should cite consistently.
 
 ## Apple: Improving the speed of incremental builds

package/pipeline/skills/shared/external/spm-build-analysis/references/spm-analysis-checks.md

@@ -1,5 +1,24 @@
 # SPM Analysis Checks
 
+<!-- toc -->
+- [Package Graph Checks](#package-graph-checks)
+- [Package Plugin Checks](#package-plugin-checks)
+- [Package Reference Verification](#package-reference-verification)
+- [Version Pin Feasibility](#version-pin-feasibility)
+- [Binary And Remote Dependency Checks](#binary-and-remote-dependency-checks)
+- [Module Variant Checks](#module-variant-checks)
+- [Layered Architecture Validation](#layered-architecture-validation)
+- [Circular Dependency Detection](#circular-dependency-detection)
+- [Module Sizing Guidance](#module-sizing-guidance)
+- [Transitive Dependency Minimization](#transitive-dependency-minimization)
+- [Interface/Implementation Separation](#interfaceimplementation-separation)
+- [Test Target Isolation](#test-target-isolation)
+- [Swift Macro Rebuild Impact](#swift-macro-rebuild-impact)
+- [Multi-Platform Build Multiplication](#multi-platform-build-multiplication)
+- [CI-Specific Checks](#ci-specific-checks)
+- [Recommendation Prioritization](#recommendation-prioritization)
+<!-- /toc -->
+
 Use this reference when package dependencies or package plugins are suspected build bottlenecks.
 
 ## Package Graph Checks

package/pipeline/skills/shared/external/storekit/references/core-patterns.md

@@ -1,5 +1,18 @@
 # StoreKit 2 Core Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Buying with PurchaseAction](#buying-with-purchaseaction)
+- [Launch-Time Transaction Listener](#launch-time-transaction-listener)
+- [Computing Entitlements](#computing-entitlements)
+- [Subscription Paywall](#subscription-paywall)
+- [Product Shelves: StoreView and ProductView](#product-shelves-storeview-and-productview)
+- [Is a Plan Active?](#is-a-plan-active)
+- [Verifying the Install with AppTransaction](#verifying-the-install-with-apptransaction)
+- [Store View Callbacks](#store-view-callbacks)
+- [Ten Mistakes, Fixed](#ten-mistakes-fixed)
+<!-- /toc -->
+
 Complete, copyable code for the core flows, followed by the ten common
 mistakes with a wrong and a right version each. Control styles, offers,
 testing, server validation and subscription edge cases are in

package/pipeline/skills/shared/external/storekit/references/storekit-advanced.md

@@ -1,5 +1,36 @@
 # StoreKit 2 Advanced Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Paywall Control Styles](#paywall-control-styles)
+- [Where the Controls Sit](#where-the-controls-sit)
+- [Button Labels](#button-labels)
+- [Container Backgrounds](#container-backgrounds)
+- [Store Buttons](#store-buttons)
+- [Policy Destinations](#policy-destinations)
+- [An Icon per Option](#an-icon-per-option)
+- [Sign-In Action](#sign-in-action)
+- [Grouping Options (iOS 18+)](#grouping-options-ios-18)
+- [Introductory Offers](#introductory-offers)
+- [Promotional Offers](#promotional-offers)
+- [Win-Back Offers (iOS 18+)](#win-back-offers-ios-18)
+- [Offer Codes](#offer-codes)
+- [Which Offer a Transaction Used](#which-offer-a-transaction-used)
+- [Server-Side Validation](#server-side-validation)
+- [Testing in Xcode](#testing-in-xcode)
+- [Renewal States and What to Grant](#renewal-states-and-what-to-grant)
+- [Grace Period and Billing Retry](#grace-period-and-billing-retry)
+- [Refunds](#refunds)
+- [Family Sharing](#family-sharing)
+- [Ask to Buy](#ask-to-buy)
+- [Task Modifiers](#task-modifiers)
+- [Live Subscription Status](#live-subscription-status)
+- [Promoted Purchases on the Product Page](#promoted-purchases-on-the-product-page)
+- [Price Increases](#price-increases)
+- [Unfinished Transactions](#unfinished-transactions)
+- [Advanced Mistakes](#advanced-mistakes)
+<!-- /toc -->
+
 Reach for this file once purchasing, the launch-time listener and entitlement
 checks from [core-patterns.md](core-patterns.md) are in place. Each heading
 names the release an API needs; the skill as a whole targets iOS 26.

package/pipeline/skills/shared/external/swift-api-design-guidelines/references/argument-labels-and-parameters.md

@@ -1,5 +1,13 @@
 # Argument Labels and Parameters
 
+<!-- toc -->
+- [Prepositional labels](#prepositional-labels)
+- [Grammatical phrases](#grammatical-phrases)
+- [Conversions](#conversions)
+- [Parameter names are documentation](#parameter-names-are-documentation)
+- [Default arguments instead of method families](#default-arguments-instead-of-method-families)
+<!-- /toc -->
+
 Harder cases for the label rules in the main skill, plus how to name
 parameters and order defaulted ones.
 

package/pipeline/skills/shared/external/swift-api-design-guidelines/references/conventions-and-special-rules.md

@@ -1,5 +1,14 @@
 # Conventions and Special Rules
 
+<!-- toc -->
+- [Casing](#casing)
+- [Complexity notes](#complexity-notes)
+- [Free functions](#free-functions)
+- [Overloads](#overloads)
+- [Tuples and closures](#tuples-and-closures)
+- [Unconstrained polymorphism](#unconstrained-polymorphism)
+<!-- /toc -->
+
 Casing, complexity notes, when a free function is right, safe overloading,
 labelled tuples and closures, and the traps of unconstrained polymorphism.
 

package/pipeline/skills/shared/external/swift-api-design-guidelines/references/naming-and-clarity.md

@@ -1,5 +1,15 @@
 # Naming and Clarity
 
+<!-- toc -->
+- [Words that must stay](#words-that-must-stay)
+- [Words that can go](#words-that-can-go)
+- [Roles, not types](#roles-not-types)
+- [Generic parameters](#generic-parameters)
+- [Weak types need help](#weak-types-need-help)
+- [Method or property](#method-or-property)
+- [Choosing terms](#choosing-terms)
+<!-- /toc -->
+
 How to decide which words a name needs, which it can lose, and how to choose
 between a method and a property.
 

package/pipeline/skills/shared/external/swift-api-design-guidelines/references/side-effects-and-mutating-pairs.md

@@ -1,5 +1,13 @@
 # Side Effects and Mutating Pairs
 
+<!-- toc -->
+- [Examples by kind](#examples-by-kind)
+- [Choosing between -ed and -ing](#choosing-between--ed-and--ing)
+- [The form prefix](#the-form-prefix)
+- [Booleans](#booleans)
+- [make factories](#make-factories)
+<!-- /toc -->
+
 Naming that tells the caller, at a glance, whether an operation changes the
 receiver.