@mmerterden/multi-agent-pipeline 20.34.0 → 20.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (335) hide show
  1. package/CHANGELOG.md +69 -1
  2. package/README.md +7 -5
  3. package/README.tr.md +6 -5
  4. package/docs/architecture.md +3 -3
  5. package/docs/ecosystem.md +5 -5
  6. package/docs/facts.json +4 -4
  7. package/install/catalog-history.json +1 -1
  8. package/install/claude.mjs +16 -1
  9. package/install/templates/claude-hooks.json +23 -1
  10. package/manifest.json +338 -305
  11. package/package.json +5 -1
  12. package/pipeline/agents/bulk-reader.md +3 -0
  13. package/pipeline/commands/multi-agent/channels/SKILL.md +1 -1
  14. package/pipeline/commands/multi-agent/office-on/SKILL.md +7 -3
  15. package/pipeline/commands/multi-agent/office-pair/SKILL.md +66 -0
  16. package/pipeline/commands/multi-agent/office-status/SKILL.md +3 -2
  17. package/pipeline/commands/multi-agent/sync/SKILL.md +3 -3
  18. package/pipeline/contract/CHANGELOG.md +9 -0
  19. package/pipeline/contract/README.md +1 -0
  20. package/pipeline/contract/fixtures/error-invalid-request.json +1 -1
  21. package/pipeline/contract/fixtures/error-unauthorized.json +1 -1
  22. package/pipeline/contract/fixtures/error-unsigned.json +1 -1
  23. package/pipeline/contract/manifest.json +14 -1
  24. package/pipeline/contract/types/index.d.ts +24 -2
  25. package/pipeline/lib/json-file-lock.mjs +61 -15
  26. package/pipeline/lib/office-remote.mjs +228 -0
  27. package/pipeline/lib/qr-code.mjs +386 -0
  28. package/pipeline/lib/repo-hygiene.sh +1 -0
  29. package/pipeline/lib/run-completion.mjs +17 -0
  30. package/pipeline/multi-agent-refs/channels/issue-comment.md +1 -1
  31. package/pipeline/multi-agent-refs/cross-cli-contract.md +4 -4
  32. package/pipeline/multi-agent-refs/features/office-remote-protocol.md +166 -0
  33. package/pipeline/multi-agent-refs/features/office-threat-model.md +1 -1
  34. package/pipeline/multi-agent-refs/features/scope-check.md +16 -1
  35. package/pipeline/multi-agent-refs/features/verify-by-test.md +10 -0
  36. package/pipeline/multi-agent-refs/help/en.md +1 -0
  37. package/pipeline/multi-agent-refs/help/tr.md +1 -0
  38. package/pipeline/multi-agent-refs/keychain.md +7 -0
  39. package/pipeline/multi-agent-refs/phases/phase-0-init.md +6 -2
  40. package/pipeline/multi-agent-refs/phases/phase-1-plan.md +4 -6
  41. package/pipeline/multi-agent-refs/phases/phase-2-dev.md +9 -12
  42. package/pipeline/multi-agent-refs/phases/phase-3-review.md +9 -8
  43. package/pipeline/multi-agent-refs/phases/phase-4-commit.md +1 -4
  44. package/pipeline/multi-agent-refs/rules.md +3 -2
  45. package/pipeline/multi-agent-refs/tracker-contract.md +1 -1
  46. package/pipeline/office/NOTICE.md +4 -1
  47. package/pipeline/office/assets/char_12.png +0 -0
  48. package/pipeline/office/assets/char_13.png +0 -0
  49. package/pipeline/office/assets/char_14.png +0 -0
  50. package/pipeline/office/assets/char_15.png +0 -0
  51. package/pipeline/office/assets/char_16.png +0 -0
  52. package/pipeline/office/assets/char_17.png +0 -0
  53. package/pipeline/office/assets/char_18.png +0 -0
  54. package/pipeline/office/assets/char_19.png +0 -0
  55. package/pipeline/office/assets/char_20.png +0 -0
  56. package/pipeline/office/assets/char_21.png +0 -0
  57. package/pipeline/office/assets/char_22.png +0 -0
  58. package/pipeline/office/assets/char_23.png +0 -0
  59. package/pipeline/office/assets/char_24.png +0 -0
  60. package/pipeline/office/assets/char_25.png +0 -0
  61. package/pipeline/office/assets/char_26.png +0 -0
  62. package/pipeline/office/assets/char_27.png +0 -0
  63. package/pipeline/office/assets/char_28.png +0 -0
  64. package/pipeline/office/assets/char_29.png +0 -0
  65. package/pipeline/office/assets/char_30.png +0 -0
  66. package/pipeline/office/index.html +293 -49
  67. package/pipeline/schemas/agent-state.schema.json +18 -0
  68. package/pipeline/schemas/planning-output.schema.json +18 -0
  69. package/pipeline/schemas/pr-reach.schema.json +55 -0
  70. package/pipeline/schemas/prefs.schema.json +13 -7
  71. package/pipeline/schemas/triage-output.schema.json +12 -1
  72. package/pipeline/schemas/unattended-policy.json +2 -1
  73. package/pipeline/scripts/_guard_rules.py +449 -1
  74. package/pipeline/scripts/_test-gaming.mjs +36 -0
  75. package/pipeline/scripts/agent-guard.py +79 -19
  76. package/pipeline/scripts/anonymize-findings.mjs +99 -0
  77. package/pipeline/scripts/answer-check.mjs +113 -0
  78. package/pipeline/scripts/answer-check.sh +20 -0
  79. package/pipeline/scripts/autopilot-publish.mjs +9 -2
  80. package/pipeline/scripts/contract-server.mjs +35 -1
  81. package/pipeline/scripts/gate-ledger.mjs +144 -21
  82. package/pipeline/scripts/office-build.mjs +276 -5
  83. package/pipeline/scripts/office-control.mjs +70 -10
  84. package/pipeline/scripts/office-pair.mjs +438 -0
  85. package/pipeline/scripts/office-remote-client.mjs +463 -0
  86. package/pipeline/scripts/phase-tracker.sh +8 -0
  87. package/pipeline/scripts/phase0-exit-gate.mjs +40 -37
  88. package/pipeline/scripts/phone-devices.mjs +9 -1
  89. package/pipeline/scripts/pre-commit-check.sh +28 -2
  90. package/pipeline/scripts/pre-push-check.sh +6 -12
  91. package/pipeline/scripts/rework-base.mjs +87 -0
  92. package/pipeline/scripts/run-commit-check.mjs +104 -0
  93. package/pipeline/scripts/run-scope-guard.mjs +58 -3
  94. package/pipeline/scripts/run-scope-guard.sh +13 -1
  95. package/pipeline/scripts/scope-check-gate.mjs +70 -6
  96. package/pipeline/scripts/task-mirror.mjs +106 -15
  97. package/pipeline/scripts/task-mirror.sh +3 -2
  98. package/pipeline/scripts/test-stability-gate.mjs +112 -0
  99. package/pipeline/scripts/update-check.sh +7 -1
  100. package/pipeline/scripts/update-issue-progress.sh +73 -8
  101. package/pipeline/scripts/validate-planning.mjs +105 -1
  102. package/pipeline/scripts/validate-triage.mjs +42 -2
  103. package/pipeline/scripts/work-items.mjs +119 -1
  104. package/pipeline/scripts/worktree-prepare-all.mjs +200 -0
  105. package/pipeline/scripts/worktree-prepare.sh +40 -4
  106. package/pipeline/scripts/write-state.mjs +67 -24
  107. package/pipeline/skills/.skill-manifest.json +12 -8
  108. package/pipeline/skills/.skills-index.json +15 -4
  109. package/pipeline/skills/shared/README.md +4 -3
  110. package/pipeline/skills/shared/core/apple-archive-compliance/SKILL.md +1 -1
  111. package/pipeline/skills/shared/core/google-play-compliance/SKILL.md +6 -6
  112. package/pipeline/skills/shared/core/google-play-compliance/references/rules.yml +1 -1
  113. package/pipeline/skills/shared/core/multi-agent-channels/SKILL.md +1 -1
  114. package/pipeline/skills/shared/core/multi-agent-office-pair/SKILL.md +19 -0
  115. package/pipeline/skills/shared/core/multi-agent-office-status/SKILL.md +2 -2
  116. package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +3 -3
  117. package/pipeline/skills/shared/external/alarmkit/references/alarmkit-patterns.md +14 -0
  118. package/pipeline/skills/shared/external/android-architecture/references/patterns.md +6 -0
  119. package/pipeline/skills/shared/external/android-build-quality-gates/references/patterns.md +10 -0
  120. package/pipeline/skills/shared/external/android-datastore/references/patterns.md +11 -0
  121. package/pipeline/skills/shared/external/android-design-tokens-codegen/references/patterns.md +8 -0
  122. package/pipeline/skills/shared/external/android-jetpack-compose-expert/references/patterns.md +6 -0
  123. package/pipeline/skills/shared/external/android-mvi-viewmodel/references/patterns.md +10 -0
  124. package/pipeline/skills/shared/external/android-performance/references/patterns.md +13 -0
  125. package/pipeline/skills/shared/external/android-security/references/patterns.md +16 -0
  126. package/pipeline/skills/shared/external/api-patterns/references/contract-details.md +9 -0
  127. package/pipeline/skills/shared/external/api-security-best-practices/references/abuse-controls.md +12 -0
  128. package/pipeline/skills/shared/external/api-security-best-practices/references/identity-and-access.md +13 -0
  129. package/pipeline/skills/shared/external/api-security-best-practices/references/request-handling.md +12 -0
  130. package/pipeline/skills/shared/external/app-clips/references/data-handoff-notifications-location.md +9 -0
  131. package/pipeline/skills/shared/external/app-clips/references/routing-and-experiences.md +8 -0
  132. package/pipeline/skills/shared/external/app-clips/references/size-capabilities-and-promotion.md +10 -0
  133. package/pipeline/skills/shared/external/app-intents/references/appintents-advanced.md +21 -0
  134. package/pipeline/skills/shared/external/app-store-optimization/references/keyword-research-methodology.md +9 -0
  135. package/pipeline/skills/shared/external/app-store-optimization/references/product-page-variants.md +7 -0
  136. package/pipeline/skills/shared/external/app-store-review/SKILL.md +2 -2
  137. package/pipeline/skills/shared/external/app-store-review/references/privacy-manifest.md +10 -0
  138. package/pipeline/skills/shared/external/app-store-review/references/review-checklists.md +10 -1
  139. package/pipeline/skills/shared/external/apple-on-device-ai/references/coreml-conversion.md +22 -0
  140. package/pipeline/skills/shared/external/apple-on-device-ai/references/coreml-optimization.md +17 -0
  141. package/pipeline/skills/shared/external/apple-on-device-ai/references/foundation-models.md +22 -0
  142. package/pipeline/skills/shared/external/apple-on-device-ai/references/mlx-swift.md +17 -0
  143. package/pipeline/skills/shared/external/authentication/references/keychain-biometric.md +9 -0
  144. package/pipeline/skills/shared/external/authentication/references/passkeys.md +11 -0
  145. package/pipeline/skills/shared/external/avkit/references/avkit-patterns.md +13 -0
  146. package/pipeline/skills/shared/external/background-processing/references/background-task-patterns.md +9 -0
  147. package/pipeline/skills/shared/external/callkit-voip/references/callkit-patterns.md +10 -0
  148. package/pipeline/skills/shared/external/cloudkit-sync/references/cloudkit-patterns.md +15 -0
  149. package/pipeline/skills/shared/external/compose-components/references/patterns.md +7 -0
  150. package/pipeline/skills/shared/external/compose-navigation/references/patterns.md +7 -0
  151. package/pipeline/skills/shared/external/compose-testing/references/patterns.md +15 -0
  152. package/pipeline/skills/shared/external/contacts-framework/references/contacts-patterns.md +9 -0
  153. package/pipeline/skills/shared/external/core-bluetooth/references/ble-patterns.md +11 -0
  154. package/pipeline/skills/shared/external/core-motion/references/motion-patterns.md +10 -0
  155. package/pipeline/skills/shared/external/core-nfc/references/nfc-patterns.md +13 -0
  156. package/pipeline/skills/shared/external/coreml/references/coreml-swift-integration.md +20 -0
  157. package/pipeline/skills/shared/external/cryptokit/references/cryptokit-patterns.md +16 -0
  158. package/pipeline/skills/shared/external/debugging-instruments/references/instruments-guide.md +16 -0
  159. package/pipeline/skills/shared/external/debugging-instruments/references/lldb-patterns.md +14 -0
  160. package/pipeline/skills/shared/external/device-integrity/references/device-integrity-patterns.md +13 -0
  161. package/pipeline/skills/shared/external/energykit/references/energykit-patterns.md +10 -0
  162. package/pipeline/skills/shared/external/eventkit-calendar/references/eventkit-patterns.md +10 -0
  163. package/pipeline/skills/shared/external/fastapi-pro/references/app-structure.md +10 -0
  164. package/pipeline/skills/shared/external/gradle-kotlin-dsl/references/patterns.md +17 -0
  165. package/pipeline/skills/shared/external/healthkit/references/healthkit-patterns.md +12 -0
  166. package/pipeline/skills/shared/external/hig-app-icons/references/icon-workflow.md +10 -0
  167. package/pipeline/skills/shared/external/hig-components-content/references/content-views.md +10 -0
  168. package/pipeline/skills/shared/external/hig-components-layout/references/bars-and-tabs.md +11 -0
  169. package/pipeline/skills/shared/external/hig-foundations/references/foundations-detail.md +13 -0
  170. package/pipeline/skills/shared/external/hig-foundations/references/type-color-spacing.md +13 -0
  171. package/pipeline/skills/shared/external/hig-patterns/references/onboarding-and-states.md +11 -0
  172. package/pipeline/skills/shared/external/hig-platforms/references/ipad-layout.md +12 -0
  173. package/pipeline/skills/shared/external/hig-technologies/references/technologies.md +16 -0
  174. package/pipeline/skills/shared/external/homekit-matter/references/matter-commissioning.md +9 -0
  175. package/pipeline/skills/shared/external/ios-accessibility/references/a11y-patterns.md +18 -0
  176. package/pipeline/skills/shared/external/ios-accessibility/references/large-content-and-appearance.md +9 -0
  177. package/pipeline/skills/shared/external/ios-accessibility/references/media-accessibility.md +9 -0
  178. package/pipeline/skills/shared/external/ios-accessibility/references/nutrition-labels.md +7 -0
  179. package/pipeline/skills/shared/external/ios-coding-standard/references/STANDARD.md +13 -0
  180. package/pipeline/skills/shared/external/ios-design-review/references/appearance-matrix.md +9 -0
  181. package/pipeline/skills/shared/external/ios-design-review/references/checklist.md +15 -0
  182. package/pipeline/skills/shared/external/ios-haptics/references/core-haptics.md +11 -0
  183. package/pipeline/skills/shared/external/ios-iphone-duo/references/api-map.md +11 -0
  184. package/pipeline/skills/shared/external/ios-iphone-duo/references/fixed-assumptions.md +15 -0
  185. package/pipeline/skills/shared/external/ios-iphone-duo/references/poses-and-panes.md +11 -0
  186. package/pipeline/skills/shared/external/ios-localization/references/formatstyle-locale.md +18 -0
  187. package/pipeline/skills/shared/external/ios-localization/references/string-catalogs.md +19 -0
  188. package/pipeline/skills/shared/external/ios-networking/references/background-websocket.md +15 -0
  189. package/pipeline/skills/shared/external/ios-networking/references/file-storage-patterns.md +7 -0
  190. package/pipeline/skills/shared/external/ios-networking/references/lightweight-clients.md +8 -0
  191. package/pipeline/skills/shared/external/ios-networking/references/network-framework.md +12 -0
  192. package/pipeline/skills/shared/external/ios-networking/references/urlsession-patterns.md +17 -0
  193. package/pipeline/skills/shared/external/ios-security/references/app-review-guidelines.md +8 -0
  194. package/pipeline/skills/shared/external/ios-security/references/cryptokit-advanced.md +14 -0
  195. package/pipeline/skills/shared/external/ios-security/references/file-storage-patterns.md +8 -0
  196. package/pipeline/skills/shared/external/ios-security/references/privacy-manifest.md +9 -0
  197. package/pipeline/skills/shared/external/ios-sf-symbols/references/effects-and-custom-symbols.md +9 -0
  198. package/pipeline/skills/shared/external/ios-simulator/references/simctl-commands.md +13 -0
  199. package/pipeline/skills/shared/external/kotlin-coroutines-expert/references/patterns.md +8 -0
  200. package/pipeline/skills/shared/external/live-activities/references/activitykit-patterns.md +21 -0
  201. package/pipeline/skills/shared/external/localization-reuse-map/reference/format-and-output.md +9 -0
  202. package/pipeline/skills/shared/external/localization-reuse-map/reference/sources-and-recipes.md +12 -0
  203. package/pipeline/skills/shared/external/mapkit-location/references/mapkit-corelocation-patterns.md +16 -0
  204. package/pipeline/skills/shared/external/mapkit-location/references/mapkit-patterns.md +21 -0
  205. package/pipeline/skills/shared/external/metrickit-diagnostics/references/metrickit-patterns.md +10 -0
  206. package/pipeline/skills/shared/external/musickit-audio/references/musickit-patterns.md +9 -0
  207. package/pipeline/skills/shared/external/natural-language/references/translation-patterns.md +12 -0
  208. package/pipeline/skills/shared/external/nodejs-backend-patterns/references/runtime-patterns.md +11 -0
  209. package/pipeline/skills/shared/external/passkit-wallet/references/wallet-passes.md +11 -0
  210. package/pipeline/skills/shared/external/pdfkit/references/pdfkit-patterns.md +18 -0
  211. package/pipeline/skills/shared/external/pencilkit-drawing/references/pencilkit-patterns.md +11 -0
  212. package/pipeline/skills/shared/external/permissionkit/references/permissionkit-patterns.md +11 -0
  213. package/pipeline/skills/shared/external/photos-camera-media/references/av-playback.md +15 -0
  214. package/pipeline/skills/shared/external/photos-camera-media/references/camera-capture.md +14 -0
  215. package/pipeline/skills/shared/external/photos-camera-media/references/image-loading-caching.md +14 -0
  216. package/pipeline/skills/shared/external/photos-camera-media/references/photokit-patterns.md +14 -0
  217. package/pipeline/skills/shared/external/push-notifications/references/notification-patterns.md +14 -0
  218. package/pipeline/skills/shared/external/push-notifications/references/rich-notifications.md +10 -0
  219. package/pipeline/skills/shared/external/realitykit-ar/references/realitykit-patterns.md +12 -0
  220. package/pipeline/skills/shared/external/retrofit-networking/references/patterns.md +14 -0
  221. package/pipeline/skills/shared/external/room-database/references/patterns.md +16 -0
  222. package/pipeline/skills/shared/external/shareplay-activities/references/shareplay-patterns.md +10 -0
  223. package/pipeline/skills/shared/external/speech-recognition/references/speechanalyzer-patterns.md +10 -0
  224. package/pipeline/skills/shared/external/spm-build-analysis/references/build-optimization-sources.md +14 -0
  225. package/pipeline/skills/shared/external/spm-build-analysis/references/spm-analysis-checks.md +19 -0
  226. package/pipeline/skills/shared/external/storekit/references/core-patterns.md +13 -0
  227. package/pipeline/skills/shared/external/storekit/references/storekit-advanced.md +31 -0
  228. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/argument-labels-and-parameters.md +8 -0
  229. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/conventions-and-special-rules.md +9 -0
  230. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/naming-and-clarity.md +10 -0
  231. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/side-effects-and-mutating-pairs.md +8 -0
  232. package/pipeline/skills/shared/external/swift-charts/references/charts-patterns.md +24 -0
  233. package/pipeline/skills/shared/external/swift-concurrency/references/bridging-interop.md +8 -0
  234. package/pipeline/skills/shared/external/swift-concurrency/references/concurrency-patterns.md +14 -0
  235. package/pipeline/skills/shared/external/swift-concurrency/references/swiftui-concurrency.md +12 -0
  236. package/pipeline/skills/shared/external/swift-concurrency/references/synchronization-primitives.md +10 -0
  237. package/pipeline/skills/shared/external/swift-concurrency-expert/references/swift-6-2-concurrency.md +8 -0
  238. package/pipeline/skills/shared/external/swift-concurrency-pro/references/actors.md +10 -0
  239. package/pipeline/skills/shared/external/swift-concurrency-pro/references/cancellation.md +7 -0
  240. package/pipeline/skills/shared/external/swift-concurrency-pro/references/interop.md +10 -0
  241. package/pipeline/skills/shared/external/swift-concurrency-pro/references/new-features.md +11 -0
  242. package/pipeline/skills/shared/external/swift-concurrency-pro/references/structured.md +9 -0
  243. package/pipeline/skills/shared/external/swift-concurrency-pro/references/testing.md +13 -0
  244. package/pipeline/skills/shared/external/swift-language/references/swift-attributes-interop.md +7 -0
  245. package/pipeline/skills/shared/external/swift-language/references/swift-patterns-extended.md +14 -0
  246. package/pipeline/skills/shared/external/swift-security/references/biometric-authentication.md +16 -0
  247. package/pipeline/skills/shared/external/swift-security/references/certificate-trust.md +17 -0
  248. package/pipeline/skills/shared/external/swift-security/references/common-anti-patterns.md +19 -0
  249. package/pipeline/skills/shared/external/swift-security/references/compliance-owasp-mapping.md +16 -0
  250. package/pipeline/skills/shared/external/swift-security/references/credential-storage-patterns.md +19 -0
  251. package/pipeline/skills/shared/external/swift-security/references/cryptokit-public-key.md +18 -0
  252. package/pipeline/skills/shared/external/swift-security/references/cryptokit-symmetric.md +16 -0
  253. package/pipeline/skills/shared/external/swift-security/references/keychain-access-control.md +17 -0
  254. package/pipeline/skills/shared/external/swift-security/references/keychain-fundamentals.md +17 -0
  255. package/pipeline/skills/shared/external/swift-security/references/keychain-item-classes.md +17 -0
  256. package/pipeline/skills/shared/external/swift-security/references/keychain-sharing.md +18 -0
  257. package/pipeline/skills/shared/external/swift-security/references/migration-legacy-stores.md +21 -0
  258. package/pipeline/skills/shared/external/swift-security/references/secure-enclave.md +16 -0
  259. package/pipeline/skills/shared/external/swift-security/references/testing-security-code.md +16 -0
  260. package/pipeline/skills/shared/external/swift-testing/references/testing-advanced.md +9 -0
  261. package/pipeline/skills/shared/external/swift-testing/references/testing-patterns.md +24 -0
  262. package/pipeline/skills/shared/external/swift-testing-pro/references/async-tests.md +9 -0
  263. package/pipeline/skills/shared/external/swift-testing-pro/references/new-features.md +11 -0
  264. package/pipeline/skills/shared/external/swift-testing-pro/references/writing-better-tests.md +13 -0
  265. package/pipeline/skills/shared/external/swiftdata/references/core-data-coexistence.md +8 -0
  266. package/pipeline/skills/shared/external/swiftdata/references/swiftdata-advanced.md +17 -0
  267. package/pipeline/skills/shared/external/swiftdata/references/swiftdata-queries.md +12 -0
  268. package/pipeline/skills/shared/external/swiftlint/references/adoption-and-configuration.md +11 -0
  269. package/pipeline/skills/shared/external/swiftlint/references/custom-rules-and-analyze.md +7 -0
  270. package/pipeline/skills/shared/external/swiftlint/references/plugins-run-scripts-and-integrations.md +13 -0
  271. package/pipeline/skills/shared/external/swiftlint/references/rule-reference.md +24 -0
  272. package/pipeline/skills/shared/external/swiftlint/references/rules-suppressions-and-baselines.md +12 -0
  273. package/pipeline/skills/shared/external/swiftui-animation/references/animation-advanced.md +15 -0
  274. package/pipeline/skills/shared/external/swiftui-animation/references/core-animation-bridge.md +15 -0
  275. package/pipeline/skills/shared/external/swiftui-animation/references/scroll-effects.md +12 -0
  276. package/pipeline/skills/shared/external/swiftui-expert-skill/references/accessibility-patterns.md +11 -0
  277. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-advanced.md +7 -0
  278. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-basics.md +13 -0
  279. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-transitions.md +9 -0
  280. package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts-accessibility.md +9 -0
  281. package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts.md +17 -0
  282. package/pipeline/skills/shared/external/swiftui-expert-skill/references/image-optimization.md +9 -0
  283. package/pipeline/skills/shared/external/swiftui-expert-skill/references/latest-apis.md +10 -0
  284. package/pipeline/skills/shared/external/swiftui-expert-skill/references/layout-best-practices.md +12 -0
  285. package/pipeline/skills/shared/external/swiftui-expert-skill/references/list-patterns.md +12 -0
  286. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-scenes.md +13 -0
  287. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-views.md +12 -0
  288. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-window-styling.md +12 -0
  289. package/pipeline/skills/shared/external/swiftui-expert-skill/references/performance-patterns.md +7 -0
  290. package/pipeline/skills/shared/external/swiftui-expert-skill/references/scroll-patterns.md +9 -0
  291. package/pipeline/skills/shared/external/swiftui-expert-skill/references/sheet-navigation-patterns.md +10 -0
  292. package/pipeline/skills/shared/external/swiftui-expert-skill/references/state-management.md +18 -0
  293. package/pipeline/skills/shared/external/swiftui-expert-skill/references/view-structure.md +16 -0
  294. package/pipeline/skills/shared/external/swiftui-gestures/references/gesture-patterns.md +11 -0
  295. package/pipeline/skills/shared/external/swiftui-layout-components/references/form.md +8 -0
  296. package/pipeline/skills/shared/external/swiftui-layout-components/references/grids.md +14 -0
  297. package/pipeline/skills/shared/external/swiftui-layout-components/references/scrollview.md +9 -0
  298. package/pipeline/skills/shared/external/swiftui-liquid-glass/references/liquid-glass.md +22 -0
  299. package/pipeline/skills/shared/external/swiftui-liquid-glass/references/uikit-glass.md +14 -0
  300. package/pipeline/skills/shared/external/swiftui-navigation/references/deeplinks.md +10 -0
  301. package/pipeline/skills/shared/external/swiftui-navigation/references/navigationstack.md +10 -0
  302. package/pipeline/skills/shared/external/swiftui-navigation/references/sheets.md +13 -0
  303. package/pipeline/skills/shared/external/swiftui-navigation/references/tabview.md +10 -0
  304. package/pipeline/skills/shared/external/swiftui-patterns/references/architecture-patterns.md +14 -0
  305. package/pipeline/skills/shared/external/swiftui-patterns/references/deprecated-migration.md +30 -0
  306. package/pipeline/skills/shared/external/swiftui-patterns/references/platform-and-sharing.md +16 -0
  307. package/pipeline/skills/shared/external/swiftui-performance/references/demystify-swiftui-performance-wwdc23.md +11 -0
  308. package/pipeline/skills/shared/external/swiftui-performance/references/optimizing-swiftui-performance-instruments.md +11 -0
  309. package/pipeline/skills/shared/external/swiftui-performance/references/understanding-hangs-in-your-app.md +10 -0
  310. package/pipeline/skills/shared/external/swiftui-performance-audit/references/code-smells.md +8 -0
  311. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/app-wiring.md +12 -0
  312. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/menu-bar.md +10 -0
  313. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/navigationstack.md +11 -0
  314. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/scroll-reveal.md +12 -0
  315. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/sheets.md +14 -0
  316. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/tabview.md +10 -0
  317. package/pipeline/skills/shared/external/swiftui-uikit-interop/references/hosting-migration.md +10 -0
  318. package/pipeline/skills/shared/external/swiftui-uikit-interop/references/representable-recipes.md +13 -0
  319. package/pipeline/skills/shared/external/swiftui-view-refactor/references/mv-patterns.md +12 -0
  320. package/pipeline/skills/shared/external/swiftui-webkit/references/loading-and-observation.md +8 -0
  321. package/pipeline/skills/shared/external/swiftui-webkit/references/navigation-and-javascript.md +8 -0
  322. package/pipeline/skills/shared/external/tipkit/references/tipkit-patterns.md +14 -0
  323. package/pipeline/skills/shared/external/vision-framework/references/vision-requests.md +17 -0
  324. package/pipeline/skills/shared/external/vision-framework/references/visionkit-scanner.md +11 -0
  325. package/pipeline/skills/shared/external/weatherkit/references/weatherkit-patterns.md +11 -0
  326. package/pipeline/skills/shared/external/widgetkit/references/widgetkit-advanced.md +27 -0
  327. package/pipeline/skills/shared/external/xcode-build-fixer/references/build-settings-best-practices.md +9 -0
  328. package/pipeline/skills/shared/external/xcode-build-fixer/references/fix-patterns.md +7 -0
  329. package/pipeline/skills/shared/external/xcode-build-orchestrator/references/build-settings-best-practices.md +9 -0
  330. package/pipeline/skills/shared/external/xcode-compilation-analyzer/references/build-optimization-sources.md +14 -0
  331. package/pipeline/skills/shared/external/xcode-compilation-analyzer/references/code-compilation-checks.md +8 -0
  332. package/pipeline/skills/shared/external/xcode-project-analyzer/references/build-optimization-sources.md +14 -0
  333. package/pipeline/skills/shared/external/xcode-project-analyzer/references/build-settings-best-practices.md +9 -0
  334. package/pipeline/skills/shared/external/xcode-project-analyzer/references/project-audit-checks.md +13 -0
  335. package/pipeline/skills/skills-index.md +2 -1
@@ -1,5 +1,16 @@
1
1
  # Poses, panes and the design review
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [1. Poses](#1-poses)
6
+ - [2. Pose to pattern](#2-pose-to-pattern)
7
+ - [3. Using the inner display](#3-using-the-inner-display)
8
+ - [4. Dual-pane rules](#4-dual-pane-rules)
9
+ - [5. Controls on the side](#5-controls-on-the-side)
10
+ - [6. The fold](#6-the-fold)
11
+ - [7. Review checklist](#7-review-checklist)
12
+ <!-- /toc -->
13
+
3
14
  Design guidance for iPhone Duo. The rules marked HIG come from Apple's
4
15
  Designing for iPhone Duo page; the pattern table is a recommendation built on
5
16
  those rules and on size classes, and should be adapted to the app's content.
@@ -1,5 +1,23 @@
1
1
  # FormatStyle, Locale and Layout Direction
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Replacing legacy formatters](#replacing-legacy-formatters)
6
+ - [Dates](#dates)
7
+ - [Numbers](#numbers)
8
+ - [Measurements](#measurements)
9
+ - [Durations](#durations)
10
+ - [Person names](#person-names)
11
+ - [Byte counts](#byte-counts)
12
+ - [Lists](#lists)
13
+ - [Custom styles](#custom-styles)
14
+ - [Pinning a locale](#pinning-a-locale)
15
+ - [Right-to-left in depth](#right-to-left-in-depth)
16
+ - [ScaledMetric and Dynamic Type](#scaledmetric-and-dynamic-type)
17
+ - [Checking layout with Accessibility Inspector](#checking-layout-with-accessibility-inspector)
18
+ - [Cheat sheet](#cheat-sheet)
19
+ <!-- /toc -->
20
+
3
21
  `FormatStyle` needs iOS 15 or later. This skill uses it for locale-aware
4
22
  display: numbers, dates, currency, units, names, lists, calendars and
5
23
  separators, plus previews and tests across locales. Custom `FormatStyle`
@@ -1,5 +1,24 @@
1
1
  # String Catalogs in Depth
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [What a catalog is](#what-a-catalog-is)
6
+ - [Creating one](#creating-one)
7
+ - [What extraction picks up](#what-extraction-picks-up)
8
+ - [Managing keys by hand](#managing-keys-by-hand)
9
+ - [Strings outside SwiftUI](#strings-outside-swiftui)
10
+ - [Bundles](#bundles)
11
+ - [Swift packages and multiple modules](#swift-packages-and-multiple-modules)
12
+ - [Plurals](#plurals)
13
+ - [Device variants](#device-variants)
14
+ - [Working with translators](#working-with-translators)
15
+ - [The JSON format](#the-json-format)
16
+ - [Generated symbols (Xcode 26)](#generated-symbols-xcode-26)
17
+ - [Testing](#testing)
18
+ - [Migrating from .strings and .stringsdict](#migrating-from-strings-and-stringsdict)
19
+ - [Practices that scale](#practices-that-scale)
20
+ <!-- /toc -->
21
+
3
22
  ## Contents
4
23
 
5
24
  1. [What a catalog is](#what-a-catalog-is)
@@ -1,5 +1,20 @@
1
1
  # Background Transfers and WebSockets
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Setting up a background session](#setting-up-a-background-session)
6
+ - [Downloads that outlive the app](#downloads-that-outlive-the-app)
7
+ - [Relaunch and session event delivery](#relaunch-and-session-event-delivery)
8
+ - [Uploads from a file on disk](#uploads-from-a-file-on-disk)
9
+ - [URLSessionWebSocketTask](#urlsessionwebsockettask)
10
+ - [Reconnecting a dropped socket](#reconnecting-a-dropped-socket)
11
+ - [Typed messages over a socket](#typed-messages-over-a-socket)
12
+ - [Pitfalls of background sessions](#pitfalls-of-background-sessions)
13
+ - [Showing download progress in SwiftUI](#showing-download-progress-in-swiftui)
14
+ - [WebSocket Authentication](#websocket-authentication)
15
+ - [Choosing a subprotocol](#choosing-a-subprotocol)
16
+ <!-- /toc -->
17
+
3
18
  Two things that are often confused. A background URLSession moves HTTP and
4
19
  HTTPS uploads and downloads while the app is not running. A WebSocket is a
5
20
  live foreground connection. Neither does the other's job.
@@ -1,5 +1,12 @@
1
1
  # File Storage Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Directory Selection Guide](#directory-selection-guide)
5
+ - [FileProtectionType Levels](#fileprotectiontype-levels)
6
+ - [Backup Exclusion (isExcludedFromBackup)](#backup-exclusion-isexcludedfrombackup)
7
+ - [Storage Pressure Handling](#storage-pressure-handling)
8
+ <!-- /toc -->
9
+
3
10
  Downloaded and uploaded data has to live somewhere. Where it lives decides
4
11
  whether it is backed up, whether the system may delete it, and when it can be
5
12
  read.
@@ -1,5 +1,13 @@
1
1
  # Lightweight Closure-Based Clients
2
2
 
3
+ <!-- toc -->
4
+ - [Intent](#intent)
5
+ - [Minimal shape](#minimal-shape)
6
+ - [Usage pattern](#usage-pattern)
7
+ - [Guidance](#guidance)
8
+ - [Pitfalls](#pitfalls)
9
+ <!-- /toc -->
10
+
3
11
  In an MV-style SwiftUI app a full view model plus a dependency injection
4
12
  container is often more ceremony than the feature needs. A client made of a
5
13
  few async closures keeps the service boundary swappable for previews and
@@ -1,5 +1,17 @@
1
1
  # Network Framework
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [NWConnection](#nwconnection)
6
+ - [NWListener](#nwlistener)
7
+ - [NWBrowser](#nwbrowser)
8
+ - [NWPathMonitor](#nwpathmonitor)
9
+ - [NWParameters Configuration](#nwparameters-configuration)
10
+ - [TLS Configuration](#tls-configuration)
11
+ - [WebSocket Support](#websocket-support)
12
+ - [The iOS 26 NetworkConnection API](#the-ios-26-networkconnection-api)
13
+ <!-- /toc -->
14
+
3
15
  Reach for Network.framework when URLSession is the wrong layer: raw TCP or
4
16
  UDP, a WebSocket at the protocol level, Bonjour discovery, a local server, or
5
17
  detailed path monitoring. Ordinary HTTP APIs stay on URLSession. Examples
@@ -1,5 +1,22 @@
1
1
  # URLSession Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [A protocol-backed API client](#a-protocol-backed-api-client)
6
+ - [Building requests step by step](#building-requests-step-by-step)
7
+ - [Uploading multipart form data](#uploading-multipart-form-data)
8
+ - [Downloads that report progress](#downloads-that-report-progress)
9
+ - [Paging by cursor](#paging-by-cursor)
10
+ - [Paging by offset](#paging-by-offset)
11
+ - [Stubbing the network with URLProtocol](#stubbing-the-network-with-urlprotocol)
12
+ - [Retries that back off exponentially](#retries-that-back-off-exponentially)
13
+ - [Pinning certificates in a session delegate](#pinning-certificates-in-a-session-delegate)
14
+ - [Middleware that logs requests](#middleware-that-logs-requests)
15
+ - [Choosing a cache policy](#choosing-a-cache-policy)
16
+ - [Reading a server-sent event stream](#reading-a-server-sent-event-stream)
17
+ - [A production-ready session setup](#a-production-ready-session-setup)
18
+ <!-- /toc -->
19
+
3
20
  Longer implementations behind the summaries in [SKILL.md](../SKILL.md). The
4
21
  types here are the same ones SKILL.md names: `APIClientProtocol` with
5
22
  `fetch`, `send`, `perform` and `upload`; `Endpoint`; `NetworkError`;
@@ -1,5 +1,13 @@
1
1
  # App Review Guidelines -- Privacy and Security
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [PrivacyInfo.xcprivacy -- Privacy Manifest Requirements (Guideline 5.1.1)](#privacyinfoxcprivacy----privacy-manifest-requirements-guideline-511)
6
+ - [Data Use, Sharing, and Privacy Policy (Guideline 5.1.2)](#data-use-sharing-and-privacy-policy-guideline-512)
7
+ - [App Tracking Transparency (ATT)](#app-tracking-transparency-att)
8
+ - [Pre-Submission Privacy Checklist](#pre-submission-privacy-checklist)
9
+ <!-- /toc -->
10
+
3
11
  App Store review rules relevant to security, privacy manifests, data handling,
4
12
  and App Tracking Transparency. Extracted from Apple's App Store Review
5
13
  Guidelines for self-contained reference.
@@ -1,5 +1,19 @@
1
1
  # CryptoKit Advanced Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [ChaChaPoly (Alternative to AES-GCM)](#chachapoly-alternative-to-aes-gcm)
6
+ - [Digital Signatures (P256 / ECDSA)](#digital-signatures-p256-ecdsa)
7
+ - [Key Agreement (Diffie-Hellman)](#key-agreement-diffie-hellman)
8
+ - [Key Derivation with HKDF](#key-derivation-with-hkdf)
9
+ - [Authenticated Encryption with Associated Data (AEAD)](#authenticated-encryption-with-associated-data-aead)
10
+ - [AES Key Wrapping](#aes-key-wrapping)
11
+ - [Secure Enclave Key Agreement](#secure-enclave-key-agreement)
12
+ - [Post-Quantum Cryptography](#post-quantum-cryptography)
13
+ - [Storing CryptoKit Keys in Keychain](#storing-cryptokit-keys-in-keychain)
14
+ - [Jailbreak Detection](#jailbreak-detection)
15
+ <!-- /toc -->
16
+
3
17
  Extended CryptoKit usage beyond the basics covered in the main skill. Includes
4
18
  digital signatures, key agreement, alternative ciphers, key derivation, and
5
19
  post-quantum cryptography.
@@ -1,5 +1,13 @@
1
1
  # File Storage Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Directory Selection Guide](#directory-selection-guide)
6
+ - [FileProtectionType Levels](#fileprotectiontype-levels)
7
+ - [Backup Exclusion (isExcludedFromBackup)](#backup-exclusion-isexcludedfrombackup)
8
+ - [Storage Pressure Handling](#storage-pressure-handling)
9
+ <!-- /toc -->
10
+
3
11
  Guidance on choosing the right directory, applying file protection, managing
4
12
  backup exclusions, and handling storage pressure on iOS.
5
13
 
@@ -1,5 +1,14 @@
1
1
  # Privacy Manifests -- Security Perspective
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Required API Declarations](#required-api-declarations)
6
+ - [Data Collection Declarations](#data-collection-declarations)
7
+ - [Tracking Domains](#tracking-domains)
8
+ - [Auditing Dependencies](#auditing-dependencies)
9
+ - [App Tracking Transparency (ATT)](#app-tracking-transparency-att)
10
+ <!-- /toc -->
11
+
3
12
  This reference covers the security-relevant aspects of PrivacyInfo.xcprivacy:
4
13
  required-reason API declarations, data collection types, and tracking domains.
5
14
  For submission requirements and App Review compliance checklists, see
@@ -1,5 +1,14 @@
1
1
  # Symbol effects, UIKit API and custom symbols
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [1. Effect options](#1-effect-options)
6
+ - [2. Effects in UIKit](#2-effects-in-uikit)
7
+ - [3. Rendering and configuration in UIKit](#3-rendering-and-configuration-in-uikit)
8
+ - [4. Custom symbol workflow](#4-custom-symbol-workflow)
9
+ - [5. Review checklist](#5-review-checklist)
10
+ <!-- /toc -->
11
+
3
12
  ## Contents
4
13
 
5
14
  1. Effect options
@@ -1,5 +1,18 @@
1
1
  # simctl command reference
2
2
 
3
+ <!-- toc -->
4
+ - [Devices](#devices)
5
+ - [Apps](#apps)
6
+ - [Simulation](#simulation)
7
+ - [Push payloads](#push-payloads)
8
+ - [Location](#location)
9
+ - [Media and capture](#media-and-capture)
10
+ - [JSON with jq](#json-with-jq)
11
+ - [Privacy services](#privacy-services)
12
+ - [Status bar flags](#status-bar-flags)
13
+ - [Troubleshooting](#troubleshooting)
14
+ <!-- /toc -->
15
+
3
16
  Lookup tables for `xcrun simctl`. Workflows and the simulator-versus-hardware
4
17
  boundary are in [the main skill](../SKILL.md). `<dev>` below means a UDID, or
5
18
  `booted` when exactly one simulator is running. `xcrun simctl help <command>`
@@ -1,5 +1,13 @@
1
1
  # Coroutines: Flow and testing
2
2
 
3
+ <!-- toc -->
4
+ - [Flow](#flow)
5
+ - [Operators worth knowing by reflex](#operators-worth-knowing-by-reflex)
6
+ - [Bridging callbacks](#bridging-callbacks)
7
+ - [Hot streams](#hot-streams)
8
+ - [Testing](#testing)
9
+ <!-- /toc -->
10
+
3
11
  Loaded on demand from `../SKILL.md`.
4
12
 
5
13
  ## Flow
@@ -1,5 +1,26 @@
1
1
  # ActivityKit Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [A complete attributes model](#a-complete-attributes-model)
6
+ - [Starting, with every parameter](#starting-with-every-parameter)
7
+ - [Updating from the app](#updating-from-the-app)
8
+ - [Server payloads](#server-payloads)
9
+ - [Channel pushes (iOS 18+)](#channel-pushes-ios-18)
10
+ - [Ending by outcome](#ending-by-outcome)
11
+ - [Dynamic Island, all regions](#dynamic-island-all-regions)
12
+ - [Lock Screen view with timer and progress](#lock-screen-view-with-timer-and-progress)
13
+ - [Several activities at once](#several-activities-at-once)
14
+ - [Observing state and content](#observing-state-and-content)
15
+ - [Tokens](#tokens)
16
+ - [Authorization](#authorization)
17
+ - [Errors](#errors)
18
+ - [Background behaviour](#background-behaviour)
19
+ - [Testing](#testing)
20
+ - [Info.plist keys](#infoplist-keys)
21
+ - [Apple documentation](#apple-documentation)
22
+ <!-- /toc -->
23
+
3
24
  Worked patterns for Live Activities. Everything here uses async/await and
4
25
  `ActivityContent`, so it needs iOS 16.2 or later unless a heading names a
5
26
  newer release.
@@ -1,5 +1,14 @@
1
1
  # Mapping format and outputs
2
2
 
3
+ <!-- toc -->
4
+ - [Mapping schema](#mapping-schema)
5
+ - [Rendered artifacts](#rendered-artifacts)
6
+ - [Overlay and keyshots](#overlay-and-keyshots)
7
+ - [CMS import spreadsheet](#cms-import-spreadsheet)
8
+ - [Fidelity gate](#fidelity-gate)
9
+ - [Script reference](#script-reference)
10
+ <!-- /toc -->
11
+
3
12
  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.
4
13
 
5
14
  ## Mapping schema
@@ -1,5 +1,17 @@
1
1
  # Sources and recipes
2
2
 
3
+ <!-- toc -->
4
+ - [Where each input lives](#where-each-input-lives)
5
+ - [New keys: the three-way union](#new-keys-the-three-way-union)
6
+ - [New values](#new-values)
7
+ - [CMS copy (Figma annotations)](#cms-copy-figma-annotations)
8
+ - [Legacy keys: trace, do not skim](#legacy-keys-trace-do-not-skim)
9
+ - [Legacy values](#legacy-values)
10
+ - [Overlay geometry](#overlay-geometry)
11
+ - [Keyshots](#keyshots)
12
+ - [Pitfalls](#pitfalls)
13
+ <!-- /toc -->
14
+
3
15
  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.
4
16
 
5
17
  ## Where each input lives
@@ -1,5 +1,21 @@
1
1
  # CoreLocation Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [CLLocationUpdate.liveUpdates()](#cllocationupdateliveupdates)
6
+ - [Service Sessions (iOS 18+)](#service-sessions-ios-18)
7
+ - [Geofences with CLMonitor (iOS 17+)](#geofences-with-clmonitor-ios-17)
8
+ - [CLBackgroundActivitySession](#clbackgroundactivitysession)
9
+ - [Coarse Updates from Significant Changes](#coarse-updates-from-significant-changes)
10
+ - [Visits](#visits)
11
+ - [Moving Off CLCircularRegion](#moving-off-clcircularregion)
12
+ - [Choosing Accuracy](#choosing-accuracy)
13
+ - [Simulating Position](#simulating-position)
14
+ - [Info.plist Privacy Keys](#infoplist-privacy-keys)
15
+ - [Pitfalls](#pitfalls)
16
+ - [References](#references)
17
+ <!-- /toc -->
18
+
3
19
  Modern CoreLocation with Swift concurrency, iOS 17 and later unless a heading
4
20
  says otherwise. Import `CoreLocation` in each file that uses these types.
5
21
 
@@ -1,5 +1,26 @@
1
1
  # MapKit Patterns for SwiftUI
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [A Full Map Screen](#a-full-map-screen)
6
+ - [Custom Annotations](#custom-annotations)
7
+ - [Camera Control](#camera-control)
8
+ - [Selection](#selection)
9
+ - [Autocomplete Search](#autocomplete-search)
10
+ - [Route Display](#route-display)
11
+ - [Cycling Directions (iOS 14+)](#cycling-directions-ios-14)
12
+ - [Street-Level Look Around](#street-level-look-around)
13
+ - [Still Images with MKMapSnapshotter](#still-images-with-mkmapsnapshotter)
14
+ - [Dense Annotations and Clustering](#dense-annotations-and-clustering)
15
+ - [MKMapItem Helpers](#mkmapitem-helpers)
16
+ - [Geocoding and Places on iOS 26](#geocoding-and-places-on-ios-26)
17
+ - [Showing the User](#showing-the-user)
18
+ - [Maps Inside Scrolling Content](#maps-inside-scrolling-content)
19
+ - [Coordinate Math](#coordinate-math)
20
+ - [Accessibility](#accessibility)
21
+ - [Apple Documentation](#apple-documentation)
22
+ <!-- /toc -->
23
+
3
24
  Everything here targets iOS 17 and SwiftUI unless a heading names a later
4
25
  release. Each file that uses these types imports both `MapKit` and `SwiftUI`.
5
26
 
@@ -1,5 +1,15 @@
1
1
  # MetricKit patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Reading call-stack trees](#reading-call-stack-trees)
5
+ - [Custom signposts end to end](#custom-signposts-end-to-end)
6
+ - [Exporting and uploading](#exporting-and-uploading)
7
+ - [Catching up on missed payloads](#catching-up-on-missed-payloads)
8
+ - [Extended launch rules](#extended-launch-rules)
9
+ - [Xcode Organizer](#xcode-organizer)
10
+ - [Apple documentation](#apple-documentation)
11
+ <!-- /toc -->
12
+
3
13
  Worked examples for the `metrickit-diagnostics` skill ([../SKILL.md](../SKILL.md)).
4
14
 
5
15
  ## Reading call-stack trees
@@ -1,5 +1,14 @@
1
1
  # MusicKit Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [SwiftUI integration](#swiftui-integration)
5
+ - [Genre and chart browsing](#genre-and-chart-browsing)
6
+ - [Library management](#library-management)
7
+ - [Playlist access](#playlist-access)
8
+ - [Now Playing session](#now-playing-session)
9
+ - [Background audio configuration](#background-audio-configuration)
10
+ <!-- /toc -->
11
+
3
12
  Longer examples for the `musickit-audio` skill. Its SKILL.md covers setup,
4
13
  authorization, subscription checks and the basic player; this file builds on
5
14
  that.
@@ -1,5 +1,17 @@
1
1
  # Translation and text-analysis patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Plugging in a Create ML model](#plugging-in-a-create-ml-model)
5
+ - [Contextual embeddings](#contextual-embeddings)
6
+ - [Gazetteers for your own vocabulary](#gazetteers-for-your-own-vocabulary)
7
+ - [One tagger, several schemes](#one-tagger-several-schemes)
8
+ - [Translating text in place](#translating-text-in-place)
9
+ - [Choosing a translation strategy](#choosing-a-translation-strategy)
10
+ - [Getting a session ready](#getting-a-session-ready)
11
+ - [A live analysis panel in SwiftUI](#a-live-analysis-panel-in-swiftui)
12
+ - [Lemmas for search](#lemmas-for-search)
13
+ <!-- /toc -->
14
+
3
15
  Deeper material for the `natural-language` skill ([../SKILL.md](../SKILL.md)).
4
16
 
5
17
  ## Plugging in a Create ML model
@@ -1,5 +1,16 @@
1
1
  # Node.js runtime patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Project shape](#project-shape)
6
+ - [Configuration validated at startup](#configuration-validated-at-startup)
7
+ - [Errors](#errors)
8
+ - [Graceful shutdown](#graceful-shutdown)
9
+ - [Request context](#request-context)
10
+ - [Timeouts and cancellation](#timeouts-and-cancellation)
11
+ - [Streams and backpressure](#streams-and-backpressure)
12
+ <!-- /toc -->
13
+
3
14
  Worked code for the project layout, configuration, errors, shutdown, request context, timeouts and streams summarised in SKILL.md.
4
15
 
5
16
  ## Contents
@@ -1,5 +1,16 @@
1
1
  # Wallet Passes and Advanced Apple Pay
2
2
 
3
+ <!-- toc -->
4
+ - [One advanced type per request](#one-advanced-type-per-request)
5
+ - [Recurring payments](#recurring-payments)
6
+ - [Coupon codes](#coupon-codes)
7
+ - [Several merchants in one checkout](#several-merchants-in-one-checkout)
8
+ - [Deferred payments](#deferred-payments)
9
+ - [Pass bundles](#pass-bundles)
10
+ - [Keeping passes current](#keeping-passes-current)
11
+ - [SwiftUI checkout screen](#swiftui-checkout-screen)
12
+ <!-- /toc -->
13
+
3
14
  Reference for the `passkit-wallet` skill: advanced payment request types,
4
15
  pass bundles, pass updates and a complete SwiftUI checkout.
5
16
 
@@ -1,5 +1,23 @@
1
1
  # PDFKit patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Forms](#forms)
6
+ - [Building PDFs in code](#building-pdfs-in-code)
7
+ - [Watermarks](#watermarks)
8
+ - [Merging and splitting](#merging-and-splitting)
9
+ - [Printing](#printing)
10
+ - [Outlines](#outlines)
11
+ - [Custom annotation classes](#custom-annotation-classes)
12
+ - [Custom page classes](#custom-page-classes)
13
+ - [Overlay lifecycle](#overlay-lifecycle)
14
+ - [Rendering a page to an image](#rendering-a-page-to-an-image)
15
+ - [Rotation and cropping](#rotation-and-cropping)
16
+ - [Burning in annotations](#burning-in-annotations)
17
+ - [Permissions](#permissions)
18
+ - [Coordinator-based SwiftUI wrapper](#coordinator-based-swiftui-wrapper)
19
+ <!-- /toc -->
20
+
3
21
  Longer recipes that build on the main skill. Code targets Swift 6.3 and iOS 26;
4
22
  functions that touch views are `@MainActor`.
5
23
 
@@ -1,5 +1,16 @@
1
1
  # PencilKit patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Listening to the tool picker](#listening-to-the-tool-picker)
5
+ - [A custom picker item](#a-custom-picker-item)
6
+ - [Delegate lifecycle](#delegate-lifecycle)
7
+ - [Undo and redo](#undo-and-redo)
8
+ - [Thumbnails with a fixed aspect ratio](#thumbnails-with-a-fixed-aspect-ratio)
9
+ - [Scoring a tracing exercise](#scoring-a-tracing-exercise)
10
+ - [Managing content versions](#managing-content-versions)
11
+ - [A configurable SwiftUI wrapper](#a-configurable-swiftui-wrapper)
12
+ <!-- /toc -->
13
+
3
14
  Longer recipes for the `pencilkit-drawing` skill ([../SKILL.md](../SKILL.md)).
4
15
 
5
16
  ## Listening to the tool picker
@@ -1,5 +1,16 @@
1
1
  # PermissionKit patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [UIKit view controller](#uikit-view-controller)
6
+ - [Response manager](#response-manager)
7
+ - [Several contacts in one question](#several-contacts-in-one-question)
8
+ - [Limits-check view model](#limits-check-view-model)
9
+ - [SwiftUI full flow](#swiftui-full-flow)
10
+ - [macOS](#macos)
11
+ - [Error recovery](#error-recovery)
12
+ <!-- /toc -->
13
+
3
14
  Longer examples that back the main `permissionkit` skill. They assume the iOS
4
15
  26.2 SDK (macOS 26.2 for the AppKit section) unless marked otherwise; the
5
16
  26.0 pieces (`CommunicationLimits`, the topic and question types) work
@@ -1,5 +1,20 @@
1
1
  # Audio and video playback
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Players and where they render](#players-and-where-they-render)
6
+ - [Assets and items](#assets-and-items)
7
+ - [Transport controls](#transport-controls)
8
+ - [Watching state and time](#watching-state-and-time)
9
+ - [HLS streaming](#hls-streaming)
10
+ - [The audio session](#the-audio-session)
11
+ - [Background audio](#background-audio)
12
+ - [Now Playing](#now-playing)
13
+ - [Remote commands](#remote-commands)
14
+ - [Picture in Picture](#picture-in-picture)
15
+ - [Documentation](#documentation)
16
+ <!-- /toc -->
17
+
3
18
  ## Contents
4
19
 
5
20
  - [Players and where they render](#players-and-where-they-render)
@@ -1,5 +1,19 @@
1
1
  # Capture session recipes
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [1. A full photo camera](#1-a-full-photo-camera)
6
+ - [2. Preview view](#2-preview-view)
7
+ - [3. Camera screen](#3-camera-screen)
8
+ - [4. Recording video](#4-recording-video)
9
+ - [5. Flash and torch](#5-flash-and-torch)
10
+ - [6. Tap to focus and expose](#6-tap-to-focus-and-expose)
11
+ - [7. Barcodes and QR codes](#7-barcodes-and-qr-codes)
12
+ - [8. Orientation](#8-orientation)
13
+ - [9. Choosing specific cameras](#9-choosing-specific-cameras)
14
+ - [10. Limiting the scan area](#10-limiting-the-scan-area)
15
+ <!-- /toc -->
16
+
3
17
  Shape used throughout: an `@Observable` model owns the capture session and all
4
18
  camera state; the SwiftUI view draws the preview and forwards taps. Session
5
19
  work runs on one private serial queue, because `AVCaptureSession` is not
@@ -1,5 +1,19 @@
1
1
  # Loading, caching and downsampling images
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [AsyncImage](#asyncimage)
6
+ - [In-memory cache on NSCache](#in-memory-cache-on-nscache)
7
+ - [Disk cache with URLCache](#disk-cache-with-urlcache)
8
+ - [Downsampling at decode time](#downsampling-at-decode-time)
9
+ - [Prefetching](#prefetching)
10
+ - [HEIF and HEIC](#heif-and-heic)
11
+ - [Shrinking before upload](#shrinking-before-upload)
12
+ - [Staying inside a memory budget](#staying-inside-a-memory-budget)
13
+ - [One loader for everything](#one-loader-for-everything)
14
+ - [Which layer for which job](#which-layer-for-which-job)
15
+ <!-- /toc -->
16
+
3
17
  Everything here uses async/await and targets iOS 26 and Swift 6.3.
4
18
  The samples need iOS 17 or later because the models use `@Observable`.
5
19
 
@@ -1,5 +1,19 @@
1
1
  # Picker and PhotoKit recipes
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [1. One photo with an explicit loading state](#1-one-photo-with-an-explicit-loading-state)
6
+ - [2. Many photos with progress](#2-many-photos-with-progress)
7
+ - [3. Video from the picker](#3-video-from-the-picker)
8
+ - [4. Live Photos](#4-live-photos)
9
+ - [5. PHPickerViewController inside SwiftUI](#5-phpickerviewcontroller-inside-swiftui)
10
+ - [6. Saving into the library](#6-saving-into-the-library)
11
+ - [7. Thumbnails with ImageIO](#7-thumbnails-with-imageio)
12
+ - [8. HEIC and HEIF](#8-heic-and-heif)
13
+ - [9. Picker appearance](#9-picker-appearance)
14
+ - [10. Cropping](#10-cropping)
15
+ <!-- /toc -->
16
+
3
17
  Each recipe uses SwiftUI with async/await and needs iOS 17 or later (the views
4
18
  use the two-parameter `onChange(of:)`). `PhotosPicker` itself is iOS 16.
5
19
 
@@ -1,5 +1,19 @@
1
1
  # Notification Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [App and AppDelegate Wiring](#app-and-appdelegate-wiring)
6
+ - [The Center Delegate](#the-center-delegate)
7
+ - [Routing a Tap to a Screen](#routing-a-tap-to-a-screen)
8
+ - [Handling a Silent Push](#handling-a-silent-push)
9
+ - [A Local Scheduler](#a-local-scheduler)
10
+ - [Token Lifecycle](#token-lifecycle)
11
+ - [Registering Categories](#registering-categories)
12
+ - [Testing and Debugging Delivery](#testing-and-debugging-delivery)
13
+ - [Badges](#badges)
14
+ - [From Provisional to Full Permission](#from-provisional-to-full-permission)
15
+ <!-- /toc -->
16
+
3
17
  Working code for the app side of notifications: wiring at launch, the center
4
18
  delegate, routing a tap to a screen, silent pushes, a small scheduler, the
5
19
  token lifecycle, category setup, testing, badges and moving a provisional user
@@ -1,5 +1,15 @@
1
1
  # Rich Notifications
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Service Extension](#service-extension)
6
+ - [Attachments](#attachments)
7
+ - [Content Extension](#content-extension)
8
+ - [Communication Notifications](#communication-notifications)
9
+ - [Troubleshooting Extensions](#troubleshooting-extensions)
10
+ - [A Complete Service Extension](#a-complete-service-extension)
11
+ <!-- /toc -->
12
+
3
13
  Two app extensions shape how a notification looks:
4
14
 
5
15
  - **Notification Service Extension**: edits the content of a remote