reis-mobile 0.3.6 → 0.4.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 (463) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +24 -0
  4. package/README.md +175 -168
  5. package/THIRD_PARTY_NOTICES.md +224 -4
  6. package/agents/android-architect.md +89 -0
  7. package/agents/android-performance-engineer.md +92 -0
  8. package/agents/android-test-engineer.md +97 -0
  9. package/agents/flutter-test-engineer.md +2 -0
  10. package/agents/ios-architect.md +93 -0
  11. package/agents/ios-performance-engineer.md +92 -0
  12. package/agents/ios-test-engineer.md +95 -0
  13. package/agents/lead-mobile.md +10 -1
  14. package/agents/mobile-staff-engineer.md +1 -1
  15. package/agents/rn-architect.md +94 -0
  16. package/agents/rn-performance-engineer.md +92 -0
  17. package/agents/rn-test-engineer.md +98 -0
  18. package/bin/reis-mobile.mjs +59 -17
  19. package/commands/debate.md +10 -1
  20. package/commands/debug.md +60 -0
  21. package/commands/reis-mobile.md +7 -2
  22. package/core/config/project.mjs +59 -0
  23. package/core/registry/frontmatter.mjs +15 -4
  24. package/core/registry/registry.mjs +21 -1
  25. package/core/router/intents.mjs +2 -0
  26. package/core/router/router.mjs +10 -5
  27. package/package.json +1 -1
  28. package/skills/android-adaptive/SKILL.md +304 -0
  29. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/flexbox/container-behavior.md +112 -0
  30. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/flexbox/get-started.md +69 -0
  31. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/flexbox/index.md +81 -0
  32. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/flexbox/item-behavior.md +170 -0
  33. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/grid/container-properties.md +415 -0
  34. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/grid/get-started.md +51 -0
  35. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/grid/index.md +73 -0
  36. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/grid/item-properties.md +170 -0
  37. package/skills/android-adaptive/references/android/develop/ui/compose/layouts/adaptive/mediaquery/index.md +333 -0
  38. package/skills/android-adaptive/references/android/develop/ui/compose/tooling/debug.md +114 -0
  39. package/skills/android-adaptive/references/android/guide/navigation/navigation-3/recipes/material-listdetail.md +141 -0
  40. package/skills/android-agp-9-upgrade/SKILL.md +106 -0
  41. package/skills/android-agp-9-upgrade/references/android/build/migrate-to-built-in-kotlin.md +416 -0
  42. package/skills/android-agp-9-upgrade/references/android/build/releases/agp-9-0-0-release-notes.md +554 -0
  43. package/skills/android-agp-9-upgrade/references/buildconfig.md +54 -0
  44. package/skills/android-agp-9-upgrade/references/ksp-kapt.md +39 -0
  45. package/skills/android-agp-9-upgrade/references/paparazzi-gradle-9.md +30 -0
  46. package/skills/android-agp-9-upgrade/references/recipes.md +62 -0
  47. package/skills/android-appfunctions/SKILL.md +74 -0
  48. package/skills/android-appfunctions/references/adb-interaction-testing.md +95 -0
  49. package/skills/android-appfunctions/references/context.md +26 -0
  50. package/skills/android-appfunctions/references/feature-discovery-analysis.md +71 -0
  51. package/skills/android-appfunctions/references/implementation-configuration.md +282 -0
  52. package/skills/android-appfunctions/references/kdoc-refinement-optimization.md +75 -0
  53. package/skills/android-appfunctions/references/migrate-to-service-entry-point.md +226 -0
  54. package/skills/android-camerax/SKILL.md +135 -0
  55. package/skills/android-camerax/references/camera1-to-camerax.md +198 -0
  56. package/skills/android-camerax/references/camera2-to-camerax.md +193 -0
  57. package/skills/android-camerax/references/expert-blueprints.md +58 -0
  58. package/skills/android-camerax/references/foldables.md +83 -0
  59. package/skills/android-camerax/references/immutability.md +60 -0
  60. package/skills/android-camerax/references/low-light.md +124 -0
  61. package/skills/android-camerax/references/mlkit-spatial.md +75 -0
  62. package/skills/android-camerax/references/modern-apis.md +42 -0
  63. package/skills/android-camerax/references/testing.md +69 -0
  64. package/skills/android-camerax/references/thermals.md +85 -0
  65. package/skills/android-camerax/references/wear-os.md +76 -0
  66. package/skills/android-camerax/references/xr.md +54 -0
  67. package/skills/android-cli/SKILL.md +474 -0
  68. package/skills/android-cli/references/interact.md +113 -0
  69. package/skills/android-cli/references/journeys.md +120 -0
  70. package/skills/android-code-review/SKILL.md +58 -0
  71. package/skills/android-display-glasses-with-jetpack-compose-glimmer/SKILL.md +340 -0
  72. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/design/ui/ai-glasses/guides/interaction/inputs.md +67 -0
  73. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/access-hardware-projected-context.md +388 -0
  74. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/buttons.md +139 -0
  75. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/cards.md +148 -0
  76. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/focus.md +107 -0
  77. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/icons.md +90 -0
  78. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/text.md +69 -0
  79. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/jetpack-compose-glimmer/title-chips.md +82 -0
  80. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/android/develop/xr/jetpack-xr-sdk/request-hardware-permissions.md +213 -0
  81. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/button-samples-source.md +176 -0
  82. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/button-source.md +203 -0
  83. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/card-samples-source.md +296 -0
  84. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/card-source.md +515 -0
  85. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/deptheffect-source.md +224 -0
  86. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/deptheffectlevels-source.md +105 -0
  87. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/glimmersansflextypography-source.md +270 -0
  88. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/glimmertheme-source.md +182 -0
  89. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/icon-source.md +388 -0
  90. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/iconbutton-source.md +126 -0
  91. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/iconsizes-source.md +78 -0
  92. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/list-source.md +27 -0
  93. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/listitem-source.md +272 -0
  94. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/liststate-source.md +427 -0
  95. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/material-hct-source.md +217 -0
  96. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/projectedcontext-source.md +265 -0
  97. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/stack-source.md +368 -0
  98. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/stackitemscope-source.md +440 -0
  99. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/stackstate-source.md +325 -0
  100. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/surface-source.md +1211 -0
  101. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/titlechip-samples-source.md +101 -0
  102. package/skills/android-display-glasses-with-jetpack-compose-glimmer/references/titlechip-source.md +131 -0
  103. package/skills/android-edge-to-edge/SKILL.md +429 -0
  104. package/skills/android-engage-sdk-integration/SKILL.md +130 -0
  105. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/faq.md +439 -0
  106. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/food.md +1149 -0
  107. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/healthandfitness.md +1055 -0
  108. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/listen.md +1050 -0
  109. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/otherverticals.md +1301 -0
  110. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/read.md +910 -0
  111. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/shopping.md +1224 -0
  112. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/social.md +719 -0
  113. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/travel.md +1413 -0
  114. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/tv/continue-watching/index.md +19 -0
  115. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/tv/entitlements.md +353 -0
  116. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/tv/getting-started.md +202 -0
  117. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/tv/recommendations.md +471 -0
  118. package/skills/android-engage-sdk-integration/references/android/guide/playcore/engage/watch.md +1081 -0
  119. package/skills/android-engage-sdk-integration/references/clusters.md +154 -0
  120. package/skills/android-engage-sdk-integration/references/common.md +519 -0
  121. package/skills/android-engage-sdk-integration/references/patterns.md +527 -0
  122. package/skills/android-engage-sdk-integration/references/requests.md +260 -0
  123. package/skills/android-engage-sdk-integration/references/schemas/food.md +509 -0
  124. package/skills/android-engage-sdk-integration/references/schemas/listen.md +842 -0
  125. package/skills/android-engage-sdk-integration/references/schemas/other.md +220 -0
  126. package/skills/android-engage-sdk-integration/references/schemas/read.md +412 -0
  127. package/skills/android-engage-sdk-integration/references/schemas/shopping.md +357 -0
  128. package/skills/android-engage-sdk-integration/references/schemas/social.md +228 -0
  129. package/skills/android-engage-sdk-integration/references/schemas/travel.md +923 -0
  130. package/skills/android-engage-sdk-integration/references/schemas/tv.md +1226 -0
  131. package/skills/android-engage-sdk-integration/references/schemas/watch.md +1137 -0
  132. package/skills/android-engage-sdk-integration/references/troubleshooting.md +39 -0
  133. package/skills/android-gradle-build-debug/SKILL.md +71 -0
  134. package/skills/android-intent-security/SKILL.md +550 -0
  135. package/skills/android-leanback-to-compose-tv-migration/SKILL.md +743 -0
  136. package/skills/android-leanback-to-compose-tv-migration/references/android/training/tv/get-started/navigation.md +372 -0
  137. package/skills/android-leanback-to-compose-tv-migration/references/android/training/tv/playback/compose/browse.md +243 -0
  138. package/skills/android-leanback-to-compose-tv-migration/references/android/training/tv/playback/compose/index.md +153 -0
  139. package/skills/android-media3-cast-integration/SKILL.md +236 -0
  140. package/skills/android-media3-cast-integration/references/android/media/media3/cast/create-castplayer.md +390 -0
  141. package/skills/android-media3-cast-integration/references/android/media/media3/cast/customize-castoptions.md +93 -0
  142. package/skills/android-media3-cast-integration/references/android/media/media3/cast/index.md +21 -0
  143. package/skills/android-migrate-xml-views-to-jetpack-compose/SKILL.md +127 -0
  144. package/skills/android-migrate-xml-views-to-jetpack-compose/references/analysis-of-the-project-and-layout.md +42 -0
  145. package/skills/android-migrate-xml-views-to-jetpack-compose/references/android/develop/ui/compose/designsystems/migrate-xml-theme-to-compose.md +171 -0
  146. package/skills/android-migrate-xml-views-to-jetpack-compose/references/android/develop/ui/compose/migrate/interoperability-apis/compose-in-views.md +299 -0
  147. package/skills/android-migrate-xml-views-to-jetpack-compose/references/android/develop/ui/compose/migrate/interoperability-apis/views-in-compose.md +286 -0
  148. package/skills/android-migrate-xml-views-to-jetpack-compose/references/android/develop/ui/compose/setup-compose-dependencies-and-compiler.md +197 -0
  149. package/skills/android-migrate-xml-views-to-jetpack-compose/references/identify-optimal-xml-candidate.md +31 -0
  150. package/skills/android-migrate-xml-views-to-jetpack-compose/references/xml-layout-migration.md +86 -0
  151. package/skills/android-ml-kit-genai-prompt-api/SKILL.md +124 -0
  152. package/skills/android-ml-kit-genai-prompt-api/references/get-started.md +272 -0
  153. package/skills/android-ml-kit-genai-prompt-api/references/prefix-caching.md +146 -0
  154. package/skills/android-ml-kit-genai-prompt-api/references/prompt-design.md +55 -0
  155. package/skills/android-ml-kit-genai-prompt-api/references/prompt-optimization.md +74 -0
  156. package/skills/android-ml-kit-genai-prompt-api/references/structured-output.md +219 -0
  157. package/skills/android-ml-kit-genai-prompt-api/references/system-instructions.md +71 -0
  158. package/skills/android-navigation-3/SKILL.md +122 -0
  159. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/index.md +51 -0
  160. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/migration-guide.md +670 -0
  161. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/animations.md +147 -0
  162. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/basic.md +89 -0
  163. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/basicdsl.md +85 -0
  164. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/basicsaveable.md +90 -0
  165. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/bottomsheet.md +195 -0
  166. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/common-ui.md +200 -0
  167. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/conditional-transitions.md +182 -0
  168. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/conditional.md +230 -0
  169. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/deeplinks-custommatcher.md +176 -0
  170. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/deeplinks-staticuri.md +140 -0
  171. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/deeplinks-syntheticbackstack.md +184 -0
  172. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/dialog.md +107 -0
  173. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/lifecycle-owner.md +185 -0
  174. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/material-listdetail.md +141 -0
  175. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/material-supportingpane.md +145 -0
  176. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/modular-hilt.md +283 -0
  177. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/modular-koin.md +287 -0
  178. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/multiple-backstacks.md +468 -0
  179. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/passingarguments.md +371 -0
  180. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/results-event.md +273 -0
  181. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/results-state.md +266 -0
  182. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/scenes-listdetail.md +435 -0
  183. package/skills/android-navigation-3/references/android/guide/navigation/navigation-3/recipes/scenes-twopane.md +244 -0
  184. package/skills/android-navigation-3/references/android/guide/navigation/type-safe-destinations.md +129 -0
  185. package/skills/android-navigation-event/SKILL.md +312 -0
  186. package/skills/android-navigation-event/references/android/guide/navigation/navigation-event/dispatcher.md +134 -0
  187. package/skills/android-navigation-event/references/android/guide/navigation/navigation-event/handle-back.md +217 -0
  188. package/skills/android-navigation-event/references/android/guide/navigation/navigation-event/index.md +83 -0
  189. package/skills/android-navigation-event/references/android/guide/navigation/navigation-event/setup.md +32 -0
  190. package/skills/android-play-billing-library-version-upgrade/SKILL.md +96 -0
  191. package/skills/android-play-billing-library-version-upgrade/references/android/google/play/billing/release-notes.md +1240 -0
  192. package/skills/android-play-billing-library-version-upgrade/references/migration-logic.md +78 -0
  193. package/skills/android-play-billing-library-version-upgrade/references/version-checklist.md +54 -0
  194. package/skills/android-play-policy-insights/SKILL.md +172 -0
  195. package/skills/android-play-policy-insights/resources/common_mandates.md +100 -0
  196. package/skills/android-play-policy-insights/resources/compliance_report_template.md +59 -0
  197. package/skills/android-play-policy-insights/resources/critic.md +86 -0
  198. package/skills/android-play-policy-insights/resources/goal_data_safety.md +212 -0
  199. package/skills/android-play-policy-insights/resources/goal_permissions_and_apis.md +459 -0
  200. package/skills/android-play-policy-insights/resources/goal_user_account.md +106 -0
  201. package/skills/android-play-policy-insights/resources/policies.json +321 -0
  202. package/skills/android-play-policy-insights/resources/scanner_config.json +843 -0
  203. package/skills/android-play-policy-insights/scripts/generate_report.py +860 -0
  204. package/skills/android-play-policy-insights/scripts/orchestrator.py +1313 -0
  205. package/skills/android-play-policy-insights/scripts/play_store_scraper.py +410 -0
  206. package/skills/android-play-policy-insights/scripts/scanner.py +261 -0
  207. package/skills/android-play-policy-insights/scripts/template_engine.py +243 -0
  208. package/skills/android-profiler/SKILL.md +60 -0
  209. package/skills/android-profiler/analysis/analysis_orchestrator.md +32 -0
  210. package/skills/android-profiler/analysis/workflows/perfetto-sql/perfetto_sql.md +28 -0
  211. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/perfetto_trace_analysis.md +121 -0
  212. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/guiding_principles.md +51 -0
  213. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/domain_hints_template.md +7 -0
  214. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_cpu.md +56 -0
  215. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_graphics.md +51 -0
  216. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_io.md +46 -0
  217. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_ipc.md +41 -0
  218. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_memory.md +55 -0
  219. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/hints/subsystems/hints_power.md +33 -0
  220. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/per_candidate_analysis.md +172 -0
  221. package/skills/android-profiler/analysis/workflows/perfetto-trace-analysis/references/triage.md +94 -0
  222. package/skills/android-profiler/recording/recording_orchestrator.md +36 -0
  223. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/perfetto_trace_recording.md +148 -0
  224. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/app_jank.pftxt +43 -0
  225. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/cpu_profile.pftxt +35 -0
  226. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/java_heap_dump.pftxt +21 -0
  227. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/long_background.pftxt +37 -0
  228. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/memory_counters.pftxt +45 -0
  229. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/native_heap.pftxt +21 -0
  230. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/example-configs/sched_cpu.pftxt +33 -0
  231. package/skills/android-profiler/recording/workflows/perfetto-trace-recording/references/trace_config_reference.md +102 -0
  232. package/skills/android-profiler/references/env_setup.md +15 -0
  233. package/skills/android-profiler/references/perfetto/setup.md +29 -0
  234. package/skills/android-profiler/references/perfetto/sql.md +327 -0
  235. package/skills/android-r8-analyzer/SKILL.md +72 -0
  236. package/skills/android-r8-analyzer/references/CONFIGURATION-ANALYZER.md +287 -0
  237. package/skills/android-r8-analyzer/references/CONFIGURATION.md +44 -0
  238. package/skills/android-r8-analyzer/references/KEEP-RULES-IMPACT-HIERARCHY.md +83 -0
  239. package/skills/android-r8-analyzer/references/REDUNDANT-RULES.md +222 -0
  240. package/skills/android-r8-analyzer/references/REFLECTION-GUIDE.md +139 -0
  241. package/skills/android-r8-analyzer/references/REPORT_FORMAT.md +51 -0
  242. package/skills/android-r8-analyzer/references/android/topic/performance/app-optimization/enable-app-optimization.md +252 -0
  243. package/skills/android-r8-analyzer/references/android/training/testing/other-components/ui-automator.md +312 -0
  244. package/skills/android-restore-credentials/SKILL.md +359 -0
  245. package/skills/android-restore-credentials/references/android/guide/topics/manifest/application-element.md +832 -0
  246. package/skills/android-restore-credentials/references/android/identity/passkeys/create-passkeys.md +327 -0
  247. package/skills/android-restore-credentials/references/android/identity/passkeys/sign-in-with-passkeys.md +219 -0
  248. package/skills/android-styles/SKILL.md +229 -0
  249. package/skills/android-styles/references/android/develop/ui/compose/designsystems/custom.md +459 -0
  250. package/skills/android-styles/references/android/develop/ui/compose/styles/fundamentals.md +421 -0
  251. package/skills/android-styles/references/android/develop/ui/compose/styles/state-animations.md +461 -0
  252. package/skills/android-styles/references/android/develop/ui/compose/styles/styles-vs-modifiers.md +48 -0
  253. package/skills/android-styles/references/android/develop/ui/compose/styles/theming.md +269 -0
  254. package/skills/android-verified-email/SKILL.md +432 -0
  255. package/skills/android-verified-email/references/android/identity/credential-manager/index.md +67 -0
  256. package/skills/android-verified-email/references/android/identity/digital-credentials/credential-verifier.md +166 -0
  257. package/skills/android-verified-email/references/android/identity/digital-credentials/email-verification-implementation.md +313 -0
  258. package/skills/android-verified-email/references/android/identity/digital-credentials/email-verification.md +158 -0
  259. package/skills/android-verified-email/references/android/identity/digital-credentials/index.md +112 -0
  260. package/skills/android-verified-email/references/android/identity/passkeys/create-passkeys.md +327 -0
  261. package/skills/android-verified-email/references/android/identity/sign-in/credential-manager-webview.md +84 -0
  262. package/skills/android-wear-compose-m3/SKILL.md +365 -0
  263. package/skills/android-wear-compose-m3/references/android/training/wearables/compose/migrate-to-material3.md +677 -0
  264. package/skills/android-wear-compose-m3/references/foundation/AmbientModeSample.kt.md +123 -0
  265. package/skills/android-wear-compose-m3/references/foundation/AmbientModeSample.kt.md.txt +123 -0
  266. package/skills/android-wear-compose-m3/references/foundation/CurvedWorldSample.kt.md +430 -0
  267. package/skills/android-wear-compose-m3/references/foundation/CurvedWorldSample.kt.md.txt +430 -0
  268. package/skills/android-wear-compose-m3/references/foundation/ExpandableSample.kt.md +99 -0
  269. package/skills/android-wear-compose-m3/references/foundation/ExpandableSample.kt.md.txt +99 -0
  270. package/skills/android-wear-compose-m3/references/foundation/HierarchicalFocusSample.kt.md +141 -0
  271. package/skills/android-wear-compose-m3/references/foundation/HierarchicalFocusSample.kt.md.txt +141 -0
  272. package/skills/android-wear-compose-m3/references/foundation/PagerSamples.kt.md +56 -0
  273. package/skills/android-wear-compose-m3/references/foundation/PagerSamples.kt.md.txt +56 -0
  274. package/skills/android-wear-compose-m3/references/foundation/RotarySamples.kt.md +153 -0
  275. package/skills/android-wear-compose-m3/references/foundation/RotarySamples.kt.md.txt +153 -0
  276. package/skills/android-wear-compose-m3/references/foundation/ScalingLazyColumnSample.kt.md +131 -0
  277. package/skills/android-wear-compose-m3/references/foundation/ScalingLazyColumnSample.kt.md.txt +131 -0
  278. package/skills/android-wear-compose-m3/references/foundation/SwipeToDismissBoxSample.kt.md +169 -0
  279. package/skills/android-wear-compose-m3/references/foundation/SwipeToDismissBoxSample.kt.md.txt +169 -0
  280. package/skills/android-wear-compose-m3/references/foundation/SwipeToRevealSample.kt.md +282 -0
  281. package/skills/android-wear-compose-m3/references/foundation/SwipeToRevealSample.kt.md.txt +282 -0
  282. package/skills/android-wear-compose-m3/references/foundation/TransformingLazyColumnSample.kt.md +335 -0
  283. package/skills/android-wear-compose-m3/references/foundation/TransformingLazyColumnSample.kt.md.txt +335 -0
  284. package/skills/android-wear-compose-m3/references/material3/AlertDialogSample.kt.md +377 -0
  285. package/skills/android-wear-compose-m3/references/material3/AlertDialogSample.kt.md.txt +377 -0
  286. package/skills/android-wear-compose-m3/references/material3/AnimatedTextSample.kt.md +165 -0
  287. package/skills/android-wear-compose-m3/references/material3/AnimatedTextSample.kt.md.txt +165 -0
  288. package/skills/android-wear-compose-m3/references/material3/ButtonGroupSample.kt.md +91 -0
  289. package/skills/android-wear-compose-m3/references/material3/ButtonGroupSample.kt.md.txt +91 -0
  290. package/skills/android-wear-compose-m3/references/material3/ButtonSample.kt.md +496 -0
  291. package/skills/android-wear-compose-m3/references/material3/ButtonSample.kt.md.txt +496 -0
  292. package/skills/android-wear-compose-m3/references/material3/CardSample.kt.md +470 -0
  293. package/skills/android-wear-compose-m3/references/material3/CardSample.kt.md.txt +470 -0
  294. package/skills/android-wear-compose-m3/references/material3/CheckboxButtonSample.kt.md +67 -0
  295. package/skills/android-wear-compose-m3/references/material3/CheckboxButtonSample.kt.md.txt +67 -0
  296. package/skills/android-wear-compose-m3/references/material3/ConfirmationDialogSample.kt.md +162 -0
  297. package/skills/android-wear-compose-m3/references/material3/ConfirmationDialogSample.kt.md.txt +162 -0
  298. package/skills/android-wear-compose-m3/references/material3/CurvedTextSamples.kt.md +78 -0
  299. package/skills/android-wear-compose-m3/references/material3/CurvedTextSamples.kt.md.txt +78 -0
  300. package/skills/android-wear-compose-m3/references/material3/DatePickerSample.kt.md +131 -0
  301. package/skills/android-wear-compose-m3/references/material3/DatePickerSample.kt.md.txt +131 -0
  302. package/skills/android-wear-compose-m3/references/material3/DynamicColorSchemeSample.kt.md +74 -0
  303. package/skills/android-wear-compose-m3/references/material3/DynamicColorSchemeSample.kt.md.txt +74 -0
  304. package/skills/android-wear-compose-m3/references/material3/EdgeButtonSample.kt.md +63 -0
  305. package/skills/android-wear-compose-m3/references/material3/EdgeButtonSample.kt.md.txt +63 -0
  306. package/skills/android-wear-compose-m3/references/material3/FadingExpandingLabelSample.kt.md +60 -0
  307. package/skills/android-wear-compose-m3/references/material3/FadingExpandingLabelSample.kt.md.txt +60 -0
  308. package/skills/android-wear-compose-m3/references/material3/IconButtonSample.kt.md +125 -0
  309. package/skills/android-wear-compose-m3/references/material3/IconButtonSample.kt.md.txt +125 -0
  310. package/skills/android-wear-compose-m3/references/material3/IconToggleButtonSample.kt.md +116 -0
  311. package/skills/android-wear-compose-m3/references/material3/IconToggleButtonSample.kt.md.txt +116 -0
  312. package/skills/android-wear-compose-m3/references/material3/LevelIndicatorSample.kt.md +68 -0
  313. package/skills/android-wear-compose-m3/references/material3/LevelIndicatorSample.kt.md.txt +68 -0
  314. package/skills/android-wear-compose-m3/references/material3/LinearProgressIndicatorSample.kt.md +50 -0
  315. package/skills/android-wear-compose-m3/references/material3/LinearProgressIndicatorSample.kt.md.txt +50 -0
  316. package/skills/android-wear-compose-m3/references/material3/ListHeaderSample.kt.md +177 -0
  317. package/skills/android-wear-compose-m3/references/material3/ListHeaderSample.kt.md.txt +177 -0
  318. package/skills/android-wear-compose-m3/references/material3/OneHandedGestureSamples.kt.md +651 -0
  319. package/skills/android-wear-compose-m3/references/material3/OneHandedGestureSamples.kt.md.txt +651 -0
  320. package/skills/android-wear-compose-m3/references/material3/OpenOnPhoneDialogSample.kt.md +57 -0
  321. package/skills/android-wear-compose-m3/references/material3/OpenOnPhoneDialogSample.kt.md.txt +57 -0
  322. package/skills/android-wear-compose-m3/references/material3/PageIndicatorSample.kt.md +110 -0
  323. package/skills/android-wear-compose-m3/references/material3/PageIndicatorSample.kt.md.txt +110 -0
  324. package/skills/android-wear-compose-m3/references/material3/PagerScaffoldSample.kt.md +204 -0
  325. package/skills/android-wear-compose-m3/references/material3/PagerScaffoldSample.kt.md.txt +204 -0
  326. package/skills/android-wear-compose-m3/references/material3/PickerGroupSample.kt.md +139 -0
  327. package/skills/android-wear-compose-m3/references/material3/PickerGroupSample.kt.md.txt +139 -0
  328. package/skills/android-wear-compose-m3/references/material3/PickerSample.kt.md +111 -0
  329. package/skills/android-wear-compose-m3/references/material3/PickerSample.kt.md.txt +111 -0
  330. package/skills/android-wear-compose-m3/references/material3/PlaceholderSample.kt.md +184 -0
  331. package/skills/android-wear-compose-m3/references/material3/PlaceholderSample.kt.md.txt +184 -0
  332. package/skills/android-wear-compose-m3/references/material3/ProgressIndicatorSample.kt.md +263 -0
  333. package/skills/android-wear-compose-m3/references/material3/ProgressIndicatorSample.kt.md.txt +263 -0
  334. package/skills/android-wear-compose-m3/references/material3/RadioButtonSample.kt.md +105 -0
  335. package/skills/android-wear-compose-m3/references/material3/RadioButtonSample.kt.md.txt +105 -0
  336. package/skills/android-wear-compose-m3/references/material3/ScaffoldSample.kt.md +146 -0
  337. package/skills/android-wear-compose-m3/references/material3/ScaffoldSample.kt.md.txt +146 -0
  338. package/skills/android-wear-compose-m3/references/material3/ScrollAwaySample.kt.md +97 -0
  339. package/skills/android-wear-compose-m3/references/material3/ScrollAwaySample.kt.md.txt +97 -0
  340. package/skills/android-wear-compose-m3/references/material3/ScrollIndicatorSample.kt.md +66 -0
  341. package/skills/android-wear-compose-m3/references/material3/ScrollIndicatorSample.kt.md.txt +66 -0
  342. package/skills/android-wear-compose-m3/references/material3/SliderSample.kt.md +86 -0
  343. package/skills/android-wear-compose-m3/references/material3/SliderSample.kt.md.txt +86 -0
  344. package/skills/android-wear-compose-m3/references/material3/StepperSample.kt.md +148 -0
  345. package/skills/android-wear-compose-m3/references/material3/StepperSample.kt.md.txt +148 -0
  346. package/skills/android-wear-compose-m3/references/material3/SurfaceTransformationSample.kt.md +166 -0
  347. package/skills/android-wear-compose-m3/references/material3/SurfaceTransformationSample.kt.md.txt +166 -0
  348. package/skills/android-wear-compose-m3/references/material3/SwipeToDismissBoxSample.kt.md +172 -0
  349. package/skills/android-wear-compose-m3/references/material3/SwipeToDismissBoxSample.kt.md.txt +172 -0
  350. package/skills/android-wear-compose-m3/references/material3/SwipeToRevealSample.kt.md +367 -0
  351. package/skills/android-wear-compose-m3/references/material3/SwipeToRevealSample.kt.md.txt +367 -0
  352. package/skills/android-wear-compose-m3/references/material3/SwitchButtonSample.kt.md +66 -0
  353. package/skills/android-wear-compose-m3/references/material3/SwitchButtonSample.kt.md.txt +66 -0
  354. package/skills/android-wear-compose-m3/references/material3/TextButtonSample.kt.md +115 -0
  355. package/skills/android-wear-compose-m3/references/material3/TextButtonSample.kt.md.txt +115 -0
  356. package/skills/android-wear-compose-m3/references/material3/TextToggleButtonSample.kt.md +71 -0
  357. package/skills/android-wear-compose-m3/references/material3/TextToggleButtonSample.kt.md.txt +71 -0
  358. package/skills/android-wear-compose-m3/references/material3/TimePickerSample.kt.md +151 -0
  359. package/skills/android-wear-compose-m3/references/material3/TimePickerSample.kt.md.txt +151 -0
  360. package/skills/android-wear-compose-m3/references/material3/TimeTextSample.kt.md +65 -0
  361. package/skills/android-wear-compose-m3/references/material3/TimeTextSample.kt.md.txt +65 -0
  362. package/skills/android-wear-compose-m3/references/material3/TransformationSpecSample.kt.md +246 -0
  363. package/skills/android-wear-compose-m3/references/material3/TransformationSpecSample.kt.md.txt +246 -0
  364. package/skills/android-wear-compose-m3/references/material3/TransformingLazyColumnNotificationsSample.kt.md +89 -0
  365. package/skills/android-wear-compose-m3/references/material3/TransformingLazyColumnNotificationsSample.kt.md.txt +89 -0
  366. package/skills/android-wear-compose-m3/references/material3/TransformingLazyColumnSample.kt.md +309 -0
  367. package/skills/android-wear-compose-m3/references/material3/TransformingLazyColumnSample.kt.md.txt +309 -0
  368. package/skills/android-wear-compose-m3/references/navigation3/SwipeDismissableSceneStrategySample.kt.md +205 -0
  369. package/skills/android-wear-compose-m3/references/navigation3/SwipeDismissableSceneStrategySample.kt.md.txt +205 -0
  370. package/skills/{architecture-feature-first → flutter-architecture-feature-first}/SKILL.md +1 -1
  371. package/skills/{bloc → flutter-bloc}/SKILL.md +1 -1
  372. package/skills/flutter-build-debug/SKILL.md +66 -0
  373. package/skills/{code-review → flutter-code-review}/SKILL.md +1 -1
  374. package/skills/{dart-3-updates → flutter-dart-3-updates}/SKILL.md +1 -1
  375. package/skills/{dart-fix-runtime-errors → flutter-dart-fix-runtime-errors}/SKILL.md +1 -1
  376. package/skills/{dart-resolve-package-conflicts → flutter-dart-resolve-package-conflicts}/SKILL.md +1 -1
  377. package/skills/{dart-run-static-analysis → flutter-dart-run-static-analysis}/SKILL.md +1 -1
  378. package/skills/{dart-use-pattern-matching → flutter-dart-use-pattern-matching}/SKILL.md +1 -1
  379. package/skills/{effective-dart → flutter-effective-dart}/SKILL.md +1 -1
  380. package/skills/{provider → flutter-provider}/SKILL.md +1 -1
  381. package/skills/{riverpod → flutter-riverpod}/SKILL.md +1 -1
  382. package/skills/ios-cocoapods-debug/SKILL.md +65 -0
  383. package/skills/ios-code-review/SKILL.md +56 -0
  384. package/skills/ios-xcode-build-debug/SKILL.md +66 -0
  385. package/skills/{detect-mobile-stack → mobile-detect-stack}/SKILL.md +1 -1
  386. package/skills/mobile-firebase/SKILL.md +54 -0
  387. package/skills/mobile-firebase/references/android/ai-logic.md +31 -0
  388. package/skills/mobile-firebase/references/android/analytics.md +33 -0
  389. package/skills/mobile-firebase/references/android/app-check.md +36 -0
  390. package/skills/mobile-firebase/references/android/auth.md +44 -0
  391. package/skills/mobile-firebase/references/android/crashlytics.md +31 -0
  392. package/skills/mobile-firebase/references/android/firestore.md +44 -0
  393. package/skills/mobile-firebase/references/android/functions.md +33 -0
  394. package/skills/mobile-firebase/references/android/in-app-messaging.md +28 -0
  395. package/skills/mobile-firebase/references/android/messaging.md +41 -0
  396. package/skills/mobile-firebase/references/android/realtime-database.md +50 -0
  397. package/skills/mobile-firebase/references/android/remote-config.md +43 -0
  398. package/skills/mobile-firebase/references/android/sql-connect.md +31 -0
  399. package/skills/mobile-firebase/references/android/storage.md +39 -0
  400. package/skills/mobile-firebase/references/android.md +30 -0
  401. package/skills/{firebase-ai/SKILL.md → mobile-firebase/references/flutter/ai-logic.md} +2 -8
  402. package/skills/{firebase-analytics/SKILL.md → mobile-firebase/references/flutter/analytics.md} +2 -8
  403. package/skills/{firebase-app-check/SKILL.md → mobile-firebase/references/flutter/app-check.md} +2 -8
  404. package/skills/{firebase-auth/SKILL.md → mobile-firebase/references/flutter/auth.md} +2 -8
  405. package/skills/{firebase-crashlytics/SKILL.md → mobile-firebase/references/flutter/crashlytics.md} +2 -8
  406. package/skills/{firebase-cloud-firestore/SKILL.md → mobile-firebase/references/flutter/firestore.md} +2 -8
  407. package/skills/{firebase-cloud-functions/SKILL.md → mobile-firebase/references/flutter/functions.md} +2 -8
  408. package/skills/{firebase-in-app-messaging/SKILL.md → mobile-firebase/references/flutter/in-app-messaging.md} +2 -8
  409. package/skills/{firebase-messaging/SKILL.md → mobile-firebase/references/flutter/messaging.md} +2 -8
  410. package/skills/{firebase-database/SKILL.md → mobile-firebase/references/flutter/realtime-database.md} +2 -8
  411. package/skills/{firebase-remote-config/SKILL.md → mobile-firebase/references/flutter/remote-config.md} +2 -8
  412. package/skills/{flutterfire-configure/SKILL.md → mobile-firebase/references/flutter/setup-flutterfire.md} +1 -8
  413. package/skills/{firebase-data-connect/SKILL.md → mobile-firebase/references/flutter/sql-connect.md} +2 -8
  414. package/skills/{firebase-storage/SKILL.md → mobile-firebase/references/flutter/storage.md} +2 -8
  415. package/skills/mobile-firebase/references/flutter.md +36 -0
  416. package/skills/mobile-firebase/references/ios/ai-logic.md +30 -0
  417. package/skills/mobile-firebase/references/ios/analytics.md +33 -0
  418. package/skills/mobile-firebase/references/ios/app-check.md +36 -0
  419. package/skills/mobile-firebase/references/ios/auth.md +48 -0
  420. package/skills/mobile-firebase/references/ios/crashlytics.md +34 -0
  421. package/skills/mobile-firebase/references/ios/firestore.md +53 -0
  422. package/skills/mobile-firebase/references/ios/functions.md +35 -0
  423. package/skills/mobile-firebase/references/ios/in-app-messaging.md +26 -0
  424. package/skills/mobile-firebase/references/ios/messaging.md +45 -0
  425. package/skills/mobile-firebase/references/ios/realtime-database.md +49 -0
  426. package/skills/mobile-firebase/references/ios/remote-config.md +44 -0
  427. package/skills/mobile-firebase/references/ios/sql-connect.md +33 -0
  428. package/skills/mobile-firebase/references/ios/storage.md +36 -0
  429. package/skills/mobile-firebase/references/ios.md +28 -0
  430. package/skills/mobile-firebase/references/react-native/ai-logic.md +32 -0
  431. package/skills/mobile-firebase/references/react-native/analytics.md +43 -0
  432. package/skills/mobile-firebase/references/react-native/app-check.md +35 -0
  433. package/skills/mobile-firebase/references/react-native/auth.md +50 -0
  434. package/skills/mobile-firebase/references/react-native/crashlytics.md +36 -0
  435. package/skills/mobile-firebase/references/react-native/firestore.md +45 -0
  436. package/skills/mobile-firebase/references/react-native/functions.md +28 -0
  437. package/skills/mobile-firebase/references/react-native/in-app-messaging.md +27 -0
  438. package/skills/mobile-firebase/references/react-native/messaging.md +46 -0
  439. package/skills/mobile-firebase/references/react-native/realtime-database.md +46 -0
  440. package/skills/mobile-firebase/references/react-native/remote-config.md +32 -0
  441. package/skills/mobile-firebase/references/react-native/sql-connect.md +11 -0
  442. package/skills/mobile-firebase/references/react-native/storage.md +30 -0
  443. package/skills/mobile-firebase/references/react-native.md +29 -0
  444. package/skills/mobile-test/SKILL.md +63 -0
  445. package/skills/mobile-test/references/android/setup/GUIDE.md +183 -0
  446. package/skills/mobile-test/references/android/setup/references/android/develop/ui/compose/testing/common-patterns.md +181 -0
  447. package/skills/mobile-test/references/android/setup/references/android/studio/preview/compose-screenshot-testing.md +255 -0
  448. package/skills/mobile-test/references/android/setup/references/android/training/dependency-injection/hilt-testing.md +447 -0
  449. package/skills/mobile-test/references/android.md +83 -0
  450. package/skills/{dart-collect-coverage/SKILL.md → mobile-test/references/flutter/coverage.md} +2 -11
  451. package/skills/{dart-generate-test-mocks/SKILL.md → mobile-test/references/flutter/generate-mocks.md} +2 -11
  452. package/skills/{flutter-add-integration-test/SKILL.md → mobile-test/references/flutter/integration-tests.md} +2 -11
  453. package/skills/{dart-migrate-to-checks-package/SKILL.md → mobile-test/references/flutter/migrate-to-checks.md} +2 -13
  454. package/skills/{mockito/SKILL.md → mobile-test/references/flutter/mockito.md} +1 -8
  455. package/skills/{mocktail/SKILL.md → mobile-test/references/flutter/mocktail.md} +1 -8
  456. package/skills/{patrol-e2e-testing/SKILL.md → mobile-test/references/flutter/patrol.md} +1 -8
  457. package/skills/{testing/SKILL.md → mobile-test/references/flutter/testing-guidelines.md} +1 -8
  458. package/skills/{dart-add-unit-test/SKILL.md → mobile-test/references/flutter/unit-tests.md} +2 -11
  459. package/skills/{flutter-add-widget-test/SKILL.md → mobile-test/references/flutter/widget-tests.md} +2 -11
  460. package/skills/mobile-test/references/flutter.md +44 -0
  461. package/skills/mobile-test/references/ios.md +79 -0
  462. package/skills/mobile-test/references/react-native.md +62 -0
  463. /package/skills/{dart-use-pattern-matching → flutter-dart-use-pattern-matching}/examples/json_patterns.dart +0 -0
@@ -0,0 +1,410 @@
1
+ #!/usr/bin/env python3
2
+
3
+ # Copyright 2026 The Android Open Source Project
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ """Scrapes and parses app metadata and safety info from Play Store."""
18
+
19
+ import html.parser
20
+ import json
21
+ import os
22
+ import ssl
23
+ import sys
24
+ import urllib.error
25
+ import urllib.request
26
+
27
+
28
+ def fetch_html(url, verify_ssl=True):
29
+ """Fetches HTML content from a URL with a realistic User-Agent."""
30
+ headers = {
31
+ "User-Agent": (
32
+ "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
33
+ "AppleWebKit/537.36 (KHTML, like Gecko) "
34
+ "Chrome/119.0.0.0 Safari/537.36"
35
+ ),
36
+ "Accept-Language": "en-US,en;q=0.9",
37
+ }
38
+ req = urllib.request.Request(url, headers=headers)
39
+ if verify_ssl:
40
+ context = ssl.create_default_context()
41
+ else:
42
+ context = ssl._create_unverified_context()
43
+ try:
44
+ with urllib.request.urlopen(req, timeout=10, context=context) as resp:
45
+ return resp.read().decode("utf-8")
46
+ except urllib.error.HTTPError as e:
47
+ if e.code == 404:
48
+ print(f"App not found on Play Store (404): {url}", file=sys.stderr)
49
+ else:
50
+ print(f"HTTP Error: {e.code} {e.reason}", file=sys.stderr)
51
+ return None
52
+ except Exception as e:
53
+ print(f"Error fetching {url}: {e}", file=sys.stderr)
54
+ return None
55
+
56
+
57
+ class PlayStoreMetadataParser(html.parser.HTMLParser):
58
+ """Parses core app metadata from Play Store HTML."""
59
+
60
+ def __init__(self):
61
+ super().__init__()
62
+ self.ld_json = None
63
+ self.meta_category = None
64
+ self.meta_content_rating = None
65
+ self.meta_description = None
66
+ self.title_text = None
67
+ self.developer_name = None
68
+ self.privacy_policy_url = None
69
+
70
+ self.in_ld_json = False
71
+ self.json_data = []
72
+ self.in_title = False
73
+ self.in_dev_link = False
74
+
75
+ self.in_a_tag = False
76
+ self.current_a_href = None
77
+
78
+ def handle_starttag(self, tag, attrs):
79
+ attrs_dict = dict(attrs)
80
+
81
+ if tag == "script" and attrs_dict.get("type") == "application/ld+json":
82
+ self.in_ld_json = True
83
+ self.json_data = []
84
+
85
+ if tag == "meta":
86
+ itemprop = attrs_dict.get("itemprop")
87
+ if itemprop == "applicationCategory":
88
+ self.meta_category = attrs_dict.get("content")
89
+ elif itemprop == "contentRating":
90
+ self.meta_content_rating = attrs_dict.get("content")
91
+
92
+ name = attrs_dict.get("name")
93
+ prop = attrs_dict.get("property")
94
+ if prop == "og:description" or name == "description":
95
+ if not self.meta_description:
96
+ self.meta_description = attrs_dict.get("content")
97
+
98
+ if tag == "h1":
99
+ self.in_title = True
100
+
101
+ if tag == "a":
102
+ href = attrs_dict.get("href", "")
103
+ if "/store/apps/dev" in href:
104
+ self.in_dev_link = True
105
+
106
+ self.in_a_tag = True
107
+ self.current_a_href = href
108
+
109
+ def handle_endtag(self, tag):
110
+ if tag == "script" and self.in_ld_json:
111
+ self.in_ld_json = False
112
+ try:
113
+ self.ld_json = json.loads("".join(self.json_data))
114
+ if isinstance(self.ld_json, list):
115
+ self.ld_json = self.ld_json[0]
116
+ except (json.JSONDecodeError, TypeError, IndexError):
117
+ pass
118
+ if tag == "h1":
119
+ self.in_title = False
120
+ if tag == "a":
121
+ self.in_dev_link = False
122
+ self.in_a_tag = False
123
+ self.current_a_href = None
124
+
125
+ def handle_data(self, data):
126
+ if self.in_ld_json:
127
+ self.json_data.append(data)
128
+ elif self.in_title and not self.title_text:
129
+ self.title_text = data.strip()
130
+ elif self.in_dev_link and not self.developer_name:
131
+ self.developer_name = data.strip()
132
+ elif self.in_a_tag and self.current_a_href:
133
+ if "privacy policy" in data.lower():
134
+ if "google.com" not in self.current_a_href.lower():
135
+ if not self.privacy_policy_url:
136
+ self.privacy_policy_url = self.current_a_href
137
+
138
+
139
+ class PlayStoreDataSafetyParser(html.parser.HTMLParser):
140
+ """Extracts visible text content from HTML structurally."""
141
+
142
+ def __init__(self):
143
+ super().__init__()
144
+ self.text_parts = []
145
+ self.ignore_tags = {"script", "style", "noscript", "svg", "path"}
146
+ self.in_ignored_tag = 0
147
+
148
+ def handle_starttag(self, tag, attrs):
149
+ if tag.lower() in self.ignore_tags:
150
+ self.in_ignored_tag += 1
151
+
152
+ def handle_endtag(self, tag):
153
+ if tag.lower() in self.ignore_tags:
154
+ self.in_ignored_tag = max(0, self.in_ignored_tag - 1)
155
+
156
+ def handle_data(self, data):
157
+ if self.in_ignored_tag == 0:
158
+ cleaned = data.strip()
159
+ if cleaned:
160
+ self.text_parts.append(cleaned)
161
+
162
+
163
+ def load_taxonomy():
164
+ """Loads the valid data safety taxonomy from policies.json."""
165
+ repo_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
166
+ policy_path = os.path.join(repo_root, "resources", "policies.json")
167
+ try:
168
+ with open(policy_path, "r", encoding="utf-8", errors="ignore") as f:
169
+ data = json.load(f)
170
+ taxonomy = data.get("data_safety_section", {}).get("taxonomy", {})
171
+ return {
172
+ item["data_type"].lower()
173
+ for item in taxonomy.values()
174
+ if "data_type" in item
175
+ }
176
+ except Exception as e:
177
+ print(
178
+ f"Warning: Failed to load taxonomy from {policy_path}: {e}",
179
+ file=sys.stderr,
180
+ )
181
+ return set()
182
+
183
+
184
+ # Official Play Store Data Safety Taxonomy for validation
185
+ VALID_TAXONOMY = load_taxonomy()
186
+
187
+
188
+ def extract_metadata(html_content):
189
+ """Extracts all metadata into a clean dictionary."""
190
+ metadata = {
191
+ "title": "Unknown App",
192
+ "developer": "Unknown Developer",
193
+ "category": None,
194
+ "content_rating": None,
195
+ "description": None,
196
+ "privacy_policy_url": None,
197
+ }
198
+
199
+ if not html_content:
200
+ return metadata
201
+
202
+ parser = PlayStoreMetadataParser()
203
+ parser.feed(html_content)
204
+
205
+ # 1. Prioritize ld+json payload
206
+ if parser.ld_json:
207
+ metadata["title"] = parser.ld_json.get("name", metadata["title"])
208
+
209
+ author = parser.ld_json.get("author", {})
210
+ if isinstance(author, dict):
211
+ metadata["developer"] = author.get("name", metadata["developer"])
212
+ elif isinstance(author, str):
213
+ metadata["developer"] = author
214
+
215
+ metadata["category"] = parser.ld_json.get(
216
+ "applicationCategory", metadata["category"]
217
+ )
218
+ metadata["content_rating"] = parser.ld_json.get(
219
+ "contentRating", metadata["content_rating"]
220
+ )
221
+ metadata["description"] = parser.ld_json.get(
222
+ "description", metadata["description"]
223
+ )
224
+
225
+ # 2. Fall back to HTML tags if json was missing elements
226
+ if metadata["title"] == "Unknown App" and parser.title_text:
227
+ metadata["title"] = parser.title_text
228
+ if metadata["developer"] == "Unknown Developer" and parser.developer_name:
229
+ metadata["developer"] = parser.developer_name
230
+ if not metadata["category"] and parser.meta_category:
231
+ metadata["category"] = parser.meta_category
232
+ if not metadata["content_rating"] and parser.meta_content_rating:
233
+ metadata["content_rating"] = parser.meta_content_rating
234
+ if not metadata["description"] and parser.meta_description:
235
+ metadata["description"] = parser.meta_description
236
+
237
+ # Privacy Policy is only found in <a> tags
238
+ metadata["privacy_policy_url"] = parser.privacy_policy_url
239
+
240
+ return metadata
241
+
242
+
243
+ def extract_data_safety(html_content):
244
+ """Extracts Data Safety information structurally."""
245
+ if not html_content:
246
+ return {"data_collected": [], "data_shared": []}
247
+
248
+ parser = PlayStoreDataSafetyParser()
249
+ parser.feed(html_content)
250
+ parts = parser.text_parts
251
+
252
+ result = {"data_collected": [], "data_shared": []}
253
+
254
+ purposes_keywords = [
255
+ "App functionality",
256
+ "Analytics",
257
+ "Fraud prevention, security, and compliance",
258
+ "Personalization",
259
+ "Account management",
260
+ "Advertising or marketing",
261
+ "Developer communications",
262
+ ]
263
+
264
+ known_categories = {
265
+ "Location",
266
+ "Personal info",
267
+ "Financial info",
268
+ "Health and fitness",
269
+ "Messages",
270
+ "Photos and videos",
271
+ "Audio files",
272
+ "Files and docs",
273
+ "Calendar",
274
+ "Contacts",
275
+ "App activity",
276
+ "Web browsing",
277
+ "App info and performance",
278
+ "Device or other IDs",
279
+ }
280
+
281
+ # Robust parsing ignoring UI icons
282
+ cur_sec = None
283
+ cur_cat = None
284
+ cur_type = None
285
+
286
+ for p in parts:
287
+ p_lower = p.lower()
288
+
289
+ # Section Transitions
290
+ if (
291
+ p_lower == "data shared"
292
+ or p_lower
293
+ == "here's more information the developer has provided about the kinds"
294
+ " of data this app may share"
295
+ ):
296
+ cur_sec = "data_shared"
297
+ cur_cat = None
298
+ continue
299
+ elif (
300
+ p_lower == "data collected"
301
+ or p_lower
302
+ == "here's more information the developer has provided about the kinds"
303
+ " of data this app may collect"
304
+ ):
305
+ cur_sec = "data_collected"
306
+ cur_cat = None
307
+ continue
308
+ elif p_lower == "security practices" or p_lower == "data safety":
309
+ if cur_sec:
310
+ break
311
+
312
+ if not cur_sec:
313
+ continue
314
+
315
+ # Ignore UI artifacts
316
+ if p_lower in [
317
+ "expand_more",
318
+ "expand_less",
319
+ "info",
320
+ "data collected and for what purpose",
321
+ "data shared and for what purpose",
322
+ ]:
323
+ continue
324
+
325
+ # If it's a known purpose keyword, attach it to the current type
326
+ matched_purposes = [kw for kw in purposes_keywords if kw.lower() in p_lower]
327
+ if matched_purposes:
328
+ if cur_type:
329
+ cur_type["purposes"].extend(matched_purposes)
330
+ cur_type["purposes"] = list(set(cur_type["purposes"]))
331
+ continue
332
+
333
+ if p_lower == "· optional":
334
+ if cur_type:
335
+ cur_type["optional"] = True
336
+ continue
337
+
338
+ # If it's not a purpose or an artifact, it's either a Category or a
339
+ # Data Type
340
+ if len(p) > 50:
341
+ continue
342
+
343
+ if p in known_categories:
344
+ if not cur_cat or cur_cat["category"] != p:
345
+ cur_cat = {"category": p, "types": []}
346
+ result[cur_sec].append(cur_cat)
347
+ cur_type = None
348
+ continue
349
+
350
+ if cur_cat:
351
+ if p == cur_cat["category"]:
352
+ continue
353
+
354
+ cur_type = {"type": p, "purposes": [], "optional": False}
355
+ cur_cat["types"].append(cur_type)
356
+
357
+ # Post-process to remove summary headers (UI groupings)
358
+ for cat in result["data_collected"] + result["data_shared"]:
359
+ filtered_types = []
360
+ cat_name = cat["category"].lower()
361
+
362
+ for t in cat["types"]:
363
+ t_name_lower = t["type"].lower()
364
+
365
+ # Indicators that this is a summary header rather than a declaration:
366
+ # 1. It has no associated purposes (headers are never assigned purposes)
367
+ # 2. AND it either:
368
+ # a. Matches the category name exactly (redundant UI artifact)
369
+ # b. Is not a valid item in the official taxonomy (summary string)
370
+ if not t["purposes"]:
371
+ if (
372
+ t_name_lower == cat_name
373
+ or t_name_lower not in VALID_TAXONOMY
374
+ ):
375
+ continue
376
+
377
+ filtered_types.append(t)
378
+
379
+ cat["types"] = filtered_types
380
+
381
+ return result
382
+
383
+
384
+ def scrape_app_details(pkg_name, verify_ssl=True):
385
+ """Scrapes app metadata and Data Safety info for a given package."""
386
+ details_url = (
387
+ f"https://play.google.com/store/apps/details?id={pkg_name}&hl=en&gl=US"
388
+ )
389
+ ds_url = (
390
+ f"https://play.google.com/store/apps/datasafety?id={pkg_name}&hl=en&gl=US"
391
+ )
392
+
393
+ details_html = fetch_html(details_url, verify_ssl=verify_ssl)
394
+ metadata = extract_metadata(details_html)
395
+
396
+ ds_html = fetch_html(ds_url, verify_ssl=verify_ssl)
397
+ data_safety = extract_data_safety(ds_html)
398
+
399
+ return {
400
+ "package_name": pkg_name,
401
+ "is_published": bool(details_html),
402
+ "store_url": details_url,
403
+ "title": metadata["title"],
404
+ "developer": metadata["developer"],
405
+ "description": metadata["description"],
406
+ "category": metadata["category"],
407
+ "app_info": {"content_rating": metadata["content_rating"]},
408
+ "developer_links": {"privacy_policy_url": metadata["privacy_policy_url"]},
409
+ "data_safety": data_safety,
410
+ }
@@ -0,0 +1,261 @@
1
+ #!/usr/bin/env python3
2
+
3
+ # Copyright 2026 The Android Open Source Project
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ """Scans Android codebase for data safety signals and sensitive API usage."""
18
+
19
+ import concurrent.futures
20
+ import functools
21
+ import json
22
+ import os
23
+ import re
24
+ import sys
25
+
26
+ # Pre-compiled regex patterns at module scope for thread-safe performance
27
+ URL_PATTERN = re.compile(r'"(https?://[^"]+)"')
28
+ XML_COMMENT_PATTERN = re.compile(r"<!--.*?-->", flags=re.DOTALL)
29
+ COMMENT_STRIP_PATTERN = re.compile(
30
+ r'("(?:\\.|[^"\\])*")|//[^\n]*|/\*.*?\*/',
31
+ flags=re.DOTALL,
32
+ )
33
+
34
+
35
+ @functools.lru_cache(maxsize=1)
36
+ def get_scanner_config():
37
+ """Loads the scanner configuration from scanner_config.json with caching."""
38
+ config_path = os.path.join(
39
+ os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
40
+ "resources",
41
+ "scanner_config.json",
42
+ )
43
+ try:
44
+ with open(config_path, "r", encoding="utf-8") as f:
45
+ return json.load(f)
46
+ except Exception as e:
47
+ print(
48
+ f"Warning: Failed to load scanner config from {config_path}: {e}",
49
+ file=sys.stderr,
50
+ )
51
+ return {}
52
+
53
+
54
+ @functools.lru_cache(maxsize=1)
55
+ def get_supported_extensions():
56
+ """Returns a tuple of supported file extensions from config."""
57
+ return tuple(get_scanner_config().get("supported_extensions", []))
58
+
59
+
60
+ def collect_target_files(target_dir):
61
+ """Performs a single master walk to categorize files."""
62
+ categorized = {
63
+ "manifests": [],
64
+ "gradles": [],
65
+ "source_code": [],
66
+ "all_files": [],
67
+ }
68
+
69
+ normalized_target = os.path.abspath(target_dir)
70
+ hybrid_root = normalized_target
71
+ target_parent = os.path.dirname(normalized_target)
72
+
73
+ for potential_root in [normalized_target, target_parent]:
74
+ if os.path.exists(
75
+ os.path.join(potential_root, "package.json")
76
+ ) or os.path.exists(os.path.join(potential_root, "pubspec.yaml")):
77
+ hybrid_root = potential_root
78
+ print(
79
+ f"Hybrid app detected. Expanding scan root to: {hybrid_root}",
80
+ file=sys.stderr,
81
+ )
82
+ break
83
+
84
+ config = get_scanner_config()
85
+ ignored_dirs = set(config.get("ignored_directories", []))
86
+ supported_exts = get_supported_extensions()
87
+
88
+ for root, dirs, files in os.walk(hybrid_root):
89
+ dirs[:] = sorted([d for d in dirs if d not in ignored_dirs])
90
+ for file in sorted(files):
91
+ file_path = os.path.join(root, file)
92
+ categorized["all_files"].append((file, file_path, root))
93
+
94
+ # Surgical filter for XMLs to avoid scanning thousands of low-signal
95
+ # assets.
96
+ if file.endswith(".xml"):
97
+ # Exclude test-bleed XMLs
98
+ if not any(
99
+ x in file_path.lower()
100
+ for x in ["/debug/", "/test/", "/androidtest/", "/testfixtures/"]
101
+ ):
102
+ if file == "AndroidManifest.xml":
103
+ categorized["manifests"].append(file_path)
104
+ else:
105
+ path_parts = file_path.split(os.sep)
106
+ is_valuable_xml = False
107
+ for i, part in enumerate(path_parts):
108
+ if part in ["res", "resources"] and i + 1 < len(path_parts):
109
+ next_part = path_parts[i + 1]
110
+ if any(
111
+ next_part.startswith(d)
112
+ for d in ["layout", "values", "xml", "navigation"]
113
+ ):
114
+ is_valuable_xml = True
115
+ break
116
+ if is_valuable_xml:
117
+ categorized["source_code"].append(file_path)
118
+
119
+ elif file.lower().endswith((".gradle", ".gradle.kts")):
120
+ categorized["gradles"].append(file_path)
121
+
122
+ elif file.lower().endswith(supported_exts) or (
123
+ file.lower() == "pubspec.yaml" or file.lower() == "package.json"
124
+ ):
125
+ # Filter (Gap 3 - OS-Specific Path Separators and Test-Bleed based on
126
+ # filename/path)
127
+ file_lower = file.lower()
128
+ is_test_or_debug = (
129
+ any(
130
+ x in file_path.lower()
131
+ for x in [
132
+ "/debug/",
133
+ "/test/",
134
+ "/androidtest/",
135
+ "/testfixtures/",
136
+ ".spec.js",
137
+ ".spec.ts",
138
+ ".spec.jsx",
139
+ ".spec.tsx",
140
+ ]
141
+ )
142
+ or file_lower.endswith("_test.dart")
143
+ )
144
+ if not is_test_or_debug:
145
+ categorized["source_code"].append(file_path)
146
+
147
+ return categorized
148
+
149
+
150
+ def _identify_semantic_files(all_files):
151
+ """Maps files to semantic categories based on filename patterns."""
152
+ semantic_files = {}
153
+ file_patterns = get_scanner_config().get("file_patterns", {})
154
+ supported_exts = get_supported_extensions()
155
+
156
+ for file, file_path, root in all_files:
157
+ file_lower = file.lower()
158
+ # Check if it's a relevant source/config file
159
+ if file_lower.endswith(supported_exts + (".xml",)):
160
+ rel_path = os.path.relpath(file_path, root)
161
+ for category, patterns in file_patterns.items():
162
+ if any(p in file_lower for p in patterns):
163
+ if category not in semantic_files:
164
+ semantic_files[category] = []
165
+ semantic_files[category].append(rel_path)
166
+
167
+ return semantic_files
168
+
169
+
170
+ def _scan_single_file(file_path, all_signal_categories, target_dir):
171
+ """Internal worker to scan a single file for all signal categories."""
172
+ local_api_usage = {}
173
+ found_urls = []
174
+ supported_exts = get_supported_extensions()
175
+
176
+ try:
177
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
178
+ content = f.read()
179
+
180
+ # URLs - with quick check for policy relatedness
181
+ policy_url_keywords = ["privacy", "support", "delete", "terms", "policy"]
182
+ for match in URL_PATTERN.finditer(content):
183
+ url = match.group(1)
184
+ if any(kw in url.lower() for kw in policy_url_keywords):
185
+ found_urls.append(url)
186
+
187
+ # Cleanup comments based on file type. .csproj and .xaml are XML documents
188
+ # despite their extensions, so they use XML comment syntax rather than the
189
+ # C-style stripping applied to source files.
190
+ file_path_lower = file_path.lower()
191
+ if file_path_lower.endswith((".xml", ".csproj", ".xaml")):
192
+ content = XML_COMMENT_PATTERN.sub("", content)
193
+ elif file_path_lower.endswith(supported_exts):
194
+ content = COMMENT_STRIP_PATTERN.sub(
195
+ lambda m: m.group(1) if m.group(1) else "", content
196
+ )
197
+
198
+ # Signal Patterns
199
+ for cat_name, signals in all_signal_categories.items():
200
+ for signal_id, patterns in signals.items():
201
+ for p in patterns:
202
+ if p in content:
203
+ if cat_name not in local_api_usage:
204
+ local_api_usage[cat_name] = {}
205
+ if signal_id not in local_api_usage[cat_name]:
206
+ local_api_usage[cat_name][signal_id] = []
207
+
208
+ rel_path = os.path.relpath(file_path, target_dir)
209
+ local_api_usage[cat_name][signal_id].append(
210
+ f"{rel_path} (Pattern: {p})"
211
+ )
212
+ break # Move to next signal once pattern found in file
213
+
214
+ except Exception: # pylint: disable=broad-exception-caught
215
+ pass
216
+
217
+ return {"api_usage": local_api_usage, "urls": found_urls}
218
+
219
+
220
+ def perform_scan(target_dir, file_inventory):
221
+ """Orchestrates the parallel scanning of identified files."""
222
+ api_usage = {}
223
+ all_urls = []
224
+ all_signal_categories = get_scanner_config().get("signal_categories", {})
225
+
226
+ with concurrent.futures.ThreadPoolExecutor(max_workers=8) as executor:
227
+ futures = [
228
+ executor.submit(
229
+ _scan_single_file, f, all_signal_categories, target_dir
230
+ )
231
+ for f in file_inventory.get("source_code", [])
232
+ ]
233
+
234
+ for future in concurrent.futures.as_completed(futures):
235
+ res = future.result()
236
+ for cat_name, cat_findings in res["api_usage"].items():
237
+ if cat_name not in api_usage:
238
+ api_usage[cat_name] = {}
239
+ for signal_id, findings in cat_findings.items():
240
+ if signal_id not in api_usage[cat_name]:
241
+ api_usage[cat_name][signal_id] = []
242
+ api_usage[cat_name][signal_id].extend(findings)
243
+
244
+ for u in res["urls"]:
245
+ all_urls.append(u)
246
+
247
+ # Final cleanup and formatting
248
+ for cat_name in api_usage:
249
+ for signal_id in api_usage[cat_name]:
250
+ api_usage[cat_name][signal_id] = sorted(
251
+ list(set(api_usage[cat_name][signal_id]))
252
+ )
253
+
254
+ return {
255
+ "data_safety_scan": api_usage,
256
+ "found_urls": sorted(list(set(all_urls))),
257
+ "semantic_files": _identify_semantic_files(
258
+ file_inventory.get("all_files", [])
259
+ ),
260
+ "codebase_map": file_inventory,
261
+ }