android-agent-harness 1.2.4__tar.gz → 1.2.5__tar.gz

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 (258) hide show
  1. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/PKG-INFO +25 -23
  2. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/README.md +22 -20
  3. android_agent_harness-1.2.5/agents/VERSION +1 -0
  4. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/release_checksums.json +6 -6
  5. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/harness-rules.md +3 -3
  6. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_release_safety_selftest.py +19 -0
  7. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_vnext_selftest.py +1 -1
  8. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/questions.py +15 -9
  9. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/AGENTS.md.template +1 -1
  10. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/PKG-INFO +25 -23
  11. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/pyproject.toml +3 -3
  12. android_agent_harness-1.2.4/agents/VERSION +0 -1
  13. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/LICENSE +0 -0
  14. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/.gitignore +0 -0
  15. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/check-strings.md.template +0 -0
  16. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/commit-msg.md.template +0 -0
  17. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/crash-triage.md.template +0 -0
  18. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/debug.md.template +0 -0
  19. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/deliver.md.template +0 -0
  20. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/doctor.md.template +0 -0
  21. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/new-feature.md.template +0 -0
  22. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/perf-audit.md.template +0 -0
  23. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/preflight.md.template +0 -0
  24. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/test-quality-audit.md.template +0 -0
  25. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/zoho-sprints.md.template +0 -0
  26. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness.py +0 -0
  27. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/__init__.py +0 -0
  28. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/commands.py +0 -0
  29. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/integrity.py +0 -0
  30. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/paths.py +0 -0
  31. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/processes.py +0 -0
  32. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/hooks.json +0 -0
  33. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/mcp_config.json +0 -0
  34. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/pm/mcp_registration.jira.md +0 -0
  35. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/pm/mcp_registration.linear.md +0 -0
  36. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/compose-context.md +0 -0
  37. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/gradle-context.md +0 -0
  38. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/kmp-context.md +0 -0
  39. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_adb_core.py +0 -0
  40. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_adb_core_selftest.py +0 -0
  41. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_inspect_selftest.py +0 -0
  42. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_scenarios_selftest.py +0 -0
  43. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_ui_selftest.py +0 -0
  44. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_antigravity_stability_selftest.py +0 -0
  45. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_architecture_selftest.py +0 -0
  46. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_baseline_selftest.py +0 -0
  47. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_change_decision_selftest.py +0 -0
  48. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_critical_safety_selftest.py +0 -0
  49. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_daily_workflow_selftest.py +0 -0
  50. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_delivery_equivalence_selftest.py +0 -0
  51. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_efficiency_selftest.py +0 -0
  52. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_enforcement.py +0 -0
  53. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_env_codes.py +0 -0
  54. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_env_codes_selftest.py +0 -0
  55. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_environment.py +0 -0
  56. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_external_write_policy_selftest.py +0 -0
  57. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_gate_results.py +0 -0
  58. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_core.py +0 -0
  59. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_discovery_selftest.py +0 -0
  60. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_selftest.py +0 -0
  61. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_hook_selftest.py +0 -0
  62. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_host_continuation_selftest.py +0 -0
  63. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_idempotency.py +0 -0
  64. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_installer_config.py +0 -0
  65. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_live_process.py +0 -0
  66. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_modules.py +0 -0
  67. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_performance_selftest.py +0 -0
  68. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_phase_review_v2_selftest.py +0 -0
  69. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_pm_selftest.py +0 -0
  70. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_portability_selftest.py +0 -0
  71. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_product.py +0 -0
  72. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_project_architecture.py +0 -0
  73. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_project_intelligence_selftest.py +0 -0
  74. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_public_cli_selftest.py +0 -0
  75. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_public_commands.py +0 -0
  76. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_repo_files.py +0 -0
  77. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_review_models_selftest.py +0 -0
  78. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_security_selftest.py +0 -0
  79. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_source_outline.py +0 -0
  80. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_source_text.py +0 -0
  81. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_stabilization_v41_selftest.py +0 -0
  82. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_stabilization_v42_selftest.py +0 -0
  83. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_task_isolation_selftest.py +0 -0
  84. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_variants.py +0 -0
  85. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_verification_recipes.py +0 -0
  86. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_verification_value_selftest.py +0 -0
  87. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_vnext_common.py +0 -0
  88. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/__init__.py +0 -0
  89. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/engine.py +0 -0
  90. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/phase_routing.py +0 -0
  91. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/planning.py +0 -0
  92. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/router.py +0 -0
  93. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/verification.py +0 -0
  94. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow_insight_selftest.py +0 -0
  95. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_worktree_handoff_selftest.py +0 -0
  96. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/android_inspect.py +0 -0
  97. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/android_ui.py +0 -0
  98. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_contract.py +0 -0
  99. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_runtime.py +0 -0
  100. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_tools.py +0 -0
  101. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_drift.py +0 -0
  102. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_policy.py +0 -0
  103. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_resolver.py +0 -0
  104. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/artifact_set.py +0 -0
  105. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/baseline_capture.py +0 -0
  106. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/build_execution.py +0 -0
  107. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/capture_screen.py +0 -0
  108. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/cc_pre_tool_safety.py +0 -0
  109. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/change_classifier.py +0 -0
  110. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/change_decision.py +0 -0
  111. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/check_kit_update.py +0 -0
  112. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/check_strings.py +0 -0
  113. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/context_presentation.py +0 -0
  114. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/copilot_pre_tool_safety.py +0 -0
  115. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/delivery_equivalence.py +0 -0
  116. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/delivery_manifest.py +0 -0
  117. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/discovery_receipt.py +0 -0
  118. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/discovery_router.py +0 -0
  119. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/__init__.py +0 -0
  120. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/engine.py +0 -0
  121. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/models.py +0 -0
  122. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/ensure_hook_selftest.py +0 -0
  123. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/evidence_store.py +0 -0
  124. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/exported_component_guard.py +0 -0
  125. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/fast_kt_lint.py +0 -0
  126. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/final_verdict.py +0 -0
  127. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/final_verifier.py +0 -0
  128. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/generate_project_context.py +0 -0
  129. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/gradle_error_parser.py +0 -0
  130. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/harness_doctor.py +0 -0
  131. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/host_continuation.py +0 -0
  132. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/incident_reporter.py +0 -0
  133. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/install_or_update.py +0 -0
  134. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/install_tool_adapters.py +0 -0
  135. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/__init__.py +0 -0
  136. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/base.py +0 -0
  137. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/external_write_policy.py +0 -0
  138. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/generic_mcp.py +0 -0
  139. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/registry.py +0 -0
  140. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/universal_pm.py +0 -0
  141. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/__init__.py +0 -0
  142. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/integration.py +0 -0
  143. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/policy.py +0 -0
  144. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/journey_runner.py +0 -0
  145. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/lifecycle.py +0 -0
  146. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/logcat_doctor.py +0 -0
  147. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/mutation_guard.py +0 -0
  148. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/new_feature_scaffold.py +0 -0
  149. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/perf_guard.py +0 -0
  150. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/phase_review.py +0 -0
  151. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/phone_e2e.py +0 -0
  152. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_authority.py +0 -0
  153. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_document.py +0 -0
  154. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_notes.py +0 -0
  155. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_discovery.py +0 -0
  156. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_github.py +0 -0
  157. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_policy.py +0 -0
  158. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/policy_vocab.py +0 -0
  159. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/post_tool_reconcile.py +0 -0
  160. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pre_invocation_reminder.py +0 -0
  161. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pre_tool_safety.py +0 -0
  162. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/preflight.py +0 -0
  163. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/preflight_check.py +0 -0
  164. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/project_context.py +0 -0
  165. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/project_graph.py +0 -0
  166. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/record_review.py +0 -0
  167. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/repair.py +0 -0
  168. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_budget.py +0 -0
  169. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_execution.py +0 -0
  170. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_fix_delta.py +0 -0
  171. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_models.py +0 -0
  172. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_orchestrator.py +0 -0
  173. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_package.py +0 -0
  174. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_policy.py +0 -0
  175. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_reasoning.py +0 -0
  176. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_sources.py +0 -0
  177. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/reviewer_host.py +0 -0
  178. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/room_guard.py +0 -0
  179. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_device.py +0 -0
  180. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_gradle_task.py +0 -0
  181. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_tests_gate.py +0 -0
  182. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/self_heal.py +0 -0
  183. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/setup_wizard.py +0 -0
  184. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/skill_router.py +0 -0
  185. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_base.py +0 -0
  186. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_context.py +0 -0
  187. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_git_lineage.py +0 -0
  188. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_merge.py +0 -0
  189. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_metrics.py +0 -0
  190. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/verification_contract.py +0 -0
  191. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/verification_steps.py +0 -0
  192. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/__init__.py +0 -0
  193. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/discovery.py +0 -0
  194. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/i18n.py +0 -0
  195. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/schema.py +0 -0
  196. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/workflow.py +0 -0
  197. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/zoho_grant.py +0 -0
  198. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/zoho_sync.py +0 -0
  199. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/settings.json +0 -0
  200. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/SKILL.md +0 -0
  201. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/architecture-guidelines.md +0 -0
  202. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/automated-skills.md +0 -0
  203. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/command-contract.md +0 -0
  204. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/daily-scenarios.md +0 -0
  205. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/database-and-persistence.md +0 -0
  206. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/performance-and-optimization.md +0 -0
  207. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/test-quality-guidelines.md +0 -0
  208. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/ui-layout-and-theming.md +0 -0
  209. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-security-billing/SKILL.md +0 -0
  210. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/brainstorming/SKILL.md +0 -0
  211. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/compose-inspector/SKILL.md +0 -0
  212. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/git-pr-automator/SKILL.md +0 -0
  213. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/gradle-build-optimizer/SKILL.md +0 -0
  214. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/kotlin-coroutines-expert/SKILL.md +0 -0
  215. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/systematic-debugging/SKILL.md +0 -0
  216. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/test-driven-development/SKILL.md +0 -0
  217. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/android-ui-expert-agent.json +0 -0
  218. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/arch-regression-reviewer-agent.json +0 -0
  219. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/bug-test-reviewer-agent.json +0 -0
  220. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/qa-diagnostics-agent.json +0 -0
  221. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/re-review-prompt.md +0 -0
  222. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/review-prompt.md +0 -0
  223. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/security-perf-reviewer-agent.json +0 -0
  224. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/spec-compliance-agent.json +0 -0
  225. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/CLAUDE.md.template +0 -0
  226. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/CODEX.md.template +0 -0
  227. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/GEMINI.md.template +0 -0
  228. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/QWEN.md.template +0 -0
  229. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/README.md +0 -0
  230. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/continue-android-harness.md.template +0 -0
  231. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/copilot-instructions.md.template +0 -0
  232. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/cursor-android-harness.mdc.template +0 -0
  233. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/android-harness-global.md.template +0 -0
  234. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/config.grants.example.json +0 -0
  235. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/mcp_config.template.json +0 -0
  236. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/github-instructions.md.template +0 -0
  237. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/pointer.md.template +0 -0
  238. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/windsurf-android-harness.md.template +0 -0
  239. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/android-inspection.md +0 -0
  240. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/android-ui.md +0 -0
  241. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/check-strings.md +0 -0
  242. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/commit-msg.md +0 -0
  243. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/crash-triage.md +0 -0
  244. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/debug.md +0 -0
  245. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/deliver.md +0 -0
  246. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/efficient-context.md +0 -0
  247. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/new-feature.md +0 -0
  248. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/perf-audit.md +0 -0
  249. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/phone-e2e.md +0 -0
  250. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/preflight.md +0 -0
  251. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/test-quality-audit.md +0 -0
  252. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/zoho-sprints.md +0 -0
  253. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/SOURCES.txt +0 -0
  254. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/dependency_links.txt +0 -0
  255. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/entry_points.txt +0 -0
  256. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/top_level.txt +0 -0
  257. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/harness_cli.py +0 -0
  258. {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/setup.cfg +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: android-agent-harness
3
- Version: 1.2.4
4
- Summary: Approval-first, evidence-bound development harness for supported Gradle Android projects.
3
+ Version: 1.2.5
4
+ Summary: Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity.
5
5
  Author: Rabee Elkholy
6
6
  License-Expression: MIT
7
7
  Project-URL: Homepage, https://github.com/rabee-elkholy/android-agent-harness
@@ -10,7 +10,7 @@ Project-URL: Source, https://github.com/rabee-elkholy/android-agent-harness
10
10
  Project-URL: Documentation, https://github.com/rabee-elkholy/android-agent-harness/tree/main/docs
11
11
  Project-URL: Changelog, https://github.com/rabee-elkholy/android-agent-harness/blob/main/CHANGELOG.md
12
12
  Project-URL: Security, https://github.com/rabee-elkholy/android-agent-harness/blob/main/SECURITY.md
13
- Keywords: android,kmp,ai-agents,code-review,governance,mcp
13
+ Keywords: android,kmm,kmp,kotlin-multiplatform,antigravity,ai-agents,code-review,governance,mcp
14
14
  Classifier: Development Status :: 5 - Production/Stable
15
15
  Classifier: Environment :: Console
16
16
  Classifier: Intended Audience :: Developers
@@ -29,17 +29,18 @@ Dynamic: license-file
29
29
 
30
30
  # Android Agent Harness
31
31
 
32
- > **Stricter proof, not heavier daily workflow.**
32
+ > **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
33
33
 
34
- Android Agent Harness is an approval-first engineering layer for AI coding tools working on real Android codebases.
34
+ Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
35
35
 
36
- It gives agents bounded project context, records the approved architecture and scope, checks the resulting changes, and requires the test, build, review, or device evidence selected by policy.
36
+ It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
37
37
 
38
38
  The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
39
39
 
40
40
  [![CI](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
41
41
  [![Release](https://img.shields.io/github/v/release/rabee-elkholy/android-agent-harness?label=release)](https://github.com/rabee-elkholy/android-agent-harness/releases)
42
42
  [![PyPI](https://img.shields.io/pypi/v/android-agent-harness)](https://pypi.org/project/android-agent-harness/)
43
+ [![Targets](https://img.shields.io/badge/Android%20%7C%20KMM%20%2F%20KMP-Kotlin%20%7C%20Java%20%7C%20Compose%20%7C%20Swift-7F52FF)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
43
44
  [![Python](https://img.shields.io/badge/Python-3.10%E2%80%933.14-blue)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
44
45
  [![Platforms](https://img.shields.io/badge/Linux%20%7C%20macOS%20%7C%20Windows-supported-success)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
45
46
  [![License](https://img.shields.io/github/license/rabee-elkholy/android-agent-harness)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
@@ -218,10 +219,10 @@ Task A
218
219
 
219
220
  ### Chat installation (recommended)
220
221
 
221
- Open your Android project in your AI coding agent (Claude Code, Codex, Gemini CLI / Antigravity, Cursor, Windsurf, Roo Code, or Copilot) and provide this bootstrap prompt:
222
+ Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
222
223
 
223
224
  ```text
224
- Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.4/docs/install-or-update-prompt.md and follow all instructions.
225
+ Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
225
226
  ```
226
227
 
227
228
  The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
@@ -244,7 +245,7 @@ android-harness doctor --repo /path/to/android-project --json
244
245
  Or run directly from a pinned source clone without global installation:
245
246
 
246
247
  ```bash
247
- git clone --depth 1 --branch v1.2.4 --single-branch \
248
+ git clone --depth 1 --branch v1.2.5 --single-branch \
248
249
  https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
249
250
 
250
251
  python ~/.android-harness/kit/harness_cli.py init \
@@ -407,8 +408,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
407
408
 
408
409
  ---
409
410
 
410
- ## Android-specific protection
411
+ ## Android & KMM / KMP (Kotlin Multiplatform) protection
411
412
 
413
+ - **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
414
+ - **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
415
+ - **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
416
+ - **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
417
+ - **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
412
418
  - **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
413
419
  - **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
414
420
  - **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
@@ -476,18 +482,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
476
482
 
477
483
  ## Supported hosts / enforcement model
478
484
 
485
+ Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
486
+
479
487
  | Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
480
488
  |---|---|---|---|---|
481
- | **Google Antigravity** | `agents/hooks.json`, custom agents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 | Yes |
482
- | **Claude Code** | `.claude/settings.json`, rules | Installed pre-tool hooks where available | V1 response ingestion; independence not natively verified | Yes |
483
- | **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
484
- | **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
485
- | **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
486
- | **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
487
- | **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
488
- | **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
489
+ | **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
490
+ | Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
489
491
 
490
- Host-native hooks can intercept some mutation classes where supported. Other hosts rely on rule enforcement plus deterministic downstream verification. The harness reports the detected enforcement level honestly.
492
+ On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
491
493
 
492
494
  See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
493
495
 
@@ -586,8 +588,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
586
588
  **2. Does this make the AI autonomous?**
587
589
  No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
588
590
 
589
- **3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
590
- Yes. It derives local architectural evidence per module and source set and checks changes against the approved architecture. Ambiguous or unsupported patterns can require developer clarification.
591
+ **3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
592
+ Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
591
593
 
592
594
  **4. Does every task run many reviewers?**
593
595
  No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
@@ -595,8 +597,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
595
597
  **5. Does every task require a device?**
596
598
  No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
597
599
 
598
- **6. Can I use Codex / Gemini / Claude / Copilot?**
599
- Yes. Native tool adapters and instruction templates are provided for Claude Code, Gemini CLI / Antigravity, GitHub Copilot, Cursor, Windsurf, Roo Code, and others.
600
+ **6. Why is the harness focused on Google Antigravity?**
601
+ Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
600
602
 
601
603
  **7. Does the harness commit/push code?**
602
604
  Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
@@ -1,16 +1,17 @@
1
1
  # Android Agent Harness
2
2
 
3
- > **Stricter proof, not heavier daily workflow.**
3
+ > **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
4
4
 
5
- Android Agent Harness is an approval-first engineering layer for AI coding tools working on real Android codebases.
5
+ Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
6
6
 
7
- It gives agents bounded project context, records the approved architecture and scope, checks the resulting changes, and requires the test, build, review, or device evidence selected by policy.
7
+ It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
8
8
 
9
9
  The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
10
10
 
11
11
  [![CI](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
12
12
  [![Release](https://img.shields.io/github/v/release/rabee-elkholy/android-agent-harness?label=release)](https://github.com/rabee-elkholy/android-agent-harness/releases)
13
13
  [![PyPI](https://img.shields.io/pypi/v/android-agent-harness)](https://pypi.org/project/android-agent-harness/)
14
+ [![Targets](https://img.shields.io/badge/Android%20%7C%20KMM%20%2F%20KMP-Kotlin%20%7C%20Java%20%7C%20Compose%20%7C%20Swift-7F52FF)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
14
15
  [![Python](https://img.shields.io/badge/Python-3.10%E2%80%933.14-blue)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
15
16
  [![Platforms](https://img.shields.io/badge/Linux%20%7C%20macOS%20%7C%20Windows-supported-success)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
16
17
  [![License](https://img.shields.io/github/license/rabee-elkholy/android-agent-harness)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
@@ -189,10 +190,10 @@ Task A
189
190
 
190
191
  ### Chat installation (recommended)
191
192
 
192
- Open your Android project in your AI coding agent (Claude Code, Codex, Gemini CLI / Antigravity, Cursor, Windsurf, Roo Code, or Copilot) and provide this bootstrap prompt:
193
+ Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
193
194
 
194
195
  ```text
195
- Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.4/docs/install-or-update-prompt.md and follow all instructions.
196
+ Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
196
197
  ```
197
198
 
198
199
  The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
@@ -215,7 +216,7 @@ android-harness doctor --repo /path/to/android-project --json
215
216
  Or run directly from a pinned source clone without global installation:
216
217
 
217
218
  ```bash
218
- git clone --depth 1 --branch v1.2.4 --single-branch \
219
+ git clone --depth 1 --branch v1.2.5 --single-branch \
219
220
  https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
220
221
 
221
222
  python ~/.android-harness/kit/harness_cli.py init \
@@ -378,8 +379,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
378
379
 
379
380
  ---
380
381
 
381
- ## Android-specific protection
382
+ ## Android & KMM / KMP (Kotlin Multiplatform) protection
382
383
 
384
+ - **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
385
+ - **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
386
+ - **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
387
+ - **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
388
+ - **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
383
389
  - **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
384
390
  - **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
385
391
  - **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
@@ -447,18 +453,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
447
453
 
448
454
  ## Supported hosts / enforcement model
449
455
 
456
+ Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
457
+
450
458
  | Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
451
459
  |---|---|---|---|---|
452
- | **Google Antigravity** | `agents/hooks.json`, custom agents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 | Yes |
453
- | **Claude Code** | `.claude/settings.json`, rules | Installed pre-tool hooks where available | V1 response ingestion; independence not natively verified | Yes |
454
- | **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
455
- | **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
456
- | **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
457
- | **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
458
- | **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
459
- | **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
460
+ | **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
461
+ | Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
460
462
 
461
- Host-native hooks can intercept some mutation classes where supported. Other hosts rely on rule enforcement plus deterministic downstream verification. The harness reports the detected enforcement level honestly.
463
+ On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
462
464
 
463
465
  See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
464
466
 
@@ -557,8 +559,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
557
559
  **2. Does this make the AI autonomous?**
558
560
  No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
559
561
 
560
- **3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
561
- Yes. It derives local architectural evidence per module and source set and checks changes against the approved architecture. Ambiguous or unsupported patterns can require developer clarification.
562
+ **3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
563
+ Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
562
564
 
563
565
  **4. Does every task run many reviewers?**
564
566
  No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
@@ -566,8 +568,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
566
568
  **5. Does every task require a device?**
567
569
  No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
568
570
 
569
- **6. Can I use Codex / Gemini / Claude / Copilot?**
570
- Yes. Native tool adapters and instruction templates are provided for Claude Code, Gemini CLI / Antigravity, GitHub Copilot, Cursor, Windsurf, Roo Code, and others.
571
+ **6. Why is the harness focused on Google Antigravity?**
572
+ Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
571
573
 
572
574
  **7. Does the harness commit/push code?**
573
575
  Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
@@ -0,0 +1 @@
1
+ 1.2.5
@@ -2,7 +2,7 @@
2
2
  "algorithm": "sha256",
3
3
  "files": {
4
4
  "agents/.gitignore": "8a0eaa7cc8e55d17da96f31f6863b5e9b5aba15bb03fd6e8fb07a8cb89e5715c",
5
- "agents/VERSION": "563a0b4eec3c77bbc34ac630d4fa5214f5c6726ae01468404fd704473110084e",
5
+ "agents/VERSION": "fe2b7c237b5a6e42818aa3e4f7fc5820f49c32289c32c96260ef89a8c8f6d3d7",
6
6
  "agents/command-packs/check-strings.md.template": "688d464d69849d4b5bc68faae49bf79a196d882765ac5eaf9b829bd8df8b9c0b",
7
7
  "agents/command-packs/commit-msg.md.template": "cf8bd58a510a6953a66e2c705c8c9515f0369e4fa454af9bbc9c7f6b1805b80e",
8
8
  "agents/command-packs/crash-triage.md.template": "acea2311229cc8d4f7d1eae515a4d3f3b52246437df25ee75dfa40d3407dc69a",
@@ -26,7 +26,7 @@
26
26
  "agents/pm/mcp_registration.linear.md": "7547aa65303993c89ae109b663d4cdbc200671a58b9a9f6fdfdfb1fb27b0c4c9",
27
27
  "agents/rules/compose-context.md": "338cfebf9f718b69b588c2eedcad718ec862db16c7142f4cbaa74bbb189cd501",
28
28
  "agents/rules/gradle-context.md": "a797096a10859c4fb9d337a34cf3fdb647c9657c38aea408bbcd16c07926a9f4",
29
- "agents/rules/harness-rules.md": "e80e837b540c03c21ea611387abba109a2d9c5c079af99bfc652b4225e14a94e",
29
+ "agents/rules/harness-rules.md": "7cf2a0774c37768fb4f480ec3a2a2ad137e8a16fccabe765adaa214f23f0a007",
30
30
  "agents/rules/kmp-context.md": "f258d89ba9f1f032f4e256e83a71fde07f65df7eeef3c307fcd0b12de26b856a",
31
31
  "agents/scripts/_adb_core.py": "094bfe0768b553496420cb82fe4947cf38002f84087fa8d259adcfef0ed51f7a",
32
32
  "agents/scripts/_adb_core_selftest.py": "f2f6b03168253032b4fdfa6289ac67d80824723fc84903f17d2d1cee62569ba2",
@@ -65,7 +65,7 @@
65
65
  "agents/scripts/_project_intelligence_selftest.py": "0f8117e3d1c8ea6b74f584b557bf531fcb2482081d3f1078c99a6539ef8a8a9e",
66
66
  "agents/scripts/_public_cli_selftest.py": "23610078906c1cc7e035bfa954d99f42e8df40acaa62d155a4557318b6966f9d",
67
67
  "agents/scripts/_public_commands.py": "3aa974d2ce8907f49c5a437e8f3d6c70cd04942be0f09aa0a8ad6ac59a41dc5f",
68
- "agents/scripts/_release_safety_selftest.py": "9f9eccb55e7f584f43d2bb4c9d1c58d9f3ff3b4b3d13b4763d67d6c85e51072f",
68
+ "agents/scripts/_release_safety_selftest.py": "c4578e68aa058cffbdd000e3fef211ca94237985c10fe368bf562551506fdff4",
69
69
  "agents/scripts/_repo_files.py": "69fab31be58f2fcef0dacb44d75b93b6a1f3192fcad1f514217ea2219b837818",
70
70
  "agents/scripts/_review_models_selftest.py": "264162e5e44d4acfa6432457924e7e2f8d41f66c1912eafb3d1bb242c7a713d5",
71
71
  "agents/scripts/_security_selftest.py": "8a5b7fbb26990a37006239518391cab5660318951c26dc2327af8be6521b1bf9",
@@ -78,7 +78,7 @@
78
78
  "agents/scripts/_verification_recipes.py": "5bf892d82818020c4f7fff063a3983d383b2b4ee50fc459b29a44eb53f2f1209",
79
79
  "agents/scripts/_verification_value_selftest.py": "89e786c8b04cad6e925bd78d9a98bf59f6d03b4639b18d9ab32073917b62d176",
80
80
  "agents/scripts/_vnext_common.py": "5036dbaf9e303f3652c66287f213d5eca13197ffbf4fa3438d81fa9dd476c03b",
81
- "agents/scripts/_vnext_selftest.py": "1a4f388670a4b01756de2f45085a9da1138ffcaecfe1e42f9cdef8114c669078",
81
+ "agents/scripts/_vnext_selftest.py": "6f5820e970bad8b3b0ac6123ed794bc897d8bab053db78748f0db0ff053efdf6",
82
82
  "agents/scripts/_workflow/__init__.py": "c22fd03196f70c813422712dfe3cb56689bfcbc32d08089987ffe8b41191675e",
83
83
  "agents/scripts/_workflow/engine.py": "595fd34139ba13ed2467da3067abfc4c710e0d1a0406b087e6b9c482466665af",
84
84
  "agents/scripts/_workflow/phase_routing.py": "5948f0c916f720a522785965e71bf478add3dda1955d8dd8cbf2743498f07e78",
@@ -186,7 +186,7 @@
186
186
  "agents/scripts/wizard/__init__.py": "bc3e731532f96d9de98ce49c51b9cd969d682b12d1d7fb3779953152730ef60a",
187
187
  "agents/scripts/wizard/discovery.py": "c10abe695d3e4feaa440e01020e2af76b66bcc85a3548e6bda2be2262631e187",
188
188
  "agents/scripts/wizard/i18n.py": "89d1c25ff5ac8c50a4fda681e797b97db5ae9be0c74a7b6cfb85c22f22b83622",
189
- "agents/scripts/wizard/questions.py": "02a5a06ffb15cfc3261b3a970767bb107a1b7d309c7de98d4a6330830084f86f",
189
+ "agents/scripts/wizard/questions.py": "aa1c2a03ef88d346ac6bd637190753ff747eb23ab577ff55391c5dba27359153",
190
190
  "agents/scripts/wizard/schema.py": "17f073c9ba044e1d65dd541511401a60dce3183c655f8a40ece1cb4e85f188ee",
191
191
  "agents/scripts/workflow.py": "a7becec2309e4071c5efff5bb6600a6e706b3623a59be0a7cd744d34868ca2e3",
192
192
  "agents/scripts/zoho_grant.py": "1ff1b3d1cd4cf350d62701c3bcc46b3430be4dbe913571b4eb90477da9fac8d0",
@@ -217,7 +217,7 @@
217
217
  "agents/subagents/review-prompt.md": "bde25a34e54344b48aac75063d27a861e70f174d637ce30f43def88bd27baff5",
218
218
  "agents/subagents/security-perf-reviewer-agent.json": "39126b1bf981dcbb304163470a4bcdea892f2f204f33258ae911e0f641bfeeae",
219
219
  "agents/subagents/spec-compliance-agent.json": "4d9a91d94fbc097a46a4978adce068dde54e218a7831c64f8c80d90aae58ed04",
220
- "agents/tool-adapters/AGENTS.md.template": "76480cf043b82bcdf64381999ed4a1101deae46ea704f9d31f7deee01b79feb7",
220
+ "agents/tool-adapters/AGENTS.md.template": "803d42ff2a3a8b5e2a6ddb054251389ed821e99896bd957823c820ac67984d61",
221
221
  "agents/tool-adapters/CLAUDE.md.template": "011adc69ab7dbde774a373183850f769dc864058dffedb0f78364d0fc0fbd3b7",
222
222
  "agents/tool-adapters/CODEX.md.template": "0b2a7b9a5d990d0abd641970b3a07ad42fbad960f67629514ea7d2b73be8459e",
223
223
  "agents/tool-adapters/GEMINI.md.template": "b84142de56442d6dc2437b5700c6e0580c394139c360fdc39db71d00e88d44f2",
@@ -15,13 +15,13 @@ This is the authoritative always-loaded contract. Route detailed Android guidanc
15
15
  - **Single-shot Proceed invariant**: Proceed appears only for initial task approval. One approval covers all stated phases without pausing between phases.
16
16
  - **Direct follow-up execution**: approved in-scope fixes execute immediately; new plan/Proceed only if behavior, sensitive surface, contract, external write, or blast radius materially expands.
17
17
  - **Review corrections are not replanning**: resume the same task (`workflow.py resume`) before fixes, then freeze fresh final verification and execute only its routed reviewers. Completed semantic phase checkpoints remain historical proof; clarify existing decisions with `task plan-note --task-id <id> --text "<clarification>" --source conversation --proof-reference "<decision>"` (never edit `plan.md` manually; narrative `revise` on an approved task requires `--material-change-reason "<actual requirement expansion>"`).
18
- - **Host continuation**: use `task continue --task-id <id> --host <actual-host>` (stop former writer before `--source-stopped`; include `--expect-session`).
18
+ - **Host continuation**: use `task continue --task-id <id> --host antigravity` (stop former writer before `--source-stopped`; include `--expect-session`).
19
19
  - Durable context (`context note` / `context instruct` with `--replace`, `--remove`, `--supersedes`) is administrative: clarify ambiguity first, then organize and translate into clear, self-contained English before saving. Always follow `.agents/project-context/project-notes.md` and `developer-instructions.json`. Commit, push, release, tracker mutation, app uninstall/data clear, downgrade, purchase, and publication are never implicit.
20
20
  - **Unified Chat & Question UI/UX (Language-Adaptive)**:
21
21
  - **Dynamic Language & RTL Hygiene**: Match the developer's active conversation language for all headings, table headers, and labels. In any right-to-left (RTL) language, start every paragraph, bullet, and numbered item with a word in that language and wrap every file name, symbol, command, path, and English technical term in `` `backticks` ``.
22
22
  - **6 Canonical Task Cards** (no emoji, no duplicate summaries): (1) **Plan Approval** (`[plan.md](<PLAN_DOCUMENT_URI>)` + translated `APPROVAL_BRIEF` bullets inside `ask_question`, never in a code block), (2) **Reviewer Dispatch** (`| Reviewer | Model | Status |` with only the role name in `Reviewer` and active model in `Model`; on partial completion `WAIT_FOR_REVIEWERS` / `WAIT_FOR_PHASE_REVIEWERS`, output at most one short progress line like `1/3` without listing pending reviewer names), (3) **Review Verdict** (`| Reviewer | Model | Verdict | Findings |` after finalize), (4) **Mobile Walkthrough & Sign-Off** (3 sections: Navigation & Preconditions, `| # | Action | Expected Result |` table with <=5 rows, Edge Cases, with NO file-change summary wall, in chat or directly inside `ask_question` in the SAME turn), (5) **Ready for Delivery & Commit** (verified files in backticks + copyable fenced `text` Conventional Commit block with subject and bullet body, included in chat and inside `ask_question`), and (6) **Decision & Escalation Modal (`ask_question`)** (concise bold heading + bulleted context for `SELECT_REVIEW_MODEL`, `MOBILE_VALIDATION_DECISION`, stale/scope decisions, or pre-planning clarifications).
23
23
 
24
- Lifecycle (`PLAN -> BUILD -> VERIFY -> SHIP -> DONE`): Follow `NEXT_ACTION`/`NEXT_REASON`; query `python .agents/harness.py task status --task-id <id> --next --brief --json` only when missing. `verify-steps --task-id <id> --host <actual-host>` runs consecutive deterministic steps and stops at failures, reviews, or decisions (`STOPPED` is not completion). Never fabricate approval or evidence.
24
+ Lifecycle (`PLAN -> BUILD -> VERIFY -> SHIP -> DONE`): Follow `NEXT_ACTION`/`NEXT_REASON`; query `python .agents/harness.py task status --task-id <id> --next --brief --json` only when missing. `verify-steps --task-id <id> --host antigravity` runs consecutive deterministic steps and stops at failures, reviews, or decisions (`STOPPED` is not completion). Never fabricate approval or evidence.
25
25
 
26
26
  ## 2. Discovery and harness boundary
27
27
 
@@ -77,7 +77,7 @@ Report detected tier honestly: `HARD_ENFORCED`, `RULE_ENFORCED`, or `UNSUPPORTED
77
77
  | Context note | `python .agents/harness.py context note "<structured-english-note>"` (`--replace "<old>"` / `--remove "<old>"`) |
78
78
  | Task guidance | `python .agents/harness.py task status --task-id <id> --next` |
79
79
  | Policy diagnosis | `python .agents/harness.py policy --json` |
80
- | Consecutive verification steps | `python .agents/harness.py verify-steps --task-id <id> --host <actual-host>` |
80
+ | Consecutive verification steps | `python .agents/harness.py verify-steps --task-id <id> --host antigravity` |
81
81
  | Preflight | `python .agents/harness.py preflight` |
82
82
  | Unit tests | `python .agents/harness.py test` |
83
83
  | Review package | `python .agents/harness.py review package --task-id <id>` |
@@ -345,6 +345,25 @@ class ReleaseSafetyTests(unittest.TestCase):
345
345
  errors = validation.validate_release(KIT, version)
346
346
  self.assertTrue(any("relative link" in err for err in errors), errors)
347
347
 
348
+ def test_release_commit_subject_accepts_descriptive_conventional_formats(self):
349
+ for valid_subj in (
350
+ "chore(release): v1.2.5 — Consent-first incident reporting",
351
+ "chore(release): v1.2.5",
352
+ "release(v1.2.5): consent-first incident reporting",
353
+ "release: v1.2.5 — consent-first incident reporting",
354
+ "release: v1.2.5",
355
+ ):
356
+ with self.subTest(valid_subj=valid_subj):
357
+ self.assertTrue(automatic_release.is_release_commit_subject(valid_subj, "v1.2.5"))
358
+ for invalid_subj in (
359
+ "feat(incidents): add consent-first reporting",
360
+ "chore(release): v1.2.4 — wrong version",
361
+ "release: v1.2.50",
362
+ "",
363
+ ):
364
+ with self.subTest(invalid_subj=invalid_subj):
365
+ self.assertFalse(automatic_release.is_release_commit_subject(invalid_subj, "v1.2.5"))
366
+
348
367
 
349
368
  if __name__ == "__main__":
350
369
  unittest.main()
@@ -140,7 +140,7 @@ class GuidanceTests(unittest.TestCase):
140
140
 
141
141
  def test_repository_constitution_guard(self) -> None:
142
142
  constitution = (KIT / "PROJECT_CONSTITUTION.md").read_text(encoding="utf-8")
143
- for pointer in ("AGENTS.md", "GEMINI.md", "CLAUDE.md"):
143
+ for pointer in ("AGENTS.md", "GEMINI.md"):
144
144
  self.assertIn("PROJECT_CONSTITUTION.md", (KIT / pointer).read_text(encoding="utf-8"))
145
145
  for marker in (
146
146
  "Stricter proof, not heavier workflow", "Approval-first", "Human Git Authority",
@@ -53,19 +53,19 @@ def questions_payload(repo: Path, lang: str, facts: dict | None = None) -> list[
53
53
  ],
54
54
  },
55
55
  ]
56
- tool_opts = []
57
- for tid in TOOL_IDS:
58
- lbl = labels[tid]
59
- if tid == "antigravity" and (d.get("antigravity") or not d.get("tools")):
60
- lbl += " (Recommended)"
61
- tool_opts.append({"id": tid, "label": lbl})
62
- tool_opts.append({"id": "all", "label": labels["all"]})
56
+ tool_opts = [
57
+ {
58
+ "id": "antigravity",
59
+ "label": f"{labels['antigravity']} (Recommended)",
60
+ }
61
+ ]
63
62
  qs.append(
64
63
  {
65
64
  "id": "i14",
66
65
  "station": 1,
67
66
  "station_title": "Workspace & AI Tooling",
68
- "required": True,
67
+ "required": False,
68
+ "default": ["antigravity"],
69
69
  "allow_multiple": True,
70
70
  "prompt": t(lang, "i14"),
71
71
  "options": tool_opts,
@@ -824,7 +824,11 @@ def normalize(raw: dict, facts: dict) -> dict:
824
824
  "networking": net_val,
825
825
  "locales": loc_val,
826
826
  }
827
- tools = raw.get("i14") or []
827
+ tools = raw.get("i14") if "i14" in raw else ["antigravity"]
828
+ if not tools and "i14" not in raw:
829
+ tools = ["antigravity"]
830
+ elif not tools:
831
+ tools = []
828
832
  if isinstance(tools, str):
829
833
  tools = [x.strip() for x in tools.split(",") if x.strip()]
830
834
  if "all" in tools:
@@ -1155,6 +1159,8 @@ def existing_defaults(repo: Path) -> dict[str, object]:
1155
1159
  defaults["review_model_policy_text"] = json.dumps(policy)
1156
1160
  if isinstance(tools, list) and tools:
1157
1161
  defaults["i14"] = list(tools)
1162
+ else:
1163
+ defaults["i14"] = ["antigravity"]
1158
1164
  return defaults
1159
1165
 
1160
1166
 
@@ -26,7 +26,7 @@ Read `.agents/rules/harness-rules.md`; it is the authoritative safety contract.
26
26
  | Context note | `{{PY}} .agents/harness.py context note "<structured-english-note>"` (`--replace "<old>"` / `--remove "<old>"`) |
27
27
  | Preflight | `{{PY}} .agents/harness.py preflight` |
28
28
  | Unit tests | `{{PY}} .agents/harness.py test` |
29
- | Review evidence | `{{PY}} .agents/scripts/record_review.py --task <id> --response <role>=<unchanged-response-file>` |
29
+ | Review evidence | `{{PY}} .agents/harness.py review complete --task <id> --reviewer <role> --execution-id <convId>` -> `review finalize --task <id>` |
30
30
  | Resume | `{{PY}} .agents/harness.py task resume --task-id <id>` |
31
31
  | Assemble | `{{PY}} .agents/harness.py assemble` |
32
32
  | Device | `{{PY}} .agents/harness.py device install-start` |
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: android-agent-harness
3
- Version: 1.2.4
4
- Summary: Approval-first, evidence-bound development harness for supported Gradle Android projects.
3
+ Version: 1.2.5
4
+ Summary: Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity.
5
5
  Author: Rabee Elkholy
6
6
  License-Expression: MIT
7
7
  Project-URL: Homepage, https://github.com/rabee-elkholy/android-agent-harness
@@ -10,7 +10,7 @@ Project-URL: Source, https://github.com/rabee-elkholy/android-agent-harness
10
10
  Project-URL: Documentation, https://github.com/rabee-elkholy/android-agent-harness/tree/main/docs
11
11
  Project-URL: Changelog, https://github.com/rabee-elkholy/android-agent-harness/blob/main/CHANGELOG.md
12
12
  Project-URL: Security, https://github.com/rabee-elkholy/android-agent-harness/blob/main/SECURITY.md
13
- Keywords: android,kmp,ai-agents,code-review,governance,mcp
13
+ Keywords: android,kmm,kmp,kotlin-multiplatform,antigravity,ai-agents,code-review,governance,mcp
14
14
  Classifier: Development Status :: 5 - Production/Stable
15
15
  Classifier: Environment :: Console
16
16
  Classifier: Intended Audience :: Developers
@@ -29,17 +29,18 @@ Dynamic: license-file
29
29
 
30
30
  # Android Agent Harness
31
31
 
32
- > **Stricter proof, not heavier daily workflow.**
32
+ > **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
33
33
 
34
- Android Agent Harness is an approval-first engineering layer for AI coding tools working on real Android codebases.
34
+ Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
35
35
 
36
- It gives agents bounded project context, records the approved architecture and scope, checks the resulting changes, and requires the test, build, review, or device evidence selected by policy.
36
+ It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
37
37
 
38
38
  The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
39
39
 
40
40
  [![CI](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
41
41
  [![Release](https://img.shields.io/github/v/release/rabee-elkholy/android-agent-harness?label=release)](https://github.com/rabee-elkholy/android-agent-harness/releases)
42
42
  [![PyPI](https://img.shields.io/pypi/v/android-agent-harness)](https://pypi.org/project/android-agent-harness/)
43
+ [![Targets](https://img.shields.io/badge/Android%20%7C%20KMM%20%2F%20KMP-Kotlin%20%7C%20Java%20%7C%20Compose%20%7C%20Swift-7F52FF)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
43
44
  [![Python](https://img.shields.io/badge/Python-3.10%E2%80%933.14-blue)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
44
45
  [![Platforms](https://img.shields.io/badge/Linux%20%7C%20macOS%20%7C%20Windows-supported-success)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
45
46
  [![License](https://img.shields.io/github/license/rabee-elkholy/android-agent-harness)](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
@@ -218,10 +219,10 @@ Task A
218
219
 
219
220
  ### Chat installation (recommended)
220
221
 
221
- Open your Android project in your AI coding agent (Claude Code, Codex, Gemini CLI / Antigravity, Cursor, Windsurf, Roo Code, or Copilot) and provide this bootstrap prompt:
222
+ Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
222
223
 
223
224
  ```text
224
- Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.4/docs/install-or-update-prompt.md and follow all instructions.
225
+ Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
225
226
  ```
226
227
 
227
228
  The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
@@ -244,7 +245,7 @@ android-harness doctor --repo /path/to/android-project --json
244
245
  Or run directly from a pinned source clone without global installation:
245
246
 
246
247
  ```bash
247
- git clone --depth 1 --branch v1.2.4 --single-branch \
248
+ git clone --depth 1 --branch v1.2.5 --single-branch \
248
249
  https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
249
250
 
250
251
  python ~/.android-harness/kit/harness_cli.py init \
@@ -407,8 +408,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
407
408
 
408
409
  ---
409
410
 
410
- ## Android-specific protection
411
+ ## Android & KMM / KMP (Kotlin Multiplatform) protection
411
412
 
413
+ - **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
414
+ - **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
415
+ - **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
416
+ - **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
417
+ - **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
412
418
  - **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
413
419
  - **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
414
420
  - **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
@@ -476,18 +482,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
476
482
 
477
483
  ## Supported hosts / enforcement model
478
484
 
485
+ Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
486
+
479
487
  | Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
480
488
  |---|---|---|---|---|
481
- | **Google Antigravity** | `agents/hooks.json`, custom agents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 | Yes |
482
- | **Claude Code** | `.claude/settings.json`, rules | Installed pre-tool hooks where available | V1 response ingestion; independence not natively verified | Yes |
483
- | **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
484
- | **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
485
- | **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
486
- | **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
487
- | **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
488
- | **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
489
+ | **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
490
+ | Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
489
491
 
490
- Host-native hooks can intercept some mutation classes where supported. Other hosts rely on rule enforcement plus deterministic downstream verification. The harness reports the detected enforcement level honestly.
492
+ On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
491
493
 
492
494
  See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
493
495
 
@@ -586,8 +588,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
586
588
  **2. Does this make the AI autonomous?**
587
589
  No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
588
590
 
589
- **3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
590
- Yes. It derives local architectural evidence per module and source set and checks changes against the approved architecture. Ambiguous or unsupported patterns can require developer clarification.
591
+ **3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
592
+ Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
591
593
 
592
594
  **4. Does every task run many reviewers?**
593
595
  No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
@@ -595,8 +597,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
595
597
  **5. Does every task require a device?**
596
598
  No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
597
599
 
598
- **6. Can I use Codex / Gemini / Claude / Copilot?**
599
- Yes. Native tool adapters and instruction templates are provided for Claude Code, Gemini CLI / Antigravity, GitHub Copilot, Cursor, Windsurf, Roo Code, and others.
600
+ **6. Why is the harness focused on Google Antigravity?**
601
+ Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
600
602
 
601
603
  **7. Does the harness commit/push code?**
602
604
  Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "android-agent-harness"
7
- version = "1.2.4"
8
- description = "Approval-first, evidence-bound development harness for supported Gradle Android projects."
7
+ version = "1.2.5"
8
+ description = "Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
11
11
  license = "MIT"
12
12
  license-files = ["LICENSE"]
13
13
  authors = [{ name = "Rabee Elkholy" }]
14
- keywords = ["android", "kmp", "ai-agents", "code-review", "governance", "mcp"]
14
+ keywords = ["android", "kmm", "kmp", "kotlin-multiplatform", "antigravity", "ai-agents", "code-review", "governance", "mcp"]
15
15
  classifiers = [
16
16
  "Development Status :: 5 - Production/Stable",
17
17
  "Environment :: Console",
@@ -1 +0,0 @@
1
- 1.2.4