@mmerterden/multi-agent-pipeline 20.34.0 → 20.35.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 (321) hide show
  1. package/CHANGELOG.md +55 -1
  2. package/README.md +1 -0
  3. package/docs/facts.json +2 -2
  4. package/install/catalog-history.json +1 -1
  5. package/install/claude.mjs +16 -1
  6. package/install/templates/claude-hooks.json +23 -1
  7. package/manifest.json +324 -293
  8. package/package.json +1 -1
  9. package/pipeline/agents/bulk-reader.md +3 -0
  10. package/pipeline/commands/multi-agent/channels/SKILL.md +1 -1
  11. package/pipeline/commands/multi-agent/office-on/SKILL.md +7 -3
  12. package/pipeline/commands/multi-agent/office-status/SKILL.md +3 -2
  13. package/pipeline/contract/CHANGELOG.md +9 -0
  14. package/pipeline/contract/README.md +1 -0
  15. package/pipeline/contract/fixtures/error-invalid-request.json +1 -1
  16. package/pipeline/contract/fixtures/error-unauthorized.json +1 -1
  17. package/pipeline/contract/fixtures/error-unsigned.json +1 -1
  18. package/pipeline/contract/manifest.json +14 -1
  19. package/pipeline/contract/types/index.d.ts +24 -2
  20. package/pipeline/lib/json-file-lock.mjs +61 -15
  21. package/pipeline/lib/office-remote.mjs +228 -0
  22. package/pipeline/lib/qr-code.mjs +360 -0
  23. package/pipeline/lib/repo-hygiene.sh +1 -0
  24. package/pipeline/lib/run-completion.mjs +17 -0
  25. package/pipeline/multi-agent-refs/channels/issue-comment.md +1 -1
  26. package/pipeline/multi-agent-refs/features/office-remote-protocol.md +166 -0
  27. package/pipeline/multi-agent-refs/features/office-threat-model.md +1 -1
  28. package/pipeline/multi-agent-refs/features/scope-check.md +16 -1
  29. package/pipeline/multi-agent-refs/features/verify-by-test.md +10 -0
  30. package/pipeline/multi-agent-refs/keychain.md +7 -0
  31. package/pipeline/multi-agent-refs/phases/phase-0-init.md +6 -2
  32. package/pipeline/multi-agent-refs/phases/phase-1-plan.md +4 -6
  33. package/pipeline/multi-agent-refs/phases/phase-2-dev.md +9 -12
  34. package/pipeline/multi-agent-refs/phases/phase-3-review.md +9 -8
  35. package/pipeline/multi-agent-refs/phases/phase-4-commit.md +1 -4
  36. package/pipeline/multi-agent-refs/rules.md +3 -2
  37. package/pipeline/multi-agent-refs/tracker-contract.md +1 -1
  38. package/pipeline/office/NOTICE.md +4 -1
  39. package/pipeline/office/assets/char_12.png +0 -0
  40. package/pipeline/office/assets/char_13.png +0 -0
  41. package/pipeline/office/assets/char_14.png +0 -0
  42. package/pipeline/office/assets/char_15.png +0 -0
  43. package/pipeline/office/assets/char_16.png +0 -0
  44. package/pipeline/office/assets/char_17.png +0 -0
  45. package/pipeline/office/assets/char_18.png +0 -0
  46. package/pipeline/office/assets/char_19.png +0 -0
  47. package/pipeline/office/assets/char_20.png +0 -0
  48. package/pipeline/office/assets/char_21.png +0 -0
  49. package/pipeline/office/assets/char_22.png +0 -0
  50. package/pipeline/office/assets/char_23.png +0 -0
  51. package/pipeline/office/assets/char_24.png +0 -0
  52. package/pipeline/office/assets/char_25.png +0 -0
  53. package/pipeline/office/assets/char_26.png +0 -0
  54. package/pipeline/office/assets/char_27.png +0 -0
  55. package/pipeline/office/assets/char_28.png +0 -0
  56. package/pipeline/office/assets/char_29.png +0 -0
  57. package/pipeline/office/assets/char_30.png +0 -0
  58. package/pipeline/office/index.html +293 -49
  59. package/pipeline/schemas/agent-state.schema.json +18 -0
  60. package/pipeline/schemas/planning-output.schema.json +18 -0
  61. package/pipeline/schemas/pr-reach.schema.json +55 -0
  62. package/pipeline/schemas/prefs.schema.json +13 -7
  63. package/pipeline/schemas/triage-output.schema.json +12 -1
  64. package/pipeline/schemas/unattended-policy.json +2 -1
  65. package/pipeline/scripts/_guard_rules.py +449 -1
  66. package/pipeline/scripts/_test-gaming.mjs +36 -0
  67. package/pipeline/scripts/agent-guard.py +79 -19
  68. package/pipeline/scripts/anonymize-findings.mjs +99 -0
  69. package/pipeline/scripts/answer-check.mjs +113 -0
  70. package/pipeline/scripts/answer-check.sh +20 -0
  71. package/pipeline/scripts/autopilot-publish.mjs +9 -2
  72. package/pipeline/scripts/contract-server.mjs +35 -1
  73. package/pipeline/scripts/gate-ledger.mjs +144 -21
  74. package/pipeline/scripts/office-build.mjs +276 -5
  75. package/pipeline/scripts/office-control.mjs +70 -10
  76. package/pipeline/scripts/office-pair.mjs +407 -0
  77. package/pipeline/scripts/office-remote-client.mjs +463 -0
  78. package/pipeline/scripts/phase-tracker.sh +8 -0
  79. package/pipeline/scripts/phase0-exit-gate.mjs +40 -37
  80. package/pipeline/scripts/phone-devices.mjs +9 -1
  81. package/pipeline/scripts/pre-commit-check.sh +28 -2
  82. package/pipeline/scripts/pre-push-check.sh +6 -12
  83. package/pipeline/scripts/rework-base.mjs +87 -0
  84. package/pipeline/scripts/run-commit-check.mjs +104 -0
  85. package/pipeline/scripts/run-scope-guard.mjs +58 -3
  86. package/pipeline/scripts/run-scope-guard.sh +13 -1
  87. package/pipeline/scripts/scope-check-gate.mjs +70 -6
  88. package/pipeline/scripts/task-mirror.mjs +106 -15
  89. package/pipeline/scripts/task-mirror.sh +3 -2
  90. package/pipeline/scripts/test-stability-gate.mjs +112 -0
  91. package/pipeline/scripts/update-check.sh +7 -1
  92. package/pipeline/scripts/update-issue-progress.sh +73 -8
  93. package/pipeline/scripts/validate-planning.mjs +105 -1
  94. package/pipeline/scripts/validate-triage.mjs +42 -2
  95. package/pipeline/scripts/work-items.mjs +119 -1
  96. package/pipeline/scripts/worktree-prepare-all.mjs +200 -0
  97. package/pipeline/scripts/worktree-prepare.sh +40 -4
  98. package/pipeline/scripts/write-state.mjs +67 -24
  99. package/pipeline/skills/.skill-manifest.json +5 -5
  100. package/pipeline/skills/shared/core/google-play-compliance/SKILL.md +5 -5
  101. package/pipeline/skills/shared/core/google-play-compliance/references/rules.yml +1 -1
  102. package/pipeline/skills/shared/core/multi-agent-channels/SKILL.md +1 -1
  103. package/pipeline/skills/shared/core/multi-agent-office-status/SKILL.md +2 -2
  104. package/pipeline/skills/shared/external/alarmkit/references/alarmkit-patterns.md +14 -0
  105. package/pipeline/skills/shared/external/android-architecture/references/patterns.md +6 -0
  106. package/pipeline/skills/shared/external/android-build-quality-gates/references/patterns.md +10 -0
  107. package/pipeline/skills/shared/external/android-datastore/references/patterns.md +11 -0
  108. package/pipeline/skills/shared/external/android-design-tokens-codegen/references/patterns.md +8 -0
  109. package/pipeline/skills/shared/external/android-jetpack-compose-expert/references/patterns.md +6 -0
  110. package/pipeline/skills/shared/external/android-mvi-viewmodel/references/patterns.md +10 -0
  111. package/pipeline/skills/shared/external/android-performance/references/patterns.md +13 -0
  112. package/pipeline/skills/shared/external/android-security/references/patterns.md +16 -0
  113. package/pipeline/skills/shared/external/api-patterns/references/contract-details.md +9 -0
  114. package/pipeline/skills/shared/external/api-security-best-practices/references/abuse-controls.md +12 -0
  115. package/pipeline/skills/shared/external/api-security-best-practices/references/identity-and-access.md +13 -0
  116. package/pipeline/skills/shared/external/api-security-best-practices/references/request-handling.md +12 -0
  117. package/pipeline/skills/shared/external/app-clips/references/data-handoff-notifications-location.md +9 -0
  118. package/pipeline/skills/shared/external/app-clips/references/routing-and-experiences.md +8 -0
  119. package/pipeline/skills/shared/external/app-clips/references/size-capabilities-and-promotion.md +10 -0
  120. package/pipeline/skills/shared/external/app-intents/references/appintents-advanced.md +21 -0
  121. package/pipeline/skills/shared/external/app-store-optimization/references/keyword-research-methodology.md +9 -0
  122. package/pipeline/skills/shared/external/app-store-optimization/references/product-page-variants.md +7 -0
  123. package/pipeline/skills/shared/external/app-store-review/SKILL.md +2 -2
  124. package/pipeline/skills/shared/external/app-store-review/references/privacy-manifest.md +10 -0
  125. package/pipeline/skills/shared/external/app-store-review/references/review-checklists.md +10 -1
  126. package/pipeline/skills/shared/external/apple-on-device-ai/references/coreml-conversion.md +22 -0
  127. package/pipeline/skills/shared/external/apple-on-device-ai/references/coreml-optimization.md +17 -0
  128. package/pipeline/skills/shared/external/apple-on-device-ai/references/foundation-models.md +22 -0
  129. package/pipeline/skills/shared/external/apple-on-device-ai/references/mlx-swift.md +17 -0
  130. package/pipeline/skills/shared/external/authentication/references/keychain-biometric.md +9 -0
  131. package/pipeline/skills/shared/external/authentication/references/passkeys.md +11 -0
  132. package/pipeline/skills/shared/external/avkit/references/avkit-patterns.md +13 -0
  133. package/pipeline/skills/shared/external/background-processing/references/background-task-patterns.md +9 -0
  134. package/pipeline/skills/shared/external/callkit-voip/references/callkit-patterns.md +10 -0
  135. package/pipeline/skills/shared/external/cloudkit-sync/references/cloudkit-patterns.md +15 -0
  136. package/pipeline/skills/shared/external/compose-components/references/patterns.md +7 -0
  137. package/pipeline/skills/shared/external/compose-navigation/references/patterns.md +7 -0
  138. package/pipeline/skills/shared/external/compose-testing/references/patterns.md +15 -0
  139. package/pipeline/skills/shared/external/contacts-framework/references/contacts-patterns.md +9 -0
  140. package/pipeline/skills/shared/external/core-bluetooth/references/ble-patterns.md +11 -0
  141. package/pipeline/skills/shared/external/core-motion/references/motion-patterns.md +10 -0
  142. package/pipeline/skills/shared/external/core-nfc/references/nfc-patterns.md +13 -0
  143. package/pipeline/skills/shared/external/coreml/references/coreml-swift-integration.md +20 -0
  144. package/pipeline/skills/shared/external/cryptokit/references/cryptokit-patterns.md +16 -0
  145. package/pipeline/skills/shared/external/debugging-instruments/references/instruments-guide.md +16 -0
  146. package/pipeline/skills/shared/external/debugging-instruments/references/lldb-patterns.md +14 -0
  147. package/pipeline/skills/shared/external/device-integrity/references/device-integrity-patterns.md +13 -0
  148. package/pipeline/skills/shared/external/energykit/references/energykit-patterns.md +10 -0
  149. package/pipeline/skills/shared/external/eventkit-calendar/references/eventkit-patterns.md +10 -0
  150. package/pipeline/skills/shared/external/fastapi-pro/references/app-structure.md +10 -0
  151. package/pipeline/skills/shared/external/gradle-kotlin-dsl/references/patterns.md +17 -0
  152. package/pipeline/skills/shared/external/healthkit/references/healthkit-patterns.md +12 -0
  153. package/pipeline/skills/shared/external/hig-app-icons/references/icon-workflow.md +10 -0
  154. package/pipeline/skills/shared/external/hig-components-content/references/content-views.md +10 -0
  155. package/pipeline/skills/shared/external/hig-components-layout/references/bars-and-tabs.md +11 -0
  156. package/pipeline/skills/shared/external/hig-foundations/references/foundations-detail.md +13 -0
  157. package/pipeline/skills/shared/external/hig-foundations/references/type-color-spacing.md +13 -0
  158. package/pipeline/skills/shared/external/hig-patterns/references/onboarding-and-states.md +11 -0
  159. package/pipeline/skills/shared/external/hig-platforms/references/ipad-layout.md +12 -0
  160. package/pipeline/skills/shared/external/hig-technologies/references/technologies.md +16 -0
  161. package/pipeline/skills/shared/external/homekit-matter/references/matter-commissioning.md +9 -0
  162. package/pipeline/skills/shared/external/ios-accessibility/references/a11y-patterns.md +18 -0
  163. package/pipeline/skills/shared/external/ios-accessibility/references/large-content-and-appearance.md +9 -0
  164. package/pipeline/skills/shared/external/ios-accessibility/references/media-accessibility.md +9 -0
  165. package/pipeline/skills/shared/external/ios-accessibility/references/nutrition-labels.md +7 -0
  166. package/pipeline/skills/shared/external/ios-coding-standard/references/STANDARD.md +13 -0
  167. package/pipeline/skills/shared/external/ios-design-review/references/appearance-matrix.md +9 -0
  168. package/pipeline/skills/shared/external/ios-design-review/references/checklist.md +15 -0
  169. package/pipeline/skills/shared/external/ios-haptics/references/core-haptics.md +11 -0
  170. package/pipeline/skills/shared/external/ios-iphone-duo/references/api-map.md +11 -0
  171. package/pipeline/skills/shared/external/ios-iphone-duo/references/fixed-assumptions.md +15 -0
  172. package/pipeline/skills/shared/external/ios-iphone-duo/references/poses-and-panes.md +11 -0
  173. package/pipeline/skills/shared/external/ios-localization/references/formatstyle-locale.md +18 -0
  174. package/pipeline/skills/shared/external/ios-localization/references/string-catalogs.md +19 -0
  175. package/pipeline/skills/shared/external/ios-networking/references/background-websocket.md +15 -0
  176. package/pipeline/skills/shared/external/ios-networking/references/file-storage-patterns.md +7 -0
  177. package/pipeline/skills/shared/external/ios-networking/references/lightweight-clients.md +8 -0
  178. package/pipeline/skills/shared/external/ios-networking/references/network-framework.md +12 -0
  179. package/pipeline/skills/shared/external/ios-networking/references/urlsession-patterns.md +17 -0
  180. package/pipeline/skills/shared/external/ios-security/references/app-review-guidelines.md +8 -0
  181. package/pipeline/skills/shared/external/ios-security/references/cryptokit-advanced.md +14 -0
  182. package/pipeline/skills/shared/external/ios-security/references/file-storage-patterns.md +8 -0
  183. package/pipeline/skills/shared/external/ios-security/references/privacy-manifest.md +9 -0
  184. package/pipeline/skills/shared/external/ios-sf-symbols/references/effects-and-custom-symbols.md +9 -0
  185. package/pipeline/skills/shared/external/ios-simulator/references/simctl-commands.md +13 -0
  186. package/pipeline/skills/shared/external/kotlin-coroutines-expert/references/patterns.md +8 -0
  187. package/pipeline/skills/shared/external/live-activities/references/activitykit-patterns.md +21 -0
  188. package/pipeline/skills/shared/external/localization-reuse-map/reference/format-and-output.md +9 -0
  189. package/pipeline/skills/shared/external/localization-reuse-map/reference/sources-and-recipes.md +12 -0
  190. package/pipeline/skills/shared/external/mapkit-location/references/mapkit-corelocation-patterns.md +16 -0
  191. package/pipeline/skills/shared/external/mapkit-location/references/mapkit-patterns.md +21 -0
  192. package/pipeline/skills/shared/external/metrickit-diagnostics/references/metrickit-patterns.md +10 -0
  193. package/pipeline/skills/shared/external/musickit-audio/references/musickit-patterns.md +9 -0
  194. package/pipeline/skills/shared/external/natural-language/references/translation-patterns.md +12 -0
  195. package/pipeline/skills/shared/external/nodejs-backend-patterns/references/runtime-patterns.md +11 -0
  196. package/pipeline/skills/shared/external/passkit-wallet/references/wallet-passes.md +11 -0
  197. package/pipeline/skills/shared/external/pdfkit/references/pdfkit-patterns.md +18 -0
  198. package/pipeline/skills/shared/external/pencilkit-drawing/references/pencilkit-patterns.md +11 -0
  199. package/pipeline/skills/shared/external/permissionkit/references/permissionkit-patterns.md +11 -0
  200. package/pipeline/skills/shared/external/photos-camera-media/references/av-playback.md +15 -0
  201. package/pipeline/skills/shared/external/photos-camera-media/references/camera-capture.md +14 -0
  202. package/pipeline/skills/shared/external/photos-camera-media/references/image-loading-caching.md +14 -0
  203. package/pipeline/skills/shared/external/photos-camera-media/references/photokit-patterns.md +14 -0
  204. package/pipeline/skills/shared/external/push-notifications/references/notification-patterns.md +14 -0
  205. package/pipeline/skills/shared/external/push-notifications/references/rich-notifications.md +10 -0
  206. package/pipeline/skills/shared/external/realitykit-ar/references/realitykit-patterns.md +12 -0
  207. package/pipeline/skills/shared/external/retrofit-networking/references/patterns.md +14 -0
  208. package/pipeline/skills/shared/external/room-database/references/patterns.md +16 -0
  209. package/pipeline/skills/shared/external/shareplay-activities/references/shareplay-patterns.md +10 -0
  210. package/pipeline/skills/shared/external/speech-recognition/references/speechanalyzer-patterns.md +10 -0
  211. package/pipeline/skills/shared/external/spm-build-analysis/references/build-optimization-sources.md +14 -0
  212. package/pipeline/skills/shared/external/spm-build-analysis/references/spm-analysis-checks.md +19 -0
  213. package/pipeline/skills/shared/external/storekit/references/core-patterns.md +13 -0
  214. package/pipeline/skills/shared/external/storekit/references/storekit-advanced.md +31 -0
  215. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/argument-labels-and-parameters.md +8 -0
  216. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/conventions-and-special-rules.md +9 -0
  217. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/naming-and-clarity.md +10 -0
  218. package/pipeline/skills/shared/external/swift-api-design-guidelines/references/side-effects-and-mutating-pairs.md +8 -0
  219. package/pipeline/skills/shared/external/swift-charts/references/charts-patterns.md +24 -0
  220. package/pipeline/skills/shared/external/swift-concurrency/references/bridging-interop.md +8 -0
  221. package/pipeline/skills/shared/external/swift-concurrency/references/concurrency-patterns.md +14 -0
  222. package/pipeline/skills/shared/external/swift-concurrency/references/swiftui-concurrency.md +12 -0
  223. package/pipeline/skills/shared/external/swift-concurrency/references/synchronization-primitives.md +10 -0
  224. package/pipeline/skills/shared/external/swift-concurrency-expert/references/swift-6-2-concurrency.md +8 -0
  225. package/pipeline/skills/shared/external/swift-concurrency-pro/references/actors.md +10 -0
  226. package/pipeline/skills/shared/external/swift-concurrency-pro/references/cancellation.md +7 -0
  227. package/pipeline/skills/shared/external/swift-concurrency-pro/references/interop.md +10 -0
  228. package/pipeline/skills/shared/external/swift-concurrency-pro/references/new-features.md +11 -0
  229. package/pipeline/skills/shared/external/swift-concurrency-pro/references/structured.md +9 -0
  230. package/pipeline/skills/shared/external/swift-concurrency-pro/references/testing.md +13 -0
  231. package/pipeline/skills/shared/external/swift-language/references/swift-attributes-interop.md +7 -0
  232. package/pipeline/skills/shared/external/swift-language/references/swift-patterns-extended.md +14 -0
  233. package/pipeline/skills/shared/external/swift-security/references/biometric-authentication.md +16 -0
  234. package/pipeline/skills/shared/external/swift-security/references/certificate-trust.md +17 -0
  235. package/pipeline/skills/shared/external/swift-security/references/common-anti-patterns.md +19 -0
  236. package/pipeline/skills/shared/external/swift-security/references/compliance-owasp-mapping.md +16 -0
  237. package/pipeline/skills/shared/external/swift-security/references/credential-storage-patterns.md +19 -0
  238. package/pipeline/skills/shared/external/swift-security/references/cryptokit-public-key.md +18 -0
  239. package/pipeline/skills/shared/external/swift-security/references/cryptokit-symmetric.md +16 -0
  240. package/pipeline/skills/shared/external/swift-security/references/keychain-access-control.md +17 -0
  241. package/pipeline/skills/shared/external/swift-security/references/keychain-fundamentals.md +17 -0
  242. package/pipeline/skills/shared/external/swift-security/references/keychain-item-classes.md +17 -0
  243. package/pipeline/skills/shared/external/swift-security/references/keychain-sharing.md +18 -0
  244. package/pipeline/skills/shared/external/swift-security/references/migration-legacy-stores.md +21 -0
  245. package/pipeline/skills/shared/external/swift-security/references/secure-enclave.md +16 -0
  246. package/pipeline/skills/shared/external/swift-security/references/testing-security-code.md +16 -0
  247. package/pipeline/skills/shared/external/swift-testing/references/testing-advanced.md +9 -0
  248. package/pipeline/skills/shared/external/swift-testing/references/testing-patterns.md +24 -0
  249. package/pipeline/skills/shared/external/swift-testing-pro/references/async-tests.md +9 -0
  250. package/pipeline/skills/shared/external/swift-testing-pro/references/new-features.md +11 -0
  251. package/pipeline/skills/shared/external/swift-testing-pro/references/writing-better-tests.md +13 -0
  252. package/pipeline/skills/shared/external/swiftdata/references/core-data-coexistence.md +8 -0
  253. package/pipeline/skills/shared/external/swiftdata/references/swiftdata-advanced.md +17 -0
  254. package/pipeline/skills/shared/external/swiftdata/references/swiftdata-queries.md +12 -0
  255. package/pipeline/skills/shared/external/swiftlint/references/adoption-and-configuration.md +11 -0
  256. package/pipeline/skills/shared/external/swiftlint/references/custom-rules-and-analyze.md +7 -0
  257. package/pipeline/skills/shared/external/swiftlint/references/plugins-run-scripts-and-integrations.md +13 -0
  258. package/pipeline/skills/shared/external/swiftlint/references/rule-reference.md +24 -0
  259. package/pipeline/skills/shared/external/swiftlint/references/rules-suppressions-and-baselines.md +12 -0
  260. package/pipeline/skills/shared/external/swiftui-animation/references/animation-advanced.md +15 -0
  261. package/pipeline/skills/shared/external/swiftui-animation/references/core-animation-bridge.md +15 -0
  262. package/pipeline/skills/shared/external/swiftui-animation/references/scroll-effects.md +12 -0
  263. package/pipeline/skills/shared/external/swiftui-expert-skill/references/accessibility-patterns.md +11 -0
  264. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-advanced.md +7 -0
  265. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-basics.md +13 -0
  266. package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-transitions.md +9 -0
  267. package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts-accessibility.md +9 -0
  268. package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts.md +17 -0
  269. package/pipeline/skills/shared/external/swiftui-expert-skill/references/image-optimization.md +9 -0
  270. package/pipeline/skills/shared/external/swiftui-expert-skill/references/latest-apis.md +10 -0
  271. package/pipeline/skills/shared/external/swiftui-expert-skill/references/layout-best-practices.md +12 -0
  272. package/pipeline/skills/shared/external/swiftui-expert-skill/references/list-patterns.md +12 -0
  273. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-scenes.md +13 -0
  274. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-views.md +12 -0
  275. package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-window-styling.md +12 -0
  276. package/pipeline/skills/shared/external/swiftui-expert-skill/references/performance-patterns.md +7 -0
  277. package/pipeline/skills/shared/external/swiftui-expert-skill/references/scroll-patterns.md +9 -0
  278. package/pipeline/skills/shared/external/swiftui-expert-skill/references/sheet-navigation-patterns.md +10 -0
  279. package/pipeline/skills/shared/external/swiftui-expert-skill/references/state-management.md +18 -0
  280. package/pipeline/skills/shared/external/swiftui-expert-skill/references/view-structure.md +16 -0
  281. package/pipeline/skills/shared/external/swiftui-gestures/references/gesture-patterns.md +11 -0
  282. package/pipeline/skills/shared/external/swiftui-layout-components/references/form.md +8 -0
  283. package/pipeline/skills/shared/external/swiftui-layout-components/references/grids.md +14 -0
  284. package/pipeline/skills/shared/external/swiftui-layout-components/references/scrollview.md +9 -0
  285. package/pipeline/skills/shared/external/swiftui-liquid-glass/references/liquid-glass.md +22 -0
  286. package/pipeline/skills/shared/external/swiftui-liquid-glass/references/uikit-glass.md +14 -0
  287. package/pipeline/skills/shared/external/swiftui-navigation/references/deeplinks.md +10 -0
  288. package/pipeline/skills/shared/external/swiftui-navigation/references/navigationstack.md +10 -0
  289. package/pipeline/skills/shared/external/swiftui-navigation/references/sheets.md +13 -0
  290. package/pipeline/skills/shared/external/swiftui-navigation/references/tabview.md +10 -0
  291. package/pipeline/skills/shared/external/swiftui-patterns/references/architecture-patterns.md +14 -0
  292. package/pipeline/skills/shared/external/swiftui-patterns/references/deprecated-migration.md +30 -0
  293. package/pipeline/skills/shared/external/swiftui-patterns/references/platform-and-sharing.md +16 -0
  294. package/pipeline/skills/shared/external/swiftui-performance/references/demystify-swiftui-performance-wwdc23.md +11 -0
  295. package/pipeline/skills/shared/external/swiftui-performance/references/optimizing-swiftui-performance-instruments.md +11 -0
  296. package/pipeline/skills/shared/external/swiftui-performance/references/understanding-hangs-in-your-app.md +10 -0
  297. package/pipeline/skills/shared/external/swiftui-performance-audit/references/code-smells.md +8 -0
  298. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/app-wiring.md +12 -0
  299. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/menu-bar.md +10 -0
  300. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/navigationstack.md +11 -0
  301. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/scroll-reveal.md +12 -0
  302. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/sheets.md +14 -0
  303. package/pipeline/skills/shared/external/swiftui-ui-patterns/references/tabview.md +10 -0
  304. package/pipeline/skills/shared/external/swiftui-uikit-interop/references/hosting-migration.md +10 -0
  305. package/pipeline/skills/shared/external/swiftui-uikit-interop/references/representable-recipes.md +13 -0
  306. package/pipeline/skills/shared/external/swiftui-view-refactor/references/mv-patterns.md +12 -0
  307. package/pipeline/skills/shared/external/swiftui-webkit/references/loading-and-observation.md +8 -0
  308. package/pipeline/skills/shared/external/swiftui-webkit/references/navigation-and-javascript.md +8 -0
  309. package/pipeline/skills/shared/external/tipkit/references/tipkit-patterns.md +14 -0
  310. package/pipeline/skills/shared/external/vision-framework/references/vision-requests.md +17 -0
  311. package/pipeline/skills/shared/external/vision-framework/references/visionkit-scanner.md +11 -0
  312. package/pipeline/skills/shared/external/weatherkit/references/weatherkit-patterns.md +11 -0
  313. package/pipeline/skills/shared/external/widgetkit/references/widgetkit-advanced.md +27 -0
  314. package/pipeline/skills/shared/external/xcode-build-fixer/references/build-settings-best-practices.md +9 -0
  315. package/pipeline/skills/shared/external/xcode-build-fixer/references/fix-patterns.md +7 -0
  316. package/pipeline/skills/shared/external/xcode-build-orchestrator/references/build-settings-best-practices.md +9 -0
  317. package/pipeline/skills/shared/external/xcode-compilation-analyzer/references/build-optimization-sources.md +14 -0
  318. package/pipeline/skills/shared/external/xcode-compilation-analyzer/references/code-compilation-checks.md +8 -0
  319. package/pipeline/skills/shared/external/xcode-project-analyzer/references/build-optimization-sources.md +14 -0
  320. package/pipeline/skills/shared/external/xcode-project-analyzer/references/build-settings-best-practices.md +9 -0
  321. package/pipeline/skills/shared/external/xcode-project-analyzer/references/project-audit-checks.md +13 -0
@@ -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
@@ -1,5 +1,17 @@
1
1
  # RealityKit Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Physics](#physics)
6
+ - [Animation](#animation)
7
+ - [Materials and lighting](#materials-and-lighting)
8
+ - [Custom components and systems](#custom-components-and-systems)
9
+ - [Occlusion and environment](#occlusion-and-environment)
10
+ - [A SwiftUI model viewer](#a-swiftui-model-viewer)
11
+ - [Entity accessibility](#entity-accessibility)
12
+ - [Performance](#performance)
13
+ <!-- /toc -->
14
+
3
15
  Longer examples for the `realitykit-ar` skill. SKILL.md covers setup, anchoring,
4
16
  raycasting and gestures; this file goes deeper.
5
17
 
@@ -1,5 +1,19 @@
1
1
  # Retrofit Networking -- Reference Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [API Interface](#api-interface)
6
+ - [Retrofit Setup with Hilt](#retrofit-setup-with-hilt)
7
+ - [OkHttp Interceptors](#okhttp-interceptors)
8
+ - [Error Handling](#error-handling)
9
+ - [Network-Bound Resource](#network-bound-resource)
10
+ - [Multipart Uploads](#multipart-uploads)
11
+ - [WebSocket Support](#websocket-support)
12
+ - [Envelope to Typed Exception](#envelope-to-typed-exception)
13
+ - [Unknown-Tolerant Enum Serialization](#unknown-tolerant-enum-serialization)
14
+ - [Client Composition and Environment Config](#client-composition-and-environment-config)
15
+ <!-- /toc -->
16
+
3
17
  Full code for the patterns summarized in `SKILL.md`. Load the section you need
4
18
  when implementing that part of the networking layer.
5
19
 
@@ -1,5 +1,21 @@
1
1
  # Room Database Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Entity Definition](#entity-definition)
6
+ - [DAO Interface](#dao-interface)
7
+ - [Database Setup](#database-setup)
8
+ - [Reactive Queries with Flow](#reactive-queries-with-flow)
9
+ - [TypeConverters](#typeconverters)
10
+ - [Relations](#relations)
11
+ - [Migration Strategies](#migration-strategies)
12
+ - [Hilt Integration](#hilt-integration)
13
+ - [Testing with In-Memory Database](#testing-with-in-memory-database)
14
+ - [Encrypted Database (SQLCipher)](#encrypted-database-sqlcipher)
15
+ - [Async Database Provisioning](#async-database-provisioning)
16
+ - [Runtime Hygiene](#runtime-hygiene)
17
+ <!-- /toc -->
18
+
3
19
  Full code examples backing the guidance in `SKILL.md`. Headings mirror the
4
20
  SKILL.md sections.
5
21
 
@@ -1,5 +1,15 @@
1
1
  # SharePlay Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [A shared sticky-note board](#a-shared-sticky-note-board)
6
+ - [A reusable manager](#a-reusable-manager)
7
+ - [SwiftUI entry points](#swiftui-entry-points)
8
+ - [Syncing game state, including late joiners](#syncing-game-state-including-late-joiners)
9
+ - [Tracking who joins and leaves](#tracking-who-joins-and-leaves)
10
+ - [Nearby participants on visionOS](#nearby-participants-on-visionos)
11
+ <!-- /toc -->
12
+
3
13
  Longer examples for the `shareplay-activities` skill. SKILL.md covers setup,
4
14
  the session lifecycle and the messenger basics; this file builds on them.
5
15
 
@@ -1,5 +1,15 @@
1
1
  # SpeechAnalyzer patterns (iOS 26+)
2
2
 
3
+ <!-- toc -->
4
+ - [Picking modules](#picking-modules)
5
+ - [Model assets](#model-assets)
6
+ - [Transcribing a file](#transcribing-a-file)
7
+ - [Live audio](#live-audio)
8
+ - [Reading results](#reading-results)
9
+ - [Ending a session](#ending-a-session)
10
+ - [Further reading](#further-reading)
11
+ <!-- /toc -->
12
+
3
13
  Companion to the `speech-recognition` skill ([../SKILL.md](../SKILL.md)).
4
14
  Every API here needs iOS 26 or later.
5
15
 
@@ -1,5 +1,19 @@
1
1
  # Build Optimization Sources
2
2
 
3
+ <!-- toc -->
4
+ - [Apple: Improving the speed of incremental builds](#apple-improving-the-speed-of-incremental-builds)
5
+ - [Apple: Improving build efficiency with good coding practices](#apple-improving-build-efficiency-with-good-coding-practices)
6
+ - [Apple: Building your project with explicit module dependencies](#apple-building-your-project-with-explicit-module-dependencies)
7
+ - [SwiftLee: Build performance analysis for speeding up Xcode builds](#swiftlee-build-performance-analysis-for-speeding-up-xcode-builds)
8
+ - [Apple: Xcode Release Notes -- Compilation Caching](#apple-xcode-release-notes----compilation-caching)
9
+ - [Apple: Demystify explicitly built modules (WWDC24)](#apple-demystify-explicitly-built-modules-wwdc24)
10
+ - [Swift Compile-Time Best Practices](#swift-compile-time-best-practices)
11
+ - [Bitrise: Demystifying Explicitly Built Modules for Xcode](#bitrise-demystifying-explicitly-built-modules-for-xcode)
12
+ - [Bitrise: Xcode Compilation Cache FAQ](#bitrise-xcode-compilation-cache-faq)
13
+ - [RocketSim Docs: Build Insights](#rocketsim-docs-build-insights)
14
+ - [Swift Forums: Slow incremental builds because of planning swift module](#swift-forums-slow-incremental-builds-because-of-planning-swift-module)
15
+ <!-- /toc -->
16
+
3
17
  This file stores the external sources that the README and skill docs should cite consistently.
4
18
 
5
19
  ## Apple: Improving the speed of incremental builds
@@ -1,5 +1,24 @@
1
1
  # SPM Analysis Checks
2
2
 
3
+ <!-- toc -->
4
+ - [Package Graph Checks](#package-graph-checks)
5
+ - [Package Plugin Checks](#package-plugin-checks)
6
+ - [Package Reference Verification](#package-reference-verification)
7
+ - [Version Pin Feasibility](#version-pin-feasibility)
8
+ - [Binary And Remote Dependency Checks](#binary-and-remote-dependency-checks)
9
+ - [Module Variant Checks](#module-variant-checks)
10
+ - [Layered Architecture Validation](#layered-architecture-validation)
11
+ - [Circular Dependency Detection](#circular-dependency-detection)
12
+ - [Module Sizing Guidance](#module-sizing-guidance)
13
+ - [Transitive Dependency Minimization](#transitive-dependency-minimization)
14
+ - [Interface/Implementation Separation](#interfaceimplementation-separation)
15
+ - [Test Target Isolation](#test-target-isolation)
16
+ - [Swift Macro Rebuild Impact](#swift-macro-rebuild-impact)
17
+ - [Multi-Platform Build Multiplication](#multi-platform-build-multiplication)
18
+ - [CI-Specific Checks](#ci-specific-checks)
19
+ - [Recommendation Prioritization](#recommendation-prioritization)
20
+ <!-- /toc -->
21
+
3
22
  Use this reference when package dependencies or package plugins are suspected build bottlenecks.
4
23
 
5
24
  ## Package Graph Checks
@@ -1,5 +1,18 @@
1
1
  # StoreKit 2 Core Patterns
2
2
 
3
+ <!-- toc -->
4
+ - [Contents](#contents)
5
+ - [Buying with PurchaseAction](#buying-with-purchaseaction)
6
+ - [Launch-Time Transaction Listener](#launch-time-transaction-listener)
7
+ - [Computing Entitlements](#computing-entitlements)
8
+ - [Subscription Paywall](#subscription-paywall)
9
+ - [Product Shelves: StoreView and ProductView](#product-shelves-storeview-and-productview)
10
+ - [Is a Plan Active?](#is-a-plan-active)
11
+ - [Verifying the Install with AppTransaction](#verifying-the-install-with-apptransaction)
12
+ - [Store View Callbacks](#store-view-callbacks)
13
+ - [Ten Mistakes, Fixed](#ten-mistakes-fixed)
14
+ <!-- /toc -->
15
+
3
16
  Complete, copyable code for the core flows, followed by the ten common
4
17
  mistakes with a wrong and a right version each. Control styles, offers,
5
18
  testing, server validation and subscription edge cases are in